Mule Runtime での OpenTelemetry のサポート

トレースは、分散システムの完全な操作を表す一連のスパンです。スパンは、ネストされることがあり、作業または操作の単位を表します。各スパンには、以下が含まれます。

フロー実行をトレースする場合、メッセージの処理に関連する各 Mule コンポーネント実行はスパンとして表されます。コンポーネントスパンは、実行の関連する側面を表します。Set Payload などのシンプルなコンポーネントでは 1 つのスパンですが、Batch Job などではより複雑な構造になります。

Mule Runtime は Batch Job などの複雑なコンポーネントを追跡します。

トレースは、Batch Job の最初のステップでどのように各バッチレコードが処理されるのかを表示します。各レコードスパンには、Logger コンポーネントで実行される作業の単位を表す子スパンが含まれます。 次に、For Each コンポーネントおよびその内部のプロセッサー (Transform Message や Logger など) と共に Batch Aggregator スパンを表示します。 その後、他の 2 つのバッチステップとそれぞれのコンポーネントを表示します。 最後に、フローの Batch Job の後に表示される Logger コンポーネントと共に Batch On Complete スパンを表示します。

次の例では、ある Mule アプリケーションが別の Mule アプリケーションに要求を送信しています。

Mule および HTTP Connector で OpenTelemetry が計測されるため、分散トレースでは、同じトレースの一部として両方のフローが取得されます。

スパンで表される実行作業単位でエラーが発生すると、スパンの状況が ​[Error (エラー)]​ に設定されます。MuleSoft は、1 つ以上の​例外​イベントをスパンに追加する OpenTelemetry によって定義されるセマンティック規則に準拠します。

次の例では、エラーが発生したときに、Raise error コンポーネントに対応するスパンで Lightstep プラットフォームのエラー状況が表示されます。

この状況は、親スパン (フロースパンなど) に伝播します。スパンの詳細ビューにエラー状況と例外イベントが表示されます。

HTTP Listener および HTTP Request 操作により、スパンに属性が追加され、HTTP インタラクションをトレースするためのより多くのコンテキストが提供されます。

HTTP Listener が含まれるフローでは以下のようになります。

フロースパンに関連付けられた HTTP Listener の追加属性:

HTTP Request が含まれるフローでは以下のようになります。

フロースパンに関連付けられた HTTP Request の追加属性: