Skip to main content

​
Supported Data Types

📈 Metrics

​
Overview

The New Relic source supports three different senders. Each sender uses a different protocol and collector endpoint.
Note: The APM agent and Infrastructure agent are different products. Do not use the APM agent endpoint for the Infrastructure agent.
Infrastructure-agent support is enabled by default on Sawmills Collector v1.1097.0 or later. There is no source option to enable or disable this support. As with all Sawmills pipelines, metric data from this source flows through the configured processors to all pipeline destinations. The New Relic destination reconstructs Infrastructure samples in their native format before it sends them to New Relic.

​
Configuration

​
Default protocol paths

You can change Infrastructure paths and upstream service URLs in Advanced options. A custom upstream URL overrides automatic regional routing for that service.

​
Configure a sender

Open the collector details and find New Relic ingestion endpoints. Copy the endpoint for the sender type that you use. Do not copy the endpoint for a different sender type.

​
Infrastructure authentication

The Infrastructure agent sends its New Relic license key in the X-License-Key header. Sawmills does not put the raw key in OpenTelemetry attributes. The New Relic destination must use the same license key as the Infrastructure agent. This keeps identity, inventory, and metric data in the same New Relic account. The collector rejects Infrastructure export if the source key and destination key do not match.
Warning: Do not use a New Relic User API key. Use the same ingest license key in the Infrastructure agent and the New Relic destination.

​
Region routing

Sawmills selects the default New Relic service hosts from the license key region. The source key and destination key must belong to the same account and region. If you configure a custom upstream URL, configure all related services for the same region.

​
Supported Infrastructure versions

The minimum supported newrelic-infrastructure Helm chart version is 4.0.1. Sawmills validated this configuration: Later versions are supported when they keep the same protocol paths and native sample format. Test a later version in staging before you use it in production.

​
Metric API format

Supported Metric API types:
  • gauge
  • count, with interval.ms
  • summary

​
APM agent protocol

Supported methods:
  • preconnect
  • connect
  • metric_data
APM metrics are converted to Summary metrics. The conversion keeps count, sum, minimum, maximum, exclusive time, sum of squares, and transaction scope.