Importación por fichero CSV

La importación o inventariado por fichero CSV permite tanto la incorporación de nuevos activos, como el enriqueciendo de datos de inventario de Activos (ya alojados en la BBDD de monitorización de WOCU-Monitoring), a través de la lectura de un fichero en formato CSV que contiene el listado de los Dispositivos junto con sus respectivos datos.

Nota

El formato CSV (Comma Separated Value), es un formato sencillo que separa las columnas mediante un separador (punto y coma “;”) y las filas por un salto de línea. Resulta sencillo exportar los datos desde multitud de orígenes (otras herramientas de monitorización, BBDD, herramientas CMDB, inventarios en algún formato de tablas u hojas de cálculo) hacia este tipo de formato. Así, es muy fácil compatibilizar cualquier sistema preexistente como Fuente de Importación de WOCU-Monitoring.

Existen dos posibles Tareas que aplican ficheros CSV para la incorporación de Activos: Tarea CSV_Import y Tarea CSV_Inventory y la Tarea CSV_Delete para el borrado masivo de activos.

../../_images/4_008_import-tool_tasks_csv-tasks-selector_0-58.png

Tarea CSV_Import

A continuación se detallan cada uno de los distintos campos que el usuario debe rellenar para la configuración de la Tarea:

../../_images/4_009_import-tool_tasks_csv-import_0-50.png

Realm Name

Este campo no es editable e indica el nombre del Reino objeto de la Tarea de Importación.

Task Type

Este campo indica el Tipo de Tarea que va a generarse. Es el primer campo seleccionable en el desplegable y que condiciona el resto de los campos.

Si se selecciona otro tipo de Tarea distinta antes de guardar los cambios, los datos introducidos anteriormente se perderán.

Name

El campo recoge el nombre escogido por el usuario para identificar la nueva Tarea creada.

Enabled

Marcando esta casilla se habilita y activa esta Nueva Tarea de Importación para su próxima ejecución.

Por defecto esta opción está habilitada.

Interval

Mediante este desplegable es posible escoger con qué frecuencia se ejecutará la importación de activos de esta nueva tarea. Las posibles opciones disponibles son:

  • Tarea ejecutada a diario (Every 1 days).

  • Tarea ejecutada cada segundo (Every 1 second).

Contrab

Opción alternativa para establecer la periodicidad en la que la Tarea será ejecutada. Su configuración se realiza empleando el Formato Crontab, ofreciendo mayor flexibilidad para casos de uso más específicos.

Amplie información sobre la definición de periodos de ejecución aquí.

Información de ayuda sobre el archivo CSV

A continuación, el formulario de creación ofrece instrucciones acerca del tipo de tarea de importación y del formato que tendrá que respetar el fichero CSV empleado como fuente de datos de los activos a importar.

Import data via CSV file

CSV_IMPORT task allow Wocu users to import several data types
into WOCU system. Data types can be one of the following:

       Hosts

       Contacts

       HostBusinessProcess

       ServiceBusinessProcess

Each CSV data type has a minimun required fields and a list of
allowed fields to be imported on it

Sample /tmp/csv_import.txt:

       host_name;address;use_templates

       dummy_csv;127.0.0.1;generic-host

  Host CSV:

       Required fields:

          host_name;address

       Allowed fields:

          host_name;address;use_templates;use_packs;alias;check_interval;
          max_check_attempts;active_checks_enabled;retry_interval;hostgroups;
          notifications_enabled;latitude;longitude;check_period_link;check_period;
          notification_period_link;notification_period;service_excludes;service_includes;
          service_overrides;check_command;business_impact;parents;poller_tag;macros;
          display_name;realm;contacts;contact_groups

  Contacts CSV:

       Required fields:

          contact_name

       Allowed fields:

          contact_name;alias;use;host_notifications_enabled;
          service_notifications_enabled;email;pager;is_admin;password;
          notificationways_link;contactgroups;notificationways

   Hostgroup CSV:

       Required fields:

          hostgroup_name

       Allowed fields:

          hostgroup_name;alias;realm;host_members
          bp_members;hostgroup_members

  HostBusinessProcess CSV:

       Required fields:

          host_name;check_command;business_impact

       Allowed fields:

          host_name;check_command;use_templates;use_packs;
          alias;check_interval;max_check_attempts;active_checks_enabled;
          retry_interval;hostgroups;notifications_enabled;
          latitude;longitude;check_period_link;check_period;
          notification_period_link;notification_period;service_excludes;service_includes;
          service_overrides;business_impact;contacts;contact_groups

  ServicesBusinessProcess CSV:

       Required fields:

         host_name;check_command;service_description

       Allowed fields:

         host_name;check_command;service_description
         normal_check_interval;use;business_impact

CSV File

En este campo el usuario deberá adjuntar el fichero en formato CSV con el inventario de Dispositivos o valores asociados a importar a través de la Tarea.

Only scan active and pending assets

