快速集成Skywalking 9(Windows系统、JavaAgent、Logback)

本文详细介绍了SkyWalking的安装过程,包括下载、解压、启动服务端,以及如何在Java应用中集成SkyWalkingJavaAgent,涉及配置和集成效果。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

一、Skywalking简介

SkyWalking是一个开源的可观察性平台,用于收集、分析、聚合和可视化来自服务和云原生基础设施的数据。SkyWalking提供了一种简单的方法来维护分布式系统的清晰视图,即使是跨云的。它是一个现代APM,专门为云原生的、基于容器的分布式系统而设计,支持对应用端TracinigMetricsLogging的采集和展示。SkyWalking逻辑上分为四个部分:探测器、平台后端、存储和UI,下文中的Skywalking服务端安装主要包括了平台后端、存储(默认内存数据库H2)、UI,探测器则简要介绍了Java Agent集成。
在这里插入图片描述

二、下载Skywalking服务端

进入Skywalking下载页面:https://skywalking.apache.org/downloads/
在这里插入图片描述
点击[tar]下载 apache-skywalking-apm-9.6.0.tar.gz在这里插入图片描述

三、安装Skywalking服务端

关于安装说明可参见:
https://skywalking.apache.org/docs/main/v9.6.0/en/setup/backend/backend-setup/

注: 需本地安装:JDK 11 至 JDK17 均可

3.1 解压安装包

解压apache-skywalking-apm-9.6.0.tar.gz
在这里插入图片描述
SkyWalking的后端发行包由以下部分组成:

  • bin/cmd scripts: 位于/bin文件夹。包括启动Linux shell和Windows cmd脚本后端服务器和UI启动。
  • 后端配置: 位于/config文件夹中,包括后端配置文件:
    • application.yml
    • log4j.xml
    • alarm-settings.yml
  • 后端库: 位于/oap-libs文件夹中,后端的所有依赖项都可以在这里找到。
  • Webapp环境(前端): 位于Webapp文件夹中,UI前端jar文件可以在这里找到,连同它的webapp.yml设置文件

3.2 启动Skywalking

您可以使用bin/startup.bat(或Linux环境sh)以默认设置启动后端和UI,设置如下:

  • 后端存储默认使用H2(为了更容易开始)
  • 后端监听 0.0.0.0/11800的gRPC api0.0.0.0/12800的HTTP REST api
  • UI监听8080端口,请求127.0.0.1/12800运行GraphQL查询

在Java、DotNetCore、Node.js和Istio代理/探测中,
您应该将gRPC服务地址设置为ip/host:11800,
ip/host应该是您的后端所在的位置。

双击运行bin/startup.bat
在这里插入图片描述
运行成功后弹出如下两个窗口:
在这里插入图片描述
其中:

  • Webapp即对应前端UI(位于webapp目录下)
  • Collector即对应后端服务(位于oap-libs目录,配置位于config目录下)

在这里插入图片描述
运行成功后即可访问UI:http://localhost:8080
在这里插入图片描述

四、关于Skywalking服务端更多配置

更多配置可参见:
修改Mysql存储 - https://skywalking.apache.org/docs/main/next/en/setup/backend/backend-setup/#applicationyml
https://skywalking.apache.org/docs/main/next/en/setup/backend/backend-setting-override/

五、Java应用集成skywalking-agent.jar

集成Java Agent可参见:
https://skywalking.apache.org/docs/skywalking-java/v9.0.0/en/setup/service-agent/java-agent/readme/
https://skywalking.apache.org/docs/skywalking-java/v9.0.0/en/setup/service-agent/java-agent/setting-override/

5.1 下载SkyWalking Java Agent

https://www.apache.org/dyn/closer.cgi/skywalking/java-agent/9.0.0/apache-skywalking-java-agent-9.0.0.tgz
在这里插入图片描述

下载apache-skywalking-java-agent-9.0.0.tgz
在这里插入图片描述
解压后:
在这里插入图片描述

5.2 集成JavaAgent

通过Java命令行集成skywalking-agent.jar:

java
# skywalking agent
-javaagent:D:/programs/dev/java/skywalking-agent/skywalking-agent.jar
# 当前服务名
-Dskywalking.agent.service_name=luo-demo::api-sub
# Skywalking后端采集 - gRpc端口
-Dskywalking.collector.backend_service=127.0.0.1:11800
-jar myapp.jar

5.3 Logback集成Skywalking

logback日志集成可参见:
https://skywalking.apache.org/docs/skywalking-java/v9.0.0/en/setup/service-agent/java-agent/application-toolkit-logback-1.x/
https://github.com/apache/skywalking-satellite

maven依赖:

 <!-- logback sw集成 -->
<dependency>
    <groupId>org.apache.skywalking</groupId>
    <artifactId>apm-toolkit-logback-1.x</artifactId>
    <version>9.0.0</version>
</dependency>

resources/logback-spring.xml:

