Quotas et limites

Cette page fournit des informations sur les limites d'utilisation de Cloud Logging.

Limites d'utilisation pour Logging

Les limites suivantes s'appliquent à l'utilisation de Cloud Logging. À l'exception des limites concernant le nombre de buckets de journaux et de sinks, ces limites sont fixes. Vous ne pouvez pas les augmenter ni les diminuer.

Catégorie Valeur maximale
Taille d'un LogEntry 256 Ko1
Taille d'une entrée de journal d'audit 512 Kio
Nombre d'étiquettes 64 par LogEntry
Longueur d'une clé de libellé LogEntry 512 B2
Longueur d'une valeur de libellé LogEntry 64 Ko2
Longueur d'une requête Logging query language 20 000 caractères
Distribution ramifiée des requêtes4 200 buckets
Nombre de récepteurs 200 par projet Google Cloud3
Longueur d'un filtre d'inclusion de récepteur 20 000 caractères
Longueur d'un filtre d'exclusion de récepteur 20 000 caractères
Nombre de filtres d'exclusion 50 par récepteur
Nombre de buckets de journaux 100 par projet Google Cloud3,4,5
Nombre de champs indexés personnalisés 20 par bucket de journaux
Nombre de vues de journaux 30 par bucket de journaux
Horodatage le plus ancien pouvant être stocké dans les buckets de journaux6 30 jours en arrière
Code temporel futur pouvant être stocké dans des buckets de journaux6 Jusqu'à 1 jour à l'avance
Nombre de champs d'application des journaux par ressource7 100
Nombre de vues de journaux et de projets inclus dans un champ d'application des journaux7 100
Nombre de projets inclus dans un champ d'application de journal7 5

1 Cette limite approximative est basée sur des tailles de données internes et non sur la taille réelle de la requête de l'API REST.

2 Cloud Logging tronque les clés et valeurs de libellés surdimensionnées lorsque l'entrée de journal associée est écrite.

3 Cette limite s'applique également aux comptes de facturation, aux dossiers et aux organisations, et n'est pas hiérarchique. Par exemple, si vous avez plusieurs projets Google Cloud dans une organisation, vous pouvez configurer jusqu'à 200 récepteurs pour chaque projet Google Cloud. Pour cette même organisation, vous pouvez également configurer jusqu'à 200 récepteurs au niveau de l'organisation.

4 Cette limite correspond au nombre maximal de buckets pouvant contenir des entrées de journal pour une ressource. Pour en savoir plus, consultez la section La requête renvoie une erreur.

5 Cette limite inclut les buckets en attente de suppression.

6 Les entrées de journal dont les codes temporels dépassent ces limites sont rejetées des buckets de journaux. L'API Logging accepte les entrées avec des horodatages plus anciens. Ces entrées peuvent être acheminées vers des destinations de récepteur, mais pas stockées dans l'espace de stockage des journaux. L'API Logging rejette les entrées dont les codes temporels sont situés plus d'un jour dans le futur et renvoie une erreur INVALID_ARGUMENT.

7 Les portées de journalisation sont disponibles en version Preview publique.

Quotas et limites des API Logging

Les limites suivantes s'appliquent à votre utilisation de l'API Logging. Vous pouvez demander des modifications de vos quotas et limites de l'API Logging. Pour obtenir des instructions, consultez la section Demander des modifications de quota pour l'API Cloud Logging sur cette page.

Catégorie Valeur maximale
Utilisation de l'API Pour afficher vos quotas, accédez au tableau de bord des API, sélectionnez une API, puis Quotas.
Durée de vie des jetons de page de l'API 24 heures
Nombre de sessions d'affichage des dernières lignes en direct ouvertes 10 par projet Google Cloud3
Nombre d'entrées d'affichage des dernières lignes en direct renvoyées 60 000 par minute
Nombre de champs restreints 20 par bucket
Taille d'un champ restreint 800 B
Taille d'une requête entries.write 10 Mo
Nombre de requêtes entries.write 120 000 par minute et par projet Google Cloud1, 3
Nombre de requêtes entries.list 60 par minute et par projet Google Cloud2, 3
Nombre de noms de ressources différents dans une seule commande entries.write4
 1000
Requêtes de contrôle5 par minute 600
Requêtes de contrôle5 par jour 1 000 par projet Google Cloud
Nombre de projets Google Cloud ou d'autres noms de ressource dans une
seule requête entries.list		 100
Nombre d'opérations de copie simultanées 1 par projet Google Cloud3
Taux d'exportations vers un sujet Pub/Sub6 60 Go par minute et par projet Google Cloud

1 L'utilisation de filtres d'exclusion ne réduit pas ce nombre, car les journaux sont exclus après l'envoi de la requête entries.write.

2 Cette valeur est le paramètre par défaut.

3 Cette limite s'applique également aux comptes de facturation, aux dossiers et aux organisations, et n'est pas hiérarchique.

