Difference between revisions of "Pandora: Documentation es: Presentacion datos/Mapas visuales"

From Pandora FMS Wiki
Jump to: navigation, search
(Crear un mapa visual)
Line 3: Line 3:
 
Pandora FMS permite construir mapas visuales donde cada usuario define su propia forma de representar visualmente la monitorización. El editor de consolas visuales se imita la sensación y el tacto de una aplicación de dibujo. El usuario elige 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.
 
Pandora FMS permite construir mapas visuales donde cada usuario define su propia forma de representar visualmente la monitorización. El editor de consolas visuales se imita la sensación y el tacto de una aplicación de dibujo. El usuario elige 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.
  
=== Crear un mapa visual ===
+
=== Creación y acceso a las consolas visuales ===
  
Para crear un mapa visual se va 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.
+
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.
  
 
<center>
 
<center>
Line 11: Line 13:
 
</center>
 
</center>
  
===Ver un mapa visual===
 
  
Para ver los Mapas visuales que se han creado se va a Reporting>Visual Console. Aparece una lista con todos los Mapas creados.
+
==== Creación de una consola visual ====
  
Los mapas con un nombre que su primera letra sea "'''_'''", "''','''" , "'''['''" o "'''('''" serán mostrados en menú de la izquierda en el submenu de la "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:
  
<br><br>
 
 
<center>
 
<center>
[[image:pre73.png|900px]]
+
[[File:Vc_tabs_o2017.jpg]]
 
</center>
 
</center>
<br><br>
 
 
Para acceder a ver el Mapa se pincha sobre el nombre del mapa que se quiere ver.
 
 
<br><br>
 
<center>
 
[[image:pre74.png|750px]]
 
</center>
 
<br><br>
 
 
Debajo del mapa hay un combo donde se elige el tiempo  de rtefresco del mapa.
 
El mapa se puede poner en pantalla completa pulsando sobre el siguiente icono [[image:pre75.png]]
 
 
Es posible acceder a la pagina de edición del mapa pulsando sobre el siguiente icono [[image:pre76.png]]
 
 
Desde esta misma ventana es posible acceder a un enlace público del mapa visual que nos permitirá ver el contenido de este sin la necesidad de entrar en la consola [[image:pre76_b.png]].
 
 
 
=== Pestañas del editor de mapas ===
 
  
La organización del editor está compuesta por varias pestañas: La pestaña data, que contiene los datos generales del mapa en sí mismo, la pestaña preview que sirve para previsualizar el mapa, la pestaña wizard que sirve para añadir de forma rápida elementos comunes al mapa, la pestaña lista de elementos y la pestaña del editor.
+
==== 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 aqui:
  
====Pestaña Data====
+
Las imágenes de background se encuentran en el directorio de Pandora Console (normalmente var/www/pandora_console/) en el directorio ./images/backgrounds/. Puede subir ahi sus propias imágenes a través del gestor de ficheros integrado en Pandora (Admin tools -> File manager)
  
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 la guardes. Los valores básicos que contiene son: nombre de la consola visual, el grupo para la gestión de ACL, y la imagen background.
+
'''Permisos de acceso en la consola visual'''
  
Al crearlo, el tamaño de la consola visual se determina por el tamaño de la imagen de background, pero al editarlo, si se cambia el background, se mantendrá el último tamaño definido por el usuario o el anterior background.
+
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.
  
Las imágenes de background se encuentran en el directorio de Pandora Console (normalmente var/www/pandora_console/) en el directorio ./images/backgrounds/ .
 
<br><br>
 
 
<center>
 
<center>
[[image:Pandora new visual console, tab data.png|800px]]<br />
+
[[File:visual_console_edit1.jpg]]
''Captura de pantalla del formulario de la pestaña data.''</center>
+
</center>
<br><br>
 
  
====Pestaña Preview====
 
  
La pestaña preview sirve para ver el resultado de tu trabajo de forma rápida, evitando navegar entre los menús de Pandora Console. La vista de la consola visual es una vista estática, por lo que si cambia el estado de los elementos contenidos, estos no se redibujarán como ocurre con la vista de edición. En esta vista se encuentran los elementos nombrados anteriormente (Pantalla completa, pasar a modo administración y link al enlace público).
+
==== Creación - Wizard====
  
