Catalyst Center と PagerDuty の統合

Catalyst Center と PagerDuty の統合について

Catalyst Center と PagerDuty を統合できます。


（注）  

PagerDuty は、信頼性の高い通知を提供してインフラストラクチャに関する問題を検出および修正するインシデント管理プラットフォームです。PagerDuty については、https://www.pagerduty.com/ を参照してください。

次の表は、サポートされている Catalyst Center と PagerDuty の統合ワークフローを示しています。

表 1. Catalyst Center と PagerDuty の統合ワークフロー
ステップ 説明

ステップ 1

次の Catalyst Center と PagerDuty の統合の要件を確認します。

  • 最新の Catalyst Center リリース。

  • PagerDuty

（注）  

 

Catalyst Center と PagerDuty の統合は、PagerDuty Events REST API と Catalyst Center Events フレームワークを使用して実現されます。

ステップ 2

統合の設定を行います。メインメニューから次を選択します。[System] > [Settings] > [System Configuration] > [Integration Settings]。コールバック URL ホスト名または IP アドレスを入力します。

ステップ 3

1 つ以上のイベントを選択して登録し、Catalyst Center から PagerDuty に通知を転送します。

Catalyst Centerでイベントにアクセスするには、メニューアイコンをクリックして次を選択します。[Platform] > [Developer Toolkit] > [Event Notifications] > [Event Catalog] の順に選択します。[Event Catalog] には、すべてのイベントが表示されます。

[Notifications] タブをクリックしてイベントを登録します。

ステップ 4

[Notifications] タブで、イベントの新しい通知を作成します。

[Create a New Notification] ウィザードの手順に従い、通知チャネルとして PagerDuty を選択します。

選択したイベントの Catalyst Center プラットフォーム GUI に次のデータを入力する必要があります。

  • [PagerDuty Events API URL]

  • [PagerDuty Integration Key]（ルーティングキー）

このイベント構成手順の詳細については、PagerDuty への Catalyst Center イベント通知の登録 を参照してください。

ステップ 5

選択したイベントの通知が Catalyst Center から PagerDuty に転送されるようになりました。

Catalyst Center 問題と PagerDuty イベントの間でサポートされているワークフロー接続は次のとおりです。

  • Catalyst Center を開いて PagerDuty をトリガーします。

ステップ 6

PagerDuty は、次の REST API 応答のいずれかで Catalyst Center に応答します。

  • 202：イベントは PagerDuty によって受け入れられました。

  • 400：不正な要求 - JSON が有効であることを確認してください。

  • 429：一度の API 呼び出しが多すぎます。

  • 500 またはその他の 5xx：内部サーバーエラー - イベントの処理中に PagerDuty サーバーでエラーが発生しました。

  • Networking Error：PagerDuty サーバーとの通信の試行中にエラーが発生しました。

ステップ 7

PagerDuty のインシデントステータスを確認して（必要に応じて）変更します。

（注）  

 
この手順の実行に関する情報は、PagerDuty のドキュメントを参照してください。

ステップ 8

PagerDuty でインシデントを閉じます。

（注）  

 
この手順の実行に関する情報は、PagerDuty のドキュメントを参照してください。

ステップ 9

PagerDuty の統合は、Catalyst Center から PagerDuty への一方通行の通知です。Catalyst Center は、問題をクローズするために PagerDuty のステータスに依存しません。

PagerDuty への Catalyst Center イベント通知の登録

PagerDuty にアラートとして表示されるように Catalyst Center プラットフォーム イベント通知を設定できます。ここで説明されている手順に従って、PagerDuty に表示されるように Catalyst Center イベント通知を設定します。

始める前に

Catalyst Center プラットフォーム と統合するシステム上で PagerDuty が実行されていることを確認します。PagerDuty の設定手順については、PagerDuty のドキュメントを参照してください。

この手順で説明するタスクを実行するには、適切な権限が必要になります。Catalyst Center プラットフォーム におけるロールベース アクセス コントロール（RBAC）の詳細については、『Cisco Catalyst Center Platform User Guide』を参照してください。

手順

ステップ 1

メインメニューから次を選択します。[Platform] > [Developer Toolkit] > [Event Notifications]。

[Events Notifications] ウィンドウが表示されます。

ステップ 2

[Notifications] タブをクリックして、通知タイルを表示します。

各通知はタイルで表され、通知の詳細を表示するためのリンクが含まれています。左側のペインの [CHANNELS] エリアで、通知チャネルの横にあるオプションボタンをクリックすると、選択したチャネルの既存のタイルが表示されます。

ステップ 3

[Create a New Notification] ウィザードの手順に従って、新しい通知を作成します。

[Let's Do It] をクリックして、ワークフローに直接移動します。

ステップ 4

[Select Site and Events] ウィンドウで、ドロップダウンリストからサイトを選択し、必要な通知チャネルをサポートするイベントを選択します。

ステップ 5

[Next] をクリックします。

[Select Channels] ウィンドウが表示されます。

ステップ 6

[Select Channels] ウィンドウで、通知チャネルとして [PAGERDUTY] を選択します。

[Next] をクリックして、[PAGERDUTY Settings] ウィンドウで次の値を設定します。

  • [SERVICE CONFIGURATION] エリアで、[Select Existing Instance] をクリックして既存の PagerDuty インスタンスを使用するか、[Create New Instance] をクリックして新しい PagerDuty インスタンスを作成します。

  • [Select Instance] ドロップダウンリストで PagerDuty インスタンスを選択します。

  • [PagerDuty Events API URL] フィールドに、PagerDuty イベント API URL を入力します。

  • [PagerDuty Integration Key] フィールドに、PagerDuty 統合キーを入力します。

  • [PagerDuty Events API Version] フィールドで、ドロップダウンリストからイベント API バージョンを選択します。

ステップ 7

[Next] をクリックします。

[Name and Description] ウィンドウが表示されます。

ステップ 8

[Next] をクリックします。

[Summary] ウィンドウが開きます。

ステップ 9

[Summary] ウィンドウで、設定を確認します。

変更するには、[Edit] をクリックします。

ステップ 10

[完了（Finish）] をクリックします。

タスク完了[Done! Your new notification is complete] ウィンドウが表示されます。

詳細については、『Cisco Catalyst Center Platform User Guide』の「Work with Event Notifications」および『Cisco Catalyst Center User Guide』の「Create an Event Notification」を参照してください。

次のタスク

PagerDuty にアクセスしてイベントを確認します。

Catalyst Center イベントは、PagerDuty の [INCIDENTS] ウィンドウ内のアラートとして PagerDuty に表示されます。このウィンドウでアラートを確認し、[Resolved] としてマークできます。