Uso de la fuente de datos de Prometheus

Configuración de Prometheus

Nombre	Descripción
Name	El nombre de la fuente de datos. Así es como se ve la fuente de datos en los paneles y las consultas.
Default	La fuente de datos predeterminada significa que se preseleccionará para los nuevos paneles.
Url	La URL de su servidor Prometheus; por ejemplo,. https://prometheus.example.org:9090
Access	Servidor (predeterminado) = La URL debe ser accesible desde el backend/servidor de Grafana.
Basic Auth	Habilite la autenticación básica en la fuente de datos de Prometheus.
User	Nombre de usuario para la autenticación básica.
Password	Contraseña para la autenticación básica.
Scrape interval	Establézcalo en el intervalo de raspado y evaluación típico configurado en Prometheus. El valor predeterminado es 15 segundos.
Disable metrics lookup	Al marcar esta opción, se deshabilitarán el selector de métricas y la compatibilidad con métricas o etiquetas en la función de autocompletar del campo de consulta. Esto ayuda si tiene problemas de rendimiento con instancias de Prometheus más grandes.
Custom Query Parameters	Añada parámetros personalizados a la URL de consulta de Prometheus. Por ejemplotimeout,, partial_responsededup, o. max_source_resolution Se deben concatenar varios parámetros con una «&».

Prometheus, editor de consultas

Las siguientes secciones proporcionan información y opciones para el editor de consultas de Prometheus en el panel de control y en Explore.

Editor de consultas en los paneles

Abra un gráfico en el modo de edición seleccionando el título y, a continuación, seleccionando Editar (o pulsando la tecla e mientras hace una pausa en el panel).

Nombre	Descripción
Query expression	Para obtener más información sobre las expresiones de consulta de Prometheus, consulte la documentación de Prometheus.
Legend format	Controla el nombre de la serie temporal mediante el nombre o el patrón. Por ejemplo, {{hostname}} se sustituye por el valor de etiqueta de la etiquetahostname.
Min step	Un límite inferior adicional para el stepparámetro de las consultas de rango de Prometheus y para $__interval las variables y. $__rate_interval El límite es absoluto y no lo modifica la configuración de resolución.
Resolution	1/1establece tanto la $__interval variable como el stepparámetro de las consultas de rango de Prometheus de manera que cada píxel corresponda a un punto de datos. Para obtener un mejor rendimiento, utilice resoluciones más bajas. 1/2solo recupera un punto de datos por cada píxel restante y 1/10 recupera un punto de datos por cada 10 píxeles. Tenga en cuenta que tanto el intervalo de tiempo mínimo como el paso mínimo limitan el valor final de $__interval y. step
Metric lookup	Busque los nombres de las métricas en este campo de entrada.
Format as	Cambia entre TableTime series, oHeatmap. Tablesolo funciona en el panel de la mesa. Heatmapes adecuado para mostrar métricas del tipo histograma en un panel de mapa de calor. Convierte los histogramas acumulados en histogramas normales y clasifica las series por grupos.
Instant	Realice una consulta «instantánea» para devolver solo el último valor que Prometheus haya extraído para la serie temporal solicitada. Las consultas instantáneas devuelven resultados mucho más rápido que las consultas de rango normales. Úselas para buscar conjuntos de etiquetas.
Min time interval	Este valor multiplicado por el denominador de la configuración de Resolución establece un límite inferior tanto para la $__interval variable como para el stepparámetro de las consultas de rango de Prometheus. El valor predeterminado es el intervalo de raspado establecido en las opciones de la fuente de datos.

nota

Amazon Managed Grafana modifica las fechas de solicitud de las consultas para alinearlas con el paso calculado dinámicamente. Esto garantiza una visualización coherente de los datos de las métricas, pero puede provocar una pequeña brecha de datos en el borde derecho del gráfico.

Consultas instantáneas en los paneles

