Muestra registros y errores en un panel personalizado

En este documento, se describen los widgets que puedes agregar a tus paneles personalizados. para ver tus datos de registros y errores en el mismo contexto que datos de métricas. El widget del panel de registros muestra entradas de registro. El widget del panel de informes de errores muestra los grupos de errores más recientes. Ambos los widgets proporcionan información útil para solucionar problemas. El widget de gráfico de Análisis de registros, que muestra los resultados de una consulta en SQL, te permite identificar tendencias en tus datos de registro.

Explorador de registros y widget del panel de registros

El Explorador de registros es la forma estándar de investigar los registros. Agregar un widget del panel de registros a un panel no cambiará la forma en la que usas el Explorador de registros. Como los widgets del panel de registros se pueden agregar en paneles personalizados, te permiten a ver tus entradas de registro en el mismo contexto que tus métricas.

El Explorador de registros y el widget del panel de registros admiten las mismo lenguaje de consulta y ambos muestran solo aquellos las entradas de registro que tienes permiso para ver. Tu Roles de Identity and Access Management (IAM) en los recursos que almacenan las entradas de registro que se recuperan se usan para determinar si puedes ver esas entradas de registro.

El Explorador de registros y el widget del panel de registros están preconfigurados para recuperar de buckets de registros las entradas de registro que se originan en tu proyecto de Google Cloud o que estén enrutados a tu proyecto actual. Puedes configurar qué entradas de registro se recuperan. Por ejemplo, puedes especificar que las entradas de registro de una vista de registro se recuperan para mostrarlas.

Los widgets del panel de registros muestran una entrada de registro por fila, con columnas para gravedad, la marca de tiempo y un de la entrada de registro. Para ver la representación con formato JSON de un registro haz clic en el botón Ver detalles del registro. La estructura del resumen de cada entrada varía según el tipo de registro. Por ejemplo: En la siguiente imagen, se muestran dos entradas de registro:

Imagen de dos entradas de registro en el widget del panel de registros.

En la foto anterior, se muestra la primera entrada de registro información sobre una solicitud de servicio. El resumen muestra información sobre el servicio, una dirección de correo electrónico y una versión con formato de cadena de la JSON para la entrada. La segunda entrada muestra los resultados de una solicitud. muestra solo una oración que resume la acción que se produjo.

Para obtener información general sobre Cloud Logging, consulta los siguientes recursos:

Antes de comenzar

Para obtener los permisos que necesitas para agregar un widget del panel de registros a un panel personalizado con la consola de Google Cloud y configurarla para que muestre entradas de registro en proyectos o vistas de registro, solicita a tu administrador que te otorgue el los siguientes roles de IAM:

Si quieres obtener más información para otorgar roles, consulta Administra el acceso.

También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.

Muestra entradas de registro en un panel

En esta sección, se describe cómo agregar y configurar un widget del panel de registros con la consola de Google Cloud. Para obtener información sobre el uso de la API de Cloud Monitoring, consulta Panel con un widget LogsPanel.

Un widget del panel de registros está preconfigurado para recuperar entradas de registro que se originan en tu proyecto de Google Cloud y aquellos que se enrutan a tu proyecto de Google Cloud. Sin embargo, puedes configurar a qué entradas de registro El widget del panel de registros se recupera de los buckets de registros. Por ejemplo, podrías configurar el widget para que solo muestre entradas de registro que indiquen algún tipo de condición de error o solo esas entradas de registro una vista de registro.

Puedes colocar hasta 40 gráficos en un panel.

