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 アラートを作成する方法を示しています。
Go to Settings > Integrations. Search for Email and select Add. Learn more about integrating Opsgenie with your email.
Opsgenie の Free プランまたは Essentials プランを使用している、または Jira Service Management の Standard プランで Opsgenie を使用している場合は、チーム ダッシュボードからのみこの統合を追加できます。 このプランでは、[設定] の [統合] ページが利用できません。
[チーム] に移動して自分のチームを選択します。
左側のナビゲーションで [統合] を選択し、[統合を追加] を選択します。
統合をチーム ダッシュボードから追加すると、そのチーム統合の所有者になります。Opsgenie では、この統合を通じて受信したアラートはそのチームのみに割り当てられます。このセクションの残りの手順に従って、統合を設定してください。
Opsgenie メール インテグレーション (下図) のメール アドレスを使用して、「mail_on_critical」トリガーのアクション セクションを変更し、有効にします。電子メールの件名には「Netcool メール」テキストではなく [概要] フィールドを使用していることに注意してください。これは、Opsgenie アラート メッセージに変換されます。
完了です! 正しく設定されていれば、Opsgenie は重要な Netcool イベントごとにアラートを作成します。このアラートは 30 分間受信されません。
問題が発生した場合は、メール ユーティリティが正しく動作していることを確認します。Netcool 手順が正常に動作しているかどうかをテストするには、連絡先のメールをメールボックスに変更します。
シナリオ 2: Lamp & Marid を介したインテグレーション
Opsgenie also provides the Netcool Integration plugin that provides integration via the web API (HTTPS) using Opsgenie-provided tools: Lamp and Marid. When installed and appropriately configured, the plugin creates Opsgenie alerts via Lamp command line utility and enables recipients to execute actions like acknowledge, write to journal, etc. on Netcool events directly from their mobile devices or Opsgenie web console.
インストール
以下の手順では、Opsgenie Netcool インテグレーション パッケージを使用してアラートを作成し、アラートに対してアクションを実行する方法について説明します。
Download Opsgenie Netcool Integration files, which includes:
Lamp - Opsgenie コマンドライン ユーティリティでアラートを作成します
Marid - Opsgenie インテグレーション サーバー
Netcool インテグレーション シェル スクリプト
Netcool インテグレーション パッケージを Netcool サーバー上のディレクトリに解凍します。
Lamp のインストール:
Netcool インテグレーション ファイルには、カスタマイズされたバージョンの lamp が含まれています。このバージョンをインストールする必要があります。
Install lamp by referring to Lamp Documentation - Installation steps- Do not download lamp again
Netcool シェル スクリプトに正しい LAMP_HOME (lamp のインストール ディレクトリ) があることを確認してください
Create an API Integration and obtain apiKey, then put into the opsgenie-integration/conf/opsgenie-integration.conf file
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 が含まれています。このバージョンをインストールする必要があります。
Install Marid by referring to Marid Documentation - Installation steps. Do not download Marid again.
Create an Opsgenie Marid Integration, make sure your Marid integration Alert Filter processes only Netcool alerts.
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 イベント リストのアクション結果
この内容はお役に立ちましたか?