new-relic.md

New Relic

If you want to use New Relic as the trace data store, you'll configure the OpenTelemetry Collector to receive traces from your system and then send them to both Tracetest and New Relic. And, you don't have to change your existing pipelines to do so.

:::tip Examples of configuring Tracetest with New Relic can be found in the examples folder of the Tracetest GitHub repo. :::

Configuring OpenTelemetry Collector to Send Traces to B New Relic and Tracetest

In your OpenTelemetry Collector config file:

• Set the exporter to otlp/tt
• Set the endpoint to your Tracetest instance on port 4317

:::tip If you are running Tracetest with Docker and Tracetest's service name is tracetest, then the endpoint might look like this http://tracetest:4317 :::

Additionally, add another config:

• Set the exporter to otlp/nr.
• Set the endpoint pointing to your New Relic account and the New Relic ingest API.
• Set your New Relic access token as a header.

# collector.config.yaml

# If you already have receivers declared, you can just ignore
# this one and still use yours instead.
receivers:
  otlp:
    protocols:
      grpc:
      http:

processors:
  batch:
    timeout: 100ms

exporters:
  logging:
    logLevel: debug
  # OTLP for Tracetest
  otlp/tt:
    endpoint: tracetest:4317 # Send traces to Tracetest. Read more in docs here:  https://docs.tracetest.io/configuration/connecting-to-data-stores/opentelemetry-collector
    tls:
      insecure: true
  # OTLP for New Relic
  otlp/nr:
    endpoint: otlp.nr-data.net:443
    headers:
      api-key: <new_relic_ingest_licence_key> # Send traces to New Relic.
      # Read more in docs here: https://docs.newrelic.com/docs/more-integrations/open-source-telemetry-integrations/opentelemetry/opentelemetry-setup/#collector-export
      # And here: https://docs.newrelic.com/docs/more-integrations/open-source-telemetry-integrations/opentelemetry/collector/opentelemetry-collector-basic/

service:
  pipelines:
    # Your probably already have a traces pipeline, you don't have to change it.
    # Add these two to your configuration. Just make sure to not have two
    # pipelines with the same name
    traces/tt:
      receivers: [otlp] # your receiver
      processors: [batch]
      exporters: [otlp/tt] # your exporter pointing to your tracetest instance
    traces/nr:
      receivers: [otlp] # your receiver
      processors: [batch]
      exporters: [logging, otlp/nr] # your exporter pointing to your lighstep account

Configure Tracetest to Use New Relic as a Trace Data Store

Configure your Tracetest instance to expose an otlp endpoint to make it aware it will receive traces from the OpenTelemetry Collector. This will expose Tracetest's trace receiver on port 4317.

Connect Tracetest to New Relic with the Web UI

In the Web UI, (1) open Settings, and, on the (2) Configure Data Store tab, select (3) New Relic.

Connect Tracetest to New Relic with the CLI

Or, if you prefer using the CLI, you can use this file config.

type: DataStore
spec:
  name: Opentelemetry Collector pipeline
  type: otlp
  default: true

Proceed to run this command in the terminal and specify the file above.

tracetest apply datastore -f my/data-store/file/location.yaml

:::tip To learn more, read the recipe on running a sample app with New Relic and Tracetest. :::