SaltStack と統合する

Opsgenie から Jira Service Management にオペレーションを移行したお客様の場合、この統合の新しいインスタンスを Jira Service Management で追加することはできません。編集できるのは、元々 Opsgenie から移行された統合だけです。

Jira Service Management が SaltStack ユーザーにもたらすメリット

Jira Service Management の SaltStack 統合を使用して、Salt の状態またはイベントに応じて、Jira Service Management でアラートを作成またはクローズします。 Jira Service Management は、オンコールスケジュールに基づいて適切な通知先を決定します。メール、テキストメッセージ (SMS)、電話、iOS や Android のプッシュ通知による通知を行い、アラートが承認またはクローズされるまでアラートをエスカレートします。

統合の機能性

アラートは、Salt 状態に応じて作成またはクローズされます。
アラートは、Salt の Event Reactor に従って作成またはクローズされます。

Jira Service Management で SaltStack 統合を編集する

Jira Service Management で SaltStack 統合を編集するには、次の手順を実行します。

チームの運用ページに移動します。
左側のナビゲーションパネルで [統合] を選択します。
SaltStack 統合を検索します。
必要に応じて統合の設定とルールを編集します。

SaltStack で統合を設定する

該当する場合はこのセクションの指示に従ってください。

Opsgenie の実行モジュールをダウンロードします。
別のドメイン (EU、サンドボックスなど) から Opsgenie を使用している場合、Opsgenie スクリプトで API_ENDPOINT 変数をアップデートします。既定では (https://api.opsgenie.com) として設定されています。
Salt ファイルサーバーのルートにある _modules という名前のディレクトリにモジュールを移動します。
Opsgenie の状態モジュールをダウンロードします。
Salt ファイルサーバーのルートにある _states という名前のディレクトリにモジュールを移動します。
次のコマンドを実行して、これらのモジュールの変更をミニオンに適用します。

シェル

salt '*' saltutil.sync_all

Jira Service Management と Salt States の統合

初期設定後、Opsgenie の状態モジュールは、Salt 状態ファイル (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

Opsgenie の状態モジュールをトリガーするために、SaltStack の前提条件 (onfail、require) を使用しました。設定が正常に完了すると、Jira Service Management でアラートが作成/クローズされます。

フィールド	(必須)	説明
api_key	true	これは、Jira Service Management で統合を追加する際にコピーした API キーです。
理由	true	Jira Service Management でアラートの既定のメッセージとして使用されます。
name	false	アラートのエイリアスとして使用されます。クローズ機能を使用する場合は、この場合のように両方の状態の name フィールドを指定する必要があります。

Opsgenie と SaltStack の Event Reactor を統合する

初期設定後、Opsgenie の実行モジュールは Salt の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!"}'

設定が正常に完了すると、Jira Service Management でアラートが作成/クローズされます。

フィールド	(必須)	説明
api_key	true	これは、Jira Service Management で統合を追加する際にコピーした API キーです。
理由	true	Jira Service Management でアラートの既定のメッセージとして使用されます。
name	false	アラートのエイリアスとして使用されます。クローズ機能を使用する場合は、この場合のように両方の状態の name フィールドを指定する必要があります。
action_type	true	Jira Service Management は、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 を統合する」の章で作成したアラート:

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

正確ではなかった

明確ではなかった

関係なかった

Jira Service Management サポート

SaltStack と統合する

Jira Service Management が SaltStack ユーザーにもたらすメリット

統合の機能性

Jira Service Management で SaltStack 統合を編集する

SaltStack で統合を設定する

Jira Service Management と Salt States の統合

Opsgenie と SaltStack の Event Reactor を統合する

SaltStack から送信されるペイロードのサンプル

アラートの例

その他のヘルプ