OAL简介

在流模式(Streaming mode)下，SkyWalking 提供了 观测分析语言(Observability Analysis Language，OAL) 来分析流入的数据。

OAL脚本现在位于/config文件夹，用户可以简单地改变和重新启动服务器，使其有效。

但是，OAL脚本仍然是编译语言，OAL运行时动态生成Java代码。可以在系统环境上设置SW_OAL_ENGINE_DEBUG=Y，查看生成了哪些类。

作用域（Scope）

作用域包括全局(All)、服务(Service)、服务实例(Service Instance)、端点(Endpoint)、服务关系(Service Relation)、服务实例关系(Service Instance Relation)、端点关系(Endpoint Relation)。

接下来我来详细了解一下每个作用域。

文章持续更新，微信搜索「万猫学社」第一时间阅读，关注后回复「电子书」，免费获取12本Java必读技术书籍。

全局（All）

名称	备注	是否分组键	数据类型
name	表示每个请求对应的服务名称		string
serviceInstanceName	表示引用的服务实例名称		string
endpoint	表示每个请求的端点名称		string
latency	表示每个请求的耗时		int(单位：毫秒)
status	表示请求成功还是失败的状态		bool(true 表示成功)
responseCode	如果该请求是 HTTP 请求, 则表示 HTTP 响应的状态码. 如 200, 404, 302		int
type	表示请求类型，例如: Database, HTTP, RPC, gRPC		enum

服务(Service）

按照服务计算每个请求的度量数据。

名称	备注	是否分组键	数据类型
name	表示服务的名称		string
nodeType	表示服务节点或网络地址的类型，如：Normal, Database, MQ, Cache		enum
serviceInstanceName	表示引用的服务实例名称		string
endpointName	表示端点的名称, 如：HTTP URI的完整路径		string
latency	表示每个请求的耗时		int
status	表示请求成功还是失败的状态		bool(true 表示成功)
responseCode	如果该请求是 HTTP 请求, 表示 HTTP 请求的响应码		int
type	表示每个请求的类型, 如: Database, HTTP, RPC, gRPC		enum

服务实例(Service Instance）

按照服务实例计算每个请求的度量数据。

名称	备注	是否分组键	数据类型
name	表示服务实例名称。现在原生探针使用 uuid@ipv4 作为服务实例名称, 当需要在聚合中设置过滤器(Filter)时，这个毫无用处。		string
nodeType	表示服务节点或网络地址的类型，如：Normal, Database, MQ, Cache		enum
serviceName	表示服务的名称		string
endpointName	表示端点的名称, 如 HTTP URI 的完整路径.		string
latency	表示每个请求的耗时		int
status	表示请求成功还是失败的状态		bool（true 表示成功)
responseCode	如果该请求是 HTTP 请求, 则表示 HTTP 响应的状态码. 如 200, 404, 302.		int
type	表示请求类型，例如: Database, HTTP, RPC, gRPC		enum

文章持续更新，微信搜索「万猫学社」第一时间阅读，关注后回复「电子书」，免费获取12本Java必读技术书籍。

服务实例（Service Instance）二级作用域

当服务实例是一个 JVM 并且通过 javaagent 收集时，计算服务实例的度量指标。

1. ServiceInstanceJVMCPU

名称	备注	是否分组键	数据类型
name	表示服务实例名称。现在原生探针使用 uuid@ipv4 作为服务实例名称, 当需要在聚合中设置过滤器（Filter)时，这个毫无用处。		string
serviceName	表示服务的名称		string
usePercent	表示 CPU 耗时百分比		double

2. ServiceInstanceJVMMemory

名称	备注	是否分组键	数据类型
name	表示服务实例名称。 现在原生探针使用 uuid@ipv4 作为服务实例名称, 当需要在聚合中设置过滤器（Filter)时，这个毫无用处。		string
serviceName	表示服务的名称		string
heapStatus	表示该指标是否是堆的指标		bool
init	参考 JVM 文档		long
max	参考 JVM 文档		long
used	参考 JVM 文档		long
committed	参考 JVM 文档		long

3. ServiceInstanceJVMMemoryPool

名称	备注	是否分组键	数据类型
name	表示服务实例名称。现在原生探针使用 uuid@ipv4 作为服务实例名称, 当需要在聚合中设置过滤器（Filter)时，这个毫无用处。		string
serviceName	表示服务的名称		string
poolType	根据不同的 JVM 版本, 可能包括 CODE_CACHE_USAGE, NEWGEN_USAGE, OLDGEN_USAGE, SURVIVOR_USAGE, PERMGEN_USAGE, METASPACE_USAGE		enum
init	参考 JVM 文档		long
max	参考 JVM 文档		long
used	参考 JVM 文档		long
committed	参考 JVM 文档		long

