***************************************** Gestión de Inventario con WOCU-Monitoring ***************************************** **WOCU-Monitoring** permite la actualización continua de una base de datos de activos de TI (CMDB) de **forma automática** empleando :ref:`tareas específicas de importación y descubrimiento ` o agregando de **manualmente** nuevas categorías y atributos descriptivos asociados a un activo. A continuación, entramos en materia detallando ambos modos de gestión del inventario: Cómo añadir elementos de inventario a un Dispositivo de forma manual ==================================================================== **✓** La planta de monitorización cuenta con un Dispositivo (*Router-inventario*) dado de alta manualmente, que viene acompañado de los atributos ``Hostname`` y una dirección ``IP``. .. image:: ../images/use_cases/5_094_aggregator_use_cases_inventory_task-form_0-48.jpg :align: center .. Note:: Más información sobre este proceso en: :ref:`Alta manual de nuevos Dispositivos `. .. image:: ../images/use_cases/5_093_aggregator_use_cases_inventory_add-tasks_0-48.jpg :align: center **✓** Inicialmente, este Dispositivo carece aún de información de inventario como se puede comprobar en :ref:`la sección Inventory` de su modal. .. image:: ../images/use_cases/5_095_aggregator_use_cases_inventory-tab_0-48.jpg :align: center **✓** Enriquecer el inventario es siempre una buena práctica para la administración de activos en la herramienta. Por ello, se pretende añadir (de forma manual) dos nuevos campos útiles para situar al Dispositivo en el CPD: ``CPD_Nam`` y ``Rack_Number``. Existen dos vías para agregar o actualizar la información de inventario: **Método 1: A través de un fichero CSV:** * Parte de la construcción de un fichero **CSV** en el que incluir los anteriores campos mencionados, más el campo obligatorio ``host_name``: :: host_name;CPD_Name;Rack_Number Router-inventario;CPD_BCN_234;Rack_123 * A continuación, será necesario crear una :ref:`tasksCSV-inventory`, desde el módulo :ref:`import_tool`, para anexar el fichero CSV recién generado en el campo **CSV File**. De forma opcional, se define la **sección** ``EMPLACEMENT``, para organizar y aunar los datos del emplazamiento del Dispositivo en el inventario. .. image:: ../images/use_cases/5_096_aggregator_use_cases_inventory_csv-task-form_0-48.jpg :align: center * Ejecutada y finalizada la tarea, la :ref:`sección Inventory ` ya debe mostrar en pantalla esta nueva información de inventario. .. image:: ../images/use_cases/5_097_aggregator_use_cases_inventory-tab_0-48.jpg :align: center **Método 2: Usando una estructura JSON** * Desde la sección :guilabel:`Inventory Data` del :ref:`Módulo de Configuración Avanzada `, es posible añadir la estructura ``JSON`` deseada. En este ejemplo, se incluye información sobre el departamento al que da servicio el Dispositivo en cuestión, añadiendo la **categoría** ``DEPARTMENT``, más unos campos con la ciudad y descripción del departamento. .. image:: ../images/use_cases/5_098_aggregator_use_cases_inventory-import-tool_module_0-48.jpg :align: center * Confirmada la acción, la :ref:`sección Inventory ` ya debe mostrar en pantalla esta nueva información de inventario. .. image:: ../images/use_cases/5_099_aggregator_use_cases_inventory-tab_0-48.jpg :align: center Cómo añadir elementos de inventario a un Dispositivo de forma automática ======================================================================== **WOCU-Monitoring** incluye procesos de autodescubrimiento para la detección de cambios en los dispositivos que integran la planta monitorizada. Para ello, se ejecutan tareas de tipo :ref:`SNMP Inventory ` y :ref:`SCAN Inventory`, disponibles en el módulo :ref:`import_tool`. **Autodescubrimiento con tareas SNMP:** **✓** Las tareas de autodescubrimiento vía **SNMP** se utilizan para inventariar ciertos cambios en las OID de las MIB del Dispositivo. Un ejemplo de la información de autodescubrimiento sería la siguiente: :: {"system vendor": "Cisco", "system contact": "support@ase.org", "system location": "GlobalSwitch", "system description": "Cisco Adaptive Security Appliance Version 9.13(1)"} **✓** Para iniciar el proceso, en primer lugar será necesario crear una tarea :ref:`SNMP Inventory `, desde el módulo :ref:`import_tool` y completar los campos: **CPD_Name**, **Community SNMP** y la **Section** del inventario, si pretendemos agrupar y organizar los datos recopilados. .. image:: ../images/use_cases/5_100_aggregator_use_cases_inventory-snmp_inventory_0-48.jpg :align: center .. image:: ../images/use_cases/5_101_aggregator_use_cases_inventory_csv-task-form_0-48.jpg :align: center **✓** Ejecutada y finalizada la tarea satisfactoriamente, la :ref:`sección Inventory ` ya debe mostrar en pantalla esta nueva información de inventario. .. image:: ../images/use_cases/5_102_aggregator_use_cases_inventory-tab_0-48.jpg :align: center **Autodescubrimiento con tareas SCAN:** **✓** Las tareas de autodescubrimiento tipo **SCAN** son útiles para detectar el tipo y versión de sistema operativo, los puertos abiertos y en general, toda la información posible que se pueda obtener de un Dispositivo del que sólo se conoce la dirección IP. Ejemplo de la información extraída en este tipo de tareas: :: {"ip": "12.30.0.4", "os": "linux", "isup": "1", "ostype": "general purpose", "osvendor": "linux", "openports": "5000,5003,5009,5901,161", "osversion": "3.x"} **✓** Para iniciar el proceso, en primer lugar será necesario crear una tarea :ref:`SCAN Inventory` desde el módulo :ref:`import_tool` y completar los campos: **Name** y la **Section** del inventario, si pretendemos agrupar y organizar los datos recopilados. **✓** Ejecutada y finalizada la tarea satisfactoriamente, la :ref:`sección Inventory ` ya debe mostrar en pantalla esta nueva información de inventario. .. admonition:: Modificaciones en el inventario Es posible editar la información autodescubierta por el sistema y adaptarla a determinadas necesidades, desde la sección :guilabel:`Inventory Data` del :ref:`Módulo de Configuración Avanzada `. En la siguiente imagen se observa un cambio de la versión de **IOS** de ``11.2`` a ``12.2``. .. image:: ../images/use_cases/5_103_aggregator_use_cases_inventory-field_0-48.jpg :align: center Informes de Inventario de Dispositivos (*Device Inventory*) =========================================================== El :ref:`Módulo de Generación de Informes ` de **WOCU-Monitoring** incluye el informe predefinido :ref:`Device Inventory `, que genera inventarios de dispositivos monitorizados a medida y sobre multitud de aspectos técnicos y funcionales, de una manera rápida y sencilla. Continuando con el ejemplo, se define un informe que sólo recopilará determinadas secciones del inventario: ``EMPLACEMENT`` y ``SNMP MODULOS``. .. image:: ../images/use_cases/5_104_aggregator_use_cases_inventory-report_0-48.jpg :align: center .. Note:: Descripción pormenorizada de cada uno de los parámetros de configuración en: :ref:`device_inventory`. La salida del informe (en formato PDF) sobre el Dispositivo *Router-inventario* es la siguiente: .. image:: ../images/use_cases/5_105_aggregator_use_cases_inventory-report-output_0-48.jpg :align: center También, desde la sección :guilabel:`Inventory Data` del :ref:`Módulo de Configuración Avanzada `, existe la función de exportación en formato **CSV** (delimitado por comas) de las propiedades de inventario recopiladas sobre el conjunto de dispositivos. .. image:: ../images/use_cases/5_106_aggregator_use_cases_inventory-report-export_0-48.jpg :align: center Consultas a través de API Pública ================================= **WOCU-Monitoring** dispone de una :doc_url:`API Pública ` con *endpoints* específicos de inventario. Medianta la consulta ``GET`` a la siguiente URL, seguido de la autenticación, se obtendría la información de inventario de un Dispositivo. :: http://x.x.x.x/aggregator/api/device-inventory/realm/wocu-demos/host/router-inventario/inventory/ .. image:: ../images/use_cases/5_107_aggregator_use_cases_inventory-report-export_0-48.jpg :align: center Las posibilidades que brinda esta consulta al API son muy variadas. Podría por ejemplo desarrollarse un :doc_url:`Pack de Monitorización ` que compruebe cualquier atributo del inventario y alertar ante versiones de *firmware* desactualizadas, versiones de software vulnerables o características hardware no compatibles.