Skywalking Learning
下载安装:
TIP:
- JDK版本在JDK 8 - JDK 12之间
- 注意:如使用
ElasticSearch7
的版本,那么需要JDK 11+
- 确保如下端口可用:
- 11800:和Skywalking通信的gRPC端口
- 12800:和Skywalking通信的HTTP端口
- 8080:UI所占用的端口
一、集群安装
1、下载安装包
最新版本下载地址:http://skywalking.apache.org/downloads/
历史版本下载地址:https://archive.apache.org/dist/skywalking/
2、上传并解压文件:
# 切换到对应安装目录,并执行解压操作
# 对解压文件进行重命名,此操作非必要
tar -zxvf apache-skywalking-apm-6.6.0.tar.gz
mv apache-skywalking-apm-bin skywalking-6.6.0
3、安装ES集群
配置Es集群:详见ES集群配置资料
demo:在服务器172.16.203.77 172.16.203.78 172.16.203.79分别安装es,并配置为集群架构
172.16.203.77:9200,172.16.203.78:9200,172.16.203.79:9200
4、修改SkyWalking配置文件:
application.yml配置修改
vim ...../skywalking/config/application.yml
1、其中 gRPCHost改成本机服务器IP
core:
selector: ${SW_CORE:default}
default:
gRPCHost: ${SW_CORE_GRPC_HOST:172.16.203.77} # 指定本机IP
2、其中存储为es
storage:
selector: ${SW_STORAGE:elasticsearch}
elasticsearch:
nameSpace: ${SW_NAMESPACE:""}
clusterNodes: ${SW_STORAGE_ES_CLUSTER_NODES:172.16.203.77:9200,172.16.203.78:9200,172.16.203.79:9200} # 执行ES集群地址,TIP:可以为单节点
collector 集群
# 在不同机器上启动Collector
demo:172.16.203.76 172.16.203.77 172.16.203.78
TIP:将上述解压配置文件分配到三台服务器对应目录,并将上述application.yml文件中gRPCHost: ${SW_CORE_GRPC_HOST:172.16.203.77}进行相应修改
# 分别在三台服务器中执行启动命令:
cd /usr/local/skywalking/bin/sh oapService.sh
dashboard配置及启动
- 配置文件修改:…/skywalking/webapp/webapp.yml
vim ...../skywalking/webapp/webapp.yml
server:
port: 18080 #web端口
collector:
path: /graphql
ribbon:
ReadTimeout: 10000
# Point to all backend's restHost:restPort, split by ,
listOfServers: 172.16.203.76:12800,172.16.203.77:12800,172.16.203.78:12800 # 配置collector地址
- 启动dashboard
cd ..../skywalking/bin/
./webappService.sh
- **停止skywalking web **
ps -ef|grep skywalking-webapp
kill -9 pid
5、访问web:
http://IP:18080/,出现如下界面,表示安装配置成功
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-GJPRgCsw-1604998823737)(/Users/mbw/Library/Application Support/typora-user-images/image-20201109183616669.png)]
二、单机安装:
1、下载安装包
最新版本下载地址:http://skywalking.apache.org/downloads/
历史版本下载地址:https://archive.apache.org/dist/skywalking/
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-0GjV9Oxd-1604998823739)(/Users/mbw/Library/Application Support/typora-user-images/image-20201109182223112.png)]
2、上传并解压文件:
# 切换到对应安装目录,并执行解压操作
# 对解压文件进行重命名,此操作非必要
tar -zxvf apache-skywalking-apm-6.6.0.tar.gz
mv apache-skywalking-apm-bin skywalking-6.6.0
3、安装ES集群
配置Es集群:详见ES集群配置资料
demo:在服务器172.16.203.77 172.16.203.78 172.16.203.79分别安装es,并配置为集群架构
172.16.203.77:9200,172.16.203.78:9200,172.16.203.79:9200
4、修改SkyWalking配置文件:
application.yml配置修改
vim ...../skywalking/config/application.yml
1、其中 gRPCHost改成本机服务器IP
core:
selector: ${SW_CORE:default}
default:
gRPCHost: ${SW_CORE_GRPC_HOST:172.16.203.77} # 指定本机IP
2、其中存储为es
storage:
selector: ${SW_STORAGE:elasticsearch}
elasticsearch:
nameSpace: ${SW_NAMESPACE:""}
clusterNodes: ${SW_STORAGE_ES_CLUSTER_NODES:172.16.203.77:9200,172.16.203.78:9200,172.16.203.79:9200} # 执行ES集群地址,TIP:可以为单节点
5、dashboard配置及启动*
- 配置文件修改:…/skywalking/webapp/webapp.yml
vim ...../skywalking/webapp/webapp.yml
server:
port: 18080 #web端口
collector:
path: /graphql
ribbon:
ReadTimeout: 10000
# Point to all backend's restHost:restPort, split by ,
listOfServers: 172.16.203.77:12800 # 配置collector地址
启动
cd apache-skywalking-apm-bin/bin
sh startup.sh
Skywalking使用
配置 java agent
- 找到SkyWalking包中的
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
.....
skywalking-agent.jar
- 将
agent
目录拷贝到任意位置 - 配置
config/agent.config
:
- 将
agent.service_name
修改成你的微服务名称; - 如果Skywalking和微服务部署在不同的服务器,还需修改
collector.backend_service
的值,该配置用来指定微服务和Skywalking通信的地址,默认是127.0.0.1:11800
,按需修改即可。当然agent.config
文件里面有很多的配置,本文下面的表格有详细讲解。
配置属性
属性名 | 描述 | 默认值 |
| 命名空间,用于隔离跨进程传播的header。如果进行了配置,header将为 | 未设置 |
| 在SkyWalking UI中展示的服务名。5.x版本对应Application,6.x版本对应Service。 建议:为每个服务设置个唯一的名字,服务的多个服务实例为同样的服务名 |
|
| 负数或0表示不采样,默认不采样。SAMPLE_N_PER_3_SECS表示每3秒采样N条。 | 未设置 |
| 鉴权是否开启取决于后端的配置,可查看application.yml的详细描述。对于大多数的场景,需要后端对鉴权进行扩展。目前仅实现了基本的鉴权功能。 | 未设置 |
| 单个segment中的span的最大个数。通过这个配置项,Skywalking可评估应用程序内存使用量。 | 300 |
| 如果这个集合中包含了第一个span的操作名,这个segment将会被忽略掉。 | 未设置 |
| 如果为true,skywalking会将所有经Instrument转换过的类文件保存到 | 未设置 |
| 是否默认使用v2版本的header。 |
|
| 实例id。skywalking会将实例id相同的看做一个实例。如果为空,skywalking agent会生成一个32位的uuid。 |
|
| 添加服务实例的定制属性。 | 未设置 |
| agent记录的异常时,代理进入的深度 | 5 |
| 是否默认使用v1版本的header。 |
|
| 收到reset命令后,代理应等待多久(以分钟为单位)才能重新注册到OAP服务器。 |
|
| 根据grpc_channel_check_interval强制重新连接grpc。 |
|
| operationName最大长度,不建议将此值设置为> 500。 |
|
| 检查grpc的channel状态的时间间隔。 |
|
| 检查应用和服务的注册状态的时间间隔。 |
|
| 接收skywalking trace数据的后端地址 |
|
| grpc客户端向上游发送数据时的超时时间,单位秒。 |
|
| 日志级别。默认为debug。 |
|
| 日志文件名 |
|
| 日志输出,默认FILE。CONSOLE表示输出到stdout。 |
|
| 日志目录。默认为空串,表示使用”system.out”输出日志。 |
|
| 日志记录格式。所有转换说明符: * |
|
| 日志文件的最大大小。当日志文件大小超过这个数,归档当前的日志文件,将日志写入到新文件。 |
|
| 最大历史记录日志文件。发生翻转时,如果日志文件超过此值,则最早的文件将被删除。默认情况下,负数或零表示关闭。 |
|
| 收集JVM信息的buffer的大小。 |
|
| buffer的channel大小。 |
|
| buffer的大小 |
|
| The buffer size of application codes and peer |
|
| The buffer size of endpoint names and peer |
|
| Peer最大描述限制 |
|
| 如果为true,记录所有访问MongoDB的参数信息。默认为false,表示仅记录操作名,不记录参数信息。 |
|
| 如果设为正数, |
|
| 如果为true,记录所有访问ElasticSearch的DSL信息。默认为false。 |
|
| 如果为true,endpoint的name为方法的全限定名,而不是请求的URL。默认为false。 |
|
| 如果为true,operation的name为方法的全限定名,而不是给定的operation name。默认为false。 |
|
| 如果设置为true,则将收集sql的参数(通常为 |
|
| 如果设置为正数, |
|
| 如果设置为true,则将收集sql的参数(通常为 |
|
| 如果设置为正数, |
|
| 如果为true,则在Solr查询请求中跟踪所有查询参数(包括deleteByIds和deleteByQuery) |
|
| 如果为true,则跟踪Solr请求中的所有操作参数 |
|
| 如果为true,请跟踪Light4J的请求的所有中间件/业务handler。 |
|
| 支持操作名称自定义不同插件中的组的规则。详见 支持组规则的插件 | 未设置 |
| 设为true,则简化事务定义名称。 | false |
| 将对名称与任意一个 | 未设置 |
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)` > `系统环境变量` > `配置文件
启动应用
java -jar
启动的应用
- 执行如下命令启动
# 注意-javaagent得在-jar之前哦
java -javaagent:/opt/agent/skywalking-agent.jar -jar somr-spring-boot.jar
- idea
Java Agent插件
Java Agent是插件化、可插拔的。Skywalking的插件分为三种:
- 引导插件:在agent的
bootstrap-plugins
目录下 - 内置插件:在agent的
plugins
目录下 - 可选插件:在agent的
optional-plugins
目录下
Java Agent只会启用 plugins
目录下的所有插件,bootstrap-plugins
目录以及 optional-plugins
目录下的插件不会启用。如需启用引导插件或可选插件,只需将JAR包移到 plugins
目录下,如需禁用某款插件,只需从 plugins
目录中移除即可。
插件生态
引导插件
目前只有两款引导插件:
-
apm-jdk-http-plugin
用来是监测HttpURLConnection; -
apm-jdk-threading-plugin
用来监测Callable以及Runnable;
有关引导插件的功能描述,可详见: https://github.com/apache/skywalking/blob/v6.6.0/docs/en/setup/service-agent/java-agent/README.md#bootstrap-class-plugins
。
内置插件
内置插件主要用来为业界主流的技术与框架提供支持。所支持的技术&框架,详见 https://github.com/apache/skywalking/blob/v6.6.0/docs/en/setup/service-agent/java-agent/Supported-list.md
。
可选插件
关于可选插件的功能描述,可详见 https://github.com/apache/skywalking/blob/v6.6.0/docs/en/setup/service-agent/java-agent/README.md
。
插件扩展
Skywalking生态还有一些插件扩展,例如Oracle、Resin插件等。这部分插件主要是由于许可证不兼容/限制,Skywalking无法将这部分插件直接打包到Skywalking安装包内,于是托管在这个地址: https://github.com/SkyAPM/java-plugin-extensions
,使用方式:
- 前往
https://github.com/SkyAPM/java-plugin-extensions/releases
,下载插件JAR包 - 将JAR包挪到
plugins
目录即可启用。
参考资料
周立的博客:http://www.itmuch.com/skywalking/skywalking-install/
调用链路选型:
https://www.jianshu.com/p/0fbbf99a236e
https://www.jianshu.com/p/4fa81b661f55