Para agregar un widget del panel de registros al panel con la consola, haz lo siguiente:

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

    Dirígete a Paneles de control

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

  2. Selecciona un panel o haz clic en Crear panel.
  3. En la barra de herramientas, haz clic en  Agregar widget.
  4. En el diálogo Agregar widget, selecciona  Registros.
  5. Opcional: Para actualizar el título, escribe el nuevo en la Campo Título del widget.

  6. Opcional: Para modificar qué entradas de registro se recuperan, haz lo siguiente: realiza una de las siguientes acciones:

    • Recuperar entradas de registro de un proyecto diferente o de varias proyectos, en la entrada Proyecto, expande Current project y completa el . En el menú, se enumeran todos los proyectos de Google Cloud en el permiso de métricas actual.

      Si una entrada del menú incluye el texto "No tienes permiso a nivel de proyecto para ver los registros de este proyecto", no tienes los permisos necesarios para ver las entradas de registro del proyecto de Google Cloud.

    • Para recuperar entradas de registro que se incluyen en vistas de registro en buckets de registros, haz lo siguiente:

      1. En la entrada Limitar alcance por, expande Proyecto, y, luego, selecciona Almacenamiento.
      2. En la entrada Vistas del almacenamiento, expande Proyecto actual y completa el diálogo. El menú enumera las vistas de registros en buckets de registros en tu proyecto de Google Cloud. Para seleccionar vistas de registros en buckets de registros en otros proyectos de Google Cloud, en el menú, haz clic en Importar proyecto seleccionar un proyecto y, luego, seleccionar una o más vistas de registro. Solo puedes importar proyectos incluidas en el permiso de métricas actual.

  7. Opcional: Para restringir los registros que muestra el widget del panel de registros, ingresar una consulta en el campo Editor de consultas y, si inhabilitaste que las consultas se ejecuten automáticamente, luego haz clic en Ejecutar consulta. Para ver una breve introducción a las consultas, consulta Ejemplos de consultas.

  8. Opcional: Aplica variables de plantilla al widget del panel de registros. Para ver más información, consulta Agrega filtros permanentes a un panel personalizado.

  9. Para aplicar los cambios al panel, en la barra de herramientas, Haz clic en Aplicar. Para descartar los cambios, haz clic en Cancelar.

  10. Para guardar el panel modificado, haz clic en Guardar en la barra de herramientas.

    El widget del panel de registros muestra una tabla del registro recuperado entradas que también coincidan con tu consulta. También puedes usar el filtro del widget para cambiar temporalmente las entradas de registro que muestra el widget. Para obtener más información, consulta la sección titulada Filtra las entradas de registro.

Ejemplos de consultas

Para completar el campo Editor de consultas, puedes ingresar texto en el o puedes seleccionar desde los menús. El editor de consultas usa el mismo lenguaje de consulta que Explorador de registros. Para obtener información sobre la solución de problemas, consulta Problemas de sintaxis.

Los menús Gravedad y Nombre del registro te permiten seleccionar varias opciones. El siguiente es un ejemplo de una instrucción de consulta que coincide con varias niveles de gravedad:

severity=(WARNING OR ERROR OR CRITICAL OR ALERT OR EMERGENCY)

El menú Recurso te permite filtrar por recurso. Puedes seleccionar un tipo de recurso, como Audited Resource, o puedes navegar a través de las ventanas para seleccionar un método específico.

Por ejemplo, para agregar una consulta para Audited Resource, haz lo siguiente:

  1. Expande el menú Recurso.
  2. Busca y selecciona Recurso auditado.

  3. Haz clic en Aplicar.

    Con estos pasos, se agrega la siguiente cláusula al editor de consultas. :

    resource.type="audited_resource"

Del mismo modo, para agregar una consulta a los registros de auditoría de Cloud Functions, haz lo siguiente: lo siguiente:

  1. Expande el menú Recurso.
  2. Busca y selecciona Recurso auditado.
  3. En el menú de servicios, selecciona Cloud Functions.

  4. Haz clic en Aplicar.

    Con estos pasos, se agrega la siguiente cláusula al editor de consultas. :

    resource.type="audited_resource" resource.labels.service="cloudfunctions.googleapis.com"

Filtra las entradas de registro

Puedes modificar qué entradas de registro muestra un widget del panel de registros modificando los valores de los siguientes campos o menús:

  • Selector de hora del panel: el widget del panel de registros solo recupera de las entradas de registro se escribe en el intervalo especificado por este campo.

  • Campo Filter en el widget del panel de registros: Se aplicará el filtro que especifiques una vez completada la consulta. El valor de este campo se conserva solo durante sesión actual.

  • Menú Gravedad en el widget del panel de registros: el filtro por nivel de gravedad se aplica una vez completada la consulta. Se conserva el valor de este campo solo para la sesión actual.

  • Consulta en el widget del panel de registros: muestra el widget del panel de registros solo las entradas de registro que coinciden con la consulta. Si no especificas una consulta, todos los registros se mostrarán el intervalo de tiempo seleccionado. Si especificas una consulta, el widget del panel de registros muestra el mensaje Mostrar consulta que muestra la consulta actual como información sobre la herramienta.

    Para modificar la consulta, edita el widget del panel de registros.

  • Proyecto de Google Cloud en el widget del panel de registros. Para modificar este parámetro de configuración, editar el widget del panel de registros.

  • Filtros del panel: Cuando existen filtros del panel, el parámetro de configuración de filtros se aplica a la consulta del widget del panel de registros. Por ejemplo, si agregas el filtro del panel cluster_name: mycluster, entonces la consulta será para incluir resource.labels."cluster_name"="mycluster". Para obtener más información sobre los filtros del panel, consulta Agrega filtros temporales y Agrega filtros permanentes.

