Installation de l'agent sous Linux

Le script à une ligne accepte les paramètres suivants :

Pour télécharger un package d'agent d' Instana, 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 ».

   Si vous lancez une nouvelle instance d'essai d' Instana, le catalogue d'agents s'affiche et vous invite à sélectionner un agent hôte à installer.

2. Sur la page du catalogue de déploiement de l'agent, cliquez sur la tuile Linux - Paquets (DEB, RPM).

3. Sélectionnez les configurations de l'agent.

   • Dans la section Packaging, sélectionnez le type d'agent (Dynamic ou " Static) que vous souhaitez déployer. Pour comprendre les différences entre les agents statiques et les agents dynamiques, voir Types d'agents d'accueil.

   • Dans la section Runtime, sélectionnez Azul Zulu 11 ou Eclipse OpenJ9 11 runtime.

   • Dans la section Mode, sélectionnez le mode d'emballage (RPM ou " DEM) que vous souhaitez utiliser.

4. Dans la section Architecture de la plate-forme, sélectionnez l'architecture de la machine Linux sur laquelle vous souhaitez installer l'agent hôte.

5. Cliquez sur l'icône de téléchargement pour télécharger le paquetage de l'agent hôte (DEB ou RPM) à partir de votre navigateur web.

Le paquet d'agents est maintenant téléchargé. Go Passez à la section suivante pour installer le paquet de l'agent.

Demandez à votre gestionnaire de paquets d'installer le paquet d'agents ou installez le paquet d'agents manuellement.

Pour installer le paquetage de l'agent à l'aide d'un gestionnaire de paquets, utilisez l'une des méthodes suivantes en fonction de votre distribution Linux:

openSUSE/SLES (zypp gestionnaire de paquets)

Pour openSUSE et SUSE Linux Enterprise Server, le chemin est '/etc/zypp/yum.repos.d/Instana-Agent.repo, mais le contenu peut rester le même que celui de la distribution basée sur le RPM.

L'agent est maintenant installé. Après avoir actualisé les sources du gestionnaire de paquets, passez à la section suivante pour continuer.

1. Configurez le point de terminaison de l'agent hôte et la clé de l'agent.

   Pour trouver les valeurs du point de terminaison, du port et de la clé d'agent, accédez à la page d'accueil de l'interface utilisateur d' Instana, puis cliquez sur « Déploiement d'agent ». Sur la page du catalogue de déploiement des agents, cliquez sur la vignette « Linux » - Installation automatique (commande en une ligne). Vous pouvez alors voir les valeurs des clés de point d'extrémité, de port et d'agent dans le script de déploiement.

   Voir l'exemple de script suivant :

   curl -o setup_agent.sh https://setup.instana.io/agent && chmod 700 ./setup_agent.sh && sudo -E ./setup_agent.sh -a aGeNTKEY0vaLuO0Eu1ABc -d n3asffgkg -t dynamic -e ingress-green-saas.instana.io:443

2. Définissez les variables d'environnement avant d'installer l'agent hôte.

   export INSTANA_AGENT_KEY=$agentkey
   export INSTANA_AGENT_ENDPOINT=$endpoint
   export INSTANA_AGENT_ENDPOINT_PORT=$endpoint_port

   Remarque : l'utilisation des variables d'environnement INSTANA_AGENT_HOST et INSTANA_AGENT_PORT pour la configuration de l'agent est obsolète. Ces variables d'environnement sont réservées à la configuration des traceurs d' Instana s pour la connexion à l'agent. Si ces paramètres sont définis au niveau global, les traceurs « Instana » ne peuvent pas se connecter à l'agent. La prise en charge de l'utilisation de ces variables d'environnement pour configurer l'agent sera supprimée dans les prochaines versions d' Instana.

   Résumé des options de définition des variables d'environnement :

   • Gestion de la configuration Git: Placer des variables d'environnement dans un fichier est une bonne approche. Pour plus d'informations, consultez la section « Gestion de la configuration basée sur Git ».

   • Systemd : A sans rendez-vous est le moyen le plus simple de remplacer les paramètres d'environnement spécifiques aux services.

   • SysVinit: Place les fichiers dans '/etc/sysconfig (dérivés deRed Hat ) ou '/etc/default ' (dérivés deDebian ).

   Pour plus d'informations sur les options relatives aux variables d'environnement, consultez la section « Définition et remplacement des variables d'environnement ».

Le travail de préparation pour l'installation de l'agent est maintenant terminé. Go Rendez-vous à la section « Installation de l'agent » pour continuer.

Actualisez les sources du gestionnaire de paquets, puis exécutez l'une des commandes suivantes pour installer l'agent sur l'architecture choisie :

• Dérivés de Debian

  • Pour installer un agent statique, exécutez la commande suivante :

    apt-get install instana-agent-static

  • Pour installer un agent dynamique, exécutez la commande suivante :

    apt-get install instana-agent-dynamic

• Dérivés de Red Hat

  • Pour installer un agent statique, exécutez la commande suivante :

    yum install instana-agent-static

  • Pour installer un agent dynamique, exécutez la commande suivante :

    yum install instana-agent-dynamic

• Packages intégrés Eclipse OpenJ9 11

  Installez l'agent hôte avec l'un des noms de paquetage suivants : " instana-agent-static-j9 ou " instana-agent-dynamic-j9.

L'agent hôte est maintenant installé. Pour savoir ce que vous pouvez faire après l'installation, consultez la section Que faire ensuite ?

Avant d'installer l'agent hôte, assurez-vous que les conditions préalables suivantes sont remplies :

