首页 编程相关 正文
我要发布

云原生架构下微服务接入 SkyWalking 最佳实践

编程相关
2025-12-12 0 710

背景

本文介绍在 Kubernetes 集群中，如何通过 Sidecar 模式为 Java 应用无侵入式部署 SkyWalking 探针，并利用 DataKit 内置的 SkyWalking 采集器，一站式收集链路数据（Trace）与应用日志（Log），最终在观测云平台实现强大的链路与日志联动查询，全面提升可观测性能力。

部署 SkyWalking 探针

SkyWalking Agent Sidecar 容器

该容器负责提供 skywalking-agent.jar 及其配置文件。

  • 环境变量： 配置应用名（SW_AGENT_NAME）
  • Volume 挂载： 将 Agent 目录挂载到共享 Volume
  • Sidecar 容器镜像 dockerfile：
FROM alpine:3.14

  

# 下载SkyWalking探针

RUN wget -O /tmp/skywalking-agent.tar.gz 

    https://archive.apache.org/dist/skywalking/java-agent/8.8.0/apache-skywalking-java-agent-8.8.0.tgz 

    && tar -zxvf /tmp/skywalking-agent.tar.gz -C / 

    && mv /skywalking-agent /agent 

    && rm /tmp/skywalking-agent.tar.gz

  

# 复制启动脚本

COPY entrypoint.sh /entrypoint.sh

RUN chmod +x /entrypoint.sh

  

