> ## 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.

# New Relic

> Export Simplismart metrics to New Relic

New Relic is an observability platform that helps you monitor, debug, and improve your entire stack. You can send Simplismart metrics to New Relic using the OpenTelemetry Collector.

## Prerequisites

* New Relic 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 slugs
            bundle: ["core"]        
            source: ["deployment"]
      static_configs:
        - targets: ["api.app.simplismart.ai"]

processors:
  batch:

exporters:
  otlphttp/newrelic:
    endpoint: "https://otlp.nr-data.net"
    headers:
      api-key: "${NEW_RELIC_API_KEY}"

service:
  pipelines:
    metrics:
      receivers: [prometheus]
      processors: [batch]
      exporters: [otlphttp/newrelic]
```

## 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 NEW_RELIC_API_KEY="your-new-relic-api-key"
```

Next, execute the following command to start the collector:

```bash theme={null}
docker run --rm \
  -e SIMPLISMART_API_KEY \
  -e NEW_RELIC_API_KEY \
  -v "$PWD/otelcol-newrelic.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.