Esta opción permite habilitar el enriquecimiento de datos sólo para Dispositivos presentes en las bases de datos de activos y pendientes, excluyendo de la importación al resto de Dispositivos que no estén presentes en estas bases de datos. Por defecto la opción viene inhabilitada.

Resulta útil para poder mantener completa y actualizada la información con la que cuenta WOCU sobre los Dispositivos, puesto que permite que en cada nueva lectura de fichero CSV se recopilen datos actualizados de los mismos.

Overwrite simple macros

Esta opción permite habilitar o dejar inhabilitada la actualización de las macros simples de los Activos. Por defecto esta opción está habilitada.

Overwrite complex macros

Esta opción permite habilitar o dejar inhabilitada la actualización de las macros complejas de los Activos. Por defecto esta opción está inhabilitada.

Atención

Las macros son elementos que WOCU-Monitoring utiliza internamente para almacenar propiedades e información de los Activos monitorizados.

Una macro simple almacena un único valor. Un ejemplo de macro simple es “_DEVICEVENDOR”, macro que almacena como valor el nombre del fabricante del Dispositivo. Por ejemplo para un switch Cisco esta macro de ejemplo tendría el valor:

_DEVICEVENDOR:Cisco.

Una macro compleja, en cambio, puede almacenar multitud de valores dentro de una tabla. Un ejemplo de macro compleja es “_IFACES”, macro que almacena todos los datos de los puertos e interfaces de red de un Dispositivo. Por ejemplo para un switch Cisco esta macro de ejemplo tendría el valor:

_IFACES:Fa0/0$(1)$$(0)$$(0)$$(m)$,Fa1/1$(4)$$(0)$$(0)$$(m)$, WAN_CPD_01$(8)$$(0)$$(0)$$(m)$…

Dada la dificultad de configuración de algunas macros complejas, que pueden requerir una configuración complementamente manual, puede resultar preferible evitar sobreescribir las mismas al ejecutarse una Tarea de Importación. Es por ello que esta opción de sobreescribir macros complejas aparece deshabilitada por defecto. Se aconseja utilizar únicamente esta opción con precaución, cuando el usuario esté seguro de que la ejecución de la misma no vaya a causar desajustes importantes en la configuración de los Activos.

Register as active

Habilitando esta opción, los activos importados mediante ficheros CSV, serán enviados directamente al listado de Activos Operativos (Active Assets), es decir, se omitirá el alta en Activos Pendientes (Pending Assets) y pasarán directamente a monitorización.

Exclude fields

Las distintas tareas de importación en WOCU-Monitoring cuentan con un conjunto de atributos de Dispositivo ignorados por defecto, durante la importación o actualización del perfil de configuración de activos.

En este campo el usuario puede editar de forma manual los campos excluidos durante la comprobación de activos vía fichero CSV. Es posible modificar el listado añadiendo nuevos campos o eliminando algunos de los preestablecidos.

Nota

Haciendo clic en el botón identificado por el icono i (Información), aparecerá una nueva ventana con información de ayuda de los distintos campos. Esta acción no efectúa cambio alguno en la configuración.

../../_images/4_010_import-tool_tasks_info-button_0-36.png

Una vez introducidos los datos en los campos correspondientes habrá que pulsar el botón azul Add Tasks para guardar la nueva Tarea en el listado.

Tarea CSV_Inventory

A continuación se detallan cada uno de los distintos campos que el usuario debe rellenar para la configuración de la Tarea:

Importante

Esta tarea solo efectuará actividades de enriquecimiento de datos de inventario de Activos que ya están alojados en la BBDD de monitorización de WOCU-Monitoring. En ningún caso hará un descubrimiento de nuevos activos.

../../_images/4_011_import-tool_tasks_csv-inventory_0-36.png

Realm Name

Este campo no es editable e indica el nombre del Reino objeto de la Tarea de Importación.

Task Type

Este campo indica el Tipo de Tarea que va a generarse. Es el primer campo seleccionable en el desplegable y que condiciona el resto de los campos.

Si se selecciona otro tipo de Tarea distinta antes de guardar los cambios, los datos introducidos anteriormente se perderán.

Name

El campo recoge el nombre escogido por el usuario para identificar la nueva Tarea creada.

Enabled

Marcando esta casilla se habilita y activa esta nueva Tarea de Importación para su próxima ejecución.

Por defecto esta opción está habilitada.

Interval

Mediante este desplegable es posible escoger con qué frecuencia se ejecutará la Importación de Activos de esta Nueva Tarea. Las posibles opciones disponibles son:

  • Tarea ejecutada a diario (Every 1 days).

  • Tarea ejecutada cada segundo (Every 1 second).

Contrab

Opción alternativa para establecer la periodicidad en la que la Tarea será ejecutada. Su configuración se realiza empleando el Formato Crontab, ofreciendo mayor flexibilidad para casos de uso más específicos.

Amplie información sobre la definición de periodos de ejecución aquí.

