AddThisFeature

Datadog Event Forwarding

Ship the app's metrics, logs, and deploy events to Datadog with tags that stay consistent.

involved Developer Experience

What it adds

A single outbound telemetry path to Datadog, with an agreed tag set, batching, sampling, and redaction applied before send.

What your agent is told to do

5
  1. 1

    Decide first what is worth sending — the handful of metrics, log streams, and deployment markers someone would actually look at during an incident — and route all of them through one outbound path rather than scattering calls across the codebase.

  2. 2

    Fix a small, mandatory tag set applied to everything: service, environment, version, and where the app is multi-tenant, an opaque tenant identifier. Set them from the same configuration the deploy uses, so a dashboard filter works the same across metrics, logs, and traces.

  3. 3

    Treat every tag value as a cardinality decision. User identifiers, request identifiers, URLs with embedded values, and raw error messages must not become tag values; put them in the log body or trace attributes where they belong.

  4. 4

    Buffer and batch outbound telemetry through the app's existing background processing, with a bounded queue that drops oldest-first when it fills. Telemetry must never be sent inline on the request path or hold a user request open.

  5. 5

    Redact before the payload is constructed, not after: credentials, tokens, authorisation headers, payment details, and personal data must never reach the buffer. Keep the API credential in server-side configuration and never in a browser bundle.

Edge cases it handles

8
  • High-cardinality tags are the standard way this integration becomes expensive overnight, because each distinct value creates a new time series. Enforce an allowed tag key list and reject values that look unbounded.
  • Payloads also have size limits. Truncate long log bodies and stack traces at a defined length with a marker, rather than letting an oversized payload be rejected wholesale and the event lost.
  • Inconsistent service, environment, version, or tenant metadata makes correlation impossible — a metric tagged one way and a log tagged another cannot be joined. Derive all four from one place and assert their presence before send.
  • Secrets and personal data leak in through log lines and exception messages more often than through deliberate fields. Redact at the source and default to excluding unknown structured fields.
  • A noisy loop or a failing endpoint will flood the pipeline and the bill. Sample repetitive events at a defined rate and aggregate counters locally before shipping them rather than sending one call per occurrence.
  • When Datadog is unreachable, the app must degrade to local logging and continue serving users. Do not retry synchronously, do not grow the buffer without limit, and do not let a telemetry failure surface as a user-facing error.
  • Backoff must be applied on rate limiting and on server errors, with jitter, or every instance will retry in lockstep and prolong the outage.
  • Losing telemetry is acceptable; losing user requests is not. Make the dropped-event count itself an observable number so silent loss is visible.

Definition of done

8
  • All outbound telemetry leaves through a single path with a mandatory service, environment, version, and tenant tag set.
  • Tag keys are restricted to an allowed list and unbounded values are rejected before send.
  • No credential or personal data is present in forwarded metrics, logs, or events, verified against a captured payload.
  • Sending is batched off the request path and never delays or fails a user request.
  • Noisy events are sampled or aggregated, and oversized payloads are truncated rather than dropped whole.
  • A provider outage falls back to local logging with a bounded buffer, backoff with jitter, and a visible dropped-event count.
  • The feature matches the existing design system.
  • No existing functionality is broken.

Related features

How it works

  1. 1

    Copy the link

    Grab the Markdown instruction URL for this feature.

  2. 2

    Give it to your AI

    Paste it into Claude Code, Cursor, v0, Lovable — whatever you build with.

  3. 3

    It inspects, then implements

    Your agent reads your existing app first, then adds the feature to fit it.

Works with your stack

These instructions are written to adapt. They tell the agent to detect your framework, match your existing design system, and reuse what you already have — rather than assuming a particular stack.

Need it tighter than that? Customize the feature and tell it exactly what you're running.