Cloud Trace aplica cuotas de frecuencia, límites de transferencia de intervalos y períodos de retención de datos que dependen de la API que uses para enviar datos de seguimiento a tu Google Cloud proyecto: la API de Telemetry (OTLP) o la API de Cloud Trace. La API de Telemetry implementa la especificación de OTLP de OpenTelemetry y proporciona una mayor compatibilidad con el ecosistema de OpenTelemetry de código abierto.
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 indican en esta sección no se aplican a la API de Telemetry.
Cloud Trace aplica dos tipos diferentes de cuotas: una cuota de frecuencia en tus solicitudes a la API de Cloud Trace y una cuota de transferencia en 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 la transferencia de intervalos a la API de Trace. Por ejemplo, tienes un total de 300 por 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 ingeridos3,4 | 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. Consultar y ver seguimientos con el Explorador de seguimiento en la consola de 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 está restringida.
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 hayas realizado 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 MINIMAL100 en la vista COMPLETE |
| Longitud máxima del nombre de un tramo | 1,024 bytes |
| Cantidad máxima de etiquetas o atributos por intervalo | 1024 |
| Tamaño máximo de la clave de una etiqueta o un atributo | 512 bytes |
| Tamaño máximo del valor de una etiqueta o un atributo | 65,532 bytes |
| Cantidad máxima de eventos por intervalo | 256 |
| Marca de tiempo máxima del pasado para que se ingiera un intervalo | 14 días |
| Es la marca de tiempo futura máxima para que se ingiera un intervalo. | 3 días |
| Marca de tiempo máxima pasada 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 1,024. En cambio, en esta situación, la API de Cloud Trace usa un algoritmo no determinístico para seleccionar 1,024 atributos que se pueden transferir. Los atributos restantes se descartan.
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 extremo batchWrite, agrega atributos al objeto Span. Si usas el extremo patchTraces, agrega etiquetas al objeto TraceSpan.
Límites y cuotas de la API de Telemetry
En esta sección, se enumeran los límites que se aplican solo cuando se usa la API de Telemetry para transferir datos de seguimiento. La API de Telemetry, que implementa la API de OTLP de OpenTelemetry, está diseñada para usarse con aplicaciones instrumentadas con uno de los SDKs de OpenTelemetry. Los límites que se indican en esta sección no se aplican a la API de Cloud Trace.
| Descripción | Valor | Nota |
|---|---|---|
| Tamaño máximo de las claves de atributos | 512 bytes | Límite. |
| Tamaño máximo de los valores de atributos | 64 KiB | Límite. |
Tamaño máximo del nombre de un objeto Span* |
1,024 bytes | Límite. |
Cantidad máxima de atributos adjuntos a un objeto Span* |
1024 | Límite. |
Cantidad máxima de atributos de recursos por objeto ResourceSpans* |
1024 | Límite. |
Cantidad máxima de atributos por objeto ResourceSpan*Incluye atributos adjuntos a objetos secundarios de los siguientes tipos: Resource, Span, ScopeSpans,
Event y Link. |
8192 | Límite. |
Cantidad máxima de objetos Event* por objeto Span* |
256 | Límite. |
Cantidad máxima de objetos Link* por objeto Span* |
128 | Límite. |
Tamaño máximo del nombre de un objeto Event* |
1,024 bytes | Límite. |
Cantidad máxima de atributos por objeto Event* |
1024 | Límite. |
Cantidad máxima de atributos por objeto Link* |
1024 | Límite. |
| Tamaño máximo de las URLs del esquema | 8,192 bytes | Límite. |
| Cantidad máxima de bytes de transferencia de registros por minuto | 2.4 GB para las siguientes regiones: 300 MB para todas las demás regiones |
Cuota. |
trace.proto.
Límites en los permisos de seguimiento
| Límites en los permisos de seguimiento | Valor |
|---|---|
| Cantidad máxima de permisos de seguimiento por proyecto | 100 |
| Cantidad máxima de vistas por alcance de seguimiento | 20 |
Períodos de retención de Trace
| Categoría | Período de retención |
|---|---|
Intervalos almacenados en el bucket _Trace |
30 días |
Administra tu cuota
En esta sección, se describe cómo solicitar un cambio en una cuota y cómo supervisar el uso de la cuota.
Solicita cambios en las cuotas de la API de Cloud Trace
Para determinar si puedes solicitar un límite de la API de Cloud Trace más alto o más bajo para la cuota con la consola de Google Cloud , ve a la página Cuotas y límites del sistema y busca la cuota que te interesa.
- Si la cuota aparece en la lista, puedes usar esa página para solicitar un cambio en el límite. Para obtener información sobre esos pasos, consulta Visualiza y administra las cuotas.
- Si la cuota no aparece en la lista o si solicitas una actualización de la cuota y recibes el error
Edit is not allowed for this quota, comunícate con Atención al cliente de Cloud y solicita un cambio en la cuota. La facturación debe estar habilitada en el proyecto deGoogle Cloud para editar las cuotas en la consola de Google Cloud .
Supervisa el uso de tu cuota
Para asegurarte de no quedarte sin cuota y perder la observabilidad del rendimiento de tus apps, verifica que envíes tus actualizaciones por lotes y supervisa el uso de tu 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 Cómo ver y administrar cuotas.
Para obtener información sobre cómo reducir las unidades de cuota de la API y las unidades de cuota de transferencia diarias, consulta Limita el uso.
Para solicitar un aumento en las unidades de cuota de la API o en las cuotas de transferencia diarias, consulta Solicita 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.
Consultas de alto volumen
Para realizar consultas de gran volumen sobre tus datos de seguimiento, crea un conjunto de datos de BigQuery vinculado y, luego, usa la API de BigQuery.
No uses la API de Cloud Trace para realizar consultas de gran volumen, ya que las llamadas a la API de Trace están limitadas por la frecuencia.