APMカスタムレポートをOpenTelemetry Javaエージェント2.0に移行する 🔗
Splunk Distribution of OpenTelemetry Javaエージェントのバージョン2.0には、HTTPセマンティック規約の破壊的変更が含まれます。バージョン2.0のリリースは未定ですが、アップデートに先立って影響を受ける属性に移行しておくことで、Splunk APMのエクスペリエンスへの影響を最小限に抑えることができます。
廃止予定のOTel属性を使用し続けると、Splunk Distribution of OpenTelemetry Javaエージェントのバージョン2.0に更新した場合に、APMのカスタムレポートの以下の点が影響を受けます:
Tag Spotlight
作成したカスタムのチャートやダッシュボード
ディテクター
HTTPセマンティック規約の変更内容 🔗
以下のテーブルは、Splunk Distribution of OpenTelemetry Javaエージェントのバージョン1.0からバージョン2.0において変更された、現在のHTTP OpenTelemetry(OTel)属性を網羅しています。
注釈
OpenTelemetry Javaエージェントのバージョン2.0のリリースまでの間に、このリストは変更される可能性があります。
バージョン1.0のOTel属性 |
バージョン2.0のOTel属性 |
変更の理由 |
---|---|---|
|
|
一貫した名前空間設定のための更新。 |
|
|
一貫した名前空間設定のための更新。 |
|
|
一貫した名前空間設定のための更新。 |
|
|
一貫した名前空間設定のための更新。 |
|
|
様々なURLタイプに対して別々のフィールドを使用することを避け、ftp://、ssh://、file://、data://などの異なるURLタイプ間のテレメトリの相関を簡素化するための更新。 |
|
|
様々なURLタイプに対して別々のフィールドを使用することを避け、ftp://、ssh://、file://、data://などの異なるURLタイプ間のテレメトリの相関を簡素化するための更新。 |
|
|
様々なURLタイプに対して別々のフィールドを使用することを避け、ftp://、ssh://、file://、data://などの異なるURLタイプ間のテレメトリの相関を簡素化するための更新。 |
|
|
最新の属性定義を反映するための更新。 |
アップデートの影響を受けるかどうかを判断する 🔗
ご利用のAPMエクスペリエンスがアップデートの影響を受けるかどうかを判断するには、Splunk APMで影響を受けるOTel属性をカスタムタグとしてインデックス化しているかどうかを確認します:
注釈
HTTPメソッド属性は、デフォルトでSplunk Observability Cloudにシステムタグとして保存されます。HTTPメソッド属性をTroubleshooting MetricSet(TMS)または Monitoring MetricSet(MMS)として使用するためにインデックス化する必要はありません。
Settings に移動し、次に APM MetricSets に移動します。APM MetricSetsにアクセスするにはadminロールが必要です。
- APM MetricSetsリストにインデックスされたタグを、新しいOTel属性のリストと相互参照させます。HTTPセマンティック規約の変更内容 を参照してください。
APM MetricSetsページに影響を受けるタグが1つ以上表示されている場合、各タグがTroubleshooting MetricSet(TMS)としてのみインデックス化されているのか、Monitoring MetricSet(MMS)としてもインデックス化されているのかを判断します。その後、移行手順 セクションを参照してください。
影響を受けるタグのいずれもインデックス化しない場合は、タグを移行するための操作は何も必要ありません。今後、必ず新しいHTTP規約を使用するようにしてください。
移行手順 🔗
移行が必要と判断した場合は、以下の手順に従ってください:
アップデートのタイミングを調整する 🔗
2023年8月7日時点で、Splunk APMは生トレースデータの新しい属性の入力を開始しています。しかし、これらの新しい属性のTMSとMMSはまだ作成されていません。データを受信するには、TMSとMMSを作成する必要があります。アップデートの準備として、新しい属性をタグとしてインデックス化し、カスタムのTMSおよびMMSがレポーティング用のデータを受信できるようにする必要があります。Tag Spotlightで使用されるTMSの場合は、アップデートの少なくとも8日前に、新しいデータのインデックス化を予定してください。ダッシュボードのチャートやディテクターで使用されるMMSの場合は、データのギャップを防ぐために、新旧両方のタグをフィルタリングするように、チャートやダッシュボードのSignalFlowを更新する必要があります。