IBM Z ChatOpsIntegration(パブリック・プレビュー)

Instana のイベントに関するアラート通知を IBM Z ChatOps に送信する方法についてご確認ください。

Instana のイベントに関するアラート通知を IBM Z ChatOps にリアルタイムで送信するには、 IBM Z ChatOps のアラートチャネルを作成してください。

IBM Z ChatOps のアラートチャンネルを作成する

IBM Z ChatOps のアラートチャネルを作成するには、 Instana のUIで、 [設定] > [グローバル設定 ] > [イベントとアラート ] > [アラートチャネル ] > [アラートチャネルの追加] の順にクリックします。

IBM Z ChatOps アラート・チャネル

  • Z ChatOps の「インシデント」セクションにある「 URL 」フィールドは、インシデントに関するPOSTリクエストを送信するために、 https://your_microservice_server:your_port_number/ibm/bnz/v1/incidentIBM Z ChatOps のインスタンスを指すように設定する必要があります。 詳細については、 「 IBM Z ChatOps との連携」 を参照してください。

  • Token 」フィールドには、JWTベアラートークンを指定する必要があります。このトークンは、 IBM Z ChatOps マイクロサービスから取得できます。

  • チャネル・フィールドには、チャネル・サービスでアラートを受信したいチャネル名を含める必要があります(つまり、IBM Z ChatOpsと統合するために使用される通信ツールである'**Mattermost**のチャネル名です)。

アラートのペイロードの詳細

Instana のUIでイベントが発生すると、アラートが受信されます。 IBM Z ChatOps のアラートチャネルを作成すると、 URL のエンドポイントが提供されます。 受信したアラートのペイロードは、この URL エンドポイントに送信されます。

IBM z/OS のエンティティが Instana 内でアラートをトリガーすると、その特定のエンティティに対応するペイロードが IBM Z ChatOps に送信されます。 Instana 以下の IBM z/OS エンティティに対応しています:

  • CICS
  • Db2
  • IMS

アラート・ペイロードには、以下の情報が含まれます。

  • Id: イベントの ID。
  • 要約: イベントのタイトル。
  • 説明: イベントの説明。
  • 優先度 : Instana で重大(Critical)の深刻度を持つイベントは優先度 high に割り当てられ、それ以外のすべてのイベントは優先度 low に割り当てられます。
  • 深刻度 : Instana のイベントのうち、深刻度が「重大」のものは 深刻 critical 度に、深刻度が「警告」のものは 深刻 minor 度に、その他のイベントは 深刻 low 度にマッピングされます。
  • カテゴリー: アラート。
  • 日付時刻:UTC(協定世界時)フォーマットで、報告および発生したタイムスタンプを提供する。
  • ロケーション: リソース名には、イベントがトリガーされたエンティティーの名前が含まれます。 以下のように、 IBM Z エンティティー上のイベントに関する追加情報が含まれます。
    • CICS: シスプレックス名、システム名、SMF ID。
    • Db2: SMF ID。
    • IMS: SMF ID。
  • 状況: New または Closed イベント。
  • 情報提供 : Instana
  • ChatTool ポスト: ユーザーが提供する Mattermost チャネルの名前が含まれます。
  • リンク : Instana のイベントへのリンクを添付します。
  • カスタマイズ・フィールド: イベントのタイプに基づいて、以下のデータがアラートに付加されます。
    • CICS: コンポーネント、 CICS 領域、および CICS プレックス名。
    • IMS: コンポーネントおよび IMS ID。
    • Db2: コンポーネントおよび Db2 ID。