Pandora: Documentation es: Presentacion datos/Mapas visuales

From Pandora FMS Wiki
Revision as of 17:13, 23 October 2017 by Slerena (talk | contribs) (Creación - Datos generales)
Jump to: navigation, search

1 Mapas visuales

Pandora FMS permite construir mapas visuales donde cada usuario define su propia forma de representar visualmente la monitorización. El editor de consolas visuales permite al usuario, arrastrando elementos con el ratón, diseñar de forma visual el aspecto final, eligiendo el fondo y los iconos que representan el estado de cada aspecto relevante que quiere mostrar. Con Pandora vienen una serie de iconos, pero el usuario puede fácilmente personalizar los suyos. Diferentes consolas visuales pueden interactuar entre sí, visualizando de forma jerárquica, el estado de mapas que están "por debajo" en un mapa superior, pudiendo abstraer de esta forma, la monitorización y visualizando a alto nivel, toda una serie de elementos.

Estos son ejemplos reales de consolas visuales, tal como se ven en una pantalla de 40":

Vc sample1.jpg

Vc sample2.jpg

Vc sample3.jpg

1.1 Creación y acceso a las consolas visuales

Para trabajar con un mapa visual vaya a Topology Maps > Visual console. Aparece una lista con todos los mapas creados, para crear uno nuevo se pulsa en el botón “Create”. Sobre la lista podemos editar un mapa, borrarlo o "clonar" uno ya existente para modificarlo.

Aquellos mapas cuyo nombre comience por el carácter "_", "," , "[" o "(" serán mostrados en menú de la izquierda en el submenu de la "Consola Visual". Esto permite crear una especie de vista rápida desde el menú, téngalo en cuenta al nombrar su consola visual.

Pre54.png


1.1.1 Creación de una consola visual

La organización del editor está compuesta por varias pestañas: La pestaña "Datos principales" (Main data), que contiene los datos generales de la consola visual, la pestaña de visualización, varios wizards, un acceso a la vista en pantalla completa, un enlace para compartir la consola visual con un tercero a través de una URL, una lista de elementos contenidos en la consola visual y por supuesto el editor visual con el que trabajaremos para construir y editar la consola:

Vc tabs o2017.jpg

1.1.2 Creación - Datos generales

En esta se pueden editar y crear los datos básicos de la consola visual. Será la única visible para un mapa nuevo hasta que se guarde. Los valores básicos que contiene son: nombre de la consola visual, el grupo para la gestión de ACL, y la imagen de fondo, que se podrá cambiar de tamaño, al margen del que tenga la imagen. El color de fondo, es importante ya que si la pantalla donde se visualiza la consola visual es más grande que la imagen de fondo, rellenará el resto con el color de fondo seleccionado aquí.

Las imágenes de background se encuentran en el directorio de la consola de Pandora, dentro del directorio:

./images/console/backgrounds/

Puede subir ahi sus propias imágenes a través del gestor de ficheros integrado en Pandora (Admin tools -> File manager).

Permisos de acceso en la consola visual

Las ACL en las consolas visuales implican que cualquier que tenga acceso de lectura de una consola visual, por que tenga acceso al grupo con el flag de ver Consola Visual (VR), verá todo el contenido de la VC, aunque en él haya elementos de otro grupo.

Visual console edit1.jpg

1.1.3 Creación - Wizard

El wizard permite añadir elementos a la VC de forma rápida y cómoda. Puede crear elementos de varios tipos, y le recomendamos que antes de crear muchos elementos lo use solo con un par de ellos, para no tener problemas luego al borrar los elementos (aunque puede que si se equivoca le resulte más rápido borrar la VC completa).

El elemento más relevante es el que permite crear un elemento por agente, o por el contrario, crear un elemento por módulo. De esta manera puede añadir decenas de elementos que representan a un agente completo, o a un elemento de un agente, o bien mostrar todos los modulos de diferetnes agentes, creando muchos elementos a la vez, los cuales se pueden identificar por el nombre del agente, el nombre del modulo o ambos. La interfaz no es compleja de usar y lo más sencillo es probar con algunos elementos y ver como funciona.

