Visualiza los registros

En esta guía, se muestra cómo buscar registros y ver entradas de registro con el visor de registros.

Antes de comenzar

No hace falta un lugar de trabajo para utilizar Stackdriver Logging, a menos que envíes registros desde Amazon Web Services (AWS) hacia Logging.

Stackdriver Logging muestra registros para un solo proyecto de Google Cloud Platform. Si utilizas un espacio de trabajo, Logging no combina los registros de los proyectos supervisados. Debes seleccionar un proyecto específico para ver sus registros.

Si utilizas un lugar de trabajo y AWS, selecciona el proyecto conector de AWS a fin de ver los registros de AWS.

Comienza

  1. Ve a la página Stackdriver Logging > Registros (Visor de registros) en GCP Console:

    Ir a la página del visor de registros

  2. Selecciona un proyecto de GCP existente en la parte superior de la página o crea un proyecto nuevo.

  3. Desde los menús desplegables, selecciona el recurso cuyos registros quieres ver.

Si no ves ningún registro, consulta la sección Solución de problemas a continuación.

Interfaces de filtro del visor de registros

Existen dos interfaces de filtro en el visor de registros:

  • La interfaz de filtro básico te permite seleccionar registros desde menús y tiene una capacidad de búsqueda simple.
  • La interfaz de filtro avanzado te permite ver entradas de registro de varios registros y tiene una capacidad de búsqueda más sofisticada.

Para intercambiar entre estas interfaces, utiliza la flecha desplegable (▾) en el extremo derecho del cuadro de filtro de búsqueda en cualquiera de las interfaces.

En la siguiente captura de pantalla, se muestra el diseño del visor de registros con la interfaz de filtro básico. Se muestran entradas de registro de una aplicación de App Engine:

Visor de registros

La interfaz de filtro básico tiene los siguientes componentes principales, indicados con números en rojo en la captura anterior; algunos son iguales en la interfaz de filtro avanzado:

  1. Las pestañas de ventanas te permiten permanecer en Registros (la página del visor de registros) o seleccionar entre otras funciones de Stackdriver Logging: Métricas (consulta Métricas basadas en registros), Exportaciones (consulta Exporta con el visor de registros) y Transferencia de registros (consulta Exclusiones de registros).
  2. El cuadro de filtro de búsqueda en la interfaz de filtro básico te permite filtrar entradas de registro mediante búsqueda de etiqueta o texto. Se muestra filtro básico y la flecha desplegable (▾) en el extremo derecho te permite cambiar a la interfaz de filtro avanzado o, también, obtener un vínculo a tu filtro.
  3. El menú selector básico te permite seleccionar recursos, registros y niveles de gravedad que quieras mostrar.
  4. Los menús desplegables de selector de intervalo de tiempo te permiten filtrar fechas y horarios específicos en los registros.
  5. El selector de transmisión, en la parte superior de la página, controla si las entradas de registro nuevas se muestran, o no, a medida que llegan.
  6. La tabla de entrada de registros contiene las entradas de registro disponibles se acuerdo con tus archivos actuales y campos personalizados.
  7. La flecha desplegable (▸) frente a cada entrada de registro te permite mirar el contenido total de esa entrada. Para obtener más información, consulta Expande entradas de registro.
  8. El menú Ver opciones, en el extremo derecho, tiene opciones de visualización adicionales.
  9. El menú Descargar registros, en el extremo derecho, te permite descargar un conjunto de entradas de registro. Para obtener detalles, consulta descarga entradas de registro.
  10. La opción Más (⋮), que se muestra con cada entrada de registro, te permite poner una marca en ella, mostrarla en su contexto de recursos y copiar la URL de la entrada de registros en el portapapeles.

Por último, el visor de registros utiliza la posición del cursor para resaltar la entrada de registro correspondiente y mostrar un símbolo de marcador (📌) al lado del ícono Más (⋮).

Desplázate y transmite registros