<br><br>
+
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).
<center>
 
[[File:Pandora new visual console, tab preview.png|800px]]<br><br>
 
<br><br></center>
 
  
====Pestaña Wizard====
+
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.
  
La pestaña wizard contiene un pequeño formulario para crear de una vez multitud de elementos de tipo Imagen estática, gráfica de módulo, calor simple e item de tipo percentil en la consola visual con sólo un par de clicks. Como se puede ver en la captura de pantalla, el formulario se compone de:
+
==== Creación - Wizard de Servicios====
 
 
* La imagen, que será igual para todos los elementos creados en lote.
 
* La distancia entre los elementos, que aparecerán uno de tras de otro en una linea horizontal desde la posición (0, 0).
 
* La caja de selección del agente. Para seleccionar uno o varios agentes se crearán elementos en lotes para la consola visual.
 
* La caja de selección de módulo. Este control es dinámico y se rellenará con los módulos de los agentes que se seleccione en el caja de selección del agente. Y aquí podrá seleccionar los módulos de los que quiera que se creen los elementos. Imagen estática en la consola visual.
 
 
 
<br><br>
 
<center>
 
[[File:Pandora new visual console, tab wizard.png|800px]]<br />
 
''Captura de pantalla de la pestaña wizard.''
 
</center>
 
<br><br>
 
 
 
====Pestaña Wizard de Servicios====
 
 
<br>
 
<br>
 
{{tip|Esta funcionalidad solo se encuentra disponible en la versión '''Enterprise''' de '''Pandora FMS'''.}}
 
{{tip|Esta funcionalidad solo se encuentra disponible en la versión '''Enterprise''' de '''Pandora FMS'''.}}
Line 95: Line 56:
 
<br>
 
<br>
  
====Pestaña lista de elementos====
+
==== 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.
 
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.
+
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.
  
La primera fila es la configuración de la imagen de background.
 
  
El resto de filas serán los elementos del mapa, que como se ve la captura de pantalla van agrupados en filas de dos cada elemento y separados por una linea negra horizontal.
 
 
<br><br>
 
 
<center>
 
<center>
 
[[File:Pandora new visual console, tab list elements.png|800px]]<br />
 
[[File:Pandora new visual console, tab list elements.png|800px]]<br />
 
''Captura de pantalla de ejemplo de la pestaña List of elements.''
 
''Captura de pantalla de ejemplo de la pestaña List of elements.''
 
</center>
 
</center>
<br><br>
 
  
====Pestaña Editor====
 
  
Esta pestaña contiene la mayor parte de la funcionalidad del editor de la consola visual, porque es donde podrás crear los elementos, editarlos y posicionarlos. Es una página dinámica, por lo que es necesario que tu navegador soporte correctamente el lenguaje javascript. Como se puede ver en la captura de pantalla, la pantalla se divide en dos áreas claramente diferenciadas: la caja de botones, el área de trabajo (donde ''"pintarás"'' la consola visual) y la paleta de opciones (no visible en esta captura de pantalla).
+
==== Creación y edición de consolas visuales ====
  
<br><br><center>
+
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).  
[[File:Pandora new visual console, tab editor.png|800px]]<br />
 
''Captura de pantalla de ejemplo de la pestaña Editor.''
 
</center><br><br>
 
  
=====Caja de botones=====
+
En la parte superior izquierda, están los diferentes elementos que podemos incluir en una VC (de izq. a derecha):
  
Los botones que componen la herramienta son:
+
Imagen estática, progreso, gráfica, histograma de eventos (AutoSLA), dato en crudo, etiqueta, icono sin estado, grupo, rectángulo, línea y servicio.
  
