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

From Pandora FMS Wiki
Jump to: navigation, search
(Crear un mapa visual)
(Gráfica de un módulo)
 
(97 intermediate revisions by 14 users not shown)
Line 1: Line 1:
==Mapas visuales==
+
[[Pandora:Documentation|Volver a Indice de Documentación Pandora FMS]]
 +
==Consolas visuales==
 +
=== Introducción ===
 +
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 FMS 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 construye su mapa de monitorización. El nuevo editor de la consola visual es mucho más funcional, aunque hay que reconocer los méritos del antiguo editor de la consola visual. En la nueva consola visual se intenta y se consigue imitar la sensación y el tacto de una aplicación de dibujo (como el [http://www.gimp.org/ GIMP]), además de simplificar el editor separando en varias pestañas temáticas: pestaña "Data", pestaña "Preview", pestaña "Editor", pestaña "Wizard" y pestaña "List of elements".
+
Estos son ejemplos reales de consolas visuales, tal como se ven en una pantalla de 40":
  
El mapa visual permite representar la información de monitorización, en tiempo real, de la forma que el usuario decide, de una forma totalmente gráfica. EL usuario elige el fondo y los iconos que representan el estado. Con Pandora vienen una serie de iconos, pero el usuario puede fácilmente personalizar los suyos.
+
<center>
 +
[[image:vc_sample1.jpg|800px]]
 +
<br><br>
 +
[[image:vc_sample2.jpg|800px]]
 +
<br><br>
 +
[[image:vc_sample3.jpg|800px]]
 +
</center>
 +
 
 +
=== 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 submenú 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.
  
Los mapas 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.
+
<center>
 +
[[image:pre54_new.png]]
 +
</center>
  
Los elementos que puede contener un mapa son: Imagen estática, etiquetas, item de porcentaje (burbuja o barra de porcentaje), gráfica de un módulo y valor simple o gráfico estático.
+
Para grandes entornos, donde poseemos múltiples consolas visuales, se ha creado el filtrado de las mismas mediante la búsqueda de texto libre, por grupo y con recursión de grupos secundarios y subgrupos.
  
=== Crear un mapa visual ===
+
==== Creación de una consola visual ====
  
Para crear un mapa visual se va a Operation > Topology Maps > Visual console. Aparece una lista con todos los mapas creados, para crear uno nuevo se pulsa en el botón “Create”.
+
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:pre54.png|900px]]
+
[[File:Vc_tabs_o2017.jpg]]
 
</center>
 
</center>
<br><br>
 
  
Aparece una ventana donde se pone el nombre del mapa, se elije el grupo y se selecciona el mapa que se va a usar. Una vez se han rellenado los campos se pincha en create.
+
==== 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 FMS, dentro del directorio:
 +
 
 +
./images/console/backgrounds/
 +
 
 +
Puede subir ahí sus propias imágenes a través del gestor de ficheros integrado en Pandora FMS (Admin tools -> File manager).  
 +
 
 +
'''Permisos de acceso en la consola visual'''
 +
 
 +
Las ACL en las consolas visuales implican que cualquiera que tenga acceso de lectura de una consola visual, porque 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.
  
<br><br>
 
 
<center>
 
<center>
[[image:pre55.png|900px]]
+
[[File:visual_console_edit1.jpg]]
 
</center>
 
</center>
<br><br>
 
  
Una vez creado el mapa aparece la ventana donde se crea el mapa. La gestion/edición de los mapas visuales ha cambiado completamente en la version 3.1, hemos intentado hacer un editor totalmente gráfico y mucho mas fácil de usar.
+
==== 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).
  
===Ver un mapa visual===
+
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 módulos de diferentes agentes, creando muchos elementos a la vez, los cuales se pueden identificar por el nombre del agente, el nombre del módulo o ambos. La interfaz no es compleja de usar y lo más sencillo es probar con algunos elementos y ver cómo funciona.
  
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 - Wizard de Servicios====
 +
<br>
 +
{{tip|Esta funcionalidad solo se encuentra disponible en la versión '''Enterprise''' de '''Pandora FMS'''.}}
  
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 pestaña wizard de servicios contiene un pequeño formulario para crear de una vez varios elementos de tipo ''servicio con solo un par de clicks. Los servicios seleccionados aparecerán en la consola visual colocados automáticamente con el icono elegido.
  
<br><br>
+
<br>
 
<center>
 
<center>
[[image:pre73.png|900px]]
+
[[File:Pandora new visual console, tab services wizard.png]]<br />
 +
''Captura de pantalla de la pestaña wizard de servicios.''
 
</center>
 
</center>
<br><br>
+
<br>
 +
 
 +
==== 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.
  
Para acceder a ver el Mapa se pincha sobre el nombre del mapa que se quiere ver.
 
  
<br><br>
 
 
<center>
 
<center>
[[image:pre74.png|750px]]
+
[[File:Pandora new visual console, tab list elements.png|800px]]<br />
 +
''Ejemplo de cómo se ve la lista de elementos de una VC''
 
</center>
 
</center>
<br><br>
 
  
Debajo del mapa hay un combo donde se elige el tiempo  de rtefresco del mapa.
+
==== Creación y edición de consolas visuales ====
El mapa se puede poner en pantalla completa pulsando sobre el siguiente icono [[image:pre75.png]]
+
 
 +
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).  
  
Es posible acceder a la pagina de edición del mapa pulsando sobre el siguiente icono [[image:pre76.png]]
+
En la parte superior izquierda están los diferentes elementos que podemos incluir en una VC (de izquierda a derecha):
  
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]].
+
Imagen estática, progreso, gráfica, histograma de eventos (AutoSLA), dato en crudo, etiqueta, icono sin estado, grupo, rectángulo, línea y servicio.
  
===Borrar un mapa visual===
+
<center>
 +
[[File:vc_o2017_izq.jpg]]<br />
 +
</center>
  
Para borrar un Mapa visual se va a Reporting>Visual console. Aparece una lista con todos los Mapas creados. Para borrar el Mapa se pulsa en el icono papelera correspondiente a la fila del mapa a borrar.
+
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.
  
<br><br>
 
 
<center>
 
<center>
[[image:pre77.png|800px]]
+
[[File:vc_o2017_drcha.jpg]]<br />
 
</center>
 
</center>
<br><br>
 
  
=== Pestañas del editor de mapas ===
+
Veamos, paso a paso, las características más relevantes de los elementos que pueden componer una VC.
 +
 
  
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.
+
==== Elementos que puede contener un mapa ====
  
 +
=====Imagen estática=====
  
====Pestaña Data====
+
Este elemento muestra una imagen estática que se mostrará en cuatro posibles colores:
  
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.
+
* Gris, para estado desconocido.
 +
* Verde, para estado normal (OK).
 +
* Rojo, para estado crítico (CRITICAL).
 +
* Amarillo, para estado WARNING.
  
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.
+
Según el estado del módulo, agente o mapa, se muestra una imagen u otra. En una instalación normal de Pandora FMS deben estar en:
 +
./images/console/icons
  
