Instana konfigurieren

Instana-Agenten

Installieren Sie Instana-Agenten zur Überwachung Ihrer Technologie-Stacks mit dem Befehl stanctl agent .

  • Weitere Informationen zu Instana-Agenten finden Sie unter Installieren von Instana-Agenten.
  • Weitere Informationen über den Befehl stanctl agent finden Sie unter stanctl agent --help.
Hinweis: Bei der Installation von Agenten werden standardmäßig zufällig generierte Agentenschlüssel verwendet. Verwenden Sie zur Konfiguration Ihres benutzerdefinierten Agentenschlüssels den Befehl stanctl agent apply --agent-key <key-value> .

Ermöglichung der Selbstüberwachung

Sie können die Selbstüberwachung Ihres selbst gehosteten Standard Edition -Hosts aktivieren, indem Sie den Host-Agenten installieren.

Wir empfehlen die Selbstüberwachung auf demselben Backend nur für Testinstallationen. Für eine zuverlässige Selbstüberwachung sollten Sie idealerweise ein zweites Backend verwenden. Es reicht aus, den Installationstyp demo auf dem zweiten Backend-Host zu verwenden. Auf dem zu überwachenden System müssen Sie dem Agenten den Agentenakzeptor-Endpunkt zuweisen, indem Sie das Kennzeichen --agent-endpoint-host verwenden.

Sie finden den Agent-Akzeptor-Endpunkt URL auf der Seite Instana UI > Agent installieren > <Platform> seite. Suchen Sie nach einem Endpunktwert, der mit agent-acceptor beginnt. Weitere Informationen finden Sie unter „Installieren des Host-Agenten“ auf Kubernetes.

Führen Sie über die Befehlszeilenschnittstelle Ihres Hosts den folgenden Befehl aus, um den Agenten zu installieren oder die Konfiguration des Agenten zu aktualisieren:

  • Wenn Sie das gleiche Backend für die Selbstüberwachung verwenden, führen Sie den folgenden Befehl aus:
    stanctl agent apply
     
  • Wenn Sie ein zweites Backend für die Selbstüberwachung verwenden, führen Sie den folgenden Befehl aus:
    stanctl agent apply --agent-endpoint-host <endpoint-of-the-second-backend> --agent-key <agent-key-of-the-second-backend> --agent-cluster-name <your-custom-local-cluster-name> --agent-zone-name <your-custom-local-cluster-zone-name>
     
Hinweis: Wenn das zweite Backend nicht den Standard-Agentenport 8600 verwendet, geben Sie einen benutzerdefinierten Endpunktport an, indem Sie das Flag --agent-endpoint-port <custom-endpoint-port-of-the-second-backend> mit dem vorherigen Befehl verwenden.
Hinweis: Wenn der Befehl stanctl die Aufforderung zur Eingabe eines Benutzernamens und eines Passworts anzeigt, verwenden Sie den Standardbenutzer _ als Benutzernamen und Ihren Download-Schlüssel als Passwort.

Deaktivieren der Selbstüberwachung

Um den Instana-Host-Agenten zu deinstallieren und die Selbstüberwachung zu beenden, führen Sie den folgenden Befehl aus:

stanctl agent delete
 

Instana Backend-Konfigurationen

Während oder nach der Installation des Instana-Backends können Sie die Konfigurationswerte von Instana Core jederzeit mit dem Befehl stanctl backend apply aktualisieren. Verwenden Sie stanctl backend apply --help , um die Konfigurationsoptionen zu sehen. Sie können auch eine Datei .env erstellen, wie in Umgebungsvariablen beschrieben.

Um instana mit Hilfe der Datei .env zu konfigurieren, führen Sie den folgenden Befehl aus:

stanctl backend apply --env-file <your_env_file>
 

Weitere Informationen zu den Kernspezifikationen finden Sie unter den CoreSpec Elementen in der API-Referenz.

Standard Edition mit einer einzigen Domäne konfigurieren

Hinweis: Sie können die Konfiguration nur Standard Edition 1.9.0 und später mit einer einzelnen Domäne.

Zur Installation und Konfiguration von Standard Edition mit einer einzelnen Domäne zu installieren und zu konfigurieren, führen Sie den folgenden Befehl aus:

stanctl backend apply --core-use-tu-url-path \
   --core-acceptors-agent-port=<desired-acceptor-port> \
   --core-acceptors-agent-host=<basedomain> \
   --core-acceptors-otlp-http-port=<desired-otlp-http-port> \
   --core-acceptors-otlp-http-host=<basedomain> \
   --core-acceptors-otlp-grpc-port=<desired-otlp-grpc-port> \
   --core-acceptors-otlp-grpc-host=<basedomain> \
   --core-acceptors-eum-port=<desired-eum-port> \
   --core-acceptors-eum-host=<basedomain> \
   --core-acceptors-synthetics-port=<desired-synthetics-port> \
   --core-acceptors-synthetics-host=<basedomain> \
   --core-acceptors-opamp-port=<desired-opamp-port> \
   --core-acceptors-opamp-host=<basedomain> \
   --core-acceptors-serverless-port=<desired-serverless-port> \
   --core-acceptors-serverless-host=<basedomain>

 