En el resto de esta sección, se proporciona información adicional filtrar tus entradas de registro.

Ejemplo: filtra entradas de registro por fecha

Para mostrar los registros más recientes en un widget del panel de registros, usa los campos de tiempo en la barra de herramientas del panel. Por ejemplo, selecciona 1 H. Siempre que no selecciones un intervalo de tiempo personalizado, el widget siempre muestra los registros más recientes, incluso cuando están anterior al período seleccionado.

Cuando investigas un incidente, quizás quieras restringir el las entradas de registro a aquellas que están en un intervalo de tiempo específico. Para configurar las entradas de registro para mostrar registros que están en un intervalo de tiempo fijo realizar una de las siguientes acciones o ambas:

  • Selecciona un intervalo de tiempo con el selector de intervalo de tiempo.
  • Ingresa una cláusula timestamp en el campo Editor de consultas de la de configuración y, luego, selecciona Aplicar filtro.

Cuando especificas un intervalo de tiempo, el widget del panel de registros actual.

Ejemplo: Filtra entradas de registro por gravedad

Cuando supervises la depuración de una situación de falla, para ver los mensajes de error y ocultar de la pantalla todas las demás entradas de registro. Configurar un widget del panel de registros para que muestre solo las entradas de registro que satisfacer niveles de gravedad específicos, realiza una de las siguientes acciones, o ambas:

  • Para aplicar un filtro temporal, selecciona un valor para el menú Gravedad en el widget del panel de registros. Este menú especifica un nivel de gravedad mínimo. Por ejemplo, el valor “Advertencia” genera entradas de registro con la gravedad “Error” se están recuperando, pero esos entradas de registro con la gravedad “Aviso” no se recuperan. De forma predeterminada, el valor para este campo se establece en Default, que incluye todos los registros de entradas de registro.

    El parámetro de configuración del menú Gravedad se descarta cuando navegas del panel.

  • Para aplicar un filtro permanente, ingresa una cláusula severity en el Editor de consultas del panel de configuración. y, luego, selecciona Aplicar filtro.

Ejemplo: filtra entradas de registro por una string o frase

Filtrar entradas de registro por cadena o frase específica te permite eliminar ver entradas de registro que no son de interés. Por ejemplo, para ver entradas de registro que incluyan una dirección de correo electrónico específica, puedes filtrarlos por esa dirección.

  • Para aplicar un filtro temporal y ver solo las entradas de registro que contiene una palabra o frase específica, usa el Filtro. El elemento contiene-prueba no distingue mayúsculas de minúsculas.

    Si agregas varios filtros, solo se mostrarán los registros que coincidan con todos los filtros. porque se inserta un AND implícito entre filtros adyacentes. Sin embargo, puedes insertar de forma explícita un operador OR:

    • Por ejemplo, cuando agregas los filtros Get y Compute, las entradas de registro que contengan ambas palabras.

    • Por ejemplo, cuando agregues los filtros Get, OR y Compute, registra se muestran entradas que contienen Get o Compute.

    El valor del campo de Filtro no es persistente.

  • Para aplicar un filtro permanente, modifica la consulta almacenada en Editor de consultas y, luego, selecciona Aplicar filtro. Para obtener información sobre la sintaxis de la consulta, visita Lenguaje de consulta de Logging.

    Por ejemplo, para mostrar solo las entradas de registro con un campo MESSAGE. cuyo valor contenga la cadena "lamp", agrega la cláusula jsonPayload.MESSAGE:"lamp" al Editor de consultas.

Visualiza entradas de registro en el Explorador de registros

Los widgets del panel de registros muestran campos clave de entradas de registro, no muestran entrada de registro completa. Para examinar todos los campos de una entrada de registro, haz lo siguiente:

  1. En el widget del panel de registros, selecciona Ver en el Explorador de registros.

  2. En el cuadro de diálogo, selecciona el proyecto de Google Cloud en el que deseas abrir el contenido. el Explorador de registros.

    El Explorador de registros se abre en una nueva pestaña del navegador, y los filtros seleccionados en el widget del panel de registros se aplican automáticamente.

  3. Selecciona la entrada de registro que quieres ver.

