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 la lecture et l'écriture
et le quota quotidien d'ingestion de segments. Par exemple :
vous avez un total de 300 requêtes
par tranche de 60 secondes
les commandes 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 |
<ph type="x-smartling-placeholder"></ph>
1 Les opérations de lecture incluent GetTrace
, ListTraces
,
ListSpan
Un appel à ListTraces
consomme 25 unités de quota. Appels vers
GetTrace
consomment ListSpan
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 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 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 d'une 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 segments
en créant un objet labels
et en l'associant
l'objet TraceSpan
lorsque vous utilisez l'objet
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 votre utilisation du quota.
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. 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 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 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 le nombre d'unités de quota d'API et le délai quotidien unités de quota d'ingestion, consultez la section Limiter l'utilisation.
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.