Amministrazione dell'agente dell' Instana su Red Hat OpenShift

Dopo aver installato l'agente, è possibile verificare lo stato dei pod nella distribuzione dell'agente utilizzando i seguenti comandi:

kubectl get pods -n instana-agent
kubectl get agent instana-agent -n instana-agent -o yaml | yq ".status"
 

In una buona distribuzione, il 'STATUS di tutti i pod nello spazio dei nomi deve essere 'Running. La risorsa personalizzata 'instana-agent dovrebbe visualizzare anche 'status: Running, come mostrato nell'esempio seguente:

$ kubectl get pods -n instana-agent
NAME                                      READY   STATUS    RESTARTS   AGE
controller-manager-6478cb4c6f-8s29b       1/1     Running   0          70m
instana-agent-8ftnj                       1/1     Running   0          70m
instana-agent-9w4vc                       1/1     Running   0          70m
instana-agent-k8sensor-5bbf568976-5pjk2   1/1     Running   0          3h2m
instana-agent-k8sensor-5bbf568976-h96hr   1/1     Running   0          3h2m
instana-agent-k8sensor-5bbf568976-lnbsg   1/1     Running   0          3h2m
instana-agent-zpmrj                       1/1     Running   0          70m

$ kubectl get agent instana-agent -n instana-agent -o yaml | yq ".status"
conditions:
  - lastTransitionTime: "2024-08-06T08:12:03Z"
    message: most recent reconcile of agent CR completed without issue
    observedGeneration: 2

    ...

observedGeneration: 2
oldVersionsUpdated: true
operatorVersion: 0.0.1-dev
status: Running
 

È possibile configurare l'agente Instana per Kubernetes e Red Hat OpenShift in due modi diversi, a seconda del metodo utilizzato per installare l'agente.

A seconda dell'ambiente Red Hat OpenShift, potrebbe essere necessario personalizzare il Red Hat OpenShift Container Registry.

A seconda del metodo di installazione utilizzato, è possibile aggiornare l'agente Instana per Red Hat OpenShift in diversi modi.

È possibile eseguire le seguenti operazioni utilizzando la dashboard Gestione agenti nell'interfaccia utente di Instana :

• Modifica delle modalità dell'agente
• Modifica del livello di log
• Aggiornamento degli agenti
• Agenti di ripristino
• Agenti di riavvio
• Visualizzazione dei sensori
• [Gestione della configurazione]
  • Inizializzazione della gestione della configurazione
  • Aggiornamento della gestione della configurazione
• Auto-monitoraggio

Per aprire il dashboard Gestione agenti, procedere come segue:

1. Nella barra laterale dell'interfaccia utente di Instana, seleziona "Infrastruttura".
2. Fare clic su un host monitorato specifico.
3. Nella dashboard dell'host, fare clic su Apri gestione agenti.

È necessario configurare l'accesso alla rete dei seguenti tipi di applicazioni affinché possano comunicare con l'agente:

• Node.js
• Go
• Ruby
• Python
• .NET Core

Queste applicazioni devono conoscere l'indirizzo IP su cui l'agente è in ascolto. L'agente ascolta automaticamente l'IP dell'host. È possibile utilizzare il seguente snippet di ` API ` per passare l'IP dell'host, contenuto in una variabile d'ambiente, al pod dell'applicazione:

spec:
  containers:
    env:
      - name: INSTANA_AGENT_HOST
        valueFrom:
          fieldRef:
            fieldPath: status.hostIP
 

Per impostazione predefinita, l'agente host non viene pianificato sui nodi del piano di controll Kubernetes. Per informazioni su come monitorare i nodi del piano di controllo, consultare la sezione Monitoraggio dei nodi del piano di controllo.

Per un controllo più diretto, installa l'agente separatamente sui nodi del piano di controllo.

Per le linee guida su come configurare l'Ingress di Kubernetes NGINX e il nostro agente per l'acquisizione delle metriche di NGINX, consultare la pagina di monitoraggio NGINX. È possibile eseguire il tracciamento di Ingress su Kubernetes NGINX anche tramite il progetto OpenTracing; consultare la sezione "Tracciamento distribuito per Ingress su NGINX " per le istruzioni su come configurarlo.

Per aggiungere ulteriori backend utilizzando l' helm e e l'operatore, eseguire il comando seguente. È possibile utilizzare backend aggiuntivi per configurare l'agente Instana oppure lasciare il campo vuoto.

• Come utilizzare helm :

     helm install instana-agent \
     --repo https://agents.instana.io/helm \
     --namespace instana-agent \
     --create-namespace \
     --set agent.key=my-key \
     --set agent.endpointHost='<your_host_agent_endpoint>' \
     --set agent.endpointPort=443 \
     --set cluster.name='<your_cluster_name>' \
     --set zone.name='zone-name' \
     --set "agent.additionalBackends[0].endpointHost=<your_host_agent_endpoint>" \
     --set "agent.additionalBackends[0].key=<your_agent_key>" \
     --set "agent.additionalBackends[0].endpointPort=443" \
     --set "agent.additionalBackends[1].endpointHost=<your_other_host_agent_endpoint>" \
     --set "agent.additionalBackends[1].key=<your_other_agent_key>" \
     --set "agent.additionalBackends[1].endpointPort=443" \
     instana-agent
   

• Utilizzo dell'operatore:

  apiVersion: instana.io/v1
  kind: InstanaAgent
  metadata:
    name: instana-agent
    namespace: instana-agent
  spec:
    zone:
      name: edited-zone # (optional) name of the zone of the host
    cluster:
      name: my-cluster
    agent:
      endpointHost: <your_host_agent_endpoint>
      endpointPort: "443"
      env: {}
      key: <your_agent_key>
      additionalBackends:
      - endpointHost: <your_host_agent_endpoint>
        endpointPort: "443"
        key: <your_agent_key>
      configuration_yaml: |
        # You can leave this empty, or use this to configure your instana agent.
        # See https://github.com/instana/instana-agent-operator/blob/main/config/samples/instana_v1_extended_instanaagent.yaml for the extended version.
  
   

Per abilitare la segnalazione a più backend da un agente Kubernetes, consultare la configurazione dell'agente Docker.

È possibile utilizzare Secrets per archiviare e gestire dati sensibili come credenziali, token o chiavi. Per ulteriori dettagli, consulta la pagina Kubernetes secrets.