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.
Limites d'utilisation de l'API Trace
Méthode API | Unités de quota totales |
---|---|
GetTrace 1 ListTraces 2 ListSpan 1 |
300 par période de 60 secondes |
PatchTraces 1 BatchWriteSpans 1 CreateSpan 1 |
4 800 par période de 60 secondes |
1 Chaque appel d'API consomme une unité de quota.
2 Chaque appel d'API consomme 25 unités de quota.
Vous disposez d'un total de 300 unités de quota 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
Les restrictions et limites supplémentaires applicables à l'API Cloud Trace sont les suivantes :
Restrictions et limites | 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 en mode ROOTSPAN/Minimal 100 en mode COMPLETE |
Nombre maximal de délais par trace | 1 000 |
Nombre maximal d'octets par trace | 50 Mo |
Nombre maximal de libellés/attributs par délai | 32 |
Taille de clé par libellé/attribut | 128 octets |
Taille de valeur par libellé/attribut | 256 octets |
Demander des modifications du quota de l'API Cloud Trace
Vous pouvez demander une augmentation ou une baisse des limites de l'API Cloud Trace à l'aide de la console Google Cloud:
Sur la page Quotas de la console Google Cloud, cochez les cases pour sélectionner API Cloud Trace, puis cliquez sur Modifier 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.Dans le panneau Modifications des quotas, sélectionnez le service pour développer la vue associée, puis renseignez les champs Nouvelle limite et Description de la requête. Cliquez sur Suivant.
Remplissez le formulaire dans le panneau Coordonnées.
Cliquez sur Envoyer la requête.
Pour en savoir plus, consultez la page Afficher et gérer les quotas.
Limite quotidienne d'ingestion des délais de trace
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. Le tableau suivant répertorie la plage d'allocations de quotas :
Catégorie | Unités de quota |
---|---|
Délais ingérés | 3 000 000 à 5 000 000 000 par jour |
Quel est le lien entre les quotas et la tarification ?
La tarification de Cloud Trace est basée sur l'ingestion et l'analyse des délais de trace. Les données de latence sont regroupées dans une trace, qui est composée de délais. Les segments sont ingérés par le backend Cloud Trace, qui met ensuite les données à disposition de la console Google Cloud pour une visualisation et des rapports en temps réel. Lorsque vous consultez les données de trace, les délais stockés sont analysés dans le cadre du processus de récupération.
Les quotas de délais quotidiens définissent le nombre maximal de délais pouvant être ingérés au-delà duquel les appels d'API sont refusés pour cause d'insuffisance de ressources. Les quotas de débit de l'API définissent le nombre maximal d'appels d'API au-delà duquel les appels sont refusés pour cause d'insuffisance de ressources.
Chaque appel d'API compte dans le quota de l'API. Chaque appel d'API en écriture compte également dans le quota quotidien d'ingestion de délais. Par exemple, pour appliquer des correctifs à 10 000 délais, différentes approches sont possibles :
Envoyer une requête
patchTraces
incluant les 10 000 délaisEnvoyer 10 000 requêtes
patchTraces
contenant chacune un délai et répartir leur exécution sur plusieurs minutes afin d'éviter de dépasser les limites de quota de l'API
La première approche utilise une unité de quota de l'API et la seconde 10 000. Les deux approches utilisent 10 000 unités de quota quotidien d'ingestion de délais. Le prix des deux approches est le même, car il est déterminé par le nombre de délais ingérés et non par le nombre d'appels d'API.
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
Pour vous assurer de ne pas dépasser votre quota et de ne pas perdre l'observabilité des performances de vos applications, vérifiez régulièrement l'utilisation de votre quota ou créez une règle d'alerte. 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 votre quota quotidien 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 de vos unités de quota d'API ou de vos quotas quotidiens d'ingestion de délais, 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.