> ## Documentation Index
> Fetch the complete documentation index at: https://coralogix-193a2008-facade-sync-01851a7.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

# Alert definitions service overview

View and manage your alerts using alert definitions - data structures that contain the configuration required to create an alert.

Learn more about alerts in our [documentation](https://coralogix.com/docs/user-guides/alerting/introduction-to-alerts/).

## Authentication and permissions

To use the Alert definitions service API you need to [create a personal or team API key](https://coralogix.com/docs/user-guides/account-management/api-keys/api-keys/). It's recommended to use permission presets, as they are automatically updated with all relevant permissions. Alternatively, you can manually add the following individual permissions.

| Presets | Permission | Description |
| - | - | - |
| Alerts | `alerts:ReadConfig` | Grants access to read alerts |
| | `alerts:UpdateConfig` | Required to create, update, or delete alerts |

## Common error response codes

| Status Code | Description |
| - | - |
| `400 Bad Request` | Response code 400 |
| `401 Unauthorized` | Response code 401 |
| `500 Internal Server Error` | Response code 500 |

## Protocol documentation

### AlertDef

Represents An Existing or Created Alert Definition

| Field | Type | Label | Description |
| - | - | - | - |
| alert\_def\_properties | AlertDefProperties | | |
| id | google.protobuf.StringValue | | This is the Alert Definition's Persistent ID (does not change on replace) , AKA UniqueIDentifier |
| alert\_version\_id | google.protobuf.StringValue | | the old alertID |
| created\_time | google.protobuf.Timestamp | | |
| updated\_time | google.protobuf.Timestamp | | |

### AlertDefProperties

Represents The non generated alert definition properties (the ones that are set by the user)

| Field | Type | Label | Description |
| - | - | - | - |
| name | google.protobuf.StringValue | | |
| description | google.protobuf.StringValue | | |
| enabled | google.protobuf.BoolValue | | |
| priority | AlertDefPriority | | |
| active\_on | ActivitySchedule | | |
| type | AlertDefType | | |
| logs\_immediate | LogsImmediateType | | |
| tracing\_immediate | TracingImmediateType | | |
| logs\_threshold | LogsThresholdType | | |
| logs\_ratio\_threshold | LogsRatioThresholdType | | |
| logs\_time\_relative\_threshold | LogsTimeRelativeThresholdType | | |
| metric\_threshold | MetricThresholdType | | |
| tracing\_threshold | TracingThresholdType | | |
| flow | FlowType | | |
| logs\_anomaly | LogsAnomalyType | | |
| metric\_anomaly | MetricAnomalyType | | |
| logs\_new\_value | LogsNewValueType | | |
| logs\_unique\_count | LogsUniqueCountType | | |
| group\_by\_keys | google.protobuf.StringValue | repeated | |
| incidents\_settings | AlertDefIncidentSettings | | |
| notification\_group | AlertDefNotificationGroup | | |
| entity\_labels | AlertDefProperties.EntityLabelsEntry | repeated | |
| phantom\_mode | google.protobuf.BoolValue | | |
| deleted | google.protobuf.BoolValue | | |

### AlertDefProperties.EntityLabelsEntry

| Field | Type | Label | Description |
| - | - | - | - |
| key | string | | |
| value | string | | |

### AlertDefIncidentSettings

| Field | Type | Label | Description |
| - | - | - | - |
| minutes | google.protobuf.UInt32Value | | |
| notify\_on | NotifyOn | | |

### AlertDefNotificationGroup

| Field | Type | Label | Description |
| - | - | - | - |
| group\_by\_keys | google.protobuf.StringValue | repeated | |
| webhooks | AlertDefWebhooksSettings | repeated | |

### AlertDefWebhooksSettings

| Field | Type | Label | Description |
| - | - | - | - |
| minutes | google.protobuf.UInt32Value | | |
| notify\_on | NotifyOn | optional | |
| integration | IntegrationType | | |

### IntegrationType

| Field | Type | Label | Description |
| - | - | - | - |
| integration\_id | google.protobuf.UInt32Value | | |
| recipients | Recipients | | |

### Recipients

| Field | Type | Label | Description |
| - | - | - | - |
| emails | google.protobuf.StringValue | repeated | |

### NotifyOn

| Name | Number | Description |
| - | - | - |
| NOTIFY\_ON\_TRIGGERED\_ONLY\_UNSPECIFIED | 0 | |
| NOTIFY\_ON\_TRIGGERED\_AND\_RESOLVED | 1 | |

### AlertDefPriority

| Name | Number | Description |
| - | - | - |
| ALERT\_DEF\_PRIORITY\_P5\_OR\_UNSPECIFIED | 0 | |
| ALERT\_DEF\_PRIORITY\_P4 | 1 | |
| ALERT\_DEF\_PRIORITY\_P3 | 2 | |
| ALERT\_DEF\_PRIORITY\_P2 | 3 | |
| ALERT\_DEF\_PRIORITY\_P1 | 4 | |

### ActivitySchedule

| Field | Type | Label | Description |
| - | - | - | - |
| day\_of\_week | DayOfWeek | repeated | |
| start\_time | TimeOfDay | | |
| end\_time | TimeOfDay | | |

### TimeOfDay

| Field | Type | Label | Description |
| - | - | - | - |
| hours | int32 | | Hours of day in 24 hour format. Should be from 0 to 23. |
| minutes | int32 | | Minutes of hour of day. Must be from 0 to 59. |

### DayOfWeek

| Name | Number | Description |
| - | - | - |
| DAY\_OF\_WEEK\_MONDAY\_OR\_UNSPECIFIED | 0 | |
| DAY\_OF\_WEEK\_TUESDAY | 1 | |
| DAY\_OF\_WEEK\_WEDNESDAY | 2 | |
| DAY\_OF\_WEEK\_THURSDAY | 3 | |
| DAY\_OF\_WEEK\_FRIDAY | 4 | |
| DAY\_OF\_WEEK\_SATURDAY | 5 | |
| DAY\_OF\_WEEK\_SUNDAY | 6 | |

### AlertDefType

| Name | Number | Description |
| - | - | - |
| ALERT\_DEF\_TYPE\_LOGS\_IMMEDIATE\_OR\_UNSPECIFIED | 0 | |
| ALERT\_DEF\_TYPE\_LOGS\_THRESHOLD | 1 | |
| ALERT\_DEF\_TYPE\_LOGS\_ANOMALY | 3 | |
| ALERT\_DEF\_TYPE\_LOGS\_RATIO\_THRESHOLD | 4 | |
| ALERT\_DEF\_TYPE\_LOGS\_NEW\_VALUE | 6 | |
| ALERT\_DEF\_TYPE\_LOGS\_UNIQUE\_COUNT | 7 | |
| ALERT\_DEF\_TYPE\_LOGS\_TIME\_RELATIVE\_THRESHOLD | 8 | |
| ALERT\_DEF\_TYPE\_METRIC\_THRESHOLD | 10 | |
| ALERT\_DEF\_TYPE\_METRIC\_ANOMALY | 14 | |
| ALERT\_DEF\_TYPE\_TRACING\_IMMEDIATE | 15 | |
| ALERT\_DEF\_TYPE\_TRACING\_THRESHOLD | 16 | |
| ALERT\_DEF\_TYPE\_FLOW | 17 | |

### ActivityAnalysis

| Field | Type | Label | Description |
| - | - | - | - |
| rules | string | repeated | |
| status | ActivityAnalysisStatus | | |

### ActivityAnalysisStatus

| Name | Number | Description |
| - | - | - |
| ACTIVITY\_ANALYSIS\_STATUS\_ACTIVATE\_OR\_UNSPECIFIED | 0 | |
| ACTIVITY\_ANALYSIS\_STATUS\_MUTE | 1 | |

### FlowStages

| Field | Type | Label | Description |
| - | - | - | - |
| flow\_stages\_groups | FlowStagesGroups | | |
| timeframe\_ms | google.protobuf.Int64Value | | |
| timeframe\_type | TimeframeType | | |

### FlowStagesGroup

| Field | Type | Label | Description |
| - | - | - | - |
| alert\_defs | FlowStagesGroupsAlertDefs | repeated | |
| next\_op | NextOp | | |
| alerts\_op | AlertsOp | | |

### FlowStagesGroups

| Field | Type | Label | Description |
| - | - | - | - |
| groups | FlowStagesGroup | repeated | |

### FlowStagesGroupsAlertDefs

| Field | Type | Label | Description |
| - | - | - | - |
| id | google.protobuf.StringValue | | |
| not | google.protobuf.BoolValue | | |

### FlowType

| Field | Type | Label | Description |
| - | - | - | - |
| stages | FlowStages | repeated | |
| enforce\_suppression | google.protobuf.BoolValue | | |

### AlertsOp

| Name | Number | Description |
| - | - | - |
| ALERTS\_OP\_AND\_OR\_UNSPECIFIED | 0 | |
| ALERTS\_OP\_OR | 1 | |

### NextOp

| Name | Number | Description |
| - | - | - |
| NEXT\_OP\_AND\_OR\_UNSPECIFIED | 0 | |
| NEXT\_OP\_OR | 1 | |

### TimeframeType

| Name | Number | Description |
| - | - | - |
| TIMEFRAME\_TYPE\_UNSPECIFIED | 0 | |
| TIMEFRAME\_TYPE\_UP\_TO | 1 | |

### LogsAnomalyConditionType

| Name | Number | Description |
| - | - | - |
| LOGS\_ANOMALY\_CONDITION\_TYPE\_MORE\_THAN\_USUAL\_OR\_UNSPECIFIED | 0 | |

### LabelFilterType

| Field | Type | Label | Description |
| - | - | - | - |
| value | google.protobuf.StringValue | | |
| operation | LogFilterOperationType | | |

### LabelFilters

| Field | Type | Label | Description |
| - | - | - | - |
| application\_name | LabelFilterType | repeated | |
| subsystem\_name | LabelFilterType | repeated | |
| severities | LogSeverity | repeated | |

### LogsFilter

| Field | Type | Label | Description |
| - | - | - | - |
| simple\_filter | LogsSimpleFilter | | |

### LogsSimpleFilter

| Field | Type | Label | Description |
| - | - | - | - |
| lucene\_query | google.protobuf.StringValue | | |
| label\_filters | LabelFilters | | |

### LogFilterOperationType

| Name | Number | Description |
| - | - | - |
| LOG\_FILTER\_OPERATION\_TYPE\_IS\_OR\_UNSPECIFIED | 0 | |
| LOG\_FILTER\_OPERATION\_TYPE\_INCLUDES | 1 | |
| LOG\_FILTER\_OPERATION\_TYPE\_ENDS\_WITH | 2 | |
| LOG\_FILTER\_OPERATION\_TYPE\_STARTS\_WITH | 3 | |

### LogSeverity

| Name | Number | Description |
| - | - | - |
| LOG\_SEVERITY\_VERBOSE\_UNSPECIFIED | 0 | |
| LOG\_SEVERITY\_DEBUG | 1 | |
| LOG\_SEVERITY\_INFO | 2 | |
| LOG\_SEVERITY\_WARNING | 3 | |
| LOG\_SEVERITY\_ERROR | 4 | |
| LOG\_SEVERITY\_CRITICAL | 5 | |

### LogsTimeWindow

| Field | Type | Label | Description |
| - | - | - | - |
| logs\_time\_window\_specific\_value | LogsTimeWindowValue | | |

### LogsTimeWindowValue

| Name | Number | Description |
| - | - | - |
| LOGS\_TIME\_WINDOW\_VALUE\_MINUTES\_5\_OR\_UNSPECIFIED | 0 | |
| LOGS\_TIME\_WINDOW\_VALUE\_MINUTES\_10 | 1 | |
| LOGS\_TIME\_WINDOW\_VALUE\_MINUTES\_20 | 2 | |
| LOGS\_TIME\_WINDOW\_VALUE\_MINUTES\_15 | 3 | |
| LOGS\_TIME\_WINDOW\_VALUE\_MINUTES\_30 | 4 | |
| LOGS\_TIME\_WINDOW\_VALUE\_HOUR\_1 | 5 | |
| LOGS\_TIME\_WINDOW\_VALUE\_HOURS\_2 | 6 | |
| LOGS\_TIME\_WINDOW\_VALUE\_HOURS\_4 | 7 | |
| LOGS\_TIME\_WINDOW\_VALUE\_HOURS\_6 | 8 | |
| LOGS\_TIME\_WINDOW\_VALUE\_HOURS\_12 | 9 | |
| LOGS\_TIME\_WINDOW\_VALUE\_HOURS\_24 | 10 | |
| LOGS\_TIME\_WINDOW\_VALUE\_HOURS\_36 | 11 | |

### LogsAnomalyCondition

| Field | Type | Label | Description |
| - | - | - | - |
| minimum\_threshold | google.protobuf.DoubleValue | | |
| time\_window | LogsTimeWindow | | |
| condition\_type | LogsAnomalyConditionType | | |

### LogsAnomalyRule

| Field | Type | Label | Description |
| - | - | - | - |
| condition | LogsAnomalyCondition | | |

### LogsAnomalyType

| Field | Type | Label | Description |
| - | - | - | - |
| logs\_filter | LogsFilter | | |
| rules | LogsAnomalyRule | repeated | |
| notification\_payload\_filter | google.protobuf.StringValue | repeated | |

### LogsImmediateType

| Field | Type | Label | Description |
| - | - | - | - |
| logs\_filter | LogsFilter | | |
| notification\_payload\_filter | google.protobuf.StringValue | repeated | |

### LogsNewValueCondition

| Field | Type | Label | Description |
| - | - | - | - |
| keypath\_to\_track | google.protobuf.StringValue | | |
| time\_window | LogsNewValueTimeWindow | | |

### LogsNewValueRule

| Field | Type | Label | Description |
| - | - | - | - |
| condition | LogsNewValueCondition | | |

### LogsNewValueType

| Field | Type | Label | Description |
| - | - | - | - |
| logs\_filter | LogsFilter | | |
| rules | LogsNewValueRule | repeated | |
| notification\_payload\_filter | google.protobuf.StringValue | repeated | |

### LogsRatioCondition

| Field | Type | Label | Description |
| - | - | - | - |
| threshold | google.protobuf.DoubleValue | | |
| time\_window | LogsRatioTimeWindow | | |
| condition\_type | LogsRatioConditionType | | |

### LogsRatioRules

| Field | Type | Label | Description |
| - | - | - | - |
| condition | LogsRatioCondition | | |
| override | AlertDefOverride | | |

### LogsRatioThresholdType

| Field | Type | Label | Description |
| - | - | - | - |
| numerator | LogsFilter | | |
| numerator\_alias | google.protobuf.StringValue | | |
| denominator | LogsFilter | | |
| denominator\_alias | google.protobuf.StringValue | | |
| rules | LogsRatioRules | repeated | |
| ignore\_infinity | google.protobuf.BoolValue | | |
| notification\_payload\_filter | google.protobuf.StringValue | repeated | |
| group\_by\_for | LogsRatioGroupByFor | | |
| undetected\_values\_management | UndetectedValuesManagement | | |

### LogsThresholdCondition

| Field | Type | Label | Description |
| - | - | - | - |
| threshold | google.protobuf.DoubleValue | | |
| time\_window | LogsTimeWindow | | |
| condition\_type | LogsThresholdConditionType | | |

### LogsThresholdRule

| Field | Type | Label | Description |
| - | - | - | - |
| condition | LogsThresholdCondition | | |
| override | AlertDefOverride | | |

### LogsThresholdType

| Field | Type | Label | Description |
| - | - | - | - |
| logs\_filter | LogsFilter | | |
| undetected\_values\_management | UndetectedValuesManagement | | |
| rules | LogsThresholdRule | repeated | |
| notification\_payload\_filter | google.protobuf.StringValue | repeated | |

### LogsTimeRelativeCondition

| Field | Type | Label | Description |
| - | - | - | - |
| threshold | google.protobuf.DoubleValue | | |
| compared\_to | LogsTimeRelativeComparedTo | | |
| condition\_type | LogsTimeRelativeConditionType | | |

### LogsTimeRelativeRule

| Field | Type | Label | Description |
| - | - | - | - |
| condition | LogsTimeRelativeCondition | | |
| override | AlertDefOverride | | |

### LogsTimeRelativeThresholdType

| Field | Type | Label | Description |
| - | - | - | - |
| logs\_filter | LogsFilter | | |
| rules | LogsTimeRelativeRule | repeated | |
| ignore\_infinity | google.protobuf.BoolValue | | |
| notification\_payload\_filter | google.protobuf.StringValue | repeated | |
| undetected\_values\_management | UndetectedValuesManagement | | |

### LogsUniqueCountCondition

| Field | Type | Label | Description |
| - | - | - | - |
| max\_unique\_count | google.protobuf.Int64Value | | |
| time\_window | LogsUniqueValueTimeWindow | | |

### LogsUniqueCountRule

| Field | Type | Label | Description |
| - | - | - | - |
| condition | LogsUniqueCountCondition | | |

### LogsUniqueCountType

| Field | Type | Label | Description |
| - | - | - | - |
| logs\_filter | LogsFilter | | |
| rules | LogsUniqueCountRule | repeated | |
| notification\_payload\_filter | google.protobuf.StringValue | repeated | |
| max\_unique\_count\_per\_group\_by\_key | google.protobuf.Int64Value | | |
| unique\_count\_keypath | google.protobuf.StringValue | | |

### LogsNewValueTimeWindow

| Field | Type | Label | Description |
| - | - | - | - |
| logs\_new\_value\_time\_window\_specific\_value | LogsNewValueTimeWindowValue | | |

### LogsNewValueTimeWindowValue

| Name | Number | Description |
| - | - | - |
| LOGS\_NEW\_VALUE\_TIME\_WINDOW\_VALUE\_HOURS\_12\_OR\_UNSPECIFIED | 0 | |
| LOGS\_NEW\_VALUE\_TIME\_WINDOW\_VALUE\_HOURS\_24 | 1 | |
| LOGS\_NEW\_VALUE\_TIME\_WINDOW\_VALUE\_HOURS\_48 | 2 | |
| LOGS\_NEW\_VALUE\_TIME\_WINDOW\_VALUE\_HOURS\_72 | 3 | |
| LOGS\_NEW\_VALUE\_TIME\_WINDOW\_VALUE\_WEEK\_1 | 4 | |
| LOGS\_NEW\_VALUE\_TIME\_WINDOW\_VALUE\_MONTH\_1 | 5 | |
| LOGS\_NEW\_VALUE\_TIME\_WINDOW\_VALUE\_MONTHS\_2 | 6 | |
| LOGS\_NEW\_VALUE\_TIME\_WINDOW\_VALUE\_MONTHS\_3 | 7 | |

### LogsRatioConditionType

| Name | Number | Description |
| - | - | - |
| LOGS\_RATIO\_CONDITION\_TYPE\_MORE\_THAN\_OR\_UNSPECIFIED | 0 | |
| LOGS\_RATIO\_CONDITION\_TYPE\_LESS\_THAN | 1 | |

### LogsRatioGroupByFor

| Name | Number | Description |
| - | - | - |
| LOGS\_RATIO\_GROUP\_BY\_FOR\_BOTH\_OR\_UNSPECIFIED | 0 | |
| LOGS\_RATIO\_GROUP\_BY\_FOR\_NUMERATOR\_ONLY | 1 | |
| LOGS\_RATIO\_GROUP\_BY\_FOR\_DENUMERATOR\_ONLY | 2 | |

### LogsRatioTimeWindow

| Field | Type | Label | Description |
| - | - | - | - |
| logs\_ratio\_time\_window\_specific\_value | LogsRatioTimeWindowValue | | |

### LogsRatioTimeWindowValue

| Name | Number | Description |
| - | - | - |
| LOGS\_RATIO\_TIME\_WINDOW\_VALUE\_MINUTES\_5\_OR\_UNSPECIFIED | 0 | |
| LOGS\_RATIO\_TIME\_WINDOW\_VALUE\_MINUTES\_10 | 1 | |
| LOGS\_RATIO\_TIME\_WINDOW\_VALUE\_MINUTES\_15 | 2 | |
| LOGS\_RATIO\_TIME\_WINDOW\_VALUE\_MINUTES\_30 | 3 | |
| LOGS\_RATIO\_TIME\_WINDOW\_VALUE\_HOUR\_1 | 4 | |
| LOGS\_RATIO\_TIME\_WINDOW\_VALUE\_HOURS\_2 | 5 | |
| LOGS\_RATIO\_TIME\_WINDOW\_VALUE\_HOURS\_4 | 6 | |
| LOGS\_RATIO\_TIME\_WINDOW\_VALUE\_HOURS\_6 | 7 | |
| LOGS\_RATIO\_TIME\_WINDOW\_VALUE\_HOURS\_12 | 8 | |
| LOGS\_RATIO\_TIME\_WINDOW\_VALUE\_HOURS\_24 | 9 | |
| LOGS\_RATIO\_TIME\_WINDOW\_VALUE\_HOURS\_36 | 10 | |

### LogsThresholdConditionType

| Name | Number | Description |
| - | - | - |
| LOGS\_THRESHOLD\_CONDITION\_TYPE\_MORE\_THAN\_OR\_UNSPECIFIED | 0 | |
| LOGS\_THRESHOLD\_CONDITION\_TYPE\_LESS\_THAN | 1 | |

### LogsTimeRelativeComparedTo

| Name | Number | Description |
| - | - | - |
| LOGS\_TIME\_RELATIVE\_COMPARED\_TO\_PREVIOUS\_HOUR\_OR\_UNSPECIFIED | 0 | |
| LOGS\_TIME\_RELATIVE\_COMPARED\_TO\_SAME\_HOUR\_YESTERDAY | 1 | |
| LOGS\_TIME\_RELATIVE\_COMPARED\_TO\_SAME\_HOUR\_LAST\_WEEK | 2 | |
| LOGS\_TIME\_RELATIVE\_COMPARED\_TO\_YESTERDAY | 3 | |
| LOGS\_TIME\_RELATIVE\_COMPARED\_TO\_SAME\_DAY\_LAST\_WEEK | 4 | |
| LOGS\_TIME\_RELATIVE\_COMPARED\_TO\_SAME\_DAY\_LAST\_MONTH | 5 | |

### LogsTimeRelativeConditionType

| Name | Number | Description |
| - | - | - |
| LOGS\_TIME\_RELATIVE\_CONDITION\_TYPE\_MORE\_THAN\_OR\_UNSPECIFIED | 0 | |
| LOGS\_TIME\_RELATIVE\_CONDITION\_TYPE\_LESS\_THAN | 1 | |

### LogsUniqueValueTimeWindow

| Field | Type | Label | Description |
| - | - | - | - |
| logs\_unique\_value\_time\_window\_specific\_value | LogsUniqueValueTimeWindowValue | | |

### LogsUniqueValueTimeWindowValue

| Name | Number | Description |
| - | - | - |
| LOGS\_UNIQUE\_VALUE\_TIME\_WINDOW\_VALUE\_MINUTE\_1\_OR\_UNSPECIFIED | 0 | |
| LOGS\_UNIQUE\_VALUE\_TIME\_WINDOW\_VALUE\_MINUTES\_15 | 1 | |
| LOGS\_UNIQUE\_VALUE\_TIME\_WINDOW\_VALUE\_MINUTES\_20 | 2 | |
| LOGS\_UNIQUE\_VALUE\_TIME\_WINDOW\_VALUE\_MINUTES\_30 | 3 | |
| LOGS\_UNIQUE\_VALUE\_TIME\_WINDOW\_VALUE\_HOURS\_1 | 4 | |
| LOGS\_UNIQUE\_VALUE\_TIME\_WINDOW\_VALUE\_HOURS\_2 | 5 | |
| LOGS\_UNIQUE\_VALUE\_TIME\_WINDOW\_VALUE\_HOURS\_4 | 6 | |
| LOGS\_UNIQUE\_VALUE\_TIME\_WINDOW\_VALUE\_HOURS\_6 | 7 | |
| LOGS\_UNIQUE\_VALUE\_TIME\_WINDOW\_VALUE\_HOURS\_12 | 8 | |
| LOGS\_UNIQUE\_VALUE\_TIME\_WINDOW\_VALUE\_HOURS\_24 | 9 | |

### MetricAnomalyConditionType

| Name | Number | Description |
| - | - | - |
| METRIC\_ANOMALY\_CONDITION\_TYPE\_MORE\_THAN\_USUAL\_OR\_UNSPECIFIED | 0 | |
| METRIC\_ANOMALY\_CONDITION\_TYPE\_LESS\_THAN\_USUAL | 1 | |

### MetricTimeWindow

| Field | Type | Label | Description |
| - | - | - | - |
| metric\_time\_window\_specific\_value | MetricTimeWindowValue | | |

### MetricTimeWindowValue

| Name | Number | Description |
| - | - | - |
| METRIC\_TIME\_WINDOW\_VALUE\_MINUTES\_1\_OR\_UNSPECIFIED | 0 | |
| METRIC\_TIME\_WINDOW\_VALUE\_MINUTES\_5 | 1 | |
| METRIC\_TIME\_WINDOW\_VALUE\_MINUTES\_10 | 2 | |
| METRIC\_TIME\_WINDOW\_VALUE\_MINUTES\_15 | 3 | |
| METRIC\_TIME\_WINDOW\_VALUE\_MINUTES\_30 | 4 | |
| METRIC\_TIME\_WINDOW\_VALUE\_HOUR\_1 | 5 | |
| METRIC\_TIME\_WINDOW\_VALUE\_HOURS\_2 | 6 | |
| METRIC\_TIME\_WINDOW\_VALUE\_HOURS\_4 | 7 | |
| METRIC\_TIME\_WINDOW\_VALUE\_HOURS\_6 | 8 | |
| METRIC\_TIME\_WINDOW\_VALUE\_HOURS\_12 | 9 | |
| METRIC\_TIME\_WINDOW\_VALUE\_HOURS\_24 | 10 | |

### MetricFilter

| Field | Type | Label | Description |
| - | - | - | - |
| promql | google.protobuf.StringValue | | |

### MetricAnomalyCondition

| Field | Type | Label | Description |
| - | - | - | - |
| threshold | google.protobuf.DoubleValue | | |
| for\_over\_pct | google.protobuf.UInt32Value | | |
| of\_the\_last | MetricTimeWindow | | |
| min\_non\_null\_values\_pct | google.protobuf.UInt32Value | | |
| condition\_type | MetricAnomalyConditionType | | |

### MetricAnomalyRule

| Field | Type | Label | Description |
| - | - | - | - |
| condition | MetricAnomalyCondition | | |

### MetricAnomalyType

| Field | Type | Label | Description |
| - | - | - | - |
| metric\_filter | MetricFilter | | |
| rules | MetricAnomalyRule | repeated | |

### MetricThresholdCondition

| Field | Type | Label | Description |
| - | - | - | - |
| threshold | google.protobuf.DoubleValue | | |
| for\_over\_pct | google.protobuf.UInt32Value | | |
| of\_the\_last | MetricTimeWindow | | |
| condition\_type | MetricThresholdConditionType | | |

### MetricThresholdRule

| Field | Type | Label | Description |
| - | - | - | - |
| condition | MetricThresholdCondition | | |
| override | AlertDefOverride | | |

### MetricThresholdType

| Field | Type | Label | Description |
| - | - | - | - |
| metric\_filter | MetricFilter | | |
| rules | MetricThresholdRule | repeated | |
| missing\_values | MetricMissingValues | | |
| undetected\_values\_management | UndetectedValuesManagement | | |

### MetricThresholdConditionType

| Name | Number | Description |
| - | - | - |
| METRIC\_THRESHOLD\_CONDITION\_TYPE\_MORE\_THAN\_OR\_UNSPECIFIED | 0 | |
| METRIC\_THRESHOLD\_CONDITION\_TYPE\_LESS\_THAN | 1 | |
| METRIC\_THRESHOLD\_CONDITION\_TYPE\_MORE\_THAN\_OR\_EQUALS | 2 | |
| METRIC\_THRESHOLD\_CONDITION\_TYPE\_LESS\_THAN\_OR\_EQUALS | 3 | |

### MetricMissingValues

| Field | Type | Label | Description |
| - | - | - | - |
| replace\_with\_zero | google.protobuf.BoolValue | | |
| min\_non\_null\_values\_pct | google.protobuf.UInt32Value | | |

### AlertDefOverride

| Field | Type | Label | Description |
| - | - | - | - |
| priority | AlertDefPriority | | |

### TracingFilter

| Field | Type | Label | Description |
| - | - | - | - |
| simple\_filter | TracingSimpleFilter | | |

### TracingFilterType

| Field | Type | Label | Description |
| - | - | - | - |
| values | google.protobuf.StringValue | repeated | |
| operation | TracingFilterOperationType | | |

### TracingLabelFilters

| Field | Type | Label | Description |
| - | - | - | - |
| application\_name | TracingFilterType | repeated | |
| subsystem\_name | TracingFilterType | repeated | |
| service\_name | TracingFilterType | repeated | |
| operation\_name | TracingFilterType | repeated | |
| span\_fields | TracingSpanFieldsFilterType | repeated | |

### TracingSimpleFilter

| Field | Type | Label | Description |
| - | - | - | - |
| tracing\_label\_filters | TracingLabelFilters | | |
| latency\_threshold\_ms | google.protobuf.UInt32Value | | |

### TracingSpanFieldsFilterType

| Field | Type | Label | Description |
| - | - | - | - |
| key | google.protobuf.StringValue | | |
| filter\_type | TracingFilterType | | |

### TracingFilterOperationType

| Name | Number | Description |
| - | - | - |
| TRACING\_FILTER\_OPERATION\_TYPE\_IS\_OR\_UNSPECIFIED | 0 | |
| TRACING\_FILTER\_OPERATION\_TYPE\_INCLUDES | 1 | |
| TRACING\_FILTER\_OPERATION\_TYPE\_ENDS\_WITH | 2 | |
| TRACING\_FILTER\_OPERATION\_TYPE\_STARTS\_WITH | 3 | |
| TRACING\_FILTER\_OPERATION\_TYPE\_IS\_NOT | 4 | |

### TracingThresholdConditionType

| Name | Number | Description |
| - | - | - |
| TRACING\_THRESHOLD\_CONDITION\_TYPE\_MORE\_THAN\_OR\_UNSPECIFIED | 0 | |

### TracingTimeWindow

| Field | Type | Label | Description |
| - | - | - | - |
| tracing\_time\_window\_value | TracingTimeWindowValue | | |

### TracingTimeWindowValue

| Name | Number | Description |
| - | - | - |
| TRACING\_TIME\_WINDOW\_VALUE\_MINUTES\_5\_OR\_UNSPECIFIED | 0 | |
| TRACING\_TIME\_WINDOW\_VALUE\_MINUTES\_10 | 1 | |
| TRACING\_TIME\_WINDOW\_VALUE\_MINUTES\_15 | 2 | |
| TRACING\_TIME\_WINDOW\_VALUE\_MINUTES\_30 | 3 | |
| TRACING\_TIME\_WINDOW\_VALUE\_HOUR\_1 | 4 | |
| TRACING\_TIME\_WINDOW\_VALUE\_HOURS\_2 | 5 | |
| TRACING\_TIME\_WINDOW\_VALUE\_HOURS\_4 | 6 | |
| TRACING\_TIME\_WINDOW\_VALUE\_HOURS\_6 | 7 | |
| TRACING\_TIME\_WINDOW\_VALUE\_HOURS\_12 | 8 | |
| TRACING\_TIME\_WINDOW\_VALUE\_HOURS\_24 | 9 | |
| TRACING\_TIME\_WINDOW\_VALUE\_HOURS\_36 | 10 | |

### TracingImmediateType

| Field | Type | Label | Description |
| - | - | - | - |
| tracing\_filter | TracingFilter | | |
| notification\_payload\_filter | google.protobuf.StringValue | repeated | |

### TracingThresholdCondition

| Field | Type | Label | Description |
| - | - | - | - |
| span\_amount | google.protobuf.DoubleValue | | |
| time\_window | TracingTimeWindow | | |
| condition\_type | TracingThresholdConditionType | | |

### TracingThresholdRule

| Field | Type | Label | Description |
| - | - | - | - |
| condition | TracingThresholdCondition | | |

### TracingThresholdType

| Field | Type | Label | Description |
| - | - | - | - |
| tracing\_filter | TracingFilter | | |
| rules | TracingThresholdRule | repeated | |
| notification\_payload\_filter | google.protobuf.StringValue | repeated | |

### UndetectedValuesManagement

| Field | Type | Label | Description |
| - | - | - | - |
| trigger\_undetected\_values | google.protobuf.BoolValue | | |
| auto\_retire\_timeframe | AutoRetireTimeframe | optional | |

### AutoRetireTimeframe

| Name | Number | Description |
| - | - | - |
| AUTO\_RETIRE\_TIMEFRAME\_NEVER\_OR\_UNSPECIFIED | 0 | |
| AUTO\_RETIRE\_TIMEFRAME\_MINUTES\_5 | 1 | |
| AUTO\_RETIRE\_TIMEFRAME\_MINUTES\_10 | 2 | |
| AUTO\_RETIRE\_TIMEFRAME\_HOUR\_1 | 3 | |
| AUTO\_RETIRE\_TIMEFRAME\_HOURS\_2 | 4 | |
| AUTO\_RETIRE\_TIMEFRAME\_HOURS\_6 | 5 | |
| AUTO\_RETIRE\_TIMEFRAME\_HOURS\_12 | 6 | |
| AUTO\_RETIRE\_TIMEFRAME\_HOURS\_24 | 7 | |

### AuditLogDescription

| Field | Type | Label | Description |
| - | - | - | - |
| description | string | optional | |

### BatchGetAlertDefRequest

| Field | Type | Label | Description |
| - | - | - | - |
| ids | google.protobuf.StringValue | repeated | |

### BatchGetAlertDefResponse

| Field | Type | Label | Description |
| - | - | - | - |
| alert\_defs | BatchGetAlertDefResponse.AlertDefsEntry | repeated | |
| not\_found\_ids | google.protobuf.StringValue | repeated | |

### BatchGetAlertDefResponse.AlertDefsEntry

| Field | Type | Label | Description |
| - | - | - | - |
| key | string | | |
| value | AlertDef | | |

### CreateAlertDefRequest

| Field | Type | Label | Description |
| - | - | - | - |
| alert\_def\_properties | AlertDefProperties | | |

### CreateAlertDefResponse

| Field | Type | Label | Description |
| - | - | - | - |
| alert\_def | AlertDef | | |

### DeleteAlertDefRequest

| Field | Type | Label | Description |
| - | - | - | - |
| id | google.protobuf.StringValue | | |

### DeleteAlertDefResponse

### DownloadAlertsRequest

### DownloadAlertsResponse

| Field | Type | Label | Description |
| - | - | - | - |
| content | bytes | | |

### GetAlertDefRequest

| Field | Type | Label | Description |
| - | - | - | - |
| id | google.protobuf.StringValue | | The Alert's non changing ID |

### GetAlertDefResponse

| Field | Type | Label | Description |
| - | - | - | - |
| alert\_def | AlertDef | | |

### ListAlertDefsRequest

### ListAlertDefsResponse

| Field | Type | Label | Description |
| - | - | - | - |
| alert\_defs | AlertDef | repeated | |

### OrderBy

| Field | Type | Label | Description |
| - | - | - | - |
| field\_name | OrderByFields | | |
| direction | OrderByDirection | | |

### ReplaceAlertDefRequest

| Field | Type | Label | Description |
| - | - | - | - |
| alert\_def\_properties | AlertDefProperties | | |
| id | google.protobuf.StringValue | | The AlertDef's ID to be replaced |

### ReplaceAlertDefResponse

| Field | Type | Label | Description |
| - | - | - | - |
| alert\_def | AlertDef | | |

### SetActiveRequest

```
message AlertExecutionRequest {
  oneof request {
    CreateAlertDefRequest create = 1;
    ReplaceAlertDefRequest replace = 2;
    DeleteAlertDefRequest delete = 3;
  }
}

message AlertExecutionResponse {
  oneof response {
    CreateAlertDefResponse create = 1;
    ReplaceAlertDefResponse replace = 2;
    DeleteAlertDefResponse delete = 3;
  }
}

message GetLimitsRequest {}

message GetLimitsResponse {
  google.protobuf.StringValue company_id = 1;
  google.protobuf.Int32Value limit = 2;
  google.protobuf.Int32Value used = 3;
}

message ValidateAlertRequest {
  Alert alert = 1;
}

message ValidateAlertResponse {
  google.protobuf.BoolValue valid = 1;
}
```

| Field | Type | Label | Description |
| - | - | - | - |
| id | google.protobuf.StringValue | | |
| active | google.protobuf.BoolValue | | |

### SetActiveResponse

### OrderByDirection

| Name | Number | Description |
| - | - | - |
| ORDER\_BY\_DIRECTION\_ASC\_OR\_UNSPECIFIED | 0 | |
| ORDER\_BY\_DIRECTION\_DESC | 1 | |

### OrderByFields

| Name | Number | Description |
| - | - | - |
| `ORDER_BY_FIELDS_UNSPECIFIED` | `0` | |
| `ORDER_BY_FIELDS_NAME` | `1` | |
| `ORDER_BY_FIELDS_ID` | `2` | |
| `ORDER_BY_FIELDS_SEVERITY` | `3` | |
| `ORDER_BY_FIELDS_CREATED_TIME` | `4` | |
| `ORDER_BY_FIELDS_UPDATED_TIME` | `5` | |
| `ORDER_BY_FIELDS_LAST_TRIGGERED` | `6` | |

### File-level Extensions

| Extension | Type | Base | Number | Description |
| - | - | - | - | - |
| audit\_log\_description | AuditLogDescription | .google.protobuf.MethodOptions | 5000 | |