Tutoriel : Téléchargement et installation d'un agent

Ce tutoriel vous permet d'acquérir l'expérience du téléchargement et de l'installation d'un Cloud APM agent Windows OS à partir d'IBM® Marketplace. Vous pouvez ensuite démarrer la console Cloud APM et vérifier la santé de votre ressource surveillée en affichant des indicateurs clés de performance dans les tableaux de bord.

1. Si vous n'êtes pas connecté à IBM Marketplace, connectez-vous avec vos ID utilisateur et mot de passe IBM, et accédez à Produits et services.
   La page Produits et services est disponible pour les abonnés actifs. En cas de problème, accédez au forum Cloud Application Performance Management ou au Support Marketplace.
2. Téléchargez le fichier archive d'installation de Windows :
   1. Dans la boîte de souscription de Cloud APM, cliquez sur Gérer > Téléchargements.
   2. Sélectionnez le système d'exploitation Windows.

      Sélectionnez le package d'agents IBM Cloud Application Performance Management 64 bits. Si vous utilisez la version 32 bits de Windows, sélectionnez le package d'agent 32 bits.

   3. Cliquez sur Download et enregistrez le fichier archive d'installation d'agent sur votre système.
      Exemple :

      C:\Users\MY_ADMIN\Downloads\IAPM_Agent_Install.zip

3. Sur votre système Windows local, accédez au répertoire dans lequel vous avez enregistré le fichier archive téléchargé et extrayez son contenu.
   Par exemple, dans l'Explorateur Windows, ouvrez le répertoire Téléchargements, cliquez avec le bouton droit de la souris sur IAPM_Agent_Install.zip, puis sélectionnez Extraire tout.
4. Ouvrez une invite de commandes en tant qu'administrateur :
   1. Dans le menu Démarrer de Windows, tapez commande dans la zone de recherche.
   2. Cliquez sur Invite de commandes avec le bouton droit de la souris dans la liste qui s'affiche, puis sélectionnez Exécuter en tant qu'administrateur.
5. Accédez au répertoire dans lequel vous avez extrait les fichiers d'installation.
   Exemple :

   cd C:\Users\MY_ADMIN\Downloads\IAPM_Agent_Install\IAPM_Agent_Install_8.1.4

6. Exécutez le script d'installation pour installer l'agent Windows OS :
   1. Exécutez la commande suivante :

      installAPMAgents.bat

   2. Dans la liste des agents disponibles, entrez le numéro qui correspond à l'agent Windows OS.
   3. Répondez aux invites pour confirmer que vous voulez installer l'agent Windows OS et acceptez le contrat de licence.
      Une analyse des prérequis de votre environnement, qui prend un certain temps, commence. Si des exigences ne sont pas satisfaites, un message vous dirige vers un fichier journal indiquant la raison de l'échec. Un prérequis non satisfait tel un espace disque insuffisant entraîne l'arrêt du processus d'installation. Vous devez corriger le problème et relancer le script d'installation. En cas de problème, accédez au forum Cloud Application Performance Management ou envoyez un e-mail à info@ibmserviceengage.com.
   
   Pour afficher le rapport sur les exigences du système d'exploitation Windows, voir System requirements (APM Developer Center).
   Une fois l'installation réussie, l'agent Windows OS démarre automatiquement et vous pouvez démarrer la console Cloud APM pour lancer la surveillance de votre système Windows.

   Remarque : Si votre environnement inclut un pare-feu qui n'autorise pas les connexions HTTPS sortantes transparentes à un hôte externe, vous devez configurer un proxy direct pour les communications entre l'agent et le serveur Cloud APM. En configurant un proxy direct, vous pouvez acheminer l'intégralité du trafic vers un point spécifique du réseau et de n'autoriser qu'une seule connexion via le pare-feu. Pour plus d'informations, voir Configuration des agents pour qu'ils communiquent via un proxy direct.
7. Retournez dans Produits et services sur IBM Marketplace et cliquez sur Lancer dans la boîte de souscription de Cloud APM.
   La console Cloud APM s'ouvre sur la page Mise en route à partir de laquelle vous pouvez vous familiariser avec les fonctions, visionner des vidéos de différents scénarios d'utilisation et ouvrir les pages de console associées.
8. Dans la page Mise en route, cliquez sur Visitez le tableau de bord de gestion des performances pour un tour d'horizon des éléments de navigation.
   
9. Ouvrez le tableau de bord récapitulatif du système d'exploitation Windows :
   1. A partir de la barre de navigation, cliquez sur Performance > Tableau de bord d'Application Performance.
      • Le tableau de bord Toutes mes applications s'affiche avec une zone d'état récapitulative de chacune des applications définies dans votre environnement. Au départ, seule l'application prédéfinie Mes composants s'affiche.
      • Si une fenêtre Ajouter une application s'affiche au lieu de Mes composants, créez une application pour visualiser votre ressource surveillée :
        1. Entrez un nom pour l'application, par exemple, Mon application.
        2. Cliquez sur .
        3. Faites défiler la liste vers le bas jusqu'à Sélectionner le composant, puis cliquez sur Système d'exploitation Windows.
        4. Dans l'éditeur de composant, cliquez sur Principal :nom_hôte:NT, sur Ajouter, puis sur Précédent pour ajouter votre agent à l'application.
        5. Cliquez sur Sauvegarder pour fermer la fenêtre et afficher une zone d'état récapitulative de votre nouvelle application dans le tableau de bord.
   2. Dans la zone récapitulative, cliquez sur Composants.
      • Le tableau de bord récapitulatif de votre système géré de système d'exploitation Windows s'affiche. Dans ce tableau de bord, vous pouvez cliquer n'importe où dans le widget de groupe de récapitulatif d'état pour défiler vers le bas jusqu'à des tableaux de bord détaillés contenant des indicateurs clés de performance renvoyés depuis votre agent Windows OS.
      • Un agent qui vient d'être démarré peut nécessiter un peu de temps pour communiquer avec l'infrastructure de surveillance et envoyer des indicateurs clés de performance à la console.
   

   Si l'agent ne communique pas avec le serveur Cloud APM ou n'est pas démarré, le tableau de bord récapitulatif n'affiche aucun indicateur clé de performance et affiche l'état inconnu. Vous pouvez utiliser la commande os-agent pour vérifier l'état et démarrer l'agent si nécessaire. Ouvrez une invite de commande en tant qu'administrateur et entrez la commande os-agent status à partir du dossier C:\\IBM\APM\bin. Si l'agent n'est pas démarré, entrez la commande os-agent start.