1.1.4 Creación - Wizard de Servicios


Info.png

Esta funcionalidad solo se encuentra disponible en la versión Enterprise de Pandora FMS.

 


La pestaña wizard de servicios contiene un pequeño formulario para crear de una vez varios elementos de tipo servicio con sólo un par de clicks. Los servicios seleccionados aparecerán en la consola visual colocados automáticamente con el icono elegido.


Pandora new visual console, tab services wizard.png
Captura de pantalla de la pestaña wizard de servicios.


1.1.5 Creación - lista de elementos

Esta pestaña proporciona un formulario tabulado en filas de los elementos que contiene la consola visual que está editando. Es una forma rápida de editar los distintos elementos, además de ser una útil herramienta para los usuarios que necesitan afinar en ciertos valores de los elementos.

Las acciones permitidas en este formulario son: la edición (pero no cambiar el tipo de elemento) y el borrado de elementos (pero no su creación).Esta acción hay que realizarla en la pestaña Editor. Cada fila de esta pantalla, será un elemento de la VC.


Pandora new visual console, tab list elements.png
Ejemplo de como se ve la lista de elementos de una VC

1.1.6 Creación y edición de consolas visuales

Esta sección contiene la mayor parte de la funcionalidad del editor de la consola visual, y aquí es donde podrán añadirse y modificarse los elementos que forman una VC (excepto la imagen de fondo, que vimos previamente).

En la parte superior izquierda, están los diferentes elementos que podemos incluir en una VC (de izq. a derecha):

Imagen estática, progreso, gráfica, histograma de eventos (AutoSLA), dato en crudo, etiqueta, icono sin estado, grupo, rectángulo, línea y servicio.

Vc o2017 izq.jpg

En la parte superior derecha, las acciones que puede realizar con un elemento ya existente: duplicarlo, borrarlo, editarlo o activar una rejilla donde "forzar" la colocación de todos los elementos.

Vc o2017 drcha.jpg

Veamos paso a paso las caracteristicas más relevantes de los elementos que pueden componer una VC.


1.1.7 Elementos que puede contener un mapa

1.1.7.1 Imagen estática

Este elemento muestra una imagen estática que se mostrará en cuatro posibles colores:

  • Gris, para estado desconocido.
  • Verde, para estado normal (OK)
  • Rojo, para estado crítico (CRITICAL)
  • Amarillo, para estado WARNING.

Según el estado del módulo, agente o mapa, se muestra una imagen u otra. En una instalación normal de Pandora las tendrás disponibles en (/images/console/icons), usando una nomenclatura especial para dichas imágenes es: <nombre_imagen>_<estado>.png donde el estado puede ser:



Static image, example.png
Ejemplo de imágenes con el nombre y el estado.



  • "": cuando no tiene ningún estado el agente, módulo o la consola visual que enlaza.
  • "Bad":cuando el agente tiene algún módulo en fallo, o el módulo está en fallo o la consola visual que enlaza contiene algún elemento en bad.
  • "Ok": cuando el agente, módulo o la consola visual que puede enlazar están correctos.
  • "Warning": cuando el agente tiene algún módulo en warning, o el módulo está en warning o la consola visual que enlaza contiene algún elemento en warning.

A la imagen estática se le puede asociar una etiqueta, o bien se puede dejar en blanco, dicha etiqueta se puede formatear e incluso se le pueden añadir ciertas macros al texto (se verá mas adelante).

La imagen estática se puede asociar a un módulo específico, a un agente completo (de forma que si tiene al menos un modulo mal saldrá en color rojo y solo se verá verde si están todos sus módulos en estado normal). La imagen estática se puede asociar tambien al estado general de otra consola visual (ver opciones avanzadas, al final de este capítulo).

