diff --git a/hugo/config/_default/menus/main.en.yaml b/hugo/config/_default/menus/main.en.yaml index 24d41987211..ec09b4db45b 100644 --- a/hugo/config/_default/menus/main.en.yaml +++ b/hugo/config/_default/menus/main.en.yaml @@ -1549,6 +1549,11 @@ menu: identifier: bits_ai_bits_chat parent: bits_ai weight: 2 + - name: Use Bits Chat + url: bits_ai/bits_chat/usage + identifier: bits_ai_bits_chat_usage + parent: bits_ai_bits_chat + weight: 201 - name: Bits Code url: bits_ai/bits_code parent: bits_ai diff --git a/hugo/content/en/bits_ai/bits_chat.md b/hugo/content/en/bits_ai/bits_chat.md deleted file mode 100644 index ccb8ac55391..00000000000 --- a/hugo/content/en/bits_ai/bits_chat.md +++ /dev/null @@ -1,189 +0,0 @@ ---- -title: Bits Chat -description: "Use Bits Chat in Datadog to explore and act on your observability data using natural language." -further_reading: -- link: "bits_ai/" - tag: "Documentation" - text: "Bits AI Overview" -- link: "/incident_response/incident_management/investigate/incident_ai" - tag: "Documentation" - text: "Coordinate incidents with Incident AI" -- link: "/cloud_cost_management/cloud_cost_skill/" - tag: "Documentation" - text: "Cloud Cost Skill in Bits Chat" -- link: "/account_management/billing/ai_credits/" - tag: "Documentation" - text: "AI Credits" -- link: "https://www.datadoghq.com/blog/datadog-mcp-apps/" - tag: "Blog" - text: "Datadog MCP Apps: Interactive experiences in AI workflows" -- link: "https://www.datadoghq.com/blog/introducing-bits-chat/" - tag: "Blog" - text: "Search and act across Datadog to resolve issues faster with Bits Chat" -- link: "https://www.datadoghq.com/blog/cloud-cost-skill-bits-chat/" - tag: "Blog" - text: "Answer any cost question faster with the Cloud Cost skill in Bits Chat" -- link: "https://www.datadoghq.com/blog/bits-chat-slack-incident-response/" - tag: "Blog" - text: "From alert to resolution: Manage incidents with Bits Chat in Slack" -aliases: -- /bits_ai/getting_started/ -- /bits_ai/chat_with_bits_ai -- /bits_ai/bits_assistant/ -- /tracing/guide/latency_investigator/ ---- - -## Overview -Bits Chat helps you search and act across Datadog using natural language. Bits Chat is available across the web application, mobile app, and Slack. - -Ask Bits Chat questions across these categories: - -### Investigate issues and remediate -- `Summarize high severity incidents that have occurred in the last day` -- `What's causing 400 errors on the checkout endpoint in the last hour?` -- `Why is the error rate spiking on the web-store service?` -- `What is the root cause of this error? How did it propagate and what is the impact on users?` -- `What could cause 500 errors on this API endpoint?` - -### Explore and analyze telemetry -- `Which services have the most errors right now?` -- `Summarize the key findings from the Kubernetes overview dashboard` -- `What's the success rate for my top API endpoints over the past week?` -- `Show me error rates for the checkout service over the last 24 hours` -- `Are there any incidents related to Kafka lag?` - -### Learn Datadog concepts and how-to -- `How do I configure log collection for the Datadog Agent?` -- `What is the difference between a metric monitor and an anomaly monitor?` -- `What permission do I need to create a new connection?` -- `Can I set the timepicker on a notebook to read-only?` - -### Set up and optimize observability -- `Do we already have monitors for high latency on the payments service?` -- `Build me a dashboard to show latency, errors, and request rates for my service` -- `How can I put a team tag on this monitor?` -- `Add a timeseries widget for request count over time to this notebook` - -{{< img src="bits_ai/getting_started/bits_assistant_full_page.png" alt="Full-page Bits Chat interface with suggested tasks" style="width:100%;">}} - -### Permissions - -#### Access to Bits Chat - -To use Bits Chat, your role must have the **Bits Chat Access** permission. This permission is enabled by default for all three standard Datadog roles: Datadog Admin, Datadog Standard, and Datadog Read Only. - -To manage this permission for custom roles, go to **Organization Settings** > **Roles**, select a role, and toggle **Bits Chat Access** under **General Permissions**. - -#### Data access through Bits Chat - -Bits Chat uses your Datadog role to fetch data, so it can only access the resources you have permission to view or modify. For example, if your role restricts access to a specific set of logs indexes, Bits Chat can only query logs from those indexes. Similarly, if you do not have permission to edit a dashboard, Bits Chat cannot edit that dashboard on your behalf. - -### Skills -Bits Chat has a range of specialized skills for tasks across Datadog. The most commonly used skills are described below. - -#### Dashboards -Build [dashboards][5] and widgets from natural language descriptions. - -Example prompts: -- `Show me a dashboard of high-impact alerts from the past week and which services they affected` -- `Add a widget about CPU usage in the payments service` - -#### Notebooks -Create investigation [notebooks][6] and enhance existing ones with summaries and analysis. - -Example prompts: -- `Create an investigation for the recent spike of errors in the checkout service` -- `Add an executive summary for this cost spike report` - -#### APM - -##### Trace analysis -Investigate an individual [trace][3] to diagnose what failed, where, and why. - -Example prompts: -- `Why did this request fail?` -- `Summarize this trace and identify the root cause of the error` - -##### Latency investigations -Investigate latency on a service to identify bottleneck resources and what changed in its slow traces. - -Example prompts: -- `What caused the latency spike for this service?` -- `What's the latency bottleneck for this service?` - -#### Cloud Cost Management -Investigate [cloud cost][4] changes and identify the teams or resources responsible. See [Cloud Cost Skill in Bits Chat][9]. - -Example prompts: -- `Investigate why EC2 costs changed between January and February` -- `Which teams are responsible for the highest S3 storage costs this month?` - -#### DDSQL -Generate and run [DDSQL][7] queries against Datadog [telemetry data][8] using natural language. - -Example prompts: -- `Write a DDSQL query that shows the top 10 services by error count in the last hour` -- `Query average request latency for the payments service broken down by status code` -- `Show me a DDSQL query for the number of RUM sessions by country over the past day` - -### Reports - -The Bits Chat Reports page provides visibility into how your organization uses Bits Chat. Go to [**Bits AI** > **Chat** > **Reports**][10] to view: - -- **Top users**: See which team members use Bits Chat the most, ranked by conversation count. -- **Usage trends**: Track conversation volume over time to understand adoption and identify usage patterns. -- **Conversation intent distribution**: See how conversations break down by intent category, such as investigating issues, exploring telemetry, learning Datadog concepts, and configuring observability. - -Use these insights to understand adoption patterns, identify power users for best-practice sharing, and assess which use cases deliver the most value for your organization. - -### Web application -There are multiple ways to open Bits Chat in the Datadog web application: -- Go to [Bits Chat][11]. -- In the top-right of the navigation bar, click {{< ui >}}Ask Bits{{< /ui >}}. -- In a Datadog product integrated with Bits Chat, click {{< ui >}}Ask Bits{{< /ui >}} or {{< img src="bits_ai/dev_agent/twinkling_stars_icon.png" inline="true" style="width:24px">}} (the twinkling stars icon). -- Press Cmd/Ctrl + I. -- In the left-side navigation panel, click {{< ui >}}Bits AI{{< /ui >}}. - -{{< img src="bits_ai/getting_started/bits_assistant_side_panel.png" alt="Bits Chat panel open alongside the Dashboards list" style="width:40%;">}} - -### Mobile application - -Ask Bits questions about your system or active incident. Bits has context on Datadog public documentation, telemetry, and ownership. - -1. [Download the mobile app and log in][2]. -2. On the home screen, tap {{< ui >}}Bits Chat{{< /ui >}}. -3. Start chatting with Bits Chat by voice or text. -{{< img src="bits_ai/getting_started/bits_ai_mobile_app_2026.png" alt="View of the Mobile App Home dashboard with Bits AI" style="width:40%;" >}} - -### Slack -Ask Bits questions, declare incidents, trigger investigations, or make code changes. Bits Chat replies in the message thread so your team can keep the question, context, and answer in one place. - -1. Select your Slack workspace in [Bits Chat Settings][12]. -2. Click **Connect Slack account** to grant Datadog permission to recognize you across both products. -3. (Optional) Click **Grant permissions** to your workspace so that Bits chat can read relevant slack conversations. - -After setup is complete, you can send queries to `@Datadog` in natural language to channels in your workspace with the Datadog App. - -{{< img src="bits_ai/getting_started/example-slack-query.png" alt="Output of an example service-dependency query in Slack" style="width:60%;">}} - -#### Code channels with Bits Code - -Ask Bits Chat to make a code change, and it creates a dedicated [code channel][13] for the task. In the code channel, [Bits Code][14] works on the change alongside you and your team. - -## Further reading -{{< partial name="whats-next/whats-next.html" >}} - -[1]: /integrations/slack/?tab=applicationforslack -[2]: /mobile/#installing -[3]: /tracing/trace_explorer/ -[4]: /cloud_cost_management/ -[5]: /dashboards/ -[6]: /notebooks/ -[7]: /ddsql_editor/ -[8]: /ddsql_reference/data_directory/ -[9]: /cloud_cost_management/cloud_cost_skill/ -[10]: https://app.datadoghq.com/ask/usage -[11]: https://app.datadoghq.com/ask -[12]: https://app.datadoghq.com/ask/settings -[13]: /bits_ai/bits_code/slack_code_channels/ -[14]: /bits_ai/bits_code/ diff --git a/hugo/content/en/bits_ai/bits_chat/_index.md b/hugo/content/en/bits_ai/bits_chat/_index.md new file mode 100644 index 00000000000..18fe5a5681e --- /dev/null +++ b/hugo/content/en/bits_ai/bits_chat/_index.md @@ -0,0 +1,93 @@ +--- +title: Bits Chat +description: "Use Bits Chat in Datadog to explore and act on your observability data using natural language." +further_reading: +- link: "bits_ai/" + tag: "Documentation" + text: "Bits AI Overview" +- link: "/incident_response/incident_management/investigate/incident_ai" + tag: "Documentation" + text: "Coordinate incidents with Incident AI" +- link: "/cloud_cost_management/cloud_cost_skill/" + tag: "Documentation" + text: "Cloud Cost Skill in Bits Chat" +- link: "/account_management/billing/ai_credits/" + tag: "Documentation" + text: "AI Credits" +- link: "https://www.datadoghq.com/blog/datadog-mcp-apps/" + tag: "Blog" + text: "Datadog MCP Apps: Interactive experiences in AI workflows" +- link: "https://www.datadoghq.com/blog/introducing-bits-chat/" + tag: "Blog" + text: "Search and act across Datadog to resolve issues faster with Bits Chat" +- link: "https://www.datadoghq.com/blog/cloud-cost-skill-bits-chat/" + tag: "Blog" + text: "Answer any cost question faster with the Cloud Cost skill in Bits Chat" +- link: "https://www.datadoghq.com/blog/bits-chat-slack-incident-response/" + tag: "Blog" + text: "From alert to resolution: Manage incidents with Bits Chat in Slack" +aliases: +- /bits_ai/getting_started/ +- /bits_ai/chat_with_bits_ai +- /bits_ai/bits_assistant/ +- /tracing/guide/latency_investigator/ +--- + +## Overview + +Bits Chat helps you search and act across Datadog using natural language. Ask it to investigate an incident, explore your telemetry, build a dashboard, or query your data with DDSQL, and it answers in a conversational chat instead of sending you to build the query yourself. + +Bits Chat is available in the Datadog web application, the mobile app, and Slack. See [Use Bits Chat][1] to open it from each surface. + +{{< img src="bits_ai/getting_started/bits_assistant_full_page.png" alt="Full-page Bits Chat interface with suggested tasks" style="width:100%;">}} + +Ask Bits Chat questions like: +- `Why is the error rate spiking on the web-store service?` +- `Summarize the key findings from the Kubernetes overview dashboard` +- `Build me a dashboard to show latency, errors, and request rates for my service` +- `Write a DDSQL query that shows the top 10 services by error count in the last hour` +- `Investigate why EC2 costs changed between January and February` + +## Permissions + +### Access to Bits Chat + +To use Bits Chat, your role must have the **Bits Chat Access** permission. This permission is enabled by default for all three standard Datadog roles: Datadog Admin, Datadog Standard, and Datadog Read Only. + +To manage this permission for custom roles, you can [update the role][2] to enable **Bits Chat Access**. + +### Data access through Bits Chat + +Bits Chat uses your Datadog role to fetch data, so it can only access the resources you have permission to view or modify. For example, if your role restricts access to a specific set of logs indexes, Bits Chat can only query logs from those indexes. Similarly, if you do not have permission to edit a dashboard, Bits Chat cannot edit that dashboard on your behalf. + +## Chat History + +Bits Chat saves your conversations. To see past chats, open {{< ui >}}History{{< /ui >}} in [Bits Chat][3], or click {{< img src="bits_ai/icons/clock_historical.svg" inline="true" style="width:16px;" alt="History icon" >}} in the Bits Chat panel. + +### Manage and share chats + +Click {{< ui >}}...{{< /ui >}} next to a chat in {{< ui >}}History{{< /ui >}}, or in an open chat's header, to {{< ui >}}Rename{{< /ui >}}, {{< ui >}}Share{{< /ui >}}, or {{< ui >}}Delete{{< /ui >}} it. Deleting a chat cannot be undone. + +Chats are private by default. To share one, click {{< ui >}}...{{< /ui >}} > {{< ui >}}Share{{< /ui >}} > {{< ui >}}Shared Chat{{< /ui >}}, then click {{< ui >}}Copy Link{{< /ui >}}. Anyone with the link can view the chat, including new messages, but only you can reply. + +
Shared chats show data retrieved with your permissions. Check the chat before you share it.
+ +Shared links expire automatically (see the expiration date in the {{< ui >}}Share Chat{{< /ui >}} dialog). To stop sharing, open {{< ui >}}Share Chat{{< /ui >}} and select {{< ui >}}Private Chat{{< /ui >}}. + +## Reports + +The Bits Chat Reports page provides visibility into how your organization uses Bits Chat. Go to [**Bits AI** > **Chat** > **Reports**][4] to view: + +- **Top users**: See which team members use Bits Chat the most, ranked by conversation count. +- **Usage trends**: Track conversation volume over time to understand adoption and identify usage patterns. +- **Conversation intent distribution**: See how conversations break down by intent category, such as investigating issues, exploring telemetry, learning Datadog concepts, and configuring observability. + +Use these insights to understand adoption patterns, identify power users for best-practice sharing, and assess which use cases deliver the most value for your organization. + +## Further reading +{{< partial name="whats-next/whats-next.html" >}} + +[1]: /bits_ai/bits_chat/usage/ +[2]: /account_management/rbac/?tab=datadogapplication#update-a-role +[3]: https://app.datadoghq.com/ask +[4]: https://app.datadoghq.com/ask/usage diff --git a/hugo/content/en/bits_ai/bits_chat/usage.md b/hugo/content/en/bits_ai/bits_chat/usage.md new file mode 100644 index 00000000000..ff9bc523154 --- /dev/null +++ b/hugo/content/en/bits_ai/bits_chat/usage.md @@ -0,0 +1,53 @@ +--- +title: Use Bits Chat +description: "Open Bits Chat from the Datadog web application, mobile app, or Slack." +further_reading: +- link: "/bits_ai/bits_chat/" + tag: "Documentation" + text: "Bits Chat" +- link: "/bits_ai/bits_code/slack_code_channels/" + tag: "Documentation" + text: "Code channels with Bits Code" +--- + +Bits Chat has context on Datadog public documentation, telemetry, and ownership. Use Bits Chat to ask questions about your system or active incident. Bits Chat is available in the Datadog web application, the mobile app, and Slack. + +## Web application +There are multiple ways to open Bits Chat in the Datadog web application: +- Go directly to [Bits Chat][1]. +- In the top-right of the navigation bar, click {{< ui >}}Ask Bits{{< /ui >}}. +- In a Datadog product integrated with Bits Chat, click the AI trigger button (for example, {{< ui >}}Ask Bits{{< /ui >}}) or {{< img src="bits_ai/dev_agent/twinkling_stars_icon.png" inline="true" style="width:24px" alt="">}} (the twinkling stars icon). +- Press Cmd/Ctrl + I. +- In the left-side navigation panel, click {{< ui >}}Bits AI{{< /ui >}}, then select {{< ui >}}Bits Chat{{< /ui >}}. + +## Mobile application + +Ask Bits questions about your system or active incident from the [Mobile App][2]. + +1. On the home screen, tap {{< ui >}}Bits Chat{{< /ui >}}. +1. Start chatting with Bits Chat by voice or text. +{{< img src="bits_ai/getting_started/bits_ai_mobile_app_2026.png" alt="View of the Mobile App Home dashboard with Bits AI" style="width:40%;" >}} + +## Slack +Ask Bits questions, declare incidents, trigger investigations, or make code changes. Bits Chat replies in the message thread so your team can keep the question, context, and answer in one place. + +1. Select your Slack workspace in [Bits Chat Settings][3]. +2. Click **Connect Slack account** to grant Datadog permission to recognize you across both products. +3. (Optional) Click **Grant permissions** to your workspace so that Bits chat can read relevant slack conversations. + +After setup is complete, you can send queries to `@Datadog` in natural language to channels in your workspace with the Datadog App. + +{{< img src="bits_ai/getting_started/example-slack-query.png" alt="Output of an example service-dependency query in Slack" style="width:60%;">}} + +### Code channels with Bits Code + +Ask Bits Chat to make a code change, and it creates a dedicated [code channel][4] for the task. In the code channel, [Bits Code][5] works on the change alongside you and your team. + +## Further reading +{{< partial name="whats-next/whats-next.html" >}} + +[1]: https://app.datadoghq.com/ask +[2]: /mobile/#installing +[3]: https://app.datadoghq.com/ask/settings +[4]: /bits_ai/bits_code/slack_code_channels/ +[5]: /bits_ai/bits_code/ diff --git a/hugo/content/en/bits_ai/bits_code/setup.md b/hugo/content/en/bits_ai/bits_code/setup.md index 9827cbb985d..58c8e515175 100644 --- a/hugo/content/en/bits_ai/bits_code/setup.md +++ b/hugo/content/en/bits_ai/bits_code/setup.md @@ -216,7 +216,7 @@ In some cases, especially in repositories with many branches, GitHub does not ru [11]: /bits_ai/bits_code/#supported-source-code-providers [12]: /bits_ai/bits_code/#custom-agent-skills-and-instructions [13]: /bits_ai/bits_code/slack_code_channels/ -[14]: /bits_ai/bits_chat/#slack +[14]: /bits_ai/bits_chat/usage/#slack [15]: https://docs.slack.dev/reference/scopes/ [16]: https://app.datadoghq.com/code/settings/slack diff --git a/hugo/content/en/bits_ai/bits_code/slack_code_channels.md b/hugo/content/en/bits_ai/bits_code/slack_code_channels.md index fb1a4162652..6df7753e62a 100644 --- a/hugo/content/en/bits_ai/bits_code/slack_code_channels.md +++ b/hugo/content/en/bits_ai/bits_code/slack_code_channels.md @@ -5,7 +5,7 @@ further_reading: - link: "/bits_ai/bits_code/" tag: "Documentation" text: "Bits Code" -- link: "/bits_ai/bits_chat/#slack" +- link: "/bits_ai/bits_chat/usage/#slack" tag: "Documentation" text: "Bits Chat in Slack" - link: "/integrations/slack/" @@ -79,7 +79,7 @@ The overall [Bits Code limitations][5] also apply to code channels. {{< partial name="whats-next/whats-next.html" >}} -[1]: /bits_ai/bits_chat/#slack +[1]: /bits_ai/bits_chat/usage/#slack [2]: /bits_ai/bits_code/#sessions [3]: https://app.datadoghq.com/code [4]: /bits_ai/bits_code/setup/ diff --git a/hugo/content/en/experiments/diagnostics.md b/hugo/content/en/experiments/diagnostics.md index d9fe014ead9..7c886ed5b28 100644 --- a/hugo/content/en/experiments/diagnostics.md +++ b/hugo/content/en/experiments/diagnostics.md @@ -212,6 +212,6 @@ The SQL you define depends on how the experiment is randomized. For experiments [4]: /experiments/concepts/subject_types/#product-analytics-and-rum-metrics [5]: /experiments/concepts/subject_types/#warehouse-metrics [6]: /source_code/ -[7]: /bits_ai/bits_chat/#web-application +[7]: /bits_ai/bits_chat/usage/#web-application [8]: /experiments/plan_and_launch_experiments/#run-a-sample-size-calculation-optional [9]: /help/ diff --git a/hugo/content/en/tracing/services/service_page.md b/hugo/content/en/tracing/services/service_page.md index a7106cf577f..5e4b5655b16 100644 --- a/hugo/content/en/tracing/services/service_page.md +++ b/hugo/content/en/tracing/services/service_page.md @@ -112,7 +112,7 @@ Datadog provides out-of-the-box graphs for any given service. Use the dropdown a {{% apm-ootb-graphs %}} -
When you hover over a latency spike in the latency graph, click Investigate With Bits AI to launch an automated investigation. Bits AI analyzes tag divergence and bottlenecks across the affected traces. For more information, see Latency investigations.
+
When you hover over a latency spike in the latency graph, click Investigate With Bits AI to launch an automated investigation. Bits AI analyzes tag divergence and bottlenecks across the affected traces. For more information, see Bits Chat.
### Export diff --git a/hugo/content/en/tracing/trace_explorer/_index.md b/hugo/content/en/tracing/trace_explorer/_index.md index bda23e3c314..2ee062e6c63 100644 --- a/hugo/content/en/tracing/trace_explorer/_index.md +++ b/hugo/content/en/tracing/trace_explorer/_index.md @@ -136,7 +136,7 @@ The Trace Explorer combines automated Watchdog outlier detection with TAG Analys {{< img src="tracing/trace_explorer/visualize/trace_explorer_outliers.mp4" alt="Analyzing anomalies with integrated insights" video="true" >}} -
When you sort the trace list by Duration, click Investigate With Bits AI to launch an automated latency investigation. Bits AI analyzes bottlenecks and tag divergence across the displayed traces. For more information, see Latency investigations.
+
When you sort the trace list by Duration, click Investigate With Bits AI to launch an automated latency investigation. Bits AI analyzes bottlenecks and tag divergence across the displayed traces. For more information, see Bits Chat.
## Indexed spans search with 15 day retention diff --git a/hugo/content/en/tracing/trace_explorer/trace_view.md b/hugo/content/en/tracing/trace_explorer/trace_view.md index 21e5bbffbad..0d766fc9412 100644 --- a/hugo/content/en/tracing/trace_explorer/trace_view.md +++ b/hugo/content/en/tracing/trace_explorer/trace_view.md @@ -170,7 +170,7 @@ Example: `service:web-ui` The height-adjustable bottom of the Trace View shows selected span and trace information. -
On traces that contain errors, click Investigate With Bits AI in the trace detail panel to launch an automated investigation. Bits AI walks the span tree to identify where the request failed and correlates findings with associated logs. For more information, see Trace analysis.
+
On traces that contain errors, click Investigate With Bits AI in the trace detail panel to launch an automated investigation. Bits AI walks the span tree to identify where the request failed and correlates findings with associated logs. For more information, see Bits Chat.
The span header contains service, operation, and resource names of the selected span as well as latency information. Pivot to other parts of the platform or narrow down your [Trace Explorer][5] search by clicking on the naming pill. diff --git a/hugo/static/images/bits_ai/icons/clock_historical.svg b/hugo/static/images/bits_ai/icons/clock_historical.svg new file mode 100644 index 00000000000..5fb033de87e --- /dev/null +++ b/hugo/static/images/bits_ai/icons/clock_historical.svg @@ -0,0 +1,3 @@ + + +