How to Create Metric Streams

Metric Streams support the following monitoring platforms:

Datadog

Native integration with Datadog’s metrics API

New Relic

Stream via OpenTelemetry Protocol (OTLP)

Splunk

Stream via OpenTelemetry Protocol (OTLP)

Prerequisites

Before setting up a metric stream, you need:

Auth0 Management API access: Create a Machine-to-Machine (M2M) application with the following permissions:
- read:event_streams
- create:event_streams
- update:event_streams
- delete:event_streams
- read:event_deliveries
- update:event_deliveries
For detailed instructions, read Get Management API Access Tokens.
Auth0 CLI: Install the Auth0 CLI to configure metric streams via API commands.
Monitoring platform account: An active account with one of the supported platforms.

Set up Datadog

Stream Auth0 metrics directly to Datadog using their native metrics API.

Prerequisites

Active Datadog account
Datadog API key (generate at Organization Settings > API Keys in Datadog)
Your Datadog site (region identifier like US1 for app.datadoghq.com, EU for app.datadoghq.eu, US3 for us3.datadoghq.com)

Create metric stream

Dashboard
CLI

Navigate to Metric Streams:

Go to Auth0 Dashboard > Monitoring > Metric Streams.
Select + Create Metric Stream.
Select Datadog.

Configure stream:

Name: Enter a descriptive name (e.g., datadog-production).
Datadog Site: Select your Datadog region from the dropdown:
- US1 for app.datadoghq.com
- US3 for us3.datadoghq.com
- US5 for us5.datadoghq.com
- EU for app.datadoghq.eu
- AP1 for ap1.datadoghq.com
Datadog API Key: Paste your Datadog API key.
Select Save.

This creates and automatically enables your Metric Stream.

Use the Auth0 CLI to create a Datadog metric stream:

Using the Auth0 CLI? If you haven’t already, set up and authenticate your CLI session before running this command.

auth0 api post metric-streams \
  --data '{
    "name": "datadog-production",
    "subscriptions": [{ "metric_type": "auth0.api_request.count" }],
    "destination": {
      "type": "datadog",
      "configuration": {
        "api_key": "YOUR_DATADOG_API_KEY",
        "site": "app.datadoghq.com"
      }
    }
  }'

Response:

{
  "id": "mst_abc123xyz",
  "status": "enabled",
  "name": "datadog-production",
  "created_at": "2024-02-12T10:30:00Z",
  "updated_at": "2024-02-12T10:30:00Z",
  "destination": {
    "type": "datadog",
    "configuration": {
      "api_key": "***",
      "site": "app.datadoghq.com"
    }
  }
}

Save the id value to manage this stream later.

Verify in Datadog

Within a few minutes, Auth0 metrics appear in Datadog. Navigate to Metrics > Explorer and search for auth0.api_request.count to view your data.

Manage streams

Dashboard
CLI

View all streams:

Go to Auth0 Dashboard > Monitoring > Metric Streams.
All configured streams are listed with their Destination, Status, Name, and Subscriptions.

Edit a stream:

Select the stream name from the list.
Update the configuration.
Select Save.

Enable/Disable a stream:

Choose the Toggle switch in the Status column to enable or disable the stream.
Disabled streams stop sending metrics but retain their configuration.

Delete a stream:

Select the stream name from the list.
Select Delete at the bottom of the configuration page.
Confirm deletion.

List all streams:

auth0 api get /api/v2/metric-streams

Disable a stream:

auth0 api patch /api/v2/metric-streams/YOUR_STREAM_ID \
  --data '{"status":"disabled"}'

Re-enable a stream:

auth0 api patch /api/v2/metric-streams/YOUR_STREAM_ID \
  --data '{"status":"enabled"}'

Set up New Relic

Stream Auth0 metrics to New Relic using OpenTelemetry Protocol (OTLP).

Get New Relic credentials

Find your OTLP endpoint

Refer to New Relic’s OTLP documentation to find your region-specific endpoint:

US: https://otlp.nr-data.net
EU: https://otlp.eu01.nr-data.net

Save this endpoint URL.

Create ingest license key

Go to [your user menu] > API Keys.
Select Create a key.
Select Key Type = Ingest - License.
Enter a descriptive name and optional note.
Select Create a key.
Copy the API key immediately. You need it for later steps and it won’t be shown again.

Create metric stream

Dashboard
CLI

Navigate to Metric Streams:

Go to Auth0 Dashboard > Monitoring > Metric Streams.
Select + Create Metric Stream.
Select OpenTelemetry.

Configure stream:

