Azure Monitor を使用して Azure Logic Apps の従量課金ワークフローで B2B メッセージを監視および追跡する

適用対象: Azure Logic Apps (従量課金)

注

この記事は、従量課金ロジック アプリワークフローにのみ適用されます。 Standard ロジック アプリのワークフローについては、次を参照してください。

統合アカウントで取引先間の B2B 通信を設定した後、これらのパートナーは AS2、X12、EDIFACT などのプロトコルを使用してメッセージを交換できます。 この通信が期待どおりに動作することを確認するには、統合アカウントの Azure Monitor ログを設定します。

Azure Monitor を使用すると、クラウドとオンプレミスの環境を監視して、可用性とパフォーマンスをより簡単に維持できます。 Azure Monitor ログを使用すると、トリガー イベント、実行イベント、アクション イベントなどのランタイム データとイベントに関するデータを Log Analytics ワークスペースに記録して格納できます。

メッセージの場合、ログには次の情報も収集されます。

  • メッセージの数と状態
  • 承認状況
  • メッセージと受信確認の間の相関関係
  • 障害の詳細なエラー説明

Azure Monitor を使用すると、この情報を見つけて確認するのに役立つログ クエリを作成できます。 この診断データは、Azure Storage や Azure Event Hubs などの他の Azure サービスでも使用できます。

このガイドでは、統合アカウントの Azure Monitor ログを設定する方法について説明します。 最初に、Azure portal に Logic Apps B2B ソリューションをインストールします。 このソリューションは、B2B メッセージ イベントの集計情報を提供します。 次に、ログ記録とクエリの作成を有効にするには、Azure Monitor ログを設定する方法について説明します。

詳細については、以下を参照してください。

注

この記事は最近、Log Analytics ではなく Azure Monitor ログという用語を使うように更新されました。 ログ データは引き続き Log Analytics ワークスペースに格納され、同じ Log Analytics サービスによって収集されて分析されます。 Azure Monitor のログの役割をより適切に反映させるために、用語を更新しています。 詳しくは、Azure Monitor の用語の変更に関するページをご覧ください。

[前提条件]

Logic Apps B2B ソリューションをインストールする

Azure Monitor ログでロジック アプリの B2B メッセージを追跡する前に、 Logic Apps B2B ソリューションを Log Analytics ワークスペースに追加します。

  1. Azure portal の検索ボックスに「Log Analytics ワークスペース」と入力し、[Log Analytics ワークスペース] を選択します。

    Log Analytics ワークスペースが強調表示されている Azure portal の検索ボックスを示すスクリーンショット。

  2. [Log Analytics ワークスペース] でワークスペースを選択します。

    選択できる Log Analytics ワークスペースを示すスクリーンショット。

  3. [ 概要 ] ページの [ Log Analytics の概要>監視ソリューションの構成] で、[ ソリューションの表示] を選択します。

    [ソリューションの表示] を選択できるワークスペースの [概要] ページを示すスクリーンショット。

  4. [ 概要 ] ページで、[ 追加] を選択します。

  5. Marketplace が開いたら、検索ボックスに「logic apps b2b」と入力し、Logic Apps B2B を選択します。

    スクリーンショットは、Logic Apps B2B を検索して選択できる Marketplace を示しています。

  6. ソリューションの説明ウィンドウで、[ 作成] を選択します。

    Logic Apps B2B ソリューションを追加するために選択された [作成] を示すスクリーンショット。

  7. ソリューションをインストールする Log Analytics ワークスペースを確認して確認し、もう一度 [作成 ] を選択します。

    [Logic Apps B2B ソリューション] ページを示すスクリーンショット。このページでは、サブスクリプションとプランを選択し、[作成] を選択できます。

    Azure は、Log Analytics ワークスペースを含む Azure リソース グループにソリューションをデプロイします。

  8. Log Analytics ワークスペースの [概要 ] ページの [ 概要 ] タブで、[ ソリューションの表示 ] をもう一度選択して、インストールされているソリューションを表示します。 ソリューション タイルを選択すると、メッセージの詳細が表示されます。

    ワークフローが B2B メッセージを処理すると、グラフはメッセージ数で更新されます。

    スクリーンショットは、メッセージの状態グラフを含むワークスペースの [概要] ページを示しています。

