Ce document explique comment interroger, afficher et analyser des entrées de journal à l'aide de la console Google Cloud. Deux interfaces sont disponibles : l'explorateur de journaux et Log Analytics. Vous pouvez interroger, afficher et analyser les journaux avec les deux interfaces. Toutefois, elles utilisent des langages de requêtes différents et ont des fonctionnalités différentes. Pour résoudre les problèmes et explorer les données de journal, nous vous recommandons d'utiliser l'explorateur de journaux. Pour générer des insights et des tendances, nous vous recommandons utiliser l'Analyse de journaux. Vous pouvez interroger vos journaux et enregistrer vos requêtes en émettant des commandes API Logging. Vous pouvez également interroger vos journaux à l'aide de la Google Cloud CLI.
Explorateur de journaux
L'explorateur de journaux est conçu pour vous aider à dépanner et à analyser les performances de vos services et applications. Par exemple, un histogramme affiche le taux d'erreurs. Si vous constatez une augmentation soudaine du nombre d'erreurs ou un élément intéressant, vous pouvez rechercher et afficher les entrées de journal correspondantes. Lorsqu'une entrée de journal est associée à un error group, l'entrée de journal est annotée d'un d'options permettant d'accéder à plus d'informations sur le groupe d'erreurs.
Le même langage de requête est compatible avec l'API Cloud Logging, la Google Cloud CLI et l'explorateur de journaux. Pour simplifier la construction des requêtes lorsque vous utilisez l'explorateur de journaux, vous pouvez créer des requêtes à l'aide de menus, en saisissant du texte et, dans certains cas, à l'aide des options proposées d'une entrée de journal individuelle.
L'explorateur de journaux n'est pas compatible avec les opérations agrégées, comme compter le nombre d'entrées de journal contenant un modèle spécifique. Pour effectuer des opérations agrégées, activez l'analyse sur le bucket de journaux, puis utilisez dans l'Analyse de journaux.
Pour en savoir plus sur la recherche et l'affichage des journaux avec l'explorateur de journaux, consultez Affichez les journaux à l'aide de l'explorateur de journaux.
Analyse de journaux
L'Analyse de journaux vous permet d'exécuter des requêtes qui analysent les données des journaux. vous pouvez afficher ou présenter sous forme graphique les résultats de la requête. Les graphiques vous permettent d'identifier des tendances et des schémas dans vos journaux au fil du temps. La capture d'écran suivante illustre les fonctionnalités de création de graphiques dans Log Analytics :
Par exemple, supposons que vous résolviez un problème et que vous souhaitiez connaître la latence moyenne des requêtes HTTP envoyées à une URL spécifique au fil du temps. Lorsqu'un bucket de journaux est mis à niveau pour utiliser l'Analyse de journaux, vous pouvez utiliser des requêtes SQL pour interroger les journaux stockés dans votre bucket de journaux. Ces requêtes SQL peuvent également inclure la syntaxe de pipe. En regroupant et en agrégeant vos journaux, vous pouvez mieux les comprendre ce qui peut vous aider à réduire le temps consacré au dépannage.
L'Analyse de journaux vous permet également d'utiliser BigQuery pour interroger vos données. Par exemple, supposons que vous souhaitiez utiliser BigQuery pour comparer les URL de vos journaux à celles d'un ensemble de données public les URL malveillantes connues. Pour rendre les données de vos journaux visibles BigQuery, mettez à niveau votre bucket pour utiliser l'Analyse de journaux, puis Créer un ensemble de données associé
Vous pouvez continuer à résoudre les problèmes et à afficher des entrées de journal individuelles dans les buckets de journaux mis à niveau à l'aide de l'explorateur de journaux.
Restrictions
Pour mettre à niveau un bucket de journaux existant afin d'utiliser l'Analyse de journaux, procédez comme suit : Des restrictions s'appliquent:
- Le bucket de journaux est déverrouillé, sauf s'il est
_Required
. - Aucune mise à jour du bucket n'est en attente.
- Le bucket de journaux est déverrouillé, sauf s'il est
Vous ne pouvez pas désactiver la prise en charge de Log Analytics pour les buckets de journaux mis à niveau pour utiliser Log Analytics.
Seules les entrées de journal écrites après la fin de la mise à niveau sont disponibles pour l'analyse.
Vous ne pouvez pas utiliser la page Log Analytics pour interroger les vues de journaux lorsque des contrôles d'accès au niveau du champ sont configurés pour le bucket de journaux. Toutefois, vous pouvez émettre des requêtes via la page Explorateur de journaux, et vous pouvez interroger une ensemble de données BigQuery associé. Comme BigQuery n'applique pas les contrôles des accès au niveau des champs, si vous interrogez un ensemble de données associé, vous pouvez interroger tous les champs des entrées de journal.
Si vous interrogez plusieurs buckets de journaux configurés avec des Cloud KMS, la requête échoue, sauf si sont remplies:
- Les buckets de journaux se trouvent au même emplacement.
- Un dossier ou une organisation qui est la ressource parente des buckets de journaux est configurée avec une clé par défaut ;
- La clé par défaut se trouve au même emplacement que les buckets de journaux.
Lorsque les contraintes précédentes sont remplies, la bibliothèque Cloud KMS chiffre toutes les données temporaires générées par une requête d'Analyse de journaux.
Tarifs
Cloud Logging ne facture pas l'acheminement des journaux vers une destination compatible. Toutefois, la destination peut appliquer des frais.
À l'exception du bucket de journaux _Required
, Cloud Logging facture le streaming de journaux dans des buckets de journaux et le stockage pendant une durée supérieure à la période de conservation par défaut du bucket de journaux.
Cloud Logging ne facture pas la copie des journaux, la définition des champs d'application des journaux ni les requêtes émises via les pages Explorateur de journaux ou Analyse de journaux.
Pour en savoir plus, consultez les documents suivants :
- Synthèse des tarifs Cloud Logging
Coûts de destination:
- Frais de génération de journaux de flux VPC lorsque vous envoyez les journaux de flux de cloud privé virtuel, puis les excluez de Cloud Logging.
Il n'y a aucun coût d'ingestion ou de stockage BigQuery vous mettez à niveau un bucket pour utiliser l'Analyse de journaux, puis créer un ensemble de données associé ; Lorsque vous créez un ensemble de données associé pour un bucket de journaux, vous n'ingérez pas vos données de journal dans BigQuery. Vous bénéficiez plutôt d'un accès en lecture aux données de journal stockées dans votre bucket de journaux via l'ensemble de données associé.
Des frais d'analyse BigQuery s'appliquent lorsque vous exécutez des requêtes SQL sur des ensembles de données associés BigQuery, y compris lorsque vous utilisez la page BigQuery Studio, l'API BigQuery et l'outil de ligne de commande BigQuery.
Blogs
Pour en savoir plus sur l'Analyse de journaux, consultez les articles de blog suivants:
- Pour en savoir plus sur l'Analyse de journaux, consultez L'Analyse de journaux dans Cloud Logging est désormais accessible à tous.
- Pour découvrir comment créer des graphiques générés par les requêtes de l'Analyse de journaux et l'enregistrement de ces graphiques dans des tableaux de bord personnalisés, Lancement des graphiques et tableaux de bord de l'Analyse de journaux dans Cloud Logging version Preview publique.
- Pour en savoir plus sur l'analyse des journaux d'audit à l'aide de l'Analyse de journaux, consultez Obtenir des insights sur la sécurité provenant de journaux d'audit grâce à l'Analyse de journaux.
- Si vous acheminez des journaux vers BigQuery et que vous souhaitez comprendre la différence entre cette solution et l'utilisation de l'Analyse de journaux, consultez Passer à l'Analyse de journaux pour les utilisateurs de l'exportation BigQuery.
Étape suivante
- Créer un bucket de journaux et le mettre à niveau pour utiliser l'Analyse de journaux
- Mettre à niveau un bucket existant pour utiliser l'Analyse de journaux
Interrogez et affichez les journaux:
Exemples de requêtes: