Importación por fichero CSV

La importación por fichero CSV permite la incorporación de Activos en WOCU a través de la lectura de un fichero en formato CSV que contenga el listado de los Dispositivos (Hosts) junto con sus respectivos datos a importar.

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-361.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 via CSV file

Importación de Dispositivos vía fichero CSV

Sample /tmp/csv_import.txt:

Ejemplo [ruta y nombre de fichero]

host_name;address;use

dummy_csv;127.0.0.1;generic-host

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.

Column choices are:

address, alias, business_impact, check_command, check_interval,

contact_groups, contacts, display_name, host_name, hostgroups,

latitude, longitude, macros, max_check_attempts,

notifications_enabled, parents, realm, retry_interval, use

Aquí se detallan los distintos campos que admite este tipo de Tarea de Importación. Es decir, 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.

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:

../../_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