La fuente de datos de Prometheus le permite ejecutar consultas instantáneas, que consultan solo el valor más reciente. Puede visualizar los resultados en un panel de tabla para ver todas las etiquetas disponibles de una serie temporal.

Los resultados de las consultas instantáneas se componen de un solo punto de datos por serie. Se pueden mostrar en el panel de gráficos con la ayuda de anulaciones de serie. Para mostrarlos en el gráfico como el último punto de valor, añada una modificación de la serie y seleccione. Points > true Para mostrar una línea horizontal en todo el gráfico, añada una modificación de serie y seleccione Transform > constant Para obtener más información sobre las anulaciones de serie, consulte. Anulaciones de series

Editor de consultas en Explore

Nombre	Descripción
Query expression	Para obtener más información sobre la expresión de consulta de Prometheus, consulte la documentación de Prometheus.
Step	Stepparámetro de las consultas de rango de Prometheus. Aquí se pueden usar unidades de tiempo, por ejemplo: 5s, 1m, 3h, 1d, 1y. Unidad predeterminada si no se ha especificado ninguna unidad (segundos). s
Query type	Range, Instant, o Both. Al ejecutar una consulta de rango, el resultado de la consulta se muestra en un gráfico y una tabla. La consulta instantánea devuelve solo el último valor que Prometheus ha extraído para la serie temporal solicitada y se muestra en la tabla. Cuando se selecciona Ambos, se ejecutan tanto la consulta instantánea como la consulta de rango. El resultado de la consulta de rango se muestra en el gráfico y el resultado de la consulta instantánea se muestra en la tabla.

Navegador de métricas

El navegador de métricas te permite encontrar métricas rápidamente y seleccionar las etiquetas relevantes para crear consultas básicas. Cuando abras el navegador, verás todas las métricas y etiquetas disponibles. Si su instancia de Prometheus lo admite, cada métrica mostrará su AYUDA y su TIPO en forma de información sobre herramientas.

Al seleccionar una métrica, el navegador reduce las etiquetas disponibles para mostrar solo las que se aplican a la métrica. A continuación, puede seleccionar una o más etiquetas para las que los valores de etiqueta disponibles se muestran en las listas de la sección inferior. Seleccione uno o más valores para cada etiqueta para restringir el alcance de la consulta.

nota

Si no recuerda el nombre de una métrica con el que empezar, también puede seleccionar primero algunas etiquetas para reducir la lista y, a continuación, buscar los valores de etiqueta relevantes.

Todas las listas del navegador de métricas tienen un campo de búsqueda encima para filtrar rápidamente las métricas o etiquetas que coincidan con una cadena determinada. La sección de valores solo tiene un campo de búsqueda. Su filtrado se aplica a todas las etiquetas para ayudarte a encontrar valores en todas las etiquetas una vez que las hayas seleccionado; por ejemplo, entre tus etiquetas app, job o job_name, solo una podría tener el valor que estás buscando.

Cuando esté satisfecho con la consulta, haga clic en «Usar consulta» para ejecutar la consulta. El botón Utilizar como consulta de tarifas añade una tarifa (...) [$__interval] en torno a tu consulta para ayudarte a escribir consultas para las contramétricas. El botón «Validar el selector» comprobará con Prometheus cuántas series temporales están disponibles para ese selector.

Limitaciones

El navegador de métricas tiene un límite estricto de 10 000 etiquetas (claves) y 50 000 valores de etiquetas (incluidos los nombres de las métricas). Si su instancia de Prometheus devuelve más resultados, el navegador seguirá funcionando. Sin embargo, los conjuntos de resultados se reducirán por encima de esos límites máximos.

Creación de plantillas

En lugar de codificar elementos como el nombre del servidor, la aplicación y el sensor en las consultas de métricas, puede utilizar variables en su lugar. Las variables se muestran como cuadros de selección desplegables en la parte superior del panel de control. Puedes usar estos cuadros desplegables para cambiar los datos que se muestran en tu panel de control.

