OpenTelemetry トレースとの統合

Instana OpenTelemetry のトレースとシームレスに連携できます。 Instana OpenTelemetry のトレースを、デフォルトの W3C トレースコンテキストを使用する Instana で生成されたトレースと関連付けます。

Instana OpenTelemetry の「トレースのセマンティック規約」および「 リソースのセマンティック規約」 で頻繁に使用される定義をサポートしています。 Instana OpenTelemetry のセマンティック規約で定義されている以下の属性をサポートしています。

スパン属性:

- peer.service
- net.peer.ip
- net.peer.name
- net.peer.port
- http.method
- http.url
- http.scheme
- http.host
- http.target
- http.status_code
- http.route
- http.user_agent
- db.system
- db.user
- db.statement
- db.operation
- db.name
- db.connection_string
- messaging.system
- messaging.operation
- messaging.destination
- rpc.system
- rpc.service
- rpc.method
- faas.execution
- faas.trigger
- faas.coldstart

リソース属性:

- service.name
- service.instance.id
- container.id
- process.pid
- telemetry.sdk.language
- host.name
- host.id
- cloud.provider
- faas.id
- device.id
- process.runtime.version
- container.name
- container.runtime
- container.image.name
- container.image.tag
- faas.version

OpenTelemetry Instana の AutoTrace テクノロジーと統合されています。 OpenTelemetry が有効になっている場合、アプリケーションによって生成されたトレースのスパンは、 Instana トレーサーから生成されたスパンと同様に処理されます。

OpenTelemetry, からの通話をフィルタリングするには、フィルタクエリを OpenTelemetry リソースの属性、 service.name および に設定 is presentします。 リソース・セマンティック規則の OpenTelemetry 仕様 には OpenTelemetry リソース属性 service.nameが必要であるため、このフィルター照会を設定します。 OpenTelemetry には、サービス名を指定するためのさまざまな方法があります。 詳しくは、 OpenTelemetry の公式資料を参照してください。

すべての OpenTelemetry 属性またはリソース属性は、以下のタグで表されます。

• 動的タグ：これらのタグは、 Instana に送信され、かつコールタグカタログに含まれるすべての OpenTelemetry 属性から算出されます。 タグ・カタログから直接、 http.methodなどの名前で動的タグを簡単に検索できます。 タグ・カタログに入れられる動的タグの数は、500 個の異なる属性名に制限されます。 この制限を超えた場合、静的タグにはこの制限がないため、静的タグのみを使用してフィルタリングおよびグループ化してください。

  

• 静的タグ：これらのタグを使用すると、 Instana に送信されるすべての OpenTelemetry 属性、または OpenTelemetry リソース属性にアクセスできます。 静的タグでフィルタリングまたはグループ化を行うには、まず 「 OpenTelemetry 」タグまたは「 OpenTelemetry 」リソースタグを選択し、そのキーとして属性名を指定する必要があります。

  

Instana OpenTelemetry のspanイベントおよびspanリンクに対応しています。 通話の 「詳細 」画面で確認できます。

• スパンイベント：スパンイベントとは、スパン上の構造化されたログメッセージ（またはアノテーション）であり、スパンの継続時間中の特定の時点を示すものです。 詳細については、 「Span イベント」 を参照してください。

• スパンリンク：スパンリンクは、あるスパンを1つ以上のスパンに関連付け、それらの間に（親子関係とは異なる）因果関係を確立します。 詳細については、 「Span Links」 を参照してください。

• Instana Instana のデフォルトのコンテキストプロパゲータを、 W3C のTrace Context以外のコンテキストプロパゲータと組み合わせることはサポートされていません。 W3C Trace Context は、 OpenTelemetry のデフォルトのコンテキスト伝播モジュールです。