Opsgenie を SaltStack と統合する
Opsgenie が SaltStack ユーザーに提供するもの
Opsgenie の SaltStack 統合を使用し、Salt の状態またはイベントに応じて、Opsgenie でアラートを作成またはクローズします。Opsgenie は、オンコール スケジュールに基づいて通知する適切な担当者を決定します。メール、テキスト メッセージ (SMS)、電話、iOS および Android のプッシュ通知によって通知し、アラートが承認されるかクローズされるまでアラートをエスカレートします。
統合の機能性
アラートは、Salt 状態に応じて作成またはクローズされます。
アラートは、Salt の Event Reactor に従って作成またはクローズされます。
Opsgenie で SaltStack 統合を追加する
Opsgenie の Free プランまたは Essentials プランを使用している、または Jira Service Management の Standard プランで Opsgenie を使用している場合は、チーム ダッシュボードからのみこの統合を追加できます。 このプランでは、[設定] の [統合] ページが利用できません。
[チーム] に移動して自分のチームを選択します。
左側のナビゲーションで [統合] を選択し、[統合を追加] を選択します。
統合をチーム ダッシュボードから追加すると、そのチーム統合の所有者になります。Opsgenie では、この統合を通じて受信したアラートはそのチームのみに割り当てられます。このセクションの残りの手順に従って、統合を設定してください。
Go to Settings > Integrations. Search for SaltStack and select Add.
Specify who is notified of SaltStack alerts using the Responders field. Autocomplete suggestions are provided as you type.
API キーをコピーします。
[Save Integration (統合の保存)] を選択します。
SaltStack での設定
Download the Opsgenie's Execution Module.
If using Opsgenie from another domain(EU, sandbox etc.) update API_ENDPOINT variable at Opsgenie script. Default configured as (https://api.opsgenie.com).
Salt ファイル サーバーのルートにある _modules という名前のディレクトリにモジュールを移動します。
Download the Opsgenie’s State Module.
Salt ファイル サーバーのルートにある _states という名前のディレクトリにモジュールを移動します。
次のコマンドを実行して、これらのモジュールの変更をミニオンに適用します。
シェル
salt '*' saltutil.sync_all
Opsgenie と Salt States の統合
After the initial configuration Opsgenie’s state module can be used with SaLt State files(SLS).
ミニオンのディスク使用量に応じてアラートを作成したり閉じたりするユース ケースの例を見てみましょう。disk.sls という名前のファイルを作成します。このファイルは、Salt ファイル サーバーのルートにあります。
YAML
used_space:
disk.status:
- name: /
- maximum: 79%
- minimum: 10%
opsgenie_create_action_sender:
opsgenie.create_alert:
- api_key: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
- reason: 'Disk capacity is out of designated range.'
- name: disk.status
- onfail:
- disk: used_space
opsgenie_close_action_sender:
opsgenie.close_alert:
- api_key: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
- name: disk.status
- require:
- disk: used_space
Salt 状態ファイルの作成後、以下のコマンドを使用して試してみましょう。
シェル
salt salt-minion state.apply disk
We've used the SaltStack's Requisites (onfail, require) for triggering Opsgenie’s state module.
After successful configuration, an alert is created/closed in Opsgenie.
フィールド | (必須) | 説明 |
|---|---|---|
api_key | true | Opsgenie で統合を追加する際にコピーした API キーです。 |
理由 | true | Opsgenie で、アラートの既定のメッセージとして使用されます。 |
name | false | アラートのエイリアスとして使用されます。クローズ機能を使用する場合は、この場合のように両方の状態の name フィールドを指定する必要があります。 |
Opsgenie と SaltStack の Event Reactor を統合する
After initial configuration, Opsgenie’s execution module can be used with Salt's Event Reactor.
Salt のイベント バスに送信されたイベントに応じてアラートを作成したり閉じたりするユース ケースの例を見てみましょう。
Salt の Event Reactor を初めて使用する場合は、以下の設定を Salt master の設定に追加します。
/etc/salt/master
既定で。Salt の Event Reactor に習熟している場合は、必要に応じて既存のリアクター設定を編集します。
YAML
reactor:
- 'og-tag':
- /srv/salt/reactor/og-reactor.sls
Salt 状態ファイル
og-reactor.sls
/srv/salt/reactor/ にあり、以下の YAML コンテンツを貼り付けます。
YAML
opsgenie_event_poster:
local.opsgenie.post_data:
- tgt: 'salt-minion'
- kwarg:
name: event.reactor
api_key: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
reason: {{ data['data']['reason'] }}
action_type: Create
以下のコマンドを使用し、カスタム タグ
'og-tag'
が付いたイベントを送信します。
シェル
salt-call event.send 'og-tag' '{"reason" : "Overheating CPU!"}'
設定が正常終了すると、Opsgenie でアラートが作成またはクローズされます。
フィールド | (必須) | 説明 |
|---|---|---|
api_key | true | Opsgenie で統合を追加する際にコピーした API キーです。 |
理由 | true | Opsgenie で、アラートの既定のメッセージとして使用されます。 |
name | false | アラートのエイリアスとして使用されます。クローズ機能を使用する場合は、この場合のように両方の状態の name フィールドを指定する必要があります。 |
action_type | true | Opsgenie は、action_type の既定値 Create/Close をサポートします。Opsgenie のカスタム アクションを使用して、ノートの追加やアラートの確認などの目的で、このフィールドをカスタマイズできます。 |
SaltStack から送信されるペイロードのサンプル
JSON
{
"username": "root",
"kernel": "Linux",
"uuid": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"name": "event.reactor",
"kernelRelease": "4.12.13-300.fc26.x86_64",
"saltVersion": "2017.7.1",
"fqdn": "localhost.localdomain",
"saltPath": "/usr/lib/python2.7/site-packages/salt",
"cpuArch": "x86_64",
"reason": "Overheating CPU!",
"actionType": "Create",
"host": "localhost",
"master": "127.0.0.1",
"os": "Fedora",
"id": "salt-minion",
"cpuModel": "Intel(R) Core(TM) i7-4770HQ CPU @ 2.20GHz"
}
アラートの例
「Opsgenie を Salt States と統合する」の章で作成したアラート:
「Opsgenie と Salt の Event Reactor を統合する」の章で作成したアラート:
この内容はお役に立ちましたか?