Skip to navigation

Send data plane telemetry to New Relic

New Relic accepts OTLP/gRPC, so a data plane can send its traces, metrics, and logs straight to it, without a collector. This page shows how to point the data plane at New Relic, keep your license key in the app Secret, and confirm that telemetry arrives.

This applies to the Enterprise plan, where the data plane runs in your VPC. For how data plane telemetry export works in general, see Export telemetry with OpenTelemetry.

Prerequisites

Before you begin, make sure you have the following:

  • A data plane installed with the Helm chart. See Install the data plane.
  • A New Relic license key for the account that receives the data.
  • Egress from the gateway pods to otlp.nr-data.net on port 4317.
  • A way to add keys to the data plane’s app Secret. See Manage data plane secrets and keys.

Point the data plane at New Relic

  1. In your values file, turn off the chart’s collector sidecar and set the New Relic endpoint:

    otelCollector:
    enabled: false
    env:
    vars:
    OTEL_EXPORTER_OTLP_ENDPOINT: "https://otlp.nr-data.net:4317"

    If your account is in another New Relic region, use that region’s OTLP endpoint from New Relic’s documentation.

  2. Add your license key to the app Secret as OTEL_EXPORTER_OTLP_HEADERS. For example, with the app Secret fabric-dp-secrets from Install the data plane:

    kubectl -n pm-fabric-dp patch secret fabric-dp-secrets --type merge \
    -p '{"stringData":{"OTEL_EXPORTER_OTLP_HEADERS":"api-key=YOUR_LICENSE_KEY"}}'
  3. Apply the change:

    helm upgrade fabric-dp ./fabric-gateway-chart -n pm-fabric-dp -f my-values.yaml

    If the values file didn’t change, restart the gateway instead, so it reads the new Secret:

    kubectl -n pm-fabric-dp rollout restart deploy/fabric-gateway-chart

    With the distributed store, the gateway runs as a StatefulSet, so use statefulset/fabric-gateway-chart in place of deploy/fabric-gateway-chart.

Confirm that telemetry arrives

  1. Send several requests through a route on the data plane. The chart samples 10% of new traces. For the steps, see Authenticate and send a request.
  2. In New Relic, look for the entity fabric-gateway-dp, or the name you set in OTEL_SERVICE_NAME.

If nothing arrives, check the license key and egress to otlp.nr-data.net, and check the gateway logs as shown in Confirm that telemetry arrives.

Next steps