extern/gatus
1
0
Fork 0
mirror of https://github.com/TwiN/gatus.git synced 2025-04-03 06:32:24 +02:00
Code Issues Packages Projects Releases Wiki Activity

Add documentation for alerts

Browse Source
This commit is contained in:
TwinProduction 2020-08-22 14:15:44 -04:00
parent 22fef4e9aa
commit af6298de05
2 changed files with 52 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

51
README.md
View File

@ -41,17 +41,22 @@ Note that you can also add environment variables in the your configuration file
### Configuration ### Configuration
| Parameter | Description | Default | | Parameter | Description | Default |
| ----------------------- | --------------------------------------------------------------- | -------------- | | --------------------------------- | --------------------------------------------------------------- | -------------- |
| `metrics` | Whether to expose metrics at /metrics | `false` | | `metrics` | Whether to expose metrics at /metrics | `false` |
| `services[].name` | Name of the service. Can be anything. | Required `""` | | `alerting.slack` | Webhook to use for alerts of type `slack` | `""` |
| `services[].url` | URL to send the request to | Required `""` | | `services[].name` | Name of the service. Can be anything. | Required `""` |
| `services[].conditions` | Conditions used to determine the health of the service | `[]` | | `services[].url` | URL to send the request to | Required `""` |
| `services[].interval` | Duration to wait between every status check | `10s` | | `services[].conditions` | Conditions used to determine the health of the service | `[]` |
| `services[].method` | Request method | `GET` | | `services[].interval` | Duration to wait between every status check | `10s` |
| `services[].graphql` | Whether to wrap the body in a query param (`{"query":"$body"}`) | `false` | | `services[].method` | Request method | `GET` |
| `services[].body` | Request body | `""` | | `services[].graphql` | Whether to wrap the body in a query param (`{"query":"$body"}`) | `false` |
| `services[].headers` | Request headers | `{}` | | `services[].body` | Request body | `""` |
| `services[].headers` | Request headers | `{}` |
| `services[].alerts[].type` | Type of alert. Currently, only `slack` is supported | Required `""` |
| `services[].alerts[].enabled` | Whether to enable the alert | `false` |
| `services[].alerts[].threshold` | Number of failures in a row needed before triggering the alert | `3` |
| `services[].alerts[].description` | Description of the alert. Will be included in the alert sent | `""` |
### Conditions ### Conditions
@ -133,4 +138,28 @@ services:
will send a `POST` request to `http://localhost:8080/playground` with the following body: will send a `POST` request to `http://localhost:8080/playground` with the following body:
```json ```json
{"query":" {\n user(gender: \"female\") {\n id\n name\n gender\n avatar\n }\n }"} {"query":" {\n user(gender: \"female\") {\n id\n name\n gender\n avatar\n }\n }"}
```
### Configuring Slack alerts
```yaml
alerting:
slack: https://hooks.slack.com/services/**********/**********/**********
services:
- name: twinnation
interval: 30s
url: https://twinnation.org/health
alerts:
- type: slack
enabled: true
description: "healthcheck failed 3 times in a row"
- type: slack
enabled: true
threshold: 5
description: "healthcheck failed 5 times in a row"
conditions:
- "[STATUS] == 200"
- "[BODY].status == UP"
- "[RESPONSE_TIME] < 300"
``` ```

16
core/alert.go
View File

@ -1,10 +1,18 @@
package core package core
// Alert is the service's alert configuration
type Alert struct { type Alert struct {
Type AlertType `yaml:"type"` // Type of alert
Enabled bool `yaml:"enabled"` Type AlertType `yaml:"type"`
Threshold int `yaml:"threshold"`
Description string `yaml:"description"` // Enabled defines whether or not the alert is enabled
Enabled bool `yaml:"enabled"`
// Threshold is the number of failures in a row needed before triggering the alert
Threshold int `yaml:"threshold"`
// Description of the alert. Will be included in the alert sent.
Description string `yaml:"description"`
} }
type AlertType string type AlertType string