En esta página, se ofrece información general sobre la recopilación de seguimientos con OpenTelemetry. Para supervisar y depurar solicitudes de Spanner, puedes habilitar los seguimientos en las bibliotecas cliente de Spanner. El seguimiento de extremo a extremo y del cliente puede ayudarte a supervisar el rendimiento y depurar problemas.
Los seguimientos proporcionan información pertinente para cada solicitud de un cliente, como la siguiente:
Intervalos con marcas de tiempo de cuándo el cliente envió una solicitud de RPC y cuándo recibió la respuesta de RPC, incluida la latencia causada por la red y el sistema cliente
Atributos (pares clave-valor) que proporcionan información sobre el cliente y su configuración
Anotaciones con eventos importantes en los intervalos
Para obtener más información sobre los intervalos y los atributos, consulta Intervalos y atributos en la documentación de OpenTelemetry.
Seguimiento de extremo a extremo
Además del seguimiento del cliente, puedes habilitar el seguimiento de extremo a extremo. El seguimiento de extremo a extremo te ayuda a comprender y depurar problemas de latencia específicos de Spanner, como los siguientes:
Identificar si la latencia se debe a la latencia de la red entre tu aplicación y Spanner, o si la latencia ocurre dentro de Spanner
Identificar las Google Cloud regiones por las que se enrutan las solicitudes de tu aplicación y si hay una solicitud entre regiones Una solicitud entre regiones suele significar latencias más altas entre tu aplicación y Spanner
Para evitar la sobrecarga de Cloud Trace y ayudar a administrar los costos de manera eficaz, el seguimiento de extremo a extremo tiene un límite en la cantidad de intervalos de seguimiento que puedes exportar. Debido a este límite, no se afecta el uso del seguimiento de extremo a extremo para la solución de problemas.
OpenTelemetry
Las bibliotecas cliente de Spanner admiten la recopilación de seguimientos con las OpenTelemetry. OpenTelemetry es un framework de observabilidad de código abierto. OpenTelemetry ofrece una amplia variedad de configuraciones, como exportadores para backends específicos, proporciones de muestreo y límites de intervalos.
Exporta seguimientos con OTLP
Como parte de tu configuración de OpenTelemetry, usas un exportador para enviar datos de seguimiento a un backend de observabilidad. Te recomendamos que uses un exportador del Protocolo de OpenTelemetry
(OTLP)
que envíe datos con el protocolo de OpenTelemetry. Puedes configurar el exportador de OTLP
para enviar seguimientos directamente a backends de observabilidad que admitan OTLP,
como Cloud Trace con
Telemetry
API, o
a un recopilador de OpenTelemetry.
Limitaciones
Los seguimientos de Spanner tienen las siguientes limitaciones:
- Los intervalos de seguimiento solo están disponibles para las bibliotecas cliente de Java, Go, Node y Python.
- Los seguimientos de extremo a extremo solo se pueden exportar a Cloud Trace.
Precios
Además del uso de Spanner, el seguimiento puede generar cargos a través de tu backend de observabilidad.
La transferencia de intervalos de seguimiento a tu backend de observabilidad es facturable. Por ejemplo, si usas Cloud Trace como backend, se te facturará según los precios de Cloud Trace.
Para comprender mejor la facturación, comienza con una proporción de muestreo de seguimiento pequeña según tu tráfico.
¿Qué sigue?
Para configurar el seguimiento de extremo a extremo y del cliente, consulta Configura la recopilación de seguimientos con OpenTelemetry.