mirror of
https://github.com/grafana/grafana.git
synced 2025-02-12 08:35:43 -06:00
19ebb079ba
This commit adds support for limits and filters to the Prometheus Rules
API.
Limits:
It adds a number of limits to the Grafana flavour of the Prometheus Rules
API:
- `limit` limits the maximum number of Rule Groups returned
- `limit_rules` limits the maximum number of rules per Rule Group
- `limit_alerts` limits the maximum number of alerts per rule
It sorts Rule Groups and rules within Rule Groups such that data in the
response is stable across requests. It also returns summaries (totals)
for all Rule Groups, individual Rule Groups and rules.
Filters:
Alerts can be filtered by state with the `state` query string. An example
of an HTTP request asking for just firing alerts might be
`/api/prometheus/grafana/api/v1/rules?state=alerting`.
A request can filter by two or more states by adding additional `state`
query strings to the URL. For example `?state=alerting&state=normal`.
Like the alert list panel, the `firing`, `pending` and `normal` state are
first compared against the state of each alert rule. All other states are
ignored. If the alert rule matches then its alert instances are filtered
against states once more.
Alerts can also be filtered by labels using the `matcher` query string.
Like `state`, multiple matchers can be provided by adding additional
`matcher` query strings to the URL.
The match expression should be parsed using existing regular expression
and sent to the API as URL-encoded JSON in the format:
{
"name": "test",
"value": "value1",
"isRegex": false,
"isEqual": true
}
The `isRegex` and `isEqual` options work as follows:
| IsEqual | IsRegex | Operator |
| ------- | -------- | -------- |
| true | false | = |
| true | true | =~ |
| false | true | !~ |
| false | false | != |
|
||
|---|---|---|
| .. | ||
| test-data | ||
| tooling | ||
| api_alertmanager_guards_test.go | ||
| api_alertmanager_guards.go | ||
| api_alertmanager_test.go | ||
| api_alertmanager.go | ||
| api_configuration_test.go | ||
| api_configuration.go | ||
| api_prometheus_test_fixtures.go | ||
| api_prometheus_test.go | ||
| api_prometheus.go | ||
| api_provisioning_test.go | ||
| api_provisioning.go | ||
| api_ruler_history.go | ||
| api_ruler_test.go | ||
| api_ruler_validation_test.go | ||
| api_ruler_validation.go | ||
| api_ruler.go | ||
| api_testing_test.go | ||
| api_testing.go | ||
| api.go | ||
| authorization_test.go | ||
| authorization.go | ||
| compat_test.go | ||
| compat.go | ||
| configuration.go | ||
| errors.go | ||
| forking_alertmanager.go | ||
| forking_prometheus.go | ||
| forking_ruler.go | ||
| generated_base_api_alertmanager.go | ||
| generated_base_api_configuration.go | ||
| generated_base_api_history.go | ||
| generated_base_api_prometheus.go | ||
| generated_base_api_provisioning.go | ||
| generated_base_api_ruler.go | ||
| generated_base_api_testing.go | ||
| lotex_am.go | ||
| lotex_prom.go | ||
| lotex_ruler_test.go | ||
| lotex_ruler.go | ||
| persist.go | ||
| promql_compat_test.go | ||
| promql_compat.go | ||
| provisioning.go | ||
| ruler_history.go | ||
| testing_api.go | ||
| testing.go | ||
| util_test.go | ||
| util.go | ||