1. Homepage
  2. Mule Runtime (4.2)
  3. Mule アプリケーションの開発
  4. 一般的な開発戦略とベストプラクティス
  5. イベント追跡の設定

  6. デフォルトイベント追跡の設定

デフォルトイベント追跡の設定

このバージョンの Mule は、拡張サポートが終了する 2023 年 5 月 2 日にその すべてのサポート​が終了しました。

このバージョンの Mule を使用する CloudHub には新しいアプリケーションをデプロイできなくなります。許可されるのはアプリケーションへのインプレース更新のみになります。

標準サポートが適用されている最新バージョンの Mule 4 にアップグレード​することをお勧めします。これにより、最新の修正とセキュリティ機能強化を備えたアプリケーションが実行されます。

イベント追跡を行うと、Mule Runtime Engine で生成されるイベントを集約および保存するための処理やネットワークオーバーヘッドが必要になるため、デフォルトでは、イベント追跡は無効になっています。ただし、イベント追跡をサポートするコネクタまたはメッセージプロセッサーに対して、次の 2 つのいずれかのレベルでデフォルトイベント追跡を有効化し、設定することができます。

  • フローレベル

  • メッセージプロセッサー (コネクタまたはコンポーネント) レベル (フローレベルの設定よりも優先される)

イベント追跡を有効にしたら、特定の追跡対象イベントを識別するようにトランザクション ID をカスタマイズして、実行時にそのイベントを分析できるようにします。

フローレベルのイベント追跡

イベント追跡をサポートするフローのすべての要素のデフォルトイベント追跡を有効にするには、このオプションを使用します。 特定のプロセッサーまたはコネクタの追跡を無効にして、フローレベルの設定を上書きできます。

フローのすべてのコンポーネントのデフォルトイベント追跡を有効にする手順は、次のとおりです。

  1. フローコンポーネントを選択して、プロパティビューを開きます。

  2. UI または XML を使用して、デフォルトビジネスイベントを有効にします。

    • UI では、​[Enable default events tracking (デフォルトイベント追跡を有効化)]​ をオンにします。

      default-event-tracking-flow

    • XML では、属性 ​tracking:enable-default-events="true"​ を ​flow​ 要素に追加します。

      <flow name="testFlow" tracking:enable-default-events="true">

  3. 設定を保存します。

メッセージプロセッサーレベルのイベント追跡

イベント追跡をサポートする個々のコネクタおよびコンポーネントでイベント追跡を有効にできます。

個々のコンポーネントのデフォルトイベント追跡を有効にする手順は、次のとおりです。

  1. コネクタまたはコンポーネントのプロパティビューを開きます。

  2. 次のいずれかのオプションを使用して、デフォルトビジネスイベントを有効にします。

    • UI では、​[Enable default events tracking (デフォルトイベント追跡を有効化)]​ をオンにします。

      default-event-tracking-component

    • XML では、属性 ​tracking:enable-default-events="true"​ をコンポーネント要素の内側に追加します。

      <flow name="flow">
  ...
    <choice doc:name="Choice" tracking:enable-default-events="true"/>
  ...
</flow>

  3. 設定を保存します。

トランザクション ID のカスタマイズ

実行時に追跡対象イベントを分析するときにトランザクションの有用な情報 (注文番号など) が表示されるように、トランザクション ID を定義します。トランザクション ID をカスタマイズしない場合、デフォルトでは Mule によって数値のトランザクション ID が割り当てられます。

トランザクション ID は DataWeave 式をサポートするため、ID を動的に作成し、イベントに関連する情報を ID に含めることができます。UI または XML で、次の手順に従ってトランザクション ID を設定します。

  • UI では、次の手順を実行します。

    1. [Set Transaction Id]​ コンポーネントをフローにドラッグします。

    2. トランザクション ID を定義します。

      custom-transaction-id

  • XML では、子要素を ​flow​ 要素に追加します。

    <flow name="flow">
...
  <tracking:transaction id="#[payload.orderId]" />
...
</flow>

関連情報

ビジネスイベント