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 8.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 9.x de Grafana, consulte Uso de la versión 9 de Grafana.
En un espacio de trabajo de Grafana, en la interfaz de usuario del panel se proporcionan herramientas para crear paneles de visualización. Explore elimina todas las opciones de paneles para que pueda centrarse en la consulta. Itere hasta que tenga una consulta funcional y, a continuación, planifique y cree un panel.
Para la supervisión de la infraestructura y la respuesta a incidentes, ya no es necesario cambiar a otras herramientas para depurar lo que ha fallado. Puede usar Explore para profundizar en sus métricas y registros y encontrar la causa.
Explore facilita la visualización de los datos sin necesidad de crear un panel. Si el origen de datos admite datos de gráficos y tablas, en Explore se muestran los resultados tanto en forma de gráfico como de tabla. Esto lo ayuda a ver las tendencias de los datos y más detalles al mismo tiempo.
Inicio de la exploración
nota
De forma predeterminada, los usuarios con el rol de espectador no pueden editar Explore ni tienen acceso.
El icono de Explore del menú de la izquierda abre una pestaña Explore vacía.
Para empezar con una consulta existente en un panel, elija la opción Explore en el menú Panel. Se abrirá una pestaña Explore que contiene la consulta del panel. A continuación, puede modificar o iterar la consulta fuera de su panel.
Elija su origen de datos en la lista desplegable de la parte superior izquierda. Prometheus tiene una implementación de Explore personalizada. Los demás orígenes de datos utilizan su editor de consultas estándar.
En el campo de consulta, puede escribir la consulta y explorar los datos. Hay tres botones al lado del campo de consulta: un botón para borrar (X), un botón para agregar consulta (+) y el botón para eliminar una consulta (-). Al igual que en el editor de consultas del panel, puede agregar y eliminar varias consultas.
División y comparación
La función de vista dividida es una forma de comparar gráficos y tablas side-by-side o de ver datos relacionados juntos en una página. Seleccione Dividir para duplicar la consulta actual y dividir la página en dos side-by-side consultas. Tiene la opción de seleccionar un origen de datos diferente para la nueva consulta. Esto le da la oportunidad de comparar la misma consulta para dos servidores diferentes o de comparar el entorno de ensayo con el entorno de producción.
En la vista dividida, los selectores de tiempo de ambos paneles se pueden vincular (si cambia uno, también se cambiará el otro) seleccionando uno de los botones de sincronización horaria adjuntos a los selectores de tiempo. Al vincular los selectores de tiempo, se mantienen sincronizadas las horas de inicio y finalización de las consultas de la vista dividida, de modo que se puede ver el mismo intervalo de tiempo en ambos paneles divididos.
Para cerrar la consulta recién creada, seleccione Cerrar división.
Uso compartido de un enlace abreviado
Utilice la función Compartir enlaces abreviados para crear formatos más pequeños y sencillos URLs /goto/:uid en lugar de compartirlos más largos URLs que contengan parámetros de consulta complejos. Para crear un enlace abreviado, seleccione la opción Compartir en la barra de herramientas de Explore. Los enlaces abreviados que nunca se utilizan se eliminan automáticamente después de 7 días.
Historial de consultas
El historial de consultas es una lista de consultas que ha utilizado en Explore. El historial es local en el navegador y no se comparte. Para abrir su historial e interactuar con él, seleccione Historial de consultas en Explore.
Visualización del historial de consultas
FIn en el historial de consultas, puede hacer lo siguiente:
-
Ejecute una consulta.
-
Crear o editar un comentario.
-
Copiar una consulta al portapapeles.
-
Copiar un enlace abreviado con la consulta en el portapapeles.
-
Destacar una consulta.
Administración de las consultas favoritas
Todas las consultas que se han destacado en la pestaña Historial de consultas se muestran en la pestaña Destacadas. Puede acceder a sus consultas favoritas más rápido y reutilizarlas sin tener que volver a escribirlas desde allí.
Ordenación del historial de consultas
De forma predeterminada, en el historial de consultas se muestran las consultas más recientes. Puede ordenar el historial por fecha o por nombre de origen de datos en orden ascendente o descendente.
En el lado derecho del historial de consultas, en la lista desplegable, seleccione una de las siguientes opciones: campo.
-
Lo más reciente primero
-
Lo más antiguo primero
-
Origen de datos (A-Z)
-
Origen de datos (Z-A)
nota
Si está en una vista dividida, el modo de ordenación solo se aplica al panel activo.
Filtración del historial de consultas
En las pestañas Historial de consultas y Destacadas, puede filtrar el historial de consultas por nombre de origen de datos.
-
Seleccione Filtrar consultas para orígenes de datos específicos.
-
Seleccione el origen de datos que desee usar para filtrar el historial. Puede seleccionar varios orígenes de datos.
En la pestaña Historial de consultas, puede usar el deslizador vertical para filtrar las consultas por fecha:
-
Arrastre el controlador inferior para ajustar la fecha de inicio.
-
Arrastre el controlador superior para ajustar la fecha de finalización.
nota
Si está en una vista dividida, los filtros se aplican solo al panel activo.
Búsqueda en el historial de consultas
Puede buscar en su historial todas las consultas y comentarios. Es posible buscar consultas en las pestañas Historial de consultas y Destacadas.
-
Seleccione el campo Buscar consultas.
-
En el campo de búsqueda, escriba el término de búsqueda.
Configuración del historial de consultas
Puede personalizar el historial de consultas en la pestaña Configuración. En la siguiente tabla se muestran las opciones disponibles.
| Opción | Valor predeterminado |
|---|---|
| Especificar durante cuánto tiempo Grafana guardará el historial de consultas. | 1 semana |
| Cambiar la pestaña activa predeterminada. | Pestaña Historial de consultas |
| Mostrar las consultas solo para el origen de datos que está activo actualmente en Explore. | True |
| Borrar el historial de consultas. | (Seleccione Borrar el historial de consultas para eliminar permanentemente todas las consultas almacenadas). |
nota
La configuración del historial de consultas es global y se aplica a ambos paneles en modo dividido.
Características específicas de Prometheus
La primera versión de Explore incluye una experiencia de consulta personalizada para Prometheus. Cuando ejecuta una consulta, Grafana en realidad ejecuta dos consultas: una consulta de Prometheus normal para el gráfico y una consulta instantánea para la tabla. Una consulta instantánea devuelve el último valor de cada serie temporal, lo que muestra un buen resumen de los datos que se muestran en el gráfico.
Explorador de métricas
En el lado izquierdo del campo de consulta, seleccione Métricas para abrir el Explorador de métricas. Se muestra un menú jerárquico con métricas agrupadas por su prefijo. Por ejemplo, todas las métricas de Alertmanager se agrupan bajo el prefijo alertmanager. Este es un buen punto de partida para explorar qué métricas están disponibles.
Campo Consulta
El campo Consulta permite completar automáticamente los nombres y funciones de las métricas y funciona prácticamente de la misma manera que el editor de consultas estándar de Prometheus. Pulse Entrar para ejecutar una consulta.
Se puede acceder al menú Autocompletar si se pulsa Ctrl + Espacio. El menú Autocompletar contiene una nueva sección Historial con una lista de las consultas ejecutadas recientemente.
Las sugerencias pueden aparecer en el campo Consulta. Elija una sugerencia para actualizar su consulta con el cambio sugerido.
-
En el caso de los contadores (métricas que aumentan monótonamente), se sugiere una función de tasa.
-
En el caso de los buckets, se sugiere una función de histograma.
-
En el caso de las reglas de registro, es posible ampliarlas.
Filtros de tablas
Pulse el botón Filtrar en la columna de etiquetas de un panel de tabla para agregar filtros a la expresión de consulta. También puede agregar filtros para varias consultas. El filtro se agrega para todas las consultas.
Integración de registros
También puede usar Explore para investigar sus registros con los siguientes orígenes de datos:
-
InfluxDB
-
Elasticsearch
Visualización de registros
Los resultados de las consultas de registro se muestran como histogramas en el gráfico y los registros individuales se muestran a continuación. Si el origen de datos no envía los datos del histograma para el intervalo de tiempo solicitado, el modelo de registros calcula una serie temporal en función de los recuentos de filas del registro agrupados en buckets por un intervalo de tiempo calculado automáticamente. A continuación, el inicio del histograma se ancla mediante la marca de tiempo de la primera fila del registro a partir del 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 su color. Si el registro no tiene una etiqueta de nivel especificada, Grafana analiza el registro para averiguar si su contenido coincide con alguna de las expresiones admitidas. 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. En la siguiente tabla se muestran los niveles de registro y la asignación de las abreviaturas y expresiones de 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 |
Opciones de visualización
Puede personalizar la forma en que se muestran los registros y seleccionar las columnas que se muestran.
Tiempo
Esta opción 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
Esta opción 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
Para usar el ajuste de líneas en la pantalla, establézcalo en True. Si se establece esta opción en False, se produce un desplazamiento horizontal.
Eliminación de duplicados
Los datos de registro pueden ser muy repetitivos. Explore puede ayudar, ya que oculta las líneas de registro duplicadas. Puede elegir entre diferentes algoritmos de eliminación de duplicados:
-
Exacto: las coincidencias exactas se establecen en toda la línea, excepto en los campos de fecha.
-
Números: las coincidencias se establecen en la línea después de eliminar números como la duración, las direcciones IP, etc.
-
Firma: la forma más agresiva de eliminación de duplicados, ya que elimina todas las letras y números. Las coincidencias se establecen con 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. Para todas las etiquetas, puede filtrar por inclusión (filtro positivo) y filtrar por exclusión (filtro negativo) las etiquetas seleccionadas. Cada campo o etiqueta también tiene un icono de estadísticas para mostrar estadísticas únicas en relación con todos los registros mostrados.
Cómo alternar los campos detectados
Si sus registros están estructurados en JSON o logfmt, puede mostrar u ocultar los campos detectados. Expanda una línea de registro y, a continuación, elija el icono en forma de ojo para mostrar u ocultar los campos.
{{< docs-imagebox img=»/img/docs/explore/parsed-fields-7-2.gif "max-width="800px» caption="Alternar los campos detectados en Explore» >}}
Integración de rastreo
Puede visualizar los rastros de los orígenes de datos de rastreo en Explore. Orígenes de datos admitidos actualmente:
Para obtener información sobre el uso del editor de consultas, consulte la documentación del origen de datos específico.
Encabezado
El encabezado incluye los elementos siguientes:
-
Título del encabezado, que muestra el nombre del intervalo raíz y el ID de rastro
-
Búsqueda, que resalta los intervalos que contienen el texto buscado
-
Metadatos sobre el rastro
Minimapa
En el minimapa se muestra una vista condensada de la línea temporal del rastro. Arrastre el ratón sobre el minimapa para ampliar un intervalo de tiempo más pequeño. Al hacer zoom, también se actualizará la línea temporal principal, por lo que será más fácil ver los intervalos más cortos. Si hace una pausa en el minimapa, al ampliarlo, verá el botón Restablecer selección, que restablece el zoom.
Plazo
En la línea temporal se muestra una lista de los intervalos del rastro. Cada fila de intervalos consta de los siguientes componentes:
-
Botón Expandir elementos secundarios: expande o contrae todos los intervalos secundarios del intervalo seleccionado.
-
Nombre del servicio: nombre del servicio que registró el intervalo.
-
Nombre de la operación: nombre de la operación que representa este intervalo.
-
Barra de duración del intervalo: representación visual de la duración de la operación dentro del rastro.
Al seleccionar cualquier lugar de la fila de intervalos, se muestran los detalles del intervalo.
Detalles del intervalo
Los detalles del intervalo incluyen los siguientes elementos:
-
Nombre de operación
-
Metadatos del intervalo
-
Etiquetas (cualquier etiqueta asociada a este intervalo)
-
Metadatos de proceso (metadatos sobre el proceso que registró este intervalo)
-
Registros: lista de registros que documentó este intervalo y valores de clave asociados. En el caso de los registros de Zipkin, en la sección se muestran las anotaciones de Zipkin.
Navegación entre Explore y un panel
Para acelerar los flujos de trabajo que implican cambiar periódicamente de Explore a un panel y viceversa, hemos agregado la posibilidad de volver al panel de origen después de acceder a Explore desde el menú desplegable del panel.
Cuando haya accedido a Explore, verá el botón “Atrás” en la barra de herramientas correspondiente.
Con solo pulsar el botón, volverá al panel de origen o, si quiere que los cambios que haga en Explore vuelvan al panel, solo tiene que pulsar la flecha situada junto al botón para que aparezca el elemento de menú “Volver al panel con los cambios”.
Inspector de consultas
Para ayudar a depurar las consultas, Explore le permite investigar las solicitudes y respuestas de las consultas, así como las estadísticas de estas, mediante el inspector de consultas. Esta funcionalidad es similar a las pestañas Estadísticas y Consulta del inspector de paneles. Para obtener más información, consulte Inspección del rendimiento de consultas y Visualización de la solicitud sin procesar y respuesta al origen de datos.
