Cloud Trace aplica dos tipos de cuotas: una cuota de tarifa por las solicitudes a la API y una cuota de transferencia por los intervalos que envías a Trace.
Cuotas de Trace
En la siguiente tabla, se resumen las unidades de cuota disponibles para las operaciones de lectura y escritura, y la cuota diaria para transferir intervalos. Por ejemplo,
tienes un total de 300 por 60 segundos para los tres comandos de la API
GetTrace, ListTraces y ListSpan. A continuación, presentamos dos ejemplos distintos sobre cómo podrías usar todas las unidades de cuota disponibles:
- Realiza 12 llamadas a la API con el método
ListTracescada 60 segundos. - Realiza 10 llamadas a la API con el método
ListTracesy 50 llamadas a la API con el métodoGetTracecada 60 segundos.
| Categoría | Unidades de cuota totales |
|---|---|
| Operaciones de lectura1 | 300 cada 60 segundos |
| Operaciones de escritura2 | 4,800 cada 60 segundos |
| Intervalos transferidos3 | 3,000,000 al día - 5,000,000,000 al día |
1 Las operaciones de lectura incluyen GetTrace, ListTraces y ListSpan. Una llamada a ListTraces consume 25 unidades de cuota. Las llamadas a GetTrace consumen 1 unidad de cuota de ListSpan.
2 Las operaciones de escritura incluyen PatchTraces, BatchWrite y
CreateSpan. Cada operación de escritura consume 1 unidad de cuota.
3 La cuota diaria de transferencia de intervalos para seguimiento se determina en función del
historial de tu cuenta de facturación y de las solicitudes de aumento de cuota que realizaste.
Límites de seguimiento
En esta sección, se enumeran los límites que se aplican cuando se usa la API de Cloud Trace.
Límites para los métodos de la API
| Límites para los métodos de API | Valor |
|---|---|
Cantidad máxima de intervalos por llamada a GetTrace |
1,000 |
Cantidad máxima de intervalos por llamada a PatchTraces |
25,000 |
Cantidad máxima de seguimientos por llamada a ListTraces |
1,000 en las vistas ROOTSPAN y MINIMAL100 en la vista COMPLETE |
Límites de los intervalos
| Límites de los intervalos | Valor |
|---|---|
| Longitud máxima de un nombre de intervalo | 128 bytes |
| Cantidad máxima de etiquetas o atributos por intervalo | 32 |
| Tamaño máximo de la clave de una etiqueta o un atributo | 128 bytes |
| Tamaño máximo de valor para una etiqueta o un atributo | 256 bytes |
| Cantidad máxima de eventos por intervalo | 128 |
| Marca de tiempo máxima anterior para que se transfiera un intervalo | 14 días |
| Marca de tiempo máxima futura para que se transfiera un intervalo | 3 días |
| Marca de tiempo máxima anterior para el evento en relación con la marca de tiempo del intervalo | 365 días |
Puedes anotar intervalos si creas un objeto attributes y lo adjuntas al objeto Span cuando usas la API de Cloud Trace v2 batchWrite. Del mismo modo, puedes anotar intervalos si creas un objeto labels y lo adjuntas al objeto TraceSpan cuando usas el método patchTraces de la API de Cloud Trace v1.
Límites de los registros
| Límites de los registros | Valor |
|---|---|
| Cantidad máxima de intervalos por seguimiento | 1,000 |
| Tamaño máximo del registro | 50 MB |
Períodos de retención de Trace
| Categoría | Período de retención |
|---|---|
| Datos de intervalo almacenados por Cloud Trace | 30 días |
| Informes de análisis | 30 días |
Administra tu cuota
En esta sección, se describe cómo solicitar un cambio en una cuota y cómo supervisar su uso.
Solicita cambios en la cuota de la API de Cloud Trace
Puedes solicitar límites de la API de Cloud Trace más altos o más bajos con la consola de Google Cloud. Para obtener más información, consulta Visualiza y administra las cuotas.
Si recibes un error Edit is not allowed for this quota, puedes comunicarte con el equipo de asistencia para solicitar cambios en la cuota. También ten en cuenta que la facturación debe estar habilitada en el proyecto de Google Cloud para poder hacer clic en las casillas de verificación.
Supervisa el uso de tu cuota
Para asegurarte de que no te quedes sin cuota ni dejes de observar el rendimiento de las apps, asegúrate de realizar las actualizaciones por lotes y supervisar el uso de la cuota. Por ejemplo, puedes crear una política de alertas que te notifique cuando tu uso supere un umbral. Para ver información detallada sobre cómo supervisar las solicitudes y respuestas de la API, consulta Supervisa el uso de la API.
Para ver tus cuotas de la API de Cloud Trace y de la transferencia diaria de intervalos, consulta Consulta y administra las cuotas.
Para aprender a disminuir tus unidades de cuota de la API y tus unidades de cuota diaria de transferencia de intervalos, consulta Limita el uso.
Para solicitar un aumento de las unidades de cuota de la API o de las cuotas diarias de transferencia de intervalos, consulta Cómo solicitar más cuota.
Consulta la página Cómo crear una alerta de cuota superada para obtener más información sobre cómo crear políticas de alertas a fin de supervisar la cuota de la API de Trace y la tasa de transferencia de intervalos de seguimiento.