Cuando abres el visor de registros por primera vez, verás suficientes entradas de registro como para llenar la pantalla. Cuando te desplazas por las entradas de registro, el visor de registros intenta obtener entradas adicionales. La barra amarilla encima y debajo de los registros te permite saber si hay más entradas de registro disponibles.

Los íconos en la parte superior de la pantalla controlan cuando se actualizan los registros:

  • Haz clic en el ícono "actualizar" (refresh) para recuperar los últimos registros y ajustar el desplazamiento a ellos.
  • Haz clic en el ícono "reproducir" (play_arrow) para transmitir los últimos registros. La transmisión se detiene cuando seleccionas una entrada de registro o cuando te desplazas la pantalla de registros.
  • Haz clic en el ícono "pausa" (pause) para detener la transmisión.

Desplázate hasta un horario

Puedes filtrar tus entradas de registro según hora y fecha mediante los menús de selector de intervalo de tiempo debajo del cuadro de filtro de búsqueda.

Selector de intervalo de tiempo

La selección predeterminada es Última hora (Last hour). Puedes utilizar el menú desplegable para seleccionar otros intervalos de tiempo o definir uno:

  • Selecciona Saltar a un momento específico (Jump to time) para filtrar los registros en una fecha y hora particular.
  • Selecciona Personalizado (Custom) para especificar un intervalo personalizado o una zona horaria.

Para mostrar las entradas de registro actuales, haz clic en Pasar a los más recientes.

En todos los casos, las selecciones hacen que el visor de registros actualice la pantalla. Puedes desplazarte y también inspeccionar las entradas de registro que se muestran.

Para restablecer la fecha y la hora a fin de que se correspondan con la entrada de registro recibida más recientemente, haz clic en Actualizar o en el ícono Reproducir.

Cambia la zona horaria

Puedes seleccionar una zona horaria para tus entradas de registro:

  1. Desde el menú desplegable Última hora, selecciona Personalizado.
  2. Haz clic en la flecha desplegable (▾) en cualquiera de los nuevos menús para abrir el calendario desplegable.
  3. En el panel Zona horaria, selecciona tu país y zona horaria preferidos.

Tu selección hará que el visor de registros actualice la pantalla y la zona horaria de cada entrada de registro:

Personalizar la zona horaria

Expande las entradas de registro

En la tabla de entradas de registro se muestra, de forma predeterminada, una línea de resumen para cada entrada de registro.

Línea de resumen de una entrada de registro

La línea de resumen de la entrada de registro podría contener campos resaltados. Por ejemplo, los campos personalizados están resaltados.

Los campos incluidos en la línea de resumen se seleccionan como subconjuntos de los campos de entrada de registro. Ciertos campos se muestran de forma predeterminada si cumplen con uno o más de estos criterios:

  • La entrada de registro tiene un tipo conocido, como un registro de solicitud de App Engine.
  • La entrada de registro contiene el campo httpRequest.
  • La entrada de registro tiene una carga útil que contiene un campo llamado message.

A fin de ver los detalles completos de una entrada de registro, haz clic en la flecha desplegable (▸) al comienzo de la línea de resumen. Para ver los detalles completos, en una vista estructurada, de todas las entradas de registro disponibles con tu filtro actual, haz clic en el menú Opciones de vista (View Options) en el extremo derecho y, a continuación, selecciona Expandir todo (Expand all):

Ver el menú de opciones

Puedes seleccionar Contraer todo (Collapse All) para contraer todos los detalles expandidos de las entradas de registro.

Cuando expandes una línea de resumen de una entrada de registro, el visor de registros muestra una representación estructurada (JSON):

Entrada de registro de solicitud estructurada

Para obtener una descripción de los campos presentes en una entrada de registro, consulta el tipo LogEntry.

Agrega campos personalizados

Los campos personalizados son campos dentro de las entradas de registro que puedes especificar para que se los incluya en la línea de resumen. Estos campos se propagan y resaltan en azul cuando están disponibles en tus entradas de registro.

