文章中用到的软件包：

提取码：3bgr

一、软件包说明

1、SkyWalking APM( 版本8.9.1)

包含：

• SkyWalking OAP 服务:负责接收 Agent 发送的 Tracing 数据信息，然后进行分析(Analysis Core) ，存储到外部存储器( Storage )，最终提供查询( Query )功能。

• SkyWalking UI服务:负责提供控台，查看链路等等。

2、SkyWalking Agent（版本8.9.0）

包含：

• Agent ：负责从应用中，收集链路信息，发送给 SkyWalking OAP 服务器。

3、Spring Boot 项目（HelloWord测试项目jar包）

确保jar包能正常运行：

java -jar .\target\vscdemo-0.0.1-SNAPSHOT.jar

二、使用说明

1、SkyWalking APM( 版本8.9.1)

skywalking apm 目录：

skywalking apm bin目录启动脚本：

建议修改默认webUI端口（位置：webapp/webapp.xml）：

访问18888端口的UI页面：

2、SkyWalking Agent（版本8.9.0）

skywalking Agent 目录：

3、Spring Boot 项目（HelloWord测试项目jar包）

确保jar包能正常运行：

java -jar .\target\vscdemo-0.0.1-SNAPSHOT.jar

启动Helloword jar包时，配置使用该 SkyWalking Agent：

java -javaagent:D:\environment\skywalking-agent\skywalking-agent.jar -Dskywalking.agent.service_name=demo -Dskywalking.collector.backend_service=127.0.0.1:11800 -jar .\target\vscdemo-0.0.1-SNAPSHOT.jar

• -javaagent:D:\environment\skywalking-agent\skywalking-agent.jar：指定skywalking-agent.jar路径

• -Dskywalking.agent.service_name=demo：指定监控项目在UI控制台显示的名称

• -Dskywalking.collector.backend_service=127.0.0.1:11800：OAP 地址

访问18888端口的UI页面：

4、接口内省

内省是GraphQL的一种特殊功能，我们可以通过内省以获取有关其支持哪些功能（接口）的信息。

使用GraphQL前，建议阅读GraphQL官方说明文档。（GraphQL中文文档）

后端接口：http://localhost:12800/graphql

方法：POST

QUERY | 请求体

query GetAllQueries {
  __schema {
    queryType {
      fields {
        name
        description
        args {
          name
          type {
            name
          }
        }
        type {
          name
        }
      }
    }
  }
}

GRAPHQL VARIABLES | 请求参数

​

返回响应

{
    "data": {
        "__schema": {
            "queryType": {
                "fields": [
                    {
                        "name": "version",
                        "description": "",
                        "args": [],
                        "type": {
                            "name": "String"
                        }
                    },
                    {
                        "name": "checkHealth",
                        "description": "Query Health Checker module for the status of OAP server",
                        "args": [],
                        "type": {}
                    },
                    {
                        "name": "getAllServices",
                        "description": "Normal service related meta info",
                        "args": [
                            {
                                "name": "duration",
                                "type": {}
                            },
                            {
                                "name": "group",
                                "type": {
                                    "name": "String"
                                }
                            }
                        ],
                        "type": {}
                    },
                    ...此处省略...
                    {
                        "name": "queryEvents",
                        "description": "",
                        "args": [
                            {
                                "name": "condition",
                                "type": {
                                    "name": "EventQueryCondition"
                                }
                            }
                        ],
                        "type": {
                            "name": "Events"
                        }
                    }
                ]
            }
        }
    }
}

5、使用GraphiQL浏览器插件

使用GraphiQL浏览器插件，将接口查询工作事半功倍。

只需鼠标点击，实时查询参数类型。

三、名词解释

GraphQL

GraphQL 是一个用于 API 的查询语言，也是使用现有数据完成这些查询的运行时。 GraphQL 为 API 中的数据提供了完整且易于理解的描述，使客户能够准确地询问他们需要的内容，从而更轻松地随着时间的推移改进 API，并启用强大的开发工具。

GraphQL官方说明文档。

GraphQL中文文档

Apdex

详细说明见文章：度量服务网格健康度——Apdex得分

Apdex是根据设定的阈值和响应时间结合考虑的衡量标准。

Apdex得分是满意型请求和容忍型请求与做出的总请求的比率。

一个Apdex得分从0到1的范围内取值。0是最差的分数，表示用户总是感到失望；而'1’是最好的分数（100%的响应时间是令人满意的）。

这个分数的百分比表示也可以用作服务的健康指标。

Apdex得分的实际计算是通过以下公式实现的：

                           满意请求数 +  ( 容忍请求数 / 2 )
​
Apdex 得分  =  ------------------------------------------------------
​
                                总请求数

此公示得到的百分率，即可视为服务的健康度。

CPM

HTTP 1/2、gRPC、RPC服务，每分钟调用数（CPM）

PPM

TCP服务，每分钟数据包数（PPM）