Watcher Slack 操作
编辑Watcher Slack 操作
编辑使用 slack
操作向 Slack 团队的频道或用户发送消息。要发送 Slack 消息,您需要在 elasticsearch.yml
中配置至少一个 Slack 账户。
配置 Slack 操作
编辑您可以在 actions
数组中配置 Slack 操作。使用 slack
关键字指定特定于操作的属性。
以下代码片段显示了一个简单的 slack 操作定义
使用附件格式化 Slack 消息
编辑除了发送简单的基于文本的消息外,您还可以使用 Slack 的 附件机制来发送格式化的消息。Watcher 利用 Slack 附件使您能够从执行上下文有效负载中动态填充模板消息。
以下代码片段显示了一个标准消息附件
"actions" : { "notify-slack" : { "throttle_period" : "5m", "slack" : { "account" : "team1", "message" : { "from" : "watcher", "to" : [ "#admins", "@chief-admin" ], "text" : "System X Monitoring", "attachments" : [ { "title" : "Errors Found", "text" : "Encountered {{ctx.payload.hits.total}} errors in the last 5 minutes (facepalm)", "color" : "danger" } ] } } } }
要定义从有效负载动态填充的附件模板,请在 watch 操作中指定 dynamic_attachments
。例如,动态附件可以引用有效负载中的直方图桶,并为每个桶构建一个附件。
在以下示例中,watch 输入执行带有日期直方图聚合的搜索,以及 Slack 操作
- 将有效负载转换为列表,其中列表中的每个项目都包含月份、该月份的用户计数以及表示与该计数相关的情绪的颜色(危险或不良)。
- 定义一个附件模板,该模板引用由转换生成的列表中的项目。
"input" : { "search" : { "request" : { "body" : { "aggs" : { "users_per_month" : { "date_histogram" : { "field" : "@timestamp", "interval" : "month" } } } } } } }, ... "actions" : { "notify-slack" : { "throttle_period" : "5m", "transform" : { "script" : { "source" : "['items': ctx.payload.aggregations.users_per_month.buckets.collect(bucket -> ['count': bucket.doc_count, 'name': bucket.key_as_string, 'color': bucket.doc_count < 100 ? 'danger' : 'good'])]", "lang" : "painless" } }, "slack" : { "account" : "team1", "message" : { "from" : "watcher", "to" : [ "#admins", "@chief-admin" ], "text" : "System X Monitoring", "dynamic_attachments" : { "list_path" : "ctx.payload.items" "attachment_template" : { "title" : "{{month}}", "text" : "Users Count: {{count}}", "color" : "{{color}}" } } } } } }
Slack 操作属性
编辑名称 | 必需 | 描述 |
---|---|---|
|
否 |
要在 Slack 消息中显示的发送者名称。覆盖传入 webhook 的配置名称。 |
|
是 |
您要向其发送消息的频道和用户。频道名称必须以 |
|
否 |
要在 Slack 消息中显示的图标。覆盖传入 webhook 的配置图标。接受指向图像的公共 URL。 |
|
是 |
消息内容。 |
|
否 |
Slack 消息附件。消息附件使您能够创建更丰富格式的消息。指定为 Slack 附件文档中定义的数组。 |
|
否 |
可以根据当前 watch 有效负载动态填充的 Slack 消息附件。有关更多信息,请参阅 使用附件格式化 Slack 消息。 |
|
否 |
要使用的代理主机(仅与 |
|
否 |
要使用的代理端口(仅与 |
配置 Slack 账户
编辑您可以在 elasticsearch.yml
的 xpack.notification.slack
命名空间中配置 Watcher 可以用来与 Slack 通信的账户。
您需要一个具有 传入 Webhook 功能的 Slack 应用程序来配置 Slack 账户。使用生成的 webhook URL 在 Elasticsearch 中设置您的 Slack 账户。
要配置 Slack 账户,您至少需要在 Elasticsearch 密钥库中指定账户名称和 webhook URL(请参阅安全设置)
bin/elasticsearch-keystore add xpack.notification.slack.account.monitoring.secure_url
您不能再使用 elasticsearch.yml
设置配置 Slack 账户。请改用 Elasticsearch 的安全密钥库方法。
您可以为 Slack 通知属性指定默认值
xpack.notification.slack: account: monitoring: message_defaults: from: x-pack to: notifications icon: http://example.com/images/watcher-icon.jpg attachment: fallback: "X-Pack Notification" color: "#36a64f" title: "X-Pack Notification" title_link: "https://elastic.ac.cn/guide/en/x-pack/current/index.html" text: "One of your watches generated this notification." mrkdwn_in: "pretext, text"
要通知多个频道,请在 Slack 中为每个频道创建一个 webhook URL,并在 Elasticsearch 中创建多个 Slack 账户(每个 webhook URL 一个)。
如果您配置了多个 Slack 账户,则要么需要配置一个默认账户,要么在 slack
操作中指定应使用哪个账户发送通知。
xpack.notification.slack: default_account: team1 account: team1: ... team2: ...