Live Messages は、特定のサービスが消費または生成するメッセージのライブ テールを表示できます。ライブ メッセージにアクセスして内容を確認することで、特定のサービスのトラブルシューティング時に問題の特定に役立ちます。

セットアップ

1. 使用したいサービスで Dynamic Instrumentation を有効化します。

   Dynamic Instrumentation requires Remote Configuration.

2. Datadog Settings で、次のロールを保持していることを確認します:

   • Dynamic Instrumentation Read
   • Dynamic Instrumentation Write

使用方法

1. Data Streams Monitoring マップに移動し、Dynamic Instrumentation が有効な Java サービスをクリックします。Messages タブを選択します。

2. Live Messages のライブ テールをオンにするには、再生ボタンをクリックします。次に、取得するメッセージ数のおおよその値を指定し、Start Capturing をクリックします。メッセージはログとして生成され、ホスト 1 台あたり 1 秒に 1 メッセージのレートでサンプリングされます。

3. 各メッセージをクリックすると、フィールドと値が表示されます。

Live Messages のライブ テールをオフにする

指定した概算のメッセージ数の取得が完了すると、ライブ テールは自動的にオフになります。Stop Capturing ボタンを選択して手動で停止することもできます。

追加の詳細

メッセージの保存とアクセス

メッセージはコンシューマーおよびプロデューサー内で Datadog によって取得されます。その後、Sensitive Data Scanner を通過したうえで、Datadog にログとして保存されます。

Live Messages 機能を使用するには、Dynamic Instrumentation Capture Variables と Dynamic Instrumentation Read のロールが必要です。組織内のすべてのユーザーがログを閲覧できます。ロール ベース アクセス制御 (RBAC) の詳細については、Dynamic Instrumentation を参照してください。

機微情報のマスキング

Dynamic Instrumentation は、password や accessToken など、機微と見なされる特定の識別子に関連付けられた値を自動的にマスキングします。マスキング対象の識別子の完全な一覧を参照してください。

追加の識別子を指定することで、マスキングの範囲をさらに調整できます。アプリケーションの環境 (datadog-agent ではありません) で、環境変数 DD_DYNAMIC_INSTRUMENTATION_REDACTED_IDENTIFIERS に firstName,lastName,phoneNumber のような識別子のカンマ区切りリストを設定します。

機微データのスクラビングの詳細については、Dynamic Instrumentation ドキュメント を参照してください。機微データの取り扱いに関して追加の要件やリクエストがある場合は、Datadog サポートに連絡してください。

Kafka 上の SSL 暗号化

Datadog は、暗号化される前にクライアント (コンシューマー、プロデューサー) 内でメッセージを取得します。そのため、Kafka レイヤーで暗号化が有効かどうかに関係なく、Datadog はメッセージを取得できます。