AlertingTemplate CRD schema reference (group sre.smm.cisco.com)

AlertingTemplate specifies non-slo based alerting for a given service/workload

AlertingTemplate

AlertingTemplate specifies non-slo based alerting for a given service/workload

Full name:
alertingtemplates.sre.smm.cisco.com
Group:
sre.smm.cisco.com
Singular name:
alertingtemplate
Plural name:
alertingtemplates
Scope:
Namespaced
Versions:
v1alpha1

Version v1alpha1

Properties

.apiVersion

string

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

string

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

object

.spec

object Required

AlertingTemplateSpec specifies a template for alerting purposes (without SLOs)

.spec.category

string Required

Category should be used on the frontend to categorize multiple ATs

.spec.details

object Required

Additional details to show to the user, when eximinging the Alert

.spec.details.description

string

Description is the one paragraph long description of the health indicator scenario

.spec.details.metricUnit

string

MetricUnit contains the unit in which the given metric is measured

.spec.details.relatedGraphs

array

RelatedGraphs specify what additional information we can show the end user for better troubleshooting capabilities

.spec.details.relatedGraphs[*]

object

RelatedGraphsConfiguration defines the additional graphs configuration that can help the end-user to troubleshoot the given health indicator issue.

.spec.details.relatedGraphs[*].name

string Required

Name is the five-word description of the health indicator scenario

.spec.details.relatedGraphs[*].series

array Required

Series is the specification of the prometheus based series to show on this graph

.spec.details.relatedGraphs[*].series[*]

object

SeriesQueryConfiguration defines a series that should be shown on the related graphs

.spec.details.relatedGraphs[*].series[*].name

string

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

string Required

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

boolean

Stack describes if the graph should be displayed in stacked manner, default: false

.spec.details.relatedGraphs[*].thresholds

array

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[*]

object

RelatedGraphThresholdConfiguration specifies a threshold line on the graph itself

.spec.details.relatedGraphs[*].thresholds[*].name

string Required

Name is the name of the threshold shown on the user interface

.spec.details.relatedGraphs[*].thresholds[*].query

string Required

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

string

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

string

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

string Required

ShortName is the five-word description of the health indicator scenario

.spec.parameters

array Required

Definitions of the parameters the Rules are depending on

.spec.parameters[*]

object

.spec.parameters[*].advanced

boolean

.spec.parameters[*].default

string Required

.spec.parameters[*].description

string Required

.spec.parameters[*].name

string Required

.spec.rules

array Required

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[*]

object

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

string

.spec.rules[*].name

string Required

.spec.rules[*].partial_response_strategy

string

.spec.rules[*].rules

array Required

.spec.rules[*].rules[*]

object

Rule describes an alerting or recording rule.

.spec.rules[*].rules[*].alert

string

.spec.rules[*].rules[*].annotations

object

.spec.rules[*].rules[*].expr

Required

.spec.rules[*].rules[*].for

string

.spec.rules[*].rules[*].labels

object

.spec.rules[*].rules[*].record

string

.spec.scope

string Required

Scope specifies if this is a service or workload specific template, right now only services are supported

.status

object

AlertingTemplateStatus describes the status of an AlertingTemplate