核心是将 skywalking agent 与 java 应用打包进同一容器并用 jvm 参数挂载探针：下载解压 agent、copy 到镜像、通过 -javaagent 指定绝对路径，配置 service_name 和 backend_service 地址，确保网络可达，最后验证日志和 ui 数据上报。
核心是把 SkyWalking Agent 和你的 Java 应用打包进同一个容器，并通过 JVM 参数挂载探针。只要路径对、参数全、网络通，监控数据就能自动上报。
准备探针并纳入构建上下文
从 Apache 官网下载对应版本的 SkyWalking Java Agent（如 8.12.0），解压后得到 skywalking-agent.jar 及其 config/、plugins/ 等目录。将整个 agent/ 文件夹放在项目根目录下（与 Dockerfile 同级），确保它能被 COPY 指令读取。
不需要在宿主机上提前安装 Java 或配置环境——Docker 构建阶段会统一处理。
在 Dockerfile 中完成探针挂载
关键在于三步：复制 agent、指定启动参数、确保 jar 路径可访问。示例如下：
FROM openjdk:17-jre-slim
WORKDIR /app
COPY target/*.jar app.jar
COPY agent /usr/skywalking/agent
ENTRYPOINT ["sh", "-c", "java \
-javaagent:/usr/skywalking/agent/skywalking-agent.jar \
-Dskywalking.agent.service_name=my-order-service \
-Dskywalking.collector.backend_service=skywalking-oap:11800 \
-Djava.security.egd=file:/dev/./urandom \
-jar /app.jar"]
-
agent 路径必须与
-javaagent中一致，建议使用绝对路径避免歧义 -
service_name要体现业务语义（如user-service），便于 SkyWalking UI 识别 -
backend_service填写 OAP 服务在 Kubernetes 或 Docker 网络中的可解析地址，不是localhost - 若使用自定义
agent.config，可提前修改好再 COPY 进镜像，或通过环境变量覆盖（如-Dskywalking.agent.namespace=prod）
适配运行时网络与配置
Docker 容器默认无法通过 localhost 访问宿主机服务。若 OAP 部署在宿主机或另一容器中，需确保网络连通：
- 单机 Docker 测试可用
host.docker.internal替代localhost（Docker Desktop 默认支持） - Kubernetes 场景下，直接填 Service 名（如
skywalking-oap.default.svc.cluster.local:11800） - 若启用了 TLS 或需要额外插件（如 logback 日志透传），把对应 JAR 放入
plugins/并确认未被忽略
验证是否生效
容器启动后，检查日志是否有类似输出：
INFO org.apache.skywalking.apm.agent.SkyWalkingAgent : SkyWalking Agent v8.12.0 started successfully.
然后访问 SkyWalking UI（如 http://localhost:8080），在「拓扑图」或「服务列表」中查找你设置的 service_name。如果 1–2 分钟内出现且有调用链，说明集成成功。
没有数据？优先检查容器日志里是否报 Connection refused 或 Unable to find backend，这基本指向网络或端口配置问题。
