Para enviar datos de seguimiento a tu proyecto de Google Cloud, puedes usar la API de Telemetry (OTLP) o la API de Cloud Trace. La API de Telemetry implementa la API de OpenTelemetry OTLP y proporciona una mayor compatibilidad y compatibilidad con el ecosistema de código abierto de OpenTelemetry. La API de Trace es una API Google Cloud propietaria que antecede 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 solo se aplican 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 tarifa 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 por 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 1 unidad de cuota de ListSpan.
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 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.
Límites
| Descripción | 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 |
| Cantidad máxima de intervalos por seguimiento | 1,000 |
| Tamaño máximo del registro | 50 MB |
| 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 de una etiqueta o un atributo | 128 bytes |
| Tamaño máximo de valor para una etiqueta o un atributo | 256 bytes |
| Cantidad máxima de eventos por intervalo | 128 |
| 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 |
Puedes anotar intervalos si creas un objeto attributes y lo adjuntas al objeto Span cuando usas la API de 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 Trace v1.
Límites 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 OpenTelemetry OTLP, está diseñada para usarse con aplicaciones instrumentadas con uno de los SDK de OpenTelemetry. Los límites que se enumeran en esta sección no se aplican a la API de Cloud Trace.
| Descripción | Valor |
|---|---|
| Tamaño máximo de las claves de atributos | 512 bytes |
| Tamaño máximo de los valores de atributos | 64 KiB |
Tamaño máximo del nombre de un objeto Span* |
1,024 bytes |
Cantidad máxima de atributos adjuntos a un objeto Span* |
1024 |
Cantidad máxima de atributos de recursos por objeto ResourceSpans* |
1024 |
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 |
Cantidad máxima de objetos Event* por objeto Span* |
256 |
Cantidad máxima de objetos Link* por objeto Span* |
128 |
Tamaño máximo del nombre de un objeto Event* |
1,024 bytes |
Cantidad máxima de atributos por objeto Event* |
1024 |
Atributos máximos por objeto Link* |
1024 |
| Tamaño máximo de las URLs de esquemas | 8,192 bytes |
trace.proto de OpenTelemetry.
Límites de los permisos de seguimiento
| Límites de los permisos de seguimiento | Valor |
|---|---|
| Cantidad máxima de alcances de seguimiento por proyecto | 100 |
| Cantidad máxima de proyectos por permiso de seguimiento | 20 |
Períodos de retención de Trace
| Categoría | Período de retención |
|---|---|
| Datos de intervalo almacenados por 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 de la API de Cloud Trace más altos o más bajos con la consola de Google Cloud. Para obtener más información, consulta Visualiza y administra las 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. También ten en cuenta que la facturación debe estar habilitada en el proyecto de Google Cloud para poder hacer clic en las casillas de verificación.
Supervisa el uso de tu cuota
Para asegurarte de que no te quedes sin cuota ni dejes de observar el rendimiento de las apps, asegúrate de realizar 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 tus cuotas de la API de Cloud Trace y de la transferencia diaria de intervalos, consulta Consulta y administra las cuotas.
Para aprender a 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 las unidades de cuota de la API o de las cuotas diarias 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.