Name: Enter a descriptive name (e.g., newrelic-production).
Protocol: Select HTTP from the dropdown.
OTLP Endpoint: Paste your New Relic OTLP endpoint (e.g., https://otlp.nr-data.net).
Authentication Method: Select API Key from the dropdown.
Header Name: Enter api-key.
API Key: Paste your New Relic Ingest License Key that you copied from previous steps.
Select Save.

This creates and automatically enables your Metric Stream.

auth0 api post metric-streams \
  --data '{
    "name": "newrelic-production",
    "subscriptions": [{ "metric_type": "metrics_bridge.api_request" }],
    "destination": {
      "type": "otlp",
      "configuration": {
        "endpoint": "YOUR_NEW_RELIC_ENDPOINT",
        "protocol": "http",
        "auth_type": "api_key",
        "api_key": "YOUR_INGEST_LICENSE_KEY",
        "auth_header_name": "api-key"
      }
    }
  }'

Set up Splunk

Stream Auth0 metrics to Splunk Observability Cloud using OpenTelemetry Protocol (OTLP).

Get Splunk credentials

Find your OTLP endpoint

Refer to Splunk’s OTLP HTTP Exporter documentation to find your endpoint.The endpoint format is:

https://ingest.<REALM>.signalfx.com/v2/datapoint/otlp

Replace <REALM> with your Splunk realm (e.g., us1, eu0, jp0).

Create access token

Navigate to Settings > Access Tokens > New Token.
Enter a descriptive name.
Set Authorization Scope to INGEST (required).
Set token expiration.
Select Create.
Copy and securely store the token value. You need this value for later steps.

Create metric stream

Dashboard
CLI

Navigate to Metric Streams:

Go to Auth0 Dashboard > Monitoring > Metric Streams.
Select + Create Metric Stream.
Select OpenTelemetry.

Configure stream:

Name: Enter a descriptive name (e.g., splunk-production).
Protocol: Select HTTP from the dropdown.
OTLP Endpoint: Paste your Splunk OTLP endpoint (e.g., https://ingest.us1.signalfx.com/v2/datapoint/otlp).
Authentication Method: Select API Key from the dropdown.
Header Name: Enter X-SF-TOKEN.
API Key: Paste your Splunk access token (from Step 2 above).
Select Save.

The metric stream is created and automatically enabled.

auth0 api post metric-streams \
  --data '{
    "name": "splunk-production",
    "subscriptions": [{ "metric_type": "metrics_bridge.api_request" }],
    "destination": {
      "type": "otlp",
      "configuration": {
        "endpoint": "YOUR_SPLUNK_ENDPOINT",
        "protocol": "http",
        "auth_type": "api_key",
        "api_key": "YOUR_SPLUNK_ACCESS_TOKEN",
        "auth_header_name": "X-SF-TOKEN"
      }
    }
  }'

Troubleshooting

Metrics not appearing

Check stream status:

Dashboard
CLI

Go to Auth0 Dashboard > Monitoring > Metric Streams.
Find your metric stream in the list.
Verify the Status column shows Enabled.
Select the stream name to view detailed configuration and verify settings.

auth0 api get /api/v2/metric-streams/YOUR_STREAM_ID

Verify the status field is enabled.

Verify destination credentials:

Datadog: Confirm your API key is valid and the site URL matches your Datadog region
OTLP destinations: Verify endpoint URL, authentication token, and header name are correct

Check for edge caching: Remember that cached requests and WAF-blocked requests are not included in metric streams.

High monitoring costs

If you’re seeing unexpectedly high costs:

Review which tags you’re using in queries and dashboards.
Consider removing client_id and connection_id from aggregations.
Use sampling or filtering in your monitoring platform to reduce ingested metrics.
Aggregate by higher-level tags like api and operation_result instead of granular tags.

Concepts

How To

Reference

How to Create Metric Streams

Datadog

New Relic

Splunk

Prerequisites

Set up Datadog

Prerequisites

Create metric stream

Verify in Datadog

Manage streams

Set up New Relic

Get New Relic credentials

Create metric stream

Set up Splunk

Get Splunk credentials

Create metric stream

Troubleshooting

Metrics not appearing

High monitoring costs

Datadog

New Relic

Splunk

​Prerequisites

​Set up Datadog

​Prerequisites

​Create metric stream

​Verify in Datadog

​Manage streams

​Set up New Relic

​Get New Relic credentials

​Create metric stream

​Set up Splunk

​Get Splunk credentials

​Create metric stream

​Troubleshooting

​Metrics not appearing

​High monitoring costs

Prerequisites

Set up Datadog

Prerequisites

Create metric stream

Verify in Datadog

Manage streams

Set up New Relic

Get New Relic credentials

Create metric stream

Set up Splunk

Get Splunk credentials

Create metric stream

Troubleshooting

Metrics not appearing

High monitoring costs