Skywalking agent配置，微服务接入

文件准备

 

将apache-skywalking-apm-bin-es7/agent文件夹拷贝到发布容器中，位置可以根据情况调整。

 

cp -r ./agent/* /opt/skywalkingAgent

 

文件说明

 

• config/agent.config：为客户端代理配置文件，可以根据系统情况进行响应调整，这里就不详细说明。
• logs：SW agent相关运行情况日志。
• activations: 插件包
• bootstrap-plugins:插件包
• optional-plugins:插件包
• optional-reporter-plugins:插件包
• skywalking-agent.jar：agent代理jar包。

使用方式

 

优先级：探针 > JVM配置 > 系统环境变量 > agent.config

 

一般都使用探针方式，其他方式就不介绍了，配置方式如下：

 

格式1(推荐)：-javaagent:/path/to/skywalking-agent.jar={config1}={value1},{config2}={value2}

 

-javaagent:../skywalking-agent.jar=agent.service_name=fw-gateway,collector.backend_service=127.0.0.1:11800

 

格式2：-Dskywalking.[option1]=[value2]

 

-javaagent:../skywalking-agent.jar -Dskywalking.agent.service_name=fw-gateway -Dskywalking.collector.backend_service=127.0.0.1:11800

 

一般配置下面两项即可：

 

agent.service_name：客户端服务名，在apm系统中显示的服务名称。

collector.backend_service：SW上传的服务地址。

效果

微服务加入了SW Agent配置后启动日志如下：

Connected to the target VM, address: '127.0.0.1:61863', transport: 'socket' 
DEBUG 2020-07-22 17:53:35:179 main AgentPackagePath : The beacon class location is jar:file:/Users/lizz/Documents/workspace/skywalking8/skywalking-agent.jar!/org/apache/skywalking/apm/agent/core/boot/AgentPackagePath.class. 
INFO 2020-07-22 17:53:35:184 main SnifferConfigInitializer : Config file found in /Users/lizz/Documents/workspace/skywalking8/config/agent.config. 
INFO 2020-07-22 17:53:35:534 main SnifferConfigInitializer : Agent options is agent.service_name=fw-gateway,collector.backend_service=10.2.20.12:11800. 
17:53:41.327 [SkywalkingAgent-5-GRPCChannelManager-0] DEBUG org.apache.skywalking.apm.dependencies.io.netty.util.internal.PlatformDependent - Platform: MacOS 
17:53:41.334 [SkywalkingAgent-5-GRPCChannelManager-0] DEBUG org.apache.skywalking.apm.dependencies.io.netty.util.internal.PlatformDependent0 - -Dio.netty.noUnsafe: false 
... 

详细配置：

# 命名空间，用于隔离跨进程传播的header。如果进行了配置，header将为HeaderName:Namespace. 
# agent.namespace=${SW_AGENT_NAMESPACE:default-namespace} 
 
# 展示界面中现实服务名称 
agent.service_name=${SW_AGENT_NAME:lizz-gw}
 
# 每3秒采样道数默认情况下，负或零表示关闭 
agent.sample_n_per_3_secs=${SW_AGENT_SAMPLE:-1}
 
# 鉴权是否开启取决于后端的配置，可查看application.yml的详细描述。对于大多数的场景，需要后端对鉴权进行扩展。目前仅实现了基本的鉴权功能。 
# agent.authentication = ${SW_AGENT_AUTHENTICATION:xxxx} 
 
# 单个线段中的最大跨距量。 
# 通过这个配置项，SkyWalking可以估计应用程序内存开销。 
# agent.span_limit_per_segment=${SW_AGENT_SPAN_LIMIT:150} 
 
# 如果段的操作名称以这些后缀结尾，则忽略这些段。 
# agent.ignore_suffix=${SW_AGENT_IGNORE_SUFFIX:.jpg,.jpeg,.js,.css,.png,.bmp,.gif,.ico,.mp3,.mp4,.html,.svg} 
 
# 如果为true，则SkyWalking代理将在“/debugging”文件夹中保存所有检测到的类文件。 
# SkyWalking可能会要求这些文件，以解决兼容问题。 
# agent.is_open_debugging_class = ${SW_AGENT_OPEN_DEBUG:true} 
 
# 如果为true，SkyWalking代理将把所有检测到的类文件缓存到内存或磁盘文件中（由类缓存模式决定）， 
# 允许其他javaagent增强那些由SkyWalking agent增强的类。 
# agent.is_cache_enhanced_class = ${SW_AGENT_CACHE_CLASS:false} 
 
# 插入指令的类缓存模式：内存或文件 
# 内存：将类字节缓存到内存中，如果插入指令的类太多或太大，则可能会占用更多内存 
# 文件：在“/class cache”文件夹中缓存类字节，当应用程序退出时自动清理缓存的类文件 
# agent.class_cache_mode = ${SW_AGENT_CLASS_CACHE_MODE:MEMORY} 
 
# 操作名称最大长度 
# 注意，在目前的实践中，我们不建议长度超过190。 
# agent.operation_name_threshold=${SW_AGENT_OPERATION_NAME_THRESHOLD:150} 
 
# The agent use gRPC plain text in default. 
# If true, SkyWalking agent uses TLS even no CA file detected. 
# agent.force_tls=${SW_AGENT_FORCE_TLS:false} 
 
# 如果为true，则当用户创建新的配置文件任务时，skywalking代理将启用配置文件。否则禁用配置文件。 
# profile.active=${SW_AGENT_PROFILE_ACTIVE:true} 
 
# 并行监视器段计数 
# profile.max_parallel=${SW_AGENT_PROFILE_MAX_PARALLEL:5} 
 
# 最大监视段时间（分钟），如果当前段监视时间超出限制，则停止它。 
# profile.duration=${SW_AGENT_PROFILE_DURATION:10} 
 
# 最大转储线程堆栈深度 
# profile.dump_max_stack_depth=${SW_AGENT_PROFILE_DUMP_MAX_STACK_DEPTH:500} 
 
# 快照传输到后端缓冲区的大小 
# profile.snapshot_transport_buffer_size=${SW_AGENT_PROFILE_SNAPSHOT_TRANSPORT_BUFFER_SIZE:50} 
 
# skywalking后端服务地址。 
collector.backend_service=${SW_AGENT_COLLECTOR_BACKEND_SERVICES:127.0.0.1:11800}
 
# 日志文件名 
logging.file_name=${SW_LOGGING_FILE_NAME:skywalking-api.log}
 
# 日志记录级别 
logging.level=${SW_LOGGING_LEVEL:WARN}
 
# 日志文件存储目录 
# logging.dir=${SW_LOGGING_DIR:""} 
 
# 日志文件最大值, default: 300 * 1024 * 1024 = 314572800 
# logging.max_file_size=${SW_LOGGING_MAX_FILE_SIZE:314572800} 
 
# 最大历史记录日志文件。当发生滚动时，如果日志文件超过这个数字， 
# 然后删除最旧的文件。默认情况下，负数或零表示禁用。 
# 如果不限制个数可能到只日志文件过大，磁盘爆满。 
logging.max_history_files=${SW_LOGGING_MAX_HISTORY_FILES:5}
 
# 忽略异常，有些异常属于业务需要，不用在sw中标示出来 
# statuscheck.ignored_exceptions=${SW_STATUSCHECK_IGNORED_EXCEPTIONS:} 
 
# 异常链路的跟踪深度，最好不要高于10，对性能有影响 
# statuscheck.max_recursive_depth=${SW_STATUSCHECK_MAX_RECURSIVE_DEPTH:1} 
 
# 增加agent下特定文件夹下的支持插件 
plugin.mount=${SW_MOUNT_FOLDERS:plugins,activations,bootstrap-plugins}
 
# 不加载某些支持插件，名称参考Plugin-list.md 
plugin.exclude_plugins=${SW_EXCLUDE_PLUGINS:dubbo,motan}
 
# 是否获取mysql操作sql的参数 
# plugin.mysql.trace_sql_parameters=${SW_MYSQL_TRACE_SQL_PARAMETERS:false} 
 
# Kafka producer configuration 
# plugin.kafka.bootstrap_servers=${SW_KAFKA_BOOTSTRAP_SERVERS:localhost:9092}
 
# 跟踪Spring中的bean，需要耗费更多的资源 
plugin.springannotation.classname_match_regex=${SW_SPRINGANNOTATION_CLASSNAME_MATCH_REGEX:}

windos环境--在IDEA中配置SkyWalking

在运行的程序配置jvm参数，如下图所示：

配置：

-javaagent:D:\soft\worksoft\skywalking\agent\skywalking-agent.jar -DSW_AGENT_NAME=tag -DSW_AGENT_COLLECTOR_BACKEND_SERVICES=10.200.60.63:11800

-javaagent:D:\soft\worksoft\skywalking\skywalking-agent.jar -Dskywalking.collector.backend_service=10.200.60.63:11800 -Dskywalking.agent.service_name=tag

结果：

我的skywalking安装在centos7上，ide在windows上，ide配置如上内容后，也无法启动成功。

INFO 2021-11-25 20:19:51:137 main AgentClassLoader : D:\soft\worksoft\skywalking\agent\activations\apm-toolkit-trace-activation-8.4.0.jar loaded. 
ERROR 2021-11-25 20:19:51:139 main SkyWalkingAgent : Enhance class org.springframework.beans.BeanWrapperImpl error. org.apache.skywalking.apm.agent.core.plugin.PluginException: Can't create InstanceMethodsAroundInterceptor. 
at org.apache.skywalking.apm.agent.core.plugin.interceptor.enhance.InstMethodsInterWithOverrideArgs.<init>(InstMethodsInterWithOverrideArgs.java:53) at org.apache.skywalking.apm.agent.core.plugin.interceptor.enhance.ClassEnhancePluginDefine.enhanceInstance(ClassEnhancePluginDefine.java:170) 
at org.apache.skywalking.apm.agent.core.plugin.interceptor.enhance.ClassEnhancePluginDefine.enhance(ClassEnhancePluginDefine.java:74) at org.apache.skywalking.apm.agent.core.plugin.AbstractClassEnhancePluginDefine.define(AbstractClassEnhancePluginDefine.java:89) 
at org.apache.skywalking.apm.agent.SkyWalkingAgent$Transformer.transform(SkyWalkingAgent.java:156)

改用jar形式，可以启动成功。

java -javaagent:D:\soft\worksoft\skywalking\agent\skywalking-agent.jar -DSW_AGENT_NAME=tag -DSW_AGENT_COLLECTOR_BACKEND_SERVICES=10.200.60.63:11800 -jar tag-202111261002.jar