Administration de l'agent hôte sur Windows
Après avoir installé l'agent, configurez-le et gérez-le comme vous le souhaitez. Consultez la liste suivante pour connaître toutes les options de configuration des agents disponibles sur Windows :
Vérification de l'état de l'agent hôte
Une fois l'agent hôte installé, vérifiez 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.
Personnaliser la configuration de l'agent hôte
Après l'installation de l'agent hôte, les fichiers de configuration suivants sont créés par défaut :
*agent-path*\etc\mvn-settings.xml
*agent-path*\etc\org.ops4j.pax.url.mvn.cfg
*agent-path*\etc\instana\com.instana.agent.bootstrap.AgentBootstrap.cfg
*agent-path*\etc\instana\com.instana.agent.main.config.Agent.cfg
*agent-path*\etc\instana\com.instana.agent.main.config.UpdateManager.cfg
*agent-path*\etc\instana\com.instana.agent.main.sender.Backend.cfg
*agent-path*\etc\instana\configuration.yaml
En général, le chemin d'accès à l'agent sur Windows est C:\Program Files\Instana\instana-agent.
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 mettre en place 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 de l'agent, voir les rubriques suivantes :
- Journalisation de l'agent
- Configuration du backend « Instana »
- Configuration du mode 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
- Mise en place d'un proxy d'agent
- Configuration du chiffrement « TLS » pour le terminal de l'agent
- Intervalle de mise à jour des agents dynamiques
- Épinglage des versions des agents dynamiques
Démarrage de l'agent
Lorsque vous installez l'agent hôte, il démarre automatiquement au démarrage du système. Pour désactiver ce comportement, définissez la variable d'environnement INSTANA_AGENT_AUTOSTART=false lors de l'installation.
Pour démarrer l'agent hôte, exécutez la commande suivante :
<instana-agent-install-dir>\bin\start.bat
Arrêt de l'agent
Pour arrêter l'agent, exécutez la commande suivante :
<instana-agent-install-dir>\bin\stop.bat
Mise à jour de l'agent hôte
Vous pouvez mettre à jour l'agent hôte d' Windows de deux manières différentes, selon le mode d'installation.
Mise à jour interactive de l'agent (environnement en ligne et sous abri)
Pour mettre à jour les agents hôtes installés de manière interactive à l'aide du programme d'installation d' Windows, procédez comme suit :
- Sur la page d'accueil de l'interface utilisateur d' Instana, cliquez sur « Agents et collecteurs ». Dans l'onglet « Agents » de l' Instana, sélectionnez « Installer les agents ».
- Sélectionnez la tuile de paquet requise. Par exemple, Windows - Windows (programme d'installation) 64Bit et Windows - Isolé physiquement (archive, programme d'installation).
- Pour l'installateur d' Windows - Windows 64Bit uniquement, sélectionnez le mode de packaging et l'environnement d'exécution correspondant à votre installation d'origine.
- Cliquez sur le lien de téléchargement pour enregistrer le fichier d'installation d' Windows.
- Exécutez le programme d'installation d' Windows sur l'ordinateur hôte Windows.
Un assistant d'installation vous guide tout au long du processus de mise à niveau de l'agent.
Mise à jour silencieuse de l'agent
Pour mettre à jour les agents hôtes installés en mode silencieux à l'aide du programme d'installation d' Windows, procédez comme suit :
- Sur la page d'accueil de l'interface utilisateur d' Instana, cliquez sur « Agents et collecteurs ». Dans l'onglet « Agents » de l' Instana, sélectionnez « Installer les agents ».
- Sélectionnez la tuile de paquet requise. Par exemple, Windows - Windows Installer 64Bit (installation sans intervention) et Windows - Elastic Computing ( EC2 ) - Windows 64Bit.
- Sélectionnez le mode d'empaquetage et la durée d'exécution de votre installation d'origine.
- Cliquez sur le lien de téléchargement pour enregistrer le fichier d'installation d' Windows.
- Copiez la ligne de commande depuis l'interface utilisateur et exécutez-la sur l'ordinateur hôte d' Windows.
Le processus de mise à jour s'exécute silencieusement tout au long du processus de mise à niveau de l'agent vers la dernière version.
Mise à jour de l'agent à l'aide d'une archive ZIP
Pour mettre à jour les agents hôte installés à l'aide d'une archive ZIP, procédez comme suit :
- Sur la page d'accueil de l'interface utilisateur d' Instana, cliquez sur « Agents et collecteurs ». Dans l'onglet « Agents » de l' Instana, sélectionnez « Installer les agents ».
- Sélectionnez la tuile de paquet requise. Par exemple, Windows - Fichiers ZIP.
- Sélectionnez le mode d'emballage de votre installation d'origine.
- Cliquez sur le lien de téléchargement correspondant à la version 32 bits ou 64 bits d' Windows pour enregistrer le
.zipfichier. - Décompressez le fichier
.ziptéléchargé dans le dossier de votre choix (<instana-agent-install-dir>) sur votre ordinateur hôte Windows.
Gérer les agents à l'aide du tableau de bord de gestion des agents
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 de fonctionnement des agents
- Modification du niveau de journalisation
- Mise à jour des agents
- Réinitialisation des agents
- Agents de redémarrage
- Visualisation des capteurs
- [Gestion de la configuration]
- Surveillance automatique
Pour ouvrir le tableau de bord de la gestion des agents, procédez comme suit :
- Dans le menu de navigation de l'interface utilisateur d' Instana, sélectionnez « Infrastructure ». Vous pouvez également, dans la vue d'ensemble de l'hôte, sous « Agent d' Instana », cliquer sur l'agent.
- Cliquez sur un hôte surveillé spécifique.
- Sur le tableau de bord de l'hôte, cliquez sur Ouvrir la gestion des agents.
Définition et remplacement des variables d'environnement
Vous pouvez définir ou remplacer les variables d'environnement de l'agent d' Instana ation sur Windows à l'aide de l'éditeur de registre Windows.
Pour définir, modifier ou remplacer des variables d'environnement, accédez à l'emplacement de registre InstanaComputer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\instana-agent-service dans l'Éditeur du Registre d' Windows, puis ajoutez de nouvelles variables d'environnement ou modifiez celles qui existent déjà.
Suppression des fichiers temporaires
Instana L'agent hôte installe certains fichiers dont il a besoin dans le /Temp/instana/ répertoire. Si ces fichiers sont supprimés pendant la durée de fonctionnement de l'hôte, des problèmes peuvent survenir lors des mises à jour.
Instana efface automatiquement tous ses fichiers temporaires lorsque vous désinstallez l'agent. Pour effacer manuellement les fichiers temporaires, supprimez le contenu du dossier " Windows/Temp/instana.