文章目录[隐藏]
详解Apache SkyWalking 告警配置指南
Apache SkyWalking
Apache SkyWalking是分布式系统的应用程序性能监视工具（Application Performance Management，APM），专为微服务、云原生架构和基于容器（Docker、K8s、Mesos）架构而设计。
它提供了分布式追踪、服务网格遥测分析、度量聚合和可视化一体化解决方案。
Apache SkyWalking告警
Apache SkyWalking告警是由一组规则驱动，这些规则定义在config/alarm-settings.yml文件中。
告警规则的定义分为三部分。
- 告警规则：定义了触发告警所考虑的条件。
- webhook：当告警触发时，被调用的服务端点列表。
- gRPCHook：当告警触发时，被调用的远程gRPC方法的主机和端口。
- Slack Chat Hook：当告警触发时，被调用的Slack Chat接口。
- 微信 Hook：当告警触发时，被调用的微信接口。
- 钉钉 Hook：当告警触发时，被调用的钉钉接口。
告警规则
告警规则有两种类型，单独规则（Individual Rules）和复合规则（Composite Rules），复合规则是单独规则的组合。
单独规则（Individual Rules）
单独规则主要有以下几点：
- 规则名称：在告警信息中显示的唯一名称，必须以_rule结尾。
- metrics-name：度量名称，也是OAL脚本中的度量名。默认配置中可以用于告警的度量有：服务，实例，端点，服务关系，实例关系，端点关系。它只支持long,double和int类型。
- include-names：包含在此规则之内的实体名称列表。
- exclude-names：排除在此规则以外的实体名称列表。
- include-names-regex：提供一个正则表达式来包含实体名称。如果同时设置包含名称列表和包含名称的正则表达式，则两个规则都将生效。
- exclude-names-regex：提供一个正则表达式来排除实体名称。如果同时设置排除名称列表和排除名称的正则表达式，则两个规则都将生效。
- include-labels：包含在此规则之内的标签。
- exclude-labels：排除在此规则以外的标签。
- include-labels-regex：提供一个正则表达式来包含标签。如果同时设置包含标签列表和包含标签的正则表达式，则两个规则都将生效。
- exclude-labels-regex：提供一个正则表达式来排除标签。如果同时设置排除标签列表和排除标签的正则表达式，则两个规则都将生效。
标签的设置必须把数据存储在meter-system中，例如：Prometheus, Micrometer。以上四个标签设置必须实现LabeledValueHolder接口。
- threshold：阈值。
对于多个值指标，例如percentile，阈值是一个数组。像value1 value2 value3 value4 value5这样描述。
每个值可以作为度量中每个值的阈值。如果不想通过此值或某些值触发警报，则将值设置为 -。
例如在percentile中，value1是P50的阈值，value2是P75的阈值，那么-，-，value3, value4, value5的意思是，没有阈值的P50和P75的percentile告警规则。
- op：操作符，支持
>,>=,<,<=,=。 - period：多久告警规则需要被检查一下。这是一个时间窗口，与后端部署环境时间相匹配。
- count：在一个周期窗口中，如果按op计算超过阈值的次数达到count，则发送告警。
- only-as-condition：
true或者false，指定规则是否可以发送告警，或者仅作为复合规则的条件。 - silence-period：在时间N中触发报警后，在N -> N + silence-period这段时间内不告警。 默认情况下，它和period一样，这意味着相同的告警（同一个度量名称拥有相同的Id）在同一个周期内只会触发一次。
- message：该规则触发时，发送的通知消息。
举个例子：
rules:
service_resp_time_rule:
metrics-name: service_resp_time
op: ">"
threshold: 1000
period: 10
count: 2
silence-period: 10
message: 服务【{name}】的平均响应时间在最近10分钟内有2分钟超过1秒
service_instance_resp_time_rule:
metrics-name: service_instance_resp_time
op: ">"
threshold: 1000
period: 10
count: 2
silence-period: 10
message: 实例【{name}】的平均响应时间在最近10分钟内有2分钟超过1秒
endpoint_resp_time_rule:
metrics-name: endpoint_avg
threshold: 1000
op: ">"
period: 10
count: 2
message: 端点【{name}】的平均响应时间在最近10分钟内有2分钟超过1秒
文章持续更新，微信搜索「万猫学社」第一时间阅读，关注后回复「电子书」，免费获取12本Java必读技术书籍。
复合规则（Composite Rules）
复合规则仅适用于针对相同实体级别的告警规则，例如都是服务级别的告警规则：service_percent_rule && service_resp_time_percentile_rule。
不可以编写不同实体级别的告警规则，例如服务级别的一个告警规则和端点级别的一个规则：service_percent_rule && endpoint_percent_rule。
复合规则主要有以下几点：
- 规则名称：在告警信息中显示的唯一名称，必须以
_rule结尾。 - expression：指定如何组成规则，支持
&&,||,()操作符。 - message：该规则触发时，发送的通知消息。
举个例子：
rules:
service_resp_time_rule:
metrics-name: service_resp_time
op: ">"
threshold: 1000
period: 10
count: 2
silence-period: 10
message: 服务【{name}】的平均响应时间在最近10分钟内有2分钟超过1秒
service_sla_rule:
metrics-name: service_sla
op: "<"
threshold: 8000
period: 10
count: 2
silence-period: 10
message: 服务【{name}】的成功率在最近10分钟内有2分钟低于80％
composite-rules:
comp_rule:
expression: service_resp_time_rule && service_sla_rule
message: 服务【{name}】在最近10分钟内有2分钟超过1秒平均响应时间超过1秒并且成功率低于80％
Webhook
Webhook 要求一个点对点的 Web 容器。告警的消息会通过 HTTP 请求进行发送，请求方法为 POST，Content-Type 为 application/json，JSON 格式包含以下信息：
- scopeId：目标 Scope 的 ID。
- name：目标 Scope 的实体名称。
- id0：Scope 实体的 ID。id1：未使用。
- ruleName：您在
alarm-settings.yml中配置的规则名。 - alarmMessage. 告警消息内容。
- startTime. 告警时间戳，当前时间与 UTC 1970/1/1 相差的毫秒数。
举个例子：
[{
"scopeId": 1,
"scope": "SERVICE",
"name": "one-more-service",
"id0": "b3JkZXItY2VudGVyLXNlYXJjaC1hcGk=.1",
"id1": "",
"ruleName": "service_resp_time_rule",
"alarmMessage": "服务【one-more-service】的平均响应时间在最近10分钟内有2分钟超过1秒",
"startTime": 1617670815000
}, {
"scopeId": 2,
"scope": "SERVICE_INSTANCE",
"name": "[email protected] of one-more-service",
"id0": "dWF0LWxib2Mtc2VydmljZQ==.1_ZTRiMzEyNjJhY2FhNDdlZjkyYTIyYjZhMmI4YTdjYjFAMTcyLjI0LjMwLjEzOA==",
"id1": "",
"ruleName": "instance_jvm_young_gc_count_rule",
"alarmMessage": "实例【[email protected] of one-more-service】的YoungGC次数在最近10分钟内有2分钟超过10次",
"startTime": 1617670815000
}, {
"scopeId": 3,
"scope": "ENDPOINT",
"name": "/one/more/endpoint in one-more-service",
"id0": "b25lcGllY2UtYXBp.1_L3RlYWNoZXIvc3R1ZGVudC92aXBsZXNzb25z",
"id1": "",
"ruleName": "endpoint_resp_time_rule",
"alarmMessage": "端点【/one/more/endpoint in one-more-service】的平均响应时间在最近10分钟内有2分钟超过1秒",
"startTime": 1617670815000
}]
gRPCHook
告警消息将使用 Protobuf 类型通过gRPC远程方法发送。消息格式的关键信息定义如下：
syntax = "proto3";
option java_multiple_files = true;
option java_package = "org.apache.skywalking.oap.server.core.alarm.grpc";
service AlarmService {
rpc doAlarm (stream AlarmMessage) returns (Response) {
}
}
message AlarmMessage {
int64 scopeId = 1;
string scope = 2;
string name = 3;
string id0 = 4;
string id1 = 5;
string ruleName = 6;
string alarmMessage = 7;
int64 startTime = 8;
}
message Response {
}
Slack Chat Hook
您需要遵循传入Webhooks入门指南并创建新的Webhooks。
如果您按以下方式配置了Slack Incoming Webhooks，则告警消息将按 Content-Type 为 application/json 通过HTTP的 POST 方式发送。
举个例子：
slackHooks:
textTemplate: |-
{
"type": "section",
"text": {
"type": "mrkdwn",
"text": ":alarm_clock: *Apache Skywalking Alarm* \\n **%s**."
}
}
webhooks:
- hooks.slack.com/services/x/y/z
微信Hook
只有微信的企业版才支持 Webhooks ，如何使用微信的 Webhooks 可参见如何配置群机器人。
如果您按以下方式配置了微信的 Webhooks ，则告警消息将按 Content-Type 为 application/json 通过HTTP的 POST 方式发送。
举个例子：
wechatHooks:
textTemplate: |-
{
"msgtype": "text",
"text": {
"content": "Apache SkyWalking 告警: \\n %s."
}
}
webhooks:
- qyapi.weixin.qq.com/cgi-bin/webhook/send?key=dummy_key
钉钉 Hook
您需要遵循自定义机器人开放并创建新的Webhooks。为了安全起见，您可以为Webhook网址配置可选的密钥。
如果您按以下方式配置了钉钉的 Webhooks ，则告警消息将按 Content-Type 为 application/json 通过HTTP的 POST 方式发送。
举个例子：
dingtalkHooks:
textTemplate: |-
{
"msgtype": "text",
"text": {
"content": "Apache SkyWalking 告警: \\n %s."
}
}
webhooks:
- url: oapi.dingtalk.com/robot/send?access_token=dummy_token
secret: dummysecret
微信扫描二维码，关注java 技术迷，回复「电子书」，免费获取Java必读技术书籍。
到此这篇关于Apache SkyWalking 告警配置指南的文章就介绍到这了,更多相关SkyWalking 告警配置内容请搜索华域联盟以前的文章或继续浏览下面的相关文章希望大家以后多多支持华域联盟！
相关文章
-
Windows下载的软件包，如何上传到远程Linux主机上？如何从Linux主机下载软件包到Windows下，具有一定的参考价值，感兴趣的小伙伴们可以参考一下2017-06-06
-
这篇文章主要介绍了Ubuntu下ssh免密码登录安装,需要的朋友可以参考下2014-06-06
-
这篇文章主要为大家详细介绍了在Linux下写一个简单的进度条，用make指令进行编译，具有一定的参考价值，感兴趣的小伙伴们可以参考一下2017-04-04
-
下面小编就为大家带来一篇Linux下实现定时器Timer的几种方法总结。小编觉得挺不错的，现在就分享给大家，也给大家做个参考。一起跟随小编过来看看吧2016-10-10
-
这篇文章主要介绍了CentOS 安装 Mogodb详解（在线和离线） ,小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧2017-01-01
-
Linux Crontab Shell脚本实现秒级定时任务的方法
这篇文章主要介绍了Linux Crontab Shell脚本实现秒级定时任务的方法，非常不错，具有一定的参考借鉴价值,需要的朋友可以参考下2018-11-11
-
ufw（简单防火墙Uncomplicated FireWall）真正地简化了 iptables，它从出现的这几年，已经成为 Ubuntu 和 Debian 等系统上的默认防火墙。这篇文章主要介绍了Linux 防火墙 ufw 简介,需要的朋友可以参考下2020-04-04
-
这篇文章主要介绍了Centos7的Firewalld防火墙基础命令详解，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2019-11-11
-
Linux服务器运行久时，系统时间就会存在一定的误差，一般情况下可以使用date命令进行时间设置，但在做数据库集群分片等复杂操作时对多台机器的时间差是有要求的，此时就需要使用ntpdate进行时间同步。2018-04-04
-
今天小编就为大家分享一篇关于Ubuntu下VIM配置成C++开发编辑器，小编觉得内容挺不错的，现在分享给大家，具有很好的参考价值，需要的朋友一起跟随小编来看看吧2018-10-10
本文由 华域联盟 原创撰写：华域联盟 » 详解Apache SkyWalking 告警配置指南
转载请保留出处和原文链接：https://www.cnhackhy.com/3381.htm
最新评论