Para obtener más información sobre las plantillas y las variables de plantilla, consulte. Plantillas y variables

Variable de consulta

La variable del tipo Query le permite consultar Prometheus para obtener una lista de métricas, etiquetas o valores de etiquetas. El complemento de fuente de datos de Prometheus proporciona las siguientes funciones que puede utilizar en el campo de entrada de consultas.

Nombre	Descripción
label_names()	Devuelve una lista de nombres de etiquetas.
label_values(label)	Devuelve una lista de valores de etiqueta para cada métrica. label
label_values(metric, label)	Devuelve una lista de valores de etiqueta para label la métrica especificada.
metrics(metric)	Devuelve una lista de métricas que coinciden con la expresión regular especificadametric.
query_result(query)	Devuelve una lista de los resultados de la consulta de Prometheus para. query

Para obtener información sobre qué son los nombres de las métricas, los nombres de las etiquetas y los valores de las etiquetas, consulte la documentación de Prometheus.

Uso de variables de intervalo y rango

nota

Support y $__range_ms están disponibles solo a partir de Grafana v5.3. $__range $__range_s

Puede usar algunas variables globales en las variables de consulta:$__interval,, $__interval_ms $__range$__range_s, y. $__range_ms Para obtener más información, consulte Variables globales. Puede resultar práctico utilizarlas con la query_result función cuando se deben filtrar consultas de variables, ya que la label_values función no admite consultas.

Para obtener las instancias correctas al cambiar el intervalo de tiempo en el panel de control, asegúrate de configurar el refresh activador de la variable para que seaOn Time Range Change.

El siguiente ejemplo de código muestra cómo rellenar una variable con las cinco instancias de solicitud más concurridas en función del QPS promedio en el intervalo de tiempo que se muestra en el panel.

Query: query_result(topk(5, sum(rate(http_requests_total[$__range])) by (instance)))
Regex: /"([^"]+)"/

En el siguiente ejemplo de código se muestra cómo rellenar una variable con las instancias que tienen un estado determinado en el intervalo de tiempo que se muestra en el panel de control, utilizando. $__range_s

Query: query_result(max_over_time(<metric>[${__range_s}s]) != <state>)
Regex:

Uso de una variable $__rate_interval

La $__rate_interval variable está destinada a usarse en la función de tasa. Se define como máximo ($__interval+ intervalo de raspado, 4 * intervalo de raspado). El intervalo de raspado es el ajuste de paso mínimo (también conocido como query_interval, un ajuste por consulta de ProMQL), si se ha establecido alguno, y de lo contrario, el intervalo de raspado establecido en la fuente de datos de Prometheus (pero ignorando cualquier configuración de intervalo mínimo del panel, ya que esta última se modifica con la configuración de resolución).

Uso de variables en las consultas

Hay dos sintaxis:

• $<varname>Ejemplo: rate (http_requests_total {job=~"$job "} [5m])

• [[varname]]Ejemplo: rate (http_requests_total {job=~ "[[job]]"} [5m])

¿Por qué de dos maneras? La primera sintaxis es más fácil de leer y escribir, pero no permite utilizar una variable en mitad de una palabra. Cuando las opciones de varios valores o Incluir todos los valores están habilitadas, Grafana convierte las etiquetas de texto sin formato a una cadena compatible con expresiones regulares. Lo que significa que tienes que usar en lugar de. =~ =

Annotations

Puede utilizar las anotaciones para superponer información detallada sobre los eventos sobre los gráficos. Las consultas de anotación se añaden mediante el menú del panel de control o la vista de anotaciones. Para obtener más información, consulte Annotations.

Prometheus admite dos formas de consultar anotaciones.

• Una consulta métrica normal

• Una consulta de Prometheus para alertas pendientes y de activación. Para obtener más información, consulte Inspeccionar las alertas (durante el tiempo de ejecución).

La opción escalonada es útil para limitar el número de eventos devueltos por la consulta.