请参阅 Application Integration 支持的连接器。

查看执行日志

Application Integration 会为集成的每次运行生成执行日志消息。日志消息中包含的信息可帮助确定集成中每个步骤的状态，或对失败的集成、任务或事件进行问题排查。如需详细了解 Application Integration 中的日志记录，请参阅日志简介。

注意：Application Integration 会将集成的执行日志最多保留 32 天。

查看集成执行日志

如需查看执行日志页面，请选择以下选项之一：

控制台

1. 在 Application Integration 中，转到日志页面。

   转到 Application Integration 日志

2. 在导航菜单中，点击日志。或者，在导航菜单中，点击集成，然后选择要查看其日志的集成。然后，点击 查看此集成的执行日志。系统会显示执行日志页面。
   注意：如果执行日志大小超过 300 MB，Application Integration 会抛出 Response size too large 错误，并且不会在执行日志页面上加载日志。在这种情况下，请使用 API 标签页中所述的 projects.locations.integrations.executions.list 方法。
3. 从区域列表中，选择区域以查看集成的区域特定执行日志。您还可以点击 refresh 刷新日志以重新加载当前日志列表。

   下图显示了一个示例 Application Integration 执行日志页面。

   

   每个执行日志消息都会显示以下属性。

   • 集成名称：集成的名称。
   • 执行 ID：为集成的每次运行生成的唯一标识符。
   • 状态：集成执行的状态。
     • 正在进行：表示集成目前正在执行。
     • 成功：表示集成已成功执行。
     • 失败：表示集成执行失败。
     • 已取消：表示用户已取消集成执行。
     • 暂停：表示集成执行已暂停，正在等待事件或操作完成。
     • 暂停重试：表示集成执行失败，正在等待重试。
     • 已暂停：表示集成执行已暂停，需要人工干预才能继续集成。
   • 开始时间：集成开始执行时的时间戳。
   • 时长：执行集成所花费的时间。
     注意：请勿使用时长值计算集成的端到端执行延迟。 时长列中显示的时间并不反映集成的总执行时间，因为它不考虑集成在执行之前或之后所花费的任何额外时间。例如，配额强制执行或身份验证所花费的时间不会反映在时长值中。
   • 集成版本：所执行集成的版本。
   • 触发器 ID：触发器的 ID 值。
   • Cloud Logging：指示集成是否配置为将日志记录到 Cloud Logging。如果已启用 Cloud Logging，此字段会提供用于在 Cloud Logging 中查看日志的链接。如果 Cloud Logging 未启用，则此字段会设置为已停用。
   • 重放自：如果集成执行已重放，此字段会提供已重放的执行的执行 ID。如果您想重新运行集成作业且使用的参数与之前的执行作业相同，可以重放已发布的集成执行作业。例如，如果集成因超时错误而失败，或者集成的输出不符合预期，您可以重放执行。如需了解如何重放执行作业，请参阅重放执行作业。

4. 在过滤条件字段中，添加过滤条件。您可以根据集成名称、执行 ID、日期或时间范围、执行状态、变量类型以及变量名称或值等条件过滤日志。 如需自定义程度更高的搜索，请使用 API 标签页中所述的 projects.locations.integrations.executions.list 方法。

   如需为测试用例执行添加过滤条件，请使用以下格式：

   Integration name:INTEGRATION_NAME:TEST_CASE_NAME。

   替换以下内容：

   • INTEGRATION_NAME：包含功能测试的集成名称。
   • TEST_CASE_NAME：您要列出其测试执行的测试用例的名称。

   例如 Integration name:example-integration-name:example-test-case。

API

如果执行日志的大小超过 300 MB，Application Integration 将抛出 Response too large error 错误，并且不会在执行日志页面上加载日志。在这种情况下，您必须使用 projects.locations.integrations.executions.list 方法来获取日志。如需使用 API 方法查看日志，请按以下步骤操作：

1. 如需获取要查看其执行日志的执行 ID，请使用 projects.locations.integrations.executions.list 方法构建一个 GET 请求，并将 snapshotMetadataWithoutParams 参数设置为 TRUE：

   curl -v -X -G GET
       -H "Content-Type: application/json"
       -H "Authorization: Bearer $(gcloud auth print-access-token)"
       -d 'snapshotMetadataWithoutParams=true'
       'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/executions'
   

   响应中会返回执行 ID。复制要查看其日志的执行 ID。

