Para enviar datos de traza a tu Google Cloud proyecto, puedes usar la API Telemetry (OTLP) o la API Cloud Trace. La API Telemetry implementa la API OTLP de OpenTelemetry y ofrece una mayor compatibilidad y asistencia para el ecosistema de código abierto OpenTelemetry. La API Trace es una API propietaria de Google Cloud que es anterior a la compatibilidad con la API Telemetry. Los límites de la API Telemetry suelen ser más flexibles que los de la API Trace.
Cuotas y límites de la API Trace
En esta sección se proporciona información sobre las cuotas y los límites que se aplican únicamente a la API Trace. Las cuotas y los límites que se indican en esta sección no se aplican a la API Telemetry.
Cloud Trace aplica dos tipos distintos de cuotas: una de frecuencia sobre las solicitudes a la API de Cloud Trace y una de ingestión sobre 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, así como la cuota diaria de ingestión de intervalos de la API Trace. Por ejemplo, dispones de 300 unidades en total por cada 60 segundos para los tres comandos de la API: GetTrace, ListTraces y ListSpan. A continuación tienes dos ejemplos de cómo puedes utilizar todas las unidades de cuota disponibles:
- Realizando 12 llamadas
ListTracesa la API cada 60 segundos. - Realizando 10 llamadas
ListTracesy 50 llamadasGetTracea la API cada 60 segundos.
| Categoría | Unidades de cuota totales |
|---|---|
| Operaciones de lectura1 | 300 cada 60 segundos |
| Operaciones de escritura2 | 4800 cada 60 segundos |
| Intervalos ingeridos3 | De 3 millones a 5000 millones 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.
2 Las operaciones de escritura incluyen PatchTraces, BatchWrite y CreateSpan. Cada operación de escritura consume 1 unidad de cuota.
3 Tu cuota diaria de ingestión de intervalos de trazas se determina en función del historial de tu cuenta de facturación y de las solicitudes de aumento de cuota que hayas enviado.
Límites
En esta tabla se indican los límites de la API de Cloud Trace.
| Descripción | Valor |
|---|---|
Número máximo de intervalos por llamada GetTrace |
1000 |
Número máximo de intervalos por llamada PatchTraces |
25.000 |
Número máximo de trazas por llamada ListTraces |
1000 en las vistas ROOTSPAN y MINIMAL100 en la vista COMPLETE |
| Número máximo de intervalos por traza | 1000 |
| Tamaño máximo de la traza | 50 MB |
| Longitud máxima del nombre de un intervalo | 128 bytes |
| Número máximo 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 del valor de una etiqueta o un atributo | 256 bytes |
| Número máximo de eventos por intervalo | 128 |
| Marca de tiempo máxima anterior para que se ingiera un intervalo | 14 días |
| Marca de tiempo máxima futura de un intervalo que se va a ingerir | 3 días |
| Marca de tiempo máxima anterior del 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 de ningún error cuando el número de atributos adjuntos a un intervalo supera los 32. En este caso, la API Cloud Trace usa un algoritmo no determinista para seleccionar 32 atributos que se van a ingerir. Los atributos restantes se descartan.
La API Cloud Trace proporciona detalles sobre los endpoints GetTrace, PatchTraces y ListTraces.
La forma de anotar los intervalos depende del endpoint de la API de Cloud Trace. Si usa el endpoint batchWrite, añada atributos al objeto Span. Si usas el endpoint patchTraces, añade etiquetas al objeto TraceSpan.
Límites de la API Telemetry
En esta sección se indican los límites que se aplican solo cuando se usa la API Telemetry para ingerir datos de trazas. La API Telemetry, que implementa la API OTLP de OpenTelemetry, se ha diseñado 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 |
|---|---|
| Tamaño máximo de las claves de atributo | 512 bytes |
| Tamaño máximo de los valores de atributo | 64 KiB |
Tamaño máximo del nombre de un objeto Span* |
1024 bytes |
Número máximo de atributos asociados a un objeto Span* |
1024 |
Número máximo de atributos de recursos por objeto ResourceSpans* |
1024 |
Número máximo de atributos por objeto ResourceSpan*Incluye los atributos asociados a los objetos secundarios de los siguientes tipos: Resource, Span, ScopeSpans,
Event y Link. |
8192 |
Número máximo de objetos Event* por objeto Span* |
256 |
Número máximo de objetos Link* por objeto Span* |
128 |
Tamaño máximo del nombre de un objeto Event* |
1024 bytes |
Número máximo de atributos por objeto Event* |
1024 |
Número máximo de atributos por objeto Link* |
1024 |
| Tamaño máximo de las URLs de esquema | 8192 bytes |
trace.proto.
Límites de los ámbitos de los rastreos
| Límites de los ámbitos de los rastreos | Valor |
|---|---|
| Número máximo de ámbitos de traza por proyecto | 100 |
| Número máximo de proyectos por ámbito de traza | 20 |
Periodos de conservación de Trace
| Categoría | Periodo de conservación |
|---|---|
| Datos de intervalo almacenados por Cloud Trace | 30 días |
Gestionar tu cuota
En esta sección se describe cómo solicitar un cambio en una cuota y cómo monitorizar el uso de cuotas.
Solicitar cambios en la cuota de la API de Cloud Trace
Puedes solicitar que te aumentemos o disminuyamos los límites de la API de Cloud Trace desde laGoogle Cloud consola. Para obtener más información, consulta el artículo Ver y gestionar cuotas.
Si aparece un error Edit is not allowed for this quota, puedes ponerte en contacto con el equipo de Asistencia para solicitar cambios en la cuota. Ten en cuenta también que la facturación debe estar habilitada en el
Google Cloud proyecto para poder hacer clic en las casillas.
Monitorizar el uso de la cuota
Para asegurarte de que no te quedas sin cuota y no pierdes capacidad de observación sobre el rendimiento de las aplicaciones, agrupa las actualizaciones y monitoriza el uso de la cuota. Por ejemplo, puedes crear una política de alertas que te avise cuando tu uso supere un umbral. Para obtener información detallada sobre cómo supervisar las solicitudes de las API y comprender sus respuestas, consulta la página sobre cómo supervisar el uso de las API.
Para ver tus cuotas de la API de Cloud Trace y de ingestión de intervalos diarias, consulta el artículo Ver y gestionar cuotas.
Si quieres saber cómo reducir las unidades tanto de tu cuota de la API como de tu cuota diaria de ingestión de intervalos, consulta la sección sobre cómo limitar el uso.
Para solicitar un aumento de las unidades de tu cuota de la API o de tu cuota diaria de ingestión de intervalos, consulta el artículo Solicitar un aumento de cuota.
Para obtener información detallada sobre cómo crear políticas de alertas con las que monitorizar tus cuotas de frecuencia de llamadas a la API de Trace y de ingestión de intervalos de trazas, consulta la sección Cómo crear una alerta de cuota superada.