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 :

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 :

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.

Remarque : pour mettre à jour correctement l'agent, veillez à utiliser une version de l'agent dont le mode de déploiement et l'environnement d'exécution correspondent à ceux de votre installation d'origine.

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 :

  1. 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 ».
  2. Sélectionnez la tuile de paquet requise. Par exemple, Windows - Windows (programme d'installation) 64Bit et Windows - Isolé physiquement (archive, programme d'installation).
  3. 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.
  4. Cliquez sur le lien de téléchargement pour enregistrer le fichier d'installation d' Windows.
  5. 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 :

  1. 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 ».
  2. Sélectionnez la tuile de paquet requise. Par exemple, Windows - Windows Installer 64Bit (installation sans intervention) et Windows - Elastic Computing ( EC2 ) - Windows 64Bit.
  3. Sélectionnez le mode d'empaquetage et la durée d'exécution de votre installation d'origine.
  4. Cliquez sur le lien de téléchargement pour enregistrer le fichier d'installation d' Windows.
  5. 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 :

  1. 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 ».
  2. Sélectionnez la tuile de paquet requise. Par exemple, Windows - Fichiers ZIP.
  3. Sélectionnez le mode d'emballage de votre installation d'origine.
  4. Cliquez sur le lien de téléchargement correspondant à la version 32 bits ou 64 bits d' Windows pour enregistrer le .zip fichier.
  5. Décompressez le fichier .zip té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 :

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

  1. 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.
  2. Cliquez sur un hôte surveillé spécifique.
  3. 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.