> ## Documentation Index
> Fetch the complete documentation index at: https://docs.twill.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Datadog

> Connect Datadog so Twill can investigate incidents, understand system health, and debug with more context

## Setup

<Tip>
  Make sure your GitHub App is connected and your connected repos are
  accessible. See the [Quickstart](/quickstart).
</Tip>

1. Go to **Settings → Integrations → Datadog**
2. Enter your Datadog **API key**
3. Enter your Datadog **application key**
4. Enter your Datadog **site** such as `datadoghq.com` or a full Datadog API host

This integration does **not** use OAuth.
It also does **not** currently create tasks from Datadog events. Agents use it
as read-only observability context during a task.

## How It Works

Twill stores your Datadog credentials encrypted at rest. When an agent sandbox is created for a workspace with Datadog connected, Twill injects the Datadog credentials into the sandbox and installs a read-only `datadog` skill.

That skill uses a Dogshell-compatible wrapper so agents can query Datadog using the `dog` CLI flow described in the [Datadog Dogshell docs](https://docs.datadoghq.com/extend/guide/dogshell/).

## What Agents Can Do

The first version of the Datadog integration is read-only. Agents can use it to inspect Datadog state such as:

* monitor details
* dashboard details
* host information
* search-oriented observability lookups

Twill blocks obvious mutating Dogshell subcommands in the bundled wrapper.

## Disconnect

To disconnect Datadog, go to **Settings → Integrations → Datadog** and remove the saved credentials.