Escribe y consulta entradas de registro con una secuencia de comandos de Python

Comenzar

Puedes utilizar el entorno de Cloud Shell o un entorno genérico de Linux para completar esta guía de inicio rápido. Python está preinstalado en Cloud Shell.

Clona la fuente

Para configurar Cloud Shell para esta guía de inicio rápido, haz lo siguiente:

1. Clona el proyecto python-logging de GitHub:

     git clone https://github.com/googleapis/python-logging
   

   El directorio samples/snippets contiene las dos secuencia de comandos que se usan en esta guía de inicio rápido:

   • snippets.py te permite administrar entradas en un registro.
   • export.py te permite administrar las exportaciones de registros.

2. Cambia al directorio snippets:

     cd python-logging/samples/snippets
   

Escribe entradas de registro

La secuencia de comandos snippets.py usa las bibliotecas cliente de Python para escribir entradas de registro en Logging. Cuando se especifica la opción write en la línea de comandos, la secuencia de comandos escribe las siguientes entradas de registro:

• Una entrada con datos no estructurados y sin nivel de gravedad especificado
• Una entrada con datos no estructurados y un nivel de gravedad de ERROR
• Una entrada con datos estructurados JSON y sin nivel de gravedad especificado

Para escribir entradas de registro nuevas en el registro my-log, ejecuta la secuencia de comandos snippets.py con la opción write:

python snippets.py my-log write

Visualiza entradas de registro

Para ver las entradas de registro en Cloud Shell, ejecuta la secuencia de comandos snippets.py con la opción list:

python snippets.py my-log list

El comando se completa con el resultado:

    Listing entries for logger my-log:
    * 2018-11-15T16:05:35.548471+00:00: Hello, world!
    * 2018-11-15T16:05:35.647190+00:00: Goodbye, world!
    * 2018-11-15T16:05:35.726315+00:00: {u'favorite_color': u'Blue', u'quest': u'Find the Holy Grail', u'name': u'King Arthur'}

Si el resultado no muestra ninguna entrada, vuelve a ejecutar el comando. Logging tarda unos instantes en recibir y procesar las entradas de registro.

Para ver tus entradas de registro, también puedes usar el Explorador de registros. Para obtener más detalles, consulta Visualiza los registros con el Explorador de registros.

Borra entradas de registro

Para borrar todas las entradas del registro my-log, ejecuta la secuencia de comandos snippets.py con la opción delete:

python snippets.py my-log delete

El comando se completa con el resultado:

Deleted all logging entries for my-log

Registros de ruta

En esta sección, harás lo siguiente:

• Crear un bucket de Cloud Storage como destino para tus datos
• Crear un receptor que copie nuevas entradas de registro en el destino
• Actualizar los permisos de tu bucket de Cloud Storage
• Escribir entradas de registro en Logging
• De forma opcional, verificar el contenido de tu bucket de Cloud Storage.

Crea un destino

El destino de exportación de esta guía de inicio rápido es un bucket de Cloud Storage. Para crear un bucket de Cloud Storage, haz lo siguiente:

1. En la consola de Google Cloud, ve a la página Buckets:

   Ve a Buckets.

   Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Cloud Storage.

2. Haz clic en Crear bucket.
3. Ingresa un nombre para tu bucket.
4. En Tipo de ubicación, selecciona Región, que selecciona una ubicación de bucket con la latencia más baja.
5. En Clase de almacenamiento predeterminada, selecciona Estándar.
6. En Control de acceso, selecciona Detallado.
7. En Herramientas de protección, selecciona Ninguna y, luego, haz clic en Crear.

En esta guía de inicio rápido, se usa un nombre de bucket myloggingproject-1 de Cloud Storage.

Crear un receptor

Un receptor es una regla que determina si Logging enruta una entrada de registros recién llegada a un destino. Un receptor tiene tres atributos:

• Nombre
• Destino
• Filtro

Para obtener más información sobre los receptores, consulta Sinks.

Si una entrada de registro nueva cumple con las condiciones de consulta, esa entrada se enruta al destino.

La secuencia de comandos export.py usa las bibliotecas cliente de Python para crear, enumerar, modificar y borrar receptores. Para crear el receptor mysink, que exporta todas las entradas de registro con una gravedad de INFO como mínimo al bucket myloggingproject-1 de Cloud Storage, ejecuta el siguiente comando:

python export.py create mysink myloggingproject-1 "severity>=INFO"

Para ver tus receptores, ejecuta la secuencia de comandos export.py con la opción list:

python export.py list

La secuencia de comandos muestra lo siguiente:

    mysink: severity>=INFO -> storage.googleapis.com/myloggingproject-1

Actualiza los permisos de destino

