Skip to content

Commit 8e5c76d

Browse files
[bits-ai-sre] Update doc to include manual invocation on warn events (#30475)
1 parent 46e381b commit 8e5c76d

File tree

1 file changed

+11
-11
lines changed

1 file changed

+11
-11
lines changed

content/en/bits_ai/bits_ai_sre/investigate_alerts.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -7,41 +7,41 @@ You can configure Bits to automatically investigate when a monitor triggers an a
77

88
### Enable Bits on monitors for automated investigations
99

10-
There are a few ways to enable Bits for automated investigations:
10+
There are a few ways to enable Bits for automated investigations:
1111
- **Option 1: Use the Bits-Enabled Monitors list**
12-
1. In Bits AI, go to the [**Bits-Enabled Monitors**][5] page.
12+
1. In Bits AI, go to the [**Bits-Enabled Monitors**][5] page.
1313
1. In the **Monitors** tab, select one or more monitors, then click **Enable Bits AI**.
1414
- **Option 2: Add the Bits AI tag to a single monitor**
1515
1. Open a monitor, click on the gear icon in the upper right corner, and select **Edit**.
16-
1. Add the `bitsai:enabled` tag.
16+
1. Add the `bitsai:enabled` tag.
1717
1. Save your changes.
1818
- **Option 3: Add the Bits AI tag in bulk**
1919
1. In the **Monitor List**, select multiple monitors, then click **Edit tags**.
2020
1. Add the `bitsai:enabled` tag to the selected monitors.
2121

22-
You can also add the tag to your desired monitors using the Datadog API or Terraform.
22+
You can also add the tag to your desired monitors using the Datadog API or Terraform.
2323

2424
An investigation initiates when a monitor transitions to the alert state. Transitions to the warn or no data state, [renotifications][12], and test notifications do not trigger investigations. Additionally, noisy monitors are automatically rate-limited to avoid unnecessary investigations and protect your budget.
2525

2626
### Manually start an investigation
2727

28-
Alternatively, you can manually invoke Bits on an individual monitor event.
28+
Alternatively, you can manually invoke Bits on an individual monitor alert or warn event.
2929

3030
- **Option 1: Monitor Status Page**
3131
- On the monitor status page, select an alert event, then click **Investigate with Bits AI**.
3232
- **Option 2: Monitor Event Side Panel**
3333
- On the monitor event side panel, click **Investigate with Bits AI**.
3434
- **Option 3: Slack**
3535
- In Slack, reply to a monitor notification with `@Datadog Investigate this alert`.
36-
36+
3737
### Monitor requirements for Bits AI SRE
3838

3939
Bits is able to run investigations on monitors that fulfill all three of the following requirements:
4040
1. **Monitor Type**: The monitor must be a metric, logs, APM (`query_alert` type only), anomaly, forecast, integration, or outlier monitor.
4141

4242
2. **Service scope**: The monitor must have one of the following:
4343
- A monitor query filtered by a service
44-
- A monitor query grouped by a service
44+
- A monitor query grouped by a service
4545
- A service tag on the monitor
4646

4747
3. **Telemetry links**: For metric, anomaly, forecast, integration, and outlier monitors, the monitor message must include at least one helpful Datadog link:
@@ -50,7 +50,7 @@ Bits is able to run investigations on monitors that fulfill all three of the fol
5050
- A trace query
5151
- A Datadog notebook with helpful widgets
5252

53-
Think of the first page you'd navigate to in Datadog if this monitor were to fire. These links provide Bits with valuable context to kickstart its investigation. Links are not required for APM and log monitors.
53+
Think of the first page you'd navigate to in Datadog if this monitor were to fire. These links provide Bits with valuable context to kickstart its investigation. Links are not required for APM and log monitors.
5454

5555
{{< img src="bits_ai/optimization_example.png" alt="Example monitor with optimization steps applied" style="width:100%;" >}}
5656

@@ -110,14 +110,14 @@ Reviewing Bits' findings not only validates their accuracy, but also helps Bits
110110

111111
### During the investigation
112112
You can guide Bits' learning by:
113-
- **Improving a step**: Share a link to a better query Bits should have made.
114-
- **Remembering a step**: Tell Bits to remember any helpful queries it generated. This instructs Bits to prioritize running these queries the next time the same monitor fires.
113+
- **Improving a step**: Share a link to a better query Bits should have made.
114+
- **Remembering a step**: Tell Bits to remember any helpful queries it generated. This instructs Bits to prioritize running these queries the next time the same monitor fires.
115115
### After the investigation
116116
At the end of an investigation, let Bits know if the conclusion it made was correct or not. If it was inaccurate, provide Bits with the correct root cause so that it can learn from the discrepancy.
117117

118118
{{< img src="bits_ai/help_bits_ai_learn.png" alt="An investigation conclusion with buttons to rate the conclusion helpful or unhelpful highlighted" style="width:100%;" >}}
119119

120-
### Manage memories
120+
### Manage memories
121121
Every piece of feedback you give generates a **memory**. Bits uses these memories to enhance future investigations by recalling relevant patterns, queries, and corrections. You can navigate to [Bits-Enabled Monitors][3] to view and delete memories in the **Memories** column.
122122

123123
[2]: https://app.datadoghq.com/bits-ai/investigations

0 commit comments

Comments
 (0)