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.

Límites de uso de la API de Trace

Método de la API	Unidades de cuota totales
GetTrace^1 ListTraces^2 ListSpan^1	300 cada 60 segundos
PatchTraces^1 BatchWriteSpans^1 CreateSpan^1	4,800 cada 60 segundos

¹ Cada llamada a la API consume 1 unidad de cuota.
² Cada llamada a la API consume 25 unidades de cuota.

Tienes a tu disposición 300 unidades de cuota cada 60 segundos para estos 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.

Estas son las restricciones y los límites adicionales de la API de Cloud Trace:

Restricciones y límites	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 vista ROOTSPAN/Minimal 100 en la vista COMPLETE
Cantidad máxima de intervalos por seguimiento	1,000
Cantidad máxima de bytes por seguimiento	50 MB
Cantidad máxima de etiquetas o atributos por intervalo	32
Tamaño de clave por etiqueta o atributo	128 bytes
Tamaño de valor por etiqueta o atributo	256 bytes

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.

Límite diario de transferencia de intervalos para seguimiento

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. La siguiente tabla detalla el rango de asignaciones de cuota:

Categoría	Unidades de cuota
Intervalos transferidos	3,000,000 al día - 5,000,000,000 al día

¿Cuál es la relación entre las cuotas y los precios?

Los precios de Cloud Trace se calculan en función de la transferencia y búsqueda de intervalos de Trace. Los datos de latencia se empaquetan en un trace, que se compone de intervalos. El backend de Cloud Trace transfiere los intervalos, lo que luego pone los datos a disposición para verlos y generar informes en tiempo real en la consola de Google Cloud. Cuando visualizas datos de seguimiento, los intervalos almacenados se analizan como parte del proceso de recuperación.

Las cuotas diarias de intervalos definen el límite de intervalos que se pueden transferir antes de que fallen las llamadas a la API y se muestre un error de recurso agotado. Las cuotas de tasa de API definen los límites de frecuencia de llamadas a la API que se pueden realizar antes de que fallen y se muestre un error de recurso agotado.

Cada llamada a la API consume la cuota de la API. Cada llamada a la API de Write también consume la cuota diaria de transferencia de intervalos. Por ejemplo, si necesitas aplicar un parche a 10,000 intervalos, tienes dos opciones:

• Enviar una solicitud patchTraces con los 10,000 intervalos

• Enviar 10,000 solicitudes patchTraces, cada una con 1 intervalo, y distribuirlas durante varios minutos para evitar los límites de cuota de la API

El primer método usa 1 unidad de cuota de API, mientras que el segundo usa 10,000. Ambos métodos consumen 10,000 unidades de cuota diaria de transferencia de intervalos. Los dos métodos tienen el mismo precio, pues se determina según la cantidad de intervalos transferidos, y no por la cantidad de llamadas a la API.

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

Administra tu cuota

Revisa periódicamente el uso de la cuota o crea una política de alertas para asegurarte de que no te quedes sin cuota ni dejes de observar el rendimiento de las apps. 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.