Azure Monitor ログを設定する

統合アカウントから直接 Azure Monitor ログを有効にすることができます。

  1. Azure portal で、統合アカウントを見つけて選択します。

    統合アカウントを選択できる [統合アカウント] ページを示すスクリーンショット。

  2. 統合アカウントのサイドバーの [ 監視] で、[ 診断設定] を選択します。 [ 診断設定 ] テーブルで、[ 診断設定の追加] を選択します。

    診断設定を追加できる [診断設定] ページを示すスクリーンショット。

  3. 設定を作成するには、次の手順に従います。

    1. [診断設定名] に名前を指定します。

    2. [宛先の詳細] で、[Log Analytics ワークスペースに送信する] を選択します。

    3. [サブスクリプション] で、Log Analytics ワークスペースの Azure サブスクリプションを選択します。

    4. Log Analytics ワークスペースの場合は、使用するワークスペースを選択します。

    5. [ ログ] で、記録するイベント カテゴリを指定する 統合アカウント追跡イベントを選択します。

    6. 完了したら、ツール バーの [保存] を選択 します。

    例えば次が挙げられます。

    診断データを収集するように Azure Monitor ログを設定できる [診断設定] ページを示すスクリーンショット。

メッセージの状態を表示する

ワークフローの実行後、パートナーが交換した B2B メッセージに関する状態とデータを表示できます。

  1. Azure portal の検索ボックスで、Log Analytics ワークスペースのリソース グループを見つけて開きます。

  2. リソース グループから、以前にインストールした Logic Apps B2B ソリューションを選択します。

  3. ソリューションサイドバーから[概要]を選択 します。

    ソリューションの [概要] ページを示すスクリーンショット。

    注

    実行後に Logic Apps B2B タイルに結果がすぐに表示されない場合は、ブラウザーを更新するか、しばらく待ってからやり直してください。

    既定では、 Logic Apps B2B タイルには 1 日に基づくデータが表示されます。 データ スコープを別の間隔に変更するには、ページの上部にあるスコープ コントロールを選択します。

    間隔を変更するコントロールを示すスクリーンショット。

  4. メッセージの状態ダッシュボードが表示されたら、特定のメッセージの種類の詳細を表示できます。1 日に基づいてデータが表示されます。 AS2、X12、または EDIFACT のタイルを選択します。

    状態メッセージを示すスクリーンショット。

    選択したタイルのメッセージの一覧が表示されます。 たとえば、AS2 メッセージ リストは次のようになります。

    AS2 メッセージの状態と詳細を示すスクリーンショット。

    各メッセージの種類のプロパティの詳細については、次のメッセージ プロパティの説明を参照してください。

AS2、X12、および EDIFACT メッセージのプロパティの説明と名前の形式

メッセージの種類ごとに、ダウンロードしたメッセージ ファイルのプロパティの説明と名前の形式を次に示します。

AS2 メッセージ プロパティの説明

各 AS2 メッセージのプロパティの説明を次に示します。

プロパティ Description
送信者 受信設定で指定されたゲスト パートナー、または AS2 契約の送信設定で指定されたホスト パートナー
受話器 受信設定で指定されたホスト パートナー、または AS2 契約の送信設定で指定されたゲスト パートナー
ロジック アプリ AS2 アクションが設定されているロジック アプリ
地位 AS2 メッセージの状態
成功 = 有効な AS2 メッセージを受信または送信しました。 メッセージ処理通知 (MDN) が設定されていません。
成功 = 有効な AS2 メッセージを受信または送信しました。 MDN が設定および受信されたか、または MDN が送信されました。
失敗 = 無効な AS2 メッセージを受信しました。 MDN は設定されていません。
保留中 = 有効な AS2 メッセージを受信または送信しました。 MDN が設定され、MDN が期待されています。
ACK MDN メッセージの状態
Accepted = 肯定的な MDN を受信または送信しました。
保留中 = MDN の受信または送信を待機しています。
Rejected = 否定的なMDN(メッセージ配信不能通知)を受信または送信しました。
Not Required = MDN が契約で設定されていません。
方向 AS2 メッセージの方向
追跡 ID ロジック アプリ内のすべてのトリガーとアクションを関連付ける ID
メッセージ ID AS2 メッセージ ヘッダーからの AS2 メッセージ ID
タイムスタンプ AS2 アクションがメッセージを処理した時刻

