OpenTelemetry New Relic in Azure Container Apps exportieren

In diesem Konfigurationshandbuch wird gezeigt, wie Sie Azure Container Apps so konfigurieren, dass Protokolle, Ablaufverfolgungen und Metriken mithilfe des verwalteten OpenTelemetry-Agents an New Relic weitergeleitet werden.

Weitere Informationen zum verwalteten OpenTelemetry-Agent finden Sie unter Set up OpenTelemetry agents in Azure Container Apps.

In diesem Leitfaden werden Sie lernen, wie Sie Folgendes tun:

  • Erstellen eines New Relic Ingest-Schlüssels.
  • Konfigurieren Sie ein New Relic OTLP-Ziel mithilfe von Bicep oder dem Azure Portal.
  • Konfigurieren Sie erforderliche App-Umgebungsvariablen.
  • Wenden Sie Konfigurationsupdates auf Ihre vorhandene Container-Apps-Umgebung und -App an.
  • Überprüfen Sie telemetrie in New Relic.

Voraussetzungen

  • Ein Azure-Abonnement, in dem Sie vorhandene Azure Container Apps Ressourcen aktualisieren können.
  • Berechtigungen zum Ändern der Zielressourcengruppe und der verwalteten Umgebung.
  • Ein New Relic-Konto.
  • Azure CLI installiert und angemeldet.
  • Azure Container Apps CLI-Erweiterung installiert.
az extension add --name containerapp --upgrade

Einen New Relic Ingest-Schlüssel erstellen

Verwenden Sie die ANLEITUNG zur API-Schlüsselerstellung, um Ihren New Relic-API-Schlüssel zu erstellen: New Relic-API-Schlüssel. Wählen Sie beim Erstellen des Schlüssels den Typ Ingest – Lizenzschlüssel, da dieser Typ für die Datenerfassung verwendet wird.

Rufen Sie den Wert des Ingest-Lizenzschlüssels aus Ihrem Konto ab:

  • Wechseln Sie in New Relic zu API-Schlüsseln.
  • Suchen Sie den Schlüssel Ingest - License.
  • Kopieren Sie den Schlüsselwert für die Verwendung in der Zielkonfiguration.

Konfigurieren von OpenTelemetry-Zielen

Verwenden Sie eine der folgenden Optionen, um New Relic als OTel-Endpunkt in Ihrer Container-Apps-Umgebung zu konfigurieren.

Important

Das Konfigurieren eines verwalteten OpenTelemetry-Ziels erzeugt nicht automatisch Telemetrie. Ihre Anwendung muss bereits so instrumentiert sein, dass sie Traces, Metriken und Protokolle über ein OpenTelemetry SDK ausgibt.

Festlegen von CLI-Variablen für die Bereitstellung:

$RESOURCE_GROUP = "<resource-group-name>"
$NEW_RELIC_OTLP_ENDPOINT = "https://otlp.nr-data.net:4318"
$NEW_RELIC_INGEST_KEY = "<new-relic-ingest-license-key>"

Verwenden Sie den New Relic OTLP-Basisendpunkt (https://otlp.nr-data.net) mit dem entsprechenden OTLP-Port:

  • HTTP: 4318
  • gRPC: 4317

Verwenden Sie diesen Codeausschnitt im Ressourcenstil der verwalteten Umgebung, um das Zielrouting zu konfigurieren:

var newRelicDestinationName = 'newrelic'
var newRelicAuthHeaderValue = newRelicIngestKey

@secure()
param newRelicIngestKey string
param newRelicOtlpEndpoint string = 'https://otlp.nr-data.net:4318'
@allowed([
  'http'
  'grpc'
])
param newRelicOtlpProtocol string = 'http'

resource environment 'Microsoft.App/managedEnvironments@2026-03-02-preview' = {
  name: '<managed-environment-name>'
  location: '<region>'
  properties: {
    openTelemetryConfiguration: {
      destinationsConfiguration: {
        otlpConfigurations: [
          {
            name: newRelicDestinationName
            endpoint: newRelicOtlpEndpoint
            protocol: newRelicOtlpProtocol
            insecure: false
            headers: [
              {
                key: 'api-key'
                value: newRelicAuthHeaderValue
              }
            ]
          }
        ]
      }
      tracesConfiguration: {
        destinations: [
          newRelicDestinationName
        ]
      }
      logsConfiguration: {
        destinations: [
          newRelicDestinationName
        ]
      }
      metricsConfiguration: {
        destinations: [
          newRelicDestinationName
        ]
      }
    }
  }
}

Verwenden Sie diesen Codeausschnitt im App-Ressourcenstil, um erforderliche App-Umgebungsvariablen festzulegen:

resource app 'Microsoft.App/containerApps@2023-05-01' = {
  name: '<container-app-name>'
  location: '<region>'
  properties: {
    managedEnvironmentId: environment.id
    template: {
      containers: [
        {
          name: '<container-name>'
          image: '<image-name>'
          env: [
            {
              name: 'OTEL_SERVICE_NAME'
              value: '<service-name>'
            }
            {
              name: 'OTEL_TRACES_EXPORTER'
              value: 'otlp'
            }
            {
              name: 'OTEL_METRICS_EXPORTER'
              value: 'otlp'
            }
            {
              name: 'OTEL_LOGS_EXPORTER'
              value: 'otlp'
            }
          ]
        }
      ]
    }
  }
}

Wenden Sie Ihre Bicep-Konfiguration über das Stammverzeichnis des Repositorys an:

az deployment group create `
  --resource-group $RESOURCE_GROUP `
  --template-file infra/main.bicep `
  --parameters @infra/main.parameters.json `
  --parameters newRelicOtlpEndpoint="$NEW_RELIC_OTLP_ENDPOINT" `
  --parameters newRelicIngestKey="$NEW_RELIC_INGEST_KEY"

Ihre Container-App ist jetzt so konfiguriert, dass Telemetrie an New Relic gesendet wird.

Telemetrie in New Relic überprüfen

Überprüfen Sie nach der Konfiguration, ob Protokolle, Ablaufverfolgungen und Metriken von Ihrer Anwendung in New Relic ankommen und der erwarteten Dienstidentität zugeordnet sind.

Verwenden Sie die New Relic-Oberflächen, die Ihrem Workflow entsprechen, z. B. verteilte Ablaufverfolgung, Protokollsuche und Metrikensuche.

Weitere Informationen zur Erkundung und Analyse in New Relic finden Sie in der Dokumentation zu New Relic.

  • Last updated on