Collector for Prometheus

Check for these prerequisites

If you haven't already:

• Sign up for a New Relic account.
• In your target app, make sure you're exposing the Prometheus metrics endpoint so it is accessible to the Prometheus receiver component in the OpenTelemetry collector.
  • The Prometheus metrics endpoint could be enabled by default or you may need do do additional configuration to enable it.
  • Some software may require a third-party Prometheus exporter to expose metrics.
• Install the OpenTelemetry collector by following the steps in the OpenTelemetry docs.
• You can use any distribution so long as they have these two components: OTLP/HTTP exporter and Prometheus receiver

Configure Opentelemetry collector

Update or create a new file called config.yaml and replace the following keys in the file with your own values:

• Prometheus scrape config:
  • PROMETHEUS_JOBNAME
  • PROMETHEUS_HOSTNAME
  • PROMETHEUS_ENDPOINT_PORT
  • PROMETHEUS_ENDPOINT_PATH (optional, default is /metrics)
• New Relic License key:
  • NEW_RELIC_LICENSE_KEY

receivers:
  prometheus:
    config:
      scrape_configs:
        - job_name: "PROMETHEUS_JOBNAME"
          static_configs:
            - targets: [ "PROMETHEUS_HOSTNAME:PROMETHEUS_ENDPOINT_PORT" ]
              labels:
                label_example: VALUE_EXAMPLE
          metrics_path: PROMETHEUS_ENDPOINT_PATH

exporters:
  otlphttp:
    endpoint: https://otlp.nr-data.net
    headers:
      api-key: NEW_RELIC_LICENSE_KEY
processors:
service:
  telemetry:
    logs:
  pipelines:
    metrics:
      receivers: [prometheus]
      processors: [batch, memory_limiter]
      exporters: [otlphttp]

For further configuration options, please review:

• Opentelemetry Collector docs.
• Prometheus configuration docs for additional configuration details.
• Scrape config doc.

Run the collector

Run the Opentelemetry collector. The way to run it may vary depending on the chosen installation method. For example:

/usr/bin/otelcol --config ./config.yaml

Find and use your data

You may use the metrics explorer to check the metrics being ingested. All metrics reported by the OTEL Prometheus receiver are detected by running the following query.

SELECT count(*)
FROM Metric
WHERE instrumentation.provider='opentelemetry' and otel.library.name='otelcol/prometheusreceiver'
FACET metricName