Tivoli Netcool/OMNIbus

En esta sección, se describe la integración de Tivoli Netcool/OMNIbus con DX Operational Intelligence.
dxisaas
dxp10
El esquema de Tivoli Netcool/OMNIbus permite ingerir las alertas de Tivoli Netcool/OMNIbus como alarmas en DX Operational Intelligence.
Siga una de los siguiente métodos para realizar esta integración:
  • Sondeo
    : Este método permite a RESTMon obtener los datos de alerta de Tivoli Netcool/OMNIbus mediante el esquema de Tivoli Netcool/OMNIbus (
    netcoolomnibus_schema.json
    ) y el perfil (
    netcoolomnibus_profile.json
    ).
  • Webhook (transmisión por secuencias de RESTMon)
    : Este método permite a Tivoli Netcool/OMNIbus publicar los datos de alerta en RESTMon como JSON mediante el esquema de Webhook (
    netcoolomnibuswebhook_schema.json
    ) y el perfil (
    netcoolomnibuswebhook_profile.json
    ).
Esta sección proporciona la siguiente información:
Versiones compatibles
Se admite la integración de Tivoli Netcool/OMNIbus con DX Operational Intelligence con la versión siguiente:
Producto
Versión compatible
Tivoli Netcool/OMNIbus
8.1.0
Configuración de la integración
La integración de Tivoli Netcool/OMNIbus con DX Operational Intelligence implica los pasos siguientes:
  • Configuración del entorno de Tivoli Netcool/OMNIbus
  • Configuración de RESTMon
Configuración del entorno de Tivoli Netcool/OMNIbus
Para configurar la integración, asegúrese de que se cumplen los siguientes requisitos:
  • Para el método de sondeo, asegúrese de que se ha instalado la interfaz HTTP de ObjectServer.
  • Para el método Webhook, asegúrese de que se ha instalado la puerta de enlace del bus de mensajes. Configure la puerta de enlace del bus de mensajes para enviar la carga útil de alarmas a la dirección URL de Webhook mediante la autenticación básica (nombre de usuario y contraseña). URL de ejemplo:
    https://fqdn:8443/restmon/api/v1/logs?profileName=netcoolomnibus_webhook&schemaName=netcoolomnibus_webhook
    .
    Se puede cambiar la asignación de los datos que se incluyen en la carga útil. Si se modifica el formato de la carga útil, es posible que deba cambiarse el esquema.
  • Cuando se utiliza el esquema de Webhook, se debe definir la dirección URL de Webhook a la que Tivoli Netcool/OMNIbus envía los datos. URL de ejemplo:
    https://fqdn:8443/restmon/api/v1/logs?profileName=netcoolomnibus_webhook&schemaName=netcoolomnibus_webhook
    .
  • Tiene el nombre de usuario y la contraseña para la conexión de autenticación básica a RESTMon.
Para obtener más información sobre Tivoli Netcool/OMNIbus, consulte la
documentación de Tivoli Netcool/OMNIbus
.
Configuración de RESTMon
Para configurar RESTMon, actualice los detalles de la conexión de OI si no se ha realizado antes y agregue la información del perfil al archivo
restmon.json
. Antes de configurar RESTMon, asegúrese de que se cumplen los siguientes requisitos:
  • Se tiene acceso a DX Operational Intelligence.
  • RESTMon se ha instalado e implementado correctamente.Para obtener más información, consulte la sección .
  • RESTMon se ha instalado e implementado correctamente.
