Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
G
gitlab-ce
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
0
Issues
0
List
Boards
Labels
Milestones
Merge Requests
1
Merge Requests
1
Analytics
Analytics
Repository
Value Stream
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Commits
Issue Boards
Open sidebar
nexedi
gitlab-ce
Commits
31770d19
Commit
31770d19
authored
Mar 15, 2021
by
Olena Horal-Koretska
Browse files
Options
Browse Files
Download
Plain Diff
Merge branch 'sarahwaldner-master-patch-98380' into 'master'
Custom Mapping documentation See merge request gitlab-org/gitlab!55663
parents
07113a10
21f65eaf
Changes
2
Show whitespace changes
Inline
Side-by-side
Showing
2 changed files
with
24 additions
and
7 deletions
+24
-7
doc/operations/incident_management/img/custom_alert_mapping_v13_10.png
...s/incident_management/img/custom_alert_mapping_v13_10.png
+0
-0
doc/operations/incident_management/integrations.md
doc/operations/incident_management/integrations.md
+24
-7
No files found.
doc/operations/incident_management/img/custom_alert_mapping_v13_10.png
0 → 100644
View file @
31770d19
97.8 KB
doc/operations/incident_management/integrations.md
View file @
31770d19
...
...
@@ -57,19 +57,36 @@ and you can [customize the payload](#customize-the-alert-payload-outside-of-gitl
1.
Expand the
**Alerts**
section.
1.
For each endpoint you want to create:
1.
Click the
**Add new integration**
button.
1.
In the
**Integration**
dropdown menu, select
**HTTP Endpoint**
.
1.
Name the integration.
1.
Toggle the
**Active**
alert setting to display the
**URL**
and
**Authorization Key**
for the webhook configuration. You must also input the URL and Authorization Key
in your external service.
1.
_(Optional)_ To generate a test alert to test the new integration, enter a
sample payload, then click
**Save and test alert payload**
. Valid JSON is required.
1.
Click
**Save Integration**
.
1.
Toggle the
**Active**
alert setting. The
**URL**
and
**Authorization Key**
for the webhook
configuration are available in the
**View credentials**
tab after you save the integration.
You must also input the URL and Authorization Key in your external service.
1.
_(Optional)_ To map fields from your monitoring tool's alert to GitLab fields, enter a sample
payload and click
**Parse payload for custom mapping**
. Valid JSON is required. If you update
a sample payload, you must also remap the fields.
1.
_(Optional)_ If you provided a valid sample payload, select each value in
**Payload alert key**
to
[
map to a **GitLab alert key**
](
#map-fields-in-custom-alerts
)
.
1.
To save your integration, click
**Save Integration**
. If desired, you can send a test alert
from your integration's
**Send test alert**
tab after the integration is created.
The new HTTP Endpoint displays in the
[
integrations list
](
#integrations-list
)
.
You can edit the integration by selecting the
**{
pencil}**
pencil
icon on the right
You can edit the integration by selecting the
**{
settings}**
settings
icon on the right
side of the integrations list.
#### Map fields in custom alerts
> [Introduced](https://gitlab.com/groups/gitlab-org/-/epics/4443) in [GitLab Premium](https://about.gitlab.com/pricing/) 13.10.
You can integrate your monitoring tool's alert format with GitLab alerts. To show the
correct information in the
[
Alert list
](
alerts.md
)
and the
[
Alert Details page
](
alerts.md#alert-details-page
)
, map your alert's fields to
GitLab fields when you
[
create an HTTP endpoint
](
#http-endpoints
)
:
![
Alert Management List
](
img/custom_alert_mapping_v13_10.png
)
### External Prometheus integration
For GitLab versions 13.1 and greater, read
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment