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

# Datadog Agent

> Forward logs collected by the Datadog Agent into Squasher during rollout or migration.

Use this path when the Datadog Agent already tails files, container streams, or Kubernetes workloads and you want Squasher to receive the same logs without changing application code.

## Setup

<Steps>
  <Step title="Create a Datadog Agent connector in Squasher">
    Create the connector for the target project and copy the destination URL plus connector key.
  </Step>

  <Step title="Add an HTTP forwarder">
    Configure the Datadog Agent or your existing Datadog pipeline to forward processed logs to the
    Squasher connector destination. Keep payloads in JSON and include the connector key header.
  </Step>

  <Step title="Preserve tags you care about">
    Keep `service`, `host`, `source`, `env`, and request identifiers when possible so searches and
    grouping stay familiar after cutover.
  </Step>
</Steps>

## Verify

* Send one error log from a known host or container.
* Confirm the issue appears in Squasher with the expected `service` and `environment` values.
* Confirm surrounding non-error logs appear as context, not separate incidents.

## Migrate

Mirror one Datadog pipeline into Squasher first. Once event shape and volume look right, move alerting and saved searches one service at a time.

## Hot-swap

* Start with production error logs, then widen to warning and info logs.
* Keep existing Datadog retention during overlap until on-call workflows are updated.
* Rotate the connector key after the final switch if it lived in a shared agent template.

## Agent handoff

```text theme={null}
Forward Datadog Agent logs into Squasher for project <project_id>. Onboard the connector, keep service/env/host tags intact, send one known error, verify grouping and nearby context, and ask before changing shared agent templates or rotating connector keys.
```