Verwaltung des „ Instana “-Agenten auf „ Kubernetes “

Nachdem Sie den Host-Agenten installiert haben, überprüfen Sie dessen Status in der Benutzeroberfläche von „ Instana “ oder auf dem Host. Weitere Informationen finden Sie unter Überprüfen des Status des Host-Agenten.

Sie können den Agenten unter Kubernetes entweder über die Agentenkonfigurationsdatei oder mithilfe von Umgebungsvariablen konfigurieren.

Nach der Installation des Host-Agenten werden die folgenden Konfigurationsdateien erstellt:

/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
 

Sie können die Konfiguration des Agenten an Ihre Bedürfnisse anpassen. Sie können beispielsweise den Port und den Hostnamen von TCP für das Backend Instana sowie die Dienste ändern, mit denen Ihr Host-Agent eine Verbindung herstellt, den Agenten so konfigurieren, dass er an mehrere Backends berichtet, oder die Verwendung eines Proxys für die indirekte Kommunikation vom Host-Agenten zum Backend Instana einrichten.

Weitere Informationen zum Anpassen der Agentenkonfiguration finden Sie in den folgenden Themen:

• Agentenprotokollierung
• Konfiguration des Backends „ Instana “
• Hostagentenmodus konfigurieren
• Konfigurieren von Host-Agenten mithilfe der Agentenkonfigurationsdatei
• Umwandlung eines statischen Agenten in einen dynamischen Agenten
• Hostagenten-CPU und -Speicher begrenzen
• Abrufen der aktuellen Version von dynamischen Agenten
• Einrichten eines Agenten-Proxys
• Einrichten der „ TLS “-Verschlüsselung für den Agent-Endpunkt
• Aktualisierungsintervall der dynamischen Bearbeiter
• Versionsanbindung dynamischer Bearbeiter

Je nach Installationsmethode können Sie den „ Instana “-Agenten für „ Kubernetes “ auf verschiedene Arten aktualisieren.

Über das Dashboard „Agentenverwaltung“ in der Benutzeroberfläche von „ Instana “ können Sie folgende Vorgänge ausführen:

• Ändern der Agentenmodi
• Ändern der Protokollstufe
• Aktualisierung der Agenten
• Agenten zurücksetzen
• Wiederbelebungsmittel
• Anzeige der Sensoren
• [Konfigurationsmanagement]
  • Das Konfigurationsmanagement initialisieren
  • Aktualisierung des Konfigurationsmanagements
• Selbstüberwachung

Führen Sie die folgenden Schritte aus, um das Dashboard zur Agentenverwaltung zu öffnen:

1. Wählen Sie in der Seitenleiste der Benutzeroberfläche von „ Instana “ die Option „Infrastruktur“ aus.
2. Klicken Sie auf einen bestimmten überwachten Host.
3. Klicken Sie auf dem Host-Dashboard auf Agent Management öffnen.

Sie müssen den Netzwerkzugriff für die folgenden Anwendungstypen konfigurieren, damit diese mit dem Agenten kommunizieren können:

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

Diese Anwendungen müssen die IP-Adresse kennen, auf der der Agent empfangsbereit ist. Der Host-Agent lauscht automatisch auf die Host-IP. Sie können den folgenden Downward- API -Schnipsel verwenden, um die Host-IP in einer Umgebungsvariablen an den Anwendungs-Pod zu übergeben:

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

Standardmäßig wird der Host-Agent nicht auf den Knoten der Steuer-Ebene von „ Kubernetes “ (früher als Master-Knoten bezeichnet) eingeplant, da die Bereitstellung die Standard-Taint-Einstellung berücksichtigt node-role.kubernetes.io/master:NoSchedule , die auf den meisten Knoten der Steuer-Ebene festgelegt ist. Um die Knoten der Steuerungsebene zu überwachen, überprüfen Sie zunächst, welcher Taint auf den Knoten der Steuerungsebene gesetzt ist, indem Sie den folgenden Befehl ausführen und in der Antwort .spec.taints nach suchen:

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

Fügen Sie anschließend die Toleranz für den Taint, der auf dem Knoten der Steuerungsebene gesetzt ist, zur Agenten- DaemonSet hinzu. Wenn der Knoten der Steuerungsebene die Standard-Taint-Markierung aufweist, lautet die entsprechende Toleranz für das Daemonset des Agenten wie folgt:

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

Nachdem Sie die erforderliche Toleranz festgelegt haben, nehmen Sie zur Überwachung der Knoten der Steuerungsebene die entsprechenden Einstellungen in der Agent-Installation vor.

Wenn Sie den Agenten mithilfe des Diagramms „ Helm “ installiert haben, können Sie die Toleranzen auf zwei Arten festlegen:

• Durch Verwendung des Flags --set agent.pod.tolerations

• Erstellen Sie eine values.yaml Datei mit dem folgenden Inhalt und übergeben Sie diese Datei anschließend mithilfe des Flags an den Installationsbefehl von -f values.yaml „ Helm “:

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"
 

Wenn Sie den Agenten mithilfe des Operators installiert haben, fügen Sie die Toleranzen in der benutzerdefinierten Ressource unter .spec.agent.pod.tolerations in der instana-agent.customresource.yaml Datei hinzu. Sehen Sie sich das folgende Beispiel an:

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

Wenden Sie anschließend die neue benutzerdefinierte Ressource auf den Cluster an, indem Sie den folgenden Befehl ausführen:

kubectl apply -f instana-agent.customresource.yaml
 

Um eine direktere Steuerung zu ermöglichen, installieren Sie den Host-Agenten separat auf den Knoten der Steuerungsebene.

Informationen zur Konfiguration von „ Kubernetes “ unter NGINX sowie des Ingress und des Host-Agenten zur Erfassung von Metriken unter NGINX finden Sie unter „Monitoring“ unter NGINX.

Um die verteilte Ablaufverfolgung für den „ Kubernetes “ und den „ NGINX “ Ingress zu aktivieren, lesen Sie den Abschnitt „Verteilte Ablaufverfolgung für den „ NGINX “ Ingress “.

Kubernetes verfügt über integrierte Unterstützung für die Speicherung und Verwaltung sensibler Informationen. Wenn Sie diese integrierte Funktion jedoch nicht nutzen, aber dennoch die Möglichkeit benötigen, sensible Daten in Ressourcen von „ Kubernetes “ zu schwärzen, können Sie die Agent-Geheimnisse konfigurieren.

Um die Schwärzung sensibler Daten für ausgewählte Ressourcen von „ Kubernetes “ (insbesondere Anmerkungen und Umgebungsvariablen von Containern) zu aktivieren, führen Sie die folgenden Schritte aus:

1. Setzen Sie die INSTANA_KUBERNETES_REDACT_SECRETS Umgebungsvariable wie im true folgenden Ausschnitt aus der Agent- YAML -Datei:

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

2. Konfigurieren Sie den Host-Agenten mit der gewünschten Liste von Geheimnissen, wie in der Konfiguration der Agent-Geheimnisse beschrieben.

Für den Host-Agenten, der über das Diagramm „Operator“ oder „ Helm “ installiert wurde, können Sie weitere Backends hinzufügen, indem Sie den folgenden Befehl ausführen:

• Für den Host-Agenten, der mit dem Helm installiert wird:

     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
   

• Für den Host-Agenten, der mit Operator installiert wird:

  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.
   

Weitere Informationen zur Berichterstellung an mehrere Backends über einen „ Kubernetes “-Agenten finden Sie unter „ Instana -Backend konfigurieren “.