Amministrazione dell'agente dell' Instana su Kubernetes

Dopo aver installato l'agente host, controlla lo stato dell'agente host nell'interfaccia utente di Instana o direttamente sull'host. Per ulteriori informazioni, vedere Verifica dello stato dell'agente host.

È possibile configurare l'agente su Kubernetes utilizzando il file di configurazione dell'agente oppure le variabili d'ambiente.

Dopo l'installazione dell'agente host, vengono creati i seguenti file di configurazione:

/opt/instana/agent/etc/mvn-settings.xml
/opt/instana/agent/etc/org.ops4j.pax.url.mvn.cfg
/opt/instana/agent/etc/instana/com.instana.agent.bootstrap.AgentBootstrap.cfg
/opt/instana/agent/etc/instana/com.instana.agent.main.config.Agent.cfg
/opt/instana/agent/etc/instana/com.instana.agent.main.config.UpdateManager.cfg
/opt/instana/agent/etc/instana/com.instana.agent.main.sender.Backend.cfg
/opt/instana/agent/etc/instana/configuration.yaml
 

È possibile personalizzare la configurazione dell'agente secondo le proprie esigenze. Ad esempio, è possibile modificare la porta e il nome host di TCP del backend Instana e dei servizi a cui si connette l'agente host, configurare l'agente in modo che invii i rapporti a più backend oppure configurare l'uso di un proxy per la comunicazione indiretta dall'agente host al backend Instana.

Per ulteriori informazioni sulla personalizzazione della configurazione dell'agente, consultare i seguenti argomenti:

• Registrazione degli agenti
• Configurazione del backend di Instana
• Configurazione della modalità agente host
• Configurazione degli agenti host tramite il file di configurazione dell'agente
• Conversione di un agente statico in un agente dinamico
• Limitare la CPU e la memoria dell'agente host
• Recupero della versione corrente degli agenti dinamici
• Impostazione di un proxy agente
• Configurazione della crittografi TLS e per l'endpoint dell'agente
• Intervallo di aggiornamento degli agenti dinamici
• Pinning di versione degli agenti dinamici

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

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

• Cambio di modalità dell'agente
• Modifica del livello di log
• Aggiornamento degli agenti
• Azzeramento degli agenti
• Agenti di riavvio
• Sensori di visualizzazione
• [Gestione della configurazione]
  • Inizializzazione della gestione della configurazione
  • Aggiornamento della gestione della configurazione
• Auto-monitoraggio

Per aprire la dashboard di gestione degli 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 host 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 o (precedentemente noti come nodi master), poiché l'implementazione rispetta il taint predefinito node-role.kubernetes.io/master:NoSchedule impostato sulla maggior parte dei nodi del piano di controllo. Per monitorare i nodi del piano di controllo, verificare innanzitutto quale taint è impostato su di essi eseguendo il seguente comando e controllando la presenza di .spec.taints nella risposta:

kubectl describe node <control-plane-node-name>
 

A questo punto, aggiungere la tolleranza all'agente DaemonSet per il taint impostato sul nodo del piano di controllo. Se il nodo del piano di controllo presenta il taint predefinito, la tolleranza appropriata per il Daemonset dell'agente è la seguente:

tolerations:
  - key: "node-role.kubernetes.io/master"
    effect: "NoSchedule"
    operator: "Exists"
 

Dopo aver stabilito la tolleranza richiesta per il monitoraggio dei nodi del piano di controllo, imposta la tolleranza durante l'installazione dell'agente.

Se hai installato l'agente utilizzando il grafico " Helm ", puoi specificare le tolleranze in due modi:

• Utilizzando il flag --set agent.pod.tolerations

• Creando un values.yaml file con il seguente contenuto e passando poi il file al comando di installazione di Helm utilizzando il flag -f values.yaml:

agent:
  pod:
    # agent.pod.tolerations are tolerations to influence agent pod assignment.
    #   https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/
    tolerations:
      - key: "node-role.kubernetes.io/master"
        effect: "NoSchedule"
        operator: "Exists"
 

Se hai installato l'agente tramite l'operatore, aggiungi le tolleranze nella risorsa personalizzata all'interno .spec.agent.pod.tolerations del instana-agent.customresource.yaml file. Vedi il seguente esempio:

spec:
  agent:
   pod:
    tolerations:
      - key: "node-role.kubernetes.io/master"
        effect: "NoSchedule"
        operator: "Exists"
 

Quindi, applicare la nuova risorsa personalizzata al cluster eseguendo il seguente comando:

kubectl apply -f instana-agent.customresource.yaml
 

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

Per configurare l'Ingress di Kubernetes NGINX e l'agente host per l'acquisizione delle metriche di NGINX, consultare la sezione Monitoraggio su NGINX.

Per abilitare il tracciamento distribuito per l'Ingress Kubernetes NGINX, consultare Tracciamento distribuito per l'Ingress NGINX.

Kubernetes dispone di un supporto integrato per l'archiviazione e la gestione delle informazioni sensibili. Tuttavia, se non si utilizza questa funzionalità integrata ma si desidera comunque poter oscurare i dati sensibili nelle risorse di un Kubernetes, è possibile configurare i segreti dell'agente.

Per abilitare l'occultamento dei dati sensibili per le risorse selezionate di Kubernetes (in particolare le annotazioni e le variabili d'ambiente dei container), procedere come segue:

1. Imposta la variabile INSTANA_KUBERNETES_REDACT_SECRETS d'ambiente come true indicato nel seguente frammento di codice dell' YAML e dell'agente:

   spec:
     containers:
         env:
           - name: INSTANA_KUBERNETES_REDACT_SECRETS
             value: "true"
    

2. Configurare l'agente host con l'elenco dei segreti desiderato, come descritto nella configurazione dei segreti dell'agente.

Per l'agente host installato tramite l'Operator o il grafico " Helm ", è possibile aggiungere ulteriori backend eseguendo il seguente comando:

• Per l'agente host installato tramite il grafico 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
   

• Per l'agente host installato tramite 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 ulteriori informazioni sull'invio di report a più backend da un agente Kubernetes, consultare la sezione Configurazione di un backend Instana.