<configuration scan="true" scanPeriod=" 5 seconds">
    <!-- 默认日志配置 -->
    <springProfile name="default">
        <appender name="console" class="ch.qos.logback.core.ConsoleAppender">
            <encoder>
                <pattern>
                    %d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n
                </pattern>
            </encoder>
        </appender>
        <root level="INFO">
            <appender-ref ref="console"/>
        </root>
    </springProfile>

    <!-- SkyWalking配置(注:此处需通过spring.profiles.active=skywalking激活) -->
    <springProfile name="skywalking">
        <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
            <encoder class="ch.qos.logback.core.encoder.LayoutWrappingEncoder">
                <layout class="org.apache.skywalking.apm.toolkit.log.logback.v1.x.mdc.TraceIdMDCPatternLogbackLayout">
                    <Pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%X{tid}] [%thread] %-5level %logger{36} -%msg%n</Pattern>
                </layout>
            </encoder>
        </appender>

        <appender name="ASYNC" class="ch.qos.logback.classic.AsyncAppender">
            <discardingThreshold>0</discardingThreshold>
            <queueSize>1024</queueSize>
            <neverBlock>true</neverBlock>
            <appender-ref ref="STDOUT"/>
        </appender>

        <appender name="grpc-log" class="org.apache.skywalking.apm.toolkit.log.logback.v1.x.log.GRPCLogClientAppender">
            <encoder class="ch.qos.logback.core.encoder.LayoutWrappingEncoder">
                <layout class="org.apache.skywalking.apm.toolkit.log.logback.v1.x.mdc.TraceIdMDCPatternLogbackLayout">
                    <Pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%X{tid}] [%thread] %-5level %logger{36} -%msg%n</Pattern>
                </layout>
            </encoder>
        </appender>

        <root level="INFO">
            <appender-ref ref="ASYNC"/>
            <appender-ref ref="grpc-log"/>
        </root>
    </springProfile>
</configuration>

5.4 集成效果

启动对应Java应用后,再次访问Skywalking UI:
http://localhost:8080

可以发现左侧菜单多出了【常规服务->服务】,切换到此【服务】菜单后,右侧即可查看已接入服务的追踪、日志等监控数据。

在这里插入图片描述

查看服务拓扑:
在这里插入图片描述

查看服务追踪信息:
在这里插入图片描述
查看服务日志:
在这里插入图片描述

### 配置 SkyWalking 9.3 和 Logback集成 对于 SkyWalking 9.3 版本,为了实现与 Logback 日志框架的有效集成并确保日志能够被正确收集和展示,在应用程序的日志配置文件 `logback.xml` 中应加入特定的 appender 定义来启用 gRPC 协议传输日志数据至 SkyWalking OAP Server。 ```xml <configuration> <!-- 其他 logback 设置 --> <appender name="grpc-log" class="org.apache.skywalking.apm.toolkit.log.logback.v1.x.log.GRPCLogClientAppender"/> <root level="info"> <appender-ref ref="grpc-log"/> </root> </configuration> ``` 上述 XML 片段展示了如何向现有的 Logback 配置中添加一个名为 grpc-log 的 appender 来支持通过 gRPC 发送日志给 SkyWalking[^1]。这使得开发人员可以利用 SkyWalking 提供的强大追踪能力分析分布式系统的运行状况的同时也便于排查问题时查看详细的调用链路中的日志信息。 当遇到 Java 应用程序中与 Logback 相关的问题时,除了确认正确的 appender 已经按照前述方式设置外,还需要验证以下几个方面: - **检查依赖库版本兼容性**:确保使用的 SkyWalking Agent 及其配套组件同当前项目所采用的技术栈保持良好的适配关系。 - **校验网络连接情况**:如果发现日志未能正常上报,则可能是由于目标地址不可达造成的;此时应当依据实际情况调整 SW_OAP_ADDRESS 参数指向可访问的服务实例,例如将其修改为 http://oap:12800 形式的 URL 地址[^2]。 - **审查 JVM 启动参数**:启动带有 SkyWalking agent 的 Java 进程时需附加必要的系统属性以指明服务名称和服务端点位置等重要选项,如下所示: ```bash java -javaagent:/path/to/skywalking-agent.jar \ -Dskywalking.agent.service_name=my-service-name \ -Dskywalking.collector.backend_service=oap-server-ip-or-hostname:port \ ... ``` 此命令片段说明了怎样在启动脚本里指定这些关键性的环境变量以便于 SkyWalking 正常工作[^3]。 另外值得注意的是,在 Docker 环境下部署应用时可以通过定制化的 Dockerfile 文件进一步简化这一过程,比如下面的例子就很好地示范了这一点[^4]: ```dockerfile FROM skywalking-agent:latest ENV HOME_PATH=/opt/app WORKDIR ${HOME_PATH} ADD target/my-app.jar . EXPOSE 8080 ENTRYPOINT ["sh", "-c", "java -javaagent:/agent/skywalking-agent.jar \ -DSW_AGENT_NAME=${SERVICE_NAME} \ -DSW_AGENT_COLLECTOR_BACKEND_SERVICES=${OAP_SERVER_ADDR}:11800 \ -jar my-app.jar"] ``` 这段 Dockerfile 展现了一种优雅的方式来管理基于 Spring Boot 构建的应用及其关联的 SkyWalking agent,并允许使用者轻松地自定义诸如服务名 (`${SERVICE_NAME}`) 和 OAP server 地址 (`${OAP_SERVER_ADDR}`) 等外部传入的配置项。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

罗小爬EX

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值