Administration de l'agent hôte sous Linux

Lorsque vous installez l'agent hôte, il est activé 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 :

  /opt/instana/agent/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
   

Pour arrêter l'agent, exécutez la commande suivante :

 /opt/instana/agent/bin/stop
 

• Si votre système d'exploitation utilise " systemd comme système d'initialisation, exécutez la commande suivante :

  systemctl stop instana-agent.service
   

• Si votre système d'exploitation utilise " SysVinit comme système d'initialisation, exécutez la commande suivante :

  service instana-agent stop
   

Vous pouvez utiliser le gestionnaire de paquets de votre système d'exploitation pour mettre à niveau un paquet d'agents sur votre machine. Pour mettre à jour et gérer les paquets et les correctifs de votre système, exécutez la commande suivante :

yum update // apt-get upgrade
 

Les paquets 'instana-agent-static ou 'instana-agent-dynamic sont mis à jour.

Si votre système d'exploitation utilise 'SysVinit comme système d'initialisation, l'agent hôte recherche les scripts shell correspondants dans le répertoire '/etc/default/Debian et dérivés) ou '/etc/sysconfig/Red Hat et dérivés).

Si le nom du service n'est pas modifié, le script SysVinit extrait le fichier '/etc/default/instana-agent ou le fichier '/etc/sysconfig/instana-agent

Par exemple, dans le fichier « Debian », vous pouvez mettre à jour les variables « Instana » et « PATH » en utilisant /etc/default/instana-agent (lorsque ce fichier est accessible en lecture) :

INSTANA_AGENT_KEY=$agentkey
INSTANA_AGENT_ENDPOINT=$endpoint
INSTANA_AGENT_ENDPOINT_PORT=$endpoint_port
PATH=/usr/local/bin:${PATH}
 

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.

Si votre système d'exploitation utilise " Systemd comme système d'initialisation, vous pouvez définir et remplacer les variables d'environnement à l'aide des options suivantes. La méthode des unités d'insertion est l'approche recommandée parce qu'il n'est pas nécessaire de modifier le fichier des unités de service, alors que les autres méthodes nécessitent des modifications du fichier. Ces modifications peuvent également être supprimées lors des mises à jour. La méthode des unités d'insertion garantit que les modifications et les variables d'environnement définies sont conservées même après les mises à jour.

• Unités de dépôt
• Directives EnvironmentFile
• Paramètres d'environnement globaux

Sur les systèmes basés sur " system.d, le démon " systemd-tmpfiles peut supprimer des fichiers nécessaires à l'agent hôte dans le répertoire " /tmp/.instana, ce qui entraîne des échecs de mise à jour difficiles à résoudre.

Depuis la version 181, les paquets d'agents DEB et RPM installent automatiquement le script de configuration suivant, /usr/lib/tmpfiles.d qui modifie le comportement de l'agent hôte Instana afin de ne pas supprimer les fichiers requis et de ne pas nuire à son fonctionnement.

# Instana files in /tmp cannot be deleted when the agent is running,
# or it may lead to issues on agent update
R! /tmp/.java_pid*
R! /tmp/.instana/*
 

Cette configuration permet tmpdfiles.d de supprimer les fichiers utilisés par l'agent Instana uniquement après le redémarrage de l'hôte. L'agent hôte d' Instana, qui vient d'être lancé, recrée les fichiers au démarrage.

Red Hat Enterprise Linux et CentOS, dans les versions 6 et 7, incluent des règles par défaut " tmpdfiles.d qui suppriment l'ensemble du répertoire " /tmp tous les 10 jours, indépendamment des règles qu'un paquet peut spécifier. Cela signifie qu'un paquet tel que Instana peut définir des règles personnalisées pour contrôler le comportement du système ou du paquet lui-même.

#  This file is part of systemd.
#
#  systemd is free software; you can redistribute it and/or modify it
#  under the terms of the GNU Lesser General Public License as published by
#  the Free Software Foundation; either version 2.1 of the License, or
#  (at your option) any later version.

# See tmpfiles.d(5) for details
# Clear tmp directories separately, to make them easier to override
v /tmp 1777 root root 10d
v /var/tmp 1777 root root 30d

...
 

À moins de modifier les règles par défaut " tmpfiles.d, il n'existe pas de solution connue. La stratégie tmpfiles.d incriminée se trouve dans /usr/lib/tmpfiles.d/tmp.conf.

De nombreux dérivés d' Debian, notamment Ubuntu, intègrent des tmpdfiles.d règles par défaut qui suppriment l'intégralité /tmp du répertoire, quelles que soient les règles qu'un paquet tel que celui de Instana puisse définir. Lors de l'installation, les paquets DEB et RPM exécutent un test pour vérifier le comportement des fichiers temporaires 'tmpfiles.d, en exécutant la commande 'systemd-tmpfiles --remove.

Vous pourriez voir s'afficher l'avertissement suivant sur les systèmes dont les stratégies remplacent le comportement requis spécifié par les paquets de l'agent « Instana » :

WARNING: The tmpfiles.d policies of this system may cause the Instana agent to malfunction by deleting the /tmp/.instana directory; refer https://www.instana.com/docs/setup_and_manage/host_agent/on/linux#tmpfiles.d for more information.
 

Vous pouvez résoudre ce problème en modifiant les politiques par défaut " tmpfiles.d La stratégie tmpfiles.d incriminée se trouve dans /usr/lib/tmpfiles.d/tmp.conf.

Red Hat Enterprise Linux 6 et CentOS 6 incluent l'outil tmpwatch, qui est connu pour supprimer les fichiers inutiles dans le répertoire '/tmp/.instana. Cependant, l'utilisation de tmpwatch dans ces distributions peut occasionnellement causer des problèmes de mise à jour avec l'agent hôte. Pour plus d'informations, voir Suppression des fichiers temporaires.

# Deal with tmpwatch, found in RHEL 6 and CentOS 6.
# It is a cronjob, installed in /etc/cron.d/daily, with pretty much hardcoded
# configurations to wipe data the Instana agent needs.
readonly TMPWATCH_CRONJOB='/etc/cron.d/daily/tmpwatch'
if [ -f "${TMPWATCH_CRONJOB}" ]; then
  # Let's check if we already touched the file and, if not, add our excludes
  if ! grep "${TMPWATCH_CRONJOB}" Instana 2&>1 > /dev/null; then
    echo "tmpwatch discovered in '${TMPWATCH_CRONJOB}': adding the exclude flags for Instana"
    # Edit in place with `sed`
    sed -i '/^flags=/a flags="${flags} -x /tmp/instana -x /tmp/.javapid* # Added by Instana"' "${TMPWATCH_CRONJOB}"
  fi
fi