Installazione di " IDOT " nei cluster " Kubernetes " tramite l'operatore

• Kubernetes 1.24 e più tardi
• Helm 3.9 e più tardi
• kubectl
• Autorizzazioni amministratore cluster per creare definizioni di risorse personalizzate (CRD)

Per installare l'Operator " IDOT " in un ambiente " Kubernetes ", procedere come segue:

1. Facoltativo ma consigliato: creare uno spazio dei nomi dedicato per l'operatore eseguendo il seguente comando:

   kubectl create namespace instana-otel-operator
    

2. Installare l'operatore " IDOT " in " Kubernetes " eseguendo il seguente comando:

     helm install instana-otel-operator \
     --repo https://instana.github.io/instana-otel-collector instana-otel-collector-chart-operator \
     --namespace instana-otel-operator \
     --create-namespace \
     --set clusterName=<CLUSTER_NAME> \
     --set instanaEndpoint=<INSTANA_ENDPOINT> \
     --set instanaKey=<INSTANA_KEY> \
     --set daemonset.enabled=true \
     --set statefulset.enabled=true

   Tabella 1. Parametri di installazione

   Parametro	Descrizione	Obbligatorio
   clusterName	Nome del cluster di Kubernetes da visualizzare nell'interfaccia utente di Instana	Sì
   instanaEndpoint	L'endpoint gRPC del tuo ambiente Instana	Sì
   instanaKey	Instana chiave dell'agente per l'autenticazione all'endpoint	Sì

   Come individuare i valori di configurazione:

   È possibile trovare questi parametri nell'interfaccia utente di Instana alla voce " Agent & collectors " > " OpenTelemetry " > "Collectors":

   • Fare clic su "Installa un collettore " > "Operatore Kubernetes ".
   • Nel comando di installazione:
     • INSTANA_KEY: Cerca la chiave dell'agente dopo il -a flag.
     • INSTANA_OTEL_ENDPOINT_GRPC: Cerca l'endpoint gRPC dopo il -e flag.
     • INSTANA_OTEL_ENDPOINT_HTTP: Cerca l'endpoint HTTP dopo il -H flag.
   Nota: il --create-namespace flag crea lo spazio dei nomi se questo non esiste. È possibile omettere questo flag se lo spazio dei nomi esiste già o è stato creato manualmente.

   Per ulteriori informazioni sui requisiti di sistema completi, consultare la pagina IDOT system requirements.

3. Verificare l'installazione dell'operatore: dopo l'installazione, verificare che l'operatore sia stato installato correttamente eseguendo il seguente comando:

   kubectl get pods -n instana-otel-operator
    

   Se l'installazione ha esito positivo, viene visualizzato il seguente output:

   NAME                                     READY   STATUS    RESTARTS   AGE
   instana-otel-operator-7d9f8b5c6d-xk2lm   2/2     Running   0          30s
    

   L'età della distribuzione e l'ID del pod variano a seconda di quando è stato eseguito il comando di installazione.

4. Verificare che le definizioni delle risorse personalizzate (CRD) siano installate eseguendo il seguente comando:

   kubectl get crd | grep opentelemetry
    

   Il CRD dell' OpenTelemetryCollector e deve essere elencato nell'output.

Per aggiornare la configurazione del collettore, modificare la risorsa personalizzata OpenTelemetryCollector :

kubectl edit opentelemetrycollector idot-daemonset -n instana-otel-operator
kubectl edit opentelemetrycollector idot-statefulset -n instana-otel-operator
 

L'operatore rileva automaticamente le modifiche e aggiorna i pod di raccolta di conseguenza.

Prima di installare l'operatore su un cluster Red Hat OpenShift 4.x, assicurati di disporre dei permessi di amministratore del cluster per creare CRD e gestire gli operatori.

Dopo aver effettuato l'accesso al cluster di Red Hat OpenShift, segui questi passaggi per installare l' IDOT Operator:

1. Facoltativo ma consigliato: creare un progetto dedicato all'operatore eseguendo il seguente comando:

   oc new-project instana-otel-operator
    

2. Installare l'operatore " IDOT " nel cluster " Red Hat OpenShift " eseguendo il seguente comando:

     helm install instana-otel-operator \
     --repo https://instana.github.io/instana-otel-collector instana-otel-collector-chart-operator \
     --namespace instana-otel-operator \
     --create-namespace \
     --set clusterName=<CLUSTER_NAME> \
     --set instanaEndpoint=<INSTANA_ENDPOINT> \
     --set instanaKey=<INSTANA_KEY> \
     --set daemonset.enabled=true \
     --set statefulset.enabled=true
    

3. Verifica l'installazione di Red Hat OpenShift : Controlla i pod dell'operatore eseguendo il seguente comando:

   oc get pods -n instana-otel-operator
    

   In alternativa, è possibile utilizzare il kubectl comando se il computer utilizzato per accedere al cluster ha il comando installato:

   kubectl get pods -n instana-otel-operator
    

Durante l'installazione o l'aggiornamento dell'operatore è possibile impostare i seguenti parametri:

I seguenti parametri possono essere configurati nella risorsa personalizzata OpenTelemetryCollector :

Esempio con limiti di risorse:

apiVersion: opentelemetry.io/v1alpha1
kind: OpenTelemetryCollector
metadata:
  name: instana-collector
  namespace: instana-otel-operator
spec:
  mode: daemonset
  resources:
    limits:
      cpu: 1.5
      memory: 768Mi
    requests:
      cpu: 0.5
      memory: 768Mi
  config: |
    # ... collector configuration ...
 

Se l'operatore non sta creando pod di raccolta, verificare quanto segue:

1. Verificare che l'operatore sia in funzione:

   kubectl get pods -n instana-otel-operator
   kubectl logs -n instana-otel-operator -l app.kubernetes.io/name=opentelemetry-operator
    

2. Controlla l' OpenTelemetryCollectors:

   kubectl get opentelemetrycollector -n instana-otel-operator
    

3. Verificare che i CRD siano installati:

   kubectl get crd opentelemetrycollectors.opentelemetry.io
    

Se i pod di raccolta non si avviano, controllare quanto segue:

1. Controlla gli eventi del pod eseguendo il seguente comando:

   kubectl describe pod -n instana-otel-operator -l app.kubernetes.io/managed-by=opentelemetry-operator
    

2. Verificare che la configurazione del collettore sia valida eseguendo il seguente comando:

   kubectl get opentelemetrycollector idot-daemonset -n instana-otel-operator -o yaml
   kubectl get opentelemetrycollector idot-statefulset -n instana-otel-operator -o yaml
    

3. Verificare la presenza di limitazioni delle risorse eseguendo il seguente comando:

   kubectl top nodes
   kubectl top pods -n instana-otel-operator
    

4. Esegui il comando seguente per esaminare i registri del collettore:

   kubectl logs -n instana-otel-operator -l app.kubernetes.io/managed-by=opentelemetry-operator
    

Per ulteriori indicazioni sulla risoluzione dei problemi, consultare la guida "Risoluzione dei problemi" all'indirizzo IDOT.