Commit f27ee281 authored by 马超's avatar 马超

doc: 文档补充和修改

parent 01d13a37
...@@ -31,20 +31,78 @@ tar -zxvf apache-skywalking-java-agent-8.8.0.tgz ...@@ -31,20 +31,78 @@ tar -zxvf apache-skywalking-java-agent-8.8.0.tgz
```shell ```shell
├── config/agent.config # 为客户端代理配置文件,可以根据系统情况进行响应调整 ├── config/agent.config # 为客户端代理配置文件,可以根据系统情况进行响应调整
├── logs # SW agent相关运行情况日志。 ├── logs # SW agent相关运行情况日志。
├── activations # 插件包 ├── activations # 可选插件包
├── bootstrap-plugins # 插件包 ├── bootstrap-plugins # 可选插件包
├── optional-plugins # 插件包 ├── optional-plugins # 可选插件包
├── optional-reporter-plugins # 插件包 ├── optional-reporter-plugins # 可选插件包
├── plugins # 插件目录
├── skywalking-agent.jar # agent代理jar包。 ├── skywalking-agent.jar # agent代理jar包。
``` ```
## 启动 ## 启动
JAR包 使用命令行启动应用时,添加-javaagent参数。比如: **1)、前置工作**
添加SpringCloud支持,将optional-plugins目录下的`apm-spring-cloud-gateway-2.1.x-plugin-8.8.0.jar`拷贝到plugins目录下。
如果想在SkyWalking上看日志,需要修改工程pom文件
```xml
<!-- 在pom中添加skywalking 日志支持 -->
<dependency>
<groupId>org.apache.skywalking</groupId>
<artifactId>apm-toolkit-logback-1.x</artifactId>
<version>8.8.0</version>
</dependency>
```
并在logback.xml文件中添加以下内容
```xml
<!-- skywalking -->
<appender name="skywalking-log" class="org.apache.skywalking.apm.toolkit.log.logback.v1.x.log.GRPCLogClientAppender">
<!-- 日志输出编码 -->
<encoder>
<!--格式化输出:%d表示日期,%thread表示线程名,%-5level:级别从左显示5个字符宽度%msg:日志消息,%n是换行符-->
<pattern>%date [%level] [%thread] %logger{60} [%file : %line] %msg%n</pattern>
</encoder>
</appender>
```
将appender添加到root标签中
```xml
<root level="INFO">
<appender-ref ref="CONSOLE"/>
<appender-ref ref="InfoLogFile"/>
<appender-ref ref="ErrorLogFile"/>
<!-- 添加skywalking日志 -->
<appender-ref ref="skywalking-log"/>
</root>
```
**2)、带agent启动**
JAR包 使用命令行启动应用时,添加-javaagent参数。需要在参数上指定服务名 `agent.service_name`,指定SkyWalking后台地址和端口`collector.backend_service`
```java ```java
base-service 服务: base-service 服务:
java -javaagent:/agent解压路径/skywalking-agent.jar=agent.service_name=base-service,collector.backend_service=sinra-server0:8009 -jar /jar路径/base-startup-1.0-SNAPSHOT.jar java -javaagent:/agent绝对路径/skywalking-agent.jar=agent.service_name=base-service,collector.backend_service=sinra-server0:11800 -jar /jar路径/base-startup-1.0-SNAPSHOT.jar
```
**3)、LDP安装包配置文件boot.conf**
LDP安装包`ldp-manage/conf/boot.conf`中新增了关于SkyWalking的配置,配合tool目录脚本可以非常简单的实现是否启用代理模式启动
```shell
NACOS_SERVER=nacos-server0:8018
SPRING_PROFILES_ACTIVE=prod
DUBBO_PROTOCOL_HOST=ldp-server0
DEPLOY_ENV=prod
# SkyWalking地址
SKYWALKING_SERVICE=ldp-server0:11800
SKYWALKING_START=false
SKYWALKING_URL=/alidata/skywalking-agent/agent/skywalking-agent.jar
``` ```
## Agent的可配置属性列表 ## Agent的可配置属性列表
......
...@@ -157,7 +157,7 @@ storage: ...@@ -157,7 +157,7 @@ storage:
asyncBatchPersistentPoolSize: ${SW_STORAGE_ASYNC_BATCH_PERSISTENT_POOL_SIZE:4} asyncBatchPersistentPoolSize: ${SW_STORAGE_ASYNC_BATCH_PERSISTENT_POOL_SIZE:4}
``` ```
切换到mysql需要修改h2 为mysql,并修改mysql的链接地址、用户名、密码。 切换到mysql需要修改h2 为mysql,创建数据库,并修改mysql的链接地址、用户名、密码,
```yml ```yml
selector: ${SW_STORAGE:mysql} selector: ${SW_STORAGE:mysql}
...@@ -165,7 +165,7 @@ selector: ${SW_STORAGE:mysql} ...@@ -165,7 +165,7 @@ selector: ${SW_STORAGE:mysql}
**PS:SkyWalking没有mysql驱动,需要根据自己需要将驱动下载或拷贝到oap-libs目录下** **PS:SkyWalking没有mysql驱动,需要根据自己需要将驱动下载或拷贝到oap-libs目录下**
参考样例: 参考样例(需要根据版本下载对应版本驱动)
```shell ```shell
# 切换到oap-libs目录下 # 切换到oap-libs目录下
...@@ -233,7 +233,9 @@ cd bin ...@@ -233,7 +233,9 @@ cd bin
./webappService.sh ./webappService.sh
``` ```
服务启动好后,访问:http://部署服务器ip/8080 服务启动好后,访问:http://部署服务器ip/8080,可以看到SkyWalking的UI界面。
服务端部署好后,还需要客户端收集信息,SkyWalking是使用插件方式来监控服务运行状态,只需要在jar启动时加上agent参数即可,详情请参考[skywalking-agent 说明文档.md](skywalking-agent 说明文档.md)。
## 四、配置详解 ## 四、配置详解
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment