Después de que el recopilador de registros extrae datos de varios componentes del proyecto, la plataforma de Observabilidad agrega registros de todas las fuentes de registros, agrega índices y asocia registros con etiquetas según la configuración de la observabilidad de los datos. Luego, puedes consultar y ver los registros en el panel de registros de la instancia de supervisión del sistema.
Consulta y visualiza registros en el panel de registros
Puedes consultar los registros a través de la interfaz de usuario (IU) de la instancia deinstancia de supervisión del sistema de tu proyecto. La instancia de supervisión del sistema incluye medidas a nivel del proyecto para supervisar los componentes de la infraestructura, como el uso de la CPU, el consumo de almacenamiento, la supervisión de la red, la supervisión del servidor, los registros, las alertas y las métricas de los componentes del GDC.
Puedes ver los registros en el panel de registros de la instancia de supervisión del sistema de tu proyecto. Luego, puedes realizar consultas para ver registros específicos sobre la observabilidad de los datos según las necesidades de tu caso de uso.
Antes de comenzar
Antes de consultar y ver los registros en el panel de registros, debes obtener acceso a la instancia de supervisión del sistema. Para obtener más información, consulta Cómo obtener acceso a los paneles.
Para acceder y ver los registros en Grafana, pídele a tu administrador de IAM del proyecto que te otorgue el rol de visualizador de Grafana del proyecto (project-grafana-viewer). Este proceso de control de acceso basado en roles te permite acceder a las visualizaciones de datos de forma segura.
Crea consultas para tus registros
Consultar registros desde la IU de la instancia de supervisión del sistema te permite elegir la fuente de datos para recuperar registros operativos de tu proyecto y obtener una vista integrada de tus consultas. Para filtrar los resultados, busca registros por etiquetas con expresiones del lenguaje de consultas. Por ejemplo, puedes establecer las etiquetas cluster y namespace en tus consultas con los valores que identifican tu clúster y el espacio de nombres del proyecto, respectivamente.
Extremo de la instancia de supervisión del sistema
Para el operador de la aplicación (AO)
La siguiente URL es el extremo de la instancia de supervisión de tu proyecto:
https://GDC_URL/PROJECT_NAMESPACE/grafana
Reemplaza lo siguiente:
- GDC_URL: URL de tu organización en GDC.
- PROJECT_NAMESPACE: Es el espacio de nombres de tu proyecto.
Para el administrador de la plataforma (PA)
La siguiente URL es el extremo de la instancia de supervisión de tu proyecto:
https://GDC_URL/platform-obs/grafana
Reemplaza GDC_URL por la URL de tu organización en GDC.
Consultar registros operativos
- En la consola de GDC, selecciona un proyecto.
- En el menú de navegación, haz clic en Operations > Logging.
Haz clic en Ver todo en Grafana Loki.
Se abrirá una nueva página con la URL de la instancia de supervisión de tu proyecto.
En la IU de la instancia de supervisión, haz clic en explorar Explorar en el menú de navegación para abrir la página Explorar.
En el menú desplegable de la barra Explorar, selecciona Registros operativos como la fuente de datos para recuperar los registros operativos.
Ingresa una consulta para buscar registros por etiquetas con expresiones de LogQL (lenguaje de consultas de registros). Puedes realizar este paso de una de las siguientes maneras:
- Usa la IU interactiva del compilador de consultas. Luego, haz clic en Ejecutar consulta.
- Ingresa tu consulta con expresiones de LogQL directamente en el campo de texto y presiona Mayúsculas + Intro para ejecutarla.
En la página, se muestran los registros que coinciden con tu búsqueda.
Después de consultar los registros, puedes exportarlos. Haz clic en Exportar para descargar los registros en formato de texto sin formato o CSV.
Figura 1. Opción de menú para consultar registros desde la IU de la instancia de supervisión del sistema.
En la figura 1, la opción Operational Logs muestra la interfaz que te permite crear consultas de registros desde la IU para recuperar registros operativos.
Para consultar los registros de auditoría en lugar de los registros operativos, selecciona Registros de auditoría como la fuente de datos en el menú desplegable de la barra Explorar del paso anterior.
Figura 2. Opción de menú para consultar los registros de auditoría desde la IU de la instancia de supervisión.
En la figura 2, la opción Registros de auditoría muestra la interfaz que te permite crear consultas desde la IU 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.
Para recuperar los registros operativos, completa los siguientes pasos:
- En la consola de GDC, selecciona un proyecto.
- En el menú de navegación, haz clic en Operations > Logging.
Haz clic en Ver todo en Grafana Loki.
Se abrirá una nueva página con la URL de la instancia de supervisión de tu proyecto.
En la IU de la instancia de supervisión, haz clic en explorar Explorar en el menú de navegación para abrir la página Explorar.
En el menú desplegable de la barra Explorar, selecciona Registros operativos como la fuente de datos para recuperar los registros operativos.
Ingresa una consulta para buscar registros por etiquetas con expresiones de LogQL (lenguaje de consultas de registros). Puedes realizar este paso de una de las siguientes maneras:
- Usa la IU interactiva del compilador de consultas. Luego, haz clic en Ejecutar consulta.
- Ingresa tu consulta con expresiones de LogQL directamente en el campo de texto y presiona Mayúsculas + Intro para ejecutarla.
En la página, se muestran los registros que coinciden con tu búsqueda.
Después de consultar los registros, puedes exportarlos. Haz clic en Exportar para descargar los registros en formato de texto sin formato o CSV.
Consulta registros de auditoría
Para recuperar los registros de auditoría, completa los siguientes pasos:
- En la consola de GDC, selecciona un proyecto.
- En el menú de navegación, haz clic en Operaciones > Registro de auditoría.
Haz clic en Ver todo en Grafana Loki.
Se abrirá una nueva página con la URL de la instancia de supervisión de tu proyecto.
En la IU de la instancia de supervisión, haz clic en explorar Explorar en el menú de navegación para abrir la página Explorar.
En el menú desplegable de la barra Explorar, selecciona Registros de auditoría como la fuente de datos para recuperar los registros de auditoría.
Ingresa una consulta para buscar registros por etiquetas con expresiones de LogQL (lenguaje de consultas de registros). Puedes realizar este paso de una de las siguientes maneras:
- Usa la IU interactiva del compilador de consultas. Luego, haz clic en Ejecutar consulta.
- Ingresa tu consulta con expresiones de LogQL directamente en el campo de texto y presiona Mayúsculas + Intro para ejecutarla.
En la página, se muestran los registros que coinciden con tu búsqueda.
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 intervalo de tiempo para tus registros
Para consultar los registros en un período desde la IU de la instancia de supervisión, sigue estos pasos:
Haz clic en el menú desplegable Selector de hora .
En el menú, realiza una de las siguientes acciones:
- Selecciona opciones de intervalo de tiempo relativo, por ejemplo, los últimos 30 minutos.
- Establece períodos absolutos personalizados eligiendo fechas y horas específicas en el calendario y haciendo clic en Aplicar período.
De manera opcional, haz clic en Cambiar la configuración de hora para cambiar la configuración de Zona horaria y Año fiscal desde los controles de período.
La configuración de hora se guarda por panel. Para obtener más información sobre las consultas en un período, consulta https://grafana.com/docs/loki/latest/reference/api/#query-loki-over-a-range-of-time.
Ejemplos de búsquedas y etiquetas
Estas son algunas de las etiquetas predeterminadas que puedes usar para consultar registros:
cluster: el nombre del clústerresources: Es la lista de recursos.namespace: Es el espacio de nombres de tu proyecto.node: Es el prefijo del nombre del nodo.pod: Es el prefijo del nombre del Pod.container: Es el prefijo del nombre del contenedor.
En la siguiente tabla, se describen cada una de las etiquetas predeterminadas que puedes usar para consultar registros de la plataforma de Observabilidad:
| 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 del nodo | cluster |
CLUSTER_NAME |
resources |
k8s_node |
|
node |
NODE_NAME | |
identifier |
SYSLOG_IDENTIFIER | |
machine |
MACHINE_ID |
Las consultas usan el lenguaje de consultas LogQL https://grafana.com/docs/loki/latest/logql/. En las siguientes muestras 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"}Reemplaza
PROJECT_NAMESPACEpor el espacio de nombres de tu proyecto.Selecciona los registros del proyecto de un servicio:
{cluster="user-vm-1-cluster", namespace="PROJECT_NAMESPACE", container="my-service"}Reemplaza
PROJECT_NAMESPACEpor 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"}Reemplaza PROJECT_NAMESPACE por el nombre del espacio de nombres de tu proyecto. Por ejemplo,
cluster-user-testSelecciona 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"}