Getting Started with Canvas in Kibana | Elastic Blog
Engineering

Primeros pasos con Canvas en Kibana

Actualizado el 21 de diciembre de 2018: Canvas se envía con Kibana 6.5+ y ya no hace falta instalarla por separado.

La actualización manual de marcadores y presentaciones es cosa del pasado.

Canvas es una herramienta de presentaciones —integrada en Kibana— que permite que los usuarios creen presentaciones y diapositivas de alta calidad visual que extraen datos en vivo directamente desde Elasticsearch. Esto significa que no hay actualizaciones manuales para las presentaciones, lo que permite tener objetos visuales, elementos de tablas y gráficos actualizados instantáneamente. Sin embargo, Canvas puede ser muchas cosas y tiene la flexibilidad de usarse para algo más que el caso de uso primario presentado en este artículo.

El siguiente es un video de Rashid Khan, el creador de Canvas, en el que presenta su visión de Canvas en Elastic{ON} 2018.

Por qué usar Canvas

Crear una presentación puede ser un proceso que toma mucho tiempo, especialmente cuando los datos presentados deben manipularse para que la audiencia pueda apreciarlos mejor que si se tratara de JSON puro. Incluso algo tan simple como sacar una captura de pantalla de un gráfico de barras y luego insertar la imagen en una presentación puede ser tedioso si los datos del gráfico de barras deben actualizarse con regularidad. Desafortunadamente, no es raro que se necesite exportar los datos, limpiarlos, pegarlos en la presentación, agregar imágenes, y más. Esto puede convertirse rápidamente en un proceso desagradable y difícil.

Estas inquietudes ni siquiera comienzan a abordar la posibilidad de adaptar las cosas sobre la marcha (es decir, en vivo durante una presentación). Imagina una presentación que contiene una diapositiva que muestra el reporte de ganancias de la compañía desglosado por trimestre. ¿Qué sucedería si, durante la presentación, el director general pidiera ver el reporte de ganancias desglosado por mes? Si alguien no preparó esa diapositiva con anticipación, el presentador simplemente se ve obligado a decir: "Umm, permíteme que te dé la información más tarde".

Canvas no solo elimina el problema de actualizar constantemente las visualizaciones en una presentación, sino que también brinda a los usuarios herramientas y filtros potentes para adaptar los datos sobre la marcha, al permitirles crear presentaciones muy flexibles, dinámicas y atractivas.

Requisitos previos e instalación de Canvas

Requisitos previos

Para comenzar a usar Canvas, necesitarás lo siguiente:

  • Elasticsearch para almacenar e indexar datos
  • Kibana para la UI

Si aún no tienes estas herramientas instaladas y en funcionamiento, consulta Primeros pasos con el Elastic Stack para obtener más información. También revisa este Repositorio de implementación rápida, que ofrece una manera simple para tener Elasticsearch y Kibana listos y funcionando en un equipo Ubuntu en solo minutos.

Instalación de Canvas

A partir de la versión 6.5, Canvas se envía con Kibana y ya no hace falta instalarla por separado. Simplemente instala Elasticsearch y Kibana para dar los primeros pasos con Canvas. (Nota: En diciembre de 2018, se actualizó esta sección para reflejar las instrucciones de la versión 6.5 y posteriores)

Fuentes de datos

Para fines de este tutorial, usaremos Metricbeat como una fuente rápida, fácil y relativamente predecible de datos en vivo.

1. Descarga y descomprime Metricbeat.

Visita la página de descarga de Metricbeat para descargar el binario correcto para tu SO. Una vez descargado, deberás desempaquetarlo. Una vez desempaquetado, encontrarás varios archivos en el directorio de Metricbeat.

2. Configuración de Metricbeat

