Importación por Base de Datos MySQL (MySQL_Import)

La Importación por Base de Datos MySQL (MySQLImport) permite la Importación de Activos a través de la consulta de una tabla en una BBDD MySQL.

Note

MySQL es una tecnología de Base de Datos Relacional muy popular y de uso muy extendido. Este sistema de Importación es ideal para Importar la información de Activos de una CMDB (Base de Datos de Gestión de configuración) que utilice esta tecnología de Bases de Datos.

A continuación se detallan uno por uno los distintos campos que el usuario debe rellenar así como las instrucciones de consulta de la tabla MySQL.

../../_images/4_019_import-tool_tasks_msql-import_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.

Import hosts from a MySQL table.

Importación de Dispositivos de una tabla MySQL.

Nombre de Dispositivo (Host name)


En este campo el usuario deberá introducir el nombre del Dispositivo o la dirección IP del Dispositivos donde reside la BBDD.

Nombre de usuario de la BBDD (Database user)


En este campo hay que introducir un nombre de usuario válido dentro de la BBDD de la que se quieren extraer los datos de la Importación.

Contraseña de usuario de la BBDD (Database password)


En este campo hay que introducir la contraseña asociada a la cuenta de usuario antes introducida.

Nombre de la BBDD (Database name)


En este campo hay que indicar el nombre de la Base de Datos que contiene la información a importar.

Tabla de la BBDD (Database table)


En este campo hay que registrar el nombre de la tabla de la Base de Datos antes indicada, que contiene la información de los Dispositivos a importar a WOCU.

Condiciones (Conditions)


En este nuevo campo se pueden especificar condiciones para la importación de Activos y sus correspondientes datos. Es posible definir como condiciones WHERE ... AND ..., permitiendo de este modo filtrar y devolver solo ciertos datos que se quieran importar y que WOCU necesite para la monitorización.

La condición debe seguir la siguiente sintaxis:

    {
"address": "127.0.0.1",
"cif": "B0000000"
    }

Mapeado (Mapping)


En este campo se establece una relación y correspondencia entre los campos de la tabla a importar y las variables que utiliza internamente WOCU para almacenar los datos sobre los Dispositivos monitorizados.

El mapeo se realiza introduciendo en el campo Mapeado (Mapping) qué variable o campo interno de WOCU alojará los valores de un cierto campo de la tabla de la BBDD que se usa para realizar la Importación. El mapeo sigue esta sintaxis:

{
"host_name" : "$mnemonico",
"address": "$ipgest",
"_IFACES_BYNAME" : "$interfaces_macro",
"_IFACES" : "$interfaces_macro_byid",
"_DEVICEVENDOR" : "$vendor",
"_SNMPVERSION" : "$snmpversion",
"use" : "$use",
"hostgroups" : "$hostgroups",
"contacts": "$contacts",
"check_period": "$checkperiod",
"notification_period" : "$notificationperiod",
"_SNMPCOMMUNITY" : "$community"
}

Por ejemplo, el campo host_name de la BBDD MySQL utilizada para la importación se corresponde con el campo interno de WOCU $mnemonico donde se guarda el nombre de los Dispositivos.

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 bases de datos MySQL, 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.

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