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

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 de traces

Le tableau suivant récapitule les unités de quota disponibles pour la lecture et l'écriture et le quota quotidien d'ingestion de segments. Par exemple, vous disposez d'un total de 300 unités par tranche de 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 lecture¹	300 par période de 60 secondes
Opérations d'écriture²	4 800 par période de 60 secondes
Segments ingérés³	3 000 000 à 5 000 000 000 par jour

¹ Les opérations de lecture incluent GetTrace, ListTraces et ListSpan. Un appel à ListTraces consomme 25 unités de quota. Les appels à GetTrace consomment une unité de quota ListSpan.
² Les opérations d'écriture incluent PatchTraces, BatchWrite, et CreateSpan. Chaque opération d'écriture consomme une unité de quota.
³ Votre quota quotidien d'ingestion de délais de trace est déterminé par vos l'historique du compte de facturation et les demandes d'augmentation de quota que vous avez effectuées.

Limites de Trace

Cette section liste les limites qui s'appliquent lorsque vous utilisez 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 des étendues

Limites applicables aux segments	Valeur
Longueur maximale d'un nom de span	128 octets
Nombre maximal de libellés ou d'attributs par délai	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
Horodatage maximal passé de l'événement par rapport à l'horodatage de la période	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 concernant les 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 votre utilisation du quota.

Demander des modifications du quota de 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. 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.

Surveiller votre utilisation des quotas

Pour vous assurer de ne pas dépasser votre quota et de ne pas perdre l'observabilité dans vos applis des performances, assurez-vous de regrouper vos mises à jour et de surveiller de l'utilisation du quota. Par exemple, vous pouvez créer une règle d'alerte qui 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.

Pour visualiser l'API Cloud Trace et le délai quotidien d'ingestion, consultez Afficher et gérer les quotas.
Pour savoir comment réduire vos unités de quota d'API et vos unités de quota quotidien d'ingestion de délais, consultez la section Limiter l'utilisation des ressources.
Demander une augmentation de votre quota d'API d'unités ou vos quotas quotidiens d'ingestion de segments, Demander plus de quota
Consultez la section Créer une alerte de dépassement de quota pour obtenir des informations détaillées sur la création de règles d'alerte afin de surveiller votre quota d'API Trace et le débit d'ingestion des délais de trace.