* Botones para crear los distintos tipos de elementos. Están situados a la izquierda y son: Static Graph, Percentile Item (tipo percentil o burbuja), Module Graph, Simple Value, Label, Icon y Servicios.
 
 
Cuando haces click en ellos aparece la paleta de opciones con los campos a rellenar para crear el elemento de ese tipo. Pueden estar desactivados si estás editando un elemento o creando un elemento, en cuyo caso si está activo, el hacer "click" cierra la paleta de opciones.
 
 
* Botón de Delete Item, que inicialmente está desactivado hasta que selecciones un elemento (salvo background). Al hacer click elimina sin remisión el elemento de esta consola visual borrándolo de la base de datos. '''Aviso''': no se puede deshacer esta acción.
 
 
* Botón de Edit Item, también inicialmente desactivado hasta la selección de cualquier elemento de la consola visual. Al hacer click te desplegará la paleta de opciones de ese elemento para que edites sus valores.
 
 
=====Área de trabajo=====
 
 
El área de trabajo tiene unas dimensiones de 100% del ancho de tu Pandora Console y 500 píxeles de alto. Como ves, dispone de barras de desplazamiento para facilitar el trabajo en consolas visuales de gran tamaño. Por cierto, el tamaño de la consola visual es el tamaño de la imagen de background. En el área de trabajo irán apareciendo los distintos elementos que creó en la posición por defecto (0,0) que es la esquina superior izquierda.
 
 
===== Opciones avanzadas =====
 
 
'''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.
 
 
No hace falta que rellenes en este control con la posición, salvo que quieras un posición exacta, ya que después de crear el elemento puedes posicionarlo arrastrándolo por la consola visual al igual que en una herramienta de dibujo.
 
 
'''Padre'''
 
 
Para representar la relación entre elementos de la consola visual se usan lineas que se dibujan entre ellos. Puede ser muy útil a nivel visual. Además de proporcionar a la propia linea un color según el estado del elemento padre. En el control se te desplegará una lista de elementos que hay en esta consola visual que pueden ser el padre del elemento.
 
 
'''Mapa asociado'''
 
 
También el elemento puede ser el portal hacia otra consola visual de cara a conseguir una mayor usabilidad.
 
 
Por ejemplo al tener dos consolas visuales: una que representa las máquinas dentro de un edificio que adminitra Pandora, y la otra que representa un mapamundi. En esta última podemos incluir un unico elemento que representa un "resumen" del estado completo del otro mapa (el de las maquinas dentro del edificio). De esta forma si en el mapa de las maquinas (imaginemos que hay 20), una de ellas se pone en rojo (estado CRITICAL), automáticamente en el mapa general, el icono que representa al mapa de las 20 maquinas, se pondrá en ROJO. 
 
 
Ademas al establecer la dependencia, al pinchar en el icono que vincula al mapa, se accede directamente a ese mapa, permitiendo un "drill-down" además de la visualización jerárquica.
 
 
Este control te dará un desplegable donde se muestran las consolas visuales ya creadas para enlazarla.
 
 
'''Color de la etiqueta'''
 
 
Por cuestiones de estética, o incluso para  mejorar la visibilidad del texto del label si el fondo del mapa es muy oscuro. Puedes cambiar el color del texto, que por defecto es negro. Es también un control inteligente, y además de poder escribir a mano el color en formato hexadecimal clásico de HTML, puedes desplegar un popup con la típica paleta de colores.
 
 
<center>
 
<br><br>
 
[[File:Pandora new visual console, paleta opciones, label color.png]]<br />
 
''Captura de paleta color en el label color.''
 
<br><br>
 
</center>
 
 
=====Background / Fondo=====
 
 
Al hacer click sobre la imagen de fondo, esta se puede editar. El fondo es un tipo de elemento especial porque ni se crea, ni se destruye. Sólo se pueden editar los siguientes valores:
 
 
* La imagen de fondo por medio de la paleta de opciones
 
* El tamaño que se puede realiza también por medio de la paleta de opciones o de una forma mas visual arrastrando de los bordes derecho, inferior o la esquina inferior derecha de la imagen que hace de background. El valor 0x0, al igual que en la imagen estática, es un valor especial que significa que toma el valor de ancho y alto original del archivo de image de background.
 
* Se puede aplicar el tamaño original del fondo aplicando el botón ''Original size''.
 
* Se puede también modificar el ratio ancho-alto de la imagen de fondo para que una vez se modifique alguno de estos valores se pueda conservar este ratio. Esto se puede hacer mediante los botones ''Proportional width'' y ''Proportional height''.
 
 
'''A partir de la version 5.0'''.
 
* Rejilla: Se puede mostrar una rejilla que permita mover los elementos cuadrados a esta y de esta forma queden todos alineados. Si se desactiva esta opción los elementos se podrán mover de nuevo libremente.
 
 
* El botón de autosalvado: cuando esta desactivado, solo se permiten las acciones de mover items y por eso esta desactivado los botones de creación.
 
 
<br><br>
 
<center>[[File:visual_console17.png]]</center>
 
<center>''Opción de rejilla en la paleta de opciones''</center>
 
<br><br>
 
 
<br><br>
 
<center>[[File:visual_console19.png|600px]]</center>
 
<center>''Image de fondo con la rejilla activada''</center>
 
<br><br>
 
 
'''A partir de la version 5.0'''.
 
* Salvar edición actual:Además de esta funcionalidad se podrá desactivar la funcionalidad de autoguardado que tiene por defecto el Visual console. Y se podrá forzar el guardado de la edición actual. Esto es muy útil para conexiones lentas en las que no se tenga seguridad en el autoguardado.
 
 
<br><br>
 
<center>[[File:visual_console18.png]]</center>
 
<center>''Opción para salvar la edición actual en la paleta de opciones''</center>
 
<br><br>
 
 
<br><br>
 
 
<center>
 
<center>
[[File:Pandora new visual console, paleta opciones, background.png]]<br />
+
[[File:vc_o2017_izq.jpg]]<br />
''Captura de ejemplo que muestra la paleta de opciones, al editar el background.''
 
 
</center>
 
</center>
<br><br>
 
  
===Paleta de opciones===
+
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.
Aparece al darle '''doble click''' sobre el objeto a editar o al darle al botón de editar de la caja de botones. El formulario de la paleta de opciones tiene los siguientes controles para todos los elementos, pero los elementos tienen algún control más que puedes consultar en su sección en el artículo.
 
 
 
====Label====
 
El texto que se mostrará en el elemento en la consola visual.
 
 
 
'''A partir de la version 5.0.1'''.
 
 
 
Tiene un editor rico con el se le puede dar estilos al label.
 
  
 
<center>
 
<center>
[[File:Label visualmap editor pandora5.png]]
+
[[File:vc_o2017_drcha.jpg]]<br />
 
</center>
 
</center>
  
====Agent====
+
Veamos paso a paso las caracteristicas más relevantes de los elementos que pueden componer una VC.
Un control inteligente con el que podrás buscar un agente de tu instalación de Pandora por medio de la IP o del nombre del agente.
 
  
<br><br>
 
<center>
 
[[File:Pandora new visual console, paleta opciones, agent.png]]<br />
 
''Captura de una búsqueda en el control inteligente de agent.''
 
</center>
 
<br><br>
 
  
====Module====
+
==== Elementos que puede contener un mapa ====
Este control responde a la selección del control del agente y autorellena con los módulos que contiene el agente.
 
  
<br><br>
+
=====Imagen estática=====
<center>
 
[[File:Pandora new visual console, paleta opciones, module.png]]<br />
 
''Captura del control module rellenado automáticamente con los módulos del agente.''
 
</center>
 
<br><br>
 
  
=== Elementos que puede contener un mapa ===
+
Este elemento muestra una imagen estática que se mostrará en cuatro posibles colores:
  
====Imagen estática====
+
* Gris, para estado desconocido.
 +
* Verde, para estado normal (OK)
 +
* Rojo, para estado crítico (CRITICAL)
 +
* Amarillo, para estado WARNING.
  
Este elemento muestra una imagen estática. 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 (/var/www/pandora_console/images/console/icons), incluso las podrás subir vía la herramienta incluida de ficheros. La nomenclatura de las imágenes es:
+
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:
 
&lt;nombre_imagen&gt;_&lt;estado&gt;.png donde el estado puede ser:
 
&lt;nombre_imagen&gt;_&lt;estado&gt;.png donde el estado puede ser:
  
Line 262: Line 116:
 
* "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.
 
* "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.
  
'''Creación de una imagen estática'''
+
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).
  
Para crear una imagen estática, simplemente pulsa en el botón Static Graph, situado el primero a la izquierda del panel de botones, y se te desplegará una paleta con las opciones para la nueva imagen. Las opciones más comunes las puedes ver en la entrada [[#Paleta de opciones|Paleta de opciones]], pero las opciones propias de la imagen estática las verás en la siguiente sección.
+
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).  
  
'''Opciones de la imagen estática'''
+
=====Icono=====
  
* '''image''': donde por medio de un control desplegable eliges la imagen que se mostrará, pudiendo incluso ver debajo del control una previsualización de la imagen.
+
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.
  
*Opciones avanzadas
+
'''Iconos enlazando otras páginas'''
  
:*'''Size''': en este juego de controles puedes darle un tamaño a la imagen. Por defecto viene el valor especial 0x0, que significa que tome el tamaño original de la imagen.
+
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.<br><br>
  
'''Capturas de pantalla'''
+
'''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:
  
