Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Inicia sesión en Explore
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana.
Para ver los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana, consulte. Trabajando en Grafana versión 9
Para ver los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte. Trabajando en Grafana versión 8
Explore le permite investigar sus registros en diferentes fuentes de datos, entre las que se incluyen:
Durante el monitoreo de la infraestructura y la respuesta a un incidente, puede profundizar en las métricas y los registros para encontrar la causa. Explore también le permite correlacionar los registros con otras señales de telemetría, como métricas, seguimientos o perfiles, mediante su visualización. side-by-side
Los resultados de las consultas de registro se muestran como líneas de registro individuales y como un gráfico que muestra el volumen de registros durante el período de tiempo seleccionado.
Volumen de registros
Al trabajar con fuentes de datos que admiten un volumen de registros de rango completo, Explore muestra automáticamente un gráfico que muestra la distribución de registros de todas las consultas de registro introducidas. Actualmente, esta función es compatible con las fuentes OpenSearch de datos de Loki.
nota
En Loki, este volumen de registro de rango completo se representa mediante una consulta métrica que puede resultar costosa según el rango de tiempo consultado. Esta consulta puede ser particularmente difícil de procesar en instalaciones de Loki más pequeñas. Para mitigar esto, puedes usar un proxy como nginxX-Query-Tags
con valorSource=logvolhist
; Grafana agrega estos encabezados a todas las consultas de histogramas de volumen de registro.
Si la fuente de datos no permite cargar todo el volumen de registros, el modelo de registros calcula una serie temporal contando las filas del registro y organizándolas en grupos en función de un intervalo de tiempo que se calcula automáticamente. La marca de tiempo de la primera fila de registros se utiliza para fijar el inicio del volumen de registros en los resultados. El final de la serie temporal está anclado al rango To del selector de tiempo. De esta forma, puede seguir analizando y visualizando los datos de registro de manera eficiente, incluso cuando la fuente de datos no ofrezca soporte de rango completo.
Registros
En las siguientes secciones, encontrará explicaciones detalladas sobre cómo visualizar los registros individuales e interactuar con ellos en Explore.
Navegación de registros
La navegación por los registros, situada en el lado derecho de las líneas de registro, se puede utilizar para solicitar fácilmente registros adicionales. Para ello, haga clic en el botón Registros más antiguos situado en la parte inferior de la barra de navegación. Esto resulta especialmente útil cuando llegas al límite de líneas y quieres ver más registros. A continuación, cada solicitud que se ejecuta desde la navegación se muestra en la navegación como una página independiente. En cada página se muestran from
las to
líneas de registro entrantes y las marcas de tiempo. Puede ver los resultados anteriores haciendo clic en cada página. Explore almacena en caché las últimas cinco solicitudes ejecutadas desde la navegación de registros, por lo que no se vuelven a ejecutar las mismas consultas al hacer clic en las páginas, lo que ahorra tiempo y recursos.
Opciones de visualización
Puede personalizar la forma en que se muestran los registros y seleccionar las columnas que se muestran.
Opción | Descripción |
---|---|
Tiempo | Muestra u oculta la columna de tiempo. Esta es la marca de tiempo asociada a la línea de registro tal como se indica en la fuente de datos. |
Etiquetas únicas | Muestra u oculta la columna de etiquetas únicas que incluye solo las etiquetas no comunes. Todas las etiquetas comunes se muestran arriba. |
Líneas de envoltura | Configúrelo true si desea que la pantalla utilice el ajuste de líneas. Si se establece enfalse , se producirá un desplazamiento horizontal. |
Embellece JSON | Configúrelo true para que imprima de forma bonita todos los registros JSON. Esta configuración no afecta a los registros en ningún formato que no sea JSON. |
Desduplicación | Los datos de registro pueden ser muy repetitivos y Explore puede ayudar a ocultar las líneas de registro duplicadas. Hay varios algoritmos de deduplicación diferentes que puede usar. Las coincidencias exactas se realizan en toda la línea, excepto en los campos de fecha. Las coincidencias numéricas se realizan en la línea después de eliminar números como la duración, las direcciones IP, etc. La firma es la deduplicación más agresiva, ya que elimina todas las letras y números y hace coincidir los espacios en blanco y los signos de puntuación restantes. |
Muestra el orden de los resultados | Puede cambiar el orden de los registros recibidos del orden descendente predeterminado (los más nuevos primero) a un orden ascendente (los más antiguos primero). |
Descargue las líneas de registro
Para descargar los resultados del registro en txt
cualquiera de los dos json
formatos, utilice el botón Descargar. Esta función le permite guardar los datos de registro para analizarlos más a fondo o compartirlos con otras personas en un formato cómodo y accesible.
Registre la metainformación de los resultados
Sobre las líneas de registro recibidas, puede encontrar la metainformación esencial, que incluye:
-
Número de registros recibidos: indica el recuento total de registros recibidos para la consulta o el intervalo de tiempo actuales.
-
Error: muestra un posible error en los resultados del registro.
-
Etiquetas comunes: muestra las etiquetas comunes.
-
Total de bytes procesados: representa el tamaño acumulado de los datos de registro procesados en bytes.
nota
La disponibilidad de cierta metainformación puede depender de la fuente de datos y, como resultado, es posible que solo vea algunos de estos detalles para fuentes de datos específicas.
¿Escapar de las nuevas líneas
Explore detecta automáticamente algunas secuencias que se escapan incorrectamente en las líneas de registro, como las líneas nuevas (\n
,\r
) o las pestañas (). \t
Cuando detecta este tipo de secuencias, Explore ofrece la opción Escapar de las nuevas líneas.
Para corregir automáticamente las secuencias que se han escapado incorrectamente y que Explore ha detectado
-
Seleccione Escapar de las nuevas líneas para reemplazar las secuencias.
-
Revise manualmente los reemplazos para confirmar que son correctos.
Explore reemplaza estas secuencias. Cuando lo haga, la opción cambiará de Escape newlines a Remove escaping. Evalúe los cambios, ya que el análisis puede no ser preciso en función de la entrada recibida. Puede revertir los reemplazos seleccionando Eliminar escaping.
Nivel de registro
Para los registros en los que se especifica una level
etiqueta, utilizamos el valor de esta etiqueta para determinar el nivel de registro y actualizar el color de cada línea de registro en consecuencia. Si el registro no tiene una etiqueta de nivel especificada, intentamos averiguar si su contenido coincide con alguna de las expresiones admitidas (consulte la siguiente tabla para obtener más información). El nivel de registro siempre viene determinado por la primera coincidencia. En el caso de que Grafana no pueda inferir un campo de nivel de registro, se visualizará con un nivel de registro desconocido.
nota
Si utilizas una fuente de datos de Loki y forma parte de tu línea de registro, puedes usar analizadores (JSON, logfmt, regex,..) para extraer la información del nivel y convertirla en una etiqueta de nivel que se utilice para determinar el valor del nivel. level
Esto permitirá que el histograma muestre los distintos niveles de registro como barras independientes.
Niveles de registro admitidos y mapeo de abreviaturas y expresiones a nivel de registro:
Nivel de registro | Color | Expresiones compatibles |
---|---|---|
crítica | morado | emerger, fatal, alerta, crítico, crítico |
error | red | error, error, error |
Advertencia | amarillo | advertencia, advertencia |
info | green | información, información, información, aviso |
depuración | azul | depurar, depurar |
rastro | azul claro | rastro |
desconocido | gris | * |
Resalta las palabras buscadas
Cuando la consulta incluya palabras o expresiones específicas que desee buscar, Explore las resaltará en las líneas del registro para mejorar la visibilidad. Esta función de resaltado facilita la identificación del contenido relevante de los registros y la concentración en él.
nota
La capacidad de resaltar las palabras de búsqueda puede variar en función de la fuente de datos. En el caso de algunas fuentes de datos, es posible que no esté disponible el resaltado de las palabras de búsqueda.
Vista de detalles del registro
En Explore, cada línea de registro tiene una sección ampliable denominada Detalles del registro que se puede abrir seleccionando la línea de registro. La vista de detalles del registro proporciona información adicional y opciones de exploración en forma de campos y enlaces adjuntos a las líneas de registro, lo que permite una interacción y un análisis más sólidos.
Campos
En la vista de detalles del registro, puede filtrar los campos mostrados de dos maneras: un filtro positivo (para centrarse en un campo específico) y un filtro negativo (para excluir determinados campos). Estos filtros actualizarán la consulta correspondiente que generó la línea de registro y añadirán las expresiones de igualdad y desigualdad correspondientes. Si la fuente de datos es compatible, como es el caso de Loki OpenSearch, los detalles del registro comprobarán si el campo ya está presente en la consulta actual y en su estado activo (solo para los filtros positivos), lo que le permitirá desactivarlo en la consulta o cambiar la expresión del filtro de positiva a negativa.
Puede seleccionar un subconjunto de campos para visualizarlos en la lista de registros en lugar de en la línea de registro completa haciendo clic en el icono del ojo. Cada campo tiene un icono de estadísticas para mostrar las estadísticas de todos los registros mostrados.
Enlaces
Grafana ofrece la funcionalidad de enlaces o correlaciones de datos, lo que le permite convertir cualquier parte de un mensaje de registro en un enlace interno o externo. Estos enlaces se pueden utilizar para navegar a datos relacionados o recursos externos, lo que proporciona una forma cómoda y sencilla de explorar más información.
Contexto de registro
El contexto del registro muestra líneas de contexto adicionales que rodean una entrada de registro que coincide con una consulta de búsqueda concreta. Esto puede resultar útil para comprender el contexto de la entrada de registro y es similar al -C
parámetro del grep
comando.
Es posible que encuentre largas líneas de texto que dificulten la lectura y el análisis del contexto que rodea a cada entrada del registro. Aquí es donde la opción Ajustar líneas puede resultar útil. Al habilitar esta opción, Grafana ajustará automáticamente las líneas largas de texto para que quepan dentro del ancho visible del espectador. Esto puede facilitar la lectura y la comprensión de las entradas del registro.
El botón Abrir en vista dividida permite ejecutar la consulta de contexto de una entrada de registro en una pantalla dividida en la vista de exploración. Al pulsar este botón, se abrirá un nuevo panel de exploración en el que la consulta de contexto se mostrará junto a la entrada del registro, lo que facilitará el análisis y la comprensión del contexto circundante.
La consulta de contexto del registro también se puede abrir en una nueva pestaña del navegador pulsando la tecla Ctrl
(oCmd
) mientras se selecciona el botón para abrir el modal de contexto. Cuando se abre en una pestaña nueva, también se aplican los filtros previamente seleccionados.
Copie la línea de registro
Puede copiar fácilmente el contenido de una línea de registro seleccionada en el portapapeles pulsando el botón Copiar línea de registro.
Copie el enlace a la línea de registro
La vinculación de líneas de registro en Grafana le permite navegar rápidamente a entradas de registro específicas para un análisis preciso. Al seleccionar el botón Copiar el enlace corto de una línea de registro, puede generar y copiar una URL corta que proporcione acceso directo a la entrada de registro exacta dentro de un intervalo de tiempo absoluto. Al abrir el enlace, Grafana se desplazará automáticamente hasta la línea de registro correspondiente y la resaltará con un fondo azul, lo que facilitará la identificación y el enfoque en la información relevante.
nota
Esto solo es compatible con Loki y otras fuentes de datos que proporcionan un id
campo.
Relaves vivos
Para ver los registros en tiempo real de las fuentes de datos compatibles, puede aprovechar la función de seguimiento en tiempo real de Explore.
Para ver los registros en tiempo real con seguimiento en tiempo real
-
Pulse el botón en directo de la barra de herramientas de exploración para cambiar a la vista de seguimiento en directo.
-
Mientras estés en la vista de seguimiento en vivo, aparecerán nuevos registros en la parte inferior de la pantalla y tendrán un fondo que se difumina y contrasta, lo que te permitirá rastrear fácilmente las novedades.
-
Si quieres pausar el seguimiento en directo y explorar los registros anteriores sin interrupciones, puedes hacerlo pulsando el botón de pausa o simplemente desplazándote por la vista de registros.
-
Para borrar la vista y eliminar todos los registros de la pantalla, pulsa el botón Borrar registros. Esta acción restablecerá la vista del registro y le proporcionará un borrón y cuenta nueva para continuar con el análisis del registro.
-
Para reanudar el seguimiento en directo y seguir viendo los registros en tiempo real, pulse el botón Reanudar.
-
Si desea salir de Live Tailing y volver a la vista de exploración estándar, pulse el botón Detener.
Con la función de seguimiento en tiempo real, puedes vigilar de cerca los registros más recientes a medida que van llegando, lo que facilita la supervisión de los eventos en tiempo real y la detección rápida de los problemas.
Muestra de registros
Si la fuente de datos seleccionada implementa una muestra de registros y admite consultas de registro y métricas, en el caso de las consultas de métricas, podrá ver automáticamente muestras de líneas de registro que contribuyeron a la visualización de las métricas. Actualmente, esta función es compatible con las fuentes de datos de Loki.
Cambie de métricas a registros
Si procedes de una fuente de datos de métricas que implementa DataSourceWithQueryExportSupport
(como Prometheus) a una fuente de datos de registro DataSourceWithQueryImportSupport
compatible (como Loki), conservará las etiquetas de tu consulta que existen en los registros y las usará para consultar las secuencias de registros.
Por ejemplo, la siguiente grafana_alerting_active_alerts{job='grafana'}
consulta de Prometheus, después de cambiar a la fuente de datos de Loki, cambiará a. {job='grafana'}
Esto devolverá un fragmento de registros en el intervalo de tiempo seleccionado que se puede guardar o buscar en el texto.