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-50.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_templates

       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:

          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

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.

Excluir campos (Exclude fields)


Las distintas tareas de importación en WOCU 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.

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

Tarea CSV_Delete

La Tarea CSV_Delete permite al operario el borrado masivo de Dispositivos 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-50.jpg

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

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 y confirmar los cambios, los datos introducidos se perderán.

Nombre (Name)

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

Habilitación (Enabled)

Marcando esta casilla se habilita la nueva Tarea de Importación para su próxima ejecución. Por defecto esta opción está habilitada (marcada).

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

Información de ayuda

En este bloque se ofrecen instrucciones acerca del tipo de Tarea de y del formato que habrá de respetar el fichero CSV que se utilice como fuente de los datos de los Dispositivos a eliminar.

Delete data via CSV file

CVS_delete task allow users to delete several data assets into
  WOCU-Monitoring system. Assets can be one of the following:

       Hosts

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_delete permite a los usuarios eliminar varios tipos de datos en
el sistema de WOCU-Monitoring. Los activos pueden ser:

       - Dispositivos

 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_hosts_import.txt:

       Required fields:

          host_name

       Allowed fields:

          host_name, information

Ejemplo [ruta y nombre de fichero]

       Campos requeridos:

               host_name

       Campos permitidos:

               host_name, information

Example of csv:

   host_name;information

   dummy_host_name;random info

   dummy_host_name2;random info2

Se añade un ejemplo final del formato que debe respetar el fichero CSV.
La primera línea alude al tipo de campo o atributo, seguido de una fila por
cada valor a eliminar. Es obligatorio respetar el orden preestablecido.

Borrado permanente (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.

Note

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.

Archivo CSV (CSV File)

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