Campos personalizados en la línea de resumen

Existen dos maneras de agregar campos personalizados a tus líneas de resumen de la tabla de entradas de registro:

  • En una entrada de registro expandida, haz clic en un campo dentro de la representación JSON. En el panel que aparece, haz clic en Agregar campo a línea de resumen (Add field to summary line):

Agregar campo a línea de resumen

  • Desde el menú Opciones de visualización en el extremo superior derecho del visor de registros, selecciona Agregar campos personalizados (si ya tienes campos personalizados en este proyecto, esta opción será Modificar campos personalizados). En el panel que aparece, agrega la clave JSON deseada y haz clic en Guardar. Para agregar claves múltiples, sepáralas con una coma. Para reordenar la vista de tus campos personalizados en las líneas de resumen, reorganiza el texto en este panel y, a continuación, haz clic en Guardar.

Agregar campo JSON a la línea de resumen

Existen dos maneras de quitar campos personalizados de tus líneas de resumen de la tabla de entradas de registro:

  • Desde cualquier línea de resumen que incluya el campo personalizado que deseas quitar, haz clic en el campo y selecciona Quitar campo de línea de resumen.
  • Desde el menú Opciones de visualización en el extremo superior derecho del visor de registros, selecciona Modificar campos personalizados. En el panel que aparece, borra las claves JSON que deseas quitar y, a continuación, haz clic en Guardar.

Los campos personalizados se agregan a tu URL actual y permanecen mientras utilices esa URL o mientras permanezcas dentro de la misma sesión del navegador. No puedes configurarlos a nivel global, y no se los puede guardar por usuario o por proyecto de GCP.

Los campos predeterminados no se pueden quitar de la tabla de entradas de registro.

Fija una entrada de registro

Si identificaste una entrada de registro interesante y deseas investigar las entradas cercanas, puedes fijarla. Una vez que hayas fijado la entrada de registro, puedes cambiar el filtro y el visor de registros centrará automáticamente la búsqueda alrededor de la entrada fijada. Fijar la entrada de registro te permite examinarla en el contexto específico según un filtro que definas. Una vez que se fija un registro, cambia su fondo y se muestra una marca.

Entrada de registro marcada

Para fijar una entrada de registro, haz clic en el marcador o en Más (⋮) y, a continuación, selecciona Fijar esta entrada de registro.

Cuando fijas una entrada de registro, solo tú verás este marcador. Cualquier otro usuario que esté viendo las mismas entradas de registro no verá el marcador, ni se modificarán sus visualizaciones de ninguna manera.

Fijar una entrada de registro no cambia la interfaz de filtro, la configuración del filtro, ni actualiza el contenido que se muestra. Tú determinas la configuración del filtro y cuándo actualizar la pantalla del visor de registros. Puedes modificar la configuración del filtro y actualizar la pantalla tantas veces como quieras sin afectar el marcador.

Cuando se fija una entrada de registro se detiene la transmisión, si está habilitada actualmente.

Si hay una entrada de registro fijada, puedes moverla o quitarla.

  • Para mover el marcador a otra entrada de registro, en la nueva entrada de registro, haz clic en su ícono para fijar o en Más (⋮) y, a continuación, en Fijar esta entrada de registro.

  • Para quitar el marcador de una entrada de registro, haz clic en el símbolo para fijar o en Más (⋮) y, a continuación, selecciona Dejar de fijar esta entrada de registro.

Si habilitas la transmisión mientras que una entrada de registro está fijada, el visor de registros deja de fijarla.

Muestra registros similares

Puedes hacer clic en el valor de un campo individual en la vista de la entrada de registro expandida y ocultar o mostrar todas las entradas de registro con el mismo valor:

Mostrar las entradas coincidentes

Cuando haces esto, el visor de registros cambia a la interfaz de filtro avanzado. Para modificar la búsqueda, edita el filtro y, a continuación, haz clic en Enviar filtro. Para obtener más información, consulta la interfaz de filtro avanzado.

