Présentation de l'agent Monitoring

L'agent Monitoring est un daemon basé sur collectd, qui collecte des métriques du système et des applications à partir d'instances de machines virtuelles, puis les envoie à Monitoring. Par défaut, il collecte des métriques de disque, de CPU, de réseau et de processus. Vous pouvez le configurer pour surveiller des applications tierces afin d'obtenir la liste complète des métriques de l'agent.

Pour installer l'agent, consultez la page Installer l'agent de surveillance.

Objectif

L'utilisation de l'agent Monitoring n'est pas obligatoire, mais recommandée. Monitoring peut accéder sans cet agent à certaines métriques d'instance telles que celles relatives à l'utilisation du processeur, au trafic de disque, au trafic réseau et aux informations de temps d'activité. Monitoring utilise l'agent Monitoring pour accéder à des ressources système et à des services d'application supplémentaires dans des instances de machines virtuelles (VM). Pour utiliser ces fonctionnalités supplémentaires, vous devez installer l'agent Monitoring.

Une fois que vous avez installé l'agent Monitoring, vous pouvez surveiller les applications tierces compatibles en ajoutant des configurations collectd correspondantes. Pour plus de détails, consultez la page Surveiller des applications tierces.

Pour obtenir la liste complète des métriques intégrées que vous pouvez obtenir avec l'agent Monitoring, consultez Métriques de l'agent.

Pour envoyer des métriques personnalisées à Monitoring à l'aide de l'agent, consultez la page Surveiller des applications personnalisées. Si vous avez accès au code source de votre application, il peut être plus pratique de l'instrumenter avec OpenTelemetry. Pour en savoir plus sur l'instrumentation, consultez la section Instrumentation et observabilité.

Configurations compatibles

L'agent de surveillance est compatible avec les environnements suivants.

Instances de machines virtuelles

Vous pouvez installer l'agent Monitoring sur les types d'instances de VM suivants :

  • Instances Compute Engine. L'agent Monitoring envoie des informations de surveillance au projet associé à chaque instance.

    Pour les instances sans adresse IP externe, vous devez activer l'accès privé à Google pour permettre à l'agent Monitoring d'envoyer des métriques.

    Pour créer une instance Compute Engine, consultez le Guide de démarrage de Compute Engine.

  • Instances Amazon Elastic Compute Cloud (Amazon EC2).

    L'agent Monitoring envoie des informations de surveillance depuis AWS vers un projet Google Cloud.

    Pour que l'agent Monitoring fonctionne correctement, l'instance Amazon EC2 sur laquelle il s'exécute doit pouvoir communiquer avec les API Google Cloud, en particulier avec l'API Monitoring. Cela nécessite une adresse IP externe ou une passerelle NAT.

    Pour créer une instance Amazon EC2, consultez le Guide de démarrage d'Amazon EC2.

Les types d'instances de VM suivants font partie de services gérés qui mettent en œuvre la compatibilité Monitoring de façon spécifique aux services. N'essayez pas d'installer ou de configurer manuellement l'agent Monitoring sur ceux-ci :

  • L'environnement standard App Engine offre une compatibilité intégrée avec Monitoring. Les agents ne sont pas nécessaires.
  • Les instances de l'environnement flexible App Engine comportent des agents préinstallés avec des configurations spécifiques au service.
  • Les instances Dataflow comportent des agents Monitoring préinstallés avec des configurations spécifiques au service.
  • Les instances Dataproc antérieures à la version 2.2 de l'image disposent d'agents Monitoring préinstallés à des configurations spécifiques au service.

    Vous pouvez installer l' agent Ops sur les clusters Dataproc qui utilisent une version d'image 2.2 ou ultérieure pour collecter les journaux syslog et les métriques d'hôte. Pour en savoir plus, consultez la page Versions Dataproc 2.2.x.

  • Instances de nœud Google Kubernetes Engine.

Systèmes d'exploitation

L'agent Monitoring accepte les systèmes d'exploitation suivants sur des instances de VM compatibles :

Systèmes d'exploitation Linux

