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.
Este tema de documentación está diseñado para los espacios de trabajo de Grafana que admiten la versión 9.x de Grafana.
Para los espacios de trabajo de Grafana que admiten la versión 10.x de Grafana, consulte Uso de la versión 10 de Grafana.
Para los espacios de trabajo de Grafana que admiten la versión 8.x de Grafana, consulte Uso de la versión 8 de Grafana.
Junto con las métricas, Explore le permite investigar sus registros en los siguientes orígenes de datos:
Durante la supervisión 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 métricas y registros al verlos. side-by-side Esto crea un nuevo flujo de trabajo de depuración.
-
Reciba una alerta.
-
Desglose y examine las métricas.
-
Vuelva a desglosar y busque en los registros relacionados con la métrica y el intervalo de tiempo (y, en el futuro, con los rastros distribuidos).
Visualización de registros
Los resultados de las consultas de registro se muestran como histogramas en el gráfico; los registros individuales se explican en las siguientes secciones.
Si el origen de datos admite un histograma de volumen de registros de intervalo completo, se muestra automáticamente el gráfico con 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 histograma de volumen de registro de intervalo completo se representa mediante una consulta métrica que puede resultar costosa según el intervalo de tiempo consultado. Esta consulta puede ser particularmente difícil de procesar en instalaciones de Loki más pequeñas. Para mitigar esto, recomendamos usar un proxy como nginxX-Query-Tags con el valor Source=logvolhist. Grafana agrega estos encabezados a todas las consultas de histogramas de volumen de registro.
Si el origen de datos no admite la carga de un histograma de volumen de registro de intervalo completo, el modelo de registros calcula una serie temporal basada en los números de filas de registros agrupados por un intervalo de tiempo calculado automáticamente y, a continuación, la marca de tiempo de la primera fila de registro ancla el inicio del histograma al resultado. El final de la serie temporal está anclado al intervalo Hasta del selector de tiempo.
Nivel de registro
En el caso de los registros en los que se especifica una etiqueta de nivel, Grafana utiliza el valor de la etiqueta para determinar el nivel del registro y, en consecuencia, actualizar el color. Si el registro no tiene ninguna etiqueta de nivel especificada, intenta averiguar si su contenido coincide con alguna de las expresiones admitidas (consulte lo siguiente para obtener más información). El nivel de registro siempre viene determinado por la primera coincidencia. Si Grafana no puede determinar un nivel de registro, se visualizará con el nivel de registro desconocido.
sugerencia
Si utiliza un origen de datos de Loki y level está en su línea de registro, use analizadores (JSON, logfmt, regex,..) para extraer la información del nivel en una etiqueta de nivel que se utilice para determinar el nivel de registro. Esto permitirá que el histograma muestre los distintos niveles del registro en barras independientes.
Niveles de registro admitidos y asignación de abreviaturas y expresiones a nivel de registro:
| Expresiones admitidas | Nivel de registro | Color |
|---|---|---|
emerg |
crítico |
morado |
fatal |
crítico |
morado |
alerta |
crítico |
morado |
crit |
crítico |
morado |
crítico |
crítico |
morado |
err |
error |
red |
eror |
error |
red |
error |
error |
red |
aviso |
Advertencia |
amarillo |
Advertencia |
Advertencia |
amarillo |
info |
info |
green |
información |
info |
green |
aviso |
info |
green |
dbug |
depuración |
azul |
depuración |
depuración |
azul |
rastro |
rastro |
azul claro |
* |
unknown |
gris |
Navegación de registros
La interfaz de navegación de registros, situada junto a las líneas de registro, se puede utilizar para solicitar más registros. Para ello, seleccione el botón Registros más antiguos en la parte inferior de la navegación. Cuando llegue al límite de líneas y quiera ver más registros, puede usarlo para buscar más registros. Cada solicitud se muestra en la navegación como una página independiente. En cada página se muestran las marcas de tiempo de inicio y fin de las líneas de registro entrantes. Puede ver los resultados anteriores si hace clic en la página que quiere ver. 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 esas páginas.
Opciones de visualización
Puede personalizar la forma en que se muestran los registros y seleccionar las columnas que se muestran.
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 el origen de datos.
Etiquetas únicas
Muestra u oculta la columna de etiquetas únicas, que incluye solo las etiquetas que no son comunes. Todas las etiquetas comunes se muestran arriba.
Ajuste de líneas
Establezca esta opción en Verdadero si quiere usar el ajuste de líneas en la pantalla. Si se establece en Falso, se producirá un desplazamiento horizontal.
Prettify JSON
Establezca esta opción en true para que imprima como Prettify 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:
-
Exacto: las coincidencias exactas se establecen en toda la línea, excepto en los campos de fecha.
-
Números: coincidencias en la línea después de eliminar números como la duración, las direcciones IP, etc.
-
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.
Inversión del orden de los resultados
Puede cambiar el orden de los registros recibidos del orden descendente predeterminado (Lo más reciente primero) a un orden ascendente (Lo más antiguo primero).
Etiquetas y campos detectados
Cada fila de registro tiene un área ampliable con sus etiquetas y campos detectados para una interacción más sólida. Hemos agregado a todas las etiquetas la posibilidad de filtrar por inclusión (filtro positivo) y filtrar por exclusión (filtro negativo) las etiquetas seleccionadas. Cada campo o etiqueta tiene también un icono de estadísticas para mostrar estadísticas en relación con todos los registros mostrados.
Escape de líneas nuevas
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 líneas nuevas”.
Explore puede corregir automáticamente las secuencias que se han escapado incorrectamente que ha detectado.
Corrección automática de las secuencias de escape
-
Seleccione Escapar líneas nuevas para reemplazar las secuencias.
-
Revise manualmente los reemplazos para confirmar que sean correctos.
Explore reemplaza estas secuencias. Cuando lo haga, la opción cambiará de Escapar líneas nuevas a Eliminar escape. Evalúe los cambios, ya que el análisis podría no ser preciso en función de la entrada recibida. Para revertir los reemplazos, seleccione Eliminar escape.
Enlaces de datos
Al utilizar enlaces de datos, puede convertir cualquier parte de un mensaje de registro en un enlace interno o externo. El enlace creado está visible como un botón en la sección Enlaces dentro de la vista de Detalles del registro.
Cambio de la visibilidad de los campos
Expanda una línea de registro y, a continuación, haga clic en el icono del ojo para mostrar u ocultar los campos.
Características específicas de Loki
Loki es el sistema de agregación de registros de código abierto de Grafana Labs. Loki está diseñado para ser rentable, ya que no indexa el contenido de los registros, sino un conjunto de etiquetas para cada flujo de registro. Los registros de Loki se consultan de forma similar a la consulta con los selectores de etiquetas en Prometheus. Utiliza etiquetas para agrupar flujos de registro que se pueden hacer coincidir con las etiquetas de Prometheus. Para obtener más información sobre Grafana Loki, puede ver el GitHub de Grafana Loki
Para obtener más información, consulte Loki sobre cómo consultar datos de registro.
Cambio de métricas a registros
Si cambia de una consulta de Prometheus a una consulta de registros (puede hacer antes una división para tener las métricas y los registros en paralelo), conservará las etiquetas de su consulta que existen en los registros y las usará para consultar los flujos de registro. Por ejemplo, si tiene la siguiente consulta de Prometheus:
grafana_alerting_active_alerts{job="grafana"}tras cambiar al origen de datos de los registros, cambiará a:
{job="grafana"}Esto devolverá un fragmento de registros en el intervalo de tiempo seleccionado que se puede buscar.
Registros de ejemplo
Si el origen de datos seleccionado implementa ejemplos de registros y admite consultas de registro y métricas, en el caso de las consultas métricas, podrá ver automáticamente muestras de líneas de registro que han contribuido a la visualización de las métricas. Actualmente, esta característica es compatible con los orígenes de datos de Loki.
Seguimiento en directo
Utilice la característica de seguimiento en directo para ver los registros en tiempo real de los orígenes de datos compatibles.
Seleccione En directo en la barra de herramientas de Explore para cambiar a la vista de seguimiento en directo.
Mientras esté en la vista de seguimiento en directo, aparecerán nuevos registros en la parte inferior de la pantalla y tendrán un fondo que se difumina y contrasta para que pueda seguir las novedades. Seleccione el botón Pausar o desplácese por la vista de registros para pausar el seguimiento en directo y explorar los registros anteriores sin interrupciones. Seleccione el botón Reanudar para reanudar el seguimiento en directo o el botón Detener para salir del seguimiento en directo y volver a la vista estándar de Explore.
