---
sourceDocument: Xanadu IT Operations Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/it-operations-management

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# Kafka メッセージペイロード属性からアラートフィールドへのマッピング

# Kafka メッセージペイロード属性からアラートフィールドへのマッピング {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：6分

Kafka メッセージ属性をアラートフィールドにマッピングして、メッセージに基づくアラートをさらに意味のあるものにします。イベントフィールドマッピングを使用して、Kafka の重大度値を適切な ServiceNow 値にマップします。

## 始める前に

必要なロール：evt_mgmt_admin

## このタスクについて

ペイロードによって、イベントフィールドマッピングを使用すると、イベントフィールドマッピングルールの値をイベントに置き換えることで、より包括的な情報をイベントアラートに提供できます。ペイロードによって、イベント内の情報を変換して、指定されたアラートフィールド値を入力し、さまざまな値からアラートフィールドを作成することで、追跡や修復のためのアラートを生成します。必要に応じて、イベントフィールドマッピングとアラートルールの両方を使用します。

次のテーブルは、トピックから受信したメッセージとイベントの \[追加情報\] フィールドのフラット化されたペイロードを比較しています。トピックから受信したメッセージは単一フィールドにフラット化されて、イベントの \[追加情報\] フィールドに表示されます。これらのフラット化されたメッセージを使用して、イベントルールとマッピングを作成します。
{#map-kafka-message-payload-attributes-to-alert-fields__table_v4p_xtx_svb__entry__2}

| トピックに挿入される実際のペイロード | \[追加情報\] フィールドのフラット化されたペイロード |
|-|-|
| { "version": "v0.1.0", "name": "fibsrc", "id": "mnop6789", "trigger_description": "Triggers on duration_ms goes above 5K", "status": "TRIGGERED", "alert_type": "on_true", "summary": "Triggered: fibsrc", "description": "Current value (12.296815 k) greater than threshold value (5 k)", "operator": "greater than", "threshold": 5000, "groups": [ { "Group": "GroupA", "Result": 12296.815478000368 } ], "trigger": { "Result": 12296.815478000368 } } | { "flattened.alert_type": "on_true", "flattened.description": "Current value (12.296815 k) greater than threshold value (5 k)", "flattened.id": " mnop6789", "flattened.kafkaKey": "null", "flattened.kafkaOffset": "28", "flattened.kafkaPartition": "0", "flattened.kafkaTopicName": "topic123", "flattened.name": "fibsrc", "flattened.operator": "greater than", "flattened.status": "TRIGGERED", "flattened.summary": "Triggered: fibsrc", "flattened.trigger_description": "Triggers on duration_ms goesa above 5K", "flattened.version": "v0.1.0", "flattened.version": 5000, "flattened.groups.0.Group": "GroupA", "flattened.groups.0.Result": 12296.815478000368, "flattened.trigger.Result": 12296.815478000368 } |
[表 : 1. 実際のペイロードとフラット化されたペイロード]

{#map-kafka-message-payload-attributes-to-alert-fields__table_v4p_xtx_svb}

## 手順

1. Kafka メッセージ属性を事前定義されたアラートフィールドにマップし、アラートを生成するために、イベントフィールドマッピングを作成します。
   1. 移動先 すべてイベント管理ルールイベントフィールドマッピング.
   2. \[イベントフィールドマッピング\] ウィンドウで、\[新規\] を選択します。
   3. \[名前\] フィールドにフィールドマッピングの名前を入力します。
   4. \[ソース (Source)\] フィールドに \[Kafka コンシューマー\] と入力します。
   5. \[マッピングタイプ\] フィールドで、適切なマッピングタイプを選択します
   6. 利用可能なマッピングタイプのリストについては、「[イベントフィールドマッピング](https://servicenow-prod.fluidtopics.net/8JmvRKEIgE~x1NMHbwonPA "イベントフィールドマッピングを使用して、特定のイベントフィールドの値を他のフィールドの値にマップし、より包括的な情報をアラートに提供します。イベントルールでチームベースの統合を使用して、コネクタの所有権とルールの実行がグローバルルールよりも優先されるようにします。チームは、柔軟性とカスタマイズオプションを提供しながら、一貫性と階層を維持できます。")」を参照してください。
   {#map-kafka-message-payload-attributes-to-alert-fields__substeps_vhn_tmd_jvb}
2. Kafka メッセージ属性を事前定義されたアラートフィールドにマップし、アラートを生成するために、イベントルールを作成します。
   1. 移動先 すべてイベント管理ルールイベントルール.
   2. \[新規\] を選択します。
   3. \[名前\] フィールドで、イベントルールの名前を入力します。
   4. \[ソース (Source)\] フィールドに \[Kafka コンシューマー\] と入力します。
   5. \[イベントフィルター\] を選択します。
   6. 要件に従って適切なフィルターを入力します。
   7. \[アラート出力の変換と構成\] を選択します。  
      イベントルールを作成すると、 \[イベントルール\] の \[アラート出力の変換と構成\] タブにイベントフィールドが表示されます。Kafka メッセージはユーザーごとに異なるため、イベントフィールドをアラートフィールドに変換して、アラートに詳細を表示する必要があります。  
      注:  
      重大度の値はアラートを作成するために必要なので、イベントルールまたはイベントフィールドマッピングを使用して \[重大度\] フィールドをマッピングする必要があります。\[重大度\] フィールドが空の場合、イベントは処理されず、エラーステータスになります。
   8. イベントのフィールドと \[追加情報\] フィールドをアラートのフィールドにマッピングします。
   9. \[バインディング\] を選択します。
   10. 要件に従って適切なバインディングを入力します。
   11. \[送信\] を選択します。  
       詳細については、「[イベントルールの作成または編集](https://servicenow-prod.fluidtopics.net/5dUbDs~UKd6xbKmCWz7yxw "イベントルールを作成して、追跡および修復のためのアラートを生成できます。イベントルールでチームベースの統合を使用して、コネクタの所有権とルールの実行が一般的なルールよりも優先されるようにします。チームは、柔軟性とカスタマイズオプションを提供しながら、一貫性と階層を維持できます。")」を参照してください。
   {#map-kafka-message-payload-attributes-to-alert-fields__substeps_vwd_f3c_nvb}
3. \[すべてのイベント (All Events)\] 画面で、Kafka からのいずれかのイベントでイベントルールがないためにエラーステータスになっているかどうかを確認し、不足しているルールを指定します。
   1. 移動先 すべてイベント管理すべてのイベント.
   2. \[すべてのイベント (All Events)\] テーブルで、\[重大度\] 列のステータスとして \[エラー\] が表示されている Kafka コンシューマーイベントを開きます。  
      Kafka コンシューマーから受信するメッセージはさまざまです。コネクタは受信する属性を認識できないため、\[重大度\] フィールドまたは他のイベントフィールドをメッセージ内のフィールドにマップして、アラートフィールドに正しく入力されるようにする必要があります。
   3. \[すべてのイベント (All Events)\] 画面で、\[イベントルールを作成\] を選択して新しいイベントルールを作成します。  
      イベントルールの作成の詳細については、「[イベントルール](https://servicenow-prod.fluidtopics.net/5dUbDs~UKd6xbKmCWz7yxw "イベントルールを作成して、追跡および修復のためのアラートを生成できます。イベントルールでチームベースの統合を使用して、コネクタの所有権とルールの実行が一般的なルールよりも優先されるようにします。チームは、柔軟性とカスタマイズオプションを提供しながら、一貫性と階層を維持できます。")」を参照してください。

      新しいタイプのイベントを処理するイベントフィールドマッピングが存在しない場合は、イベントフィールドマッピングを作成します。詳細については、「[イベントフィールドマッピングの作成](https://servicenow-prod.fluidtopics.net/8JmvRKEIgE~x1NMHbwonPA "イベントフィールドマッピングを使用して、特定のイベントフィールドの値を他のフィールドの値にマップし、より包括的な情報をアラートに提供します。イベントルールでチームベースの統合を使用して、コネクタの所有権とルールの実行がグローバルルールよりも優先されるようにします。チームは、柔軟性とカスタマイズオプションを提供しながら、一貫性と階層を維持できます。")」を参照してください。
   {#map-kafka-message-payload-attributes-to-alert-fields__substeps_vbb_r5f_35b}

## タスクの結果

Apache Kafka コンシューマーコネクタが構成されました。新しいメッセージが Kafka トピックに到着すると、ServiceNow インスタンスにイベントとして受信され、それらのイベントからアラートが作成されます。