Cloud Trace applique des quotas de débit, des limites d'ingestion de segments et des périodes de conservation des données qui dépendent de la méthode d'envoi des données de trace : l'API Telemetry (OTLP) ou l'API Cloud Trace. Comprendre ces seuils vous aide à surveiller votre utilisation afin de ne pas perdre l'observabilité de vos applications.
Quotas et limites de l'API Trace
Cette section fournit des informations sur les quotas et les limites qui ne s'appliquent qu'à l'API Trace. Les quotas et limites listés dans cette section ne s'appliquent pas à l'API Telemetry.
Cloud Trace applique deux types de quotas : un quota de débit sur vos requêtes API Cloud Trace et un quota d'ingestion sur les segments que vous envoyez à Trace.
Quotas
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 segments pour l'API Trace. Par exemple, vous disposez d'un total de 300 requêtes par 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
ListTracestoutes les 60 secondes - Effectuer 10 appels d'API avec la méthode
ListTraceset 50 appels d'API avec la méthodeGetTracetoutes 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 |
| Intervalles ingérés3,4 | 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 unité de quota. L'interrogation et l'affichage des traces à l'aide de l'explorateur Trace dans la console Google Cloud ne consomment pas ce quota.
2 Les opérations d'écriture incluent PatchTraces, BatchWrite et CreateSpan. Chaque opération d'écriture consomme une unité de quota.
3 Ce quota ne s'applique qu'aux segments ingérés à l'aide de l'API Cloud Trace.
L'ingestion via l'API Telemetry n'est pas limitée.
4 Votre quota quotidien d'ingestion de segments de trace pour l'API Cloud Trace est déterminé par l'historique de votre compte de facturation et les demandes d'augmentation de quota que vous avez effectuées.
Limites
Ce tableau présente les limites de l'API Cloud Trace.
| Description | Valeur |
|---|---|
Nombre maximal de délais par appel à GetTrace |
10 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 MINIMAL100 dans la vue COMPLETE |
| Longueur maximale d'un nom de segment | 1 024 octets |
| Nombre maximal d'étiquettes ou d'attributs par segment | 1 024 |
| Taille maximale de la clé pour une étiquette ou un attribut | 512 octets |
| Taille maximale de la valeur d'un libellé ou d'un attribut | 65 532 octets |
| Nombre maximal d'événements par segment | 256 |
| Code temporel passé maximal pour l'ingestion d'un segment | 14 jours |
| Code temporel futur maximal pour l'ingestion d'un segment | 3 jours |
| Horodatage passé maximal de l'événement par rapport à l'horodatage de l'intervalle | 365 jours |
Le dépassement d'une limite n'entraîne pas nécessairement l'échec d'un appel d'API avec une erreur. Par exemple, aucune erreur n'est signalée lorsque le nombre d'attributs associés à un segment dépasse 1 024. Dans ce scénario, l'API Cloud Trace utilise un algorithme non déterministe pour sélectionner 1 024 attributs à ingérer. Les autres attributs sont supprimés.
L'API Cloud Trace fournit des détails sur les points de terminaison GetTrace, PatchTraces et ListTraces.
La façon dont vous annotez les segments dépend du point de terminaison de l'API Cloud Trace. Si vous utilisez le point de terminaison batchWrite, ajoutez des attributs à l'objet Span. Si vous utilisez le point de terminaison patchTraces, ajoutez des étiquettes à l'objet TraceSpan.
Limites et quotas de l'API Telemetry
Cette section répertorie les limites qui ne s'appliquent que lorsque l'API Telemetry est utilisée pour ingérer des données de trace. L'API Telemetry, qui implémente l'API OTLP OpenTelemetry, est conçue pour être utilisée avec des applications instrumentées à l'aide de l'un des SDK OpenTelemetry. Les limites indiquées dans cette section ne s'appliquent pas à l'API Cloud Trace.
| Description | Valeur | Remarque |
|---|---|---|
| Taille maximale des clés d'attribut | 512 octets | Limite. |
| Taille maximale des valeurs d'attribut | 64 Kio | Limite. |
Taille maximale du nom d'un objet Span* |
1 024 octets | Limite. |
Nombre maximal d'attributs associés à un objet Span* |
1 024 | Limite. |
Nombre maximal d'attributs de ressource par objet ResourceSpans* |
1 024 | Limite. |
Nombre maximal d'attributs par objet ResourceSpan*Inclut les attributs associés aux objets enfants des types suivants : Resource, Span, ScopeSpans,
Event et Link. |
8 192 | Limite. |
Nombre maximal d'objets Event* par objet Span* |
256 | Limite. |
Nombre maximal d'objets Link* par objet Span* |
128 | Limite. |
Taille maximale du nom d'un objet Event* |
1 024 octets | Limite. |
Nombre maximal d'attributs par objet Event* |
1 024 | Limite. |
Nombre maximal d'attributs par objet Link* |
1 024 | Limite. |
| Taille maximale des URL de schéma | 8 192 octets | Limite. |
| Nombre maximal d'octets d'ingestion de traces par minute | 2,4 Go pour les régions suivantes : 300 Mo pour toutes les autres régions. |
Quota. |
trace.proto.
Limites des champs d'application de trace
| Limites des champs d'application de trace | Valeur |
|---|---|
| Nombre maximal de champs d'application de trace par projet | 100 |
| Nombre maximal de vues par champ d'application de trace | 20 |
Durées de conservation des traces
| Catégorie | Durée de conservation |
|---|---|
Segments stockés dans le bucket _Trace |
30 jours |
Gérer votre quota
Cette section explique comment demander une modification de quota et comment surveiller l'utilisation de vos quotas.
Demander des modifications des quotas de l'API Cloud Trace
Pour déterminer si vous pouvez demander une limite de quota plus élevée ou plus faible pour l'API Cloud Trace à l'aide de la console Google Cloud , accédez à la page Quotas et limites du système et recherchez le quota qui vous intéresse.
- Si le quota est listé, vous pouvez utiliser cette page pour demander une modification de la limite. Pour en savoir plus sur ces étapes, consultez Afficher et gérer les quotas.
- Si le quota n'est pas listé ou si vous demandez une mise à jour du quota et que vous obtenez l'erreur
Edit is not allowed for this quota, contactez l'assistance et demandez une modification du quota. La facturation doit être activée sur le projetGoogle Cloud pour que vous puissiez modifier les quotas dans la console Google Cloud .
Surveiller l'utilisation de vos quotas
Pour vous assurer de ne pas épuiser votre quota et de ne pas perdre la visibilité sur les performances de vos applications, vérifiez que vous regroupez vos mises à jour et surveillez 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 d'ingestion de segments quotidiens, 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 d'ingestion de segments quotidiennes, consultez Limiter l'utilisation.
Pour demander une augmentation de vos unités de quota d'API ou de vos quotas d'ingestion de segments quotidiens, consultez 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.
Requêtes à volume élevé
Pour interroger vos données de trace à grande échelle, créez un ensemble de données BigQuery associé, puis utilisez l'API BigQuery.
N'utilisez pas l'API Cloud Trace pour les requêtes à volume élevé, car les appels à l'API Trace sont limités.