Consultar y ver registros

Una vez que el recopilador de registros extrae datos de varios componentes del proyecto, la plataforma Observabilidad agrega los registros de todas las fuentes de registros, añade índices y asocia los registros con etiquetas según la configuración de observabilidad de los datos. A continuación, puedes consultar y ver los registros en el panel de registros de la instancia de monitorización del sistema.

Consultar y ver registros en el panel de registros

Puedes consultar los registros a través de la interfaz de usuario (UI) de la instancia de monitorización del sistema de tu proyecto. La instancia de monitorización del sistema incluye medidas a nivel de proyecto para monitorizar los componentes de la infraestructura, como la utilización de la CPU, el consumo de almacenamiento, la monitorización de la red, la monitorización del servidor, los registros, las alertas y las métricas de los componentes de GDC.

Puedes ver los registros en el panel de registros de la instancia de monitorización del sistema de tu proyecto. Después, puedes hacer consultas para ver registros específicos de la observabilidad de los datos de tu caso práctico.

Antes de empezar

Antes de consultar y ver los registros en el panel de registros, debes obtener acceso a la instancia de monitorización del sistema. Para obtener más información, consulta Acceder a los paneles de control.

Para iniciar sesión y ver los registros en Grafana, pide al administrador de gestión de identidades y accesos de tu proyecto que te conceda el rol Lector de Grafana de proyectos (project-grafana-viewer). Este proceso de control de acceso basado en roles te permite acceder a las visualizaciones de datos de forma segura.

Crear consultas para tus registros

Consultar registros desde la interfaz de usuario de la instancia de monitorización del sistema te permite elegir la fuente de datos de la que quieres obtener los registros operativos de tu proyecto y ver tus consultas de forma integrada. Para filtrar los resultados, busca registros por etiquetas mediante expresiones del lenguaje de consulta. Por ejemplo, puede definir las etiquetas cluster y namespace en sus consultas con los valores que identifican su clúster y el espacio de nombres del proyecto, respectivamente.

Endpoint de instancia de monitorización del sistema

Para operadores de aplicaciones (AO)

La siguiente URL es el endpoint de la instancia de monitorización de tu proyecto:

https://GDC_URL/PROJECT_NAMESPACE/grafana

Haz los cambios siguientes:

  • GDC_URL: la URL de tu organización en GDC.
  • PROJECT_NAMESPACE: el espacio de nombres de tu proyecto.

Para administradores de la plataforma

La siguiente URL es el endpoint de la instancia de monitorización de tu proyecto:

https://GDC_URL/platform-obs/grafana

Sustituye GDC_URL por la URL de tu organización en GDC.

Consultar registros operativos

  1. En la consola de GDC, selecciona un proyecto.
  2. En el menú de navegación, haz clic en Operaciones > Registro.

  3. Haz clic en Ver todo en Grafana Loki.

    Se abrirá una página con la URL de la instancia de monitorización de tu proyecto.

  4. En la interfaz de usuario de la instancia de monitorización, haz clic en Explorar Explorar en el menú de navegación para abrir la página Explorar.

  5. En el menú desplegable de la barra Explorar, selecciona Registros operativos como fuente de datos para obtener los registros operativos.

  6. Introduce una consulta para buscar registros por etiquetas mediante expresiones de LogQL (lenguaje de consulta de registros). Puedes completar este paso de cualquiera de las siguientes formas:

    • Usa la interfaz de usuario interactiva del creador de consultas. A continuación, haz clic en Ejecutar consulta.
    • Introduce tu consulta con expresiones LogQL directamente en el campo de texto y pulsa Mayús+Intro para ejecutarla.

    En la página se muestran los registros que coinciden con tu consulta.

Después de consultar los registros, puedes exportarlos. Haz clic en Exportar para descargar los registros en formato de texto sin formato o CSV.

La opción Registros operativos está seleccionada en la página Explorar de la interfaz de usuario para obtener registros operativos.

Imagen 1. Opción de menú para consultar los registros de la interfaz de usuario de la instancia de monitorización del sistema.

En la figura 1, la opción Registros operativos muestra la interfaz que te permite crear consultas de registro desde la interfaz de usuario para recuperar registros operativos.

Para consultar registros de auditoría en lugar de registros operativos, selecciona Registros de auditoría como fuente de datos en el menú desplegable de la barra Explorar del paso anterior.

La opción Registros de auditoría está seleccionada en la página Explorar de la interfaz de usuario para obtener los registros de auditoría.

Imagen 2. Opción de menú para consultar los registros de auditoría desde la interfaz de usuario de la instancia de monitorización.

En la figura 2, la opción Registros de auditoría muestra la interfaz que te permite crear consultas desde la interfaz de usuario para recuperar registros de auditoría.

Después de consultar los registros, puedes exportarlos. Haz clic en el botón Exportar para descargar los registros en formato de texto sin formato o CSV.

