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

# Datadog

> Export Simplismart metrics to Datadog

Datadog is a monitoring and security platform for cloud applications. You can forward Simplismart metrics to Datadog using the OpenTelemetry Collector.

## Prerequisites

* A Datadog account with API access
* Datadog API key
* OpenTelemetry Collector installed
* [Simplismart API Key](/model-suite/settings/api-keys)

## OpenTelemetry Collector configuration

```yaml theme={null}
receivers:
  prometheus:
    config:
      scrape_configs:
        - job_name: "simpli-metrics"
          scrape_interval: 60s
          scheme: https
          metrics_path: /observability/metrics/federate/
          authorization:
            type: Bearer
            credentials: "${SIMPLISMART_API_KEY}"
          params:
            namespace: ["DEPLOYMENT_SLUG_HERE"]     # your deployment slug
            bundle: ["core"]
            source: ["deployment"]
          static_configs:
            - targets: ["api.app.simplismart.ai"]

processors:
  batch:

exporters:
  datadog:
    api:
      key: "${DATADOG_API_KEY}"

service:
  pipelines:
    metrics:
      receivers: [prometheus]
      processors: [batch]
      exporters: [datadog]
```

## Configuration parameters

### namespace

The namespace parameter accepts a comma-separated list of deployment slugs. You can specify up to 10 deployment slugs. To increase this limit, reach out to support at [support@simplismart.tech](mailto:support@simplismart.tech).

**Example:** `["slug-1", "slug-2", "slug-3"]`

### scrape\_interval

The recommended scrape interval is 60 seconds.
It is advised not to reduce the interval below 30 seconds, as shorter intervals may not provide meaningful additional visibility and can lead to unnecessary overhead.

## Test locally

To test this configuration locally, first save the above YAML as `otelcol.yaml`, then set your API keys as environment variables:

```bash theme={null}
export SIMPLISMART_API_KEY="your-simplismart-api-key"
export DATADOG_API_KEY="your-datadog-api-key"
```

Next, execute the following command to start the collector:

```bash theme={null}
docker run --rm \
  -e SIMPLISMART_API_KEY \
  -e DATADOG_API_KEY \
  -v "$PWD/otelcol.yaml:/etc/otelcol/config.yaml:ro" \
  otel/opentelemetry-collector-contrib:latest \
  --config=/etc/otelcol/config.yaml
```

This will start the OpenTelemetry Collector in a Docker container using your local configuration file.
