Creación de un widget de barra horizontal IBM Cloud Logs

Puede crear un gráfico de barras horizontales que puede incluirse en los cuadros de mando personalizados de IBM® Cloud Logs.

Utilice un widget de gráfico de barras horizontales para ordenar sus datos por valor, en orden descendente por defecto. En los gráficos de barras verticales, los datos suelen ordenarse alfabéticamente por nombre de columna.

El widget de gráfico de barras horizontales incorpora umbrales, que permiten cambiar la visualización cuando se alcanzan o ejecutan determinados valores. Cuando se tantea un conjunto de datos por parámetros específicos, se crea una barra multihorizontal, en la que cada barra horizontal 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.

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 Gráfico de barras horizontales desde la barra lateral.

  2. Sustituya Nuevo gráfico de barras horizontales 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 Configuración de la leyenda.

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.

    Si 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ñada uno o más filtros específicos al widget para limitar los datos que se muestran.

    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.

    En los gráficos de barras, el cambio del tipo de agregación cambiará el tipo de datos que ve.

    Para una consulta cuyo tipo de datos es Metrics, elija una función.

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 configuración del gráfico de barras para la vista del eje Y para configurar si se muestra el valor o la categoría. Las opciones válidas son: Value y Category.

  3. Elija una opción de Gestión de Leyendas. Los valores válidos para Logs son: Group, Stack, y Aggregation . Los valores válidos para Metrics son: Group y Stack

    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.

    La pila muestra cómo se agrupan y superponen varias entradas de datos en la misma barra horizontal. Los conjuntos de datos de una misma pila se agrupan en un único gráfico de barras horizontal dividido en segmentos. Esto muestra una segunda capa de datos en el gráfico.

    La agregación muestra el valor combinando varios valores de datos en un único valor resumido antes de mostrarlos en el gráfico o la leyenda.

Esquema de colores de la leyenda : Seleccione si desea que los colores de la leyenda sean por grupo, pila o agregación. Por defecto, el gráfico de barras horizontales es por agregación, lo que significa que se mostrará un único color para todas las barras.

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

    La barra máxima por gráfico muestra el número máximo de barras individuales en una única vista del gráfico según su consulta.

    El número máximo de segmentos por barra muestra el número máximo de segmentos dentro de una misma barra.

    Active la barra máxima por gráfico, las rodajas máximas por barra o ambas para mostrar un único valor dentro de un intervalo especificado.

  2. Configure la sección Escala.

    Una escala se refiere a cómo se muestran los valores a lo largo de los ejes x e y. Puede elegir entre lineal o logarítmico como valores.

    Elija el tipo de Escala. Las opciones válidas son: linear que define como los valores aumentan proporcionalmente y logarithmic donde el valor se define por logaritmos en lugar de intervalos lineales iguales.

    Puede cambiar el color de un valor umbral.

    Por defecto, el ajuste es lineal. Sin embargo, si hay grandes diferencias entre los distintos valores, puede ser útil mostrar la escala logarítmica en su lugar. Por ejemplo, si la mayoría de sus valores están por debajo de 1k y uno de ellos es 10k, el uso de la escala logarítmica le mostrará un gráfico de barras más fácil de leer que la escala lineal.

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.