Configuration d' Instana
Utilisez stanctl pour installer et gérer les agents Instana, effectuer les configurations du backend, mettre à jour les paramètres d'authentification et activer les fonctionnalités optionnelles.
Pour plus d'informations à ce sujet stanctl, consultez la section « Utilisation des commandes stanctl ».
- Agents Instana
- Instana configurations du backend
- Configuration d' Standard Edition. avec un seul domaine
- Utilisation de certificats existants
- Configuration d'un fournisseur de services
- Utilisation d'un serveur proxy
- Utilisation d'un serveur de messagerie SMTP
- Utilisation d'un certificat d'autorité de certification personnalisé
- Mise à l'échelle automatique de pod horizontale (HPA)
- Configurations d'authentification
- Fonctionnalités facultatives
- Redémarrer le système
Agents Instana
Installez les agents d' Instana s pour surveiller vos piles technologiques à l'aide de la stanctl agent commande.
- Pour plus d'informations sur les agents d' Instana, consultez la section « Installation des agents d' Instana ».
- Pour plus d'informations sur la commande
stanctl agent, utilisezstanctl agent --help.
stanctl agent apply --agent-key <key-value> commande.Activer l'autosurveillance
Vous pouvez activer l'autosurveillance de votre hôte Standard Edition autohébergé en installant l 'agent hôte.
Nous recommandons l'autosurveillance sur le même système dorsal uniquement pour les installations de test. Pour une auto-surveillance fiable, utilisez idéalement un second système de back end. Il suffit d'utiliser le type d'installation demo sur le deuxième hôte dorsal. Sur le système à surveiller, vous devez affecter le noeud final de l'accepteur d'agent à l'agent à l'aide de l'indicateur --agent-endpoint-host .
Vous trouverez l'adresse du point de terminaison de l'acceptateur d'agent URL sur la page de l'interface utilisateur d' Instana<Platform> > Installer l'agent >. Recherchez une valeur de noeud final commençant par agent-acceptor. Pour plus d'informations, consultez la section « Installation de l'agent hôte » sur Kubernetes.
À partir de l'interface de ligne de commande de votre hôte, exécutez la commande suivante pour installer l'agent ou mettre à jour sa configuration :
- Si vous utilisez le même système de back end pour la surveillance automatique, exécutez la commande suivante:
stanctl agent apply - Si vous utilisez un deuxième système de back end pour la surveillance automatique, exécutez la commande suivante:
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> l'option avec la commande précédente.stanctl commande vous demande un nom d'utilisateur et un mot de passe, utilisez l'utilisateur par défaut _ comme nom d'utilisateur et votre clé de téléchargement comme mot de passe.Désactivation de l'autosurveillance
Pour désinstaller l'agent hôte d' Instana s et désactiver l'autosurveillance, exécutez la commande suivante :
stanctl agent delete
Instana configurations du backend
À tout moment, pendant ou après l'installation du backend d' Instana, vous pouvez mettre à jour les paramètres de configuration du noyau d' Instana à l'aide de la stanctl backend apply commande. Utilisez stanctl backend apply --help pour afficher les options de configuration. Vous pouvez également créer un fichier .env comme décrit dans Variables d'environnement.
Pour configurer instana à l'aide de votre fichier .env , exécutez la commande suivante:
stanctl backend apply --env-file <your_env_file>
Pour plus d'informations sur les spécifications de base, consultez les CoreSpec rubriques de la documentation de référence d' API.
Configuration d' Standard Edition. avec un seul domaine
Pour installer et configurer Standard Edition avec un seul domaine, exécutez la commande suivante :
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>
Lorsque vous utilisez --core-use-tu-url-path l'option, vous devez configurer les ports d'acceptation obligatoires suivants :
- Accepteur d'agent
- OTLP ( HTTP, gRPC, ou les deux)
- OpAMP
Les autres accepteurs (EUM, Synthetics et Serverless) sont facultatifs; vous n'avez pas besoin de les configurer. De plus, vous ne pouvez pas utiliser le port 8443 pour un acceptor quelconque lorsque cette option --core-use-tu-url-path est activée. Pour les acceptors qui ne sont pas configurés, vous pouvez utiliser le port par défaut 443.
Ce paramètre fait en sorte que le domaine de base soit utilisé pour l'interface utilisateur, l' API et tout le trafic vers les serveurs acceptants. Cela s'avère utile lorsque les sous-domaines ne peuvent pas être utilisés en raison de restrictions.
Utilisation des certificats existants
Pour utiliser un certificat et une clé TLS (TLS) personnalisés, utilisez la commande suivante :
stanctl backend apply --core-tls-crt <full-path-to-certificate-file> --core-tls-key <full-path-to-key-file>
Configuration d'un fournisseur de services
Pour configurer un fournisseur de services, exécutez la commande suivante:
stanctl backend apply --core-service-provider-password <pem-password> --core-service-provider-pem <full-path-to-combined-pem-file>
Utilisation d'un serveur proxy
Certains services externes, tels que le serveur de messagerie et les destinataires du canal d'alerte, sont accessibles uniquement via un serveur proxy. Pour que le backend d' Instana puisse accéder à ces services, vous devez configurer un serveur proxy. Utilisez la commande suivante :
stanctl backend apply --core-proxy-host <proxy-host> --core-proxy-port <proxy-port> --core-proxy-user <proxy-user> --core-proxy-password <proxy-password>
Utilisation d'un serveur de messagerie SMTP
Pour utiliser toutes les fonctions de messagerie dans le système dorsal, configurez un serveur de messagerie SMPT.
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>
Utilisation d'un certificat CA personnalisé
Certains services externes utilisent des certificats signés par une autorité de certification personnalisée. Pour utiliser ces services dans l' Instana, ajoutez leurs certificats aux magasins de confiance. Si ces certificats ne proviennent pas d'une autorité de certification racine, Instana importe la chaîne de certificats complète (votre certificat, les certificats intermédiaires et le certificat racine) dans le magasin de clés de l'opérateur JVM.
stanctl backend apply --core-custom-ca-crt <ca-certificate-file>
Mise à l'échelle automatique de pod horizontale (HPA)
Instana Les composants backend prennent en charge la mise à l'échelle automatique via la fonctionnalité de mise à l'échelle automatique horizontale des pods (HPA) d' Kubernetes. Cette fonctionnalité est activée par défaut et permet d'optimiser l'utilisation des ressources en adaptant la taille des pods en fonction de la charge de travail.
Si vous souhaitez désactiver ou réactiver explicitement HPA, utilisez l'indicateur suivant :
stanctl backend apply --core-enable-hpa=<true|false>
Configurations d'authentification
Gérez les données d'identification d'accès et les configurations d'authentification. Pour plus d'informations, consultez la section « Modification de la configuration de l'authentification ».
Fonctionnalités facultatives
Certaines fonctionnalités ne sont pas activées par défaut dans un backend auto-hébergé. Vous pouvez activer ces fonctions en utilisant des options de configuration supplémentaires.
Pour plus d'informations sur les fonctionnalités optionnelles et sur la manière de les activer, consultez la section « Activation des fonctionnalités optionnelles ».
Redémarrer le système
Sur Standard Edition, vous pouvez lancer un arrêt en douceur du cluster Kubernetes. Cela permet aux composants du système et aux charges de travail de s'arrêter correctement, ce qui contribue à éviter toute perte ou altération des données.
systemctl reboot commande au lieu de la reboot commande.