Tivoli Netcool/OMNIbus

このセクションでは、Tivoli Netcool/OMNIbus と DX Operational Intelligence の統合について説明します。
dxisaas
dxp10
Tivoli Netcool/OMNIbus スキーマを使用すると、Tivoli Netcool/OMNIbus アラートをアラームとして DX Operational Intelligence に取り込めます。
以下のいずれかのメソッドを使用して、この統合を実行できます。
  • ポーリング:
    このメソッドにより、RESTMon は Tivoli Netcool/OMNIbus スキーマ
    (netcoolomnibus_schema.json
    )およびプロファイル(
    netcoolomnibus_profile.json
    )を使用して、Tivoli Netcool/OMNIbus からアラート データを取得できます。
  • Webhook (RESTMon ストリーミング):
    このメソッドにより、Tivoli Netcool/OMNibus は、Webhook スキーマ(
    netcoolomnibuswebhook_schema.json
    )およびプロファイル(
    netcoolomnibuswebhook_profile.json
    )を使用して、アラート データを JSON として RESTMon にポストできます。
このセクションでは、以下の情報について説明します。
サポートされているバージョン
Tivoli Netxu/OMNIbus - DX Operational Intelligence 統合は、以下のバージョンでサポートされています。
製品
サポートされているバージョン
Tivoli Netcool/OMNIbus
8.1.0
統合の設定
Tivoli Netxu/OMNIbus - DX Operational Intelligence 統合には、以下の手順が含まれます。
  • Tivoli Netcool/OMNIbus 環境の設定
  • RESTMon の設定
Tivoli Netcool/OMNIbus 環境の設定
等号を設定するには、以下の要件を満たしていることを確認してください。
  • ポーリング メソッドの場合は、ObjectServer HTTP インターフェースがインストールされていることを確認します。
  • Webhook メソッドの場合は、Message Bus Gateway がインストールされていることを確認します。Basic 認証(ユーザ名とパスワード)を使用して、Webhook URL にアラーム ペイロードを送信するようにメッセージ バス ゲートウェイを設定します。URL の例:
    https://fqdn:8443/restmon/api/v1/logs?profileName=netcoolomnibus_webhook&schemaName=netcoolomnibus_webhook
    ペイロードに含まれるデータのマッピングを変更できます。ペイロードの形式を変更する場合は、スキーマの変更が必要な場合があります。
  • Webhook スキーマを使用する場合、Tivoli Netcool/OMNIbus がデータを送信する Webhook URL を定義する必要があります。URL の例:
    https://fqdn:8443/restmon/api/v1/logs?profileName=netcoolomnibus_webhook&schemaName=netcoolomnibus_webhook
  • RESTMon への Basic 認証接続用のユーザ名とパスワードが必要です。
Tivoli Netcool/OMNIbus の詳細については、「
Tivoli Netcool/OMNIbus のドキュメント
」を参照してください。
RESTMon の設定
RESTMon を設定するには、OI 接続の詳細を更新し(以前に行っていない場合)、プロファイル情報を
restmon.json
ファイルに追加します。RESTMon を設定する前に、以下の要件が満たされていることを確認してください。
  • DX Operational Intelligence へのアクセスがあること。
  • RESTMon が正常にインストールおよび展開されていること。詳細については、「」を参照してください。
  • RESTMon が正常にインストールおよび展開されていること。