Las imágenes de background se encuentran en el directorio de Pandora Console (normalmente var/www/pandora_console/) en el directorio ./images/backgrounds/ .
+
Y estos ficheros utilizan una nomenclatura especial para dichas imágenes: &lt;nombre_imagen&gt;_&lt;estado&gt;.png donde el estado puede ser:
 
<br><br>
 
<br><br>
 
<center>
 
<center>
[[image:Pandora new visual console, tab data.png|800px]]<br />
+
[[File:Static image, example.png]]<br />
''Captura de pantalla del formulario de la pestaña data.''</center>
+
''Ejemplo de imágenes con el nombre y el estado.''
 +
</center>
 
<br><br>
 
<br><br>
  
====Pestaña Preview====
+
* "": 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.
  
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).
+
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).
  
<br><br>
+
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 módulo mal saldrá en color rojo y solo se verá verde si están todos sus módulos en estado normal). También se puede elegir si habilitar el ultimo valor, no mostrarlo o solo ocultar para módulos booleanos (opción por defecto). La imagen estática se puede asociar también al estado general de otra consola visual (ver opciones avanzadas, al final de este capítulo).
<center>
+
 
[[File:Pandora new visual console, tab preview.png|800px]]<br><br>
+
=====Icono=====
<br><br></center>
+
 
 +
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 información de estado, es decir, no se pueden usar como imagen estática, pero sí 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á enlazar el icono con una página web. Por ejemplo, para enlazar 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
  
====Pestaña Wizard====
+
También puede ser útil para enlazar, por ejemplo, a otra consola visual, y que de esta manera podamos construir "iconos de navegación" entre nuestras propias consolas visuales.
  
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:
+
=====Progreso=====
  
* La imagen, que será igual para todos los elementos creados en lote.
+
Los ítems 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.  
* 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>
 
<center>
[[File:Pandora new visual console, tab wizard.png|800px]]<br />
+
[[File:Pandora new visual console, Percentile bar.png]]<br />
''Captura de pantalla de la pestaña wizard.''
+
''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>
 
  
====Pestaña Wizard de Servicios====
 
<br>
 
