这篇会为你介绍如何使用 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 页面指导 重新启动应用即可。