Ce guide fournit des informations de base sur l'agent Logging, une application basée sur fluentd qui s'exécute sur vos instances de machine virtuelle (VM).
Dans sa configuration par défaut, l'agent Logging transmet les journaux des applications tierces courantes et des logiciels système à Logging. Consultez la liste des journaux par défaut. Vous pouvez configurer l'agent pour diffuser des journaux supplémentaires. Pour plus d'informations sur la configuration et le fonctionnement de l'agent, consultez la page Configurer l'agent Logging.
Il est recommandé d'exécuter l'agent Logging sur toutes vos instances de VM. Il s'exécute sous Linux et Windows.
Pour installer l'agent Logging, consultez la page Installer l'agent Logging.
Systèmes d'exploitation compatibles
L'agent Logging accepte les systèmes d'exploitation suivants sur les instances de VM compatibles :
- CentOS 7 et 8
- Rocky Linux 8
- Red Hat Enterprise Linux 7 et 8
- Debian 9" "Stretch", 10 "Buster" et 11 "Bullseye"
- Ubuntu LTS 20.04 (Focal Fossa)
- Ubuntu Minimal LTS 20.04 (Focal Fossa)
- SUSE Linux Enterprise Server 12 et 12 SP5 pour SAP
- SUSE Linux Enterprise Server 15, 15 SP2 pour SAP, 15 S3 pour SAP, 15 SP4 pour SAP et 15 SP5 pour SAP
- OpenSUSE Leap 15, 15.2, 15.3 et 15.4
- Windows Server 2016 et 2019
- Windows Server Core 2016 et 2019
- AMI Linux Amazon (sauf AMI Linux Amazon 2.0)
Si vous exécutez des VM Container-Optimized OS, suivez les instructions de Container-Optimized OS pour collecter les journaux à partir de vos VM.
Environnements compatibles
L'agent Logging est compatible avec les environnements suivants :
Instances Compute Engine. L'agent Logging envoie les journaux au projet associé à chaque instance de VM.
Pour les instances sans adresses IP externes, vous devez activer l'accès privé à Google pour permettre à l'agent Logging d'envoyer des journaux.
Instances Amazon Elastic Compute Cloud (Amazon EC2). L'agent Logging envoie les journaux d'AWS à un projet Google Cloud.
Pour que l'agent Logging fonctionne correctement, l'instance Amazon EC2 sur laquelle il s'exécute doit pouvoir communiquer avec les API Google Cloud, en particulier l'API Logging. Cela nécessite une adresse IP externe ou une passerelle Internet VPC.
Pour ces instances de VM, une mémoire résidente minimale de 250 Mio (RSS) est nécessaire pour exécuter l'agent Logging, mais il est recommandé de disposer de 1 Gio. À titre d'exemple, à raison de 100 entrées de journal de 1 Ko par seconde, l'agent Logging avec les configurations par défaut consomme 5 % du processeur sur un cœur et 150 Mio de mémoire.
Les instances de VM suivantes acceptent Logging via leur propre logiciel. Il est donc possible d'installer manuellement l'agent Logging sur ces instances :
Instances de l'environnement standard App Engine. App Engine intègre la compatibilité avec Logging. Pour en savoir plus, consultez la section Écrire des journaux d'application.
Instances de l'environnement flexible App Engine. Les applications exécutées dans l'environnement flexible App Engine peuvent écrire des journaux en plus de ceux inclus dans l'environnement standard App Engine. Pour en savoir plus, consultez la section Écrire des journaux d'application.
Instances de nœud Google Kubernetes Engine. La collecte de journaux avec Logging est activée par défaut pour les nouveaux clusters de conteneurs. Vous pouvez également l'activer pour vos clusters existants. Pour plus d'informations, consultez la page Configurer la journalisation et la surveillance pour GKE.
Pour les instances exécutées sur Google Distributed Cloud, l'agent collecte les journaux système, mais pas les journaux d'application.
Instances de conteneur Cloud Run. Cloud Run intègre la compatibilité avec Logging. Pour plus d'informations, accédez à la section Journaliser et afficher des journaux.
Fonctions HTTP et fonctions d'arrière-plan de fonctions Cloud Run. Cloud Run Functions intègre la compatibilité avec Logging. Pour plus d'informations, accédez à la section Écrire, afficher des journaux et y répondre.
Compatibilité avec les clouds hybrides et sur site
Google Cloud s'est associé à observIQ pour fournir des services de journalisation sur les plates-formes cloud hybrides et sur site de manière cohérente et prévisible. BindPlane vous permet de collecter vos propres données et de les envoyer à Logging pour analyse. BindPlane s'intègre à Cloud Logging afin de capturer les données de votre infrastructure. Il est inclus dans votre projet, sans frais supplémentaires.
Pour en savoir plus sur observIQ et BindPlane, consultez la page À propos d'observIQ et de BindPlane.
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 anciennes versions 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 Logging :
logging.googleapis.com
L'installation de l'agent requiert l'accès aux noms DNS suivants :
(Linux) Dépôt de packages Google Cloud :
packages.cloud.google.com
Serveur de téléchargement Google :
dl.google.com
Code source de l'agent Logging
Les informations de cette section vous sont utiles si vous souhaitez comprendre le code source de l'agent ou si vous avez d'autres besoins particuliers. L'agent Logging est installé par le script décrit dans les instructions d'installation.
L'agent Logging google-fluentd
est une version modifiée du collecteur de données de journal fluentd.
google-fluentd
est distribué en deux packages distincts. Le code source est disponible sur les dépôts GitHub associés :
- Dépôt GitHub nommé
google-fluentd
, qui inclut le programme principalfluentd
, les scripts des packages personnalisés et le plug-in de sortie pour l'API Cloud Logging.- Le plug-in de sortie est empaqueté en tant que gem Ruby. Il est inclus dans le package
google-fluentd
. Il est également disponible séparément sur le service d'hébergement gem Ruby sur fluent-plugin-google-cloud. - Le contenu associé au programme d'installation Windows se trouve dans le dossier windows-installer.
- Le plug-in de sortie est empaqueté en tant que gem Ruby. Il est inclus dans le package
- Dépôt GitHub nommé
google-fluentd-catch-all-config
, qui inclut les fichiers de configuration de l'agent Logging pour l'ingestion des journaux à partir de différents packages de logiciels tiers.
Notes de version de l'agent Logging
Les notes de version du package Linux
google-fluentd
sont disponibles à l'emplacementgoogle-fluentd/releases
, où les tags de version respectent le format sémantique suivant :[Major].[Minor].[Patch]
.Les notes de version pour les programmes d'installation Windows se trouvent au même emplacement :
google-fluentd/releases
. Toutefois, les tags de version Windows comportent le préfixeWindows
.Les notes de version du gem autonome
fluent-plugin-google-cloud
sont disponibles à l'emplacementfluent-plugin-google-cloud/releases
, où les tags de version respectent le format sémantique suivant :[Major].[Minor].[Patch]
.
Règlement d'obsolescence
L'agent Logging est soumis au règlement relatif aux abandons des agents de Google Cloud Observability.
Étapes suivantes
Après avoir installé l'agent, affichez vos journaux dans l'explorateur de journaux.