プロファイルの追加
プロファイルを追加するには、Tivoli Netcool/OMNIbus 環境に接続するようにプロファイルを構成し、Swagger の を使って
restmon.json
ファイルにプロファイルを追加します。
netcoolomnibus_profile.json
ファイルは
<restmon\profile>
フォルダにあります。プロファイルを追加すると、Tivoli Netcool/OMNIbus 用のスキーマが自動的にアップロードされ、データ取り込みが開始されます。
この情報は、
restmon.json
ファイルに直接追加することもできます。
Tivoli Netcool/OMNIbus プロファイルには、以下のセクションが含まれています。
Profile
profile
セクションでは、プロファイル関連の情報を定義します。
プロファイル - ポーリング メソッド
以下のスニペットは、profile セクションのサンプルです。
{ "name":"netcoolomnibus", "schema":"netcoolomnibus", "streaming":"no", "polling_interval_secs":"300", "inventory_topology_fullsync_interval_mins":"1440", "topology_ttl_mins":"2880", "active":"yes" }
名前
説明
タイプ
name
プロファイルの名前を示します。
文字列
netcoolomnibus
schema
スキーマの名前を示します。スキーマに指定する名前は、restmon.json ファイルで指定されたスキーマ属性と同じである必要があります。
文字列
netcoolomnibus
streaming
ストリーミングが有効かどうかを示します。有効な場合、統合製品はデータを JSON (Webhook)として RESTMon にポストします。それ以外の場合、RESTMon は統合製品からデータを取得(ポーリング)します。
ブール
いいえ
polling_interval_secs
ポーリング間隔を秒単位で示します。
サポートされる値:
15、30、60、300、900、1800、3600、7200
その他の値は、最も近い間隔に丸められます。
整数
300
inventory_topology_fullsync_interval_mins
完全同期の間隔を分単位で示します。
整数
1440
topology_ttl_mins
レコードがキャッシュされる TTL (Time-to-Live)を分単位で示します。
整数
2880
tenantname
DX Operational Intelligence テナント名を示します。
文字列
sampleTenantName
active
データ処理が有効かどうかを示します。プロファイルを有効にするには「
yes
」を入力します。
ブール
はい
プロファイル - Webhook メソッド
以下のスニペットは、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 }
名前
説明
タイプ
name
プロファイルの名前を示します。
文字列
netcoolomnibuswebhook
schema
スキーマ名を示します。スキーマに指定する名前は、restmon.json ファイルで指定されたスキーマ属性と同じである必要があります。
文字列
netcoolomnibuswebhook
streaming
ストリーミングが有効かどうかを示します。有効な場合、統合製品はデータを JSON (Webhook)として RESTMon にポストします。それ以外の場合、RESTMon は統合製品からデータを取得(ポーリング)します。
ブール
はい
polling_interval_secs
ポーリング間隔を秒単位で示します。
サポートされる値:
15、30、60、300、900、1800、3600、7200
その他の値は、最も近い間隔に丸められます。
整数
1
inventory_topology_fullsync_interval_mins
完全同期の間隔を分単位で示します。
整数
1440
topology_ttl_mins
レコードがキャッシュされる TTL (Time-to-Live)を分単位で示します。
整数
2880
tenantname
DX Operational Intelligence テナント名を示します。
文字列
sampleTenantName
active
データ処理が有効かどうかを示します。プロファイルを有効にするには「
yes
」を入力します。
ブール
はい
batch_size
受信データのバッチのサイズを示します。
整数
1000
batch_wait_time_milli
バッチの待機時間を示します。
整数
2000
restapiconnectdetails
restapiconnectdetails
セクションに、お使いの環境の REST エンドポイントの詳細を入力します。
restapiconnectdetails - ポーリング メソッド
以下のスニペットは、
restapiconnectdetails
セクションのサンプルです。
{ "type":"https", "hostname":"sampleHostName", "port":"", "authentication":"basic", "username":"sampleUser", "password":"samplePassword", "realmdomain":"", "token":"", "httptimeout":"30000", "checkcert":"no" }
名前
説明
タイプ
type
DX Operational Intelligence によるデータ転送タイプを示します。値: HTTP または HTTPS。
文字列
https
hostname
REST エンドポイントのホスト名または IP アドレスを示します。
文字列
sampleHostName
port
REST エンドポイントのポート番号を示します。
整数
authentication
認証タイプを示します。以下の認証タイプを使用できます。
  • none:
    許可は必要ありません。
  • basic:
    ユーザ名とパスワードを入力します。
  • NTLM:
    ユーザ名とパスワードを入力します。
  • digest:
    ユーザ名、パスワード、レルムドメインを入力します。
  • OAuth2:
    token パラメータにアクセス トークンを入力します。
  • bearer:
    token パラメータにベアラ トークンを入力します。
  • urltoken:
    token パラメータにトークンを入力します。
文字列
basic
username
ユーザ名を示します。認証タイプが basic または NTLM の場合にのみ適用されます。
文字列
sampleUserName
password
パスワードを示します。認証タイプが basic または NTLM の場合にのみ適用されます。
文字列
samplePassword
realmdomain
トークンでエンコードする DNS レルムまたはドメインを示します。認証タイプが digest の場合にのみ適用されます。
文字列
token
認証タイプが OAuth2 の場合はアクセス トークン、bearer の場合はベアラ トークンを示します。
文字列
httptimeout
タイムアウトの値をミリ秒単位で示します。
整数
30000
checkcert
証明書が有効であり、信頼できることを確認するために、証明書を検証することを示します。
ブール
いいえ
restapiconnectdetails - Webhook メソッド
以下のスニペットは、
restapiconnectdetails
セクションのサンプルです。
{ "type":"https", "hostname":"dummy.value.com", "port":"7083", "authentication":"none", "username":"", "password":"", "realmdomain":"", "token":"", "httptimeout":"60000", "checkcert":"no" }
名前
説明
タイプ
type
DX Operational Intelligence によるデータ転送タイプを示します。値: HTTP または HTTPS。
文字列
https
hostname
REST エンドポイントのホスト名または IP アドレスを示します。
文字列
sampleHostName
port
REST エンドポイントのポート番号を示します。
整数
7083
authentication
認証タイプを示します。以下の認証タイプを使用できます。
  • none:
    許可は必要ありません。
  • basic:
    ユーザ名とパスワードを入力します。
  • NTLM:
    ユーザ名とパスワードを入力します。
  • digest:
    ユーザ名、パスワード、レルムドメインを入力します。
  • OAuth2:
    token パラメータにアクセス トークンを入力します。
  • bearer:
    token パラメータにベアラ トークンを入力します。
  • urltoken:
    token パラメータにトークンを入力します。
文字列
なし
username
ユーザ名を示します。認証タイプが basic または NTLM の場合にのみ適用されます。
文字列
password
パスワードを示します。認証タイプが basic または NTLM の場合にのみ適用されます。
文字列
realmdomain
トークンでエンコードする DNS レルムまたはドメインを示します。認証タイプが digest の場合にのみ適用されます。
文字列
token
認証タイプが OAuth2 の場合はアクセス トークン、bearer の場合はベアラ トークンを示します。
文字列
httptimeout
タイムアウトの値をミリ秒単位で示します。
整数
60000
checkcert
証明書が有効であり、信頼できることを確認するために、証明書を検証することを示します。
ブール
いいえ
monitored_groups
monitored_groups
セクションでは、モニタするグループを入力します。以下のスニペットは、
monitored_groups
セクションのサンプルです。
{ "Alarms":"yes" }
詳細な手順については、「」を参照してください。
Tivoli Netcool/OMNIbus スキーマのアップロード
プロファイルを追加すると、スキーマが自動的にアップロードされます。更新または編集したスキーマをアップロードする場合のみ、この手順を実行します。
詳細な手順については、「」を参照してください。
DX Operational Intelligence でのデータの表示
取り込んだデータは、DX Operational Intelligence の のページで閲覧し、サービス、Raw、異常のアラームに関するインサイトを得ることができます。
詳細については、「 」を参照してください。