{{tip|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.
+
'''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 examine bien el módulo a monitorizar para ver cuál 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.).
 +
 
 +
=====Gráfica de un módulo=====
  
<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.
<center>
 
[[File:Pandora new visual console, tab services wizard.png]]<br />
 
''Captura de pantalla de la pestaña wizard de servicios.''
 
</center>
 
<br>
 
{{warning|Este wizard ejecuta una tarea destructiva, cada vez que lo apliques recreará los servicios de la consola visual.}}
 
<br>
 
  
====Pestaña lista de elementos====
+
'''Opciones de la gráfica de un módulo'''
  
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.
+
En la gráfica es necesario definir el ancho y el alto; por eso pasa de estar oculto en las opciones avanzadas a mostrarse.
  
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.
+
* '''Intervalo''': Erango de datos que va a mostrar la gráfica desde el momento actual hacia atrás; por ejemplo: 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.
  
La primera fila es la configuración de la imagen de background.
+
Las gráficas no se "previsualizan" en el modo de edición, de forma que se presenta un cuadro blanco en su lugar.  
  
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.
+
<center>
 +
[[File:VC_edit_o2017.jpg]]<br />
 +
''Ejemplo de vista de edición de una VC con varios ítems''
 +
</center>
  
<br><br>
 
 
<center>
 
<center>
[[File:Pandora new visual console, tab list elements.png|800px]]<br />
+
[[File:VC_edit_o2017-2.jpg]]<br />
''Captura de pantalla de ejemplo de la pestaña List of elements.''
+
''Ejemplo de vista para el usuario de esa misma VC''
 
</center>
 
</center>
<br><br>
 
  
====Pestaña Editor====
+
===== Gráficas de tarta y de barras serializadas =====
 +
 
 +
Estos dos elementos de la consola visual permiten incorporar gráficas complejas de tarta o barras verticales/horizontales a una consola visual. A diferencia de una gráfica combinada de tipo "Tarta" o "Barras", estas gráficas serializadas incorporan datos de un único módulo, con un formato especial. Solo podemos incorporar datos de un módulo de tipo "Texto" que contenga series de datos con el siguiente formato:
  
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).
+
<pre>
 +
etiqueta,valor
 +
etiqueta2,valor2
 +
etiqueta3,valor3
 +
etiqueta4,valor4
 +
..
 +
</pre>
  
<br><br><center>
+
Hasta un máximo de seis elementos. Para crear un módulo con estos datos se recomienda hacerlo con un plugin de agente. Este sería un ejemplo de plugin local de Linux que genera un XML para un módulo de este tipo. En este caso estamos usando la REST API de Integria IMS para obtener datos de las incidencias abiertas, separadas por estado:
[[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=====
+
<pre>
 +
#!/bin/bash
  
Los botones que componen la herramienta son:
+
#NEW
 +
echo Nuevo,`curl -s "https://support.mycompany.comintegria/include/api.php?user=external_api&user_pass=mysecret&pass=mysecret2&op=get_stats&params=opened,,1"` > /tmp/soporte2.tmp
  
* 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.
+
#UNCONFIRMED
+
echo Noconfirmado,`curl -s "https://support.mycompany.comintegria/include/api.php?user=external_api&user_pass=mysecret&pass=mysecret2&op=get_stats&params=opened,,2"` >> /tmp/soporte2.tmp
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.
+
#ASIGNADOS
 +
echo Asignado,`curl -s "https://support.mycompany.comintegria/include/api.php?user=external_api&user_pass=mysecret&pass=mysecret2&op=get_stats&params=opened,,3"` >> /tmp/soporte2.tmp
  
* 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.
+
#REABIERTOS
 +
echo ReAbiertos,`curl -s "https://support.mycompany.comintegria/include/api.php?user=external_api&user_pass=mysecret&pass=mysecret2&op=get_stats&params=opened,,4"` >> /tmp/soporte2.tmp
  
=====Área de trabajo=====
+
#MOVIDO A DESARROLLO
 +
echo EnDesarrollo,`curl -s "https://support.mycompany.comintegria/include/api.php?user=external_api&user_pass=mysecret&pass=mysecret2&op=get_stats&params=opened,,5"` >> /tmp/soporte2.tmp
  
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.
+
#PEND. CIERRE:
 +
echo PendCierre,`curl -s "https://support.mycompany.comintegria/include/api.php?user=external_api&user_pass=mysecret&pass=mysecret2&op=get_stats&params=opened,,6"` >> /tmp/soporte2.tmp
  
===== Opciones avanzadas =====
+
echo "<module>"
 +
echo "<name>Support_Status</name>"
 +
echo "<type>generic_data_string</type>"
 +
echo "<data><![CDATA[`cat /tmp/soporte2.tmp| tr -d ' '`]]></data>"
 +
echo "</module>"
 +
</pre>
  
'''Posición'''
+
Esto generará un XML similar a este:
  
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.
+
<pre>
 +
<module>
 +
<name>Soporte_Estados</name>
 +
<type>generic_data_string</type>
 +
<data><![CDATA[Nuevos,0
 +
Noconfirmado,0
 +
Asignados,43
 +
ReAbiertos,6
 +
EnDesarrollo,5
 +
PendCierre,197]]></data>
 +
</module>
 +
</pre>
  
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.
+
Que al ser interpretado mostrará una gráfica como esta (en el caso de la gráfica de tipo tarta):
  
'''Padre'''
+
<center>
 +
[[File:Tarta serie.jpg]]<br>
 +
<i>Vista del editor</i>
 +
</center>
  
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.
+
<center>
 +
[[file:pie_serie_graph_vc.jpg]]<br>
 +
<i>Vista en la consola visual</i>
 +
</center>
  
'''Mapa asociado'''
+
=====Valor simple=====
  
También el elemento puede ser el portal hacia otra consola visual de cara a conseguir una mayor usabilidad.
+
Este elemento permite mostrar en la consola visual el valor de un módulo en tiempo real. Solo 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.
  
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. 
+
'''Datos de tipo imagen'''.  
  
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.
+
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".  
  
Este control te dará un desplegable donde se muestran las consolas visuales ya creadas para enlazarla.
+
<center>
 +
[[File:Data image vconsole.png]]<br />
 +
''Captura que muestra editor creando item de valor simple con contenido base64.''
 +
</center>
  
'''Color de la etiqueta'''
+
=====Histograma de eventos/AutoSLA=====
  
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.
+
Muestra una barra horizontal, similar a la de la vista principal de agente, donde se muestran, para un agente o una combinación agente/modulo, los eventos ocurridos en las últimas 24 horas.
  
 
<center>
 
<center>
<br><br>
+
[[File:autosla_o2017.jpg]]<br />
[[File:Pandora new visual console, paleta opciones, label color.png]]<br />
+
''Ejemplo de visualización de autoSLA con varios elementos''
''Captura de paleta color en el label color.''
 
<br><br>
 
 
</center>
 
</center>
  
=====Background / Fondo=====
+
=====Servicio=====
  
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:
+
Permite representar (y ofrecer un enlace) al estado actual de un servicio, indicando además el % de cumplimiento de SLA en tiempo real.  
  
* La imagen de fondo por medio de la paleta de opciones
+
=====Etiqueta de texto=====
* 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'''.
+
Para crear una etiqueta de texto sin contenido asociado se puede utilizar este tipo de ítem. Contiene texto y código HTML (lo que puede crear un enlace interno u otras opciones avanzadas).
* 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.
+
=====Grupo=====
  
<br><br>
+
Es una imagen estática que representa el estado de un grupo.
<center>[[File:visual_console17.png]]</center>
+
 
<center>''Opción de rejilla en la paleta de opciones''</center>
+
<center>[[File:Group palete.png]]<br>
<br><br>
+
''Edición del item de tipo grupo''</center>
 +
 
 +
=====Cajas y líneas=====
  
<br><br>
+
Si no tiene la capacidad de "personalizar" una imagen de fondo, esta es una forma sencilla pero efectiva de "personalizar" el aspecto de su consola, añadiendo cajas de diferentes colores y formas que permitan ordenar y mejorar el aspecto de su consola visual.
<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'''.
+
=====Relojes=====
* 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>
+
Este ítem permite añadir a su consola visual un reloj dinámico, tanto analógico como digital, de cualquier zona horaria, mostrando y actualizando la hora exacta en todo momento sin necesidad de actualizar la página.
<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>
+
[[File:reloj1.png]]<br />
<center>
 
[[File:Pandora new visual console, paleta opciones, background.png]]<br />
 
''Captura de ejemplo que muestra la paleta de opciones, al editar el background.''
 
</center>
 
<br><br>
 
  
===Paleta de opciones===
+
[[File:reloj2.png]]<br />
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'''.
+
=====Mapa de calor / Nube de color=====
  
Tiene un editor rico con el se le puede dar estilos al label.
+
Este elemento permite representar nubes difuminadas de color que dependen del valor del módulo asignado; a menudo se le conoce como "mapas de calor".
  
 
<center>
 
<center>
[[File:Label visualmap editor pandora5.png]]
+
[[File:color-cloud-settings.png]]<br>
 +
''Vista de edición del elemento''
 
</center>
 
</center>
  
====Agent====
+
<br>
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.
+
 
 +
A través de la configuración se pueden crear rangos de valores (por ahora solo numéricos). Cuando el valor del módulo seleccionado se encuentre entre los valores (límites incluidos) de un rango, se usará el color elegido de ese rango para el elemento. Si no se cumple ningún rango, se usará el color por defecto.
  
<br><br>
 
 
<center>
 
<center>
[[File:Pandora new visual console, paleta opciones, agent.png]]<br />
+
[[File:color-cloud-example.png]]<br>
''Captura de una búsqueda en el control inteligente de agent.''
+
''Ejemplo de consola visual con varios elementos de tipo nube de color''
 
</center>
 
</center>
<br><br>
 
  
====Module====
+
<br>
Este control responde a la selección del control del agente y autorellena con los módulos que contiene el agente.
+
 
 +
===== 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; tenga 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 ======
  
<br><br>
+
Para representar la relación entre elementos de la consola visual se usan líneas que se dibujan entre ellos. Proporciona a la propia línea un color según el estado del elemento padre.  
<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 ===
+
====== Mapa asociado ======
  
====Imagen estática====
+
Varios elementos pueden ser empleados para "resumir" el estado de otra consola visual. De esta forma, el estado del icono (Verde, Amarillo o Rojo) se muestra usando el estado de la consola enlazada. Además, es posible activar un enlace del elemento a la consola visual.
  
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:
+
''' Formas de calcular el estado de la consola visual enlazada '''
&lt;nombre_imagen&gt;_&lt;estado&gt;.png donde el estado puede ser:
 
  
<br><br>
+
* Por defecto
<center>
 
[[File:Static image, example.png]]<br />
 
''Ejemplo de imágenes con el nombre y el estado.''
 
</center>
 
<br><br>
 
  
* "": cuando no tiene ningún estado el agente, módulo o la consola visual que enlaza.
+
: Calcula el estado a partir del estado de todos los elementos, como lo haría un agente.
* "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.
 
  
'''Creación de una imagen estática'''
+
* Por peso
  
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.
+
: Calcula el estado de los elementos que tienen asignados una consola visual, un módulo o un agente en relación a un porcentaje de elementos configurado por el usuario. Este porcentaje es el que tiene que superar el número de elementos de un estado no normal respecto al número de elementos tenidos en cuenta en el cálculo para que el ese estado cambie.
  
'''Opciones de la imagen estática'''
+
: Por ejemplo, dado un elemento con un porcentaje del 50% y una consola visual enlazada con 5 elementos:
  
* '''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.
+
:- 1 ''critical'', 1 ''warning'' y 3 ''normal''  ->  Estado ''normal''.
 +
:- 2 ''critical'', 2 ''warning'' y 1 ''normal''  ->  Estado ''normal''.
 +
:- 1 ''critical'', 3 ''warning'' y 1 ''normal'' ->  Estado ''warning''.
 +
:- 3 ''critical'', 1 ''warning'' y 1 ''normal''  ->  Estado ''critical''.
 +
:- 1 ''critical'', 1 ''warning'' y 3 ''unknown'' ->  Estado ''unknown''.
  
*Opciones avanzadas
+
: Si varios estados superan el peso, la prioridad es igual que en el resto de cálculo de estados (''critical'' > ''warning'' > ''unknown''). Si no hay elementos para realizar el cálculo, el estado pasa a ser ''unknown''.
  
:*'''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.
+
* Por elementos críticos
  
'''Capturas de pantalla'''
+
: Calcula el estado usando los elementos en estado ''critical'' y los porcentajes de los umbrales definidos por el usuario. Si el número de los elementos en estado ''critical'' respecto al número de elementos tenidos en cuenta en el cálculo supera el porcentaje asignado como ''warning'', el estado pasa a ser ''warning''. Lo mismo para el porcentaje asignado como ''critical'', que además tiene preferencia.
  
 
<center>
 
<center>
<br><br>
+
[[image:Consolavisual_nodo1.png]]
[[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>
 
</center>
  
<br><br>
+
A partir de la versión 727 de Pandora FMS se pueden realizar cambios en esta sección de forma masiva. Para ello, debemos ir a ''Extensions -> Visual Console Manager''. Una vez allí, escogeremos la consola visual y los elementos que queremos modificar, así como el tipo de cálculo de estado que queremos cambiar.
 +
 
 
<center>
 
<center>
[[File:Pandora new visual console, paleta opciones, static graph.png]]<br />
+
[[image:Consolavisual_nodo2.png]]
''Vista de la paleta de opciones de una imagen estática en limpio.''
 
<br><br>
 
 
</center>
 
</center>
  
'''Trucos'''
+
====== Acceso restringido para grupo ======
  
* ¿Quiero crear un texto flotante?.
+
Si se selecciona uno, se restringirá la visualización de este elemento en la consola visual para aquellos usuarios que no tengan permisos de lectura sobre el grupo en cuestión.  
:* Es un método sencillo, basta con crear una imagen estática pero sin imagen.
 
  
 +
También se tomará en cuenta a la hora del cálculo del peso de estado en una consola enlazada; solo se calculará sobre los elementos que el usuario pueda ver.
  
====Icono====
+
=== Compartir una consola visual ===
  
Este elemento muestra una imágen estática que no está asociada a ningún módulo.
+
Es posible compartir un mapa visual con cualquiera, aunque no tenga siguiera un usuario/password para entrar en Pandora FMS. 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" (el icono de la cámara de fotos, arriba a la derecha), tal como se puede ver en esta captura de pantalla:
  
<br><br>
+
<center><Br><br>
<center>
+
[[image:Share_visual_console.png|400px]]
[[File:Items_visual_console.png]]<br />
+
</center><Br><br>
''Icono en el editor de mapas visuales.''
+
 
</center>
+
Esta URL especial es estática y tiene el siguiente aspecto:
<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.
+
http://192.168.50.2/operation/visual_console/public_console.php?hash=86d1d0e9b6f41c2e3e04c5a6ad37136b&id_layout=3&id_user=admin2
  
Todo esto se puede mediante la interfaz en la vista Editor:
+
Comparta esa URL con cualquiera, y podrá acceder a la información visualizada en la consola visual. El usuario no podrá acceder desde ahí a ninguno de los enlaces o la información de ningún agente; únicamente a la información publicada en la consola visual.
 +
''Esta es una forma excelente de publicar datos a usuarios anónimos.''
  
<br><br>
+
=== Macros en las consolas visuales ===
<center>
 
[[File:Editor_visual_map.png]]<br />
 
''Ejemplo de creación de un icono.''
 
</center>
 
<br><br>
 
  
'''Iconos enlazando otras páginas'''
+
Desde la versión 712 es posible utilizar palabras clave o "macros" que actúen dinámicamente; 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.
  
'''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>
+
<br>
'''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
+
Lista de macros de mapas visuales:
  
De esta forma en el modo de previsualización al clickar sobre el icono nos redirigirá al visor de la consola SNMP.
+
_date_ : Muestra la fecha usando el formato local del PHP.<br />
 +
_time_ : Muestra la hora usando el formato local del PHP.<br />
 +
_agent_ : Muestra el alias del agente seleccionado.<br />
 +
_module_ : Muestra el nombre del módulo seleccionado.<br />
 +
_agentdescription_ : Muestra la descripción del agente seleccionado.<br />
 +
_address_ : Muestra la dirección IP del agente seleccionado.<br />
 +
_moduledescription_ : Muestra la descripción del módulo seleccionado.<br />
 +
<center><br>
 +
[[File:macro_mapa_visual.png]]
 +
</center><br>
  
====Item percentil====
+
=== Visualización en pantalla completa ===
  
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).
+
Una de las funcionalidades más importantes de las consolas visuales es permitir el refresco automático y la visualización en pantalla completa de una pantalla. Esto tiene su aplicación más obvia en grandes paneles informativos. Existe un control que permite definir cada cuánto queremos que refresque la pantalla. Si activa el modo "pantalla completa" de una consola visual, lo verá arriba a la derecha:
  
<br><br>
 
 
<center>
 
<center>
[[File:Pandora new visual console, Percentile bar.png]]<br />
+
[[File:Vc fullscreen control.jpg]]
''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>
 
  
'''Opciones del item percentil'''
+
Existe una funcionalidad parecida en los dashboard, pero que además permite rotar estas pantallas, sean consolas visuales u otro tipo de dashboard. Lo verá en el capítulo dedicado a los ''dashboards''
 +
 
 +
=== Ejemplo completo de consola visual enlazada ===
 +
 
 +
Puede ver el concepto de servicio de forma más clara con el siguiente ejemplo.
 +
 
 +
Chip Company es una empresa que se dedica a vender ordenadores a través de Internet. Chip Company tiene tres grandes departamentos:
 +
* Tienda Online.
 +
* Soporte.
 +
* Gestión.
 +
 
 +
<br><br><center>
 +
[[Image:Chip-departments.png|center‎]]
 +
<br><br></center>
 +
 
 +
Como puede ver, los servicios que se ofrecen al cliente son tres: Tienda Online, Soporte e, indirectamente, Gestión. Todos los servicios son críticos para el negocio, ya que si uno falla los demás se pueden ver afectados, y la empresa podría perder mucho dinero, incluso clientes.
  
La barra de porcentaje tiene muchos menos controles que el resto de los elementos, pero tiene dos controles que explicaremos:
+
Al final, en esencia, lo que deseamos saber es si estamos cumpliendo con nuestros clientes, ya que, como usted sabe, un cliente satisfecho puede significar más clientes. Por eso, proporcionar un servicio estable y de calidad es tan importante.
  
* '''Width''': que será el ancho en píxeles de la barra de porcentaje.
+
Para monitorizar los servicios de Chip Company necesitamos conocer más a fondo cada uno de ellos.
* '''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>
+
El servicio de la <b>Tienda Online</b> es el responsable de garantizar que el sitio web de la tienda está online, que todos los precios de los productos son correctos, gestionar las categorías de los productos, etc. En general, asegurarse de que toda la información sobre productos y métodos de pago es correcta en el sitio web para facilitar la compra.
<center>[[File:visual_console21.png]]
 
''Elemento de tipo percentil''
 
<br>
 
</center>
 
<br><br>
 
  
<br><br>
+
De este servicio nos interesan los siguientes parámetros:
<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.
+
<center><br><br>
 +
[[Image:Operation-detail.png|center]]
 +
</center><br><br>
  
:* Opciones avanzadas: este elemento no tiene ningún control avanzado distinto de los básicos.
+
El servicio de <b>Soporte</b> tiene que resolver todas la posibles consultas que les puedan surgir a los consumidores con los equipos que han comprado. Algunas tareas de este departamento son ayudar a los clientes a llevar a cabo sus configuraciones o gestionar los reemplazos de ordenadores y sus piezas, además de gestionar las devoluciones de equipos.  
  
<center>
+
Este servicio, al igual que el de Tienda Online, está directamente relacionado con el cliente, por lo que ambos son muy importantes para la imagen de la compañía desde el punto de vista del cliente.
<br><br>
 
[[File:Pandora new visual console, paleta opciones, percentile bar.png]]<br />
 
''Captura de ejemplo de la paleta de opciones para la Barra de porcentaje.''
 
<br><br>
 
</center
 
  
====Gráfica de un módulo====
+
De este departamento se quieren monitorizar los siguientes parámetros:
  
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><br><br>
 +
[[Image:Support-service-detail.png|center]]
 +
</center><br><br>
  
<center>
+
El tercer servicio es el de <b>Gestión</b>, dentro del cual se encuentran los departamentos de Marketing, Comercial, RRHH y otros relacionados con la gestión. Su principal tarea es asegurarse de que todos los procesos internos de la compañía funcionan correctamente. Los servicios que ofrece este departamento son cruciales, ya que coordinan los demás departamentos.  
<br><br>
 
[[File:Pandora new visual console, module graph.png]]<br />
 
''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>
 
  
'''Opciones de la gráfica de un módulo'''
+
Los parámetros más importantes del servicio de Gestión son:
  
En la gráfica es necesario definir el ancho y el alto; por eso pasa de estar oculto en las opciones avanzadas a mostrarse.
+
<center><br><br>
 +
[[Image:Management-detail.png|center]]
 +
</center><br><br>
  
* '''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.
+
Para representar estos servicios podemos enlazar varios mapas con la ayuda de la <b>Consola Visual de Pandora FMS</b> y las imágenes que describen la jerarquía de Chip Company.
* '''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>
+
Los datos de estos mapas son calculados en tiempo real, así que siempre sabremos el estado de los servicios en todo momento. Lo primero que hicimos fue realizar el mapa de cada servicio independientemente.
<br><br>
 
[[File:Pandora new visual console, paleta opciones, module graph.png]]<br />
 
''Captura en la que se ve la paleta de opciones de la gráfica de un módulo en edición.''
 
</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}}
+
La siguiente imagen muestra una consola visual que simula el mapa del servicio Tienda Online con el estado de todos sus parámetros. Como puede ver el parámetro '''Contenido Actualizado''' tiene un punto rojo, lo que quiere decir que tiene algún problema. Sobre los otros parámetros podemos decir que son correctos, ya que tienen puntos verdes. La flecha hacia atrás sirve para ir al mapa general, que verá más adelante.
  
====Valor simple====
+
<center><br><br>
 +
[[Image:Screen-onlineshop-detail.png|center]]
 +
</center><br><br>
  
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.
+
Si quiere conocer más sobre el problema puede hacer click sobre el punto rojo y verá la vista técnica, con la que puede saber más acerca del problema. Esta vista técnica muestra los datos recogidos por Pandora FMS desde fuentes como CRM, ERP, SAP, Bases de datos (MySQL, Oracle, etc.), incluso dispositivos como PCs, servidores o routers.
  
<center>
+
<center><br><br>
<br><br>
+
[[Image:Agent-detail.png|850px|center]]
[[File:Pandora new visual console, simple value.png]]<br />
 
''Fragmento de la captura de pantalla en que se muestra un ejemplo de un valor simple de un módulo de CPU.''
 
 
</center>
 
</center>
 
<br><br>
 
<br><br>
  
'''Opciones del valor simple'''
+
También hicimos otros mapas para el Servicio de Soporte que puede ver en la imagen inferior. Como puede ver todos los parámetros importantes del Servicio de Soporte son correctos ya que todos tienen puntos verdes.
 +
 
 +
<center><br><br>
 +
[[Image:Screen-support-detail.png|center]]
 +
</center><br><br>
 +
 
 +
Para terminar, con los mapas de servicios creamos un mapa para el Servicio de Gestión, el cual puede ver en la siguiente imagen. De nuevo, el mapa muestra los parámetros más importantes con sus correspondientes puntos; en este caso todos los puntos son de color verde, lo que significa que todos los parámetros del servicio son correctos.
 +
 
 +
<center><br><br>
 +
[[Image:Screen-management-detail.png|center]]
 +
</center><br><br>
  
La paleta de opciones de valor simple no tiene controles propios.
+
Además, creamos un mapa general con todos los servicios de Chip Company, como se ve en la siguiente imagen. En este mapa puede ver la jerarquía de servicios de Chip Company con los estados de cada uno de ellos. Si hace click en uno de los puntos que informan del estado verá el mapa específico de cada servicio. Con todos estos mapas hemos creado una completa vista navegable de los servicios de Chip Company. El estado de cada servicio es el mismo que se muestra en los mapas específicos de cada uno; como puede ver, Gestión y Soporte son correctos, pero Tienda Online tiene problemas. '''Como puede ver, el estado de los servicios escala dentro de la jerarquía hasta la cima, propagando el estado'''.
  
 
<center><br><br>
 
<center><br><br>
[[File:Pandora new visual console, paleta opciones, simple value.png]]<br />
+
[[Image:Screen-chip-overview.png|center]]
''Captura que muestra la paleta de opciones de valor simple.''
 
 
</center><br><br>
 
</center><br><br>
  
'''A partir de la version 5.0.1'''.
+
=== Consolas visuales favoritas ===
Se puede dar formato al valor a través del editor de label con la macro (_VALUE_).
+
 
 +
Las opciones de consolas visuales favoritas permiten tener accesos directos desde la barra de menú o acceder a un listado de consolas visuales marcadas como favoritas.
  
====Etiqueta====
+
Para marcar una consola visual como favorita debemos marcar el checkbox de consola visual favorita a la hora de crearla o editarlo en el apartado de edición principial de la misma:
  
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.
+
[[Image:consola_favo_01.png|center]]
  
<br><br>
+
Para modificar las opciones de consolas visuales favoritas deberemos acceder al apartado Setup -> Visual Styles de la barra de menú lateral.
<center>[[File:visual_console27.png]]<br>
+
 
''Edición del item de tipo etiqueta''</center>
+
[[Image:consola_favo_style.png|center]]
<br><br>
+
 
 +
* Tipo de vista de las consolas visuales: La sección de consolas visuales por defecto será la lista completa de consolas visuales o solo las favoritas.
 +
* Número de consolas visuales favoritas a mostrar en el menú: Número de consolas visuales a mostrar en la barra de menú lateral.
 +
 
 +
En caso de introducir un número en el campo de número de consolas visuales favoritas, estas se mostrarán de tal forma:
 +
 
 +
[[Image:Consola_favorito_2.png|center]]
 +
 
 +
Sección de todas las consolas visuales:
 +
 
 +
[[Image:consola_favorito_4.png|center]]
 +
 
 +
Sección solo de las consolas visuales favoritas:
  
====Grupo====
+
[[Image:consola_favorito_3.png|center]]
  
Es una imagen estática que representa el estado de un grupo.
+
=== Plantillas de consolas visuales ===
  
<center>[[File:Group palete.png]]<br>
+
En esta sección se pueden observar las plantillas de consolas visuales creadas, así como crear plantillas nuevas.
''Edición del item de tipo grupo''</center>
 
  
=== Compartir una consola visual ===
+
Para poder crear una plantilla nueva, únicamente tendremos que escoger una consola visual creada, un nombre representativo y el grupo, y se creará una nueva plantilla.
  
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.
+
[[Image:Example_CV_3.png|center]]
  
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:
+
=== Asistente de consola visuales ===
  
<center><Br><br>
+
El wizard de las plantillas de consolas visuales sirve para utilizar una plantilla de las creadas anteriormente para aplicar a una nueva consola visual. Se debe escoger los agentes a los cuales se quiere aplicar la plantilla seleccionada. Se crearán tantas consolas visuales como agentes se hayan escogido.
[[image:Share_visual_console.png|800px]]
 
</center><Br><br>
 
  
Esta URL especial es estática y tiene el siguiente aspecto:
+
{{Tip|Una vez creada la plantilla, si se quiere realizar algún cambio, se debe realizar sobre la consola visual escogida y volver a crear la plantilla.}}
  
http://192.168.50.2/operation/visual_console/public_console.php?hash=86d1d0e9b6f41c2e3e04c5a6ad37136b&id_layout=3&id_user=admin2
+
[[Image:Example_CV_4.png|center]]
  
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.
+
Una vez aplicada nuestra plantilla, creará las consolas visuales, las cuales aparecerán en su listado.
  
Esta es una forma excelente de publicar datos a usuarios anónimos.
+
Si la plantilla es creada a través de una consola visual favorita, todas las consolas visuales creadas a partir de esta plantilla también serán favoritas.
  
 +
Para poder hacer mas dinámico el empleo de plantillas, en las etiquetas de los elementos de las consolas visuales podemos añadir macros: _agent_ y _agentalias_ sustituyendo estas por el nombre y el alias del agente.
  
[[Pandora:Documentation|Volver a Indice de Documentacion Pandora FMS]]
+
[[Pandora:Documentation|Volver a Indice de Documentación Pandora FMS]]
  
 
[[Category:Pandora FMS]]
 
[[Category:Pandora FMS]]

Latest revision as of 10:28, 11 June 2020

Volver a Indice de Documentación Pandora FMS

1 Consolas visuales

1.1 Introducción

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 FMS 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.2 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 submenú 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 new.png

Para grandes entornos, donde poseemos múltiples consolas visuales, se ha creado el filtrado de las mismas mediante la búsqueda de texto libre, por grupo y con recursión de grupos secundarios y subgrupos.

1.2.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.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 FMS, dentro del directorio:

./images/console/backgrounds/

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

Permisos de acceso en la consola visual

Las ACL en las consolas visuales implican que cualquiera que tenga acceso de lectura de una consola visual, porque 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.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 módulos de diferentes agentes, creando muchos elementos a la vez, los cuales se pueden identificar por el nombre del agente, el nombre del módulo o ambos. La interfaz no es compleja de usar y lo más sencillo es probar con algunos elementos y ver cómo funciona.

1.2.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 solo 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.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 cómo se ve la lista de elementos de una VC

1.2.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 izquierda 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 características más relevantes de los elementos que pueden componer una VC.


1.2.7 Elementos que puede contener un mapa

1.2.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 FMS deben estar en:

./images/console/icons

Y estos ficheros utilizan una nomenclatura especial para dichas imágenes: <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 módulo mal saldrá en color rojo y solo se verá verde si están todos sus módulos en estado normal). También se puede elegir si habilitar el ultimo valor, no mostrarlo o solo ocultar para módulos booleanos (opción por defecto). La imagen estática se puede asociar también al estado general de otra consola visual (ver opciones avanzadas, al final de este capítulo).

1.2.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 información de estado, es decir, no se pueden usar como imagen estática, pero sí 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á enlazar el icono con una página web. Por ejemplo, para enlazar 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

También puede ser útil para enlazar, por ejemplo, a otra consola visual, y que de esta manera podamos construir "iconos de navegación" entre nuestras propias consolas visuales.

1.2.7.3 Progreso

Los ítems 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 examine bien el módulo a monitorizar para ver cuál 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.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: Erango de datos que va a mostrar la gráfica desde el momento actual hacia atrás; por ejemplo: 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 edición de una VC con varios ítems

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

1.2.7.5 Gráficas de tarta y de barras serializadas

Estos dos elementos de la consola visual permiten incorporar gráficas complejas de tarta o barras verticales/horizontales a una consola visual. A diferencia de una gráfica combinada de tipo "Tarta" o "Barras", estas gráficas serializadas incorporan datos de un único módulo, con un formato especial. Solo podemos incorporar datos de un módulo de tipo "Texto" que contenga series de datos con el siguiente formato:

etiqueta,valor
etiqueta2,valor2
etiqueta3,valor3
etiqueta4,valor4
..

Hasta un máximo de seis elementos. Para crear un módulo con estos datos se recomienda hacerlo con un plugin de agente. Este sería un ejemplo de plugin local de Linux que genera un XML para un módulo de este tipo. En este caso estamos usando la REST API de Integria IMS para obtener datos de las incidencias abiertas, separadas por estado:

#!/bin/bash

#NEW
echo Nuevo,`curl -s "https://support.mycompany.comintegria/include/api.php?user=external_api&user_pass=mysecret&pass=mysecret2&op=get_stats&params=opened,,1"` > /tmp/soporte2.tmp

#UNCONFIRMED
echo Noconfirmado,`curl -s "https://support.mycompany.comintegria/include/api.php?user=external_api&user_pass=mysecret&pass=mysecret2&op=get_stats&params=opened,,2"` >> /tmp/soporte2.tmp

#ASIGNADOS
echo Asignado,`curl -s "https://support.mycompany.comintegria/include/api.php?user=external_api&user_pass=mysecret&pass=mysecret2&op=get_stats&params=opened,,3"` >> /tmp/soporte2.tmp

#REABIERTOS
echo ReAbiertos,`curl -s "https://support.mycompany.comintegria/include/api.php?user=external_api&user_pass=mysecret&pass=mysecret2&op=get_stats&params=opened,,4"` >> /tmp/soporte2.tmp

#MOVIDO A DESARROLLO
echo EnDesarrollo,`curl -s "https://support.mycompany.comintegria/include/api.php?user=external_api&user_pass=mysecret&pass=mysecret2&op=get_stats&params=opened,,5"` >> /tmp/soporte2.tmp

#PEND. CIERRE:
echo PendCierre,`curl -s "https://support.mycompany.comintegria/include/api.php?user=external_api&user_pass=mysecret&pass=mysecret2&op=get_stats&params=opened,,6"` >> /tmp/soporte2.tmp

echo "<module>"
echo "<name>Support_Status</name>"
echo "<type>generic_data_string</type>"
echo "<data><![CDATA[`cat /tmp/soporte2.tmp| tr -d ' '`]]></data>"
echo "</module>"

Esto generará un XML similar a este:

<module>
<name>Soporte_Estados</name>
<type>generic_data_string</type>
<data><![CDATA[Nuevos,0
Noconfirmado,0
Asignados,43
ReAbiertos,6
EnDesarrollo,5
PendCierre,197]]></data>
</module>

Que al ser interpretado mostrará una gráfica como esta (en el caso de la gráfica de tipo tarta):

Tarta serie.jpg
Vista del editor

Pie serie graph vc.jpg
Vista en la consola visual

1.2.7.6 Valor simple

Este elemento permite mostrar en la consola visual el valor de un módulo en tiempo real. Solo 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.

1.2.7.7 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 combinación agente/modulo, los eventos ocurridos en las últimas 24 horas.

Autosla o2017.jpg
Ejemplo de visualización de autoSLA con varios elementos

1.2.7.8 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.7.9 Etiqueta de texto

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

1.2.7.10 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.7.11 Cajas y líneas

Si no tiene la capacidad de "personalizar" una imagen de fondo, esta es una forma sencilla pero efectiva de "personalizar" el aspecto de su consola, añadiendo cajas de diferentes colores y formas que permitan ordenar y mejorar el aspecto de su consola visual.

1.2.7.12 Relojes

Este ítem permite añadir a su consola visual un reloj dinámico, tanto analógico como digital, de cualquier zona horaria, mostrando y actualizando la hora exacta en todo momento sin necesidad de actualizar la página.

Reloj1.png

Reloj2.png


1.2.7.13 Mapa de calor / Nube de color

Este elemento permite representar nubes difuminadas de color que dependen del valor del módulo asignado; a menudo se le conoce como "mapas de calor".

Color-cloud-settings.png
Vista de edición del elemento


A través de la configuración se pueden crear rangos de valores (por ahora solo numéricos). Cuando el valor del módulo seleccionado se encuentre entre los valores (límites incluidos) de un rango, se usará el color elegido de ese rango para el elemento. Si no se cumple ningún rango, se usará el color por defecto.

Color-cloud-example.png
Ejemplo de consola visual con varios elementos de tipo nube de color


1.2.7.14 Opciones avanzadas de cada elemento
1.2.7.14.1 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; tenga 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.

1.2.7.14.2 Padre

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

1.2.7.14.3 Mapa asociado

Varios elementos pueden ser empleados para "resumir" el estado de otra consola visual. De esta forma, el estado del icono (Verde, Amarillo o Rojo) se muestra usando el estado de la consola enlazada. Además, es posible activar un enlace del elemento a la consola visual.

Formas de calcular el estado de la consola visual enlazada

  • Por defecto
Calcula el estado a partir del estado de todos los elementos, como lo haría un agente.
  • Por peso
Calcula el estado de los elementos que tienen asignados una consola visual, un módulo o un agente en relación a un porcentaje de elementos configurado por el usuario. Este porcentaje es el que tiene que superar el número de elementos de un estado no normal respecto al número de elementos tenidos en cuenta en el cálculo para que el ese estado cambie.
Por ejemplo, dado un elemento con un porcentaje del 50% y una consola visual enlazada con 5 elementos:
- 1 critical, 1 warning y 3 normal -> Estado normal.
- 2 critical, 2 warning y 1 normal -> Estado normal.
- 1 critical, 3 warning y 1 normal -> Estado warning.
- 3 critical, 1 warning y 1 normal -> Estado critical.
- 1 critical, 1 warning y 3 unknown -> Estado unknown.
Si varios estados superan el peso, la prioridad es igual que en el resto de cálculo de estados (critical > warning > unknown). Si no hay elementos para realizar el cálculo, el estado pasa a ser unknown.
  • Por elementos críticos
Calcula el estado usando los elementos en estado critical y los porcentajes de los umbrales definidos por el usuario. Si el número de los elementos en estado critical respecto al número de elementos tenidos en cuenta en el cálculo supera el porcentaje asignado como warning, el estado pasa a ser warning. Lo mismo para el porcentaje asignado como critical, que además tiene preferencia.

Consolavisual nodo1.png

A partir de la versión 727 de Pandora FMS se pueden realizar cambios en esta sección de forma masiva. Para ello, debemos ir a Extensions -> Visual Console Manager. Una vez allí, escogeremos la consola visual y los elementos que queremos modificar, así como el tipo de cálculo de estado que queremos cambiar.

Consolavisual nodo2.png

1.2.7.14.4 Acceso restringido para grupo

Si se selecciona uno, se restringirá la visualización de este elemento en la consola visual para aquellos usuarios que no tengan permisos de lectura sobre el grupo en cuestión.

También se tomará en cuenta a la hora del cálculo del peso de estado en una consola enlazada; solo se calculará sobre los elementos que el usuario pueda ver.

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 FMS. 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" (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. El usuario no podrá acceder desde ahí a ninguno de los enlaces o la información de ningún 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 versión 712 es posible utilizar palabras clave o "macros" que actúen dinámicamente; 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_ : Muestra la fecha usando el formato local del PHP.
_time_ : Muestra la hora usando el formato local del PHP.
_agent_ : Muestra el alias del agente seleccionado.
_module_ : Muestra el nombre del módulo seleccionado.
_agentdescription_ : Muestra la descripción del agente seleccionado.
_address_ : Muestra la dirección IP del agente seleccionado.
_moduledescription_ : Muestra la descripción del módulo seleccionado.


Macro mapa visual.png


1.5 Visualización en pantalla completa

Una de las funcionalidades más importantes de las consolas visuales es permitir el refresco automático y la visualización en pantalla completa de una pantalla. Esto tiene su aplicación más obvia en grandes paneles informativos. Existe un control que permite definir cada cuánto queremos que refresque la pantalla. Si activa el modo "pantalla completa" de una consola visual, lo verá arriba a la derecha:

Vc fullscreen control.jpg

Existe una funcionalidad parecida en los dashboard, pero que además permite rotar estas pantallas, sean consolas visuales u otro tipo de dashboard. Lo verá en el capítulo dedicado a los dashboards

1.6 Ejemplo completo de consola visual enlazada

Puede ver el concepto de servicio de forma más clara con el siguiente ejemplo.

Chip Company es una empresa que se dedica a vender ordenadores a través de Internet. Chip Company tiene tres grandes departamentos:

  • Tienda Online.
  • Soporte.
  • Gestión.


center‎



Como puede ver, los servicios que se ofrecen al cliente son tres: Tienda Online, Soporte e, indirectamente, Gestión. Todos los servicios son críticos para el negocio, ya que si uno falla los demás se pueden ver afectados, y la empresa podría perder mucho dinero, incluso clientes.

Al final, en esencia, lo que deseamos saber es si estamos cumpliendo con nuestros clientes, ya que, como usted sabe, un cliente satisfecho puede significar más clientes. Por eso, proporcionar un servicio estable y de calidad es tan importante.

Para monitorizar los servicios de Chip Company necesitamos conocer más a fondo cada uno de ellos.

El servicio de la Tienda Online es el responsable de garantizar que el sitio web de la tienda está online, que todos los precios de los productos son correctos, gestionar las categorías de los productos, etc. En general, asegurarse de que toda la información sobre productos y métodos de pago es correcta en el sitio web para facilitar la compra.

De este servicio nos interesan los siguientes parámetros:



Operation-detail.png


El servicio de Soporte tiene que resolver todas la posibles consultas que les puedan surgir a los consumidores con los equipos que han comprado. Algunas tareas de este departamento son ayudar a los clientes a llevar a cabo sus configuraciones o gestionar los reemplazos de ordenadores y sus piezas, además de gestionar las devoluciones de equipos.

Este servicio, al igual que el de Tienda Online, está directamente relacionado con el cliente, por lo que ambos son muy importantes para la imagen de la compañía desde el punto de vista del cliente.

De este departamento se quieren monitorizar los siguientes parámetros:



Support-service-detail.png


El tercer servicio es el de Gestión, dentro del cual se encuentran los departamentos de Marketing, Comercial, RRHH y otros relacionados con la gestión. Su principal tarea es asegurarse de que todos los procesos internos de la compañía funcionan correctamente. Los servicios que ofrece este departamento son cruciales, ya que coordinan los demás departamentos.

Los parámetros más importantes del servicio de Gestión son:



Management-detail.png


Para representar estos servicios podemos enlazar varios mapas con la ayuda de la Consola Visual de Pandora FMS y las imágenes que describen la jerarquía de Chip Company.

Los datos de estos mapas son calculados en tiempo real, así que siempre sabremos el estado de los servicios en todo momento. Lo primero que hicimos fue realizar el mapa de cada servicio independientemente.

La siguiente imagen muestra una consola visual que simula el mapa del servicio Tienda Online con el estado de todos sus parámetros. Como puede ver el parámetro Contenido Actualizado tiene un punto rojo, lo que quiere decir que tiene algún problema. Sobre los otros parámetros podemos decir que son correctos, ya que tienen puntos verdes. La flecha hacia atrás sirve para ir al mapa general, que verá más adelante.



Screen-onlineshop-detail.png


Si quiere conocer más sobre el problema puede hacer click sobre el punto rojo y verá la vista técnica, con la que puede saber más acerca del problema. Esta vista técnica muestra los datos recogidos por Pandora FMS desde fuentes como CRM, ERP, SAP, Bases de datos (MySQL, Oracle, etc.), incluso dispositivos como PCs, servidores o routers.



Agent-detail.png



También hicimos otros mapas para el Servicio de Soporte que puede ver en la imagen inferior. Como puede ver todos los parámetros importantes del Servicio de Soporte son correctos ya que todos tienen puntos verdes.



Screen-support-detail.png


Para terminar, con los mapas de servicios creamos un mapa para el Servicio de Gestión, el cual puede ver en la siguiente imagen. De nuevo, el mapa muestra los parámetros más importantes con sus correspondientes puntos; en este caso todos los puntos son de color verde, lo que significa que todos los parámetros del servicio son correctos.



Screen-management-detail.png


Además, creamos un mapa general con todos los servicios de Chip Company, como se ve en la siguiente imagen. En este mapa puede ver la jerarquía de servicios de Chip Company con los estados de cada uno de ellos. Si hace click en uno de los puntos que informan del estado verá el mapa específico de cada servicio. Con todos estos mapas hemos creado una completa vista navegable de los servicios de Chip Company. El estado de cada servicio es el mismo que se muestra en los mapas específicos de cada uno; como puede ver, Gestión y Soporte son correctos, pero Tienda Online tiene problemas. Como puede ver, el estado de los servicios escala dentro de la jerarquía hasta la cima, propagando el estado.



Screen-chip-overview.png


1.7 Consolas visuales favoritas

Las opciones de consolas visuales favoritas permiten tener accesos directos desde la barra de menú o acceder a un listado de consolas visuales marcadas como favoritas.

Para marcar una consola visual como favorita debemos marcar el checkbox de consola visual favorita a la hora de crearla o editarlo en el apartado de edición principial de la misma:

Consola favo 01.png

Para modificar las opciones de consolas visuales favoritas deberemos acceder al apartado Setup -> Visual Styles de la barra de menú lateral.

Consola favo style.png
  • Tipo de vista de las consolas visuales: La sección de consolas visuales por defecto será la lista completa de consolas visuales o solo las favoritas.
  • Número de consolas visuales favoritas a mostrar en el menú: Número de consolas visuales a mostrar en la barra de menú lateral.

En caso de introducir un número en el campo de número de consolas visuales favoritas, estas se mostrarán de tal forma:

Consola favorito 2.png

Sección de todas las consolas visuales:

Consola favorito 4.png

Sección solo de las consolas visuales favoritas:

Consola favorito 3.png

1.8 Plantillas de consolas visuales

En esta sección se pueden observar las plantillas de consolas visuales creadas, así como crear plantillas nuevas.

Para poder crear una plantilla nueva, únicamente tendremos que escoger una consola visual creada, un nombre representativo y el grupo, y se creará una nueva plantilla.

Example CV 3.png

1.9 Asistente de consola visuales

El wizard de las plantillas de consolas visuales sirve para utilizar una plantilla de las creadas anteriormente para aplicar a una nueva consola visual. Se debe escoger los agentes a los cuales se quiere aplicar la plantilla seleccionada. Se crearán tantas consolas visuales como agentes se hayan escogido.

Info.png

Una vez creada la plantilla, si se quiere realizar algún cambio, se debe realizar sobre la consola visual escogida y volver a crear la plantilla.

 


Example CV 4.png

Una vez aplicada nuestra plantilla, creará las consolas visuales, las cuales aparecerán en su listado.

Si la plantilla es creada a través de una consola visual favorita, todas las consolas visuales creadas a partir de esta plantilla también serán favoritas.

Para poder hacer mas dinámico el empleo de plantillas, en las etiquetas de los elementos de las consolas visuales podemos añadir macros: _agent_ y _agentalias_ sustituyendo estas por el nombre y el alias del agente.

Volver a Indice de Documentación Pandora FMS