• Un kit de développement Java ( Java, JDK) doit être mis à la disposition de l'agent via l'une des options suivantes :

  • Placer ou lier le JDK dans le " <instana-agent-install-dir>/jvm (de sorte que le " <instana-agent-install-dir>/jvm/bin/java existe).

  • La méthode personnalisable consiste à exporter une variable d'environnement JAVA_HOME pour pointer vers ce JDK (cette variable d'environnement peut également être définie à " instana-agent-install-dir>/bin/setenv).

  Les JDK suivants sont pris en charge pour l'exécution de l'agent :

  • IBM OpenJ9 JDK 11 (recommandé)
  • Azul Zulu JDK 11
  • OpenJDK JDK 11
  • Oracle Point fort du JDK 11
  • JDK 11 d'Amazon Corretto
  • IBM J9 11

  Le fichier « JVM » doit être exécutable pour tous les utilisateurs du système. Il est recommandé d'utiliser la dernière version corrective disponible de la distribution Java de votre choix. L'agent nécessite un JDK prenant en charge la fonctionnalité « TLSv1.3 » (disponible dans toutes les versions actuelles du JDK 11). Selon la distribution de votre système d'exploitation, les paquets fournis par le distributeur du système d'exploitation peuvent ne pas contenir de support de chiffrement fort en raison des contrôles à l'exportation. Si vous utilisez un tel paquet, vous pourriez rencontrer des erreurs telles que : « java.lang.RuntimeException:. Impossible de générer la paire de clés DH. »

• Pour réduire les ressources utilisées par l'agent lorsque le système de fichiers est modifié, vous devez installer le paquet inotify-tools sur votre distribution Linux.

• Assurez-vous que l'utilisateur utilisé pour exécuter l'agent peut écrire dans le répertoire de l'agent et dans tous ses sous-répertoires. L'agent télécharge les capteurs nécessaires conformément à la détection automatique et crée des fichiers journaux dans son sous-répertoire " data.

• Veillez à disposer d'environ 100 Mo d'espace disque disponible.

• L'agent télécharge les mises à jour et les capteurs à partir de l'hôte suivant. Assurez-vous que l'hôte et les ports suivants sont accessibles :

  • DNS Nom : artifact-public.instana.io
  • Port de destination: " tcp/80 et " tcp/443

• À l'heure actuelle, le service « Instana » est proposé dans deux régions différentes. Votre instance individuelle est géographiquement la plus proche de la plupart de vos agents et utilisateurs. Les agents sont préconfigurés lors du téléchargement, mais certaines méthodes d'installation nécessitent une configuration du back-end d' Instana. Consultez la section « Gestion des agents » dans le produit ou contactez votre interlocuteur technique à l'adresse IBM pour connaître la région dans laquelle se trouve votre instance.

• Si vous utilisez la version auto-hébergée (sur site) d' Instana, utilisez les points de terminaison définis lors de l'installation du backend d' Instana. Vous pouvez également consulter le point de terminaison auquel l'agent envoie ses rapports dans l'interface utilisateur d' Instana. Sur la page d'accueil de l'interface utilisateur d' Instana, cliquez sur « Agents et collecteurs ». Dans l'onglet « Agents d' Instana », sélectionnez « Installer les agents », puis cochez le code de déploiement ou la configuration d' YAML.

• Si vous utilisez Instana SaaS,, utilisez les points de terminaison décrits à la section « Points de terminaison de l'agent hôte ».

Vous pouvez télécharger l'agent hôte de l'une des manières suivantes :

• Téléchargez l'agent depuis l'interface utilisateur d' Instana. Pour ce faire, 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 ».

     Si vous lancez une nouvelle instance d'essai d' Instana, le catalogue d'agents s'affiche et vous invite à sélectionner un agent hôte à installer.

  2. Sur la page du catalogue de déploiement de l'agent, cliquez sur la tuile Linux - Archive (tar.gz.

  3. Dans la section Packaging, sélectionnez le type d'agent (Dynamic ou " Static) que vous souhaitez déployer. Pour comprendre les différences entre les agents statiques et les agents dynamiques, voir Types d'agents d'accueil.

  4. Dans la liste déroulante, sélectionnez l'architecture de la plate-forme (système d'exploitation).

     Le fichier d'archivage est automatiquement préconfiguré avec les paramètres de votre compte Instana; il vous suffit donc de l'extraire et de lancer l'agent.

  5. Cliquez sur l'icône de téléchargement pour télécharger le fichier de l'agent hôtetar.gz) à partir de votre navigateur web, puis extrayez le fichier.

• Téléchargez l'agent avec wget en exécutant les commandes suivantes :

  wget --save-cookies {{agent_folder_name}}/instana-cookies.txt --post-data 'email={{instana_username}}&password={{instana_password}}' https://{{instana_tenant_unit}}-{{instana_tenant}}.instana.io/auth/signIn

  wget --content-disposition --load-cookies {{agent_folder_name}}/instana-cookies.txt --post-data 'type=linux64' https://instana.io/ump/{{instana_tenant}}/{{instana_tenant_unit}}/agent/download -O {{opt_folder}}/{{name_of_agent_archive.tar.gz}}

L'agent hôte est maintenant téléchargé. Go Passez à la section suivante pour lancer l'agent.

Placez le fichier extrait de l'agent dans un emplacement accessible à l'ensemble du système et exécutez l'agent en tant qu'utilisateur principal.

Pour démarrer l'agent, exécutez la commande suivante :

INSTANA_AGENT_FOLDER/bin/start

L'agent hôte est maintenant installé et démarré. Pour savoir ce que vous pouvez faire après l'installation, voir Que faire ensuite ?