# AlertHistoryDetails **Source definition:** [`src/bitdrift/public/unary/alerts/v1/alerts.proto#L423-L468`]() Describes why an alert triggered and what data contributed to it.
| Field | Type | Description | |---|---|---| | group_by_dimensions | array of string | If the alert was triggered by a group by dimension, this will contain the dimensions that triggered the alert. | | notification_failures | array of string | If there were errors sending notifications for the alert, they will be listed here. | | alert_config | [bitdrift.public.unary.alerts.v1.AlertConfig](bitdrift_public_unary_alerts_v1_AlertConfig.md "bitdrift.public.unary.alerts.v1.AlertConfig") | Alert configuration snapshot captured when the alert triggered. | | contributing_data | array of [bitdrift.public.unary.alerts.v1.AlertHistoryDetails.ContributingData](#bitdrift.public.unary.alerts.v1.AlertHistoryDetails.ContributingData "bitdrift.public.unary.alerts.v1.AlertHistoryDetails.ContributingData") | The data points that contributed to the alert being triggered. |

Example

```json { "alert_config": { "basic_alert": { "condition": "ABOVE", "consecutive_data_points": 3, "histogram_configuration": { "percentile": 1.0, "percentiles": [ 1.0 ] }, "limit_strategy": { "exclusions": { "dimension_identifiers": [ { "id": "time_series_id_opaque_example", "labels": [ { "name": "name", "value": "value" } ] } ], "return_other": false }, "sort_order": "MAX", "top_k_limit": { "top_k": 5 } }, "threshold": 0.75, "unique_device_threshold": 50, "window": "3600s" }, "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" } } } ] } }, "contributing_data": [ { "basic": { "data_points": [ { "rate_details": { "denominator_count": 42, "numerator_count": 42 }, "timestamp": "2024-01-15T09:30:00Z", "unique_devices": 1, "value": 1.0 } ] } } ], "group_by_dimensions": [ "region:us-east-1" ], "notification_failures": [ "PagerDuty returned an authentication error" ] } ``` # AlertHistoryDetails.BasicContributingData **Source definition:** [`src/bitdrift/public/unary/alerts/v1/alerts.proto#L426-L430`]() In the case of group by this might return multiple items. Describes the data points that contributed to a basic alert trigger.
| Field | Type | Description | |---|---|---| | data_points | array of [bitdrift.public.shared.workflows.v1.DataPoint](bitdrift_public_shared_workflows_v1_DataPoint.md "bitdrift.public.shared.workflows.v1.DataPoint") | The data points that contributed to the alert. For grouped alerts, the response may include multiple time series. |

Example

```json { "data_points": [ { "rate_details": { "denominator_count": 42, "numerator_count": 42 }, "timestamp": "2024-01-15T09:30:00Z", "unique_devices": 1, "value": 1.0 } ] } ``` # AlertHistoryDetails.SloContributingData **Source definition:** [`src/bitdrift/public/unary/alerts/v1/alerts.proto#L433-L442`]() Describes the burn-rate data that contributed to an SLO alert trigger.
| Field | Type | Description | |---|---|---| | window_and_burn_rate | [bitdrift.public.unary.alerts.v1.SloAlertConfig.WindowAndBurnRate](bitdrift_public_unary_alerts_v1_SloAlertConfig.md "bitdrift.public.unary.alerts.v1.SloAlertConfig.WindowAndBurnRate") | Burn-rate window configuration that triggered the alert. | | short_table | [bitdrift.public.unary.dashboards.v1.Table](bitdrift_public_unary_dashboards_v1_Table.md "bitdrift.public.unary.dashboards.v1.Table") | Short-window comparison data for the alert trigger. | | long_table | [bitdrift.public.unary.dashboards.v1.Table](bitdrift_public_unary_dashboards_v1_Table.md "bitdrift.public.unary.dashboards.v1.Table") | Long-window comparison data for the alert trigger. |

Example

```json { "long_table": { "cardinality_overflows": { "group_by_overflows": 1, "query_group_by_collapsed": false, "total_overflows": 42 }, "group_column_key_names": [ "app_id" ], "rows": [ { "aggregated_values": [ { "rate_details": { "denominator_count": 42, "numerator_count": 42 }, "value": 1.0 } ], "group_column_values": [ "io.example.app" ], "unique_devices": 1 } ], "title": "Table title", "unique_devices": 1, "value_column_key_names": [ "count" ] }, "short_table": { "cardinality_overflows": { "group_by_overflows": 1, "query_group_by_collapsed": false, "total_overflows": 42 }, "group_column_key_names": [ "app_id" ], "rows": [ { "aggregated_values": [ { "rate_details": { "denominator_count": 42, "numerator_count": 42 }, "value": 1.0 } ], "group_column_values": [ "io.example.app" ], "unique_devices": 1 } ], "title": "Table title", "unique_devices": 1, "value_column_key_names": [ "count" ] }, "window_and_burn_rate": { "burn_rate": 14.0, "long_window": "3600s", "notifications": { "custom_notification_text": "@incident-commander Review the current burn rate.", "notifications": [ { "min_time_between_notifications": "3600s", "notification_config": { "disabled": false, "notification_group": { "name": "engineering-oncall" } } } ] }, "short_window": "3600s" } } ``` # AlertHistoryDetails.ContributingData **Source definition:** [`src/bitdrift/public/unary/alerts/v1/alerts.proto#L445-L454`]() Wraps the contributing data for whichever alert type triggered.
| Field | Type | Description | |---|---|---| | basic | [bitdrift.public.unary.alerts.v1.AlertHistoryDetails.BasicContributingData](#bitdrift.public.unary.alerts.v1.AlertHistoryDetails.BasicContributingData "bitdrift.public.unary.alerts.v1.AlertHistoryDetails.BasicContributingData")only one of basic, or slo can be set | Contributing data for a basic alert. | | slo | [bitdrift.public.unary.alerts.v1.AlertHistoryDetails.SloContributingData](#bitdrift.public.unary.alerts.v1.AlertHistoryDetails.SloContributingData "bitdrift.public.unary.alerts.v1.AlertHistoryDetails.SloContributingData")only one of slo, or basic can be set | Contributing data for an SLO alert. |

Example

```json { "basic": { "data_points": [ { "rate_details": { "denominator_count": 42, "numerator_count": 42 }, "timestamp": "2024-01-15T09:30:00Z", "unique_devices": 1, "value": 1.0 } ] } } ```