在 Step Functions 控制台中查看和调试执行任务 - AWS Step Functions
界面概述

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

在 Step Functions 控制台中查看和调试执行任务

Step Functions 控制台上的执行详细信息 页面显示有关标准和快速工作流中过去和正在进行的状态机执行的信息。此信息以控制面板格式显示。例如，您可以找到状态机的 Amazon States 语言定义ARN、其执行状态和状态转换总数。您还可以查看状态机中任何单个状态的执行详细信息。

“执行详细信息”页面 – 界面概述

您可以在执行详细信息 页面上找到标准工作流和快速工作流中所有正在进行和过去的状态机执行的详细信息。如果您在启动执行时指定了执行 ID，则此页面的标题将使用该执行 ID。否则，该页面将以 Step Functions 自动生成的唯一执行 ID 为标题。

除了执行指标外，执行详细信息 页面还提供以下选项，用于管理状态机及其执行：

按钮 选择此按钮执行的操作：
编辑状态机 编辑状态机的 Amazon States Language 定义。
新执行 启动一个新的状态机执行。
操作

提供以下选项供选择：

  • 停止执行 – 停止正在进行的执行。此选项对已完成的执行不可用。

  • Redrive – Redrive过去 14 天内未成功完成的标准工作流执行。其中包括执行失败、中止或超时的执行。有关更多信息，请参阅 RedrivingStep Functions 中的状态机执行情况。

  • 导出-以JSON格式导出执行细节，以便与他人共享或执行离线分析。

  • 发送反馈 – 分享有关界面的反馈。
查看以版本或别名启动的执行

您还可以在 Step Functions 控制台中查看以版本或别名启动的执行。有关更多信息，请参阅列出版本和别名功能的执行。

执行详细信息 控制台页面包含下列部分：

  1. 执行摘要

  2. 错误消息

  3. 视图模式

  4. 步骤详细信息

  5. 事件

执行摘要

执行摘要 部分显示在执行详细信息 页面的顶部。本部分为您提供工作流的执行详细信息概览。此信息分为以下三个选项卡：

详细信息

显示诸如执行状态之类的信息ARN，以及执行开始和结束时间的时间戳。您还可以查看运行状态机执行时发生的状态转换的总数。如果您为状态机启用了跟踪或日志，则还可以查看 X-Ray 跟踪地图和 Amazon CloudWatch 执行日志的链接。

如果状态机执行由另一个状态机启动，则可以在此选项卡上查看父状态机的链接。

如果状态机执行了redriven，则此选项卡会显示redrive相关信息，例如Redrive计数。

执行输入和输出

显示状态机执行输入和输出 side-by-side。

定义

显示状态机的 Amazon States Language 定义。

错误消息

如果状态机执行失败，则执行详细信息 页面会显示一条错误消息。在错误消息中选择原因或查看步骤详细信息，查看执行失败的原因或导致错误的步骤。

如果您选择查看步骤详细信息，Step Functions 将在步骤详细信息、图表视图和表格视图选项卡中突出显示导致错误的步骤。如果步骤是已定义重试的 Task、Map 或 Parallel 状态，则步骤详细信息窗格将显示该步骤的重试选项卡。此外，如果已redriven执行，则可以在步骤详细信息窗格的重试次数和redrives选项卡中查看重试次数和redrive的详细信息。

通过此错误消息上的恢复下拉按钮，您可以redrive失败执行或启动新的执行。有关更多信息，请参阅 RedrivingStep Functions 中的状态机执行情况。

状态机执行失败的错误消息将显示在 “执行详细信息” 页面上。错误消息还将包含导致执行失败的步骤的链接。

视图模式

视图模式 部分包含状态机两种不同的可视化效果。您可以选择查看工作流的图形化表示、概述工作流状态的表格或与状态机执行相关的事件列表：

图表视图

图表视图模式显示工作流的图形化表示。底部包含一个图例，用于指示状态机的执行状态。它还包含用于放大、缩小、居中对齐整个工作流或在全屏模式下查看工作流的按钮。

在图表视图中，您可以选择工作流程中的任何步骤，以在步骤详细信息组件中查看有关其执行的详细信息。在图表视图中选择一个步骤后，表格视图也会显示该步骤。反之亦然。如果从表格视图中选择一个步骤，则图表视图将显示相同的步骤。

如果状态机包含 Map 状态、Parallel 状态或两者兼有，则可以在图表视图中查看它们在工作流中的名称。此外，对于 Map 状态，图表视图允许您在 Map 状态执行数据的不同迭代之间移动。例如，如果您的 Map 状态有五次迭代，并且您想要查看第三个和第四次迭代的执行数据，请执行以下操作：

  1. 选择要查看其迭代数据的 Map 状态。

  2. 在 Map 迭代查看器中，从下拉列表中选择 #2 来查看第三次迭代。这是因为迭代是从零开始计算的。同样，从下拉列表中选择 #3 表示 Map 状态的第四次迭代。

    或者，使用向上箭头图标和向下箭头图标控件在地图状态的不同迭代之间移动。

    注意

    如果您的状态机包含嵌套Map状态，则将显示父状态和子Map状态迭代的下拉列表以表示迭代数据。

  3. （可选）如果一次或多次 Map 状态迭代执行失败或停止执行，则可以通过在下拉列表的失败或中止下选择这些迭代编号来查看其数据。

