Azure Monitor ログを設定し、Azure Logic Apps で B2B メッセージの診断データを収集する

  • [アーティクル]

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

注意

この記事は、従量課金プランのロジック アプリのみを対象としています。 Standard ロジック アプリの監視については、Standard ロジック アプリのデプロイ後に Application Insights を有効にしたり開いたりする方法に関するセクションを参照してください。

統合アカウントで取引先間の B2B 通信を設定すると、これらの取引先が AS2、X12、および EDIFACT などのプロトコルを使用してメッセージを交換できるようになります。 この通信が期待どおりに動作することを確認するには、統合アカウントの Azure Monitor ログを設定します。 Azure Monitor を使用すると、クラウド環境とオンプレミス環境を監視して、可用性とパフォーマンスをより簡単に維持することができます。 Azure Monitor ログを使用すると、トリガー イベント、実行イベント、アクション イベントなどのランタイム データやイベントに関するデータを、Log Analytics ワークスペースに記録して格納することができます。 メッセージの場合、ログは次のような情報も収集します。

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

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

統合アカウントのログ記録を設定するには、Azure portal で Logic Apps B2B ソリューションをインストールします。 このソリューションは、B2B メッセージ イベントの集約情報を提供します。 次に、この情報に対してログの記録とクエリの作成を有効にするために、Azure Monitor ログを設定します。

この記事では、統合アカウントの 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 workspaces」と入力し、[Log Analytics ワークスペース] を選択します。

    [Log Analytics ワークスペース] を選択する

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

    Log Analytics ワークスペースを選択する

  3. [概要] ウィンドウで [Log Analytics の使用を開始する]、[監視ソリューションの構成] の順に選択し、[ソリューションの表示] を選択します。

    [概要] ウィンドウで [ソリューションの表示] を選択する

  4. [概要] ウィンドウで、 [追加] を選択します。

    [概要] ウィンドウで新しいソリューションを追加する

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

    Marketplace から [Logic Apps 管理] を選択する

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

    [作成] を選択して [Logic Apps B2B] ソリューションを追加する

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

    [Logic Apps B2B] の [作成] を選択する

    Log Analytics ワークスペースが含まれる Azure リソース グループに Azure によってソリューションがデプロイされると、ワークスペースの [概要] ウィンドウにソリューションが表示されます。 B2B メッセージが処理されると、このウィンドウのメッセージ数が更新されます。

    ワークスペースの [概要] ウィンドウ

Azure Monitor ログを設定する

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

  1. Azure ポータルで、統合アカウントを検索して選択します。

    統合アカウントを探して選択する

  2. 統合アカウントのメニューにある [監視] から、 [診断設定] を選択します。 [診断設定の追加] を選択します。

    [監視] で [診断設定] を選択する

  3. 設定を作成するには、次の手順を実行します。

    1. 設定の名前を入力します。

    2. [Log Analytics への送信] を選択します。

    3. [サブスクリプション] では、Log Analytics ワークスペースに関連付けられている Azure サブスクリプションを選択します。

    4. [Log Analytics ワークスペース] では、使用するワークスペースを選択します。

    5. [ログ] にある [IntegrationAccountTrackingEvents] カテゴリを選択します。これは、記録するイベント カテゴリを指定します。

    6. 終了したら、 [保存] を選択します。

    次に例を示します。

    診断データを収集するように Azure Monitor ログを設定する

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

ロジック アプリが実行されると、それらのメッセージに関する状態とデータを Log Analytics ワークスペースに表示できます。

  1. Azure portal の検索ボックスで、Log Analytics ワークスペースを探して開きます。

  2. ワークスペースのメニューで、[ワークスペースの概要]>[Logic Apps B2B] を選択します。

    ワークスペースの [概要] ウィンドウ

    Note

    実行後すぐに [Logic Apps B2B] タイルに結果が表示されない場合は、 [最新の情報に更新] を選択するか、しばらく待ってから再試行してください。

    既定では、 [Logic Apps B2B] タイルには 1 日に基づいたデータが表示されます。 データの範囲を異なる間隔に変更するには、ページの上部にある範囲コントロールを選択します。

    間隔を変更する

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

    メッセージの状態の表示

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

    AS2 メッセージの状態と詳細

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

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

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

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

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

プロパティ 説明
送信者 [受信設定] で指定されているゲスト パートナー、または AS2 契約の [送信設定] で指定されているホスト パートナー
受信者 [受信設定] で指定されているホスト パートナー、または AS2 契約の [送信設定] で指定されているゲスト パートナー
ロジック アプリ AS2 アクションが設定されているロジック アプリ
Status AS2 メッセージの状態
[成功] = 有効な AS2 メッセージを受信または送信しました。 MDN が設定されていません。
[成功] = 有効な AS2 メッセージを受信または送信しました。 MDN が設定および受信されたか、または MDN が送信されました。
[失敗] = 無効な AS2 メッセージを受信しました。 MDN が設定されていません。
[Pending] \(保留中) = 有効な AS2 メッセージを受信または送信しました。 MDN が設定されており、MDN が予測されています。
ACK MDN メッセージの状態
[承認済み] = 肯定の MDN を受信または送信しました。
[Pending] \(保留中) = MDN の受信または送信を待機しています。
[拒否] = 否定の MDN を受信または送信しました。
[必要なし] = MDN が契約で設定されていません。
方向 AS2 メッセージの方向
追跡 ID ロジック アプリ内のすべてのトリガーとアクションを関連付ける ID
メッセージ ID AS2 メッセージ ヘッダーからの AS2 メッセージ ID
Timestamp AS2 アクションがメッセージを処理した時間

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

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

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

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

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

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

次のステップ