你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

在 Azure 逻辑应用的标准工作流中监视和跟踪 B2B 事务(预览版)

适用于:Azure 逻辑应用(标准)

注释

此功能为预览版,受 Microsoft Azure 预览版补充使用条款限制。

若要确保业务运营顺利运行,保持合规性并排查 B2B 企业集成方案中的问题,需要准确可靠地跟踪流经集成解决方案的 B2B 事务。 如果标准逻辑应用工作流适用于 X12、EDIFACT 或 AS2 事务,则可以访问可靠的跟踪功能,从而有效地监视 B2B 交换。

使用高级级集成帐户,可以使用 Azure 数据资源管理器为标准工作流设置 B2B 跟踪。 此功能通过让 Azure 数据资源管理器将所有事务存储在群集和数据库中来准确跟踪所有 B2B 事务,从而提供无损失跟踪以及可视化和查询功能。

例如,您将获得一个跟踪信息面板,以便可以有效地监视、搜索和分析 B2B 交易。 若要进行更详细的分析,可以在群集数据库中创建高级查询。 使用 Azure 数据资源管理器中存储的跟踪数据,可以扩展 Microsoft Power BI 仪表板或使用数据生成自定义仪表板。

屏幕截图显示了 Azure 门户、高级集成帐户和 B2B 跟踪仪表板。

本指南简要概述了 B2B 跟踪的工作原理、如何为标准逻辑应用资源和工作流设置此功能,以及如何打开跟踪仪表板。

限制和已知问题

  • 在此预览版本中,跟踪当前仅处理 X12 和 AS2 事务。

B2B 跟踪的工作原理

下表介绍了各种组件如何协同工作以支持 B2B 跟踪:

组件 任务
跟踪数据生成和事件收集 发生 B2B 事务时,标准工作流中的 X12EDIFACTAS2 内置作将生成跟踪数据。
数据引入 生成的跟踪数据通过集成帐户直接推送到 Azure 数据资源管理器群集和数据库,该群集和数据库提供无损失且可靠的存储。
结构化存储 Azure 数据资源管理器提供快速索引和查询功能,可用于有效筛选、搜索和分析事务。
跟踪仪表板 此专用 B2B 监视仪表板可视化事务流,可帮助你跟踪确认,例如 MDN 和 997、检测故障以及实时解决问题。

先决条件

设置 B2B 跟踪

对于此任务,需要在集成帐户中创建跟踪存储。 集成帐户目前仅支持一个默认跟踪存储库。

为集成帐户创建跟踪存储库

  1. Azure 门户中,打开高级级集成帐户。

  2. 在集成帐户菜单中的 “设置”下,选择“ 跟踪存储”。

  3. 在工具栏中选择“添加”。“添加跟踪存储 ”窗格中,提供以下信息:

    资产 价值
    Subscription 您的 Azure 数据资源管理器群集的 Azure 订阅。
    Azure 数据资源管理器 Azure 数据资源管理器中的群集名称。
    数据库 群集数据库名称。

    例如:

    屏幕截图显示了 Azure 门户、高级集成帐户菜单,其中选择了名为“跟踪存储”的项、具有“添加”选项的工具栏,以及“添加跟踪存储”的打开窗格。

  4. 完成后,请选择“确定”

在协议级别禁用或启用 B2B 跟踪

如果集成帐户中的贸易合作伙伴之间已有协议,则可以针对每个协议禁用或重新启用跟踪。 默认情况下,会为协议启用跟踪。 目前,只能通过 JSON 视图禁用或重新启用协议跟踪。

  1. Azure 门户中,打开高级级集成帐户。

  2. 在集成帐户菜单上的 “设置”下,选择“ 协议”。 选择协议。

  3. “协议 ”页工具栏上,选择“ 编辑为 JSON”。

  4. 在协议中,查找 sendAgreementreceiveAgreement 对象。

  5. 若要禁用跟踪,请更改为 trackingStateDisabled. 若要重新启用跟踪,请更改为 trackingStateEnabled

有关详细信息,请参阅以下文档:

排查跟踪设置问题

若要使跟踪正常工作,请确保满足以下所有条件:

  • 集成帐户中存在跟踪存储。
  • 在协议中,属性 trackingState 设置为 Enabled.

打开跟踪仪表板

  1. 在使用跟踪仪表板之前,请确保工作流运行一些 X12、EDIFACT 或 AS2 内置操作,以便跟踪存储包含数据。

  2. 在集成帐户菜单中的 “监视”下,选择 “B2B 跟踪”,这会打开仪表板。

    默认情况下,“ 概述 ”选项卡处于选中状态,并显示一个概要摘要,其中包含所有受支持的消息类型、消息状态、具有最多错误的合作伙伴以及每个合作伙伴的消息摘要。

    选项卡 Description
    概述 查看所有支持的消息类型的概要摘要。
    AS2 查看所有收集的 AS2 事务的详细信息。
    X12 查看所有已收集的 X12 交易的详细信息。

    例如:

    屏幕截图显示了 Azure 门户、高级集成帐户、B2B 跟踪仪表板和所选的“概述”选项卡。

  3. 若要从默认值更改仪表板的时间间隔,请从 TimeRange 列表中选择所需的时间间隔。

  4. 若要查看所收集邮件的详细信息,请选择 AS2X12 选项卡。

    所选选项卡显示收集的邮件及其属性和值。

    以下示例显示了收集的 X12 消息的可用详细信息:

    屏幕截图显示了高级集成帐户,其中选择了 B2B 跟踪,以及一个表,其中包含有关收集的 X12 消息的详细信息。