X12 メッセージ プロパティの説明

各 X12 メッセージのプロパティの説明を次に示します。

プロパティ Description
送信者 受信設定で指定されたゲスト パートナー、または X12 契約の送信設定で指定されたホスト パートナー
受話器 受信設定で指定されたホスト パートナー、または X12 契約の送信設定で指定されたゲスト パートナー
ロジック アプリ X12 アクションが設定されているロジック アプリ
地位 X12 メッセージの状態
成功 = 有効な X12 メッセージを受信または送信しました。 機能確認が設定されていません。
成功 = 有効な X12 メッセージを受信または送信しました。 機能確認が設定および受信されたか、または機能確認が送信されました。
失敗 = 無効な X12 メッセージを受信または送信しました。
保留中 = 有効な X12 メッセージを受信または送信しました。 機能確認が設定されており、機能確認が予測されています。
ACK 機能確認 (997) の状態
Accepted = 肯定的な機能確認を受信または送信しました。
拒否 = 否定的な機能応答を受信または送信しました。
[Pending] \(保留中) = 機能確認を予測していましたが、受信しませんでした。
[Pending] \(保留中) = 機能確認を生成しましたが、パートナーに送信できません。
[必要なし] = 機能確認が設定されていません。
方向 X12 メッセージの方向
追跡 ID ロジック アプリ内のすべてのトリガーとアクションを関連付ける ID
メッセージの種類 EDI X12 メッセージの種類
ICN X12 メッセージのインターチェンジ制御番号
TSCN X12 メッセージのトランザクション セット制御番号
タイムスタンプ X12 アクションがメッセージを処理した時刻

EDIFACT メッセージ プロパティの説明

各 EDIFACT メッセージのプロパティの説明を次に示します。

プロパティ Description
送信者 受信設定で指定されたゲスト パートナー、または EDIFACT 契約の送信設定で指定されたホスト パートナー
受話器 受信設定で指定されたホスト パートナー、または EDIFACT 契約の送信設定で指定されたゲスト パートナー
ロジック アプリ EDIFACT アクションが設定されているロジック アプリ
地位 EDIFACT メッセージの状態
成功 = 有効な EDIFACT メッセージを受信または送信しました。 機能確認が設定されていません。
成功 = 有効な EDIFACT メッセージを受信または送信しました。 機能確認が設定および受信されたか、または機能確認が送信されました。
失敗 = 無効な EDIFACT メッセージを受信または送信しました
Pending = 有効な EDIFACT メッセージを受信または送信しました。 機能確認が設定されており、機能確認が予測されています。
ACK 機能確認 (CONTRL) の状態
Accepted = 肯定的な機能確認を受信または送信しました。
拒否 = 否定的な機能応答を受信または送信しました。
[Pending] \(保留中) = 機能確認を予測していましたが、受信しませんでした。
[Pending] \(保留中) = 機能確認を生成しましたが、パートナーに送信できません。
[必要なし] = 機能確認が設定されていません。
方向 EDIFACT メッセージの方向
追跡 ID ロジック アプリ内のすべてのトリガーとアクションを関連付ける ID
メッセージの種類 EDIFACT メッセージの種類
ICN EDIFACT メッセージのインターチェンジ制御番号
TSCN EDIFACT メッセージのトランザクションセットの制御番号
タイムスタンプ EDIFACT アクションがメッセージを処理した時刻