Administration de l'agent « Instana » sur Docker
Après avoir installé l'agent, configurez-le et gérez-le selon vos besoins. Consultez les sections suivantes pour connaître toutes les options de configuration des agents disponibles sur Docker.
Vérification du statut de l'agent hôte
Une fois l'agent hôte installé, vous pouvez vérifier son état dans l'interface utilisateur d' Instana ou directement sur l'hôte. Pour plus d'informations, voir Vérification de l'état de l'agent hôte.
Configuration de l'agent
En plus des variables d'environnement requises, des variables d'environnement supplémentaires peuvent être configurées au démarrage. Pour plus d'informations sur les variables disponibles, consultez la section « Variables d'environnement pour l'agent hôte ».
Montez les fichiers de configuration principaux dans le répertoire d' /root . Les fichiers sont copiés à l'endroit où se trouve le fichier d'archive (.tar) de l'agent lorsqu'il est décompressé.
Configuration de l'agent prioritaire avec montées en volume
Vous pouvez remplacer les paramètres d'échange dans les fichiers de configuration en utilisant la fonction de volume d' Docker. Le fichier de configuration de l'agent configuration.yaml fourni avec l'image définit des valeurs par défaut et ne doit pas être écrasé. Vous pouvez étendre le fichier par des extraits de configuration personnalisés nommés « configuration-<custom-extension>.yaml » comme suit :
--volume <host-path>/configuration-<custom-extension>.yaml:/opt/instana/agent/etc/instana/configuration-<custom-extension>.yaml
Exemple : Vous pouvez configurer un fichier d' configuration-mysql.yaml s pour les informations d'identification de l' MySQL, puis ajouter ce fichier de configuration lors du démarrage du conteneur.
configuration-mysql.yaml
# Mysql
com.instana.plugin.mysql:
user: 'mysqlAdmin'
password: 'mysqlSecretPassword'
docker exécuter le montage du volume
--volume /opt/instana-agent/etc/instana/configuration-mysql.yaml:/opt/instana/agent/etc/instana/configuration-mysql.yaml
Configuration de plusieurs backends
Vous pouvez configurer l'agent Instana pour qu'il transmette ses rapports à plusieurs serveurs de collecte. Pour des considérations générales et des remarques concernant la configuration, consultez la section « Configuration de plusieurs backends ».
Pour ajouter des backends supplémentaires à l'agent hôte d' Instana, montez les fichiers backend tels que com.instana.agent.main.sender.Backend-2.cfg.
Voir l'exemple d'argument suivant pour un agent conteneurisé :
--mount type=bind,source=<path-to-additional-backend-config>,target=/opt/instana/agent/etc/instana/com.instana.agent.main.sender.Backend-2.cfg
Configuration du miroir du référentiel de l'agent
INSTANA_SHARED_REPOSITORY_MIRROR_URLINSTANA_SHARED_REPOSITORY_MIRROR_USERNAMEINSTANA_SHARED_REPOSITORY_MIRROR_PASSWORD
Pour plus d'informations sur la configuration des miroirs du référentiel Maven à l'aide de variables d'environnement, consultez la section « Configuration des miroirs du référentiel Maven ».
Configuration de l'agent pour les paramètres proxy
L'agent « Instana » communique avec deux points de terminaison distincts : le système backend « Instana » pour y envoyer toutes les données collectées, et un référentiel pour récupérer les mises à jour de l'agent et des capteurs. Vous pouvez configurer ces deux points de terminaison pour utiliser les paramètres de proxy. Les trois approches suivantes sont disponibles :
Aucun paramètre de proxy pour les deux points de terminaison — aucune configuration requise pour les paramètres de proxy.
Mêmes paramètres de proxy pour le backend et le référentiel — configurez uniquement les paramètres de proxy « Agent ».
Paramètres de proxy différents pour le backend et le référentiel : configurez les deux proxies séparément et veillez à définir
INSTANA_REPOSITORY_PROXY_ENABLED=true.Par exemple, si vous avez besoin de configurer un proxy uniquement pour le référentiel, utilisez la configuration suivante :
- Associez toutes les variables
INSTANA_AGENT_PROXY_à""(chaîne vide). - Définir
INSTANA_REPOSITORY_PROXY_ENABLED=true - Définissez toutes les variables d'
INSTANA_REPOSITORY_PROXY_s sur la configuration du proxy selon les besoins.
- Associez toutes les variables
De même, pour les paramètres de proxy de l'agent, activez INSTANA_AGENT_PROXY_ENABLED et définissez toutes les variables d' INSTANA_AGENT_PROXY_ s sur la configuration du proxy selon les besoins.
Mises à jour et verrouillage des versions
Vous pouvez contrôler les mises à jour des agents et les versions des épingles dont vous avez besoin en utilisant des variables d'environnement. Pour plus d'informations, voir Contrôler les mises à jour dans les agents conteneurisés.
Personnalisation de la configuration de l'agent
Après avoir installé l'agent hôte, les fichiers de configuration suivants sont créés :
/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
Vous pouvez personnaliser la configuration de l'agent selon vos besoins. Par exemple, vous pouvez modifier le port et le nom d'hôte d' TCP du backend Instana et des services auxquels votre agent hôte se connecte, configurer l'agent pour qu'il envoie des rapports à plusieurs backends, ou configurer un proxy pour permettre une communication indirecte entre l'agent hôte et le backend Instana.
Pour plus d'informations sur la personnalisation de la configuration des agents, consultez les rubriques suivantes :
- Journalisation de l'agent
- Configuration du backend d' Instana
- Configuration du mode de l'agent hôte
- Configuration des agents hôtes à l'aide du fichier de configuration des agents
- Conversion d'un agent statique en agent dynamique
- Limitation de l'unité centrale et de la mémoire de l'agent hôte
- Récupération de la version actuelle des agents dynamiques
- Configuration d'un proxy d'agent
- Configuration du chiffrement « TLS » pour le terminal de l'agent
- Intervalle de mise à jour des agents dynamiques
- Verrouillage de version des agents dynamiques
Démarrage et arrêt de l'agent
Démarrage de l'agent
Lorsque vous installez l'agent hôte, il est configuré pour démarrer automatiquement au démarrage du système. Vous pouvez désactiver ce comportement en définissant la variable d'environnement INSTANA_AGENT_AUTOSTART=false lors de l'installation de l'agent.
Pour démarrer l'agent hôte, exécutez la commande suivante :
INSTANA_AGENT_FOLDER/bin/startSi votre système d'exploitation utilise
systemdcomme système d'initialisation, exécutez la commande suivante :systemctl start instana-agent.serviceSi votre système d'exploitation utilise
SysVinitcomme système d'initialisation, exécutez la commande suivante :service instana-agent start
Arrêt de l'agent
Pour arrêter l'agent, exécutez la commande suivante :
INSTANA_AGENT_FOLDER/bin/stop
Gestion des agents à l'aide du tableau de bord Agent Management
Vous pouvez effectuer les opérations suivantes à l'aide du tableau de bord de gestion des agents dans l'interface utilisateur d' Instana :
- Changement de mode des agents
- Modification du niveau de journalisation
- Mise à jour des agents
- Agents de remise en état
- Agents de redémarrage
- Capteurs de vision
- Gestion des configurations
- Surveillance automatique
Pour ouvrir le tableau de bord de la gestion des agents, procédez comme suit :
- Dans la barre latérale de l'interface utilisateur d' Instana, sélectionnez « Infrastructure ».
- Cliquez sur un hôte surveillé spécifique.
- Sur le tableau de bord hôte, cliquez sur Ouvrir la gestion des agents.
Activation de la surveillance du processeur graphique
Les cartes graphiques Nvidia ci-après sont prises en charge.
| Marque | Modèle |
|---|---|
| Tesla | S1070, S2050, C1060, C2050/70, M2050/70/90, X2070/90, K10, K20, K20X, K40, K80, M40, P40, P100, V100 |
| Quadro | 4000, 5000, 6000, 7000, M2070-Q, K-series, M-series, P-series, RTX-series |
| GeForce | plusieurs niveaux de prise en charge, avec moins de métriques disponibles par rapport aux produits Tesla et Quadro |
Prérequis
La surveillance du GPU nécessite un système d'exploitation Linux.
Veillez également à installer les logiciels suivants :
- Docker version 19.03 ou ultérieure.
- Les derniers pilotes officiels Nvidia. Les pilotes installés à l'aide de gestionnaires de paquets ne sont pas suffisants.
- NVIDIA Boîte à outils de conteneurs.
Pour activer la surveillance de processeur graphique, démarrez le conteneur de l'agent Instana sur un ou plusieurs processeurs graphiques. L'agent peut être démarré en tant que conteneur privilégié.
L'agent collecte des métriques pour tous les processeurs graphiques disponibles à l'échelle du système et qui sont pris en charge, quel que soit le nombre de processeurs graphiques que l'agent exécute.
Pour obtenir la liste détaillée des indicateurs collectés, consultez notre documentation sur les GPU.
Il existe plusieurs façons de démarrer le conteneur de l'agent à l'aide des processeurs graphiques :
- Pour le démarrer sur tous les processeurs graphiques disponibles, indiquez l'option
--gpus all. - Pour démarrer avec le nombre exact de GPU, fournissez l'indicateur d'
--gpus <number of gpus to use>. - Pour démarrer sur les GPU souhaités, fournissez l'indicateur
--gpus '"device=<gpu1-uuid>,<gpu2-uuid>"'.