<center>
+
<nowiki>http://</nowiki><pandora_home>/index.php?sec=snmpconsole&sec2=operation/snmpconsole/snmp_view
<br><br>
 
[[File:Pandora new visual console, paleta opciones, static graph, preview image.png]]<br />
 
''Paleta mostrando la previsualización de la imagen que se va ha añadir la consola visual.''
 
<br><br>
 
</center>
 
  
<br><br>
+
De esta forma en el modo de previsualización al clickar sobre el icono nos redirigirá al visor de la consola SNMP.
<center>
 
[[File:Pandora new visual console, paleta opciones, static graph.png]]<br />
 
''Vista de la paleta de opciones de una imagen estática en limpio.''
 
<br><br>
 
</center>
 
 
 
'''Trucos'''
 
 
 
* ¿Quiero crear un texto flotante?.
 
:* Es un método sencillo, basta con crear una imagen estática pero sin imagen.
 
  
 +
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.
  
====Icono====
+
=====Progreso=====
  
Este elemento muestra una imágen estática que no está asociada a ningún módulo.  
+
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.  
  
<br><br>
 
 
<center>
 
<center>
[[File:Items_visual_console.png]]<br />
+
[[File:Pandora new visual console, Percentile bar.png]]<br />
''Icono en el editor de mapas visuales.''
+
''Ejemplo de un elemento de tipo Barra de porcentaje, en este ejemplo se muestra el resultado de un módulo que monitoriza la CPU.''
 
