AlertingTemplate CRD schema reference (group sre.smm.cisco.com)
AlertingTemplate
AlertingTemplate specifies non-slo based alerting for a given service/workload
Version v1alpha1
Properties
.apiVersion
APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
.kind
Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
.metadata
.spec
AlertingTemplateSpec specifies a template for alerting purposes (without SLOs)
.spec.category
Category should be used on the frontend to categorize multiple ATs
.spec.details
Additional details to show to the user, when eximinging the Alert
.spec.details.description
Description is the one paragraph long description of the health indicator scenario
.spec.details.metricUnit
MetricUnit contains the unit in which the given metric is measured
.spec.details.relatedGraphs
RelatedGraphs specify what additional information we can show the end user for better troubleshooting capabilities
.spec.details.relatedGraphs[*]
RelatedGraphsConfiguration defines the additional graphs configuration that can help the end-user to troubleshoot the given health indicator issue.
.spec.details.relatedGraphs[*].name
Name is the five-word description of the health indicator scenario
.spec.details.relatedGraphs[*].series
Series is the specification of the prometheus based series to show on this graph
.spec.details.relatedGraphs[*].series[*]
SeriesQueryConfiguration defines a series that should be shown on the related graphs
.spec.details.relatedGraphs[*].series[*].name
Name is the additional description appended to the given series, useful for differentiating series coming from different sources, should be only used when showing multiple series
.spec.details.relatedGraphs[*].series[*].query
Query defines the prometheus query to be executed to fetch the graph’s data. The same go templating variables are available as with .spec.condition.query
.spec.details.relatedGraphs[*].stack
Stack describes if the graph should be displayed in stacked manner, default: false
.spec.details.relatedGraphs[*].thresholds
Thresholds can show some thresholds on the graphs based on promql queries if desired, useful for showing moving averages the health indicators are relative to.
.spec.details.relatedGraphs[*].thresholds[*]
RelatedGraphThresholdConfiguration specifies a threshold line on the graph itself
.spec.details.relatedGraphs[*].thresholds[*].name
Name is the name of the threshold shown on the user interface
.spec.details.relatedGraphs[*].thresholds[*].query
Query defines the prometheus query to be executed to fetch the threshold’s data. The same go templating variables are available as with .spec.condition.query. If it returns multiple labels the first label will be used for grouping.
.spec.details.relatedGraphs[*].unit
Unit describes the unit of values shown on the graph, if empty defaults to the parent object’s unit (HealthIndicator or Group)
.spec.details.relatedGraphs[*].when
When, if not an empty string, contain a go template for a PromQL query. Before showing the graph, the query is executed and the graph is only shown if the query returns any data
.spec.details.shortName
ShortName is the five-word description of the health indicator scenario
.spec.parameters
Definitions of the parameters the Rules are depending on
.spec.parameters[*]
.spec.parameters[*].advanced
.spec.parameters[*].default
.spec.parameters[*].description
.spec.parameters[*].name
.spec.rules
Rules is the template that is to be used to render the final PrometheusRule each field is subject to template rendering the same way as with SLI Templates
.spec.rules[*]
RuleGroup is a list of sequentially evaluated recording and alerting rules. Note: PartialResponseStrategy is only used by ThanosRuler and will be ignored by Prometheus instances. Valid values for this field are ‘warn’ or ‘abort’. More info: https://github.com/thanos-io/thanos/blob/master/docs/components/rule.md#partial-response
.spec.rules[*].interval
.spec.rules[*].name
.spec.rules[*].partial_response_strategy
.spec.rules[*].rules
.spec.rules[*].rules[*]
Rule describes an alerting or recording rule.
.spec.rules[*].rules[*].alert
.spec.rules[*].rules[*].annotations
.spec.rules[*].rules[*].expr
.spec.rules[*].rules[*].for
.spec.rules[*].rules[*].labels
.spec.rules[*].rules[*].record
.spec.scope
Scope specifies if this is a service or workload specific template, right now only services are supported
.status
AlertingTemplateStatus describes the status of an AlertingTemplate