ENTRYPOINT [\"/entrypoint.sh\"]

entrypoint.sh

#!/bin/sh

  

# 创建配置目录

mkdir -p /agent/config

  

# 动态生成agent.config

cat <<EOF > /agent/config/agent.config

# 服务名由环境变量传入

agent.service_name=${SW_AGENT_NAME:demo}

# DataKit地址由环境变量传入

collector.backend_service=${SW_AGENT_COLLECTOR_BACKEND_SERVICES:datakit-service.datakit.svc.cluster.local:11800}

EOF

  

# 将探针复制到共享卷

cp -r /agent/* /sw-agent/

  

# 保持容器运行

tail -f /dev/null

业务容器

  • 无需修改镜像： 业务镜像本身无需包含任何 SkyWalking 依赖。
  • JVM 参数注入： 通过 JAVA_TOOL_OPTIONS 环境变量，指向共享 Volume 中的 skywalking-agent.jar。
  • Volume 挂载： 同样挂载共享 Volume，以访问其中的 Agent 文件。

业务 yaml

apiVersion: apps/v1

kind: Deployment

metadata:

  name: service-b

spec:

  replicas: 1

  selector:

    matchLabels:

      app: service-b

  template:

    metadata:

      labels:

        app: service-b

    spec:

      volumes:

        - name: sw-agent

          emptyDir: {}

      containers:

        # 主应用容器

        - name: service-b-app

          image: zhaoje/service-b:sw3.0

          ports:

            - containerPort: 8081

          volumeMounts:

            - name: sw-agent

              mountPath: /sw-agent

          env:

            - name: JAVA_TOOL_OPTIONS

              value: \"-javaagent:/sw-agent/skywalking-agent.jar\"

        # SkyWalking边车容器

        - name: sw-agent-sidecar

          image: xxx/sw-agent-sidecar:8.8.2

          env:

            - name: SW_AGENT_NAME

              value: \"service-b\"

          volumeMounts:

            - name: sw-agent

              mountPath: /sw-agent

---

apiVersion: v1

kind: Service

metadata:

  name: service-b

spec:

  #type: NodePort

  selector:

    app: service-b

  ports:

    - protocol: TCP

      port: 8081

      targetPort: 8080

应用日志关联 Trace

本最佳实践以 log4j2 示例，将 toolkit 依赖包添加到 maven 或者 gradle 中：

         <dependency>

            <groupId>org.apache.skywalking</groupId>

            <artifactId>apm-toolkit-log4j-2.x</artifactId>

            <version>8.8.0</version> 

        </dependency>

        <dependency>

            <groupId>org.apache.skywalking</groupId>

            <artifactId>apm-toolkit-trace</artifactId>

            <version>8.8.0</version>

        </dependency>
  • apm-toolkit-log4j-2.x： 这是最关键的依赖。它为 Log4j2 这个日志框架提供了扩展。具体来说，它提供了一个特殊的 %tid 模式转换器（Pattern Layout Converter）。正是因为有了这个依赖，您才能在后面的 log4j2.xml 配置中使用 [%tid] 来输出 Trace ID。
  • apm-toolkit-trace： 这个依赖提供了一些有用的 API，例如 TraceContext.traceId() 用于在代码中手动获取当前链路的 Trace ID。虽然很多功能由探针自动完成，但如果您想在业务代码中主动操作追踪上下文，就需要它。

并在服务目录下新增 log4j2.xml 定义输出格式，在示例中的路径是：/root/service-a/src/main/resources

<?xml version=\"1.0\" encoding=\"UTF-8\"?>

<Configuration status=\"WARN\">

    <Appenders>

        

        <Console name=\"Console\" target=\"SYSTEM_OUT\">

            <PatternLayout pattern=\"%d{yyyy-MM-dd HH:mm:ss.SSS} [%tid] [%thread] %-5level %logger{36} - %msg%n\"/>

        </Console>

        

        <GRPCLogClientAppender name=\"GrpcLog\">

            <PatternLayout pattern=\"%d{yyyy-MM-dd HH:mm:ss.SSS} [%tid] [%thread] %-5level %logger{36} - %msg%n\"/>

        </GRPCLogClientAppender>

    </Appenders>

    <Loggers>

        

        <Logger name=\"org.springframework\" level=\"WARN\" additivity=\"false\">

            <AppenderRef ref=\"Console\"/>

            <AppenderRef ref=\"GrpcLog\"/>

        </Logger>

        <Root level=\"INFO\">

            <AppenderRef ref=\"Console\"/>

            <AppenderRef ref=\"GrpcLog\"/>

        </Root>

    </Loggers>

</Configuration>

DataKit 开启 SkyWalking 采集器

部署配置 DataKit

在观测云控制台点击「集成」-「DataKit」-「Kubernetes」，运行脚本下载。

wget https://static.guance.com/datakit/datakit.yaml

开启 SkyWalking 采集器

在 volumeMounts 中添加

        - mountPath: /usr/local/datakit/conf.d/skywalking/skywalking.conf

          name: datakit-conf

          subPath: skywalking.conf

          readOnly: true

在 configmap 中增加 SkyWalking 配置

apiVersion: v1

kind: ConfigMap

metadata:

  name: datakit-conf

  namespace: datakit

data:

    skywalking.conf: |-

      [inputs.skywalking]

       endpoints = [\"/v3/trace\", \"/v3/metric\", \"/v3/logging\", \"/v3/profiling\"]

       address = \"0.0.0.0:11800\"

观测云

可以看到链路数据正常上报的观测云空间

链路和日志也通过 trace_id 串联起来

在日志页面也可以反向查询链路数据

总结

通过本文介绍的 Sidecar 模式与 DataKit 相结合的方案，我们成功实现了：

  • 轻量级集成： 以非侵入方式为集群 Java 应用快速赋予了链路追踪能力。
  • 架构简化： 利用 DataKit 替代了 SkyWalking OAP + Storage 的复杂组件，降低了运维成本。
  • 数据融合： 最终在观测云平台上实现了链路追踪数据与应用日志数据的无缝关联与联动查询，形成了完整的可观测性闭环。

收藏 (0) 打赏

感谢您的支持，我会继续努力的!

打开微信/支付宝扫一扫，即可进行扫码打赏哦，分享从这里开始，精彩与您同在
点赞 (0)

申明：本文由第三方发布，内容仅代表作者观点，与本网站无关。对本文以及其中全部或者部分内容的真实性、完整性、及时性本站不作任何保证或承诺，请读者仅作参考，并请自行核实相关内容。本网发布或转载文章出于传递更多信息之目的，并不意味着赞同其观点或证实其描述，也不代表本网对其真实性负责。

左子网 编程相关 云原生架构下微服务接入 SkyWalking 最佳实践 https://www.zuozi.net/35643.html

HashMap核心原理与源码剖析
上一篇： HashMap核心原理与源码剖析
MyBatis 源码深度解析
下一篇： MyBatis 源码深度解析
常见问题

发货方式是什么？

  • 1、自动：拍下后，点击（下载）链接即可下载；2、手动：拍下后，联系卖家发放即可或者联系官方找开发者发货。
查看详情

交易周期是多久呢？

  • 1、源码默认交易周期：手动发货商品为1-3天，并且用户付款金额将会进入平台担保直到交易完成或者3-7天即可发放，如遇纠纷无限期延长收款金额直至纠纷解决或者退款！；
查看详情

能退款么？

  • 1、描述：源码描述(含标题)与实际源码不一致的（例：货不对板）； 2、演示：有演示站时，与实际源码小于95%一致的（但描述中有”不保证完全一样、有变化的可能性”类似显著声明的除外）； 3、发货：不发货可无理由退款； 4、安装：免费提供安装服务的源码但卖家不履行的； 5、收费：价格虚标，额外收取其他费用的（但描述中有显著声明或双方交易前有商定的除外）； 6、其他：如质量方面的硬性常规问题BUG等。 注：经核实符合上述任一，均支持退款，但卖家予以积极解决问题则除外。
查看详情

注意事项

  • 1、左子会对双方交易的过程及交易商品的快照进行永久存档，以确保交易的真实、有效、安全！ 2、左子无法对如“永久包更新”、“永久技术支持”等类似交易之后的商家承诺做担保，请买家自行鉴别； 3、在源码同时有网站演示与图片演示，且站演与图演不一致时，默认按图演作为纠纷评判依据（特别声明或有商定除外）； 4、在没有”无任何正当退款依据”的前提下，商品写有”一旦售出，概不支持退款”等类似的声明，视为无效声明； 5、在未拍下前，双方在QQ上所商定的交易内容，亦可成为纠纷评判依据（商定与描述冲突时，商定为准）； 6、因聊天记录可作为纠纷评判依据，故双方联系时，只与对方在左子上所留的QQ、手机号沟通，以防对方不承认自我承诺。 7、虽然交易产生纠纷的几率很小，但一定要保留如聊天记录、手机短信等这样的重要信息，以防产生纠纷时便于左子介入快速处理。
查看详情

相关文章

猜你喜欢
发表评论
暂无评论
官方客服团队

为您解决烦忧 - 24小时在线 专业服务

联系官方团队 在线提交工单
TA的动态
左子网

分享最新WordPress教程共同学习，共同进步，共同成长！

QQ交流群
左子网

QQ交流群

您的支持，是我们最大的动力！ https://qm.qq.com/q/iR7Nj0TrOg
热门文章
热门标签
随机推荐
热门评论
终身VIP会员限时钜惠
首页 源码 菜单 案例 我的