在 Step Functions 控制台中查看执行详情 - Amazon Step Functions
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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

在 Step Functions 控制台中查看执行详情

您可以在 Step Functions 控制台的 “执行” 部分中查看工作流程的正在执行和过去的执行情况。

执行详细信息中,您可以查看状态机的定义、执行状态ARN、状态转换次数以及工作流中各个状态的输入和输出。

显示处决清单的说明性屏幕截图。

标准工作流程执行详细信息记录在 Step Functions 中,但是 Express 工作流程执行的历史记录不是。要记录 Express 工作流程执行情况,您必须将 Express 状态机配置为向亚马逊发送日志 CloudWatch。登录 CloudWatch 日志要设置 Step Functions 的日志记录,请参阅。

查看这两种类型的工作流程执行的控制台体验类似,但是 Express 工作流程存在一些限制。请参阅 标准版和 Express 主机体验差异

注意

由于 Express 工作流程的执行数据是使用 L CloudWatch ogs Insights 显示的,因此扫描日志将产生费用。默认情况下,您的日志组仅列出最近三个小时内完成的执行。如果您指定较大的时间范围,包括更多的执行事件,则成本将会增加。有关更多信息,请参阅 “CloudWatch 定价” 页面上 “” 选项卡下的 “销售日志”。

执行详情概述

执行详情链接和页面标题使用 Step Functions 生成的唯一执行 ID 或您在启动工作流程时提供的自定义 ID。“执行详细信息” 页面包含用于管理状态机的指标和以下选项:

  • 停止执行 – 停止正在进行的执行。(不适用于已完成的执行。)

  • 开始新的执行 — 启动状态机的新执行

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

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

查看以版本或别名启动的执行

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

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

执行摘要

执行摘要在以下选项卡中概述了工作流程的执行细节:

详细信息

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

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

如果你的状态机执行是 redriven,将显示此选项卡 redrive 相关信息,例如 Redrive 计数

执行输入和输出

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

定义

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

错误消息

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

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

从此错误消息上的 “恢复” 下拉按钮中,您可以 redrive 您的执行失败或开始新的执行。有关更多信息,请参阅 Redriving 状态机

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

视图模式

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

图表视图

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

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

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

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

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

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

    注意

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

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

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

表视图

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

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

您还可以通过对视图应用筛选条件来限制在表格视图模式下显示的数据数量。您可以为特定属性创建筛选器,例如状态Redrive 尝试。有关更多信息,请参阅 检查处决情况

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

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

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

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

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

步骤详细信息

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

输入

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

您也可以选择高级视图切换按钮,查看数据通过选定状态时的输入数据传输路径。您可以借此识别将一个或多个字段(例如 InputPathParametersResultSelectorOutputPathResultPath)应用于数据时,输入是如何被处理的。

输出

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

您也可以选择高级视图切换按钮,查看数据通过选定状态时的输出数据传输路径。您可以借此识别将一个或多个字段(例如 InputPathParametersResultSelectorOutputPathResultPath)应用于数据时,输入是如何被处理的。

详细信息

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

对于使用资源的Task州,例如 Amazon Lambda,此选项卡提供资源定义页面和资源调用的 Amazon CloudWatch 日志页面的链接。它还会显示 Task 状态的 TimeoutSecondsHeartbeatSeconds 字段的值(如果已指定)。

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

定义

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

重试
注意

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

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

如果你有 redriven 你的执行,这个选项卡标题显示名字 Retries & redrives并显示每个重试的详细信息 redrive.

事件

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

事件

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

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

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

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

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

标准版和 Express 主机体验差异

标准工作流

标准工作流的执行历史记录始终可查看过去 90 天内完成的执行。

快速工作流

对于 Express 工作流程,Step Functions 控制台检索通过 CloudWatch 日志日志组收集的日志数据以显示执行历史记录。默认情况下,可以查看过去三个小时内完成的执行的历史记录。您可以自定义时间范围。如果您指定的时间范围更大,包括更多的执行事件,则扫描日志的成本将增加。有关更多信息,请参阅 “CloudWatch 定价” 页面上 “” 选项卡下的 “销售日志” 和。登录 CloudWatch 日志

查看快速工作流执行的注意事项和限制

在 Step Functions 控制台上查看 Express 工作流程执行时,请记住以下注意事项和限制:

Express 工作流程执行详情的可用性依赖于 Amazon CloudWatch 日志

对于 Express 工作流程,其执行历史和详细的执行信息是通过 CloudWatch Logs Insights 收集的。此信息保存在您在创建状态机时指定的 CloudWatch 日志组中。状态机的执行历史记录显示在 Step Functions 控制台的执行选项卡下。

警告

如果您删除 Express 工作流程的 CloudWatch 日志,它将不会列在 “执行” 选项卡下。

我们建议您使用默认的日志级别ALL来记录所有执行事件类型。编辑现有状态机时,可以根据需要更新它们的日志级别。有关更多信息,请参阅在 Step Functions 中使用 CloudWatch 日志记录执行历史记录事件日志级别

如果日志级别为ERROR或,则可获得部分 Express 工作流程执行详细信息 FATAL

默认情况下,Express 工作流程执行的日志级别设置为ALL。更改日志级别,不会影响已完成执行的执行历史记录和执行详细信息。但是,所有新的执行都将根据更新的日志级别发出日志。有关更多信息,请参阅在 Step Functions 中使用 CloudWatch 日志记录执行历史记录事件日志级别

例如,如果您将日志级别从ALL或更改为ERRORFATAL,Step Functions 控制台上的执行选项卡将仅列出失败的执行。在事件视图选项卡中,控制台仅显示失败的状态机步骤的事件详细信息。

我们建议您使用默认的日志级别ALL来记录所有执行事件类型。编辑状态机时,您可以根据需要更新现有状态机的日志级别。

修改状态机后,无法查看先前执行的状态机定义

Express 工作流程不会存储过去执行的状态机定义。如果更改状态机定义,则只能使用最新定义查看执行的状态机定义。

例如,如果您从状态机定义中移除一个或多个步骤,Step Functions 会检测到定义与先前的执行事件不匹配。由于快速工作流不存储以前的定义,因此 Step Functions 无法显示在状态机定义早期版本上运行的状态机定义。因此,“定义”、“图表视图” 和 “表视图” 选项卡不可用于在先前版本的状态机定义上运行的执行。