A continuación, necesitamos configurar Metricbeat para enviar datos a tu instancia de Elasticsearch. Abre metricbeat.yml con tu editor de código favorito. Si tu instancia de Elasticsearch es...

  1. Local: La configuración predeterminada ya está configurada para enviar datos a Elasticsearch (ejecutándose en http://localhost:9200), por lo que no deberías tener que cambiar nada. Si necesitas cambiar algo, el proceso es el mismo que el del paso siguiente.
  2. Remota: Visita la sección Salida de Elasticsearch y modifícala para que se dirija a tu instancia:
    setup.kibana:
      host: "url-to-my-kibana-instance:5601"
    ...
    ...
    output.elasticsearch:
      hosts: ["url-to-my-elasticsearch-instance:9200"]
    

3. Ejecuta Metricbeat.

Guarda el archivo metricbeat.yml. Luego, ejecuta metricbeat con la opción "Setup" (Configuración), que le indicará al sistema que cargue los dashboards de métricas predeterminados en Kibana.

./metricbeat -c metricbeat.yml -setup -e

SUGERENCIA: Si agregas la opción -e al ejecutar Metricbeat, podrás ver los logs durante la ejecución.

Cómo crear tu primer panel de trabajo de Canvas

Los proyectos de Canvas se denominan "paneles de trabajo". Los paneles de trabajo son similares a las presentaciones y pueden tener varias páginas.

  1. Una vez que hayas instalado Canvas y configurado Metricbeat, navega a tu instancia de Kibana y selecciona Canvas de la barra lateral (como se muestra a continuación).
  2. Haz clic en "Create workpad" (Crear panel de trabajo).
  3. Proporciona un nombre único a tu panel de trabajo.

image1.gif

Anatomía de la interface de Canvas


canvas.jpg

  1. Botones
    • Intervalo de actualización de datos: Establece el intervalo en el cual Canvas revisa si hay actualizaciones de Elasticsearch.
    • Activar/desactivar pantalla completa: Activa o desactiva el "modo de presentación".
    • Exportar panel de trabajo: Exporta el panel de trabajo como archivo PDF.
    • Alternar edición de la barra lateral: Oculta la sección 6 en el diagrama anterior.
  2. Agregar elemento: Esto muestra el selector de elementos, por lo que puedes agregar tablas, gráficos, imágenes y más a tu panel de trabajo de Canvas.
  3. Control de capa de elemento: Elige qué elementos están por encima, lo cual permite componer y ocultar.
  4. Duplicar un elemento - Nota: debe seleccionarse un elemento para que esto funcione.
  5. Panel de trabajo de Canvas: El área de trabajo principal.
  6. Controles de edición: Panel relacionado con el contexto que presenta edición de propiedades para elementos seleccionados, que incluyen fuentes, colores, hojas de estilo personalizadas, etc.
  7. Abrir menú principal de Canvas: Navega entre paneles de trabajo, clona, importa, exporta o elimina paneles de trabajo.
  8. Control de página: Agrega páginas nuevas o alterna entre las existentes.
  9. Editor de código de elemento: Cuando tengas dudas, codifícalo. Flexibilidad total en tus consultas, formatos y pipelines (encontrarás más información sobre esto en un artículo posterior)

Cómo crear tus primeros elementos en Canvas

Tipos de elementos

  1. Haz clic en "Add element" (Agregar elemento).
  2. Canvas incluye una variedad de elementos integrados que pueden aprovecharse de forma inmediata. Selecciona el elemento "Horizontal Bar Chart" (Gráfico de barras horizontal).
    SUGERENCIA: Cuando un elemento se crea por primera vez, se completa con datos de demostración para que puedas comenzar a reproducirlo de inmediato.
  3. En el panel de la derecha, selecciona la pestaña "Data" (Datos).
  4. Haz clic en "Change your data source" (Cambiar la fuente de datos).
  5. Selecciona "Elasticsearch Raw Documents" (Documentos sin procesar de Elasticsearch).

    image5_small.pngExplicación de las fuentes de datos:

    • Datos de demostración: Este es un pequeño set de datos de muestra que se usa cuando creas por primera vez un nuevo elemento de Canvas. Se usa principalmente para fines de prueba.
    • Documentos sin procesar de Elasticsearch: Esto te permite acceder a tus datos sin procesar en Elasticsearch.
    • Timelion: Timelion proporciona una manera especializada para manejar tus datos temporales en Elasticsearch.
    • Elasticsearch SQL: De manera similar a los documentos sin procesar, esto te permite acceder a tus datos en Elasticsearch al usar la característica de sintaxis SQL.
  6. Selecciona el índice metricbeat-* de la lista desplegable.
  7. Ve al final de la barra lateral y haz clic en "Save" (Guardar).
  8. Vuelve a la parte superior de la barra lateral y selecciona la pestaña "Display" (Pantalla).
  9. Graficaremos el tiempo de ida y vuelta contra el nombre del set de métricas, por lo que configuramos los ejes para el gráfico de barras de la siguiente manera:
    • Eje X:
      • Medición: Valor
      • Campo: metricset.rtt
    • Eje Y:
      • Medición: Valor
      • Campo: metricset.name
    • Color
      • Medición: Valor
      • Campo: metricset.name

Agreguemos un elemento más...

  1. Haz clic en "Add element" (Agregar elemento).
  2. Selecciona el elemento "Metric" (Métrica).
  3. Arrástralo hacia alguna ubicación en la que puedas verlo mejor.
  4. En el panel de la derecha, selecciona la pestaña "Data" (Datos).
  5. Esta vez, selecciona "Elasticsearch SQL".
  6. Escribe lo siguiente en el editor de búsqueda SQL:
    SELECT COUNT(*) FROM metricbeat*
  7. Haz clic en "Save" (Guardar).
  8. Observa que el elemento ahora muestra una advertencia. Esto se debe a que el elemento ya no extrae ningún dato.
  9. En la parte superior de la barra lateral, selecciona la pestaña "Display" (Pantalla).
  10. En la sección "Numbers" (Números), configura lo siguiente:
    • Medición: Valor
    • Campo: COUNT_1
  11. Cambia la etiqueta para este elemento a "Entries" (Entradas), dado que muestra la cantidad de entradas en Elasticsearch.
  12. Siempre que Metricbeat siga ejecutándose, este número se actualizará en vivo. En el lado superior izquierdo de la pantalla, haz clic en "Refresh" (Actualizar).
  13. Configura la frecuencia de actualización en 5 segundos.
  14. Observa cómo tu presentación se actualiza con datos en vivo.

image4.gif

Ya no necesitarás actualizar manualmente tu presentación.

Enlaces a otros recursos útiles

Eso es todo. Acabas de crear tu primer panel de trabajo de Canvas con datos en vivo redireccionados a través de Metricbeat. Intenta agregar otros elementos a tu panel de trabajo y experimentar con las capacidades de Canvas.

Además, revisa otros tutoriales de Canvas aquí:


Imagen de banner: "By hand" por Eric Kilby, usada bajo CC BY /Recortada del original