Cuotas y límites

Para enviar datos de seguimiento a tu Google Cloud proyecto, puedes usar la API de Telemetry (OTLP) o la API de Cloud Trace. La API de Telemetry implementa la API de OTLP de OpenTelemetry y proporciona mayor compatibilidad y asistencia para el ecosistema de OpenTelemetry de código abierto. La API de Trace es una API propietaria Google Cloud que es anterior a la compatibilidad con la API de Telemetry. Los límites de la API de Telemetry suelen ser más generosos que los de la API de Trace.

Cuotas y límites de la API de Trace

En esta sección, se proporciona información sobre las cuotas y los límites que se aplican solo a la API de Trace. Las cuotas y los límites que se enumeran en esta sección no se aplican a la API de Telemetry.

Cloud Trace aplica dos tipos de cuotas: una cuota de frecuencia por las solicitudes a la API de Cloud Trace y una cuota de transferencia por los intervalos que envías a Trace.

Cuotas

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 para la API de Trace. 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,4 3,000,000 al día - 5,000,000,000 al día

1 Las operaciones de lectura incluyen GetTrace, ListTraces, ListSpan. Una llamada a ListTraces consume 25 unidades de cuota. Las llamadas a GetTrace consumen ListSpan 1 unidad de cuota. Consultar y ver seguimientos con el Explorador de Trace en la Google Cloud no consume esta cuota.
2 Las operaciones de escritura incluyen PatchTraces, BatchWrite, y CreateSpan. Cada operación de escritura consume 1 unidad de cuota.
3 Esta cuota solo se aplica a los intervalos transferidos con la API de Cloud Trace. La transferencia a través de la API de Telemetry no tiene restricciones. 4 Tu cuota diaria de transferencia de intervalos de seguimiento para la API de Cloud Trace se determina según el historial de tu cuenta de facturación y las solicitudes que realizaste para aumentar la cuota.

Límites

En esta tabla, se enumeran los límites de la API de Cloud Trace.

Descripción Valor
Cantidad máxima de intervalos por llamada a GetTrace 10,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 MINIMAL
100 en la vista COMPLETE
Longitud máxima de un nombre de intervalo 1,024 bytes
Cantidad máxima de etiquetas o atributos por intervalo 1024
Tamaño máximo de la clave para una etiqueta o un atributo 512 bytes
Tamaño máximo del valor para una etiqueta o un atributo 65,532 bytes
Cantidad máxima de eventos por intervalo 256
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

Si se supera un límite, es posible que la llamada a la API no falle con un error. Por ejemplo, no se informa un error cuando la cantidad de atributos adjuntos a un intervalo supera los 1024. En cambio, en esta situación, la API de Cloud Trace usa un algoritmo no determinista para seleccionar 1024 atributos para transferir. Se descartan los atributos restantes.

La API de Cloud Trace proporciona detalles sobre los extremos GetTrace, PatchTraces y ListTraces.

La forma en que anotas los intervalos depende del extremo de API de Cloud Trace. Si usas el batchWrite extremo, agrega atributos al Span objeto. Si usas el