次の方法で共有


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 日に基づいてデータが表示されます。 AS2X12、または 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 アクションがメッセージを処理した時刻