Adición del perfil
Para agregar el perfil, configure el perfil que se debe conectar al entorno de Tivoli Netcool/OMNIbus y agréguelo al archivo
restmon.json
mediante la llamada en Swagger.El archivo
netcoolomnibus_profile.json
está disponible en la carpeta
<restmon\profile>
. Cuando se agrega el perfil, el esquema para Tivoli Netcool/OMNIbus se carga automáticamente y se inicia la ingesta de datos.
También se puede agregar esta información directamente al archivo
restmon.json
.
El perfil de Tivoli Netcool/OMNIbus incluye las secciones siguientes:
Profile
La sección
profile
define la información relacionada con el perfil.
Perfil: Método de sondeo
El siguiente fragmento de código es una muestra de la sección profile.
{ "name":"netcoolomnibus", "schema":"netcoolomnibus", "streaming":"no", "polling_interval_secs":"300", "inventory_topology_fullsync_interval_mins":"1440", "topology_ttl_mins":"2880", "active":"yes" }
Nombre
Descripción
Tipo
Ejemplo
name
Indica el nombre del perfil.
Cadena
netcoolomnibus
schema
Indica el nombre del esquema. El nombre que se proporciona para el esquema debe ser el mismo que el atributo schema especificado en el archivo restmon.json.
Cadena
netcoolomnibus
streaming
Indica si la transmisión por secuencias está activada. Cuando está activada, la integración del producto publica datos en RESTMon como JSON (Webhook). Cuando está desactivada, RESTMon obtiene los datos (sondeo) del producto de la integración.
Booleano
no
polling_interval_secs
Indica el intervalo de sondeo en segundos.
Valores admitidos
: 15, 30, 60, 300, 900, 1800, 3600 y 7200
Cualquier otro valor se redondea a los intervalos más cercanos.
Entero
300
inventory_topology_fullsync_interval_mins
Indica el intervalo de sincronización completa en minutos.
Entero
1440
topology_ttl_mins
Indica que el registro del tiempo de vida (TTL) se almacena en la memoria caché, en minutos.
Entero
2880
tenantname
Indica el nombre del cliente de DX Operational Intelligence.
Cadena
sampleTenantName
active
Indica si el procesamiento de datos está activado. Introduzca
yes
para activar el perfil.
Booleano
Perfil: Método de Webhook
El siguiente fragmento de código es una muestra de la sección profile.
{ "name":"netcoolomnibuswebhook", "active":"yes", "schema":"netcoolomnibuswebhook", "streaming":"yes", "polling_interval_secs":"1", "inventory_topology_fullsync_interval_mins":"1440", "topology_ttl_mins":"2880", "tenantname":"sampleTenantName", "batch_size":1000, "batch_wait_time_milli":2000 }
Nombre
Descripción
Tipo
Ejemplo
name
Indica el nombre del perfil.
Cadena
netcoolomnibuswebhook
schema
Indica el nombre del esquema. El nombre que se proporciona para el esquema debe ser el mismo que el atributo schema especificado en el archivo restmon.json.
Cadena
netcoolomnibuswebhook
streaming
Indica si la transmisión por secuencias está activada. Cuando está activada, la integración del producto publica datos en RESTMon como JSON (Webhook). Cuando está desactivada, RESTMon obtiene los datos (sondeo) del producto de la integración.
Booleano
polling_interval_secs
Indica el intervalo de sondeo en segundos.
Valores admitidos
: 15, 30, 60, 300, 900, 1800, 3600 y 7200
Cualquier otro valor se redondea a los intervalos más cercanos.
Entero
1
inventory_topology_fullsync_interval_mins
Indica el intervalo de sincronización completa en minutos.
Entero
1440
topology_ttl_mins
Indica que el registro del tiempo de vida (TTL) se almacena en la memoria caché, en minutos.
Entero
2880
tenantname
Indica el nombre del cliente de DX Operational Intelligence.
Cadena
sampleTenantName
active
Indica si el procesamiento de datos está activado. Introduzca
yes
para activar el perfil.
Booleano
batch_size
Indica el tamaño del lote para los datos entrantes.
Entero
1000
batch_wait_time_milli
Indica el tiempo de espera para el lote.
Entero
2000
restapiconnectdetails
En la sección
restapiconnectdetails
, especifique los detalles del punto final de REST del entorno.
restapiconnectdetails: Método de sondeo
El siguiente fragmento de código es una muestra de la sección
restapiconnectdetails
:
{ "type":"https", "hostname":"sampleHostName", "port":"", "authentication":"basic", "username":"sampleUser", "password":"samplePassword", "realmdomain":"", "token":"", "httptimeout":"30000", "checkcert":"no" }
Nombre
Descripción
Tipo
Ejemplo
type
Indica el tipo de transferencia de datos con DX Operational Intelligence. Valores: HTTP o HTTPS.
Cadena
https
hostname
Indica el nombre de host o la dirección IP del punto final de REST.
Cadena
sampleHostName
port
Indica el número de puerto del punto final de REST.
Entero
authentication
Indica el tipo de autenticación. Los siguientes tipos de autenticación están disponibles:
  • none:
    No se requiere ninguna autorización.
  • basic
    : Especifique el nombre de usuario y la contraseña.
  • NTLM
    : Especifique el nombre de usuario y la contraseña.
  • digest
    : Introduzca el nombre de usuario, la contraseña y el dominio del territorio.
  • OAuth2
    : Introduzca el token de acceso en el parámetro token.
  • bearer
    : Introduzca el token de portador en el parámetro token.
  • urltoken
    : Introduzca el token en el parámetro token.
