カスタム・ペイロードの構成

アラート通知にカスタム・ペイロードを追加すると、Instana アラートをより効率的に使用できます。

追加情報: アラート通知の一部としてモニター対象システムの関連情報を含めます。例えば、問題の影響を受けるホストにアクセスするために通常 ssh を使用する場合は、 ホストの IP または AWS パブリック IPv4 アドレスを含めることができます。その結果、正しいIPアドレスを見つけるために、まず Instana のダッシュボードをいくつかたどる必要がなく、各ホストに直接アクセスできるようになります。
高度なアラート・ルーティング: 各自が利用するアラート管理ツールで高度なアラート・ルーティングのユース・ケースを有効にします。例えば、組織が クラウドネイティブと考える場合、Kubernetes 環境にラベルとしてチームの責任を含めることができます。これにより、使用するアラート統合の中で、アラートを該当するチームに柔軟にルーティングできます。

カスタムペイロードをグローバルに設定する

Instana から送信されるすべてのアラート通知に、ご自身に関連する追加のペイロードを含めるには、以下の手順に従ってください：

サイドバーで「設定」をクリックします。
「イベント」&「アラート」の下で、 カスタム・ペイロードにナビゲートします。

このナビゲーション項目を表示するには、注: 許可 CAN_CONFIGURE_GLOBAL_ALERT_PAYLOAD が必要です。
カスタム・ペイロード・エントリーのプロパティーを入力します。
1. カスタム・ペイロード・エントリーを識別する固有かつ意味のあるキー。
  
  注: Instana の組み込みペイロードがオーバーライドされないことを保証するために、鍵の前に custom: が付きます。
2. カスタム・ペイロードの値のタイプを選択します。
  - 静的: 固定テキスト値。
  - 動的: 動的カスタム・ペイロードで説明されている、特定のタグに基づくアラートに関連するモニター対象インフラストラクチャーから派生した値のセット。
3. ペイロード・エントリーの値を定義します。
オプションで、別のエントリーを追加するため「行の追加」をクリックし、前のステップを繰り返します。
「保存」をクリックして変更を送信します。

グローバルカスタムペイロード

その結果、Instana によって送信される構成済みのアラート・チャネルのいずれかに対するすべての問題またはインシデントアラート通知に、構成済みの静的ペイロードまたは動的ペイロードが含まれるようになります (該当する場合)。イベント・タイプ変更のアラート通知には、構成済みの静的ペイロードのみが含まれます。

注：グローバルな動的カスタムペイロードは、ログ、アプリケーション、およびインフラストラクチャに関するカスタムイベントとスマートアラートにのみ適用されます。

動的カスタム・ペイロード

オンラインで編集

Instana 独自のダイナミックグラフを活用することで、監視対象システムの関係性を自動的に検出し、継続的に更新する機能に基づき、アラート通知に詳細な情報を付加することができます。その結果、ペイロード値はアラートがトリガーされたエンティティーのみならず、関連するエンティティーからも収集されます。

各動的ペイロード・エントリーには、Instana のタグ・カタログのタグが関連付けられています。選択されているタグごとに取得される情報が、一連の値としてイベントに組み込まれます。

カスタム・ペイロード・タグの選択

提案された候補から、選択した動的タグに適切なキーを選択するか、手動で追加することができます。

動的カスタム・ペイロードの提案

カスタム・ペイロードの例

オンラインで編集

Instana では、利用可能なすべてのアラートチャネルでカスタムペイロードがサポートされていますが、以下の例を見れば、設定されたペイロードを含むアラート通知がどのように表示されるか、より具体的に理解できるでしょう。

例 1: Opsgenie

オンラインで編集

Opsgenie アラートチャネルを使用する場合、ペイロードは「追加プロパティ 」セクションのテキストコンテンツとして含まれます。

カスタム・ペイロード opsgenie の例

さらに、これらのカスタム・ペイロードに基づくルーティング・ルールは、拡張アラート・ルーティングのユース・ケースに対して定義できます。

例 2: Slack

オンラインで編集

Slack や、 Google Chat や Microsoft Teams などの類似の通知ツールでは、カスタムペイロードはカンマ区切りの値のリストとして含まれます。メッセージ・コンテンツが長くなりすぎないようにするため、カスタム・ペイロード・エントリーは切り捨てられ、省略符号が示されます。

カスタム・ペイロード・スラックの例

例 3: Webhook

オンラインで編集

customPayloadsWebhook アラートチャネルを使用する場合、カスタムペイロードはの直下にネストされたオブジェクトとして含まれます。値は、 strings (String[].md) の配列として表されます。

{
  "issue": {
    "id": "53650436-8e35-49a3-a610-56b442ae7620",
    "type": "issue",
    "state": "OPEN",
    "text": "Custom Process Event",
    ...
    "customPayloads": {
       "custom:team": ["blue"],
       "custom:host-ip": ["10.128.0.85", "10.64.2.1"],
       "custom:app-name": ["rabbitmq"]
    }
  }
}