</center>
 
</center>
<br><br>
 
  
En una instalación normal de Pandora las tendrás disponibles en (''<pandora_home>''/images/console/icons), incluso las podrás subir vía la herramienta incluida de ficheros. Al igual que en los demás elementos de la consola visual se le puede poner una etiqueta, modificar la posición, el tamaño, asociar otro elemento como padre y linkar con otro mapa visual.
 
  
Todo esto se puede mediante la interfaz en la vista Editor:
+
'''Opciones del item percentil'''
  
<br><br>
+
La barra de porcentaje tiene muchos menos controles que el resto de los elementos, pero tiene dos controles que explicaremos:
<center>
+
 
[[File:Editor_visual_map.png]]<br />
+
* '''Width''': que será el ancho en píxeles del elemento escogido (barra, bola, donut/circular).
''Ejemplo de creación de un icono.''
+
* '''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.
</center>
+
* '''Type''': El tipo permitirá definir la forma de representar el elemento gráficamente (barra, bola, donut, etc)
<br><br>
 
  
'''Iconos enlazando otras páginas'''
+
=====Gráfica de un módulo=====
  
'''A partir de la versión 5.0'''. 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.<br><br>
+
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.
'''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:
 
  
<nowiki>http://</nowiki><pandora_home>/index.php?sec=snmpconsole&sec2=operation/snmpconsole/snmp_view
+
'''Opciones de la gráfica de un módulo'''
  
De esta forma en el modo de previsualización al clickar sobre el icono nos redirigirá al visor de la consola SNMP.
+
En la gráfica es necesario definir el ancho y el alto; por eso pasa de estar oculto en las opciones avanzadas a mostrarse.
  
