Cette page a été traduite par l'API Cloud Translation.
Switch to English

Entrées de journal des flux continus et en flux continu

Présentation

Cette page explique comment afficher les entrées de journal en temps réel.

Cloud Logging vous permet d'afficher vos entrées de journal en temps réel à mesure que Logging les écrit à l'aide des fonctionnalités suivantes:

Journaux de flux. Les journaux de streaming sont disponibles dans l'explorateur de journaux.

Diffusion en direct. La diffusion en directgcloud outil de ligne de commande gcloud alpha logging tail et en tant que méthode de l'API Cloud Logging.entries.tail pour consulter nos règles en matière de publicité.

Lorsque vous affichez et analysez vos journaux à l'aide de l'explorateur de journaux, de gcloud logging read ou de la méthode API entries.list, vous affichez entrées de journal déjà stockées par Cloud Logging En revanche, lorsque vous diffusez des entrées de journal en direct ou des flux en direct, les entrées de journal s'affichent dès que vos applications les écrivent dans l'API Cloud Logging.

Diffuser des journaux dans l'explorateur de journaux

Dans l'explorateur de journaux, vous pouvez afficher les données des journaux en temps réel à l'aide des journaux de flux. Lorsque vous utilisez des journaux de flux, vous pouvez ajouter une requête à l'explorateur de journaux pour ne diffuser que les journaux correspondant à la requête.

Pour diffuser des journaux en fonction d'une requête, ajoutez une requête au volet Outil de création de requêtes, puis sélectionnez Journaux de flux. Lorsque Logging écrit les données des journaux, seuls les journaux correspondant à la requête sont affichés dans le volet Query result (Résultat de la requête). Si la requête n'est pas fournie, Logging affiche chaque journal tel qu'il est écrit.

Diffuser les journaux correspondant à une expression de requête

Pour arrêter la diffusion, cliquez sur Arrêter le streaming ou faites défiler le volet Résultats de la requête.

En queue à l'aide de l'outil de ligne de commande gcloud

Cette fonctionnalité vous permet d'afficher vos entrées de journal en temps réel à mesure que Cloud Logging les écrit, à l'aide de l'outil de ligne de commande gcloud ou de l'API Cloud Logging.

Pour plus d'informations sur la méthode API pour la queue de queue, consultez la méthode entries.tail.

Installer gcloud alpha logging tail

Pour utiliser gcloud alpha logging tail, Python 3 et le package Python grpcio doivent être installés.

Pour savoir comment installer Python, consultez la page Python. Pour savoir comment installer le gestionnaire de packages Python, pip, nécessaire à l'installation du package grpcio, consultez la page Installer le package Python.

Pour installer gcloud alpha logging tail, procédez comme suit:

  1. Vérifiez que l'outil de ligne de commande gcloud est installé. Pour savoir comment installer l'outil de ligne de commande gcloud, consultez la page Installer le SDK Cloud.

  2. Vérifiez que vous utilisez la version 302.0.0 ou ultérieure de l'outil gcloud.

    gcloud version
    

    Pour obtenir des instructions sur la mise à jour de l'outil gcloud, consultez la section gcloud components update.

  3. Installez les composants alpha de l'outil gcloud:

    gcloud components install alpha
    
  4. Pour les utilisateurs de macOS, Linux et Cloud Shell:

    1. Installez les bibliothèques clientes gRPC:

       sudo pip3 install grpcio
      
    2. Définissez la variable d'environnement CLOUDSDK_PYTHON_SITEPACKAGES sur n'importe quelle valeur:

       export CLOUDSDK_PYTHON_SITEPACKAGES=1
      
  5. Exécutez les commandes suivantes pour définir votre ID de projet Cloud et pour vous authentifier:

    gcloud config set project PROJECT_ID
    gcloud auth login
    
  6. Vérifiez que gcloud alpha logging tail est installé en exécutant la commande suivante:

    gcloud alpha logging tail
    

    Vous visualisez maintenant les entrées de journal de votre projet à mesure que Logging les écrit.

    Entrées de journal lors d'une session en périphérie.

Pour en savoir plus sur l'utilisation de la queue en direct, consultez le guide de référence gcloud alpha logging tail.

Mise en mémoire tampon et classement

Comme Logging peut recevoir des entrées de journal dans l'ordre chronologique, la queue en direct fournit un paramètre de fenêtre de tampon pour vous permettre d'équilibrer le compromis entre l'affichage des entrées de journal au cours de leur écriture et leur affichage par ordre croissant pour consulter nos règles en matière de publicité. Vous pouvez définir la fenêtre de tampon comprise entre 0 et 60 secondes.

Notez les caractéristiques suivantes de la fenêtre tampon:

  • La fenêtre de tampon par défaut est de deux secondes.

  • Logging retarde l'ingestion des entrées de journal pendant toute la durée de la fenêtre de tampon.

  • Si une entrée de journal est écrite en dehors de la fenêtre de tampon, Logging renvoie les entrées de journal à mesure de leur réception.

Lors de la configuration de la fenêtre de tampon, vous faites un compromis entre l'affichage des journaux lors de leur ingestion et l'affichage des entrées dans le désordre.

Fenêtre de tampon Compromis
0 secondes Entrées les plus récentes affichées, mais avec une probabilité plus probable d'être dans le désordre.
60 secondes Un délai de 60 secondes avant de voir les entrées renvoyées, mais la plupart des journaux sont renvoyés par ordre croissant.

Limites et quotas

Le tableau suivant répertorie les limites et les quotas pour le fenêtrage à chaud:

Limites et quotas Valeur
Entrées renvoyées par minute 60 000
Lorsque plus de 60 000 entrées correspondent à un filtre, Logging les supprime et renvoie le nombre d'entrées supprimées dans la réponse.
Sessions d'affichage des dernières lignes en direct par projet Cloud 10

Limites des clients

Pour un projet Cloud qui écrit de nombreuses entrées rapidement, votre client peut ne pas être en mesure de les consommer aussi rapidement qu'ils sont en cours d'écriture. Dans ce cas, Logging limite le nombre total d'entrées envoyées, en donnant la priorité aux entrées les plus récentes. À la fin de la session de queue, Logging renvoie le nombre d'entrées qui n'ont pas été affichées en raison des limites du client.