OpenTelemetry Collector est un outil indépendant du fournisseur pour la réception, le traitement et l'exportation de données télémétriques. Il est recommandé d'exécuter le Collector dans votre pipeline d'observabilité. Bien que les Collector exigences et configuration varient, il est courant d'acheminer les données APM OpenTelemetry via un Collector. Cela déplace la charge administrative des applications et fournit un endroit pour enrichir la télémétrie avec des données de contexte d'environnement supplémentaires, filtrer et transformer, et bien plus encore. Il est également courant d'utiliser le Collector pour monitoring d'infrastructure, mais cette documentation se concentre sur les cas d'utilisation de traitement des données. Voir Collector pour monitoring d'infrastructure pour plus d'informations.
Voici un exemple du Collector en tant que passerelle, mais vous pouvez également configurer le Collector en tant qu'agent exécuté sur le même hôte que votre application :
Le Collector dispose d'un ensemble complet de Récepteur, Processeur, exportateur, extensions et connecteur. Ces composants sont regroupés dans des distributions prédéfinies. Cependant, il est possible de créer des composants personnalisés pour répondre à des exigences spécifiques et de créer une distribution Collector personnalisée pour package un ensemble spécifique de composants.
Bien que configuration varie en fonction des exigences, les collecteurs qui envoient des données à New Relic doivent avoir certains points communs :
Exportateur OTLP
Le OpenTelemetry Collector prend en charge l'exportation de données à l'aide de l'exportateur OTLP/HTTP . Assurez-vous que la configuration de l'exportateur correspond aux exigences de New Relic OTLP.
Remarque : bien que l'exportateur OTLP gRPC soit pris en charge, nous vous recommandons d'utiliser le protocole OTLP/HTTP pour l'envoi de données télémétriques au lieu d'OTLP/gRPC.
Processeur par lots
Configurez le Collector pour utiliser le processeur par lots pour exporter des enregistrements par lots. Assurez-vous que la taille et la fréquence du lot sont configurées pour correspondre aux exigences de New Relic OTLP.
Exemple minimal
Pour installer le Collector, suivez la documentation OpenTelemetry.
Exécutez le Collector avec la configuration ci-dessous, en vous assurant de remplacer les éléments suivants :
- Remplacez
<INSERT_NEW_RELIC_OTLP_ENDPOINT>par le point de terminaison OTLP New Relic approprié. - Remplacez
<INSERT_NEW_RELIC_LICENSE_KEY>par votre clé de licence.
receivers: otlp: protocols: grpc: http:
processors: batch:
exporters: otlphttp: endpoint: <INSERT_NEW_RELIC_OTLP_ENDPOINT> headers: api-key: <INSERT_NEW_RELIC_LICENSE_KEY>
service: pipelines: traces: receivers: [otlp] processors: [batch] exporters: [otlphttp] metrics: receivers: [otlp] processors: [batch] exporters: [otlphttp] logs: receivers: [otlp] processors: [batch] exporters: [otlphttp]Pour un exemple fonctionnel, consultez le référentiel d'exemples New Relic OpenTelemetry.
Pour des exemples supplémentaires Collector , voir Collector pour monitoring d'infrastructure.