====Item percentil====
+
* '''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.
  
Los items de tipo percentil nos permiten ver el estado de un módulo de una manera muy gráfica y descriptiva. Pueden ser de tipo burbuja o tipo percentil (barra de progreso).  
+
Las gráficas no se "previsualizan" en el modo de edición, de forma que se presenta un cuadro blanco en su lugar.  
  
<br><br>
 
 
<center>
 
<center>
[[File:Pandora new visual console, Percentile bar.png]]<br />
+
[[File:VC_edit_o2017.jpg]]<br />
''Ejemplo de un elemento de tipo Barra de porcentaje, en este ejemplo se muestra el resultado de un módulo que monitoriza la CPU.''
+
''Ejemplo de vista de edicion de una VC con varios items''
 
</center>
 
</center>
<br><br>
 
  
'''Opciones del item percentil'''
+
<center>
 +
[[File:VC_edit_o2017-2.jpg]]<br />
 +
''Ejemplo de vista para el usuario de esa misma VC''
 +
</center>
  
La barra de porcentaje tiene muchos menos controles que el resto de los elementos, pero tiene dos controles que explicaremos:
+
=====Valor simple=====
  
* '''Width''': que será el ancho en píxeles de la barra de porcentaje.
+
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.
* '''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á con figurar si este item será de tipo burbuja o de tipo barra de progreso. Básicamente esto es la forma de representar el elemento gráficamente.  
 
  
<br><br>
+
'''Datos de tipo imagen'''.
<center>[[File:visual_console21.png]]
 
''Elemento de tipo percentil''
 
<br>
 
</center>
 
<br><br>
 
  
<br><br>
+
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".  
<center>
 
[[File:visual_console22.png]]
 
''Elemento de tipo burbuja''</center>
 
<br><br>
 
 
 
:'''Value to show''': Se podrá elegir entre el tanto por ciento hasta llegar al máximo valor o el último valor que reporte el módulo.
 
 
 
:* Opciones avanzadas: este elemento no tiene ningún control avanzado distinto de los básicos.
 
  
 
<center>
 
<center>
<br><br>
+
[[File:Data image vconsole.png]]<br />
[[File:Pandora new visual console, paleta opciones, percentile bar.png]]<br />
+
''Captura que muestra editor creando item de valor simple con contenido base64.''
''Captura de ejemplo de la paleta de opciones para la Barra de porcentaje.''
 
<br><br>
 
 
</center>
 
</center>
 
====Gráfica de un módulo====
 
 
Como su nombre indica en la consola visual aparecerá una gráfica que muestra la información de la actividad de un módulo del agente.
 
  
 
<center>
 
<center>
<br><br>
+
[[File:Data image vconsole 2.png]]<br />
[[File:Pandora new visual console, module graph.png]]<br />
+
''Captura de error recogida como valor simple en base64, mostrado como imagen.''
''Captura de ejemplo de un elemento Gráfica de un módulo, en que se puede ver en forma de gráfica los últimos datos de un módulo de CPU desde hace 1 hora.''
 
<br><br>
 
 
</center>
 
</center>
  