Los permisos del destino, en este caso, tu bucket de Cloud Storage, no se modifican cuando creas un receptor con la secuencia de comandos export.py. Debes cambiar la configuración de permiso de tu bucket de Cloud Storage para otorgar permiso de escritura al receptor. Para obtener información sobre las cuentas de servicio, los permisos de acceso y las funciones de Identity and Access Management, consulta Cuentas de servicio.

Para actualizar los permisos del bucket de Cloud Storage, sigue estos pasos:

1. Identifica la Identidad del escritor de tu receptor:

   1. En la consola de Google Cloud, ve a la página Enrutador de registros:

      Ir a Enrutador de registros

      Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Logging.

      Verás una tabla de resumen de tus sumideros.

   2. Busca tu receptor en la tabla, selecciona more_vert Menú y, luego, Ver detalles del receptor.

   3. Copia la identidad del escritor en el portapapeles.

2. En la consola de Google Cloud, ve a la página Buckets:

   Ve a Buckets.

   Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Cloud Storage.

3. Para abrir la vista detallada, haz clic en el nombre de tu bucket.

4. Selecciona Permisos y haz clic en Otorgar acceso.

5. Pega la identidad del escritor en el cuadro Principales nuevas. Quita el prefijo serviceAccount: de la dirección de identidad del escritor.

6. Establece el rol en Storage Object Creator y, luego, haz clic en Guardar.

Para obtener más información, consulta Configura los permisos de destino.

Valida el receptor

Para validar que el receptor y el destino estén configurados de forma correcta, haz lo siguiente:

1. Escribe entradas de registro nuevas en el registro my-log:

   python snippets.py my-log write
   

2. Visualiza el contenido de tu bucket de Cloud Storage:

   1. En la consola de Google Cloud, ve a la página Buckets:

      Ve a Buckets.

      Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Cloud Storage.

   2. Para abrir la vista detallada, haz clic en el nombre de tu bucket. La vista de detalles muestra una lista de las carpetas que contienen datos. Si tu bucket no contiene datos, aparecerá el siguiente mensaje:

      There are no live objects in this bucket.

      Como se describe en Entradas de registro que llegan tarde, es posible que se necesiten entre 2 y 3 horas antes de que aparezcan las primeras entradas en el destino, o antes de que recibas la notificación de un error de configuración.

      Una vez que el bucket recibió los datos, en la vista de detalles, se muestra un resultado similar al siguiente:

      

   3. Los datos en cada carpeta están organizados en una serie de carpetas etiquetadas. La carpeta de nivel superior consiste en un nombre de registro y, sucesivamente, el año, el mes y el día. Para ver los datos que exportó tu receptor, haz clic en el nombre de la carpeta my-log y, luego, haz clic en las subcarpetas de año, mes y día hasta que llegues a un archivo que termine en json:

      

   4. El archivo JSON contiene las entradas de registro que se exportaron a tu bucket de Cloud Storage. Haz clic en el nombre del archivo JSON para ver su contenido. El contenido es similar al siguiente:

       {"insertId":"yf1cshfoivz48",
       "logName":"projects/loggingproject-222616/logs/my-log",
       "receiveTimestamp":"2018-11-15T23:06:14.738729911Z",
       "resource":{"labels":{"project_id":"loggingproject-222616"},"type":"global"},
       "severity":"ERROR",
       "textPayload":"Goodbye, world!",
       "timestamp":"2018-11-15T23:06:14.738729911Z"}
      

      Debido a que el nivel de gravedad de ERROR es mayor que el de INFO, la entrada de registro que contiene la string “Goodbye, world!” se exporta al destino del receptor. Las otras entradas de registro que se escribieron no se exportaron al destino, porque el nivel de gravedad se estableció en el valor predeterminado, que es menor que INFO.

Soluciona problemas

Existen diferentes motivos por los que un bucket de Cloud Storage podría estar vacío:

• El bucket no recibió datos. Es posible que se necesiten entre 2 y 3 horas antes de que aparezcan las primeras entradas en el destino, o antes de que recibas la notificación de un error de configuración. Para obtener más información, consulta Entradas de registro que llegan tarde.

• Hay un error de configuración. En este caso, recibirás un correo electrónico similar al siguiente asunto:

   [ACTION REQUIRED] Logging export config error in myloggingproject.

  En el contenido del cuerpo del correo electrónico se describe el error de configuración. Por ejemplo, si no actualizas los permisos de destino, el correo electrónico mostrará el siguiente código de error:

   bucket_permission_denied

  Para corregir esta condición en particular, consulta Actualiza los permisos de destino en esta página.

• No se escribieron entradas de registro después de crear el receptor. El receptor se aplica solamente a las entradas de registro recién llegadas. Para corregir esta situación, escribe nuevas entradas de registro:

   python snippets.py my-log write