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 | 認証タイプを示します。以下の認証タイプを使用できます。
| 文字列 | 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 | 認証タイプを示します。以下の認証タイプを使用できます。
| 文字列 | なし |
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 でのデータの表示
詳細については、「 」を参照してください。