New Relic

New Relic is a cloud-based observability platform that offers real-time monitoring and optimization of applications and infrastructure with advanced visualizations. This guide explains how to integrate ThousandEyes metrics with New Relic using OpenTelemetry.

For more information about sending metrics to New Relic using OpenTelemetry, see New Relic: Troubleshoot your applications faster with OpenTelemetry and New Relic.

Step 1: Generate API Key

To send data to New Relic, you need an ingestion token. Follow these steps to create a New Relic API key.

1. In the New Relic Cloud platform, go to API keys.

2. Click Create a key.

3. Select an Account.

4. Select Ingest - License as your Key type.

5. Enter a Name.

6. Click Create a key to create your API Key.

7. Copy the key ID to use it to send telemetry data to New Relic.

Step 2: Create an Integration

Create an Integration Using the ThousandEyes UI

1. Log in to your account on the ThousandEyes platform.

2. Navigate to Integrations > Integration 1.0 from the side menu.

3. Click New Integration and select OpenTelemetry Integration.

4. Enter a Name for the integration.

5. Set the Target to GRPC. New Relic supports both HTTP and GRPC.

6. Enter the Endpoint URL.

7. For Preset Configurations, select New Relic.

8. For Auth Type, select Custom.

9. Add the following Custom Header:

   • api-key: Enter your API Key ID from step 1.

10. For the OpenTelemetry Signal, select Metric.

11. For the Data Model Version, select v2.

12. Select a test. For more information on creating a test, see General Setup Instructions.

13. Click Save to complete the integration setup.

You have now successfully integrated your ThousandEyes data with New Relic.

Manage Integrations in the UI

For more information on managing OpenTelemetry integrations, including listing, editing, and deleting integrations, see Manage Integrations Using the UI - Integrations 1.0.

Create an Integration Using the ThousandEyes API

For a programmatic integration, use the following API command:

Using HTTP Protocol

curl -v -XPOST https://api.thousandeyes.com/v7/stream -H "Content-Type: application/json" -H \
"Authorization: Bearer $BEARER_TOKEN" -d '{
  "type": "opentelemetry",
  "testMatch": [{
    "id": "281474976717575",
    "domain": "cea"
  }],
  "endpointType": "http",
  "streamEndpointUrl": "https://otlp.eu01.nr-data.net:4318/v1/metrics",
  "customHeaders": {
    "api-key": "{NEW_RELIC_LICENSE_KEY}"
  }
}'

Using gRPC Protocol

curl -v -XPOST https://api.thousandeyes.com/v7/stream -H "Content-Type: application/json" -H \
"Authorization: Bearer $BEARER_TOKEN" -d '{
  "type": "opentelemetry",
  "testMatch": [{
    "id": "281474976717575",
    "domain": "cea"
  }],
  "endpointType": "grpc",
  "streamEndpointUrl": "https://otlp.eu01.nr-data.net:4317",
  "customHeaders": {
    "api-key": "{NEW_RELIC_LICENSE_KEY}"
  }
}'

Replace {NEW_RELIC_LICENSE_KEY} with the correct values for your instance.

ThousandEyes Dashboard in New Relic

ThousandEyes Dashboard in New Relic

You can download the dashboard template from the following link: Download ThousandEyes New Relic dashboard template.