En esta página, se ofrece información general sobre la recopilación de registros con OpenTelemetry. Para supervisar y depurar solicitudes de Spanner, puedes habilitar el registro de seguimiento en las bibliotecas cliente de Spanner. El registro de seguimiento de extremo a extremo y del cliente puede ayudarte a supervisar el rendimiento y depurar problemas.
Los registros proporcionan información pertinente para cada solicitud de un cliente, como la siguiente:
Intervalos con marcas de tiempo que indican 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 del cliente.
Son atributos (pares clave-valor) que proporcionan información sobre el cliente y su configuración.
Anotaciones con eventos importantes en los períodos.
Para obtener más información sobre los tramos y los atributos, consulta Tramos y Atributos en la documentación de OpenTelemetry.
Registro de extremo a extremo
Además del registro de seguimiento del cliente, puedes habilitar el registro de seguimiento de extremo a extremo. El registro de extremo a extremo te ayuda a comprender y depurar los problemas de latencia específicos de Spanner, como los siguientes:
Identifica si la latencia se debe a la latencia de la red entre tu aplicación y Spanner, o si se produce dentro de Spanner.
Identifica 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. Este límite no afecta el uso del registro de extremo a extremo para solucionar problemas.
OpenTelemetry
Las bibliotecas cliente de Spanner admiten la recopilación de registros con las APIs de 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.
Cómo exportar registros con exportadores y recopiladores
Como parte de tus configuraciones, puedes exportar tus registros a un backend de observabilidad. La mayoría de los proveedores de servicios de observabilidad ofrecen exportadores para que uses, como el exportador de seguimiento.
Además de un exportador, OpenTelemetry recomienda configurar un recopilador. Un recopilador permite que tu servicio descargue datos rápidamente y que el recopilador se encargue del procesamiento adicional, como reintentos, procesamiento por lotes y encriptación. Un recopilador se ejecuta junto con tu aplicación. El recopilador recibe mensajes de OLTP, los procesa y los exporta a tu backend de observabilidad.
Limitaciones
Los registros de seguimiento 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 registro de 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 registros pequeña basada en tu tráfico.
¿Qué sigue?
Para configurar el seguimiento del cliente y de extremo a extremo, consulta Configura la recopilación de seguimientos con OpenTelemetry.