Cadena
basic
username
Indica el nombre de usuario. Se aplica solamente cuando el tipo de autenticación es basic o NTLM.
Cadena
sampleUserName
password
Indica la contraseña. Se aplica solamente cuando el tipo de autenticación es basic o NTLM.
Cadena
samplePassword
realmdomain
Indica el dominio o el territorio de DNS que se codifica en el token. Se aplica solamente cuando el tipo de autenticación es digest.
Cadena
token
Indica el token de acceso o el token de portador cuando el tipo de autenticación es OAuth2 o bearer, respectivamente.
Cadena
httptimeout
Indica el valor del tiempo de espera expresado en milisegundos.
Entero
30000
checkcert
Indica que se debe verificar el certificado para garantizar que es válido y de confianza.
Booleano
no
restapiconnectdetails: Método de Webhook
El siguiente fragmento de código es una muestra de la sección
restapiconnectdetails
:
{ "type":"https", "hostname":"dummy.value.com", "port":"7083", "authentication":"none", "username":"", "password":"", "realmdomain":"", "token":"", "httptimeout":"60000", "checkcert":"no" }
Nombre
Descripción
Tipo
Ejemplo
type
Indica el tipo de transferencia de datos con DX Operational Intelligence. Valores: HTTP o HTTPS.
Cadena
https
hostname
Indica el nombre de host o la dirección IP del punto final de REST.
Cadena
sampleHostName
port
Indica el número de puerto del punto final de REST.
Entero
7083
authentication
Indica el tipo de autenticación. Los siguientes tipos de autenticación están disponibles:
  • none:
    No se requiere ninguna autorización.
  • basic
    : Especifique el nombre de usuario y la contraseña.
  • NTLM
    : Especifique el nombre de usuario y la contraseña.
  • digest
    : Introduzca el nombre de usuario, la contraseña y el dominio del territorio.
  • OAuth2
    : Introduzca el token de acceso en el parámetro token.
  • bearer
    : Introduzca el token de portador en el parámetro token.
  • urltoken
    : Introduzca el token en el parámetro token.
Cadena
Ninguno
username
Indica el nombre de usuario. Se aplica solamente cuando el tipo de autenticación es basic o NTLM.
Cadena
password
Indica la contraseña. Se aplica solamente cuando el tipo de autenticación es basic o NTLM.
Cadena
realmdomain
Indica el dominio o el territorio de DNS que se codifica en el token. Se aplica solamente cuando el tipo de autenticación es digest.
Cadena
token
Indica el token de acceso o el token de portador cuando el tipo de autenticación es OAuth2 o bearer, respectivamente.
Cadena
httptimeout
Indica el valor del tiempo de espera expresado en milisegundos.
Entero
60000
checkcert
Indica que se debe verificar el certificado para garantizar que es válido y de confianza.
Booleano
no
monitored_groups
En la sección
monitored_groups
, especifique los grupos que desea monitorizar. El siguiente fragmento de código es una muestra de la sección
monitored_groups
:
{ "Alarms":"yes" }
Para obtener los pasos detallados, consulte la sección .
Carga del esquema de Tivoli Netcool/OMNIbus
El esquema se carga automáticamente cuando se agrega el perfil. Realice los pasos solamente si desea cargar el esquema actualizado o editado.
Para obtener los pasos detallados, consulte la sección .
Visualización de datos en DX Operational Intelligence
Se pueden ver los datos ingeridos en las páginas , y de DX Operational Intelligence para obtener información acerca de las alarmas del servicio, las alarmas sin formato y las alarmas de anomalías.
Para obtener más información, consulte la sección .