文章持续更新，微信搜索「万猫学社」第一时间阅读，关注后回复「电子书」，免费获取12本Java必读技术书籍。

4. ServiceInstanceJVMGC

名称	备注	是否分组键	数据类型
name	表示服务实例名称。现在原生探针使用 uuid@ipv4 作为服务实例名称, 当需要在聚合中设置过滤器（Filter)时，这个毫无用处。		string
serviceName	表示服务的名称		string
phrase	NEW/OLD		Enum
time	GC 耗时		long
count	GC 次数		long

5. ServiceInstanceJVMThread

名称	备注	是否分组键	数据类型
name	表示服务实例名称。现在原生探针使用 uuid@ipv4 作为服务实例名称, 当需要在聚合中设置过滤器（Filter)时，这个毫无用处。		string
serviceName	表示服务的名称		string
liveCount	表示活跃线程的当前数量		int
daemonCount	表示当前守护进程线程的数量		int
peakCount	表示当前峰值线程数		int

端点（Endpoint）

计算服务中每个端点请求的度量指标。

名称	备注	是否分组键	数据类型
name	表示端点的名称, 如 HTTP URI 的完整路径.		string
nodeType	表示服务节点或网络地址的类型，如：Normal, Database, MQ, Cache		enum
serviceName	表示服务的名称		string
serviceInstanceName	表示引用的服务实例 id 的名称.		string
latency	表示每个请求的耗时		int
status	表示请求成功还是失败的状态		bool（true 表示成功)
responseCode	如果该请求是 HTTP 请求, 则表示 HTTP 响应的状态码，如：200, 404, 302.		int
type	表示请求类型，例如: Database, HTTP, RPC, gRPC		enum

服务关系（Service Relation）

计算服务与服务之间每个请求的度量指标。

名称	备注	是否分组键	数据类型
sourceServiceName	表示源服务的名称		string
sourceServiceNodeType	表示源服务节点或网络地址的类型，如：Normal, Database, MQ, Cache		enum
sourceServiceInstanceName	表示源服务实例名称		string
destServiceName	表示目标服务的名称		string
destServiceNodeType	表示目标服务节点或网络地址的类型，如：Normal, Database, MQ, Cache		enum
destServiceInstanceName	表示目标服务实例名称		string
endpoint	表示本次调用中使用的端点		string
componentId	表示本次调用中使用到的组件 ID	是	string
latency	表示每个请求的耗时		int
status	表示请求成功还是失败的状态		bool（true 表示成功)
responseCode	如果该请求是 HTTP 请求, 则表示 HTTP 响应的状态码. 如 200, 404, 302.		int
type	表示请求类型，例如: Database, HTTP, RPC, gRPC		enum
detectPoint	本地请求探测点位置，如：client, server, proxy.	是	enum
tlsMode	表示源服务和目标服务之间的TLS模式，如：service_relation_mtls_cpm = from(ServiceRelation.*).filter(tlsMode == "mTLS").cpm（)		string

服务实例关系（Service Instance Relation）

计算服务实例与服务实例之间每个请求的度量指标。

名称	备注	是否分组键	数据类型
sourceServiceName	表示源服务的名称		string
sourceServiceNodeType	表示源服务节点或网络地址的类型，如：Normal, Database, MQ, Cache		enum
sourceServiceInstanceName	表示源服务实例名称		string
destServiceName	表示目标服务的名称
destServiceNodeType	表示目标服务节点或网络地址的类型，如：Normal, Database, MQ, Cache		enum
destServiceInstanceName	表示目标服务实例名称		string
endpoint	表示本次调用中使用的端点		string
componentId	表示本次调用中使用到的组件 ID	是	string
latency	表示每个请求的耗时		int
status	表示请求成功还是失败的状态		bool(true 表示成功)
responseCode	如果该请求是 HTTP 请求, 则表示 HTTP 响应的状态码. 如 200, 404, 302.		int
type	表示请求类型，例如: Database, HTTP, RPC, gRPC		enum
detectPoint	本地请求探测点位置，如：client, server, proxy.	是	enum
tlsMode	表示源服务和目标服务之间的TLS模式，如：service_relation_mtls_cpm = from(ServiceRelation.*).filter(tlsMode == "mTLS").cpm()		string

