適用対象: 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 ログを設定する方法について説明します。
詳細については、以下を参照してください。
- Azure Monitor の概要
- Azure Monitor ログの概要
- リソース ログの宛先
- Azure Monitor のログ クエリ
- 診断データを Azure Storage と Azure Event Hubs に送信する
注
この記事は最近、Log Analytics ではなく Azure Monitor ログという用語を使うように更新されました。 ログ データは引き続き Log Analytics ワークスペースに格納され、同じ Log Analytics サービスによって収集されて分析されます。 Azure Monitor のログの役割をより適切に反映させるために、用語を更新しています。 詳しくは、Azure Monitor の用語の変更に関するページをご覧ください。
[前提条件]
アクティブなサブスクリプションを持つ Azure アカウント。 サブスクリプションがない場合は、無料アカウントを作成してください。
Log Analytics ワークスペース。 Log Analytics ワークスペースがない場合は、「 Log Analytics ワークスペースの作成」を参照してください。
従量課金ロジック アプリ リソースで、Azure Monitor ログを設定済みであり、監視したい B2B メッセージを含むワークフローがあるもの。
ワークフローは、ログ情報を Log Analytics ワークスペースまたは必要な別の宛先に送信します。
ロジック アプリ リソースにリンクされている統合アカウント。
Logic Apps B2B ソリューションをインストールする
Azure Monitor ログでロジック アプリの B2B メッセージを追跡する前に、 Logic Apps B2B ソリューションを Log Analytics ワークスペースに追加します。
Azure portal の検索ボックスに「Log Analytics ワークスペース」と入力し、[Log Analytics ワークスペース] を選択します。
[Log Analytics ワークスペース] でワークスペースを選択します。
[ 概要 ] ページの [ Log Analytics の概要>監視ソリューションの構成] で、[ ソリューションの表示] を選択します。
[ 概要 ] ページで、[ 追加] を選択します。
Marketplace が開いたら、検索ボックスに「logic apps b2b」と入力し、Logic Apps B2B を選択します。
ソリューションの説明ウィンドウで、[ 作成] を選択します。
ソリューションをインストールする Log Analytics ワークスペースを確認して確認し、もう一度 [作成 ] を選択します。
Azure は、Log Analytics ワークスペースを含む Azure リソース グループにソリューションをデプロイします。
Log Analytics ワークスペースの [概要 ] ページの [ 概要 ] タブで、[ ソリューションの表示 ] をもう一度選択して、インストールされているソリューションを表示します。 ソリューション タイルを選択すると、メッセージの詳細が表示されます。
ワークフローが B2B メッセージを処理すると、グラフはメッセージ数で更新されます。
Azure Monitor ログを設定する
統合アカウントから直接 Azure Monitor ログを有効にすることができます。
Azure portal で、統合アカウントを見つけて選択します。
統合アカウントのサイドバーの [ 監視] で、[ 診断設定] を選択します。 [ 診断設定 ] テーブルで、[ 診断設定の追加] を選択します。
設定を作成するには、次の手順に従います。
[診断設定名] に名前を指定します。
[宛先の詳細] で、[Log Analytics ワークスペースに送信する] を選択します。
[サブスクリプション] で、Log Analytics ワークスペースの Azure サブスクリプションを選択します。
Log Analytics ワークスペースの場合は、使用するワークスペースを選択します。
[ ログ] で、記録するイベント カテゴリを指定する 統合アカウント追跡イベントを選択します。
完了したら、ツール バーの [保存] を選択 します。
例えば次が挙げられます。
メッセージの状態を表示する
ワークフローの実行後、パートナーが交換した B2B メッセージに関する状態とデータを表示できます。
Azure portal の検索ボックスで、Log Analytics ワークスペースのリソース グループを見つけて開きます。
リソース グループから、以前にインストールした Logic Apps B2B ソリューションを選択します。
ソリューションサイドバーから[概要]を選択 します。
注
実行後に Logic Apps B2B タイルに結果がすぐに表示されない場合は、ブラウザーを更新するか、しばらく待ってからやり直してください。
既定では、 Logic Apps B2B タイルには 1 日に基づくデータが表示されます。 データ スコープを別の間隔に変更するには、ページの上部にあるスコープ コントロールを選択します。
メッセージの状態ダッシュボードが表示されたら、特定のメッセージの種類の詳細を表示できます。1 日に基づいてデータが表示されます。 AS2、X12、または EDIFACT のタイルを選択します。
選択したタイルのメッセージの一覧が表示されます。 たとえば、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 アクションがメッセージを処理した時刻 |