L'agent Monitoring prend en charge les systèmes d'exploitation Linux suivants :

  • Amazon Linux AMI
  • CentOS 7
  • CentOS 8
  • Rocky Linux 8
  • RHEL 7 : rhel-7, rhel-7-6-sap-ha, rhel-7-7-sap-ha
  • RHEL 8 : rhel-8, rhel-8-4-sap-ha, rhel-8-6-sap-ha, rhel-8-8-sap-ha
  • Debian 9 (Stretch)
  • Debian 10 (Buster)
  • Debian 11 (BullsEye)
  • SLES 12 : sles-12, sles-12-sp5-sap
  • SLES 15 : sles-15, sles-15-sp2-sap, sles-15-sp3-sap, sles-15-sp4-sap, sles-15-sp5-sap
  • OpenSUSE Leap 15 : opensuse-leap (opensuse-leap-15-3-*, opensuse-leap-15-4-*)
  • Ubuntu 20.04 LTS (Focal Fossa) : ubuntu-2004-lts, ubuntu-minimal-2004-lts

L'agent Monitoring n'est actuellement pas compatible avec le système d'exploitation Container-Optimized qui est utilisé par défaut dans les clusters Google Kubernetes Engine.

Systèmes d'exploitation Windows :

Toutes les versions de l'agent Monitoring sont compatibles avec les systèmes d'exploitation Windows suivants :

  • Windows Server 2019
  • Windows Server Core 2019
  • Windows Server 2016
  • Windows Server Core 2016

L'agent Monitoring ne prend actuellement pas en charge Windows Server Core 2019 pour les conteneurs.

Applications acceptées

Vous pouvez configurer Monitoring pour surveiller diverses applications logicielles Open Source courantes. La configuration n'est possible que pour les agents exécutés sur Linux. Les agents s'exécutant sur Windows peuvent surveiller les applications IIS et MS SQL, mais ne peuvent pas être configurés pour d'autres applications.

Pour en savoir plus, consultez la page Surveiller des applications tierces.

Accès requis par l'agent

L'exécution de l'agent requiert l'accès aux noms de DNS suivants :

  • Serveur de jetons OAuth2 : oauth2.googleapis.com

    Les versions antérieures de l'agent peuvent nécessiter l'accès à www.googleapis.com (URL complète : https://www.googleapis.com/oauth2/v3/token).

    Si vous utilisez une ancienne version de l'agent, il est recommandé de mettre à niveau votre agent vers la version la plus récente.

  • API Monitoring : monitoring.googleapis.com

L'installation de l'agent requiert l'accès aux noms de DNS suivants :

  • (Linux) Dépôt de packages Google Cloud : packages.cloud.google.com

  • (Linux) Google télécharge le sous-domaine : dl.google.com.

  • (Windows) Ancien serveur de téléchargement Stackdriver : repo.stackdriver.com

Obtenir le code source de l'agent Monitoring

Le code source de l'agent Monitoring est disponible uniquement pour l'agent Monitoring hébergé sur Linux. L'agent Monitoring hébergé sur Windows n'est pas open source.

L'agent Monitoring est installé par un script décrit dans les instructions d'installation. Vous pouvez ignorer cette section si vous souhaitez uniquement installer et utiliser l'agent. Si vous souhaitez comprendre le code source, lisez cette section.

L'agent Monitoring (stackdriver-agent) repose sur le daemon de collecte de statistiques système collectd d'origine. Le code source stackdriver-agent est disponible sur Stackdriver/collectd. Les scripts de compilation et de packaging de l'agent Monitoring sont disponibles sur Stackdriver/agent-packaging. Les fichiers de configuration des applications tierces se trouvent dans le dépôt de configuration GitHub de l'agent.

Le package logiciel pour stackdriver-agent contient :

  • le démon collectd ;
  • Les bibliothèques partagées du plug-in, y compris le plug-in de sortie de l'API Cloud Monitoring.
  • les fichiers de configuration de niveau supérieur de l'agent Monitoring.

Règlement d'obsolescence

L'agent Monitoring est soumis au Règlement d'obsolescence des agents.

Pour obtenir des informations sur l'abandon des anciennes fonctionnalités et versions, consultez la page sur les abandons liés à Google Cloud Observability.

Étapes suivantes

  • Consultez Démarrage rapide pour surveiller une instance de machine virtuelle exécutant un serveur Web Apache. Le guide de démarrage rapide inclut l'installation de l'agent.
  • Consultez la section Installer l'agent Monitoring pour installer l'agent sur des instances de VM Compute Engine ou Amazon EC2.