Siga estos pasos para recuperar los registros operativos:

  1. En la consola de GDC, selecciona un proyecto.
  2. En el menú de navegación, haz clic en Operaciones > Registro.

  3. Haz clic en Ver todo en Grafana Loki.

    Se abrirá una página con la URL de la instancia de monitorización de tu proyecto.

  4. En la interfaz de usuario de la instancia de monitorización, haz clic en Explorar Explorar en el menú de navegación para abrir la página Explorar.

  5. En el menú desplegable de la barra Explorar, selecciona Registros operativos como fuente de datos para obtener los registros operativos.

  6. Introduce una consulta para buscar registros por etiquetas mediante expresiones de LogQL (lenguaje de consulta de registros). Puedes completar este paso de cualquiera de las siguientes formas:

    • Usa la interfaz de usuario interactiva del creador de consultas. A continuación, haz clic en Ejecutar consulta.
    • Introduce tu consulta con expresiones LogQL directamente en el campo de texto y pulsa Mayús+Intro para ejecutarla.

    En la página se muestran los registros que coinciden con tu consulta.

Después de consultar los registros, puedes exportarlos. Haz clic en Exportar para descargar los registros en formato de texto sin formato o CSV.

Consultar registros de auditoría

Sigue estos pasos para obtener los registros de auditoría:

  1. En la consola de GDC, selecciona un proyecto.
  2. En el menú de navegación, haz clic en Operaciones > Registro de auditoría.

  3. Haz clic en Ver todo en Grafana Loki.

    Se abrirá una página con la URL de la instancia de monitorización de tu proyecto.

  4. En la interfaz de usuario de la instancia de monitorización, haz clic en Explorar Explorar en el menú de navegación para abrir la página Explorar.

  5. En el menú desplegable de la barra Explorar, selecciona Registros de auditoría como fuente de datos para obtener los registros de auditoría.

  6. Introduce una consulta para buscar registros por etiquetas mediante expresiones de LogQL (lenguaje de consulta de registros). Puedes completar este paso de cualquiera de las siguientes formas:

    • Usa la interfaz de usuario interactiva del creador de consultas. A continuación, haz clic en Ejecutar consulta.
    • Introduce tu consulta con expresiones LogQL directamente en el campo de texto y pulsa Mayús+Intro para ejecutarla.

    En la página se muestran los registros que coinciden con tu consulta.

Después de consultar los registros, puedes exportarlos. Haz clic en Exportar para descargar los registros en formato de texto sin formato o CSV.

Selecciona un periodo para los registros

Para consultar registros de un intervalo de tiempo desde la interfaz de usuario de la instancia de monitorización, sigue estos pasos:

  1. Haz clic en el menú desplegable Selector de hora.

  2. En el menú, realiza una de las siguientes acciones:

    • Selecciona opciones de intervalo de tiempo relativo (por ejemplo, los últimos 30 minutos).
    • Para definir periodos absolutos personalizados, elige fechas y horas específicas en el calendario y haz clic en Aplicar periodo.

  3. También puedes hacer clic en Cambiar configuración de hora para modificar las opciones Zona horaria y Año fiscal de los controles de periodo.

Los ajustes de hora se guardan en cada panel de control. Para obtener más información sobre las consultas en un periodo, consulta https://grafana.com/docs/loki/latest/reference/api/#query-loki-over-a-range-of-time.

Consultas y etiquetas de ejemplo

Estas son algunas de las etiquetas predeterminadas que puedes usar para consultar registros:

  • cluster: el nombre del clúster
  • resources: la lista de recursos
  • namespace: el espacio de nombres de tu proyecto
  • node: prefijo del nombre del nodo
  • pod: el prefijo del nombre del pod
  • container: prefijo del nombre del contenedor

En la siguiente tabla se describen las etiquetas predeterminadas que puede usar para consultar los registros de la plataforma Observabilidad:

Registrar etiquetas
Tipo de registro Etiqueta Valor
Registros de contenedores de Kubernetes cluster CLUSTER_NAME
resources k8s_container o k8s_audit
namespace NAMESPACE_NAME
node NODE_NAME
pod POD_NAME
container CONTAINER_NAME
Otras etiquetas de Kubernetes
Registros de journald de nodos cluster CLUSTER_NAME
resources k8s_node
node NODE_NAME
identifier SYSLOG_IDENTIFIER
machine MACHINE_ID

Las consultas usan el lenguaje de consulta LogQL https://grafana.com/docs/loki/latest/logql/. En los siguientes ejemplos de código se muestra el uso de etiquetas y valores para consultar diferentes registros:

  • Selecciona todos los registros de un proyecto:

    {cluster="user-vm-1-cluster", namespace="PROJECT_NAMESPACE"}

    Sustituye PROJECT_NAMESPACE por el espacio de nombres de tu proyecto.

  • Selecciona los registros de un servicio:

    {cluster="user-vm-1-cluster", namespace="PROJECT_NAMESPACE", container="my-service"}

    Sustituye PROJECT_NAMESPACE por el espacio de nombres de tu proyecto.

  • Selecciona los registros del servidor de la API de Kubernetes:

    {cluster="admin", namespace="kube-system", resources="k8s_container", container="kube-apiserver"}

  • Selecciona los registros de arranque del clúster:

    {cluster="admin", namespace="PROJECT_NAMESPACE"}

    Sustituye PROJECT_NAMESPACE por el nombre del espacio de nombres de tu proyecto. Por ejemplo, cluster-user-test.

  • Selecciona los registros de journald del nodo:

    {cluster="admin", resources="k8s_node"}

  • Selecciona los registros de auditoría del clúster:

    {cluster="admin", resources="k8s_audit"}