# IssuesAlertConfig
**Source definition:** [`src/bitdrift/public/unary/alerts/v1/issue_alerts.proto#L19-L118`]()
Defines the issue alert configuration for an issues view.
| Field | Type | Description |
|---|---|---|
| new_issue_event_notification | array of [bitdrift.public.unary.alerts.v1.RateLimitedNotificationConfig](bitdrift_public_unary_alerts_v1_RateLimitedNotificationConfig.md "bitdrift.public.unary.alerts.v1.RateLimitedNotificationConfig")
up to 20 items | Rate limited notifications for new issue events within the view. |
| new_issue_group_notification | array of [bitdrift.public.unary.alerts.v1.RateLimitedNotificationConfig](bitdrift_public_unary_alerts_v1_RateLimitedNotificationConfig.md "bitdrift.public.unary.alerts.v1.RateLimitedNotificationConfig")
up to 20 items | Notifications for new issue groups within the view. |
| alerts | array of [bitdrift.public.unary.alerts.v1.IssuesAlertConfig.IssuesAlert](#bitdrift.public.unary.alerts.v1.IssuesAlertConfig.IssuesAlert "bitdrift.public.unary.alerts.v1.IssuesAlertConfig.IssuesAlert")
up to 20 items | Alerts for the view. |
Example
```json
{
"alerts": [
{
"alert_uuid": "0197eb79-ef35-72ec-8e9f-91a4123c18c5",
"common_config": {
"custom_notification_text": "@checkout-oncall Please investigate.",
"description": "Triggers when the checkout workflow error rate exceeds the configured threshold.",
"labels": {
"key": ""
},
"name": "Checkout error rate",
"notifications": [
{
"min_time_between_notifications": "3600s",
"notification_config": {
"disabled": false,
"notification_group": {
"name": "engineering-oncall"
}
}
}
]
},
"condition": {
"and_conditions": {
"conditions": [
{}
]
}
},
"disabled": false,
"per_issue_group": false
}
],
"new_issue_event_notification": [
{
"min_time_between_notifications": "3600s",
"notification_config": {
"disabled": false,
"notification_group": {
"name": "engineering-oncall"
}
}
}
],
"new_issue_group_notification": [
{
"min_time_between_notifications": "3600s",
"notification_config": {
"disabled": false,
"notification_group": {
"name": "engineering-oncall"
}
}
}
]
}
```
# IssuesAlertConfig.IssuesAlertConditionList
**Source definition:** [`src/bitdrift/public/unary/alerts/v1/issue_alerts.proto#L21-L27`]()
Groups multiple issue alert conditions under a logical operator.
| Field | Type | Description |
|---|---|---|
| conditions | array of [bitdrift.public.unary.alerts.v1.IssuesAlertConfig.IssuesAlertCondition](#bitdrift.public.unary.alerts.v1.IssuesAlertConfig.IssuesAlertCondition "bitdrift.public.unary.alerts.v1.IssuesAlertConfig.IssuesAlertCondition")
between 2 and 20 items | Conditions combined by the surrounding logical operator. |
Example
```json
{
"conditions": [
{
"and_conditions": {}
}
]
}
```
# IssuesAlertConfig.CountOverDuration
**Source definition:** [`src/bitdrift/public/unary/alerts/v1/issue_alerts.proto#L30-L36`]()
Defines a count threshold that must be met within a duration.
| Field | Type | Description |
|---|---|---|
| count | uint64 | Minimum count required during the duration. |
| duration | [google.protobuf.Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration "google.protobuf.Duration") | Duration over which the count is evaluated. |
Example
```json
{
"count": 100,
"duration": "3600s"
}
```
# IssuesAlertConfig.PercentOverDuration
**Source definition:** [`src/bitdrift/public/unary/alerts/v1/issue_alerts.proto#L39-L45`]()
Defines a percentage threshold that must be met within a duration.
| Field | Type | Description |
|---|---|---|
| percent | double | Minimum percentage required during the duration. |
| duration | [google.protobuf.Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration "google.protobuf.Duration") | Duration over which the percentage is evaluated. |
Example
```json
{
"duration": "3600s",
"percent": 0.1
}
```
# IssuesAlertConfig.IssuesAlertCondition
**Source definition:** [`src/bitdrift/public/unary/alerts/v1/issue_alerts.proto#L48-L84`]()
Defines the condition that controls when an issues alert fires.
| Field | Type | Description |
|---|---|---|
| and_conditions | [bitdrift.public.unary.alerts.v1.IssuesAlertConfig.IssuesAlertConditionList](#bitdrift.public.unary.alerts.v1.IssuesAlertConfig.IssuesAlertConditionList "bitdrift.public.unary.alerts.v1.IssuesAlertConfig.IssuesAlertConditionList")only one of and_conditions, or or_conditions, event_threshold, unique_device_threshold, unique_session_threshold, event_to_app_open_threshold, event_unique_sessions_to_overall_unique_sessions_threshold, event_rate_of_change, event_unique_devices_to_overall_unique_devices_threshold can be set | All conditions must be met for the alert to fire. |
| or_conditions | [bitdrift.public.unary.alerts.v1.IssuesAlertConfig.IssuesAlertConditionList](#bitdrift.public.unary.alerts.v1.IssuesAlertConfig.IssuesAlertConditionList "bitdrift.public.unary.alerts.v1.IssuesAlertConfig.IssuesAlertConditionList")only one of or_conditions, or and_conditions, event_threshold, unique_device_threshold, unique_session_threshold, event_to_app_open_threshold, event_unique_sessions_to_overall_unique_sessions_threshold, event_rate_of_change, event_unique_devices_to_overall_unique_devices_threshold can be set | Any of the conditions must be met for the alert to fire. |
| event_threshold | [bitdrift.public.unary.alerts.v1.IssuesAlertConfig.CountOverDuration](#bitdrift.public.unary.alerts.v1.IssuesAlertConfig.CountOverDuration "bitdrift.public.unary.alerts.v1.IssuesAlertConfig.CountOverDuration")only one of event_threshold, or and_conditions, or_conditions, unique_device_threshold, unique_session_threshold, event_to_app_open_threshold, event_unique_sessions_to_overall_unique_sessions_threshold, event_rate_of_change, event_unique_devices_to_overall_unique_devices_threshold can be set | A count of events over a duration required for the alert to fire. |
| unique_device_threshold | [bitdrift.public.unary.alerts.v1.IssuesAlertConfig.CountOverDuration](#bitdrift.public.unary.alerts.v1.IssuesAlertConfig.CountOverDuration "bitdrift.public.unary.alerts.v1.IssuesAlertConfig.CountOverDuration")only one of unique_device_threshold, or and_conditions, or_conditions, event_threshold, unique_session_threshold, event_to_app_open_threshold, event_unique_sessions_to_overall_unique_sessions_threshold, event_rate_of_change, event_unique_devices_to_overall_unique_devices_threshold can be set | A count of unique devices over a duration required for the alert to fire. |
| unique_session_threshold | [bitdrift.public.unary.alerts.v1.IssuesAlertConfig.CountOverDuration](#bitdrift.public.unary.alerts.v1.IssuesAlertConfig.CountOverDuration "bitdrift.public.unary.alerts.v1.IssuesAlertConfig.CountOverDuration")only one of unique_session_threshold, or and_conditions, or_conditions, event_threshold, unique_device_threshold, event_to_app_open_threshold, event_unique_sessions_to_overall_unique_sessions_threshold, event_rate_of_change, event_unique_devices_to_overall_unique_devices_threshold can be set | A count of unique sessions over a duration required for the alert to fire. |
| event_to_app_open_threshold | [bitdrift.public.unary.alerts.v1.IssuesAlertConfig.PercentOverDuration](#bitdrift.public.unary.alerts.v1.IssuesAlertConfig.PercentOverDuration "bitdrift.public.unary.alerts.v1.IssuesAlertConfig.PercentOverDuration")only one of event_to_app_open_threshold, or and_conditions, or_conditions, event_threshold, unique_device_threshold, unique_session_threshold, event_unique_sessions_to_overall_unique_sessions_threshold, event_rate_of_change, event_unique_devices_to_overall_unique_devices_threshold can be set | A percentage of events compared to app opens over a duration required for the alert to fire. The app open metric will only be filtered by the platform and app ID. |
| event_unique_sessions_to_overall_unique_sessions_threshold | [bitdrift.public.unary.alerts.v1.IssuesAlertConfig.PercentOverDuration](#bitdrift.public.unary.alerts.v1.IssuesAlertConfig.PercentOverDuration "bitdrift.public.unary.alerts.v1.IssuesAlertConfig.PercentOverDuration")only one of event_unique_sessions_to_overall_unique_sessions_threshold, or and_conditions, or_conditions, event_threshold, unique_device_threshold, unique_session_threshold, event_to_app_open_threshold, event_rate_of_change, event_unique_devices_to_overall_unique_devices_threshold can be set | A percentage of unique sessions with events compared to overall unique sessions over a duration required for the alert to fire. The unique session metric will only be filtered by the platform and app ID. |
| event_rate_of_change | [bitdrift.public.unary.alerts.v1.RateOfChangeAlertConfig](bitdrift_public_unary_alerts_v1_RateOfChangeAlertConfig.md "bitdrift.public.unary.alerts.v1.RateOfChangeAlertConfig")only one of event_rate_of_change, or and_conditions, or_conditions, event_threshold, unique_device_threshold, unique_session_threshold, event_to_app_open_threshold, event_unique_sessions_to_overall_unique_sessions_threshold, event_unique_devices_to_overall_unique_devices_threshold can be set | A rate of change of events over a duration required for the alert to fire. |
| event_unique_devices_to_overall_unique_devices_threshold | [bitdrift.public.unary.alerts.v1.IssuesAlertConfig.PercentOverDuration](#bitdrift.public.unary.alerts.v1.IssuesAlertConfig.PercentOverDuration "bitdrift.public.unary.alerts.v1.IssuesAlertConfig.PercentOverDuration")only one of event_unique_devices_to_overall_unique_devices_threshold, or and_conditions, or_conditions, event_threshold, unique_device_threshold, unique_session_threshold, event_to_app_open_threshold, event_unique_sessions_to_overall_unique_sessions_threshold, event_rate_of_change can be set | A percentage of unique devices with events compared to overall unique devices over a duration required for the alert to fire. The unique device metric will only be filtered by the platform and app ID. |
Example
```json
{
"and_conditions": {
"conditions": [
{}
]
}
}
```
# IssuesAlertConfig.IssuesAlert
**Source definition:** [`src/bitdrift/public/unary/alerts/v1/issue_alerts.proto#L87-L108`]()
Defines one issues alert attached to the view.
| Field | Type | Description |
|---|---|---|
| common_config | [bitdrift.public.unary.alerts.v1.CommonAlertConfig](bitdrift_public_unary_alerts_v1_CommonAlertConfig.md "bitdrift.public.unary.alerts.v1.CommonAlertConfig") | Shared metadata and notification settings for the alert. |
| per_issue_group | bool | If false, the alert applies globally (across all issue groups). If true, the alert applies individually within every issue group. |
| condition | [bitdrift.public.unary.alerts.v1.IssuesAlertConfig.IssuesAlertCondition](#bitdrift.public.unary.alerts.v1.IssuesAlertConfig.IssuesAlertCondition "bitdrift.public.unary.alerts.v1.IssuesAlertConfig.IssuesAlertCondition") | The condition for the alert to fire. |
| disabled | bool | Whether the alert is disabled or not. |
| alert_uuid | string
between 1 and 255 chars | The unique identifier for the alert. This only needs to be unique within a view. This is used to associate history data with this alert. The ID should be kept consistent across modifications where the expectation is the history will be preserved. |
Example
```json
{
"alert_uuid": "0197eb79-ef35-72ec-8e9f-91a4123c18c5",
"common_config": {
"custom_notification_text": "@checkout-oncall Please investigate.",
"description": "Triggers when the checkout workflow error rate exceeds the configured threshold.",
"labels": {
"key": ""
},
"name": "Checkout error rate",
"notifications": [
{
"min_time_between_notifications": "3600s",
"notification_config": {
"disabled": false,
"notification_group": {
"name": "engineering-oncall"
}
}
}
]
},
"condition": {
"and_conditions": {
"conditions": [
{}
]
}
},
"disabled": false,
"per_issue_group": false
}
```