2. 要获取该执行 ID 的执行日志，请使用 projects.locations.integrations.executions.list 方法构建一个 POST 请求，并对您在上一步中复制的执行 ID 进行过滤：

   curl -v -X -G GET 
       -H "Content-Type: application/json"
       -H "Authorization: Bearer $(gcloud auth print-access-token)"
       -d 'filter=execution_id="EXECUTION_ID"'
       'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/executions'
   

   在响应中，查看 ExecutionDetails 字段以查看日志详细信息。

   或者，在 Google Cloud 控制台中，您可以按执行 ID 过滤执行日志。

示例：过滤日志

如果要过滤响应以列出一个集成预期的所有集成的日志，请使用以下格式：

curl -v -X -G GET 
    -H "Content-Type: application/json"
    -H "Authorization: Bearer $(gcloud auth print-access-token)"
    -d 'filter= workflowName!="INTEGRATION_NAME"'
    'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/-/executions'

使用日志进行问题排查

以下部分介绍了如何使用应用集成执行日志排查失败问题。

排查集成失败问题

在对失败的集成运行进行问题排查时，执行日志消息非常有用。

例如，如果集成未能在特定时间范围内运行，请按照以下步骤访问和过滤日志以排查失败问题：

1. 从集成列表中搜索或选择要进行问题排查的集成，然后点击以打开集成编辑器。
2. 点击集成编辑器工具栏中的日志以查看日志消息。
3. 在执行日志过滤条件字段中，选择集成名称，然后输入要查看其日志的集成的名称。
4. 点击 Enter 键。
5. 如需显示失败的集成，请在执行日志过滤条件字段中选择执行状态以显示状态列表，然后选择失败。
6. 要显示特定时间范围之间失败的集成，请在执行日志过滤条件字段中，选择开始日期晚于，并以有效格式输入所需时间。然后，选择结束日期早于并输入所需时间。默认情况下，多个过滤器使用 AND 条件组合。

如果在过滤时间范围内集成失败，执行日志页面将显示日志消息列表。每个日志消息都对应集成的失败运行作业。

查看堆栈轨迹异常

如需查看异常列表，请点击任一日志消息。点击每个异常消息中的链接可查看异常的堆栈轨迹。

注意：执行日志消息事件参数（字符串或 JSON）会被截断，上限为 2000 个字符。

跟踪连接器故障

您可以使用执行日志消息来排查和跟踪失败连接器任务的执行情况。失败连接器任务的日志数据使用 Cloud Logging 进行存储，并且可以在 Logs Explorer 中查看。

注意：只有为 Integration Connectors 中的相应连接启用了 Cloud Logging 后，Logs Explorer 中才能显示失败连接器任务的日志数据。如需了解详情，请参阅查看连接器日志。

若要从应用集成访问失败连接器任务的日志数据，请执行以下步骤：

1. 进入所需集成的执行日志页面。
2. 展开失败执行的日志消息，并将堆栈轨迹展开至包含失败连接器任务的行。
3. 在状态列中，点击失败。

   

Application Integration 会自动为失败的连接器任务运行所需的查询，并打开 Logs Explorer 页面以显示详细的执行日志数据。

如需手动检索失败连接器任务的日志数据，您可以在 Logs Explorer 的查询页面中运行以下查询。如需详细了解如何使用 Logs Explorer，请参阅 Logs Explorer 界面。

查询格式

resource.type="connectors.googleapis.com/Connection"
jsonPayload.integration_connectors_trace_id="EXECUTION_ID_EXECUTION_TASK_ID_EXECUTION_ATTEMPT_NUMBER"

示例

resource.type="connectors.googleapis.com/Connection"
jsonPayload.integration_connectors_trace_id="9db51e4b-7d57-473d-931f-cc27b282dfad_1_2"

限制

• 如果为集成停用了本地日志记录，则系统不会为该集成生成执行日志。

后续步骤

• 如需了解 Application Integration 中的日志，请参阅日志简介。
• 了解测试用例。