数据库表

在 Azure 数据资源管理器群集中,数据库以表结构格式存储事务数据。 此表结构提供高效查询和检索 B2B 跟踪数据的功能,提供对消息流、处理状态和解决问题的结构化见解。

  • 名为 AS2TrackRecords 的 表存储 AS2 事务。
  • 名为 EdiTrackRecords 的表存储 X12 和 EDIFACT 事务。

注释

若要使用 Azure 逻辑应用 REST API 创建跟踪存储 ,必须先使用特定的 JSON 架构在 Azure 数据资源管理器数据库中手动创建两个名为 AS2TrackRecordsEdiTrackRecords 的表 来跟踪 B2B 事务。 数据库还必须向集成帐户资源授予“引入者”权限。

使用 REST API 管理跟踪存储

可以使用 Azure 逻辑应用 REST API 以编程方式创建、更新、删除和检索跟踪存储。

创建或更新跟踪存储

创建跟踪存储或更新现有存储。

注释

在此版本中,集成帐户当前仅支持一个跟踪存储。 在使用 Azure 逻辑应用 REST API 创建跟踪存储之前,必须先使用特定的 JSON 架构在 Azure 数据资源管理器数据库中手动创建名为 AS2TrackRecordsEdiTrackRecords 的两个表 来跟踪 B2B 事务。 数据库还必须向集成帐户资源授予“引入者”权限。

PUT https://management.azure.com/subscriptions/{subscription-ID}/resourceGroups/{resource-group-name}/providers/Microsoft.Logic/integrationAccounts/{integration-account-name}/groups/default/trackingstores/{tracking-store-name}?api-version=2016-06-01

请求正文

{ 
  "properties": {
    "adxClusterUri": "https://{cluster-name}.kusto.windows.net",
    "databaseName": "{database-name}"
  }
}
参数 Description
{subscription-ID} 与集成帐户关联的 Azure 订阅的 ID。
{resource-group-name} 集成帐户所在的资源组的名称。
{integration-account-name} 集成帐户的名称。
{tracking-store-name} 跟踪存储的名称。
{cluster-name} Azure 数据资源管理器中群集的名称。
{database-name} Azure 数据资源管理器群集中数据库的名称。

响应

返回已创建或更新的跟踪存储的详细信息。

获取特定的跟踪存储库

获取有关特定跟踪存储的详细信息。

GET https://management.azure.com/subscriptions/{subscription-ID}/resourceGroups/{resource-group-name}/providers/Microsoft.Logic/integrationAccounts/{integration-account-name}/groups/default/trackingstores/{tracking-store-name}?api-version=2016-06-01

Parameters:

参数 Description
{subscription-ID} 与集成帐户关联的 Azure 订阅的 ID。
{resource-group-name} 集成帐户所在的资源组的名称。
{integration-account-name} 集成帐户的名称。
{tracking-store-name} 跟踪存储的名称。

响应

返回有关指定跟踪存储库的详细信息。

获取所有跟踪存储

获取集成帐户中的所有跟踪存储。

注释

在此版本中,集成帐户当前仅支持一个跟踪存储。

GET https://management.azure.com/subscriptions/{subscription-ID}/resourceGroups/{resource-group-name}/providers/Microsoft.Logic/integrationAccounts/{integration-account-name}/groups/default/trackingstores?api-version=2016-06-01

参数 Description
{subscription-ID} 与集成帐户关联的 Azure 订阅的 ID。
{resource-group-name} 集成帐户所在的资源组的名称。
{integration-account-name} 集成帐户的名称。

响应

返回与集成帐户关联的跟踪存储系统的列表。

删除跟踪存储

从集成帐户中删除现有跟踪存储。

DELETE https://management.azure.com/subscriptions/{subscription-ID}/resourceGroups/{resource-group-name}/providers/Microsoft.Logic/integrationAccounts/{integration-account-name}/groups/default/trackingstores/{tracking-store-name}?api-version=2016-06-01

参数 Description
{subscription-ID} 与集成帐户关联的 Azure 订阅的 ID。
{resource-group-name} 集成帐户所在的资源组的名称。
{integration-account-name} 集成帐户的名称。
{tracking-store-name} 跟踪存储的名称。

响应

返回成功删除的跟踪存储的成功响应。