腾讯云可观测平台 通过 SkyWalking 协议接入 Java 应用

这篇说说如何使用SkyWalking协议上报Java应用数据,实现从开源SkyWalking迁移至腾讯云APM,包括前提条件、接入步骤及三种配置方式。 前提条件:下载SkyWalking 8.5.0以上版本,解压Agent文件夹至可访问目录。 接入步骤:获取接入点和Token,配置agent.config、Java VM Options或环境变量,选择方法指定插件路径后重启应用。 配置方式:配置文件、Java VM 。

相关产品
腾讯云可观测平台 产品页,含版本规格、价格与购买入口。

这篇会为你介绍如何使用 SkyWalking 协议上报 Java 应用数据。

注意:说明:

注意:该方案适用于将开源 SkyWalking 快速迁移至腾讯云应用性能监控 APM,构建最基础的应用可观测能力。建议后期切换为腾讯云增强版 OpenTelemetry Java 探针方案,以获得 K8s 环境一键接入、应用诊断、探针配置推送、应用安全等完整的全栈可观测能力。更多详情请参见 K8s 环境自动接入 Java 应用 (推荐) 和 通过腾讯云增强版 OpenTelemetry Java 探针接入(推荐)。

一、前提条件

·打开 SkyWalking 下载页面,下载 SkyWalking 8.5.0 以上的(包含8.5.0)版本,并将解压后的 Agent 文件夹放至 Java 进程有访问权限的目录。

·插件均放置在/plugins 目录中。在启动阶段将新的插件放进该目录,即可令插件生效。将插件从该目录删除,即可令其失效。另外,日志文件默认输出到/logs 目录中。

·新的 Agent 文件夹目录如下所示:

新 Agent 文件夹目录+– agent +– activations apm-toolkit-log4j-1.x-activation.jar apm-toolkit-log4j-2.x-activation.jar apm-toolkit-logback-1.x-activation.jar ……. +– config agent.config +– plugins apm-dubbo-plugin.jar apm-feign-default-http-9.x.jar apm-httpClient-4.x-plugin.jar ……. +– optional-plugins apm-gson-2.x-plugin.jar ……. +– bootstrap-plugins jdk-http-plugin.jar …… +– logs skywalking-agent.jar

二、步骤1:获取接入点和 Token

1. 登录 腾讯云可观测平台 控制台。

2. 在左侧菜单栏中选择应用性能监控,单击应用列表 > 接入应用。

3. 在右侧弹出的数据接入抽屉框中,单击 Java 语言。

4. 在接入 Java 应用页面,选择你所要接入的地域以及业务系统。

5. 选择接入协议类型为 SkyWalking。

6. 选择你所想要的上报方式,获取你的接入点和 Token。

注意:说明:

三、步骤2:下载 SkyWalking

·若你已经使用了 SkyWalking,可跳过本步骤。

·若你还未使用 SkyWalking,建议 下载最新版本,下载方式参见 前提条件。

四、步骤3:配置相应参数及名称

SkyWalking Agent 支持多种方式完成参数配置,不同配置方式之间可以彼此组合,下面给出配置方式及其示例。

五、方法1:使用 agent.config 文件配置

打开 agent/config/agent.config 文件,配置接入点、Token 和自定义服务名称。

collector.backend_service=<接入点>agent.authentication=<Token>agent.service_name=<上报的服务名称>

注意:说明:

注意:修改完 agent.config 需要把配置项前的反注释符号#去掉。否则更改的信息将无法生效。

六、方法2:Java VM Options

启动 Java 应用程序时,在命令行中添加相应以 -DSkywalking 开头的参数,以下给出方法一的等效范例。

java -javaagent:<skywalking-agent-path>/skywalking-agent.jar -Dskywalking.collector.backend_service=<接入点>-Dskywalking.agent.authentication=<Token>-Dskywalking.agent.service_name=<上报的服务名称> 要启动的程序

七、方法3:设置相应环境变量

可以在系统中设置相应环境变量来完成 SkyWalking 客户端的配置,以下为 Linux 命令的示例。

export SW_AGENT_AUTHENTICATION=<Token> (等效于agent.authentication=Token)export SW_AGENT_NAME=<上报的服务名称> (等效于agent.service_name=<上报的服务名称>)export SW_AGENT_COLLECTOR_BACKEND_SERVICES=<接入点>(等效于collector.backend_service=接入点)

八、步骤4:选择相应方法指定插件路径

根据应用的运行环境,选择相应的方法来指定 SkyWalking Agent 的路径。

·Linux Tomcat 7/Tomcat 8
在 tomcat/bin/catalina.sh 第一行添加以下内容:

CATALINA_OPTS="$CATALINA_OPTS -javaagent:<skywalking-agent-path>"; export CATALINA_OPTS

·Jetty

在{JETTY_HOME}/start.ini配置文件中添加以下内容:

–exec # 去掉前面的井号取消注释。 -javaagent:<skywalking-agent-path>

·JAR File 或 Spring Boot
在应用程序的启动命令行中添加 -javaagent 参数(-javaagent 参数一定要放在 -jar 参数之前),参数内容如下:

java -javaagent:<skywalking-agent-path> -jar yourApp.jar

·IDEA

在 IDEA 中运行时,可在 Configuration 中配置应用程序的 VM option,添加 -javaagent 参数,参数配置与上述一致。

九、步骤5:重新启动应用

完成上述部署步骤后,参见 SkyWalking 页面指导 重新启动应用即可。

赞 (0)
上一篇 4天前
下一篇 4天前