Además, puedes correlacionar las entradas de registro de solicitud de App Engine y, entonces, verlas en una estructura anidada. Para obtener más información, consulta Ve entradas de registro de solicitudes relacionadas y selecciona el lenguaje de tu entorno de ejecución.

Muestra detalles de latencia

Hay una característica nueva para los registros de solicitud de App Engine que permite que el visor de registros proporcione un vínculo a Stackdriver Trace para ver con facilidad los detalles de latencia de la entrada de registro.

Para mostrar el menú con opciones relacionadas con la latencia de una entrada de registro, identifica el campo protoPayload.latency:

Mostrar protoPayload.latency

Haz clic en el valor de latencia:

Mostrar opciones de latencia

Las primeras dos opciones en el menú restringen las entradas de registro que se muestran a aquellas con latencias mayores o inferiores. La última opción en el menú restringe las entradas de registro a aquellas que contienen detalles de seguimiento visualizables por Stackdriver Trace. Específicamente, la última opción restringe las entradas de registro a aquellas en donde Ver detalles de seguimiento está habilitado.

Ve detalles de latencia en Stackdriver Trace

Para ciertos registros de solicitud de App Engine, la opción Ver detalles de seguimiento está habilitada. Cuando lo esté, haz clic en esta opción para abrir Stackdriver Trace y mostrar los detalles de latencia de la entrada de registro:

Mostrar cronograma de seguimiento

Cómo mostrar en el contexto de los recursos

Si identificaste una entrada de registro interesante y deseas identificar otras entradas de registro relacionadas con el mismo tipo de recurso, haz clic en Más (⋮) en el extremo derecho de la línea y selecciona la opción Mostrar en contexto de recursos (Show in resource context):

Mostrar contexto

En respuesta a tu acción, el visor de registros hará lo siguiente:

  1. Fija la entrada de registro.
  2. Cambia a la interfaz de filtro avanzado y reemplaza el contenido del filtro con un filtro en el tipo de recurso.
  3. Actualiza la pantalla. La entrada de registro fijada se muestra hacia la parte inferior de la pantalla.

Mostrar en contexto

Comparte una entrada de registro

Para compartir una entrada de registro, haz clic en Más (⋮) y selecciona Copiar vínculo a la entrada de registro en el portapapeles. Esta acción hará que el visor de registros genere una URL única para la entrada de registro y que copia la URL en el portapapeles.

Selecciona registros

Utiliza los menús y el cuadro de filtro de búsqueda para encontrar los registros que deseas ver:

  • Selecciona un tipo de recurso y una instancia cuyos registros quieras ver. Puedes ver todas las instancias de este tipo de recurso o seleccionar una instancia en particular. En la captura de pantalla anterior, está seleccionada la instancia de VM en G​C​E (todas las instancias). Para obtener una lista de todos los tipos de recursos, consulta la Lista de recursos supervisados.

  • Selecciona los registros con nombre que deseas ver del segundo menú, o selecciona Todos los registros. El menú muestra los registros que están usando las instancias de recursos seleccionadas.

  • Selecciona el nivel de gravedad más bajo que quieras ver en el tercer menú. Si seleccionas Cualquier nivel de registro se mostrarán también las entradas de registro que no tienen gravedad asignada.

  • Selecciona el intervalo de tiempo que quieras ver en el cuarto menú, o selecciona Pasar a los más recientes en el quinto menú.

A medida que cambias las selecciones de tu menú, verás las entradas de registro que coincidan.

Notas del menú:

  • Solo se mostrarán en los menús los tipos de recursos, instancias y nombres de entradas que estén presentes en tu proyecto. La actualización de los menús una vez que hayas agregado un nuevo tipo de recurso o instancia, o que hayas escrito a un nuevo registro puede llevar un tiempo.

  • En la interfaz de filtro básico, puedes ver solamente entradas de registro de un tipo de recurso a la vez. La interfaz de filtro avanzado permite múltiples tipos de recursos.

  • No verás registros si navegas a una hora previa a tu ventana de retención. Para obtener más información, consulta los Períodos de retención de registros.

