En este documento, se describe cómo ver tus entradas de registro en tiempo real mediante la transmisión y la cola en vivo.
La transmisión de registros te permite ver las entradas de registro en tiempo real y está disponible en el
Explorador de registros.
El seguimiento de registros en tiempo real te permite ver las entradas de registro en tiempo real y está disponible como el comando gcloud alpha logging tail
de la CLI de gcloud y como el método entries.tail
de la API de Cloud Logging.
Cuando veas y analices tus registros con el Explorador de registros,
gcloud logging read
o el método de la API
entries.list
, estás viendo entradas de registro que
Cloud Logging almacenó. Cuando transmites
o sigues en vivo las entradas de registro, estás viendo las entradas de registro a medida que tus
aplicaciones las escriben en la API de Cloud Logging.
Transmite registros en el Explorador de registros
En el Explorador de registros, puedes ver tus datos de registro en tiempo real con la función Transmitir registros. Cuando usas Transmitir registros, puedes agregar una consulta para transmitir solo los registros que coinciden con la consulta. Para transmitir registros, haz lo siguiente:
-
En la consola de Google Cloud, ve a la página Explorador de registros.
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Logging.
En el cuadro de texto Consulta, ingresa una consulta y, luego, haz clic en Transmitir registros.
A medida que Logging escribe los datos de registro, solo los registros que coinciden con se muestran en el panel Resultados de la consulta. Si no se proporciona una consulta, Logging mostrará el las entradas de registro almacenadas. Los registros se seguirán transmitiendo hasta que selecciones la barra de desplazamiento del panel de registros. Cuando se detiene la transmisión, se muestra el botón Reiniciar transmisión.
Para obtener información sobre las consultas, consulta Crea consultas en el Explorador de registros.
Usa la transmisión de registros en tiempo real en Google Cloud CLI
El seguimiento en vivo te permite ver tus entradas de registro en tiempo real a medida que Cloud Logging las escribe, ya sea con Google Cloud CLI o la API de Cloud Logging.
El seguimiento de registros en tiempo real no es compatible con los buckets de registros controles de acceso a nivel de campo, sin importar pueden transmitir registros de esos buckets en el Explorador de registros.
Si deseas obtener información sobre el método de la API para la transmisión de registros en tiempo real, consulta el método entries.tail.
Instalando gcloud alpha logging tail
Para usar gcloud alpha logging tail
, debes tener instalado Python 3 y
el paquete de Python grpcio
.
Para obtener instrucciones sobre cómo
instalar Python, consulta la
Página de Python.
Para obtener instrucciones sobre cómo instalar el administrador de paquetes de Python, pip
, es
necesario para instalar el paquete grpcio
; consulta
Página del instalador de paquetes de Python.
Completa los siguientes pasos para instalar gcloud alpha logging tail
:
Verifica que tengas Google Cloud CLI instalado. Para obtener instrucciones sobre cómo instalar Google Cloud CLI, consulta Instala Google Cloud CLI.
Verifica que estés usando la versión 302.0.0 o una posterior de la CLI de gcloud.
gcloud version
Para obtener instrucciones sobre cómo actualizar gcloud CLI, consulta
gcloud components update
Instala los componentes alfa de la CLI de gcloud:
gcloud components install alpha
Para usuarios de macOS, Linux y Cloud Shell:
Instala las bibliotecas cliente de gRPC:
sudo pip3 install grpcio
Establece la variable de entorno
CLOUDSDK_PYTHON_SITEPACKAGES
en cualquier valor:export CLOUDSDK_PYTHON_SITEPACKAGES=1
Usa los siguientes comandos para establecer el ID del proyecto de Google Cloud y en authenticate:
gcloud config set project PROJECT_ID gcloud auth login
Para obtener el ID del proyecto, consulta Crea y administra proyectos.
Ejecuta el siguiente comando para verificar que
gcloud alpha logging tail
esté instalado:gcloud alpha logging tail
El comando muestra el siguiente mensaje:
Initializing tail session.
Ahora estás viendo las entradas de registro de tu proyecto de Google Cloud a medida que Logging las escribe.
Para obtener más información sobre el uso de la transmisión de registros en tiempo real, consulta el
Guía de referencia de gcloud alpha logging tail
.
Almacenamiento en búfer y pedidos
Debido a que Logging puede recibir entradas de registro fuera del orden cronológico, el seguimiento en vivo proporciona una configuración de ventana de búfer para que puedas equilibrar la compensación entre ver las entradas de registro a medida que se escriben y verlas en orden ascendente. Puedes establecer la ventana del búfer entre 0
y 60
segundos.
Ten en cuenta las siguientes características de la ventana del búfer:
La ventana de búfer predeterminada es de dos segundos.
El registro retrasa la escritura de las entradas de registro en los buckets de registro durante la duración de la ventana del búfer.
Si una entrada de registro se escribe fuera de la ventana del búfer, entonces Logging muestra las entradas de registro a medida que se reciben.
Cuando configuras la ventana del búfer, debes hacer un equilibrio entre Visualizar los registros a medida que están escritos y ver las entradas desordenadas.
Ventana de búfer | Compensación |
---|---|
0 segundos |
Se mostraron las entradas de registro más recientes, pero con más probabilidades de que queden fuera de orden. |
60 segundos |
Un retraso de 60 segundos antes de ver las entradas que se muestran, pero la mayoría de los registros se muestran en orden ascendente. |
Límites y cuotas
En la siguiente tabla, se enumeran los límites y las cuotas para el transmisión de registros en tiempo real:
Límites y cuotas | Valor |
---|---|
Entradas devueltas por minuto | 60,000 Si más de 60,000 entradas coinciden con un filtro, el registro muestra el recuento de entradas en la respuesta. |
Sesiones abiertas de seguimiento de registros en tiempo real por proyecto de Google Cloud | 10 |
Limitaciones del cliente
En el caso de un proyecto de Google Cloud que escribe muchas entradas con rapidez, es posible que tu cliente no pueda consumirlas tan rápido como se escriben. En En este caso, Logging limita el número total de entradas enviadas, priorizando las entradas más recientes. Al final de la sesión de cola, el registro muestra la cantidad de entradas que no se mostraron debido a los límites del cliente.
Usa el seguimiento en vivo con bibliotecas cliente
El registro de registros en tiempo real te permite ver tus entradas de registro en tiempo real como Cloud Logging los escribe. Para obtener información sobre el método de la API para el seguimiento en vivo, consulta el método entries.tail.
El seguimiento de registros en tiempo real no es compatible con los buckets de registros controles de acceso a nivel de campo, sin importar pueden transmitir registros de esos buckets en el Explorador de registros.
En este ejemplo, se muestran las entradas de registro de transmisión de registros en vivo de un registrador determinado.
Go
Si deseas obtener información sobre cómo instalar y usar la biblioteca cliente de Logging, consulta las Bibliotecas cliente de Logging.
Para autenticarte en Logging, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Para obtener información sobre cómo instalar y usar la biblioteca cliente de Logging, consulta Bibliotecas cliente de Logging
Para autenticarte en Logging, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Node.js
Si deseas obtener información sobre cómo instalar y usar la biblioteca cliente de Logging, consulta Bibliotecas cliente de Logging.
Para autenticarte en Logging, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.