Envoi de données d' OpenTelemetry s à l'agent Instana

Par défaut, l'ingestion des données de l' OpenTelemetry e dans l'agent hôte Instana est activée.

Pour permettre la réception des données de l' OpenTelemetry e dans l'agent hôte, ajoutez l'extrait de code suivant au fichier ` configuration.yaml ` de l'agent hôte :

com.instana.plugin.opentelemetry:
  grpc:
    enabled: true
    # port: 4317 
  http:
    enabled: true
    # port: 4318

Une fois l'importation de données d' OpenTelemetry s activée, l'agent hôte active un collecteur pour l'exportateur OpenTelemetry's OTLP sur les ports par défaut 4317 pour les connexions gRPC et 4318 pour les connexions HTTP ou HTTPS, sauf si ces paramètres ont été modifiés par la configuration ou les variables d'environnement.

Pour configurer les différents ports utilisés pour les données d' OpenTelemetry s dans l'agent hôte, ajoutez l'extrait de code suivant au fichier ` configuration.yaml ` de l'agent hôte :

com.instana.plugin.opentelemetry:
  grpc:
    port: 4317
  http:
    port: 4318

Vous pouvez également configurer ces ports à l'aide des variables d'environnement INSTANA_AGENT_OTEL_GRPC_PORT et INSTANA_AGENT_OTEL_HTTP_PORT (la valeur par défaut est null).

Le service d'agent « Instana », disponible sur Kubernetes via le graphique « Instana » de l'agent Helm, s'avère utile lorsqu'il est utilisé avec la prise en charge de OpenTelemetry. Le service de l'agent « Instana » permet de garantir que les données sont transmises à l'agent « Instana », qui s'exécute sur le même nœud « Kubernetes ». Le service « Instana » est un service de type « Kubernetes » qui peut servir de nom de domaine au pod dans lequel l'agent « Instana » s'exécute.

1. Si vous installez l'agent Instana hôte à l'aide de Helm Graphique ou Opérateur, l'ingestion OpenTelemetry de données dans l'agent Instana hôte est activée par défaut.

   Par défaut, l'agent Instana est installé dans l'espace instana-agent de noms d'un cluster Kubernetes ou Red Hat OpenShift. Un service d' Kubernetes, nommé [nom du service instana-agent ], est utilisé pour accéder à l'agent Instana. Vous trouverez le port 4317 pour OTLP/gRPC et le port 4318 pour OTLP / HTTP.

   # kubectl get service -n instana-agent
   NAME                     TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)                                 AGE
   instana-agent            ClusterIP   172.30.53.248   <none>        42699/TCP,55680/TCP,4317/TCP,4318/TCP   23d
   instana-agent-headless   ClusterIP   None            <none>        42699/TCP,55680/TCP,4317/TCP,4318/TCP   23d

2. Pour accéder à un point de terminaison OTLP d'un agent Instana au sein d'un cluster Kubernetes ou Red Hat OpenShift, vous pouvez utiliser le service Kubernetes. Par exemple, vous pouvez envoyer des données d' OpenTelemetry s à http://instana-agent.instana-agent:4317 l'adresse OTLP/gRPC. Vous pouvez également envoyer des données d' OpenTelemetry s à instana-agent.instana-agent:4318 l'adresse OTLP / HTTP.

   Dans l'exemple de configuration suivant, le collecteur OpenTelemetry est utilisé pour se connecter à l'agent hôte local Instana à l'aide des protocoles OTLP/gRPC et OTLP / HTTP :

   exporters:
     otlp:
       endpoint: instana-agent.instana-agent:4317
       tls:
         insecure: true
     otlphttp:
       endpoint: http://instana-agent.instana-agent:4318

   Une autre façon d'accéder au point de terminaison de l'agent d' Instana ation consiste à utiliser directement l'adresse IP de l'hôte. Consultez l'exemple suivant pour savoir comment récupérer l'adresse IP de l'hôte dans un cluster Kubernetes ou Red Hat OpenShift et construire le nom de domaine complet du point de terminaison de OTLP/gRPC,, à savoir TRACER_EXPORTER_OTLP_ENDPOINT:

   env:
     - name: INSTANA_AGENT_HOST
       valueFrom:
         fieldRef:
           apiVersion: v1
           fieldPath: status.hostIP
     - name: TRACER_EXPORTER_OTLP_ENDPOINT
       value: http://$(INSTANA_AGENT_HOST):4317

Vous pouvez activer le chiffrement « TLS » sur l'agent hôte afin que toutes les données envoyées au point de terminaison d'ingestion OpenTelemetry soient chiffrées selon le protocole TLS.

Pour plus d'informations, consultez la section « Activation du chiffrement de la couche de transport ( TLS ) ».

Plusieurs traceurs travaillant pour la même application peuvent provoquer des conflits ou des données en double. Par exemple, l'agent « Instana » n'instrumentera pas automatiquement les machines virtuelles Java (JVMs) de type « Java » sur lesquelles plusieurs agents « Java » sont déjà en cours d'exécution.