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 et de récepteurs de journaux, ces limites sont fixes. Vous ne pouvez pas les augmenter ni les diminuer.
Catégorie | Valeur maximale |
---|---|
Taille d'une entrée de journal | 256 Ko1 |
Taille d'une entrée de journal d'audit | 512 Kio |
Nombre d'étiquettes | 64 par entrée de journal |
Longueur d'une clé de libellé d'entrée de journal | 512 B2 |
Longueur d'une valeur de libellé d'entrée de journal | 64 Ko2 |
Longueur d'une requête | 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 |
Code temporel le plus ancien pouvant être stocké dans des buckets de journaux6 | 30 derniers jours |
Code temporel futur pouvant être stocké dans des buckets de journaux6 | Jusqu'à un jour dans le futur |
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. Elle n'est pas hiérarchique. Par exemple, si une organisation possède plusieurs projets Google Cloud, 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 l'horodatage est situé en dehors de ces limites sont refusées des buckets de journaux. L'API Logging accepte les entrées ayant des horodatages plus anciens. Ces entrées peuvent être acheminées vers des destinations de récepteur, mais pas stockées dans le stockage de journaux. L'API Logging rejette les entrées dont l'horodatage se situe dans plus d'un jour et renvoie une erreur INVALID_ARGUMENT
.
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. Cliquez sur une API et sélectionnez Quotas. |
Durée de vie des jetons de page de l'API | 24 heures |
Nombre de sessions ouvertes de tailing en direct | 10 par projet Google Cloud3 |
Nombre d'entrées renvoyées en temps réel | 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.write 4 |
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 ressources 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 | 1 Go par seconde 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. Elle n'est pas hiérarchique.
4 Le champ logName
d'une entrée de journal spécifie le nom de ressource de l'entrée de journal.
5 Le quota quotidien de requêtes de contrôle s'applique aux requêtes API pour la création et la mise à jour d'exclusions et de récepteurs. Le quota de requêtes de contrôle par minute s'applique à tout ce qui est également inclus dans le quota quotidien de requêtes de contrôle, ainsi qu'aux requêtes API pour la suppression de journaux et la gestion des 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 de résumé 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 baisse des limites de l'API Logging à l'aide de la console Google Cloud:
Sur la page Quotas, cochez les cases pour sélectionner API Cloud Logging, puis cliquez sur Modifier 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.Dans le panneau Modifications des quotas, sélectionnez le service pour développer la vue associée, puis renseignez les champs Nouvelle limite et Description de la requête. Cliquez sur Suivant.
Remplissez le formulaire dans le panneau Coordonnées.
Cliquez sur Envoyer la requête.
Pour en savoir plus, consultez la page Utiliser des quotas.
Optimiser l'utilisation de entries.list
L'utilisation attendue de entries.list
est la recherche de journaux correspondants. Cette méthode n'est pas destinée à la récupération de grands volumes d'entrées de journaux. Si vous atteignez 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 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 les entrées de journal en dehors de Logging, vous pouvez copier de manière rétroactive les entrées de journal qui existent déjà dans Logging vers les 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 Logging, créez ou mettez à niveau un bucket de journaux afin d'utiliser l'Analyse de journaux. L'Analyse de journaux vous permet d'interroger vos entrées de journal à l'aide du SQL standard 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 d'un filtre | 20 000 caractères |
Longueur des descripteurs de métrique | 8 000 B |
Nombre de descripteurs de métriques | 500 par projet Google Cloud2 |
Nombre de séries temporelles actives1 | 30 000 par métrique |
Nombre de buckets d'histogramme | 200 par métrique de distribution personnalisée |
Conservation des données | Consultez la page Cloud Monitoring: conservation des données. |
1 Une 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.
2 Cette limite s'applique également aux comptes de facturation, aux dossiers et aux organisations. Elle n'est pas hiérarchique.
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 de journaux | 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.