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 de transferencia de 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
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 ListSpan 1 unidad de cuota.
2Las 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 en función del historial de tu cuenta de facturación y las solicitudes de aumentos 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 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 del nombre de un 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 para una etiqueta o un atributo | 256 bytes |
| Cantidad máxima de eventos por intervalo | 128 |
| Marca de tiempo pasada máxima para la transferencia de un intervalo | 14 días |
| Marca de tiempo futura máxima para la transferencia de un intervalo | 3 días |
| Marca de tiempo pasada máxima para el evento relativo a 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. De manera similar, 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 de la versión 1.
Límites de los seguimientos
| Límites de los seguimientos | Valor |
|---|---|
| Cantidad máxima de intervalos por seguimiento | 1,000 |
| Tamaño máximo de registro | 50 MB |
Períodos de retención de Trace
| Categoría | Período de retención |
|---|---|
| Intervalo de datos almacenados con 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 más altos o más bajos para la API de Cloud Trace mediante la consola de Google Cloud:
En la página Cuotas de la consola de Google Cloud, usa las casillas de verificación para seleccionar 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 hacer clic en las casillas de verificación.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.
Completa el formulario del panel Detalles de contacto.
Haz clic en Enviar solicitud.
Para obtener más información, consulta Visualiza y administra las cuotas.
Cómo supervisar el uso de tu cuota
Para asegurarte de no quedarte sin cuota ni perder la observabilidad del rendimiento de tus apps, asegúrate de agrupar 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 tu API de Cloud Trace y tus cuotas diarias de transferencia de intervalos, consulta Visualiza y administra cuotas.
Para obtener información sobre cómo disminuir las unidades de cuota de la API y las 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 la cuota diaria de transferencia de intervalos, consulta Cómo solicitar un aumento de 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.