Información de ayuda sobre el archivo CSV

A continuación, el formulario de creación ofrece instrucciones acerca del tipo de tarea de importación y del formato que tendrá que respetar el fichero CSV empleado como fuente de datos de los activos a importar.

Import hosts inventory via CSV file

Sample contents of CSV file:

 host_name;type;vendor
 dummy_csv;router;cisco

First column will always be host_name, and it is mandatory.

CSV File

En este campo el usuario deberá adjuntar el fichero en formato CSV con el inventario de Dispositivos o valores asociados a importar a través de la Tarea.

Section

Este campo agrupa los datos de inventario en la sección que el usuario especifique. Por defecto, viene preestablecida la sección CSV, pero esta puede ser modificada o eliminada libremente.

Una vez introducidos los datos en los campos correspondientes habrá que pulsar el botón azul Add Tasks para guardar la nueva Tarea en el listado.

Nota

Haciendo clic en el botón identificado por el icono i (Información), aparecerá una nueva ventana con información de ayuda de los distintos campos. Esta acción no efectúa cambio alguno en la configuración.

../../_images/4_010_import-tool_tasks_info-button_0-36.png

Tarea CSV_Delete

La Tarea CSV_Delete permite al operario el borrado masivo de Dispositivos, Proceso de Negocio (Host Business Processes) o datos atribuidos a los mismos, a través de la lectura de un fichero en formato CSV. A tal efecto, el sistema emplazará estos elementos importados a la sección Activos Basura o Desechados (Junk Assets) para efectuar su eliminación definitiva.

../../_images/4_116_import-tool_tasks_csv-delete_0-58.png

A continuación se detallan los campos de configuración propios de la tarea:

Realm Name

Este campo no es editable e indica el nombre del Reino objeto de la Tarea de Importación.

Task Type

Este campo indica el Tipo de Tarea que va a generarse. Es el primer campo seleccionable en el desplegable y que condiciona el resto de los campos.

Si se selecciona otro tipo de Tarea distinta antes de guardar los cambios, los datos introducidos anteriormente se perderán.

Name

El campo recoge el nombre escogido por el usuario para identificar la nueva Tarea creada.

Enabled

Marcando esta casilla se habilita y activa esta nueva Tarea de Importación para su próxima ejecución.

Por defecto esta opción está habilitada.

Interval

Mediante este desplegable es posible escoger con qué frecuencia se ejecutará la Importación de Activos de esta Nueva Tarea. Las posibles opciones disponibles son:

  • Tarea ejecutada a diario (Every 1 days).

  • Tarea ejecutada cada segundo (Every 1 second).

Contrab

Opción alternativa para establecer la periodicidad en la que la Tarea será ejecutada. Su configuración se realiza empleando el Formato Crontab, ofreciendo mayor flexibilidad para casos de uso más específicos.

Amplie información sobre la definición de periodos de ejecución aquí.

Información de ayuda sobre el archivo CSV

A continuación, el formulario de creación ofrece instrucciones acerca del tipo de tarea de importación y del formato que tendrá que respetar el fichero CSV empleado como fuente de datos de los activos a importar.

 Delete data via CSV file

 CSV_DELETE task allows users to delete several data
 assets into WOCU-monitoring system. Assets can be one of the
 following:

 - Hosts

     Each CSV data type has a minimum required fields and a list of allowed fields to be imported on it.

     Sample /tmp/csv_delete_import.txt:

     Required fields:
     host_name

     Allowed fields:
     host_name;information

     Example of csv:

             host_name;information
             dummy_host_name;random info
             dummy_host_name2;random info2

- Business Process Hosts

     Required fields:
     bphost_name

     Allowed fields:
     bphost_name;information

     Example of csv:

             bphost_name;information
             dummy_bphost_name;random info
             dummy_bphost_name2;random info2

Permanent delete:

Activando esta casilla se procede al borrado definitivo de los elementos importados y que ya estaban siendo monitorizados (eludiendo su paso por Activos Basura o Desechados (Junk Assets)), siempre y cuando no estén vinculados a ningún Host Business Process o Service Business Process.

Ante esta casuística, el elemento sí que pasará en una primera instancia al listado de Activos Basura o Desechados (Junk Assets) para su estudio y valoración.

Nota

Esta excepción no aplica para Host Groups, puesto que la tarea extraerá directamente el elemento sin alterar ninguna reunión lógica como sí ocurre en los Business Processes.

CSV File

En este campo el usuario deberá adjuntar el fichero en formato CSV con el inventario de Dispositivos o valores asociados a eliminar.

Una vez introducidos los datos en los campos correspondientes habrá que pulsar el botón azul Add Tasks para guardar la nueva Tarea en el listado.

Nota

Haciendo clic en el botón identificado por el icono i (Información), aparecerá una nueva ventana con información de ayuda de los distintos campos. Esta acción no efectúa cambio alguno en la configuración.

../../_images/4_010_import-tool_tasks_info-button_0-36.png