最后，您可以使用 “导出” 和 “布局” 按钮将工作流程图表导出为SVG或PNG图像。您也可以在工作流的水平和垂直视图之间切换。

表视图

表格视图模式以表格形式显示工作流中的状态。在此视图模式下，您可以查看工作流程中执行的每个状态的详细信息，包括其名称、其使用的任何资源（例如 AWS Lambda 函数）的名称以及该状态是否成功执行。

在此视图中，您可以选择工作流中的任何状态，在步骤详细信息 组件中查看有关其执行的详细信息。当您在表格视图中选择一个步骤时，图表视图也会显示该步骤。反之亦然。如果您从图表视图中选择一个步骤，则表格视图将显示相同的步骤。

您还可以通过对视图应用筛选条件来限制在表格视图模式下显示的数据数量。您可以为特定属性创建筛选条件，例如状态或Redrive尝试。有关更多信息，请参阅 教程：在 Step Functions 中检查状态机的执行情况。

默认情况下，此模式显示名称、类型、状态、资源和之后开始列。您可以使用首选项对话框配置要查看的列。您在此对话框中所做的选择会持续用于将来的状态机执行，直到再次更改。

如果添加时间线列，则显示每个状态的执行持续时间相对于整个执行的运行时间的状况。它将以彩色编码的线性时间线显示。这可以帮助您识别特定状态执行中任何与性能相关的问题。时间线上每个状态的颜色编码段可帮助您识别该状态的执行状态，例如进行中、失败或中止。

例如，如果您在状态机中为某个状态定义了执行重试次数，则这些重试次数将显示在时间线中。红色段代表失败的 Retry 尝试，而浅灰色段代表每次 Retry 尝试之间的 BackoffRate。

表格视图的屏幕截图，时间轴上有颜色编码的分段。

如果状态机包含 Map 状态、Parallel 状态或两者兼有，则可以在工作流中以表格视图查看它们的名称。对于 Map 和 Parallel 状态，表格视图模式将其迭代和并行分支的执行数据显示为树形视图中的节点。您可以选择这些状态中的每个节点，在步骤详细信息 部分查看其各自的详细信息。例如，您可以查看导致状态失败的特定 Map 状态迭代的数据。展开 Map 状态的节点，然后在状态列中查看每次迭代的状态。

步骤详细信息

在图表视图或表格视图中选择状态时，步骤详细信息 部分将在右侧打开。该部分包含以下选项卡，可为您提供所选状态的详细信息：

输入

显示所选状态的输入详细信息。如果输入中有错误，则选项卡标题上会显示错误图标。此外，您还可以在此选项卡中查看错误的原因。

您也可以选择高级视图切换按钮，查看数据通过选定状态时的输入数据传输路径。您可以借此识别将一个或多个字段（例如 InputPath、Parameters、ResultSelector、OutputPath 和 ResultPath）应用于数据时，输入是如何被处理的。

输出

显示选定状态的输出。如果输出中有错误，则选项卡标题上会显示错误图标。此外，您还可以在此选项卡中查看错误的原因。

您也可以选择高级视图切换按钮，查看数据通过选定状态时的输出数据传输路径。您可以借此识别将一个或多个字段（例如 InputPath、Parameters、ResultSelector、OutputPath 和 ResultPath）应用于数据时，输入是如何被处理的。

详细信息

显示状态类型、执行状态和执行持续时间等信息。

对于使用资源的Task州（例如） AWS Lambda，此选项卡提供了指向资源定义页面和资源调用的 Amazon CloudWatch 日志页面的链接。它还会显示 Task 状态的 TimeoutSeconds 和 HeartbeatSeconds 字段的值（如果已指定）。

对于 Map 状态，此选项卡显示有关 Map 状态迭代总数的信息。迭代分为失败、中止、成功或。InProgress

定义

显示与所选状态对应的 Amazon States Language 定义。

重试
注意

仅当您在状态机 Task 或 Parallel 状态下定义了 Retry 字段时，才会显示此选项卡。

显示所选状态在最初执行尝试中的初始和后续重试次数。对于初次尝试和所有后续失败的尝试，请选择 “类型” 旁边的箭头图标以查看下拉框中显示的失败原因。如果重试成功，则可以查看出现在下拉框中的输出。

如果redriven了执行，则此选项卡标题将显示名称重试和redrives，并显示每次redrive的重试详细信息。

事件

显示与执行中选定状态关联的事件的筛选列表。此选项卡上的信息是事件 表格中完整执行事件历史记录的子集。

事件

事件表格以事件列表的形式，显示所选执行的完整历史记录，跨越多个页面。每页最多包含 25 个事件。此部分还显示事件总数，这可以帮助您确定是否超过了 2.5 万个事件的最大事件历史记录数。

示例屏幕截图显示了工作流程执行的部分事件历史记录。

默认情况下，事件表格中的结果根据事件的时间戳按升序显示。您可以通过单击时间戳列标题将执行事件历史记录的排序更改为降序。

在事件表格中，每个事件都采用颜色编码表示其执行状态。例如，失败的事件以红色显示。要查看有关事件的其他详细信息，请选择事件 ID 旁边的箭头图标。打开后，事件详细信息将显示事件的输入、输出和资源调用。

此外，在事件表格中，您可以应用筛选条件来限制显示的执行事件历史记录结果。您可以选择诸如 ID 或Redrive尝试之类的属性。有关更多信息，请参阅 教程：在 Step Functions 中检查状态机的执行情况。