Installation des Hostagenten in der Oracle Container Engine (OKE) für Kubernetes
Es gibt verschiedene Möglichkeiten, den Instana-Agenten in einem Kubernetes-Cluster zu installieren. Wenn der Agent manuell direkt auf dem Host installiert wird, werden zwar Container und Prozesse auf diesem Host überwacht, es können aber keine Kubernetes-Daten erfasst werden.
Installation
Die empfohlene Methode zur Installation des Agenten ist das Diagramm Helm . Um eine manuelle Installation durchzuführen, befolgen Sie die Schritte für die reguläre Installation von „ Kubernetes “.
Bei der Erstellung eines „ Kubernetes “-Clusters auf der „ Oracle Container Engine for Kubernetes “ (OKE) besteht die Möglichkeit, „ Helm “ zu installieren Tiller (Helm) Enabled; weitere Informationen zur Verwendung von „ Helm “ auf OKE finden Sie in der OKE-Dokumentation unter „Erstellen eines „ Kubernetes “-Clusters “.
Gleichen Sie die Version von Helm, die auf dem Cluster installiert ist, mit der auf Ihrer Workstation installierten Version ab.
helm version
Wenn die auf dem neu erstellten Kubernetes-Cluster installierte Version von Helm älter als die Version auf Ihrer Workstation ist, aktualisieren Sie diese mit folgendem Befehl:
helm init --upgrade
Kopieren Sie die Tabelle „ Instana “ ( helm ) auf Ihren Rechner.
git clone https://github.com/instana/helm-charts
Legen Sie das geklonte Verzeichnis als Arbeitsverzeichnis fest.
cd helm-charts/stable/instana_agent
Klicken Sie in der Benutzeroberfläche von „ Instana “ in der Seitenleiste auf „Einstellungen “. Wählen Sie „Agent installieren “ und notieren Sie sich anschließend den eindeutigen Agentenschlüssel und den Agent-Endpunkt aus dem auf „ Docker “ basierenden Fenster. Bearbeiten Sie nun die values.yaml und fügen Sie die Werte ein.
image:
name: icr.io/instana/agent
tag: latest
pullPolicy: IfNotPresent
rbac:
create: true
instana:
zone: Oracle-OKE
leaderElectorPort: 42655
agent:
key: <your unique key here>
name: instana-agent
endpoint:
host: <regional endpoint here>
port: 443
## Annotations to be added to pods
podAnnotations: {}
Führen Sie die Installation schließlich mit dem Befehl „ helm “ durch:
helm install --name instana-agent --namespace instana-agent .
Den Status des Host-Agenten überprüfen
Nachdem Sie den Host-Agenten installiert haben, können Sie dessen Status in der Benutzeroberfläche von „ Instana “ oder auf dem Host überprüfen. Weitere Informationen finden Sie unter Status des Hostagenten überprüfen.
Den Netzwerkzugriff für überwachte Anwendungen konfigurieren
Die folgenden Arten von Anwendungen müssen den Agenten zuerst erreichen:
- Node.js
- Go
- Ruby
- Python
- .NET Core
Anwendungen, die unter diesen Laufzeiten geschrieben wurden, müssen wissen, auf welcher IP-Adresse der Host-Agent auf demselben „ Kubernetes “-Knoten lauscht. Da der Agent automatisch auf die IP-Adresse des Hosts lauscht, verwenden Sie den folgenden Codeausschnitt für die Downward- API, um die IP-Adresse des Host-Agents in einer Umgebungsvariablen an den Anwendungs-Pod zu übergeben:
spec:
containers:
env:
- name: INSTANA_AGENT_HOST
valueFrom:
fieldRef:
fieldPath: status.hostIP
Fehlerbehebung bei der Bereitstellung von Agenten
Wenn die Installation des Agenten zunächst nicht erfolgreich ist, können Sie Protokollnachrichten und Tipps zur Fehlerbehebung überprüfen. Sollte dieser Abschnitt zur Fehlerbehebung Ihre Fragen nicht beantworten, wenden Sie sich bitte mit Angaben zu Ihrem Problem an das Support-Team von IBM Instana, damit wir Ihnen helfen und unsere Dokumentation entsprechend aktualisieren können.
Informationen zur Fehlerbehebung, die für alle Hostagenten allgemein gelten, finden Sie unter Hostagenten verwalten/Fehlerbehebung.