Descarga entradas de registro

Con tan solo unos clics, puedes descargar, en formato JSON o CSV, todas las entradas de registro almacenadas en la memoria de trabajo del visor de registros. Por razones de rendimiento, el visor de registros intenta cargar 100 entradas de registro a la vez y no retiene más de 300 en la memoria de trabajo. Estos valores no se pueden configurar.

Para descargar las entradas de registro, haz clic en el menú Descargar registros, ubicado en el extremo superior derecho del visor de registros. En la siguiente ventana de diálogo, selecciona JSON o CSV para Formato de entrada de registro (Log entry format) y, a continuación, haz clic en Descargar (Download):

Mostrar detalles de la descarga

A fin de ver entradas de registro con formato JSON o CSV en una página web, sigue los mismos pasos que para una descarga, pero selecciona Ver en una pestaña nueva (View In New Tab).

Busca con el visor de registros

Para restringir aún más tus búsquedas, utiliza filtros tanto en la interfaz de filtro básico como avanzado. La interfaz de filtro avanzado contiene la mayoría de las mismas funciones que la básica, pero tiene capacidades de búsqueda más sofisticadas.

Diferencias entre filtros básicos y avanzados

Las sintaxis de las interfaces de filtro básico y avanzado son diferentes. La interfaz de filtro básico está compilada con supuestos, por ejemplo, que todas las búsquedas distinguen entre mayúsculas y minúsculas, que no son válidos para la interfaz de filtro avanzado.

En las próximas secciones se resaltan diferencias clave en la sintaxis entre estas dos interfaces.

Palabra clave "text:"

El visor de registros muestra búsquedas de texto en el filtro básico; para ello, coloca de prefijo el texto con la etiqueta text:. No utilices la etiqueta text: con filtros avanzados.

En la siguiente tabla se muestran búsquedas de texto equivalentes:

Filtro básico del visor de registros Filtro avanzado de registros con el mismo significado
text:"one two" "one two"
text:three three
text:n=5 "n=5" (comillas obligatorias)

Si accidentalmente utilizas text: en un filtro avanzado, buscarás una coincidencia en un campo llamado text, que no existe.

Nombres de campos

La interfaz de filtro básico tiene nombres de campo integrados para ciertos registros, incluido el registro de solicitud de App Engine. Esos nombres de campo no existen en los filtros avanzados.

En la siguiente tabla se muestra una búsqueda de campo equivalente para un registro de solicitud de App Engine:

Filtro básico Filtro avanzado
querystring:var=3 protoPayload.resource:"var=3"
status:400..405 protoPayload.status >= 400 AND protoPayload.status <= 405

Si utilizas querystring:var=3 en el filtro avanzado, buscarás un campo llamado querystring, que no existe. Por lo tanto, el visor de registros no encuentra ninguna entrada de registro que coincida.

Coincidencias de subcadenas

En la interfaz de filtro básico, todas las búsquedas son coincidencias de subcadenas que distinguen entre mayúsculas y minúsculas. Es decir, las búsquedas text:abc o somefieldname:abc coinciden con las entradas de registro que contienen abc, xyabcyx y ABc. En los filtros de registros avanzados, debes utilizar el operador de búsqueda "has" (:) para el mismo comportamiento.

Para una coincidencia exacta, utiliza el operador igual (=). La comparación field=abc requiere que field contenga exactamente abc, en cualquier tipo de letra. La búsqueda no puede expresarse en la interfaz de filtro básico.

AND y OR

En la interfaz de filtro básico, dos comparaciones que usan el mismo nombre de campo (o text:) se unen implícitamente mediante OR, mientras que las comparaciones con etiquetas diferentes se unen con AND. En los filtros de registros avanzados, las comparaciones se unen con AND, a menos que OR se especifique explícitamente. También puedes usar paréntesis para agrupar comparaciones. En la siguiente tabla se muestran búsquedas equivalentes en las interfaces de ambos filtros:

