...
If you want to receive notifications via Slack, you should be part of a Slack workspace. To set up alerting in your Slack workspace, you’re going to need a Slack API URL. Go to Slack -> Administration -> Manage apps. In the Manage apps directory, search for Incoming WebHooks and add it to your Slack workspace. Next, specify in which channel you’d like to receive notifications from Alertmanager. After you confirm and add Incoming WebHooks integration, webhook Webhook URL is displayed (copy it).
Section |
---|
Column |
---|
| Manage Apps
|
Column |
---|
| Incoming WebHooks
|
|
At this point, as seen previously, we create an AlertmanagerConfig
component for sending notifications to Slack, using the following file. Complete the file by replacing the two placeholders: the name of the Slack channel
, in which to receive notifications, and the apiURL
, in the Secret
at the bottom, encoded in base64 (echo <apiURL> | base64 -w0
). Then proceed with the apply
of the file.
Code Block |
---|
language | yml |
---|
title | AlertmanagerConfigSlack.yaml |
---|
collapse | true |
---|
|
apiVersion: monitoring.coreos.com/v1alpha1
kind: AlertmanagerConfig
metadata:
name: alert-slack
namespace: monitoring
labels:
alertmanager: config
spec:
route:
groupBy: [severity]
receiver: 'slack-notifications'
groupWait: 30s
groupInterval: 5m
repeatInterval: 12h
receivers:
- name: 'slack-notifications'
slackConfigs:
- channel: '<#channel>'
apiURL:
name: slack-pass
key: alertmanager.yaml
sendResolved: true
# The following lines can be omitted, they have only an aesthetic value
iconURL: 'https://avatars3.githubusercontent.com/u/3380462'
title: |-
[{{ .Status | toUpper }}{{ if eq .Status "firing" }}:{{ .Alerts.Firing | len }}{{ end }}] {{ .CommonLabels.alertname }} for {{ .CommonLabels.job }}
{{- if gt (len .CommonLabels) (len .GroupLabels) -}}
{{" "}}(
{{- with .CommonLabels.Remove .GroupLabels.Names }}
{{- range $index, $label := .SortedPairs -}}
{{ if $index }}, {{ end }}
{{- $label.Name }}="{{ $label.Value -}}"
{{- end }}
{{- end -}}
)
{{- end }}
text: >-
{{ range .Alerts -}}
*Alert:* {{ .Annotations.title }}{{ if .Labels.severity }} - `{{ .Labels.severity }}`{{ end }}
*Description:* {{ .Annotations.description }}
*Details:*
{{ range .Labels.SortedPairs }} • *{{ .Name }}:* `{{ .Value }}`
{{ end }}
{{ end }}
---
apiVersion: v1
kind: Secret
type: Opaque
metadata:
name: slack-pass
namespace: monitoring
data:
alertmanager.yaml: <apiURL_encode_base64> |
If everything went smoothly (remember to always take a look at the logs of the Alertmanager-0
pod), you should get, in the chosen channel, a result similar to the following
Image RemovedSlack Alert Example. We have 2 notifications for a single alert because we used the sendResolved
option in the configuration file above, in order to be notified also when the problem is resolved.
Section |
---|
Column |
---|
| Image AddedSlack Alert Firing
|
Column |
---|
| Image AddedSlack Alert Resolved
|
|