IntenseWebs/grafana
3
0
Fork 0
mirror of https://github.com/grafana/grafana.git synced 2025-02-11 08:05:43 -06:00
Code Issues Packages Projects Releases Wiki Activity
3409e0ea5a
grafana/docs/sources/developers/http_api/alerting_provisioning.md
brendamuir ab963a8558
Alerting docs: quick corrections to oncall integration (#74758) 
* Alerting docs: quick corrections to oncall integration

* corrects spelling errors
2023-09-12 19:46:03 +02:00

86 KiB
Raw Blame History

aliases canonical description keywords labels title
../../http_api/alerting_provisioning/
/docs/grafana/latest/developers/http_api/alerting_provisioning/ Grafana Alerts HTTP API
grafana
http
documentation
api
alerting
alerts
products
enterprise
oss
Alerting Provisioning HTTP API

Alerting provisioning HTTP API

Information

Version

1.1.0

Content negotiation

Consumes

  • application/json

Produces

  • application/json
  • text/yaml
  • application/yaml

All endpoints

Alert rules

Method URI Name Summary
DELETE /api/v1/provisioning/alert-rules/{UID} route delete alert rule Delete a specific alert rule by UID.
GET /api/v1/provisioning/alert-rules/{UID} route get alert rule Get a specific alert rule by UID.
GET /api/v1/provisioning/alert-rules/{UID}/export route get alert rule export Export an alert rule in provisioning file format.
GET /api/v1/provisioning/folder/{FolderUID}/rule-groups/{Group} route get alert rule group Get a rule group.
GET /api/v1/provisioning/folder/{FolderUID}/rule-groups/{Group}/export route get alert rule group export Export an alert rule group in provisioning file format.
GET /api/v1/provisioning/alert-rules route get alert rules Get all the alert rules.
GET /api/v1/provisioning/alert-rules/export route get alert rules export Export all alert rules in provisioning file format.
POST /api/v1/provisioning/alert-rules route post alert rule Create a new alert rule.
PUT /api/v1/provisioning/alert-rules/{UID} route put alert rule Update an existing alert rule.
PUT /api/v1/provisioning/folder/{FolderUID}/rule-groups/{Group} route put alert rule group Update the interval of a rule group.

Contact points

Note:

Contact point provisioning is for Grafana-managed alerts only.

Method URI Name Summary
DELETE /api/v1/provisioning/contact-points/{UID} route delete contactpoints Delete a contact point.
GET /api/v1/provisioning/contact-points route get contactpoints Get all the contact points.
GET /api/v1/provisioning/contact-points/export route get contactpoints export Export all contact points in provisioning file format.
POST /api/v1/provisioning/contact-points route post contactpoints Create a contact point.
PUT /api/v1/provisioning/contact-points/{UID} route put contactpoint Update an existing contact point.

Notification policies

Method URI Name Summary
DELETE /api/v1/provisioning/policies route reset policy tree Clears the notification policy tree.
GET /api/v1/provisioning/policies route get policy tree Get the notification policy tree.
GET /api/v1/provisioning/policies/export route get policy tree export Export the notification policy tree in provisioning file format.
PUT /api/v1/provisioning/policies route put policy tree Sets the notification policy tree.

Mute timings

Method URI Name Summary
DELETE /api/v1/provisioning/mute-timings/{name} route delete mute timing Delete a mute timing.
GET /api/v1/provisioning/mute-timings/{name} route get mute timing Get a mute timing.
GET /api/v1/provisioning/mute-timings route get mute timings Get all the mute timings.
POST /api/v1/provisioning/mute-timings route post mute timing Create a new mute timing.
PUT /api/v1/provisioning/mute-timings/{name} route put mute timing Replace an existing mute timing.

Templates

Method URI Name Summary
DELETE /api/v1/provisioning/templates/{name} route delete template Delete a template.
GET /api/v1/provisioning/templates/{name} route get template Get a notification template.
GET /api/v1/provisioning/templates route get templates Get all notification templates.
PUT /api/v1/provisioning/templates/{name} route put template Updates an existing notification template.

Paths

Delete a specific alert rule by UID. (RouteDeleteAlertRule)

DELETE /api/v1/provisioning/alert-rules/{UID}

Parameters

{{% responsive-table %}}

Name Source Type Go type Separator Required Default Description
UID path string string ✓ Alert rule UID
X-Disable-Provenance header string string Allows editing of provisioned resources in the Grafana UI

{{% /responsive-table %}}

All responses

Code Status Description Has headers Schema
204 No Content The alert rule was deleted successfully. schema

Responses

204 - The alert rule was deleted successfully.

Status: No Content

Schema

Delete a contact point. (RouteDeleteContactpoints)

DELETE /api/v1/provisioning/contact-points/{UID}

Consumes

  • application/json

Parameters

Name Source Type Go type Separator Required Default Description
UID path string string ✓ UID is the contact point unique identifier

All responses

Code Status Description Has headers Schema
204 No Content The contact point was deleted successfully. schema

Responses

204 - The contact point was deleted successfully.

Status: No Content

Schema

Delete a mute timing. (RouteDeleteMuteTiming)

DELETE /api/v1/provisioning/mute-timings/{name}

Parameters

Name Source Type Go type Separator Required Default Description
name path string string ✓ Mute timing name

All responses

Code Status Description Has headers Schema
204 No Content The mute timing was deleted successfully. schema

Responses

204 - The mute timing was deleted successfully.

Status: No Content

Schema

Delete a template. (RouteDeleteTemplate)

DELETE /api/v1/provisioning/templates/{name}

Parameters

Name Source Type Go type Separator Required Default Description
name path string string ✓ Template Name

All responses

Code Status Description Has headers Schema
204 No Content The template was deleted successfully. schema

Responses

204 - The template was deleted successfully.

Status: No Content

Schema

Get a specific alert rule by UID. (RouteGetAlertRule)

GET /api/v1/provisioning/alert-rules/{UID}

Parameters

Name Source Type Go type Separator Required Default Description
UID path string string ✓ Alert rule UID

All responses

Code Status Description Has headers Schema
200 OK ProvisionedAlertRule schema
404 Not Found Not found. schema

Responses

200 - ProvisionedAlertRule

Status: OK

Schema

ProvisionedAlertRule

404 - Not found.

Status: Not Found

Schema

Export an alert rule in provisioning file format. (RouteGetAlertRuleExport)

GET /api/v1/provisioning/alert-rules/{UID}/export

Produces

  • application/json
  • application/yaml
  • text/yaml

Parameters

Name Source Type Go type Separator Required Default Description
UID path string string ✓ Alert rule UID
download query boolean bool Whether to initiate a download of the file or not.
format query string string "yaml" Format of the downloaded file, either yaml or json. Accept header can also be used, but the query parameter will take precedence.

All responses

Code Status Description Has headers Schema
200 OK AlertingFileExport schema
404 Not Found Not found. schema

Responses

200 - AlertingFileExport

Status: OK

Schema

AlertingFileExport

404 - Not found.

Status: Not Found

Schema

Get a rule group. (RouteGetAlertRuleGroup)

GET /api/v1/provisioning/folder/{FolderUID}/rule-groups/{Group}

Parameters

Name Source Type Go type Separator Required Default Description
FolderUID path string string ✓
Group path string string ✓

All responses

Code Status Description Has headers Schema
200 OK AlertRuleGroup schema
404 Not Found Not found. schema

Responses

200 - AlertRuleGroup

Status: OK

Schema

AlertRuleGroup

404 - Not found.

Status: Not Found

Schema

Export an alert rule group in provisioning file format. (RouteGetAlertRuleGroupExport)

GET /api/v1/provisioning/folder/{FolderUID}/rule-groups/{Group}/export

Produces

  • application/json
  • application/yaml
  • text/yaml

Parameters

Name Source Type Go type Separator Required Default Description
FolderUID path string string ✓
Group path string string ✓
download query boolean bool Whether to initiate a download of the file or not.
format query string string "yaml" Format of the downloaded file, either yaml or json. Accept header can also be used, but the query parameter will take precedence.

All responses

Code Status Description Has headers Schema
200 OK AlertingFileExport schema
404 Not Found Not found. schema

Responses

200 - AlertingFileExport

Status: OK

Schema

AlertingFileExport

404 - Not found.

Status: Not Found

Schema

Get all the alert rules. (RouteGetAlertRules)

GET /api/v1/provisioning/alert-rules

All responses

Code Status Description Has headers Schema
200 OK ProvisionedAlertRules schema

Responses

200 - ProvisionedAlertRules

Status: OK

Schema

ProvisionedAlertRules

Export all alert rules in provisioning file format. (RouteGetAlertRulesExport)

GET /api/v1/provisioning/alert-rules/export

Parameters

Name Source Type Go type Separator Required Default Description
download query boolean bool Whether to initiate a download of the file or not.
format query string string "yaml" Format of the downloaded file, either yaml or json. Accept header can also be used, but the query parameter will take precedence.

All responses

Code Status Description Has headers Schema
200 OK AlertingFileExport schema
404 Not Found Not found. schema

Responses

200 - AlertingFileExport

Status: OK

Schema

AlertingFileExport

404 - Not found.

Status: Not Found

Schema

Get all the contact points. (RouteGetContactpoints)

GET /api/v1/provisioning/contact-points

Parameters

Name Source Type Go type Separator Required Default Description
name query string string Filter by name

All responses

Code Status Description Has headers Schema
200 OK ContactPoints schema

Responses

200 - ContactPoints

Status: OK

Schema

ContactPoints

Export all contact points in provisioning file format. (RouteGetContactpointsExport)

GET /api/v1/provisioning/contact-points/export

Parameters

Name Source Type Go type Separator Required Default Description
decrypt query boolean bool Whether any contained secure settings should be decrypted or left redacted. Redacted settings will contain RedactedValue instead. Currently, only org admin can view decrypted secure settings.
download query boolean bool Whether to initiate a download of the file or not.
format query string string "yaml" Format of the downloaded file, either yaml or json. Accept header can also be used, but the query parameter will take precedence.
name query string string Filter by name

All responses

Code Status Description Has headers Schema
200 OK AlertingFileExport schema
403 Forbidden PermissionDenied schema

Responses

200 - AlertingFileExport

Status: OK

Schema

AlertingFileExport

403 - PermissionDenied

Status: Forbidden

Schema

PermissionDenied

Get a mute timing. (RouteGetMuteTiming)

GET /api/v1/provisioning/mute-timings/{name}

Parameters

Name Source Type Go type Separator Required Default Description
name path string string ✓ Mute timing name

All responses

Code Status Description Has headers Schema
200 OK MuteTimeInterval schema
404 Not Found Not found. schema

Responses

200 - MuteTimeInterval

Status: OK

Schema

MuteTimeInterval

404 - Not found.

Status: Not Found

Schema

Get all the mute timings. (RouteGetMuteTimings)

GET /api/v1/provisioning/mute-timings

All responses

Code Status Description Has headers Schema
200 OK MuteTimings schema

Responses

200 - MuteTimings

Status: OK

Schema

MuteTimings

Get the notification policy tree. (RouteGetPolicyTree)

GET /api/v1/provisioning/policies

All responses

Code Status Description Has headers Schema
200 OK Route schema

Responses

200 - Route

Status: OK

Schema

Route

Export the notification policy tree in provisioning file format. (RouteGetPolicyTreeExport)

GET /api/v1/provisioning/policies/export

All responses

Code Status Description Has headers Schema
200 OK AlertingFileExport schema
404 Not Found NotFound schema

Responses

200 - AlertingFileExport

Status: OK

Schema

AlertingFileExport

404 - NotFound

Status: Not Found

Schema

NotFound

Get a notification template. (RouteGetTemplate)

GET /api/v1/provisioning/templates/{name}

Parameters

Name Source Type Go type Separator Required Default Description
name path string string ✓ Template Name

All responses

Code Status Description Has headers Schema
200 OK NotificationTemplate schema
404 Not Found Not found. schema

Responses

200 - NotificationTemplate

Status: OK

Schema

NotificationTemplate

404 - Not found.

Status: Not Found

Schema

Get all notification templates. (RouteGetTemplates)

GET /api/v1/provisioning/templates

All responses

Code Status Description Has headers Schema
200 OK NotificationTemplates schema
404 Not Found Not found. schema

Responses

200 - NotificationTemplates

Status: OK

Schema

NotificationTemplates

404 - Not found.

Status: Not Found

Schema

Create a new alert rule. (RoutePostAlertRule)

POST /api/v1/provisioning/alert-rules

Consumes

  • application/json

Parameters

{{% responsive-table %}}

Name Source Type Go type Separator Required Default Description
X-Disable-Provenance header string string Allows editing of provisioned resources in the Grafana UI
Body body ProvisionedAlertRule models.ProvisionedAlertRule

{{% /responsive-table %}}

All responses

Code Status Description Has headers Schema
201 Created ProvisionedAlertRule schema
400 Bad Request ValidationError schema

Responses

201 - ProvisionedAlertRule

Status: Created

Schema

ProvisionedAlertRule

400 - ValidationError

Status: Bad Request

Schema

ValidationError

Create a contact point. (RoutePostContactpoints)

POST /api/v1/provisioning/contact-points

Consumes

  • application/json

Parameters

{{% responsive-table %}}

Name Source Type Go type Separator Required Default Description
X-Disable-Provenance header string string Allows editing of provisioned resources in the Grafana UI
Body body EmbeddedContactPoint models.EmbeddedContactPoint

{{% /responsive-table %}}

All responses

Code Status Description Has headers Schema
202 Accepted EmbeddedContactPoint schema
400 Bad Request ValidationError schema

Responses

202 - EmbeddedContactPoint

Status: Accepted

Schema

EmbeddedContactPoint

400 - ValidationError

Status: Bad Request

Schema

ValidationError

Create a new mute timing. (RoutePostMuteTiming)

POST /api/v1/provisioning/mute-timings

Consumes

  • application/json

Parameters

{{% responsive-table %}}

Name Source Type Go type Separator Required Default Description
X-Disable-Provenance header string string Allows editing of provisioned resources in the Grafana UI
Body body MuteTimeInterval models.MuteTimeInterval

{{% /responsive-table %}}

All responses

Code Status Description Has headers Schema
201 Created MuteTimeInterval schema
400 Bad Request ValidationError schema

Responses

201 - MuteTimeInterval

Status: Created

Schema

MuteTimeInterval

400 - ValidationError

Status: Bad Request

Schema

ValidationError

Update an existing alert rule. (RoutePutAlertRule)

PUT /api/v1/provisioning/alert-rules/{UID}

Consumes

  • application/json

Parameters

{{% responsive-table %}}

Name Source Type Go type Separator Required Default Description
UID path string string ✓ Alert rule UID
X-Disable-Provenance header string string Allows editing of provisioned resources in the Grafana UI
Body body ProvisionedAlertRule models.ProvisionedAlertRule

{{% /responsive-table %}}

All responses

Code Status Description Has headers Schema
200 OK ProvisionedAlertRule schema
400 Bad Request ValidationError schema

Responses

200 - ProvisionedAlertRule

Status: OK

Schema

ProvisionedAlertRule

400 - ValidationError

Status: Bad Request

Schema

ValidationError

Update the interval of a rule group. (RoutePutAlertRuleGroup)

PUT /api/v1/provisioning/folder/{FolderUID}/rule-groups/{Group}

Consumes

  • application/json

Parameters

{{% responsive-table %}}

Name Source Type Go type Separator Required Default Description
FolderUID path string string ✓
Group path string string ✓
X-Disable-Provenance header string string Allows editing of provisioned resources in the Grafana UI
Body body AlertRuleGroup models.AlertRuleGroup

{{% /responsive-table %}}

All responses

Code Status Description Has headers Schema
200 OK AlertRuleGroup schema
400 Bad Request ValidationError schema

Responses

200 - AlertRuleGroup

Status: OK

Schema

AlertRuleGroup

400 - ValidationError

Status: Bad Request

Schema

ValidationError

Update an existing contact point. (RoutePutContactpoint)

PUT /api/v1/provisioning/contact-points/{UID}

Consumes

  • application/json

Parameters

{{% responsive-table %}}

Name Source Type Go type Separator Required Default Description
UID path string string ✓ UID is the contact point unique identifier
X-Disable-Provenance header string string Allows editing of provisioned resources in the Grafana UI
Body body EmbeddedContactPoint models.EmbeddedContactPoint

{{% /responsive-table %}}

All responses

Code Status Description Has headers Schema
202 Accepted Ack schema
400 Bad Request ValidationError schema

Responses

202 - Ack

Status: Accepted

Schema

Ack

400 - ValidationError

Status: Bad Request

Schema

ValidationError

Replace an existing mute timing. (RoutePutMuteTiming)

PUT /api/v1/provisioning/mute-timings/{name}

Consumes

  • application/json

Parameters

{{% responsive-table %}}

Name Source Type Go type Separator Required Default Description
name path string string ✓ Mute timing name
X-Disable-Provenance header string string Allows editing of provisioned resources in the Grafana UI
Body body MuteTimeInterval models.MuteTimeInterval

{{% /responsive-table %}}

All responses

Code Status Description Has headers Schema
200 OK MuteTimeInterval schema
400 Bad Request ValidationError schema

Responses

200 - MuteTimeInterval

Status: OK

Schema

MuteTimeInterval

400 - ValidationError

Status: Bad Request

Schema

ValidationError

Sets the notification policy tree. (RoutePutPolicyTree)

PUT /api/v1/provisioning/policies

Consumes

  • application/json

Parameters

{{% responsive-table %}}

Name Source Type Go type Separator Required Default Description
X-Disable-Provenance header string string Allows editing of provisioned resources in the Grafana UI
Body body Route models.Route The new notification routing tree to use

{{% /responsive-table %}}

All responses

Code Status Description Has headers Schema
202 Accepted Ack schema
400 Bad Request ValidationError schema

Responses

202 - Ack

Status: Accepted

Schema

Ack

400 - ValidationError

Status: Bad Request

Schema

ValidationError

Updates an existing notification template. (RoutePutTemplate)

PUT /api/v1/provisioning/templates/{name}

Consumes

  • application/json

{{% responsive-table %}}

Parameters

Name Source Type Go type Separator Required Default Description
name path string string ✓ Template Name
X-Disable-Provenance header string string Allows editing of provisioned resources in the Grafana UI
Body body NotificationTemplateContent models.NotificationTemplateContent

{{% /responsive-table %}}

All responses

Code Status Description Has headers Schema
202 Accepted NotificationTemplate schema
400 Bad Request ValidationError schema

Responses

202 - NotificationTemplate

Status: Accepted

Schema

NotificationTemplate

400 - ValidationError

Status: Bad Request

Schema

ValidationError

Clears the notification policy tree. (RouteResetPolicyTree)

DELETE /api/v1/provisioning/policies

Consumes

  • application/json

All responses

Code Status Description Has headers Schema
202 Accepted Ack schema

Responses

202 - Ack

Status: Accepted

Schema

Ack

Models

Ack

interface{}

AlertQuery

Properties

{{% responsive-table %}}

Name Type Go type Required Default Description Example
datasourceUid string string Grafana data source unique identifier; it should be 'expr' for a Server Side Expression operation.
model interface{} interface{} JSON is the raw JSON query and includes the above properties as well as custom properties.
queryType string string QueryType is an optional identifier for the type of query.
It can be used to distinguish different types of queries.
refId string string RefID is the unique identifier of the query, set by the frontend call.
relativeTimeRange RelativeTimeRange RelativeTimeRange

{{% /responsive-table %}}

AlertQueryExport

Properties

{{% responsive-table %}}

Name Type Go type Required Default Description Example
datasourceUid string string
model interface{} interface{}
queryType string string
refId string string
relativeTimeRange RelativeTimeRange RelativeTimeRange

{{% /responsive-table %}}

AlertRuleExport

Properties

{{% responsive-table %}}

Name Type Go type Required Default Description Example
annotations map of string map[string]string
condition string string
dasboardUid string string
data []AlertQueryExport []*AlertQueryExport
execErrState string string
for Duration Duration
isPaused boolean bool
labels map of string map[string]string
noDataState string string
panelId int64 (formatted integer) int64
title string string
uid string string

{{% /responsive-table %}}

AlertRuleGroup

Properties

{{% responsive-table %}}

Name Type Go type Required Default Description Example
folderUid string string
interval int64 (formatted integer) int64
rules []ProvisionedAlertRule []*ProvisionedAlertRule
title string string

{{% /responsive-table %}}

AlertRuleGroupExport

Properties

{{% responsive-table %}}

Name Type Go type Required Default Description Example
folder string string
interval Duration Duration
name string string
orgId int64 (formatted integer) int64
rules []AlertRuleExport []*AlertRuleExport

{{% /responsive-table %}}

AlertingFileExport

Properties

{{% responsive-table %}}

Name Type Go type Required Default Description Example
apiVersion int64 (formatted integer) int64
contactPoints []ContactPointExport []*ContactPointExport
groups []AlertRuleGroupExport []*AlertRuleGroupExport
policies []NotificationPolicyExport []*NotificationPolicyExport

{{% /responsive-table %}}

ContactPointExport

Properties

Name Type Go type Required Default Description Example
name string string
orgId int64 (formatted integer) int64
receivers []ReceiverExport []*ReceiverExport

ContactPoints

[]EmbeddedContactPoint

Duration

Name Type Go type Default Description Example
Duration int64 (formatted integer) int64

EmbeddedContactPoint

EmbeddedContactPoint is the contact point type that is used by grafanas embedded alertmanager implementation.

Properties

{{% responsive-table %}}

Name Type Go type Required Default Description Example
disableResolveMessage boolean bool false
name string string Name is used as grouping key in the UI. Contact points with the
same name will be grouped in the UI. webhook_1
provenance string string
settings JSON JSON ✓
type string string ✓ webhook
uid string string UID is the unique identifier of the contact point. The UID can be
set by the user. my_external_reference

{{% /responsive-table %}}

Json

interface{}

MatchRegexps

MatchRegexps

MatchType

Name Type Go type Default Description Example
MatchType int64 (formatted integer) int64

Matcher

Properties

{{% responsive-table %}}

Name Type Go type Required Default Description Example
Name string string
Type MatchType MatchType
Value string string

{{% /responsive-table %}}

Matchers

Matchers is a slice of Matchers that is sortable, implements Stringer, and provides a Matches method to match a LabelSet against all Matchers in the slice. Note that some users of Matchers might require it to be sorted.

[]Matcher

MuteTimeInterval

Properties

{{% responsive-table %}}

Name Type Go type Required Default Description Example
name string string
time_intervals []TimeInterval []*TimeInterval

{{% /responsive-table %}}

MuteTimings

[]MuteTimeInterval

NotFound

interface{}

NotificationPolicyExport

Properties

Name Type Go type Required Default Description Example
Policy RouteExport RouteExport inline
orgId int64 (formatted integer) int64

NotificationTemplate

Properties

{{% responsive-table %}}

Name Type Go type Required Default Description Example
name string string
provenance Provenance Provenance
template string string

{{% /responsive-table %}}

NotificationTemplateContent

Properties

{{% responsive-table %}}

Name Type Go type Required Default Description Example
template string string

{{% /responsive-table %}}

NotificationTemplates

[]NotificationTemplate

ObjectMatchers

Matchers

Inlined models

PermissionDenied

interface{}

Provenance

Name Type Go type Default Description Example
Provenance string string

ProvisionedAlertRule

Properties

{{% responsive-table %}}

Name Type Go type Required Default Description Example
annotations map of string map[string]string {"runbook_url":"https://supercoolrunbook.com/page/13"}
condition string string ✓ A
data []AlertQuery []*AlertQuery ✓ [{"datasourceUid":"__expr__","model":{"conditions":[{"evaluator":{"params":[0,0],"type":"gt"},"operator":{"type":"and"},"query":{"params":[]},"reducer":{"params":[],"type":"avg"},"type":"query"}],"datasource":{"type":"__expr__","uid":"__expr__"},"expression":"1 == 1","hide":false,"intervalMs":1000,"maxDataPoints":43200,"refId":"A","type":"math"},"queryType":"","refId":"A","relativeTimeRange":{"from":0,"to":0}}]
execErrState string string ✓
folderUID string string ✓ project_x
for Duration Duration ✓
id int64 (formatted integer) int64
isPaused boolean bool false
labels map of string map[string]string {"team":"sre-team-1"}
noDataState string string ✓
orgID int64 (formatted integer) int64 ✓
provenance Provenance Provenance
ruleGroup string string ✓ eval_group_1
title string string ✓ Always firing
uid string string
updated date-time (formatted string) strfmt.DateTime

{{% /responsive-table %}}

ProvisionedAlertRules

[]ProvisionedAlertRule

RawMessage

interface{}

ReceiverExport

Properties

Name Type Go type Required Default Description Example
disableResolveMessage boolean bool
settings RawMessage RawMessage
type string string
uid string string

Regexp

A Regexp is safe for concurrent use by multiple goroutines, except for configuration methods, such as Longest.

interface{}

RelativeTimeRange

RelativeTimeRange is the per query start and end time for requests.

Properties

{{% responsive-table %}}

Name Type Go type Required Default Description Example
from Duration Duration
to Duration Duration

{{% /responsive-table %}}

Route

A Route is a node that contains definitions of how to handle alerts. This is modified from the upstream alertmanager in that it adds the ObjectMatchers property.

Properties

{{% responsive-table %}}

Name Type Go type Required Default Description Example
continue boolean bool
group_by []string []string
group_interval string string
group_wait string string
match map of string map[string]string Deprecated. Remove before v1.0 release.
match_re MatchRegexps MatchRegexps
matchers Matchers Matchers
mute_time_intervals []string []string
object_matchers ObjectMatchers ObjectMatchers
provenance Provenance Provenance
receiver string string
repeat_interval string string
routes []Route []*Route

{{% /responsive-table %}}

RouteExport

RouteExport is the provisioned file export of definitions.Route. This is needed to hide fields that aren't usable in provisioning file format. An alternative would be to define a custom MarshalJSON and MarshalYAML that excludes them.

Properties

Name Type Go type Required Default Description Example
continue boolean bool
group_by []string []string
group_interval string string
group_wait string string
match map of string map[string]string Deprecated. Remove before v1.0 release.
match_re MatchRegexps MatchRegexps
matchers Matchers Matchers
mute_time_intervals []string []string
object_matchers ObjectMatchers ObjectMatchers
receiver string string
repeat_interval string string
routes []RouteExport []*RouteExport

TimeInterval

TimeInterval describes intervals of time. ContainsTime will tell you if a golang time is contained within the interval.

Properties

{{% responsive-table %}}

Name Type Go type Required Default Description Example
days_of_month []string []string
location string string
months []string []string
times []TimeRange []*TimeRange
weekdays []string []string
years []string []string

{{% /responsive-table %}}

TimeRange

For example, 4:00PM to End of the day would Begin at 1020 and End at 1440.

Properties

{{% responsive-table %}}

Name Type Go type Required Default Description Example
EndMinute int64 (formatted integer) int64
StartMinute int64 (formatted integer) int64

{{% /responsive-table %}}

ValidationError

Properties

{{% responsive-table %}}

Name Type Go type Required Default Description Example
msg string string error message

{{% /responsive-table %}}