Creación de un widget de indicador IBM Cloud Logs

Puede crear un widget de indicador que puede incluirse en los cuadros de mando personalizados de IBM® Cloud Logs.

Utilice un widget de indicador para mostrar un único valor dentro de un intervalo especificado, a menudo parecido a un velocímetro o un dial. Suele utilizarse para representar métricas clave e indicadores de rendimiento de un vistazo.

Los indicadores incorporan umbrales que permiten cambiar el aspecto de la visualización cuando se alcanzan o superan determinados valores. Cuando se agrupa un conjunto de datos por un parámetro específico, se crea un indicador múltiple, en el que cada indicador representa un subconjunto de los datos. Esto permite la comparación simultánea entre diferentes categorías o grupos, proporcionando una visión más amplia del rendimiento.

Paso 1: Introducir nombre y descripción

Complete los pasossiguientes:

  1. En un panel de instrumentos personalizado, pulse Añadir widget icono Añadir widget y arrastre y suelte el widget Indicador desde la barra lateral.

  2. Sustituya Nuevo indicador por el nombre del widget.

  3. Escriba una descripción.

    Haga clic en Icono de acción Icono de acción. A continuación, seleccione Añadir descripción.

  4. Define dónde se muestran los valores de la leyenda. Los valores válidos son: Side, Bottom, Auto, y Hide.

    Haga clic en Icono de acción Icono de acción. A continuación, seleccione Leggend Settings.

Paso 2: Configurar la consulta para definir el conjunto de datos

Complete los pasossiguientes:

  1. Haga clic en Icono de acción Icono de acción. A continuación, seleccione el modo Edición.

  2. Para Query 1, siga estos pasos:

    Seleccione el tipo de datos. Los valores válidos son: Logs, Metrics, y DataPrime.

    Selecciona la fuente. Las opciones válidas son: Priority Insights y Analyze and Alert.

    Puede cambiar el nombre de la consulta. Seleccione el icono de acción y, a continuación, haga clic en Renombrar consulta.

  3. Introduzca la consulta.

    Cuando el tipo de datos es DataPrime, introduzca una consulta Dataprime en el campo Consulta.

    Si el tipo de datos es Logs, introduzca una consulta Lucene en el campo Consulta. Puede aplicar filtros y agregaciones.

    Cuando el tipo de datos es Metrics, especifique la métrica o PromQL deseada en el campo Consulta. Puede aplicar filtros y agregaciones.

  4. [Opcional] Añade uno o más filtros específicos al widget para limitar los datos que se muestran en tu indicador.

    Seleccione una etiqueta y su valor correspondiente.

    Los filtros se aplican a nivel de widget y funcionan junto con los filtros del cuadro de mandos. En caso de conflicto, los filtros del cuadro de mandos tienen prioridad sobre los filtros de los widgets.

  5. Añade una función.

    Para una consulta en la que el tipo de datos es Logs, puede mostrar un valor agregado utilizando una de las siguientes funciones:

    Opción de agregación al crear una consulta cuando el tipo de datos es Registros
    Agregación Descripción
    Count El número total de registros dentro del intervalo de tiempo seleccionado.
    Recuento de distintos El número de registros únicos dentro del intervalo de tiempo seleccionado.
    Suma La suma de todos los registros dentro del intervalo de tiempo seleccionado.
    Mínimo El valor más pequeño entre los registros dentro del intervalo de tiempo seleccionado.
    Máx El mayor valor entre los registros dentro del intervalo de tiempo seleccionado.
    Average El valor medio de todos los registros dentro del intervalo de tiempo seleccionado.
    Percentil XX Representa el valor por debajo del cual cae el XX% de los troncos. Por ejemplo, el percentil 95 es el valor por debajo del cual se encuentra el 95% de los troncos.

    Para una consulta en la que el tipo de datos es Metrics, puede mostrar un valor calculado utilizando una de las siguientes funciones:

    Opción de cálculos al crear una consulta cuando el tipo de datos es Métrica
    Cálculo Descripción
    Instantánea El valor en el momento actual.
    Último El valor más reciente dentro del intervalo de tiempo seleccionado.
    Mínimo El valor más pequeño dentro del intervalo de tiempo seleccionado.
    Máx El mayor valor dentro del intervalo de tiempo seleccionado.
    Promedio El valor medio de todos los puntos de datos dentro del intervalo de tiempo seleccionado.
    Suma La suma total de todos los puntos de datos dentro del intervalo de tiempo seleccionado.
    Ninguna No se aplica ningún cálculo. Se utilizan datos brutos.

  6. Añada 1 o más campos en Agrupar por para generar múltiples aforos.

Paso 3: Configurar el widget

Complete los pasossiguientes:

  1. Haga clic en Icono de acción Icono de acción. A continuación, seleccione el modo Edición.

  2. Elija una opción de Gestión de Leyendas. Los valores válidos son: Group y Threshold.

    Agrupar organiza la leyenda en función de diferentes entidades de datos, como servidores o aplicaciones, mostrando cada una de ellas como una entrada independiente.

    El umbral categoriza los valores basándose en límites predefinidos como normal, advertencia, crítico, ayudando a visualizar si una métrica está dentro de un rango aceptable o ha cruzado a un estado de advertencia.

  3. En la sección Gestión visual, elija cómo desea visualizar los datos.

    El arco interior muestra el valor real de la consulta.

    El arco exterior muestra los umbrales que usted defina.

    Habilite el arco interior, el arco exterior o ambos para mostrar un único valor dentro de un rango especificado, a menudo parecido a un velocímetro o un dial.

    Si el arco interior y el arco exterior están desactivados, el resultado numérico de su consulta aparecerá como un widget STAT sin visualizaciones adicionales. En este caso, puede determinar si el color umbral se aplicará al valor o al fondo. En esta parte de la configuración, se establece la opción de color de umbral que se desee. Puede elegir Valor para establecer el color umbral para el valor, o puede establecer Fondo para establecer el fondo con el color umbral.

  4. Configure la sección Umbrales.

    Un umbral es un valor que se establece y que, cuando se alcanza o se supera, cambia el aspecto de la visualización en función de los resultados de la consulta. Puede elegir entre porcentaje o números absolutos como valores.

    Elija el tipo de Umbral. Las opciones válidas son: absolute para definir números específicos como valor y percentage para definir valores relativos al valor mínimo o máximo.

    Puede cambiar el color de un valor umbral.

    Puede establecer los valores de un umbral y añadir etiquetas que lo describan.

    Puede añadir umbrales adicionales.

Paso 4: Guardar el widget

Complete los pasossiguientes:

  1. [Opcional] Establezca la hora del salpicadero del widget si desea utilizar un intervalo de tiempo distinto del seleccionado en el salpicadero.

  2. Haz clic en Guardar para guardar tu widget.

  3. [Opcional] Comparte un enlace directo al widget. Haga clic en Icono de acción Icono de acción. A continuación, seleccione Compartir widget URL, y copie la dirección URL.

    Cualquiera que tenga acceso al panel de control puede abrir el enlace compartido para ver el widget en su contexto.

    Las URL de los widgets compartidos siempre reflejan la última versión guardada del panel de control. Si has realizado cambios en el widget o en el diseño, guarda el panel de control antes de compartirlo.

  4. [Opcional] Añadir una acción personalizada. Para obtener más información, consulte Uso de acciones para integrarse con servicios de terceros.