Quotas et limites

Cloud Trace applique deux types de quotas différents : un quota de débit sur les requêtes API et un quota d'ingestion sur les délais envoyés à Trace.

Quotas Trace

Le tableau suivant récapitule les unités de quota disponibles pour les opérations de lecture et d'écriture, ainsi que le quota quotidien d'ingestion de délais. Par exemple, vous disposez d'un total de 300 commandes toutes les 60 secondes pour les trois commandes d'API GetTrace, ListTraces et ListSpan. Voici deux exemples d'utilisation de toutes vos unités de quota disponibles :

  • Effectuer 12 appels d'API avec la méthode ListTraces toutes les 60 secondes
  • Effectuer 10 appels d'API avec la méthode ListTraces et 50 appels d'API avec la méthode GetTrace toutes les 60 secondes
Catégorie Unités de quota totales
Opérations de lecture1 300 par période de 60 secondes
Opérations d'écriture2 4 800 par période de 60 secondes
Segments ingérés3 3 000 000 à 5 000 000 000 par jour

1 Les opérations de lecture incluent GetTrace, ListTraces et ListSpan. Un appel à ListTraces consomme 25 unités de quota. Les appels à GetTrace consomment ListSpan 1 unité de quota.
2 Les opérations d'écriture incluent PatchTraces, BatchWrite et CreateSpan. Chaque opération d'écriture consomme une unité de quota.
3 Votre quota quotidien d'ingestion de délais de trace est déterminé par l'historique de votre compte de facturation et vos demandes d'augmentation de quota.

Limites de Trace

Cette section liste les limites qui s'appliquent lors de l'utilisation de l'API Cloud Trace.

Limites pour les méthodes API

Limites pour les méthodes API Valeur
Nombre maximal de segments par appel à GetTrace 1 000
Nombre maximal de segments par appel à PatchTraces 25 000
Nombre maximal de traces par appel ListTraces 1 000 dans les vues ROOTSPAN et MINIMAL
100 dans la vue COMPLETE

Limites applicables aux segments

Limites applicables aux segments Valeur
Longueur maximale d'un nom de segment 128 octets
Nombre maximal d'étiquettes ou d'attributs par segment 32
Taille maximale de la clé pour un libellé ou un attribut 128 octets
Taille maximale de la valeur d'un libellé ou d'un attribut 256 octets
Nombre maximal d'événements par segment 128
Code temporel maximal passé d'un segment à ingérer 14 jours
Code temporel maximal futur d'un segment à ingérer 3 jours
Code temporel maximal passé de l'événement par rapport au code temporel du segment 365 jours

Vous pouvez annoter des délais en créant un objet attributes et en l'associant à l'objet Span lorsque vous utilisez l'API Cloud Trace v2 batchWrite. De même, vous pouvez annoter des délais en créant un objet labels et en l'associant à l'objet TraceSpan lorsque vous utilisez la méthode patchTraces de l'API Cloud Trace v1.

Limites des traces

Limites des traces Valeur
Nombre maximal de délais par trace 1 000
Taille maximale de la trace 50 Mo

Durées de conservation des traces

Catégorie Durée de conservation
Données de segment stockées par Cloud Trace 30 jours
Rapports d'analyse 30 jours

Gérer votre quota

Cette section explique comment demander la modification d'un quota et comment surveiller son utilisation.

Demander des modifications de quota pour l'API Cloud Trace

Vous pouvez demander une augmentation ou une diminution des limites de l'API Cloud Trace à l'aide de la console Google Cloud:

  1. Sur la page Quotas de la console Google Cloud, cochez les cases pour sélectionner API Cloud Trace, 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 pouvoir cocher les cases.

  2. 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.

  3. Remplissez le formulaire dans le panneau Coordonnées.

  4. Cliquez sur Envoyer la requête.

Pour en savoir plus, consultez la page Afficher et gérer les quotas.

Surveiller votre utilisation des quotas

Pour éviter de dépasser votre quota et de ne pas perdre l'observabilité des performances de vos applications, veillez à regrouper vos mises à jour et à surveiller l'utilisation de votre quota. Par exemple, vous pouvez créer une règle d'alerte qui vous avertit lorsque votre utilisation dépasse un certain seuil. Pour obtenir des informations détaillées sur la surveillance de vos requêtes d'API et comprendre leurs réponses, consultez la page Contrôler votre utilisation des API.