Settings API - Metric events schema table
Metric events (builtin:anomaly-detection.metric-events)
Metric event configurations are used to automatically detect anomalies in metric timeseries by using thresholds or baselines.
Schema ID | Schema groups | Scope |
---|---|---|
builtin:anomaly-detection.metric-events |
| environment |
GET | Managed | https://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:anomaly-detection.metric-events |
SaaS | https://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:anomaly-detection.metric-events | |
Environment ActiveGate | https://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:anomaly-detection.metric-events |
Authentication
To execute this request, you need an access token with Read settings (settings.read
) scope. To learn how to obtain and use it, see Tokens and authentication.
Parameters
Property | Type | Description | Required |
---|---|---|---|
Enabledenabled | boolean | - | required |
Summarysummary | text | The textual summary of the metric event entry | required |
Query definitionqueryDefinition | QueryDefinition | - | required |
Monitoring strategymodelProperties | ModelProperties | - | required |
Event templateeventTemplate | EventTemplate | - | required |
Dimension key of entity for eventseventEntityDimensionKey | text | Controls the preferred entity type used for triggered events. | optional |
Config idlegacyId | text | - | optional |
The QueryDefinition
object
Property | Type | Description | Required |
---|---|---|---|
Typetype | enum |
| required |
Metric selectormetricSelector | text | To learn more, visit Metric Selectorļ»æ | required |
Metric keymetricKey | text | - | required |
Aggregationaggregation | enum |
| required |
Management zonemanagementZone | text | - | optional |
Query offsetqueryOffset | integer | Minute offset of sliding evaluation window for metrics with latency | optional |
EntitiesentityFilter | EntityFilter | Use rule-based filters to define the scope this event monitors. | required |
Dimension filterdimensionFilter | DimensionFilter[] | - | required |
The ModelProperties
object
Property | Type | Description | Required |
---|---|---|---|
Model typetype | enum | Metric-key-based query definitions only support static thresholds.
| required |
Thresholdthreshold | float | Raise an event if this value is violated | required |
Alert on missing dataalertOnNoData | boolean | The ability to set an alert on missing data in a metric. When enabled, missing data samples will contribute as violating samples defined in advanced model properties. We recommend to not alert on missing data for sparse timeseries as this leads to alert spam. | required |
Number of signal fluctuationssignalFluctuation | float | Controls how many times the signal fluctuation is added to the baseline to produce the actual threshold for alerting | required |
Tolerancetolerance | float | Controls the width of the confidence band and larger values lead to a less sensitive model | required |
Alert conditionalertCondition | enum |
| required |
Violating samplesviolatingSamples | integer | The number of one-minute samples within the evaluation window that must violate to trigger an event. | required |
Sliding windowsamples | integer | The number of one-minute samples that form the sliding evaluation window. | required |
Dealerting samplesdealertingSamples | integer | The number of one-minute samples within the evaluation window that must go back to normal to close the event. | required |
The EventTemplate
object
Property | Type | Description | Required |
---|---|---|---|
Titletitle | text | The title of the event to trigger. Type '{' for placeholder hints. | required |
Descriptiondescription | text | The description of the event to trigger. Type '{' for placeholder hints. | required |
Event typeeventType | enum | The event type to trigger.
| required |
Allow mergedavisMerge | boolean | DavisĀ® AI will try to merge this event into existing problems, otherwise a new problem will always be created. | required |
Propertiesmetadata | Set<MetadataItem> | Set of additional key-value properties to be attached to the triggered event. | required |
The EntityFilter
object
Property | Type | Description | Required |
---|---|---|---|
Dimension key of entity typedimensionKey | text | Dimension key of entity type to filter | optional |
conditions | EntityFilterCondition[] | - | required |
The DimensionFilter
object
Property | Type | Description | Required |
---|---|---|---|
Dimension keydimensionKey | text | - | required |
Operatoroperator | enum |
| optional |
Dimension valuedimensionValue | text | - | required |
The MetadataItem
object
Property | Type | Description | Required |
---|---|---|---|
KeymetadataKey | text | Type 'dt.' for key hints. | required |
ValuemetadataValue | text | Type '{' for placeholder hints. | required |
The EntityFilterCondition
object
Property | Type | Description | Required |
---|---|---|---|
Filter typetype | enum |
| required |
Operatoroperator | enum |
| required |
Valuevalue | text | - | required |