Invio dei dati dell' OpenTelemetry e all'agente Instana

Per impostazione predefinita, l'acquisizione dei dati dell' OpenTelemetry e nell'agente host Instana è attivata.

Per abilitare la ricezione dei dati dell' OpenTelemetry e nell'agente host, aggiungere il seguente frammento di codice al file ` configuration.yaml ` dell'agente host:

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

Una volta attivata l'acquisizione dei dati dell' OpenTelemetry, l'agente host avvia un collettore per l'esportatore OpenTelemetry's OTLP sulle porte predefinite 4317 per le connessioni gRPC e 4318 per le connessioni HTTP o HTTPS, a meno che non siano state modificate dalla configurazione o dalle variabili d'ambiente.

Per configurare le diverse porte utilizzate per i dati dell' OpenTelemetry e nell'agente host, aggiungere il seguente frammento di codice al file ` configuration.yaml ` dell'agente host:

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

È inoltre possibile configurare queste porte utilizzando le variabili d'ambiente INSTANA_AGENT_OTEL_GRPC_PORT e INSTANA_AGENT_OTEL_HTTP_PORT (il valore predefinito è null).

Il servizio di agenti " Instana ", disponibile su Kubernetes tramite la scheda " Instana " dell' Helm, risulta utile quando viene utilizzato in combinazione con il supporto " OpenTelemetry ". Il servizio agente di Instana contribuisce a garantire che i dati vengano inoltrati all'agente di Instana, che viene eseguito sullo stesso nodo di Kubernetes. Il servizio " Instana " è un servizio " Kubernetes " che può essere utilizzato come nome di dominio del pod in cui è in esecuzione l'agente " Instana ".

1. Se si installa l'agente host di Instana utilizzando il grafico Helm o l'Operator, l'acquisizione dei dati di OpenTelemetry nell'agente host di Instana viene attivata per impostazione predefinita.

   Per impostazione predefinita, l'agente di Instana viene installato nel instana-agent namespace di un cluster Kubernetes o Red Hat OpenShift. Per accedere all'agente Instana viene utilizzato un servizio di Kubernetesinstana-agent denominato. Le porte 4317 per OTLP/gRPC e 4318 per OTLP / HTTP sono disponibili.

   # 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. Per accedere a un endpoint OTLP di un agente Instana in un cluster Kubernetes o Red Hat OpenShift, è possibile utilizzare il servizio Kubernetes. Ad esempio, è possibile inviare dati di http://instana-agent.instana-agent:4317 tipo ` OpenTelemetry ` all'endpoint ` OTLP/gRPC `. Oppure puoi inviare i dati di instana-agent.instana-agent:4318 un OpenTelemetry e all'endpoint OTLP / HTTP.

   Nell'esempio di configurazione riportato di seguito, il collettore OpenTelemetry viene utilizzato per connettersi all'agente host locale Instana utilizzando sia il protocollo OTLP/gRPC che il protocollo OTLP / HTTP :

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

   Un altro modo per accedere all'endpoint dell'agente di Instana è quello di utilizzare direttamente l'indirizzo IP dell'host. Si veda il seguente esempio su come ottenere l'indirizzo IP dell'host in un cluster Kubernetes o Red Hat OpenShift e ricostruire il nome di dominio completo dell'endpoint di OTLP/gRPC,, ovvero 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

È possibile abilitare la crittografia TLS sull'agente host in modo che tutti i dati inviati all'endpoint di acquisizione OpenTelemetry siano crittografati con TLS.

Per ulteriori informazioni, consultare la sezione "Abilitazione della crittografia di TLS ".

Più programmi di traccia che lavorano per la stessa app potrebbero causare conflitti o dati duplicati. Ad esempio, l'agente Instana non strumenta automaticamente le macchine virtuali Java (JVM) che hanno più agenti Java in esecuzione.