1.1.7.2 Icono

Es muy similar a la imagen estática, solo que el icono seleccionado siempre saldrá en color gris, como si estuviera en unknown. A menudo se usan iconos que no tienen informacion de estado, es decir, no se pueden usar como imagen estática, pero si como icono. Una simple imagen, como un logotipo, por ejemplo.

Iconos enlazando otras páginas

Mediante el campo etiqueta y en caso de que se ponga una dirección URL completa se podrá linkar el icono con una página web.

Ejemplo: para linkar un icono del mapa visual con el visor de la consola SNMP. Se deberá crear un elemento de tipo icono que como campo etiqueta tenga la dirección completa del visor:

http://<pandora_home>/index.php?sec=snmpconsole&sec2=operation/snmpconsole/snmp_view

De esta forma en el modo de previsualización al clickar sobre el icono nos redirigirá al visor de la consola SNMP.

Esto es útil para linkarlo por ejemplo a otra consola visual, de forma que podramos contruir "iconos de navegación" entre nuestras propias consolas visuales.

1.1.7.3 Progreso

Los items de tipo progreso nos permiten ver el estado de un módulo de una manera muy gráfica y descriptiva. Pueden ser de tipo barra de progreso, bola, gráfica de tipo donut o donut completo.

Pandora new visual console, Percentile bar.png
Ejemplo de un elemento de tipo Barra de porcentaje, en este ejemplo se muestra el resultado de un módulo que monitoriza la CPU.


Opciones del item percentil

La barra de porcentaje tiene muchos menos controles que el resto de los elementos, pero tiene dos controles que explicaremos:

  • Width: que será el ancho en píxeles del elemento escogido (barra, bola, donut/circular).
  • Max value: es el valor máximo que puede tener el módulo a representar. Por eso es interesante que examines bien el módulo a monitorizar para ver cual es el valor máximo, por ejemplo, en el caso de la captura de pantalla es el módulo de CPU que va de 0 a 100.
  • Type: El tipo permitirá definir la forma de representar el elemento gráficamente (barra, bola, donut, etc)
1.1.7.4 Gráfica de un módulo

Muestra una gráfica en tiempo real. Puede ser una gráfica de un módulo de datos ordinario, una gráfica combinada o una de las gráficas que obtienen su valor de forma tabular, que pueden ser de varios tipos.

Opciones de la gráfica de un módulo

En la gráfica es necesario definir el ancho y el alto; por eso pasa de estar oculto en las opciones avanzadas a mostrarse.

  • Intervalo: el rango de datos que va a mostrar la gráfica desde el momento actual hacia atrás, p.e: 1 día.
  • Tamaño: ancho y alto de la imagen que ocupará en pantalla la gráfica y las cifras de los ejes.
  • Color de fondo: Blanco, negro o transparente. Esto nos permite ajustarla mejor visualmente a nuestra VC.
  • Tipo: nos permite escoger el tipo: gráfica de módulo, gráfica combinada o gráfica tabulada.
  • Agente/Modulo: en el caso de haber escogido una gráfica asociada a una serie de datos.

Las gráficas no se "previsualizan" en el modo de edición, de forma que se presenta un cuadro blanco en su lugar.

VC edit o2017.jpg
Ejemplo de vista de edicion de una VC con varios items

VC edit o2017-2.jpg
Ejemplo de vista para el usuario de esa misma VC

1.1.7.5 Valor simple

Este elemento permite mostrar en la consola visual el valor de un módulo en tiempo real. Sólo necesita definir una etiqueta (opcional), y elegir el agente y el módulo. Para sustituir el valor debe usar la macro _VALUE_. En la captura del apartado anterior se pueden ver varios ejemplos.

Datos de tipo imagen.

Si el módulo es un dato de tipo cadena, y contiene un dato binario codificado en Base64, mostrará la imagen. Debe empezar por "data:image".

