Intégration OpenTelemetry

Aperçu

Qu'est-ce que l'intégration OpenTelemetry ?

Radianz fournit un Collecteur OpenTelemetry personnalisé qui reçoit les logs et traces de vos applications via le protocole OTLP standard, puis les transmet à la plateforme Radianz. Cela signifie que toute application instrumentée avec OpenTelemetry — quel que soit le langage — peut envoyer de la télémétrie à Radianz sans SDK spécifique.

Comment ça fonctionne

Votre App

Collecteur OTel

Radianz

Pourquoi un Collecteur ?L'approche basée sur le Collecteur vous permet de supporter .NET, Python, Java, Node.js, Go et tout autre langage qui parle OTLP — sans installer de bibliothèque spécifique à Radianz. Vous instrumentez votre application avec OpenTelemetry standard, pointez l'exportateur OTLP vers le Collecteur, et il s'occupe du reste.

Installation

Obtenez le Collecteur Radianz via Docker Hub

Étape 1 — Télécharger l'image Docker

Le Collecteur Radianz est distribué comme image Docker publique sur Docker Hub. Téléchargez-le avec une seule commande :

bash

docker pull radianz/otelcol-radianz:latest

Configuration

Configurez vos identifiants et lancez le Collecteur

Étape 2 — Créer un fichier de configuration

Créez un fichier nommé collector-config.yaml et remplacez YOUR_CLIENT_ID et YOUR_API_KEY par vos identifiants Radianz :

collector-config.yaml

receivers:
  otlp:
    protocols:
      grpc:
        endpoint: 0.0.0.0:4317
      http:
        endpoint: 0.0.0.0:4318

processors:
  batch:
    send_batch_size: 512
    timeout: 5s

exporters:
  radianz:
    endpoint: https://radianz.io/api/otel/ingest
    client_id: "YOUR_CLIENT_ID"
    api_key: "YOUR_API_KEY"
    timeout:
      timeout: 30s
    retry_on_failure:
      enabled: true
      initial_interval: 5s
      max_interval: 30s
      max_elapsed_time: 300s

service:
  pipelines:
    logs:
      receivers: [otlp]
      processors: [batch]
      exporters: [radianz]
    traces:
      receivers: [otlp]
      processors: [batch]
      exporters: [radianz]

Où trouver mes identifiants ?Allez dans Elmah > Log API Tokens dans le tableau de bord Radianz. Votre client_id est le Client ID de l'application et votre api_key est le jeton API.

Étape 3 — Lancer le Collecteur

Démarrez le Collecteur avec votre fichier de configuration monté :

bash

docker run -d -p 4317:4317 -p 4318:4318 \
  -v ./collector-config.yaml:/etc/otelcol/config.yaml \
  radianz/otelcol-radianz:latest

Instrumenter votre application

Ajoutez OpenTelemetry à votre application

Installez le SDK OpenTelemetry pour votre langage et configurez l'exportateur OTLP pour envoyer les données au Collecteur. Voici les packages nécessaires pour les langages les plus populaires :

.NET / C#

bash

dotnet add package OpenTelemetry.Exporter.OpenTelemetryProtocol
dotnet add package OpenTelemetry.Extensions.Hosting

Python

bash

pip install opentelemetry-api \
  opentelemetry-sdk \
  opentelemetry-exporter-otlp

Node.js

bash

npm install @opentelemetry/api \
  @opentelemetry/sdk-node \
  @opentelemetry/exporter-trace-otlp-grpc

Java

bash

# Download the Java agent JAR
java -javaagent:opentelemetry-javaagent.jar \
  -Dotel.exporter.otlp.endpoint=http://localhost:4317 \
  -jar your-app.jar

Point de terminaison OTLPConfigurez votre exportateur OTLP pour envoyer vers http://localhost:4317 (gRPC) ou http://localhost:4318 (HTTP). Si le Collecteur s'exécute sur un autre hôte, remplacez localhost par le nom d'hôte ou l'adresse IP appropriée.