文章持续更新，微信搜索「万猫学社」第一时间阅读，关注后回复「电子书」，免费获取12本Java必读技术书籍。

端点关系（Endpoint Relation）

计算一个端点和另一个端点之间的依赖关系的度量数据。这种关系很难检测，也依赖于跟踪库来传播上一个端点。

所以端点关系范围聚合，仅仅在使用 SkyWalking 原生探针进行追踪的情况下才有效，包括自动打点探针(如 Java, .NET),

OpenCensus SkyWalking exporter以及其他传播追踪上下文的实现.

名称	备注	是否分组键	数据类型
endpoint	表示父级端点名称		string
serviceName	表示父级端点的服务名称		string
serviceNodeType	表示父级端点的服务节点或网络地址的类型，如：Normal, Database, MQ, Cache		enum
childEndpoint	表示子父级端点名称		string
childServiceName	表示子级端点的服务名称		string
childServiceNodeType	表示子级端点的服务节点或网络地址的类型，如：Normal, Database, MQ, Cache		string
childServiceInstanceName	表示子级端点的服务实例名称		string
rpcLatency	表示RPC请求的耗时，排除了父级端点自身的耗时		int
componentId	表示此调用中使用的组件ID	是	string
status	表示请求成功还是失败的状态		bool(true 表示成功)
responseCode	如果该请求是 HTTP 请求，则表示 HTTP 响应的状态码		int
type	表示请求类型，例如: Database, HTTP, RPC, gRPC		enum
detectPoint	本地请求探测点位置，如：client, server, proxy.	是	enum

浏览器传输（BrowserAppTraffic）

计算浏览器应用程序的每个请求的度量数据。

名称	备注	是否分组键	数据类型
name	表示每个请求的浏览器应用程序名称		string
count	表示请求数，固定为1		int
trafficCategory	表示传输类别，如：NORMAL, FIRST_ERROR, ERROR		enum
errorCategory	代表错误类别，如：AJAX, RESOURCE, VUE, PROMISE, UNKNOWN		enum

浏览器单一版本传输（BrowserAppSingleVersionTraffic）

计算浏览器应用程序中浏览器单一版本的每个请求的度量数据。

名称	备注	是否分组键	数据类型
name	表示每个请求的单一版本名		string
serviceName	表示浏览器应用程序的名称		string
count	表示请求数，固定为1		int
trafficCategory	表示传输类别，如：NORMAL, FIRST_ERROR, ERROR		enum
errorCategory	代表错误类别，如：AJAX, RESOURCE, VUE, PROMISE, UNKNOWN		enum

浏览器页面传输（BrowserAppPageTraffic）

计算浏览器应用程序中页面的每个请求的度量数据。

名称	备注	是否分组键	数据类型
name	表示每个请求的页面名称		string
serviceName	表示浏览器应用程序的名称		string
count	表示请求数，固定为1		int
trafficCategory	表示传输类别，如：NORMAL, FIRST_ERROR, ERROR		enum
errorCategory	代表错误类别，如：AJAX, RESOURCE, VUE, PROMISE, UNKNOWN		enum

浏览器页面耗时（BrowserAppPagePerf）

计算浏览器应用程序中页面的每个请求耗时的度量数据。

名称	备注	是否分组键	数据类型
name	表示每个请求的页面名称		string
serviceName	表示浏览器应用程序的名称		string
redirectTime	表示重定向的耗时		int(单位：毫秒)
dnsTime	表示DNS查询的耗时		int(单位：毫秒)
ttfbTime	发出页面请求到接收到应答数据第一个字节所花费的耗时		int(单位：毫秒)
tcpTime	TCP连接的耗时		int(单位：毫秒)
transTime	内容传输的耗时		int(单位：毫秒)
domAnalysisTime	DOM结构分析的耗时		int(单位：毫秒)
fptTime	首次渲染时间/白屏时间		int(单位：毫秒)
domReadyTime	DOM结构准备的耗时		int(单位：毫秒)
loadPageTime	整个页面加载时间		int(in ms)
resTime	页面中同步加载资源的耗时		int(单位：毫秒)
sslTime	仅对HTTPS有效		int(单位：毫秒)
ttlTime	首次交互时间		int(单位：毫秒)
firstPackTime	第一个包的时间		int(单位：毫秒)
fmpTime	首次有效绘制时间		int(单位：毫秒)

注：本文以SkyWalking的8.2.0版本为例进行介绍，如果版本不同会略有差异。