Opsgenie を IBM Tivoli Netcool と統合する

Tivoli Netcool/OMNIbus はキャリアクラスのサービスおよびビジネス保証システムです。これによって、さまざまな種類のネットワークデータソースから企業全体のイベントとアラームの情報をリアルタイムで収集して統合し、この情報の簡略化されたビューをオペレーターと管理者に表示します。

Tivoli Netcool / OMNIbus には、管理されたアラートに対してインテリジェントな処理を実行できる自動化機能があります。Netcool トリガーは、ObjectServer 自動化サブシステムの基礎を形成します。ObjectServer がトリガーに関連付けられたインシデントを検出すると、トリガーが自動的に起動します (トリガーアクションを実行します)。トリガーでは、SQL コマンドを実行し、変更に応じてプロシージャを呼び出すことができます。Netcool トリガーには、外部プロシージャを呼び出す機能もあります。これにより、トリガーを通知システムとして使用する道が開かれます。

Opsgenie が IBM Tivoli Netcool ユーザーに提供するもの

Opsgenie の Netcool プラグインは Netcool との双方向の統合を提供して、メール、SMS、電話、iPhone/Android のプッシュ通知を介して Netcool イベントの通知を受信、または Opsgenie アプリによってモバイルデバイスからイベント (承認、ジャーナルへの書き込みなど) と直接やり取りできます。

シナリオ 1: メール統合

Netcool イベントをメール経由で Opsgenie に転送するだけで、Opsgenie でアラートを作成できます。このインテグレーションは、クライアントコンポーネントを必要とせず、Netcool のメール機能に依存します。Netcool のデフォルトインストールには、「mail_on_critical」という一時的なトリガーが付属しています。このトリガーは、30 分後に承認解除されずに送信し、「send_mail」プロシージャ経由でメールを送信します。このトリガーは、電子メールを送信して Opsgenie アラートを作成する方法の例です。Netcool インシデントをメールで Opsgenie に送信するには、メール送信ツール (mailx、sendmail など) とプロセスエージェントを正しく設定します。プロセスエージェント、SMTP サーバーなどの設定は、このドキュメントでは範囲外です。

以下のステップは、30 分間承認されない重要なイベントに対して Opsgenie アラートを作成する方法を示しています。

[設定] > [統合] の順に移動します。メールを検索して [追加] を選択します。Opsgenie とメールの統合に関する詳細についてご確認ください。

この統合はチームダッシュボードから追加可能

Opsgenie の Free または Essentials の各プランを使用している、または Jira Service Management の Standard プランで Opsgenie を使用している場合、このプランでは [設定] の [統合] ページが利用できないため、この統合はチームダッシュボードからのみ追加できます。

統合をチームダッシュボードから追加すると、そのチーム統合の所有者になります。Opsgenie では、この統合を通じて受信したアラートはそのチームのみに割り当てられます。

そのためには、次の手順に従います。

Teams からチームダッシュボードに移動します。
[統合] > [統合を追加] の順に選択します。

残りの手順に従って統合を完了します。

Opsgenie メールインテグレーション (下図) のメールアドレスを使用して、「mail_on_critical」トリガーのアクションセクションを変更し、有効にします。電子メールの件名には「Netcool メール」テキストではなく [概要] フィールドを使用していることに注意してください。これは、Opsgenie アラートメッセージに変換されます。

完了です! 正しく設定されていれば、Opsgenie は重要な Netcool イベントごとにアラートを作成します。このアラートは 30 分間受信されません。

問題が発生した場合は、メールユーティリティが正しく動作していることを確認します。Netcool 手順が正常に動作しているかどうかをテストするには、連絡先のメールをメールボックスに変更します。

シナリオ 2: Lamp & Marid を介したインテグレーション

Opsgenie は Netcool インテグレーションプラグインも提供しており、Opsgenie が提供するツール (Lamp と Marid) を使用して Web API (HTTPS) を介して統合を提供します。プラグインがインストールされて適切に設定されると、Lamp コマンドラインユーティリティを使用して Opsgenie アラートが作成され、受信者はモバイルデバイスや Opsgenie Web コンソールから Netcool イベントに対して、承認やジャーナルへの書き込みなどのアクションを直接実行できます。

インストール

以下の手順では、Opsgenie Netcool インテグレーションパッケージを使用してアラートを作成し、アラートに対してアクションを実行する方法について説明します。

