From 310d4534082c3b9745ed642537b562dc88ab3096 Mon Sep 17 00:00:00 2001 From: Pierre Le Noan Date: Wed, 23 Sep 2026 12:01:04 +0200 Subject: [PATCH 1/8] Split Bits Chat page into subpages and document chat sharing Break the long Bits Chat page into Access, Skills, Previous Chats, and Reports subpages, mirroring the Bits Investigation layout. Add a new Previous Chats page covering renaming, sharing, and deleting chats. Co-Authored-By: Claude Opus 5.5 (1M context) --- hugo/config/_default/menus/main.en.yaml | 20 ++ hugo/content/en/bits_ai/bits_chat.md | 186 ------------------ hugo/content/en/bits_ai/bits_chat/_index.md | 88 +++++++++ hugo/content/en/bits_ai/bits_chat/access.md | 54 +++++ .../en/bits_ai/bits_chat/previous_chats.md | 41 ++++ hugo/content/en/bits_ai/bits_chat/reports.md | 26 +++ hugo/content/en/bits_ai/bits_chat/skills.md | 73 +++++++ hugo/content/en/bits_ai/bits_code/setup.md | 2 +- .../bits_ai/bits_code/slack_code_channels.md | 4 +- hugo/content/en/experiments/diagnostics.md | 2 +- .../en/tracing/services/service_page.md | 2 +- .../en/tracing/trace_explorer/_index.md | 2 +- .../en/tracing/trace_explorer/trace_view.md | 2 +- 13 files changed, 309 insertions(+), 193 deletions(-) delete mode 100644 hugo/content/en/bits_ai/bits_chat.md create mode 100644 hugo/content/en/bits_ai/bits_chat/_index.md create mode 100644 hugo/content/en/bits_ai/bits_chat/access.md create mode 100644 hugo/content/en/bits_ai/bits_chat/previous_chats.md create mode 100644 hugo/content/en/bits_ai/bits_chat/reports.md create mode 100644 hugo/content/en/bits_ai/bits_chat/skills.md diff --git a/hugo/config/_default/menus/main.en.yaml b/hugo/config/_default/menus/main.en.yaml index 90b1303193c..2f199e446ef 100644 --- a/hugo/config/_default/menus/main.en.yaml +++ b/hugo/config/_default/menus/main.en.yaml @@ -1615,6 +1615,26 @@ menu: identifier: bits_ai_bits_chat parent: bits_ai weight: 6 + - name: Access Bits Chat + url: bits_ai/bits_chat/access + identifier: bits_ai_bits_chat_access + parent: bits_ai_bits_chat + weight: 601 + - name: Skills + url: bits_ai/bits_chat/skills + identifier: bits_ai_bits_chat_skills + parent: bits_ai_bits_chat + weight: 602 + - name: Previous Chats + url: bits_ai/bits_chat/previous_chats + identifier: bits_ai_bits_chat_previous_chats + parent: bits_ai_bits_chat + weight: 603 + - name: Reports + url: bits_ai/bits_chat/reports + identifier: bits_ai_bits_chat_reports + parent: bits_ai_bits_chat + weight: 604 - name: Bits Agent Builder url: actions/agents/ identifier: bits_ai_agent_builder 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 5d4de206d61..00000000000 --- a/hugo/content/en/bits_ai/bits_chat.md +++ /dev/null @@ -1,186 +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" -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..0559d2ecf9d --- /dev/null +++ b/hugo/content/en/bits_ai/bits_chat/_index.md @@ -0,0 +1,88 @@ +--- +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" +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. + +## Features + +{{< whatsnext desc="Learn about how you can use Bits Chat:" >}} + {{< nextlink href="bits_ai/bits_chat/access" >}}Access Bits Chat{{< /nextlink >}} + {{< nextlink href="bits_ai/bits_chat/skills" >}}Skills{{< /nextlink >}} + {{< nextlink href="bits_ai/bits_chat/previous_chats" >}}Previous chats{{< /nextlink >}} + {{< nextlink href="bits_ai/bits_chat/reports" >}}Reports{{< /nextlink >}} +{{< /whatsnext >}} + +## Further reading +{{< partial name="whats-next/whats-next.html" >}} diff --git a/hugo/content/en/bits_ai/bits_chat/access.md b/hugo/content/en/bits_ai/bits_chat/access.md new file mode 100644 index 00000000000..ea4f6340484 --- /dev/null +++ b/hugo/content/en/bits_ai/bits_chat/access.md @@ -0,0 +1,54 @@ +--- +title: Access 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" +--- + +## Web application +There are multiple ways to open Bits Chat in the Datadog web application: +- Go 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 {{< 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][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_chat/previous_chats.md b/hugo/content/en/bits_ai/bits_chat/previous_chats.md new file mode 100644 index 00000000000..c925001d16d --- /dev/null +++ b/hugo/content/en/bits_ai/bits_chat/previous_chats.md @@ -0,0 +1,41 @@ +--- +title: Previous Chats +description: "Rename, share, and delete your previous Bits Chat conversations." +further_reading: +- link: "/bits_ai/bits_chat/" + tag: "Documentation" + text: "Bits Chat" +--- + +## Overview + +Bits Chat saves your conversations so you can return to them later. In [Bits Chat][1], your previous chats are listed under {{< ui >}}Recent{{< /ui >}}. + +To manage a chat, hover over it under {{< ui >}}Recent{{< /ui >}}, click the {{< ui >}}...{{< /ui >}} (more actions) icon, and select one of the following: + +- {{< ui >}}Rename{{< /ui >}}: Change the title of the chat. +- {{< ui >}}Share{{< /ui >}}: Share the chat with others in your organization. See [Share a chat](#share-a-chat). +- {{< ui >}}Delete{{< /ui >}}: Permanently delete the chat. Deleting a chat cannot be undone. + +## Share a chat + +By default, chats are private: only you can view them. To share a chat with others in your organization: + +1. Under {{< ui >}}Recent{{< /ui >}}, hover over the chat, click the {{< ui >}}...{{< /ui >}} icon, and select {{< ui >}}Share{{< /ui >}}. +2. In the {{< ui >}}Share Chat{{< /ui >}} dialog, select {{< ui >}}Shared Chat{{< /ui >}}. +3. Click {{< ui >}}Copy Link{{< /ui >}} and send the link to your teammates. + +Anyone in your organization with the link can view all current and future messages in the chat. Shared chats are read-only for other users: they cannot send messages, approve pending actions, share, or delete the chat. + +
A shared chat includes the data Bits Chat retrieved using your permissions. Before you share a chat, make sure it does not contain data that others in your organization should not see.
+ +Shared links expire automatically. The expiration date appears in the {{< ui >}}Share Chat{{< /ui >}} dialog. + +### Stop sharing a chat + +To stop sharing a chat, open the {{< ui >}}Share Chat{{< /ui >}} dialog and select {{< ui >}}Private Chat{{< /ui >}}. Anyone who previously had access can no longer view the chat. + +## Further reading +{{< partial name="whats-next/whats-next.html" >}} + +[1]: https://app.datadoghq.com/ask diff --git a/hugo/content/en/bits_ai/bits_chat/reports.md b/hugo/content/en/bits_ai/bits_chat/reports.md new file mode 100644 index 00000000000..5c9b3544838 --- /dev/null +++ b/hugo/content/en/bits_ai/bits_chat/reports.md @@ -0,0 +1,26 @@ +--- +title: Bits Chat Reports +description: "Understand how your organization uses Bits Chat with usage reports." +further_reading: +- link: "/bits_ai/bits_chat/" + tag: "Documentation" + text: "Bits Chat" +- link: "/account_management/billing/ai_credits/" + tag: "Documentation" + text: "AI Credits" +--- + +## Overview + +The Bits Chat Reports page provides visibility into how your organization uses Bits Chat. Go to [**Bits AI** > **Chat** > **Reports**][1] 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]: https://app.datadoghq.com/ask/usage diff --git a/hugo/content/en/bits_ai/bits_chat/skills.md b/hugo/content/en/bits_ai/bits_chat/skills.md new file mode 100644 index 00000000000..d5768df67fb --- /dev/null +++ b/hugo/content/en/bits_ai/bits_chat/skills.md @@ -0,0 +1,73 @@ +--- +title: Bits Chat Skills +description: "Use Bits Chat skills to build dashboards and notebooks, analyze traces, investigate cloud costs, and write DDSQL queries." +further_reading: +- link: "/bits_ai/bits_chat/" + tag: "Documentation" + text: "Bits Chat" +- link: "/bits_ai/skills_library/" + tag: "Documentation" + text: "Skills Library" +- link: "/cloud_cost_management/cloud_cost_skill/" + tag: "Documentation" + text: "Cloud Cost Skill in Bits Chat" +--- + +## Overview +Bits Chat has a range of specialized skills for tasks across Datadog. The most commonly used skills are described below. + +## Dashboards +Build [dashboards][1] 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][2] 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][5]. + +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][6] queries against Datadog [telemetry data][7] 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` + +## Further reading +{{< partial name="whats-next/whats-next.html" >}} + +[1]: /dashboards/ +[2]: /notebooks/ +[3]: /tracing/trace_explorer/ +[4]: /cloud_cost_management/ +[5]: /cloud_cost_management/cloud_cost_skill/ +[6]: /ddsql_editor/ +[7]: /ddsql_reference/data_directory/ diff --git a/hugo/content/en/bits_ai/bits_code/setup.md b/hugo/content/en/bits_ai/bits_code/setup.md index 5133a9042bd..1a8dd5f381f 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/access/#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 8da315c7b80..ca5c733b982 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/access/#slack" tag: "Documentation" text: "Bits Chat in Slack" - link: "/integrations/slack/" @@ -68,7 +68,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/access/#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..a5ee6163af9 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/access/#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..03011e9b0e5 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 Latency investigations.
### Export diff --git a/hugo/content/en/tracing/trace_explorer/_index.md b/hugo/content/en/tracing/trace_explorer/_index.md index bda23e3c314..097f6a326fc 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 Latency investigations.
## 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..66ea8135c97 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 Trace analysis.
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. From 1317bf457c6afa9b454454e8f8d700aab4ad3b4e Mon Sep 17 00:00:00 2001 From: Pierre Le Noan Date: Wed, 23 Sep 2026 13:50:15 +0200 Subject: [PATCH 2/8] Rename Previous Chats page to Chat History and simplify wording Co-Authored-By: Claude Opus 5.5 (1M context) --- hugo/config/_default/menus/main.en.yaml | 6 +-- hugo/content/en/bits_ai/bits_chat/_index.md | 2 +- .../en/bits_ai/bits_chat/chat_history.md | 41 +++++++++++++++++++ .../en/bits_ai/bits_chat/previous_chats.md | 41 ------------------- 4 files changed, 45 insertions(+), 45 deletions(-) create mode 100644 hugo/content/en/bits_ai/bits_chat/chat_history.md delete mode 100644 hugo/content/en/bits_ai/bits_chat/previous_chats.md diff --git a/hugo/config/_default/menus/main.en.yaml b/hugo/config/_default/menus/main.en.yaml index 2f199e446ef..23cde377bca 100644 --- a/hugo/config/_default/menus/main.en.yaml +++ b/hugo/config/_default/menus/main.en.yaml @@ -1625,9 +1625,9 @@ menu: identifier: bits_ai_bits_chat_skills parent: bits_ai_bits_chat weight: 602 - - name: Previous Chats - url: bits_ai/bits_chat/previous_chats - identifier: bits_ai_bits_chat_previous_chats + - name: Chat History + url: bits_ai/bits_chat/chat_history + identifier: bits_ai_bits_chat_chat_history parent: bits_ai_bits_chat weight: 603 - name: Reports diff --git a/hugo/content/en/bits_ai/bits_chat/_index.md b/hugo/content/en/bits_ai/bits_chat/_index.md index 0559d2ecf9d..88dfcaef419 100644 --- a/hugo/content/en/bits_ai/bits_chat/_index.md +++ b/hugo/content/en/bits_ai/bits_chat/_index.md @@ -80,7 +80,7 @@ Bits Chat uses your Datadog role to fetch data, so it can only access the resour {{< whatsnext desc="Learn about how you can use Bits Chat:" >}} {{< nextlink href="bits_ai/bits_chat/access" >}}Access Bits Chat{{< /nextlink >}} {{< nextlink href="bits_ai/bits_chat/skills" >}}Skills{{< /nextlink >}} - {{< nextlink href="bits_ai/bits_chat/previous_chats" >}}Previous chats{{< /nextlink >}} + {{< nextlink href="bits_ai/bits_chat/chat_history" >}}Chat history{{< /nextlink >}} {{< nextlink href="bits_ai/bits_chat/reports" >}}Reports{{< /nextlink >}} {{< /whatsnext >}} diff --git a/hugo/content/en/bits_ai/bits_chat/chat_history.md b/hugo/content/en/bits_ai/bits_chat/chat_history.md new file mode 100644 index 00000000000..9205093c7dd --- /dev/null +++ b/hugo/content/en/bits_ai/bits_chat/chat_history.md @@ -0,0 +1,41 @@ +--- +title: Chat History +description: "Find, rename, share, and delete your Bits Chat conversations." +further_reading: +- link: "/bits_ai/bits_chat/" + tag: "Documentation" + text: "Bits Chat" +--- + +## Overview + +Bits Chat saves your conversations so you can come back to them later. To see your past chats, open the {{< ui >}}History{{< /ui >}} list in [Bits Chat][1], or click the {{< ui >}}History{{< /ui >}} icon (a clock with an arrow) in the Bits Chat panel. + +## Manage a chat + +Click {{< ui >}}...{{< /ui >}} next to a chat in {{< ui >}}History{{< /ui >}}, or in the header of an open chat, then select: + +- {{< ui >}}Rename{{< /ui >}}: Change the chat title. +- {{< ui >}}Share{{< /ui >}}: Share the chat with your organization. +- {{< ui >}}Delete{{< /ui >}}: Delete the chat. This cannot be undone. + +## Share a chat + +Chats are private by default. To share one: + +1. Click {{< ui >}}...{{< /ui >}} and select {{< ui >}}Share{{< /ui >}}. +2. Select {{< ui >}}Shared Chat{{< /ui >}}. +3. Click {{< ui >}}Copy Link{{< /ui >}} and send the link. + +Anyone in your organization with the link can view the chat, including future messages. + +
Shared chats show data that Bits Chat retrieved with your permissions. Check the chat before you share it.
+ +Shared links expire automatically. The expiration date appears in the {{< ui >}}Share Chat{{< /ui >}} dialog. + +To stop sharing, open the {{< ui >}}Share Chat{{< /ui >}} dialog and select {{< ui >}}Private Chat{{< /ui >}}. The link stops working for everyone else. + +## Further reading +{{< partial name="whats-next/whats-next.html" >}} + +[1]: https://app.datadoghq.com/ask diff --git a/hugo/content/en/bits_ai/bits_chat/previous_chats.md b/hugo/content/en/bits_ai/bits_chat/previous_chats.md deleted file mode 100644 index c925001d16d..00000000000 --- a/hugo/content/en/bits_ai/bits_chat/previous_chats.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: Previous Chats -description: "Rename, share, and delete your previous Bits Chat conversations." -further_reading: -- link: "/bits_ai/bits_chat/" - tag: "Documentation" - text: "Bits Chat" ---- - -## Overview - -Bits Chat saves your conversations so you can return to them later. In [Bits Chat][1], your previous chats are listed under {{< ui >}}Recent{{< /ui >}}. - -To manage a chat, hover over it under {{< ui >}}Recent{{< /ui >}}, click the {{< ui >}}...{{< /ui >}} (more actions) icon, and select one of the following: - -- {{< ui >}}Rename{{< /ui >}}: Change the title of the chat. -- {{< ui >}}Share{{< /ui >}}: Share the chat with others in your organization. See [Share a chat](#share-a-chat). -- {{< ui >}}Delete{{< /ui >}}: Permanently delete the chat. Deleting a chat cannot be undone. - -## Share a chat - -By default, chats are private: only you can view them. To share a chat with others in your organization: - -1. Under {{< ui >}}Recent{{< /ui >}}, hover over the chat, click the {{< ui >}}...{{< /ui >}} icon, and select {{< ui >}}Share{{< /ui >}}. -2. In the {{< ui >}}Share Chat{{< /ui >}} dialog, select {{< ui >}}Shared Chat{{< /ui >}}. -3. Click {{< ui >}}Copy Link{{< /ui >}} and send the link to your teammates. - -Anyone in your organization with the link can view all current and future messages in the chat. Shared chats are read-only for other users: they cannot send messages, approve pending actions, share, or delete the chat. - -
A shared chat includes the data Bits Chat retrieved using your permissions. Before you share a chat, make sure it does not contain data that others in your organization should not see.
- -Shared links expire automatically. The expiration date appears in the {{< ui >}}Share Chat{{< /ui >}} dialog. - -### Stop sharing a chat - -To stop sharing a chat, open the {{< ui >}}Share Chat{{< /ui >}} dialog and select {{< ui >}}Private Chat{{< /ui >}}. Anyone who previously had access can no longer view the chat. - -## Further reading -{{< partial name="whats-next/whats-next.html" >}} - -[1]: https://app.datadoghq.com/ask From 65025480a0c7e0f287178122fd4e49150dc332e7 Mon Sep 17 00:00:00 2001 From: Pierre Le Noan Date: Wed, 23 Sep 2026 14:21:08 +0200 Subject: [PATCH 3/8] Note that only the owner can send messages in a shared chat Co-Authored-By: Claude Opus 5.5 (1M context) --- hugo/content/en/bits_ai/bits_chat/chat_history.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/hugo/content/en/bits_ai/bits_chat/chat_history.md b/hugo/content/en/bits_ai/bits_chat/chat_history.md index 9205093c7dd..7ea7cb8d657 100644 --- a/hugo/content/en/bits_ai/bits_chat/chat_history.md +++ b/hugo/content/en/bits_ai/bits_chat/chat_history.md @@ -27,7 +27,7 @@ Chats are private by default. To share one: 2. Select {{< ui >}}Shared Chat{{< /ui >}}. 3. Click {{< ui >}}Copy Link{{< /ui >}} and send the link. -Anyone in your organization with the link can view the chat, including future messages. +Anyone in your organization with the link can view the chat, including future messages. Only you can send messages in it.
Shared chats show data that Bits Chat retrieved with your permissions. Check the chat before you share it.
From c5f8d9df2776227fdc3c2c5fc748c7879bbc696b Mon Sep 17 00:00:00 2001 From: Pierre Le Noan Date: Wed, 23 Sep 2026 14:56:04 +0200 Subject: [PATCH 4/8] Show History icon inline on Chat History page Co-Authored-By: Claude Opus 5.5 (1M context) --- hugo/content/en/bits_ai/bits_chat/chat_history.md | 2 +- hugo/static/images/bits_ai/icons/clock_historical.svg | 3 +++ 2 files changed, 4 insertions(+), 1 deletion(-) create mode 100644 hugo/static/images/bits_ai/icons/clock_historical.svg diff --git a/hugo/content/en/bits_ai/bits_chat/chat_history.md b/hugo/content/en/bits_ai/bits_chat/chat_history.md index 7ea7cb8d657..c456553aca3 100644 --- a/hugo/content/en/bits_ai/bits_chat/chat_history.md +++ b/hugo/content/en/bits_ai/bits_chat/chat_history.md @@ -9,7 +9,7 @@ further_reading: ## Overview -Bits Chat saves your conversations so you can come back to them later. To see your past chats, open the {{< ui >}}History{{< /ui >}} list in [Bits Chat][1], or click the {{< ui >}}History{{< /ui >}} icon (a clock with an arrow) in the Bits Chat panel. +Bits Chat saves your conversations so you can come back to them later. To see your past chats, open the {{< ui >}}History{{< /ui >}} list in [Bits Chat][1], or click {{< img src="bits_ai/icons/clock_historical.svg" inline="true" style="width:16px;" alt="History icon" >}} (the {{< ui >}}History{{< /ui >}} icon) in the Bits Chat panel. ## Manage a chat 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 @@ + + + From 6200d7ce2f232e9f3e443e63fb7da008960a7556 Mon Sep 17 00:00:00 2001 From: Pierre Le Noan Date: Wed, 23 Sep 2026 17:25:40 +0200 Subject: [PATCH 5/8] Move Bits Chat permissions to Access Bits Chat page Co-Authored-By: Claude Opus 5.5 (1M context) --- hugo/content/en/bits_ai/bits_chat/_index.md | 12 ------------ hugo/content/en/bits_ai/bits_chat/access.md | 12 ++++++++++++ 2 files changed, 12 insertions(+), 12 deletions(-) diff --git a/hugo/content/en/bits_ai/bits_chat/_index.md b/hugo/content/en/bits_ai/bits_chat/_index.md index 88dfcaef419..174c827a976 100644 --- a/hugo/content/en/bits_ai/bits_chat/_index.md +++ b/hugo/content/en/bits_ai/bits_chat/_index.md @@ -63,18 +63,6 @@ Ask Bits Chat questions across these categories: {{< 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. - ## Features {{< whatsnext desc="Learn about how you can use Bits Chat:" >}} diff --git a/hugo/content/en/bits_ai/bits_chat/access.md b/hugo/content/en/bits_ai/bits_chat/access.md index ea4f6340484..2f569a9ac3c 100644 --- a/hugo/content/en/bits_ai/bits_chat/access.md +++ b/hugo/content/en/bits_ai/bits_chat/access.md @@ -10,6 +10,18 @@ further_reading: text: "Code channels with Bits Code" --- +## 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. + ## Web application There are multiple ways to open Bits Chat in the Datadog web application: - Go to [Bits Chat][1]. From 40b4ab8e1765ef6362ece749ad486deac2620cb7 Mon Sep 17 00:00:00 2001 From: Esther Kim Date: Fri, 9 Oct 2026 21:00:06 -0400 Subject: [PATCH 6/8] Consolidate Bits Chat into Overview and Use Bits Chat pages Fold Chat History and Reports back into the overview as sections, drop the Skills subpage (duplicated by the upcoming Bits product unification and Skills Library), and rename Access Bits Chat to Use Bits Chat to reflect that permissions moved to the overview. Update the nav menu and inbound anchor links accordingly. --- hugo/config/_default/menus/main.en.yaml | 21 +----- hugo/content/en/bits_ai/bits_chat/_index.md | 75 +++++++++++-------- .../en/bits_ai/bits_chat/chat_history.md | 41 ---------- hugo/content/en/bits_ai/bits_chat/reports.md | 26 ------- hugo/content/en/bits_ai/bits_chat/skills.md | 73 ------------------ .../bits_ai/bits_chat/{access.md => usage.md} | 29 ++----- hugo/content/en/bits_ai/bits_code/setup.md | 2 +- .../bits_ai/bits_code/slack_code_channels.md | 4 +- hugo/content/en/experiments/diagnostics.md | 2 +- .../en/tracing/services/service_page.md | 2 +- .../en/tracing/trace_explorer/_index.md | 2 +- .../en/tracing/trace_explorer/trace_view.md | 2 +- 12 files changed, 61 insertions(+), 218 deletions(-) delete mode 100644 hugo/content/en/bits_ai/bits_chat/chat_history.md delete mode 100644 hugo/content/en/bits_ai/bits_chat/reports.md delete mode 100644 hugo/content/en/bits_ai/bits_chat/skills.md rename hugo/content/en/bits_ai/bits_chat/{access.md => usage.md} (56%) diff --git a/hugo/config/_default/menus/main.en.yaml b/hugo/config/_default/menus/main.en.yaml index 23cde377bca..3644f1ba6c0 100644 --- a/hugo/config/_default/menus/main.en.yaml +++ b/hugo/config/_default/menus/main.en.yaml @@ -1615,26 +1615,11 @@ menu: identifier: bits_ai_bits_chat parent: bits_ai weight: 6 - - name: Access Bits Chat - url: bits_ai/bits_chat/access - identifier: bits_ai_bits_chat_access + - name: Use Bits Chat + url: bits_ai/bits_chat/usage + identifier: bits_ai_bits_chat_usage parent: bits_ai_bits_chat weight: 601 - - name: Skills - url: bits_ai/bits_chat/skills - identifier: bits_ai_bits_chat_skills - parent: bits_ai_bits_chat - weight: 602 - - name: Chat History - url: bits_ai/bits_chat/chat_history - identifier: bits_ai_bits_chat_chat_history - parent: bits_ai_bits_chat - weight: 603 - - name: Reports - url: bits_ai/bits_chat/reports - identifier: bits_ai_bits_chat_reports - parent: bits_ai_bits_chat - weight: 604 - name: Bits Agent Builder url: actions/agents/ identifier: bits_ai_agent_builder diff --git a/hugo/content/en/bits_ai/bits_chat/_index.md b/hugo/content/en/bits_ai/bits_chat/_index.md index 174c827a976..37431c6cefd 100644 --- a/hugo/content/en/bits_ai/bits_chat/_index.md +++ b/hugo/content/en/bits_ai/bits_chat/_index.md @@ -31,46 +31,57 @@ aliases: --- ## 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: +{{< img src="bits_ai/getting_started/bits_assistant_full_page.png" alt="Full-page Bits Chat interface with suggested tasks" style="width:100%;">}} -### 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?` +Bits Chat helps you search and act across Datadog using natural language. Bits Chat is available across the web application, mobile app, and Slack. -### Explore and analyze telemetry -- `Which services have the most errors right now?` +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` -- `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` +- `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` -{{< 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, you can [update the role][1] 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. -## Features +## Chat History -{{< whatsnext desc="Learn about how you can use Bits Chat:" >}} - {{< nextlink href="bits_ai/bits_chat/access" >}}Access Bits Chat{{< /nextlink >}} - {{< nextlink href="bits_ai/bits_chat/skills" >}}Skills{{< /nextlink >}} - {{< nextlink href="bits_ai/bits_chat/chat_history" >}}Chat history{{< /nextlink >}} - {{< nextlink href="bits_ai/bits_chat/reports" >}}Reports{{< /nextlink >}} -{{< /whatsnext >}} +Bits Chat saves your conversations. To see past chats, open {{< ui >}}History{{< /ui >}} in [Bits Chat][2], 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**][3] 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]: /account_management/rbac/?tab=datadogapplication#update-a-role +[2]: https://app.datadoghq.com/ask +[3]: https://app.datadoghq.com/ask/usage diff --git a/hugo/content/en/bits_ai/bits_chat/chat_history.md b/hugo/content/en/bits_ai/bits_chat/chat_history.md deleted file mode 100644 index c456553aca3..00000000000 --- a/hugo/content/en/bits_ai/bits_chat/chat_history.md +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: Chat History -description: "Find, rename, share, and delete your Bits Chat conversations." -further_reading: -- link: "/bits_ai/bits_chat/" - tag: "Documentation" - text: "Bits Chat" ---- - -## Overview - -Bits Chat saves your conversations so you can come back to them later. To see your past chats, open the {{< ui >}}History{{< /ui >}} list in [Bits Chat][1], or click {{< img src="bits_ai/icons/clock_historical.svg" inline="true" style="width:16px;" alt="History icon" >}} (the {{< ui >}}History{{< /ui >}} icon) in the Bits Chat panel. - -## Manage a chat - -Click {{< ui >}}...{{< /ui >}} next to a chat in {{< ui >}}History{{< /ui >}}, or in the header of an open chat, then select: - -- {{< ui >}}Rename{{< /ui >}}: Change the chat title. -- {{< ui >}}Share{{< /ui >}}: Share the chat with your organization. -- {{< ui >}}Delete{{< /ui >}}: Delete the chat. This cannot be undone. - -## Share a chat - -Chats are private by default. To share one: - -1. Click {{< ui >}}...{{< /ui >}} and select {{< ui >}}Share{{< /ui >}}. -2. Select {{< ui >}}Shared Chat{{< /ui >}}. -3. Click {{< ui >}}Copy Link{{< /ui >}} and send the link. - -Anyone in your organization with the link can view the chat, including future messages. Only you can send messages in it. - -
Shared chats show data that Bits Chat retrieved with your permissions. Check the chat before you share it.
- -Shared links expire automatically. The expiration date appears in the {{< ui >}}Share Chat{{< /ui >}} dialog. - -To stop sharing, open the {{< ui >}}Share Chat{{< /ui >}} dialog and select {{< ui >}}Private Chat{{< /ui >}}. The link stops working for everyone else. - -## Further reading -{{< partial name="whats-next/whats-next.html" >}} - -[1]: https://app.datadoghq.com/ask diff --git a/hugo/content/en/bits_ai/bits_chat/reports.md b/hugo/content/en/bits_ai/bits_chat/reports.md deleted file mode 100644 index 5c9b3544838..00000000000 --- a/hugo/content/en/bits_ai/bits_chat/reports.md +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: Bits Chat Reports -description: "Understand how your organization uses Bits Chat with usage reports." -further_reading: -- link: "/bits_ai/bits_chat/" - tag: "Documentation" - text: "Bits Chat" -- link: "/account_management/billing/ai_credits/" - tag: "Documentation" - text: "AI Credits" ---- - -## Overview - -The Bits Chat Reports page provides visibility into how your organization uses Bits Chat. Go to [**Bits AI** > **Chat** > **Reports**][1] 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]: https://app.datadoghq.com/ask/usage diff --git a/hugo/content/en/bits_ai/bits_chat/skills.md b/hugo/content/en/bits_ai/bits_chat/skills.md deleted file mode 100644 index d5768df67fb..00000000000 --- a/hugo/content/en/bits_ai/bits_chat/skills.md +++ /dev/null @@ -1,73 +0,0 @@ ---- -title: Bits Chat Skills -description: "Use Bits Chat skills to build dashboards and notebooks, analyze traces, investigate cloud costs, and write DDSQL queries." -further_reading: -- link: "/bits_ai/bits_chat/" - tag: "Documentation" - text: "Bits Chat" -- link: "/bits_ai/skills_library/" - tag: "Documentation" - text: "Skills Library" -- link: "/cloud_cost_management/cloud_cost_skill/" - tag: "Documentation" - text: "Cloud Cost Skill in Bits Chat" ---- - -## Overview -Bits Chat has a range of specialized skills for tasks across Datadog. The most commonly used skills are described below. - -## Dashboards -Build [dashboards][1] 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][2] 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][5]. - -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][6] queries against Datadog [telemetry data][7] 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` - -## Further reading -{{< partial name="whats-next/whats-next.html" >}} - -[1]: /dashboards/ -[2]: /notebooks/ -[3]: /tracing/trace_explorer/ -[4]: /cloud_cost_management/ -[5]: /cloud_cost_management/cloud_cost_skill/ -[6]: /ddsql_editor/ -[7]: /ddsql_reference/data_directory/ diff --git a/hugo/content/en/bits_ai/bits_chat/access.md b/hugo/content/en/bits_ai/bits_chat/usage.md similarity index 56% rename from hugo/content/en/bits_ai/bits_chat/access.md rename to hugo/content/en/bits_ai/bits_chat/usage.md index 2f569a9ac3c..ff9bc523154 100644 --- a/hugo/content/en/bits_ai/bits_chat/access.md +++ b/hugo/content/en/bits_ai/bits_chat/usage.md @@ -1,5 +1,5 @@ --- -title: Access Bits Chat +title: Use Bits Chat description: "Open Bits Chat from the Datadog web application, mobile app, or Slack." further_reading: - link: "/bits_ai/bits_chat/" @@ -10,35 +10,22 @@ further_reading: text: "Code channels with Bits Code" --- -## 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. +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 to [Bits Chat][1]. +- 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 {{< ui >}}Ask Bits{{< /ui >}} or {{< img src="bits_ai/dev_agent/twinkling_stars_icon.png" inline="true" style="width:24px">}} (the twinkling stars icon). +- 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 >}}. - -{{< img src="bits_ai/getting_started/bits_assistant_side_panel.png" alt="Bits Chat panel open alongside the Dashboards list" style="width:40%;">}} +- 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. Bits has context on Datadog public documentation, telemetry, and ownership. +Ask Bits questions about your system or active incident from the [Mobile App][2]. -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. +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 diff --git a/hugo/content/en/bits_ai/bits_code/setup.md b/hugo/content/en/bits_ai/bits_code/setup.md index 1a8dd5f381f..d098eca4a3a 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/access/#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 ca5c733b982..43b778dd682 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/access/#slack" +- link: "/bits_ai/bits_chat/usage/#slack" tag: "Documentation" text: "Bits Chat in Slack" - link: "/integrations/slack/" @@ -68,7 +68,7 @@ The overall [Bits Code limitations][5] also apply to code channels. {{< partial name="whats-next/whats-next.html" >}} -[1]: /bits_ai/bits_chat/access/#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 a5ee6163af9..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/access/#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 03011e9b0e5..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 097f6a326fc..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 66ea8135c97..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. From 0e3d946314396ccc8b707a4e75c9c4a4d1a51053 Mon Sep 17 00:00:00 2001 From: Esther Kim Date: Fri, 9 Oct 2026 21:38:25 -0400 Subject: [PATCH 7/8] Update hugo/content/en/bits_ai/bits_chat/_index.md --- hugo/content/en/bits_ai/bits_chat/_index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/hugo/content/en/bits_ai/bits_chat/_index.md b/hugo/content/en/bits_ai/bits_chat/_index.md index 37431c6cefd..729fbf35eaa 100644 --- a/hugo/content/en/bits_ai/bits_chat/_index.md +++ b/hugo/content/en/bits_ai/bits_chat/_index.md @@ -59,7 +59,7 @@ Bits Chat uses your Datadog role to fetch data, so it can only access the resour Bits Chat saves your conversations. To see past chats, open {{< ui >}}History{{< /ui >}} in [Bits Chat][2], 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 +### 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. From d7ad7f55678fbcd290212698fcac37c8364fbdde Mon Sep 17 00:00:00 2001 From: Esther Kim Date: Fri, 9 Oct 2026 21:51:17 -0400 Subject: [PATCH 8/8] Reference usage page in the overview --- hugo/content/en/bits_ai/bits_chat/_index.md | 19 +++++++++++-------- 1 file changed, 11 insertions(+), 8 deletions(-) diff --git a/hugo/content/en/bits_ai/bits_chat/_index.md b/hugo/content/en/bits_ai/bits_chat/_index.md index 729fbf35eaa..7b7f60736a2 100644 --- a/hugo/content/en/bits_ai/bits_chat/_index.md +++ b/hugo/content/en/bits_ai/bits_chat/_index.md @@ -32,9 +32,11 @@ aliases: ## Overview -{{< img src="bits_ai/getting_started/bits_assistant_full_page.png" alt="Full-page Bits Chat interface with suggested tasks" style="width:100%;">}} +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. -Bits Chat helps you search and act across Datadog using natural language. Bits Chat is available across the web application, mobile app, and Slack. +{{< 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?` @@ -49,7 +51,7 @@ Ask Bits Chat questions like: 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][1] to enable **Bits Chat Access**. +To manage this permission for custom roles, you can [update the role][2] to enable **Bits Chat Access**. ### Data access through Bits Chat @@ -57,7 +59,7 @@ Bits Chat uses your Datadog role to fetch data, so it can only access the resour ## Chat History -Bits Chat saves your conversations. To see past chats, open {{< ui >}}History{{< /ui >}} in [Bits Chat][2], or click {{< img src="bits_ai/icons/clock_historical.svg" inline="true" style="width:16px;" alt="History icon" >}} in the Bits Chat panel. +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 @@ -71,7 +73,7 @@ Shared links expire automatically (see the expiration date in the {{< ui >}}Shar ## Reports -The Bits Chat Reports page provides visibility into how your organization uses Bits Chat. Go to [**Bits AI** > **Chat** > **Reports**][3] to view: +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. @@ -82,6 +84,7 @@ Use these insights to understand adoption patterns, identify power users for bes ## Further reading {{< partial name="whats-next/whats-next.html" >}} -[1]: /account_management/rbac/?tab=datadogapplication#update-a-role -[2]: https://app.datadoghq.com/ask -[3]: https://app.datadoghq.com/ask/usage +[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