Cuotas y límites

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 seguimiento

En la siguiente tabla, se resumen las unidades de cuota disponibles para las operaciones de lectura y escritura, y la cuota diaria a fin de transferir los intervalos. Por ejemplo, tienes un total de 300 cada 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 ListTraces cada 60 segundos.
  • Realiza 10 llamadas a la API con el método ListTraces y 50 llamadas a la API con el método GetTrace cada 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 ListSpan 1 unidad de cuota.
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 de seguimiento se determina según el historial de tu cuenta de facturación y las solicitudes de aumentos de cuota que hiciste.

Límites de seguimientos

En esta sección, se enumeran los límites que se aplican cuando se usa la API de Cloud Trace.

Límites de los métodos de la API

Límites de los métodos de la 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 la ROOTSPAN y MINIMAL vistas
100 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 para una etiqueta o un atributo 128 bytes
Tamaño máximo del valor de una etiqueta o un atributo 256 bytes
Cantidad máxima de eventos por intervalo 128
Marca de tiempo pasada máxima para que se transfiera un intervalo 14 días
Marca de tiempo futura máxima para que se transfiera un intervalo 3 días
Marca de tiempo pasada máxima 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 seguimientos

Límites de los seguimientos 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 intervalos que almacena Cloud Trace 30 días
Informes de análisis 30 días

Administrar tu cuota

En esta sección, se describe cómo solicitar un cambio en una cuota y cómo supervisar tu uso de la cuota.

Solicita cambios en la cuota de la API de Cloud Trace

Puedes solicitar que se aumenten o disminuyan los límites de la API de Cloud Trace con la consola de Google Cloud:

  1. En la página Cuotas de la consola de Google Cloud, usa las casillas de verificación para seleccionar la API de Cloud Trace y, luego, haz clic en Editar 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. Además, ten en cuenta que la facturación debe estar habilitada en el proyecto de Google Cloud para que puedas hacer clic en las casillas de verificación.

  2. En el panel Cambios en la cuota, selecciona el servicio para expandir la vista y, luego, completa los campos Nuevo límite y Descripción de la solicitud. Haz clic en Siguiente.

  3. Completa el formulario del panel Detalles de contacto.

  4. Haz clic en Enviar solicitud.

Para obtener más información, consulta Visualiza y administra las cuotas.

Cómo supervisar el uso de tus cuotas

Para asegurarte de que no te quedes sin cuota ni pierdas la observabilidad del rendimiento de tus apps, asegúrate de agrupar las actualizaciones y supervisar el uso de la cuota. Por ejemplo, puedes crear una política de alertas que te notifique cuando tu uso supere un límite. 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 la API de Cloud Trace y las cuotas diarias de transferencia de intervalos, consulta Visualiza y administra las cuotas.

  • Si deseas obtener información para 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 tus unidades de cuota de la API o de tu cuota diaria 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.