4 Le champ logName d'une entrée de journal spécifie le nom de la ressource de l'entrée de journal.

5 Le quota de requêtes de contrôle quotidien s'applique aux requêtes API pour créer et mettre à jour des exclusions et des sinks. Le quota de requêtes de contrôle par minute s'applique à tout ce qui est également inclus dans le quota de requêtes de contrôle quotidien, ainsi qu'aux requêtes d'API pour supprimer des journaux et gérer les métriques basées sur les journaux.

6 Si le taux d'exportations dépasse le quota, l'erreur est enregistrée dans une entrée de journal. Le champ "Summary" (Récapitulatif) indique une erreur de configuration du récepteur, et le code d'erreur est topic_over_quota.

Demander une modification de quota pour l'API Cloud Logging

Vous pouvez demander une augmentation ou une diminution des limites de l'API Logging à l'aide de la console Google Cloud. Pour en savoir plus, consultez la page Afficher et gérer les quotas.

Si vous obtenez une erreur Edit is not allowed for this quota, vous pouvez contacter l'assistance pour demander des modifications du quota. Notez également que la facturation doit être activée sur le projet Google Cloud pour que vous puissiez cocher les cases.

Optimiser l'utilisation de entries.list

L'utilisation attendue de entries.list est de rechercher des journaux correspondants. Cette méthode n'est pas destinée à récupérer un grand nombre d'entrées de journal. Si vous épuisez régulièrement votre quota entries.list, envisagez les options suivantes:

  • Assurez-vous d'utiliser efficacement l'API Cloud Logging. Pour en savoir plus, consultez la section Optimiser l'utilisation de l'API.

  • Si vous savez à l'avance que les entrées de journal que vous souhaitez analyser dépassent le quota entries.list, configurez un récepteur de journaux pour exporter vos journaux vers une destination compatible.

  • Pour analyser des entrées de journal en dehors de Logging, vous pouvez copier rétroactivement des entrées de journal déjà existantes dans Logging vers des buckets Cloud Storage. Lorsque vous copiez des journaux dans un bucket Cloud Storage, vous pouvez partager des entrées de journal avec des auditeurs en dehors de Logging et exécuter des scripts dans Cloud Storage.

  • Pour agréger et analyser vos entrées de journal dans la journalisation, stockez-les dans un bucket de journaux, puis mettez à niveau ce bucket pour utiliser l'Analyse de journaux. Pour en savoir plus sur ces étapes, consultez la section Configurer les buckets de journaux.

    L'Analyse de journaux vous permet d'interroger vos entrées de journal à l'aide du SQL standard de BigQuery.

Métriques basées sur les journaux

Les limites suivantes s'appliquent à votre utilisation des métriques basées sur les journaux définies par l'utilisateur. À l'exception du nombre de descripteurs de métrique, ces limites sont fixes. Vous ne pouvez pas les augmenter ni les diminuer.

Catégorie Valeur maximale
Nombre de libellés 10 par métrique
Longueur de la valeur d'un libellé 1,024 B
Longueur de la description d'un libellé 800 B
Longueur du filtre1 20 000 caractères
Longueur des descripteurs de métrique 8 000 B
Nombre de descripteurs de métrique 500 $ par projet Google Cloud2
Nombre de séries temporelles actives3 30 000 par métrique
Nombre de buckets d'histogramme 200 par métrique de distribution personnalisée
Conservation des données Consultez Cloud Monitoring: conservation des données.

1 Chaque métrique basée sur les journaux contient un filtre. Lorsqu'une entrée de journal correspond au filtre, elle est comptabilisée. Les filtres sont définis à l'aide du langage de requête Logging.

2 Cette limite s'applique également aux comptes de facturation, aux dossiers et aux organisations, et n'est pas hiérarchique.

3Une série temporelle est considérée comme active si vous y avez ajouté des points de données au cours des dernières 24 heures.

Journaux d'audit

Les tailles maximales des journaux d'audit sont indiquées dans le tableau suivant. Ces valeurs peuvent vous aider à estimer l'espace dont vous avez besoin dans vos destinations de sink.

Type de journal d'audit Taille maximale
Activité d'administration 512 Kio
Accès aux données 512 Kio
#system-event 512 Kio
Refus de règles 512 Kio

Durée de conservation des journaux

Les durées de conservation Cloud Logging suivantes s'appliquent aux buckets de journaux, quels que soient les types de journaux inclus dans le bucket ou leur copie depuis un autre emplacement. Les informations de conservation sont les suivantes :

Bucket Durée de conservation par défaut Conservation personnalisée
_Required 400 jours Non configurable
_Default 30 jours Configurable
Défini par l'utilisateur 30 jours Configurable

Pour les buckets de journaux _Default et ceux définis par l'utilisateur, vous pouvez configurer Cloud Logging de sorte qu'ils soient conservés entre 1 et 3 650 jours. Pour en savoir plus sur la définition des règles de conservation, consultez la page Configurer la conservation personnalisée.

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 :