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 les opérations de lecture et d'écriture, ainsi que le quota quotidien pour l'ingestion d'intervalles. 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éthodeGetTrace
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 une unité de quota ListSpan
.
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 des délais de trace est déterminé par l'historique de votre compte de facturation et vos demandes d'augmentation de quota.
Limites de traçage
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 délais par appel à GetTrace |
1 000 |
Nombre maximal de délais 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 des étendues | 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é d'un libellé ou d'un attribut | 128 octets |
Taille maximale de la valeur d'un libellé ou d'un attribut | 256 octets |
Nombre maximal d'événements par délai | 128 |
Code temporel maximal passé pour qu'une période soit ingérée | 14 jours |
Code temporel futur maximal pour l'ingestion d'un intervalle | 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 concernant les 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 délai stockées par Cloud Trace | 30 jours |
Rapports d'analyse | 30 jours |
Gérer votre quota
Cette section explique comment demander une modification de quota et comment surveiller l'utilisation de votre quota.
Demander une modification 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. 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 éviter de dépasser votre quota et de perdre la visibilité sur les 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 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 afficher votre API Cloud Trace et vos quotas quotidiens d'ingestion de délais, 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.
Pour demander une augmentation du nombre d'unités de quota d'API ou de votre quota quotidien d'ingestion de délais, consultez la section Demander une augmentation 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.