Búsqueda de filtros básicos Búsqueda de filtros avanzados
text:abc querystring:def text:xyz protoPayload.resource:"def" AND ("abc" OR "xyz")

Rendimiento de la búsqueda

A continuación, se muestran algunas sugerencias para aumentar el rendimiento de la búsqueda:

  • Busca valores específicos de campos indexados, como el nombre de la entrada de registro, el tipo de recurso y las etiquetas de recursos. En la interfaz de filtro básico, esto se hace con las selecciones del menú. En la interfaz de filtro avanzado, utiliza condiciones como las que figuran a continuación:

    resource.type = "gce_instance"
    logName = "project/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Factivity"
    resource.labels.module_id="default"
    resource.labels.instance_id="1234567890"
    
  • Elige coincidencias exactas en vez de búsquedas de subcadenas. Especialmente en campos de índice, las coincidencias parciales son más lentas. En la interfaz de filtro básico, todas las búsquedas de texto son coincidencias parciales. En la interfaz de filtro avanzado, favorece las pruebas que utilicen el operador de igualdad (=) en vez de utilizar "has" (:).

  • Acorta el intervalo de tiempo de la búsqueda. No puedes hacer esto en la interfaz de filtro básico, pero en la de filtro avanzado puedes especificar un intervalo de tiempo:

    timestamp >= "2016-11-29T23:00:00Z" AND timestamp <= "2016-11-29T23:30:00Z"
    

Si deseas obtener más información sobre rendimientos, consulta Encuentra entradas de registro rápido.

Solución de problemas

En esta sección, se proporcionan instrucciones para solucionar problemas comunes durante la interacción o búsqueda con el visor de registros.

¡No hay registros!

Si no ves registros, controla los siguientes factores:

  • ¿Se seleccionó el proyecto correcto en la parte superior de la página? De lo contrario, usa el menú desplegable en la parte superior de la página para seleccionar un proyecto. Debes seleccionar el proyecto cuyos registros deseas ver.

  • ¿Tu proyecto tiene alguna actividad? Incluso si el proyecto es nuevo, debería tener registros de actividad o auditoría que registren su creación. Para obtener más registros puedes consultar la Guía de inicio rápido.

  • ¿El intervalo de tiempo es demasiado reducido? Puedes utilizar los menús desplegables debajo del cuadro de filtro de búsqueda para seleccionar otros intervalos de tiempo o definir un intervalo Personalizado. Selecciona Saltar a un momento específico para filtrar los registros en una fecha y hora particular, o utiliza el menú Pasar a los más recientes para ver las entradas de registro actuales.

¡Mi búsqueda no funciona!

Si no estás seguro de por qué tu búsqueda no funciona en la interfaz de filtro básico, cambia brevemente a la interfaz de filtro avanzado:

  1. Selecciona Convertir a filtro avanzado en el menú &blacktriangledown; al final del cuadro de filtro de búsqueda.
  2. Observa el filtro avanzado para ver si es lo que pretendías.
  3. Vuelve a la interfaz de filtro básico; para ello, utiliza el botón Atrás del navegador.

A continuación, te presentamos algunas razones por las cuales podrías no ver todas las entradas de registro que esperas:

  • No puedes ver entradas de registro anteriores al período de retención de Stackdriver Logging. Consulta Períodos de retención de registros para obtener el período de retención de registros vigente.

  • Durante períodos de mucha carga podría haber retrasos en el envío de registros a Stackdriver Logging, o en la recepción y visualización de estos.

  • El visor de registros no muestra las entradas de registro con marcas de tiempo en el futuro, a menos que el tiempo actual lo haya "alcanzado". Esta es una situación poco común, posiblemente causada por un desvío temporal en la aplicación que envía los registros.

¿Qué sigue?

¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Stackdriver Logging
Si necesitas ayuda, visita nuestra página de asistencia.