Splunk On-CallのHipChatインテグレーション 🔗
Use the bi-directional integration between HipChat and Splunk On-Call to fight fires from either platform and never miss a beat. All messages entered in the Splunk On-Call timeline, including alerts, on-call changes, escalations and chats appear in the HipChat room, and vice versa.
要件 🔗
Splunk On-Call required version: Starter or Growth for Single Room, Enterprise for Multi-Room
Use these step by step instructions to set up the integration for a Single Room or Multi-Room configuration.
Single Room 🔗
In Splunk On-Call 🔗
In Splunk On-Call, select Integrations then Hipchat.
インテグレーションがまだ有効になっていない場合は、インテグレーションを有効にする ボタンをクリックして、エンドポイントURLを生成します。必ず、」$routing_key」セクションを使用する実際のルーティングキーに置き換えてください。(VictorOpsでルートキーを表示または設定するには、アラート動作 >> ルートキー をクリックします)
インテグレーションを有効にすることで生成される*アドオン機能URL*をコピーします。
In HipChat 🔗
オンラインHipChatホームページから、インテグレーション を選択します。
アルファベット順のリストを下にスクロールし、VictorOpsを検索してください。製品名がSplunk On-Callに変わっても、HipChat内のインテグレーションはまだVictorOpsと呼ばれています： 
VictorOpsのインテグレーションメニューから、Install an integration from a descriptor url オプションを選択します：
Splunk On-Call HipChatインテグレーションページから取得した アドオン機能URL を 記述子URL ボックスに貼り付け、インストール をクリックします。
次に、VictorOps / Splunk On-Callに関連付けられるチャットルーム: hip8 を選択します
最後に、インストール をクリックします：
そのとおりです！
最後のステップは、選択したHipChatルームにエントリを投稿し、それがSplunk On-Callのタイムラインに表示されることを確認して、インテグレーションをテストすることです。
Multi-Room 🔗
マルチルーム版のHipChatインテグレーションは、シングルルームHipChat設定で達成可能なものをベースに構築されます。これは、エンタープライズレベルの機能である、ルールエンジンとカスタム発信Webhookの活用によって実現されます。
In HipChat 🔗
カスタムインテグレーションを作成することから始めましょう。Integrations を選択し、次に Build your own integration を選択します。
インテグレーションを作成したいルームを選択し、インテグレーションの名前を付けます。
「このURLに投稿して、このルームにメッセージを送る」ことができるURLが生成されます。このURLをクリップボードにコピーしてください。このURLには、この記事の後半で使用する2つの項目、ルームIDと認証トークンが含まれています。URLの太字はこちらです：
https://YOUR_DOMAIN.hipchat.com/v2/room/ROOM_ID/notification?auth_token=AUTH_TOKEN_HERE
新しいカスタムインテグレーションを保存します。
In Splunk On-Call 🔗
まず、ルームIDと認証トークンを、指定したルームに送信するアラートに追加するルールエンジンを設定します。この例では、」devops」というルーティングキーにマッチしたときに、room_idフィールドとauth_tokenフィールドを設定しています。
これにより、アラートのタイプに応じてroom_idとauth_tokenを変更することができます。この例では、」devops」というルーティングキーでマッチングしていますが、どのアラートフィールドでもマッチングすることができます。
Next we will need to set up an Outbound Webhook to send Splunk On-Call information to your HipChat room(s). See Splunk On-CallのカスタムアウトバウンドWebhook for steps.
Splunk On-Callのタイムラインから、インテグレーション > 発信Webhook >> * Webhookを追加する*を選択します。
HipChatに転送したい「イベント」を選択します。この例では、インシデントがトリガーされるたびにメッセージを送信します。
メソッド を 「POST 「に設定します。
コンテンツタイプ を」application/json」に設定します。
宛先アドレスには、HipChatルームエンドポイントを貼り付けます。アラートタイプに基づいて複数のルームに送信する場合は、」room id」と」auth token」変数をルールエンジンで作成したアラートフィールドに置き換える必要があります。例：
https://YOUR_DOMAIN.hipchat.com/v2/room/ \({{ALERT.room\_id}}/notification?auth\_token=\) {{ALERT.auth_token}}
ペイロードセクションでは、さまざまな変数を追加できます。詳細はHipChatのドキュメントを参照してください。この例では、」entity_display_name」フィールドで見つかったアラート情報を含む、シンプルな色のメッセージを送信します。
{ “color”: “red”, “message”: “${{ALERT.entity_display_name}}”, “notify”: true, “message_format”: “text” }
最終的な結果は次のようになるはずです：
Splunk On-Callシステムの他のイベントに対しても、追加のWebhookを作成できます。ご不明な点がございましたら、Splunk On-Callサポートまでお問い合わせください。