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), a través de la lectura de un fichero en formato CSV que contiene el listado de los Dispositivos (Hosts) junto con sus respectivos datos.

Note

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.

Existen dos posibles Tareas que aplican ficheros CSV para la incorporación de Activos: CSV Import y CSV Inventory.

../../_images/4_008_import-tool_tasks_csv-tasks-selector_0-36.jpg

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-431.jpg

Nombre del Reino (Realm Name)


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

Tipo de Tarea (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 en los otros campos se perderán.

Nombre (Name)


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

Habilitación (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.

Intervalo (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).

Instrucciones (Recuadro de fondo gris)


En este recuadro se ofrecen instrucciones acerca del tipo de Tarea de Importación y del formato que habrá de respetar el fichero CSV que se utilice 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

       Importación de Datos vía fichero CSV

       La tarea CSV_IMPORT permite a los usuarios importar varios tipos
       de datos en el sistema de WOCU. Los tipos de datos pueden ser:

       - Dispositivos
       - Contactos
       - Proceso de Negocio de Dispositivos
       - Proceso de Negocio de Servicios

       Cada tipo de dato en formato CSV tiene un mínimo de campos
       obligatorios y una lista de campos permitidos para su importación.

Sample /tmp/csv_import.txt:

       host_name;address;use

       dummy_csv;127.0.0.1;generic-host

       Ejemplo [ruta y nombre de fichero]

       A continuación, se añade un ejemplo con tres campos (primera línea) y
       los valores asignados para estos mismos separados por punto y coma
       (segunda línea). Es obligatorio respetar el orden preestablecido.

En el siguiente bloque se detallan los campos que admiten cada
uno de los distintos tipos de Activos que soporta la tarea. Se puede
escoger cualquiera de ellos e incluirlos en el fichero CSV para su
importación, aquellos no incluidos aparecerán vacíos en WOCU.

  Host CSV:

       Required fields:

          host_name;address

       Allowed fields:

          alias;check_interval;max_check_attempts;retry_interval
          contact;contact_groups;notifications_enabled;latitude
          longitude;check_period;notifications_period;check_command
          business_impact;parents; poller_tag;macros
          host_name;address;realm


  Contacts CSV:

       Required fields:

          contact_name

       Allowed fields:

          contact_name;alias;use;host_notifications_enabled
          service_notifications_enabled;email;pager;is_admin
          password;notificationsways;contact_groups


   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;use;business_impact

       Allowed fields:

          alias;check_interval;max_check_attempts;retry_interval
          hostgroups;contact;contact_groups;notifications_enabled
          latitude;longitude;check_period;notifications_period
          service_excludes;service_includes;service_override_ use
          host_name;check_command;business_impact


  ServicesBusinessProcess CSV:

       Required fields:

         host_name;check_command;use;business_impact
         service_description

       Allowed fields:

         service_description;normal_check_interval;hots_name;use
         check_command;business_impact

Archivo CSV (CSV File)


En este campo el usuario deberá seleccionar y adjuntar el fichero con el inventario de Dispositivos a importar a través de la Nueva Tarea.

Escanear sólo Activos operativos y pendientes (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.

Sobreescribir macros simples (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.

Sobreescribir macros complejas (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.

Attention

Las macros son elementos que WOCU 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.

Registrarse como activo (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.

Note

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-361.jpg

Una vez introducidos los datos en los campos correspondientes habrá que pulsar el botón azul “Añadir Tarea” (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:

Important

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. En ningún caso hará un descubrimiento de nuevos Activos.

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

Nombre del Reino (Realm Name)


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

Tipo de Tarea (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 en los otros campos se perderán.

Nombre (Name)


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

Habilitación (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.

Intervalo (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).

Instrucciones (Recuadro de fondo gris)


En este recuadro se ofrecen instrucciones acerca del tipo de Tarea de Importación y del formato que habrá de respetar el fichero CSV que se utilice como fuente de los datos de los Dispositivos a importar.

Import hosts inventory via CSV file

Importación del Inventario de Dispositivos vía fichero CSV

Sample contents of CSV file:

Ejemplo [ruta y nombre de fichero]

`` host_name;type;vendor``

dummy_csv;router;cisco

Ejemplo de tres campos (primera línea) y los valores para esos tres campos separados por punto y coma. Como muestra este ejemplo, una vez definido un orden de campos (columnas), los valores correspondiente por cada Dispositivo (columna) deberán respetar dicho orden preestablecido.

La primera columna siempre será host_name, y es obligatorio.

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

Aquí se detallan los distintos campos que admite este tipo de Tarea de importación de inventario. Se pueden escoger cuáles de ellos incluir en el fichero CSV y cuáles no (aquellos no incluidos aparecerá vacíos en WOCU).

Archivo CSV (CSV File)


En este campo el usuario deberá seleccionar y adjuntar el fichero con el inventario de Dispositivos a importar a través de la Nueva Tarea.

Sección (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 “Añadir Tarea” (Add Tasks) para guardar la nueva Tarea en el listado.

Note

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-361.jpg