TIPS
本文基于 Skywalking 6.6.0 编写，除特别注明的小节外，理论支持 Skywalking 6.0+。
本文详细探讨 Java Agent 的配置。
Java Agent 支持的配置属性
TIPS
本表格基于 Skywalking 6.6.0，官方文档详见：
https://github.com/apache/skywalking/blob/v6.6.0/docs/en/setup/service-agent/java-agent/README.md，其他版本配置项 不完全相同，请自行将链接中的v6.6.0修改成你所使用的版本。
| 属性名 | 描述 | 默认值 |
|---|---|---|
agent.namespace |
命名空间，用于隔离跨进程传播的 header。如果进行了配置，header 将为HeaderName:Namespace. |
未设置 |
agent.service_name |
在 SkyWalking UI 中展示的服务名。5.x 版本对应 Application，6.x 版本对应 Service。建议：为每个服务设置个唯一的名字，服务的多个服务实例为同样的服务名 | Your_ApplicationName |
agent.sample_n_per_3_secs |
负数或 0 表示不采样，默认不采样。SAMPLE_N_PER_3_SECS 表示每 3 秒采样 N 条。 | 未设置 |
agent.authentication |
鉴权是否开启取决于后端的配置，可查看 application.yml 的详细描述。对于大多数的场景，需要后端对鉴权进行扩展。目前仅实现了基本的鉴权功能。 | 未设置 |
agent.span_limit_per_segment |
单个 segment 中的 span 的最大个数。通过这个配置项，Skywalking 可评估应用程序内存使用量。 | 300 |
agent.ignore_suffix |
如果这个集合中包含了第一个 span 的操作名，这个 segment 将会被忽略掉。 | 未设置 |
agent.is_open_debugging_class |
如果为 true，skywalking 会将所有经 Instrument 转换过的类文件保存到 /debugging 文件夹下。Skywalking 团队会要求你提供这些类文件以解决兼容性问题。 |
未设置 |
agent.active_v2_header |
是否默认使用 v2 版本的 header。 | true |
agent.instance_uuid |
实例 id。skywalking 会将实例 id 相同的看做一个实例。如果为空，skywalking agent 会生成一个 32 位的 uuid。 | "" |
agent.instance_properties[key]=value |
添加服务实例的定制属性。 | 未设置 |
agent.cause_exception_depth |
agent 记录的异常时，代理进入的深度 | 5 |
agent.active_v1_header |
是否默认使用 v1 版本的 header。 | false |
agent.cool_down_threshold |
收到 reset 命令后，代理应等待多久（以分钟为单位）才能重新注册到 OAP 服务器。 | 10 |
agent.force_reconnection_period |
根据 grpc_channel_check_interval 强制重新连接 grpc。 | 1 |
agent.operation_name_threshold |
operationName 最大长度，不建议将此值设置为 > 500。 | 500 |
collector.grpc_channel_check_interval |
检查 grpc 的 channel 状态的时间间隔。 | 30 |
collector.app_and_service_register_check_interval |
检查应用和服务的注册状态的时间间隔。 | 3 |
collector.backend_service |
接收 skywalking trace 数据的后端地址 | 127.0.0.1:11800 |
collector.grpc_upstream_timeout |
grpc 客户端向上游发送数据时的超时时间，单位秒。 |
30 秒 |
logging.level |
日志级别。默认为 debug。 | DEBUG |
logging.file_name |
日志文件名 | skywalking-api.log |
logging.output |
日志输出，默认 FILE。CONSOLE 表示输出到 stdout。 | FILE |
logging.dir |
日志目录。默认为空串，表示使用 ”system.out” 输出日志。 | "" |
logging.pattern |
日志记录格式。所有转换说明符：<br/> * %level 表示日志级别。<br/> * %timestamp 表示现在的时间，格式yyyy-MM-dd HH:mm:ss:SSS。<br/> * %thread 表示当前线程的名称。<br/> * %msg 表示消息。<br/> * %class 表示 TargetClass 的 SimpleName。<br/> * %throwable 表示异常。<br/> * %agent_name 表示agent.service_name
|
%level %timestamp %thread %class : %msg %throwable |
logging.max_file_size |
日志文件的最大大小。当日志文件大小超过这个数，归档当前的日志文件，将日志写入到新文件。 | 300 * 1024 * 1024 |
logging.max_history_files |
最大历史记录日志文件。发生翻转时，如果日志文件超过此值，则最早的文件将被删除。默认情况下，负数或零表示关闭。 | -1 |
jvm.buffer_size |
收集 JVM 信息的 buffer 的大小。 | 60 * 10 |
buffer.channel_size |
buffer 的 channel 大小。 | 5 |
buffer.buffer_size |
buffer 的大小 | 300 |
dictionary.service_code_buffer_size |
The buffer size of application codes and peer | 10 * 10000 |
dictionary.endpoint_name_buffer_size |
The buffer size of endpoint names and peer | 1000 * 10000 |
plugin.peer_max_length |
Peer 最大描述限制 | 200 |
plugin.mongodb.trace_param |
如果为 true，记录所有访问 MongoDB 的参数信息。默认为 false，表示仅记录操作名，不记录参数信息。 | false |
plugin.mongodb.filter_length_limit |
如果设为正数，WriteRequest.params 将被截断为该长度，否则将被完全保存，这可能会导致性能问题。 |
256 |
plugin.elasticsearch.trace_dsl |
如果为 true，记录所有访问 ElasticSearch 的 DSL 信息。默认为 false。 | false |
plugin.springmvc.use_qualified_name_as_endpoint_name |
如果为 true，endpoint 的 name 为方法的全限定名，而不是请求的 URL。默认为 false。 | false |
plugin.toolit.use_qualified_name_as_operation_name |
如果为 true，operation 的 name 为方法的全限定名，而不是给定的 operation name。默认为 false。 | false |
plugin.mysql.trace_sql_parameters |
如果设置为 true，则将收集 sql 的参数（通常为java.sql.PreparedStatement）。 |
false |
plugin.mysql.sql_parameters_max_length |
如果设置为正数，db.sql.parameters 将被截断为该长度，否则将被完全保存，这可能会导致性能问题。 |
512 |
plugin.postgresql.trace_sql_parameters |
如果设置为 true，则将收集 sql 的参数（通常为java.sql.PreparedStatement）。 |
false |
plugin.postgresql.sql_parameters_max_length |
如果设置为正数，db.sql.parameters 将被截断为该长度，否则将被完全保存，这可能会导致性能问题。 |
512 |
plugin.solrj.trace_statement |
如果为 true，则在 Solr 查询请求中跟踪所有查询参数（包括 deleteByIds 和 deleteByQuery） | false |
plugin.solrj.trace_ops_params |
如果为 true，则跟踪 Solr 请求中的所有操作参数 | false |
plugin.light4j.trace_handler_chain |
如果为 true，请跟踪 Light4J 的请求的所有中间件 / 业务 handler。 | false |
plugin.opgroup.* |
支持操作名称自定义不同插件中的组的规则。详见 支持组规则的插件 | 未设置 |
plugin.springtransaction.simplify_transaction_definition_name |
设为 true，则简化事务定义名称。 | false |
plugin.jdkthreading.threading_class_prefixes |
将对名称与任意一个 THREADING_CLASS_PREFIXES (多个使用 , 分隔)匹配的线程化类（java.lang.Runnable 和 java.util.concurrent.Callable）及其子类进行 Instrument，请确保仅将窄前缀指定为您希望 Instrument 的前缀（安全考虑，java. 和 javax. 将被忽略） |
未设置 |
Java Agent 配置方式
agent 配置有多种姿势，上面修改 agent.config 文件中的值，只是其中一种。下面专门探讨 agent 支持的配置方式。
系统属性(-D)
使用 -Dskywalking. + agent.config 配置文件中的 key 即可。例如：
agent.config 文件中有一个属性名为 agent.service_name，那么如果使用系统属性的方式，则可以写成
java -javaagent:/opt/agent/skywalking-agent.jar -Dskywalking.agent.service_name= 你想设置的值 -jar somr-spring-boot.jar代理选项
在 JVM 参数中的代理路径之后添加属性即可。格式：
-javaagent:/path/to/skywalking-agent.jar=[option1]=[value1],[option2]=[value2]例如：
java -javaagent:/opt/agent/skywalking-agent.jar=agent.service_name= 你想设置的值 -jar somr-spring-boot.jar系统环境变量
agent.config 文件中默认的大写值，都可以作为环境变量引用。例如，agent.config 中有如下内容
agent.service_name=${SW_AGENT_NAME:Your_ApplicationName}这说明 Skywalking 会读取名为 SW_AGENT_NAME 的环境变量。
优先级
代理选项 > 系统属性（-D） > 系统环境变量 > 配置文件
参考文档
https://github.com/apache/sky…
本文首发
http://www.itmuch.com/skywalk…
本文由博客一文多发平台 OpenWrite 发布！