3、Skywalking的初识-客户端配置

概述

客户端在接入Skywalking的时候，有2个基本步骤：

1. 部署其JavaAgent jar包以及对应的埋点插件和配置
2. 在应用实例启动的vm参数中指定Agent jar包的位置

部署Skywalking Agent

下载并解压skywalking 部署包，其包中有server端使用的内容，也有客户端使用；对于应用接入Skywalking来说，只需要/agent这个目录中的文件，其他的兄弟目录可以删除。

修改Skywalking Agent的常见配置

在SkyWalking发行包中查找agent/config/agent.config这个配置文件
修改应用名称

agent.service_name=${SW_AGENT_NAME:Your_ApplicationName}

修改oap地址：

collector.backend_service=${SW_AGENT_COLLECTOR_BACKEND_SERVICES:127.0.0.1:11800}

如果使用Kafka，则修改kafka地址：

plugin.kafka.bootstrap_servers=${SW_KAFKA_BOOTSTRAP_SERVERS:localhost:9092}
plugin.kafka.producer_config[delivery.timeout.ms]=120000
plugin.kafka.get_topic_timeout=${SW_GET_TOPIC_TIMEOUT:10}

修改采样率：

agent.sample_n_per_3_secs=${SW_AGENT_SAMPLE:-1}

这个参数的作用是，每3秒取多少次采样；默认情况下-1，代表全采样；这个值可通过Skywalking的动态配置功能来实现运行期的动态调整。

修改日志:

#调试阶段可将日志级别修改为DEBUG
logging.level=${SW_LOGGING_LEVEL:INFO}
# Logging max_file_size, default: 300 * 1024 * 1024 = 314572800
logging.max_file_size=${SW_LOGGING_MAX_FILE_SIZE:314572800}
#根据磁盘情况控制历史日志文件的数量。默认是-1
logging.max_history_files=${SW_LOGGING_MAX_HISTORY_FILES:3}

更多参数参考 : 官方文档

修改应用启动时的VM参数

添加-javaagent:/path/to/skywalking-package/agent/skywalking-agent.jar到JVM参数。并确保将其添加到-jar参数之前,如：

java -javaagent:/path/to/skywalking-agent/skywalking-agent.jar -jar yourApp.jar

也可以通过VM参数skywalking.agent.service_name指定应用名称

java -javaagent:/path/to/skywalking-agent/skywalking-agent.jar -Dskywalking.agent.service_name=myApp
 -jar yourApp.jar

查看Agent的运行日志

默认情况下 skywalking 插件的日志在/agent/logs/skywalking-api.log。可以在配置文件中指定日志的目录以及日志级别。
在应用启动后，可以在这个日志中查看加载的插件清单，并通过错误日志来排查异常，这里需注意有些错误日志是DEBUG级别的。