We're updating our terminology in Jira

'Issue' is changing to 'work item'. You might notice some inconsistencies while this big change takes place.

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 を統合する」の章で作成したアラート:

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

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

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

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

コミュニティに質問