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
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,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.
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 MINIMAL100 en la vista COMPLETE |
| 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 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 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 32. En cambio, en esta situación, la API de Cloud Trace usa un algoritmo no determinista para seleccionar 32 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
patchTraces extremo, agrega etiquetas al
TraceSpan objeto.
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 OTLP de OpenTelemetry, está diseñada para usarse con aplicaciones instrumentadas con uno de los SDKs 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 Span* objeto |
1024 |
Cantidad máxima de atributos de recursos por ResourceSpans* objeto |
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 Link* objetos por objeto Span* |
128 |
Tamaño máximo del nombre de un objeto Event* |
1,024 bytes |
Cantidad máxima de atributos por Event* objeto |
1024 |
Cantidad máxima de atributos por Link* objeto |
1024 |
| Tamaño máximo de las URLs de esquema | 8,192 bytes |
trace.proto.
Límites de los permisos de seguimiento
| Límites de los permisos de seguimiento | Valor |
|---|---|
| Cantidad máxima de permisos 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 intervalos almacenados por Cloud Trace | 30 días |
Segmento de _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 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 Google Cloud consola. 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
Google Cloud proyecto para hacer clic en las casillas de verificación.
Supervisa el uso de la cuota
Para asegurarte de que no te quedes sin cuota ni dejes de observar el rendimiento de las apps, verifica que agrupes tus actualizaciones y supervises el uso de la cuota. Por ejemplo, puedes crear una política de alertas que te notifique cuando el uso supere un límite. Para ver información detallada sobre cómo supervisar las solicitudes y entender sus respuestas, 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 Visualiza y administra las cuotas.
Para obtener información sobre cómo 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 la cuota diaria de transferencia de intervalos, 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.