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.

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

Pour utiliser votre propre miroir du référentiel de l'agent dynamique Maven (par exemple, dans des environnements isolés), configurez l'agent dynamique conteneurisé à l'aide des variables d'environnement suivantes :
  • INSTANA_SHARED_REPOSITORY_MIRROR_URL
  • INSTANA_SHARED_REPOSITORY_MIRROR_USERNAME
  • INSTANA_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 :

  1. Aucun paramètre de proxy pour les deux points de terminaison — aucune configuration requise pour les paramètres de proxy.

  2. Mêmes paramètres de proxy pour le backend et le référentiel — configurez uniquement les paramètres de proxy « Agent ».

  3. 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.

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.

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 :

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/start
    
  • Si votre système d'exploitation utilise systemd comme système d'initialisation, exécutez la commande suivante :

    systemctl start instana-agent.service
    
  • Si votre système d'exploitation utilise SysVinit comme 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 :

Pour ouvrir le tableau de bord de la gestion des agents, procédez comme suit :

  1. Dans la barre latérale de l'interface utilisateur d' Instana, sélectionnez « Infrastructure ».
  2. Cliquez sur un hôte surveillé spécifique.
  3. 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>"' .