Opsgenie Netcool インテグレーションファイルをダウンロードします。これには以下が含まれます。
Lamp - Opsgenie コマンドラインユーティリティでアラートを作成します
Marid - Opsgenie インテグレーションサーバー
Netcool インテグレーションシェルスクリプト
Netcool インテグレーションパッケージを Netcool サーバー上のディレクトリに解凍します。
Lamp のインストール:
Netcool インテグレーションファイルには、カスタマイズされたバージョンの lamp が含まれています。このバージョンをインストールする必要があります。
Lamp ドキュメント - インストール手順を参照して lamp をインストールします。また lamp をダウンロードしないでください。
Netcool シェルスクリプトに正しい LAMP_HOME (lamp のインストールディレクトリ) があることを確認してください
API インテグレーションを作成して apiKey を入手し、次に opsgenie-integration/conf/opsgenie-integration.conf ファイルに入れます。
Lamp が動作していることを確認する: コマンドラインからランプユーティリティを使用してテストアラートを作成し、Opsgenie Alert ダッシュボードにアラートが表示されていることを確認します。詳細についてはLamp ドキュメントをご参照ください
インテグレーションパッケージは、ObjectServer プロシージャによって実行される UNIX ベースのシェルスクリプトを提供します。これは、コマンドライン引数にほとんど変更を加えない、非常に単純なスクリプトで、それらを Lamp に渡します。他のオペレーティングシステムユーザーは、好みのスクリプト言語で非常によく似たバージョンのスクリプトを準備できます。NetCoolShellScripts/OpsGenie シェルスクリプトを次のように準備します。
シェルスクリプトを、プロセスエージェントをインストールしたシステム内のディレクトリにコピーします。このパスは、 Netcool 手順が設定されている際に指定されます
ランプのインストールディレクトリを指すように LAMP_HOME を設定します
ファイルが Process Agent によって実行可能であることを確認します。
「create_opsgenie_alert」という名前の Netcool プロシージャを作成します。「opsgenie」シェルスクリプトを使用し、「host」プロパティを適切に設定します

create_opsgenie_alert

create or replace procedure create_opsgenie_alert
(in serial integer, in node character(255), in severity integer, in summary character(255), in count integer)
executable '/usr/bin/opsgenie'
host 'localhost'
user 0
group 0
arguments serial, '\'' + node + '\'', severity, '\'' + summary + '\'', count;

「mail_on_critical」に似た Netcool 時間トリガーを、「opsgenie_alert_on_critical」という名前で以下のように作成します。

opsgenie_alert_on_critical

create or replace trigger opsgenie_alert_on_critical
group default_triggers
priority 1
comment 'Send opsgenie alerts about critical alerts that are unacknowledged after 30 minutes'
every 10 seconds
evaluate
   select Serial, Node, Severity, Summary, Identifier, Count from alerts.status where
   Severity = 5 and Grade < 2 and Acknowledged = 0 and LastOccurrence <= (getdate -(60*30))
bind as criticals
begin
   for each row critical in criticals
   begin
      execute create_opsgenie_alert(critical.Serial, cricritical.Node, critical.Severity,    critical.Summary, critical.Count);
      update alerts.status via (critical.Identifier) set Grade=2;
   end;
end;

これまでに説明した手順は、インテグレーションのアラート作成部分を対象としています。すべてがうまくいけば、Opsgenie アラートが、30 分間承認解除される重要な Netcool イベントごとに作成されます。問題が発生した場合は、Lamp ログを確認します。

Netcool イベントでアクションを実行するには、Marid をインストールして適切に設定します。インテグレーションパッケージは、データベースレベルで ObjectServer にアクセスし、指定されたイベントアクションを実行する「netcoolActionExecutor.groovy」という強力な Java ベースのスクリプト言語である Groovy を提供します。ObjectServer のデータベースにアクセスできるシステムに Marid をインストールします。インストールを完了するには、以下の手順に従います。

Netcool の Opsgenie で少なくとも 1 つのアラートが作成されていることを確認します。
Netcool インテグレーションを使用して Opsgenie で作成されたアラートのアクションが、Opsgenie アラートの詳細で「承認」、「承認解除」、「タスクリストに追加」、「タスクリストから削除」であることを確認します。
Netcool インテグレーションファイルには、カスタマイズされたバージョンの Marid が含まれています。このバージョンをインストールする必要があります。
Marid のドキュメント - インストール手順を参照して Marid をインストールします。marid を再度ダウンロードしないでください。
Opsgenie Marid インテグレーションを作成し、Marid インテグレーションアラートフィルターが Netcool アラートのみを処理するようにしてください。
Marid インテグレーションの apiKey を opsgenie-integration/conf/opsgenie-integration.conf に入れる
opsgenie-integration/conf/opsgenie-integration.conf ファイルでデータベースアクセスパラメーターを設定します

opsgenie-integration.conf

netcool.db.driver=com.sybase.jdbc2.jdbc.SybDriver
netcool.db.host=192.168.1.178
netcool.db.port=4100
netcool.db.username=root
netcool.db.password=root

Marid を開始します。

Opsgenie から Netcool へのアクションをテストする

任意の Opsgenie アプリ (iPhone、Android、Opsgenie ダッシュボード) に移動します。Netcool インテグレーションで作成されたアラートを検索します。
Opsgenie アプリで承認アクションを実行する
アクションが Netcool イベントジャーナルに表示されることを確認します。結果は次のようになります。

Opsgenie アプリのアクションを実行する

Netcool イベントリストのアクション結果

この内容はお役に立ちましたか?

正確ではなかった

明確ではなかった

関係なかった

Opsgenie サポート