Instana konfigurieren
Verwenden Sie stanctl , um Instana-Agenten zu installieren und zu verwalten, Backend-Konfigurationen abzuschließen, Authentifizierungsparameter zu aktualisieren und optionale Funktionen zu aktivieren.
Weitere Informationen über stanctl finden Sie unter Verwendung von stanctl-Befehlen.
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 agentfinden Sie unterstanctl agent --help.
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>
--agent-endpoint-port <custom-endpoint-port-of-the-second-backend> mit dem vorherigen Befehl verwenden.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
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>
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
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>
Konfigurationen für die Authentifizierung
Verwalten Sie Zugangsdaten und Authentifizierungskonfigurationen. Weitere Informationen finden Sie unter Ändern der Authentifizierungskonfiguration.
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.
systemctl reboot anstelle des Befehls reboot aus.