'''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.
+
=====Histograma de eventos/AutoSLA=====
  
* '''Period''': el periodo o fragmento de tiempo que va hasta el momento actual, ten en cuenta que esta gráfica ira cambiando con el tiempo.
+
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.
* '''Size''': ancho y alto de la imagen que sera la gráfica, no de la gráfica, es decir de la gráfica y las cifras de los ejes.
 
:* Opciones avanzadas: este elemento no tiene ningún control avanzado distinto de los básicos.
 
  
 
<center>
 
<center>
<br><br>
+
[[File:autosla_o2017.jpg]]<br />
[[File:Pandora new visual console, paleta opciones, module graph.png]]<br />
+
''Ejemplo de visualizacion de autosla con varios elementos''
''Captura en la que se ve la paleta de opciones de la gráfica de un módulo en edición.''
 
 
</center>
 
</center>
<br><br>
 
  
{{tip|Como con las gráficas, hay que calcularlas y crear la imagen.No es un proceso instantáneo, por lo que según la arquitectura en que tengas montado Pandora puede ser prácticamente instantáneo o tardar unos segundos en los que sólo verás el label del elemento en el mapa sin la imagen de la gráfica}}
+
=====Servicio=====
 +
 
 +
Permite representar (y ofrecer un enlace) al estado actual de un servicio. Indicando además el % de cumplimiento de SLA en tiempo real.
  
====Valor simple====
+
=====Etiqueta=====
  
Este elemento sólo muestra un texto de el &lt;label&gt; &lt;valor modulo&gt; sobre la consola visual. Por lo que sólo sera necesario definir un label (si quieres), elegir el agente y el módulo que mostrará el último valor en el pintado de la consola visual.
+
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)
  
<center>
 
 
<br><br>
 
<br><br>
[[File:Pandora new visual console, simple value.png]]<br />
+
<center>[[File:visual_console27.png]]<br>
''Fragmento de la captura de pantalla en que se muestra un ejemplo de un valor simple de un módulo de CPU.''
+
''Edición del item de tipo etiqueta''</center>
</center>
 
 
<br><br>
 
<br><br>
  
'''Opciones del valor simple'''
+
=====Grupo=====
  
La paleta de opciones de valor simple no tiene controles propios.
+
Es una imagen estática que representa el estado de un grupo.
  
<center><br><br>
+
<center>[[File:Group palete.png]]<br>
[[File:Pandora new visual console, paleta opciones, simple value.png]]<br />
+
''Edición del item de tipo grupo''</center>
''Captura que muestra la paleta de opciones de valor simple.''
 
</center><br><br>
 
  
'''A partir de la version 5.0.1'''.
 
Se puede dar formato al valor a través del editor de label con la macro (_VALUE_).
 
  
'''A partir de la version 7'''.
+
===== Opciones avanzadas de cada elemento =====
Muestra de subtipo de valor simple, imagen de datos en base 64'''
 
  
Al seleccionar un módulo que contenga una en su último estado en la base de datos una cadena que comience por data:image, será representada en el mapa visual no como un texto de valor simple, si no como una imagen compuesta por los datos de esa cadena de texto, que contiene la información de una imagen codificada.
+
'''Posición'''
  
<center><br><br>
+
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.
[[File:Data image vconsole.png]]<br />
 
''Captura que muestra editor creando item de valor simple con contenido base64.''
 
</center><br><br>
 
  
<center><br><br>
+
'''Padre'''
[[File:Data image vconsole 2.png]]<br />
 
''Captura de error recogida como valor simple en base64, mostrado como imagen.''
 
</center><br><br>
 
  
====Etiqueta====
+
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.
  
Para crear una etiqueta sin contenido asociado se puede utilizar este tipo de ítem. Para configurar este ítem solo es necesario rellenar el campo etiqueta.
+
'''Mapa asociado'''
 
 
<br><br>
 
<center>[[File:visual_console27.png]]<br>
 
''Edición del item de tipo etiqueta''</center>
 
<br><br>
 
  
====Grupo====
+
''Esta es quizás una de las características mas importantes de las consolas visuales''
  
Es una imagen estática que representa el estado de un grupo.
+
Ú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.
  
<center>[[File:Group palete.png]]<br>
 
''Edición del item de tipo grupo''</center>
 
  
 
=== Compartir una consola visual ===
 
=== Compartir una consola visual ===
  
Desde la version 4.0.2 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.
+
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:
 
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:
Line 470: Line 264:
 
Esta es una forma excelente de publicar datos a usuarios anónimos.
 
Esta es una forma excelente de publicar datos a usuarios anónimos.
  
=== Macros para mapas visuales ===
+
=== 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.
+
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.
  
 
<br>
 
<br>

Revision as of 17:02, 23 October 2017

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 se imita la sensación y el tacto de una aplicación de dibujo. El usuario elige 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.

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.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 aqui:

Las imágenes de background se encuentran en el directorio de Pandora Console (normalmente var/www/pandora_console/) en el directorio ./images/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.2.1 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.2.2 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.2.3 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
Captura de pantalla de ejemplo de la pestaña List of elements.


1.2.4 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.2.5 Elementos que puede contener un mapa

1.2.5.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.2.5.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.2.5.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.2.5.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.2.5.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.2.5.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.2.5.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.2.5.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.2.5.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.2.5.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.3 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.4 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