Creador de consulta
Con el Generador de consultas, puede crear consultas para sus widgets de cuadros de mando personalizados de IBM® Cloud Logs sin necesidad de conocer la sintaxis de DataPrime, Lucene o PromQL.
Cuando defina su widget, puede seleccionar si desea utilizar el modo Constructor o Consulta.
Consultas basadas en métricas
Cuando cree un widget que utilice métricas, seleccione el modo Constructor y, a continuación, Métricas como fuente.
Tipo de consulta
Para el tipo de consulta, seleccione una consulta instantánea o de rango. La consulta se ejecuta en un intervalo de tiempo específico definido por el selector de tiempo del panel de control o el intervalo de tiempo del widget.
-
El modo de consulta instantánea muestra el valor de la métrica en un único momento, concretamente en la marca de tiempo final del marco temporal seleccionado. El modo de consulta instantánea es ideal para la supervisión en tiempo real, ya que proporciona una instantánea de los datos en el momento de la visualización. También es más eficaz, ya que sólo recupera los datos más recientes sin tener que consultar toda la base de datos.
-
El modo de consulta de intervalos recupera y agrega datos métricos en un intervalo de tiempo especificado. Devuelve todos los puntos de datos entre las fechas de inicio y fin que coinciden con la consulta. A medida que cambia el marco temporal, el sistema ajusta automáticamente el intervalo para optimizar el número de puntos de datos mostrados en el gráfico. El modo de consulta de intervalos se utiliza mejor para identificar tendencias o evaluar el rendimiento durante un periodo definido.
Nombre de métrica
Elija su métrica preferida en el menú desplegable que se rellena dinámicamente con las métricas disponibles. Puede utilizar la función de autocompletar para explorar el nombre, las etiquetas y los valores de la métrica.
Filtros
Para añadir un filtro, haga clic en el signo +. Elija una etiqueta de métrica y un valor asociado para filtrar su métrica.
Seleccione el operador = o != en el menú desplegable para incluir o excluir uno o varios valores. Utilizando los operadores =~ o !~, puede introducir una expresión RegEx.
Para añadir más pares etiqueta-valor, haga clic en el signo + para añadir una línea.
Funciones
Seleccionando métricas y etiquetas creará una consulta válida en Prometheus, pero también puede crear consultas más complejas utilizando funciones.
Para añadir una función, haga clic en +. Seleccione entre las funciones aggregation, count y rollup.
Las funciones de agregación calculan un conjunto de valores y devuelven un único valor. Estas funciones incluyen SUM(), AVG(), MIN(), MAX(), COUNT(), y otras. Después
de elegir la función, seleccione la etiqueta a agregar en el menú desplegable o introduzca un valor de etiqueta.
| Agregación | Descripción |
|---|---|
average |
El valor medio de todos los puntos de datos dentro del intervalo de tiempo seleccionado. |
count |
El número total de puntos de datos dentro del intervalo de tiempo seleccionado. |
min |
El valor más pequeño entre los puntos de datos dentro del intervalo de tiempo seleccionado. |
max |
El mayor valor entre los puntos de datos dentro del intervalo de tiempo seleccionado. |
sum |
La suma de todos los puntos de datos dentro del intervalo de tiempo seleccionado. |
quantile |
La función quantile(phi, q) by (group_labels) es un agregado que calcula el phi-quantile para cada grupo de etiquetas dentro de la serie temporal que devuelve q. El valor de phi debe
estar comprendido en el intervalo [0...1]. El cuantil se calcula por separado para cada conjunto de puntos con la misma marca temporal. |
histogram_quantile |
La función histogram_quantile es una función de transformación que calcula el phi-percentile basándose en los buckets del histograma proporcionados. El valor de phi debe estar comprendido entre
[0...1]. Por ejemplo, histogram_quantile(0.5, sum(rate(http_request_duration_seconds_bucket[5m])) by (le)) devuelve la duración media de todas las solicitudes de los últimos 5 minutos. |
Las funciones de recuento realizan cálculos sobre un conjunto de valores y devuelven un único valor. Estas funciones incluyen Count(), Absent(), Absent over time(), Present over time(),
Changes(), Resets(), y otras.
| Count | Descripción |
|---|---|
count |
El número total de puntos de datos dentro del intervalo de tiempo seleccionado. |
absent |
Devuelve 1 si la serie temporal no tiene puntos. En caso contrario, devuelve un resultado vacío. |
absent over time |
Devuelve 1 si el intervalo de tiempo proporcionado no contiene muestras sin procesar. |
present over time |
Devuelve 1 si hay al menos una muestra sin procesar en el intervalo de tiempo proporcionado. |
changes |
El número de veces que el valor de la serie temporal cambió dentro del intervalo de tiempo proporcionado. |
resets |
El número de reinicios del contador dentro del intervalo de tiempo proporcionado. |
Una función de rollup se refiere a funciones que agregan datos de series temporales en un intervalo de tiempo especificado. Estas funciones calculan métricas como average (avg_over_time), sum (sum_over_time),
minimum (min_over_time), maximum (max_over_time), count (count_over_time), y quantiles (quantile_over_time) a lo largo de una ventana temporal. Se utilizan para resumir y analizar datos
métricos.
| Resumen | Descripción |
|---|---|
average over time |
Calcula la media de los valores de las series temporales en un intervalo de tiempo. |
max over time |
Busca el valor máximo de los datos de una serie temporal en un intervalo de tiempo. |
min over time |
Determina el valor mínimo de los datos de una serie temporal en un intervalo de tiempo. |
sum over time |
Calcula la suma de los valores de las series temporales en un intervalo de tiempo. |
count over time |
Cuenta el número de elementos no NaN de la serie temporal en un intervalo de tiempo. |
quantile over time |
Calcula el cuantil especificado de los datos de series temporales en un intervalo de tiempo. |
Después de elegir la función, seleccione el intervalo que desea consultar como un número o ${__range}. ${__range} representa la duración del intervalo de tiempo del cuadro de mandos. Se representa como una cadena
de intervalos compatible con PromQL. Por ejemplo, si selecciona un intervalo de tiempo de 13.00 a 14.30, la variable ${__range} se representa como 90m.
Las funciones de clasificación permiten ordenar, clasificar y filtrar datos en las consultas. Puede utilizarlos para afinar sus resultados basándose en métricas y valores específicos.
Para añadir una función de rango, haga clic en + y elija entre TOPK, SORT, o SORT Descending. Después de seleccionar una función de clasificación, configúrela especificando la métrica
y los parámetros (por ejemplo, introduzca el número de resultados de K que desea que la consulta recupere para TOPK).
| Rank | Descripción |
|---|---|
TOPK |
Recupera los resultados más altos de K de un conjunto de datos en función de una métrica especificada. Utilice TOPK para mostrar los puntos de datos mejor clasificados. |
SORT |
Ordena los datos en orden ascendente en función de la métrica seleccionada. Utilice SORT para organizar los datos del valor más pequeño al más grande. |
SORT Descending |
Ordena los datos en orden descendente en función de la métrica seleccionada. Utilice SORT Descending para dar prioridad a los valores más grandes al principio del conjunto de resultados. |
Consultas basadas en registros
Con el Generador de consultas basado en registros, puede crear consultas complejas elaborando consultas basadas en Lucene y añadiendo después filtros y funciones.
Cuando cree un widget que utilice registros, seleccione el modo Constructor y, a continuación, Registros como fuente.
También debe elegir si desea consultar los registros en el canal de datos Información prioritaria o Analizar y alertar.
Filtros
Para añadir un filtro, haga clic en +. Elija una etiqueta y un valor asociado.
Seleccione el operador = o != en el menú desplegable para incluir o excluir uno o varios valores. Utilizando los operadores =~ o !~, puede introducir una expresión RegEx.
Para añadir más pares etiqueta-valor, haga clic en el signo +.
Funciones
Para añadir una función, haga clic en +. Seleccione un valor agregado mediante una función.
| Función | Descripción |
|---|---|
Count |
El número total de puntos de datos dentro del intervalo de tiempo seleccionado. |
Count Distinct |
El número de puntos de datos únicos dentro del intervalo de tiempo seleccionado. |
Sum |
La suma de todos los puntos de datos dentro del intervalo de tiempo seleccionado. |
Min |
El valor más pequeño entre los puntos de datos dentro del intervalo de tiempo seleccionado. |
Max |
El mayor valor entre los puntos de datos dentro del intervalo de tiempo seleccionado. |
Average |
El valor medio de todos los puntos de datos dentro del intervalo de tiempo seleccionado. |
Percentile XX |
Representa el valor en el que caen menos del XX% de los puntos de datos. Por ejemplo, Percentile 95 es el valor en el que caen menos de 95% de los puntos de datos. |
Con Agrupar por, puede agrupar los resultados de la consulta por uno o varios campos.
DataPrime consultas
Puede crear una consulta DataPrime como base para su widget.
Debe elegir si desea consultar los registros en el canal de datos Información prioritaria o Analizar y alertar.
Al crear una consulta basada en datos de registro, tiene la opción de convertir la consulta al lenguaje de sintaxis DataPrime haciendo clic en Convertir a DataPrime en el Generador de consultas.
Una vez convertida, la consulta transformada aparece en la pestaña DataPrime del Generador de consultas.
Después de cambiar las fuentes de datos, o convertir su consulta a DataPrime, sus parámetros de consulta originales en el Generador de Consultas se perderán. Al guardar el widget, se conserva su estado más reciente.
Hora del widget
El selector de tiempo del cuadro de mandos establece el marco temporal por defecto para su consulta. Para personalizar el marco temporal del widget que está configurando, haga clic en Hora del widget y desactive la casilla para desvincularlo del marco temporal del panel de control. A continuación, puede elegir un marco temporal estándar o personalizado específico para el widget que está configurando.