Data image vconsole.png
Captura que muestra editor creando item de valor simple con contenido base64.

Data image vconsole 2.png
Captura de error recogida como valor simple en base64, mostrado como imagen.


1.1.7.6 Histograma de eventos/AutoSLA

Muestra una barra horizontal, similar a la de la vista principal de agente, donde se muestran, para un agente o una combinacion agente/modulo, los eventos ocurridos en las últimas 24hr.

Autosla o2017.jpg
Ejemplo de visualizacion de autosla con varios elementos

1.1.7.7 Servicio

Permite representar (y ofrecer un enlace) al estado actual de un servicio. Indicando además el % de cumplimiento de SLA en tiempo real.

1.1.7.8 Etiqueta

Para crear una etiqueta sin contenido asociado se puede utilizar este tipo de ítem. Contiene texto y código HTML (lo que puede crear un enlace interno)



Visual console27.png
Edición del item de tipo etiqueta



1.1.7.9 Grupo

Es una imagen estática que representa el estado de un grupo.

Group palete.png
Edición del item de tipo grupo


1.1.7.10 Opciones avanzadas de cada elemento

Posición

Por defecto la posición es la 0x0 , donde la primera cifra es el eje X y la segunda es el eje Y. Estos valores son en píxeles, y ten en cuenta que el eje está definido de manera que en el eje Y está invertido, donde la parte superior es la 0 y crece hacia abajo, y el eje X está definido de la forma clásica, es decir: comienza en el borde izquierdo y crece hasta la derecha. Esta posición se modifica automáticamente al hacer click y arrastrar un elemento.

Padre

Para representar la relación entre elementos de la consola visual se usan lineas que se dibujan entre ellos. Proporciona a la propia linea un color según el estado del elemento padre.

Mapa asociado

Esta es quizás una de las características mas importantes de las consolas visuales

Únicamente los objetos de tipo "Imagen estática" pueden ser empleados para "resumir" el estado de otra consola visual. De esta forma muestra con el estado del icono (Verde, Amarillo o Rojo) el estado general de la consola visual a la que va a asociado. Si la consola visual tiene 20 elementos y uno de ellos está en critical, el estado que visualizará esa imagen estática será rojo. Si todos están bien, mostrará un verde brillante. Esto permite representar de forma fácil jerarquías de diferentes niveles de consolas visuales.

1.2 Compartir una consola visual

Es posible compartir un mapa visual con cualquiera, aunque no tenga siguiera un usuario/password para entrar en Pandora. Podrá compartir la pantalla visual con cualquier usuario, simplemente ofreciéndole acceso mediante una URL pública.

Para ello, desde la vista de la consola, acceda a la solapa de "compartir", que es el icono de la cámara de fotos, arriba a la derecha, tal como se puede ver en esta captura de pantalla:



Share visual console.png



Esta URL especial es estática y tiene el siguiente aspecto:

http://192.168.50.2/operation/visual_console/public_console.php?hash=86d1d0e9b6f41c2e3e04c5a6ad37136b&id_layout=3&id_user=admin2

Comparta esa URL con cualquiera, y podrá acceder a la información visualizada en la consola visual. No podrá acceder desde ahi a la información del agente, únicamente a la información publicada en la consola visual.

Esta es una forma excelente de publicar datos a usuarios anónimos.

1.3 Macros en las consolas visuales

Desde la version 7.712 es posible utilizar palabras clave o "macros" que actuen dinamicamente, así al introducir una macro en el cuadro de texto al editar un elemento de la consola visual, esta macro será sustituida en el modo de visionado por el dato que obtenga a partir de la funcionalidad de esa macro.


Lista de macros de mapas visuales:

_date_ : Obtiene la fecha usando el formato local del PHP.
_time_ : Obtiene la hora usando el formato local del PHP.


Macro mapa visual.png


Volver a Indice de Documentacion Pandora FMS