Mostrar gráficos generados a partir de una consulta de Análisis de registros

En esta sección, se describe cómo configurar y guardar un gráfico generado a partir de un Consulta del Análisis de registros a un panel personalizado. El Análisis de registros te permite buscar y agregar registros para generar estadísticas útiles a través de consultas en SQL.

Además de usar la página Análisis de registros para configurar y guardar gráficos en un panel, puedes guardar un gráfico del Análisis de registros directamente en Monitoring de la siguiente manera:

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

    Dirígete a Paneles de control

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

  2. Selecciona un panel o haz clic en Crear panel.
  3. En la barra de herramientas, haz clic en  Agregar widget.
  4. En el diálogo Agregar widget, ve a la sección Datos. y, luego, selecciona Análisis de registros.
  5. En el panel Configurar widget, configura los datos que se mostrarán en la gráfico creando una consulta con SQL y, luego, haz clic en Ejecutar consulta.

  6. Opcional: En la pestaña Resultados, personaliza la configuración del gráfico según desde el panel Pantalla.

    En el panel Display, puedes cambiar el tipo de gráfico y personalizar cuál para representar filas y columnas se deben cambiar las dimensiones, la medida y desglose:

    • Dimensión: La dimensión debe ser una columna de marca de tiempo, numérica o de cadena. De forma predeterminada, la dimensión se establece en la primera columna basada en marca de tiempo en el esquema. Si no hay una marca de tiempo presente en la consulta, el se selecciona la primera columna de cadena como la dimensión. También puedes personalizar la dimensión el panel Visualización del gráfico. Cuando se selecciona una columna de marca de tiempo como la dimensión, el gráfico muestra cómo cambian los datos con el tiempo.

    • Medir: Puedes seleccionar varias mediciones en el panel Chart display. Cuando seleccionas una medición, también debes seleccionar la función de agregación para realizar en sus valores agrupados, como count, sum, average y percentile-99. Por ejemplo, count-distinct muestra la cantidad de valores únicos en una columna determinada.

    • Desglose: Para dividir una sola serie de datos en varias series de datos basadas en otra columna, agrega un desglose.

    Para obtener más información sobre cómo personalizar la configuración del gráfico, consulta Personaliza la configuración del gráfico.

  7. Para guardar el panel modificado, haz clic en Guardar en la barra de herramientas.

Los gráficos del Análisis de registros también se pueden editar después de guardarlos en un panel. Para obtener más información, consulta Modifica la configuración de un widget.

Muestra errores en un panel

En esta sección, se describe cómo agregar y configurar un panel de informes de errores con la consola de Google Cloud. Para obtener información sobre cómo agregar un panel de informes de errores a un panel con la API de Cloud Monitoring, consulta Panel con un widget ErrorReportingPanel.

Para agregar un panel de informes de errores al panel con la consola, haz lo siguiente:

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

    Dirígete a Paneles de control

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

  2. Selecciona un panel o haz clic en Crear panel.
  3. En la barra de herramientas, haz clic en  Agregar widget.
  4. En el diálogo Agregar widget, ve a la sección Visualización. Luego, selecciona el panel de Error Reporting.
  5. Selecciona el proyecto cuyos grupos de errores se muestran. Expande Projects y, luego, selecciona una opción.
  6. Opcional: Actualiza el título.

  7. Opcional: Para restringir los recursos para los que se muestran errores, haz lo siguiente:

    1. Expande Todos los recursos y selecciona un recurso.

    2. Luego de seleccionar un recurso, puedes elegir Aplicar o usa los menús adicionales para definir mejor los criterios de filtro:

      • Para mostrar los errores de los recursos de App Engine, selecciona Servicios de GAE y, luego, haz clic en Aplicar.

      • Para mostrar los errores de un servicio específico de App Engine, selecciona Servicios de GAE, selecciona el servicio y, luego, haz clic en Aplicar.

  8. Para aplicar los cambios al panel, en la barra de herramientas, Haz clic en Aplicar. Para descartar los cambios, haz clic en Cancelar.

    En el siguiente ejemplo, se muestra un panel de Error Reporting:

    Ejemplo de un panel de configuración de un panel de informes de errores.

  9. Para guardar el panel modificado, haz clic en Guardar en la barra de herramientas.

Solucionar problemas

¿Qué sigue?