Hinweis:

Wenn Sie das --core-use-tu-url-path Flag verwenden, müssen Sie die folgenden obligatorischen Akzeptor-Ports konfigurieren:

  • Agent Akzeptor
  • OTLP ( HTTP, gRPC, oder beides)
  • OpAMP

Die übrigen Akzeptoren (EUM, Synthetics und Serverless) sind optional und müssen nicht konfiguriert werden. Außerdem können Sie Port 8443 für keinen Akzeptor verwenden, wenn --core-use-tu-url-path aktiviert ist. Für nicht konfigurierte Akzeptoren können Sie den Standardport 443 verwenden.

Diese Einstellung bewirkt, dass die Basisdomäne für die Benutzeroberfläche, die API und den gesamten Akzeptorverkehr verwendet wird. Sie ist nützlich, wenn Subdomains aufgrund von Einschränkungen nicht verwendet werden können.

Verwendung vorhandener Zertifikate

Um ein benutzerdefiniertes TLS-Zertifikat und einen TLS-Schlüssel zu verwenden, verwenden Sie den folgenden Befehl:

stanctl backend apply --core-tls-crt <full-path-to-certificate-file> --core-tls-key <full-path-to-key-file>
 

Konfigurieren eines Dienstanbieters

Hinweis: Für die Konfiguration eines Dienstanbieters, wie SAML oder OIDC, benötigen Sie ein Zertifikat. Stellen Sie sicher, dass Sie die kombinierte PEM-Datei für Zertifikat und Schlüssel erstellen. Weitere Informationen finden Sie unter Erstellen von Service Provider-Schlüssel und -Zertifikat für die Konfiguration von IdP.

Um einen Service Provider zu konfigurieren, führen Sie den folgenden Befehl aus:

stanctl backend apply --core-service-provider-password <pem-password> --core-service-provider-pem <full-path-to-combined-pem-file>
 

Proxy-Server verwenden

Einige externe Dienste, wie z. B. Mailserver und Empfänger des Alert Channel, sind nur über einen Proxyserver zugänglich. Damit das Instana-Backend diese Dienste erreichen kann, müssen Sie einen Proxy-Server konfigurieren. Verwenden Sie den folgenden Befehl:

stanctl backend apply --core-proxy-host <proxy-host> --core-proxy-port <proxy-port> --core-proxy-user <proxy-user> --core-proxy-password <proxy-password>
 

Verwendung eines SMTP-E-Mail-Servers

Um alle Mailfunktionen im Backend zu nutzen, konfigurieren Sie einen SMPT-Mailserver.

stanctl backend apply --core-smtp-check-server-identity=true --core-smtp-use-ssl=true --core-smtp-start-tls=false --core-smtp-from <sender-email-address> --core-smtp-host <SMTP-host> --core-smtp-port <SMTP-port> --core-smtp-user <SMTP-username> --core-smtp-password <SMTP-password>
 

Verwendung eines benutzerdefinierten CA-Zertifikats

Einige externe Dienste verwenden Zertifikate, die von einer eigenen Zertifizierungsstelle (CA) signiert sind. Um diese Dienste in Instana zu verwenden, fügen Sie ihre Zertifikate zu den Vertrauensspeichern hinzu. Wenn diese Zertifikate nicht von einer Stammzertifizierungsstelle stammen, importiert Instana die gesamte Zertifikatskette (Ihr Zertifikat, Zwischenzertifikate und das Stammzertifikat) in den JVM-Schlüsselspeicher des Betreibers.

stanctl backend apply --core-custom-ca-crt <ca-certificate-file>
 

Horizontale automatische Podskalierung (HPA)

Instana-Backend-Komponenten unterstützen die automatische Skalierung mit Kubernetes Horizontal Pod Autoscaling (HPA). Diese Funktion ist standardmäßig aktiviert und hilft bei der Optimierung der Ressourcennutzung durch die Skalierung von Pods auf der Grundlage der Workload-Anforderungen.

Wenn Sie HPA explizit deaktivieren oder wieder aktivieren wollen, verwenden Sie das folgende Flag:

stanctl backend apply --core-enable-hpa=<true|false>
 

Optionale Funktionen

Einige Funktionen sind in einem selbst gehosteten Backend standardmäßig nicht aktiviert. Sie können diese Funktionen mit Hilfe zusätzlicher Konfigurationsoptionen aktivieren.

Weitere Informationen zu den optionalen Funktionen und deren Aktivierung finden Sie unter Aktivieren optionaler Funktionen.

Neustarten des Systems

Auf Standard Edition können Sie ein sanftes Herunterfahren des Kubernetes Clusters einleiten. Dies ermöglicht ein sauberes Beenden von Systemkomponenten und Workloads und trägt dazu bei, Datenverluste oder -beschädigungen zu vermeiden.

Hinweis: Um den Cluster korrekt herunterzufahren, führen Sie den Befehl systemctl reboot anstelle des Befehls reboot aus.