SaltStack と統合する

If you’re a customer who shifted your operations from Opsgenie to Jira Service Management, adding new instances of this integration isn’t possible in Jira Service Management. You can only edit the integrations that originally shifted from 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 で統合を設定する

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

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

Jira Service Management と 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 Jira Service Management.

フィールド	(必須)	説明
api_key	true	これは、Jira Service Management で統合を追加する際にコピーした API キーです。
理由	true	Jira Service Management でアラートの既定のメッセージとして使用されます。
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!"}'

設定が正常に完了すると、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 を統合する」の章で作成したアラート:

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

正確ではなかった明確ではなかった関係なかった

さらにヘルプが必要ですか?

アトラシアンコミュニティをご利用ください。

コミュニティに質問