Pour envoyer des données de trace à votre Google Cloud projet, vous pouvez utiliser l' API Telemetry (OTLP) ou l' API Cloud Trace. L'API Telemetry implémente l'API OpenTelemetry OTLP et offre une meilleure compatibilité et une meilleure prise en charge de l'écosystème OpenTelemetry Open Source. L' API Trace est une API propriétaire Google Cloud qui est antérieure à la prise en charge de l'API Telemetry. Les limites de l'API Telemetry sont souvent plus généreuses que celles de l'API Trace.
Quotas et limites de l'API Trace
Cette section fournit des informations sur les quotas et les limites qui s'appliquent uniquement à 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 différents : un quota de débit sur les requêtes de l'API Cloud Trace et un quota d'ingestion sur les délais 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 délais pour l'API Trace. Par exemple, vous disposez d'un total de 300 unités de quota par période 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
ListTracestoutes les 60 secondes - Effectuer 10 appels d'API
ListTraceset 50 appels d'APIGetTraceavec la méthode 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 |
| Délais 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 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 Ce quota ne s'applique qu'aux délais ingérés à l'aide de l'API Cloud Trace.
L'ingestion via l'API Telemetry est illimitée.
4 Votre quota quotidien d'ingestion de délais 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.
augmentations.
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 délai | 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 |
| Horodatage passé maximal pour l'ingestion d'un délai | 14 jours |
| Horodatage futur maximal pour l'ingestion d'un délai | 3 jours |
| Horodatage passé maximal pour un événement par rapport à l'horodatage du délai | 365 jours |
Le dépassement d'une limite peut ne pas entraîner 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 délai dépasse 32. Dans ce cas, l'API Cloud Trace utilise un algorithme non déterministe pour sélectionner 32 attributs à ingérer. Les attributs restants sont ignorés.
L'API Cloud Trace fournit des informations sur les points de terminaison
GetTrace, PatchTraces et
ListTraces.
La façon dont vous annotez les délais dépend du point de terminaison de l'API Cloud Trace. Si vous utilisez le
batchWrite point de terminaison, ajoutez des attributs à l'objet
Span. Si vous utilisez le
patchTraces point de terminaison, ajoutez des libellés à l'
TraceSpan objet.
Limites et quotas de l'API Telemetry
Cette section répertorie les limites qui s'appliquent uniquement lorsque l' API Telemetry est utilisée pour ingérer des données de trace. L'API Telemetry, qui implémente l'API OpenTelemetry OTLP, est conçue pour être utilisée avec des applications instrumentées à l'aide de l'un des SDK OpenTelemetry. Les limites listé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 Span* objet |
1024 | Limite. |
Nombre maximal d'attributs de ressource par ResourceSpans* objet |
1024 | 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. |
8192 | 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 Event* objet |
1024 | Limite. |
Nombre maximal d'attributs par Link* objet |
1024 | 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 fichier.
Limites sur les champs d'application de trace
| Limites sur les 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 |
|---|---|
| Données de délai stockées par Cloud Trace | 30 jours |
Bucket _Trace |
30 jours |
Gérer votre quota
Cette section explique comment demander une modification de 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 Google Cloud console. 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
Google Cloud projet pour que vous puissiez cocher les cases.
Surveiller votre utilisation du quota
Pour éviter de dépasser votre quota et de perdre la visibilité sur les performances de vos applications, vérifiez que vous regroupez vos mises à jour et surveillez votre utilisation du 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 la page Afficher et gérer les quotas.
Pour savoir comment réduire votre utilisation d'unités de quota d'API et d'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.