“作业返回数据”页面详细介绍了已完成运行的每个作业的结果。可以使用此页面查看作业详细信息和读取作业的输出。SaltStack Config 包括多个自定义输出器,用于设置常见作业类型结果的格式。
作业用于运行远程执行任务、应用状态和启动 Salt 运行程序。有关详细信息,请参见作业。
可以查看给定工作节点或给定时间段的已完成作业列表。此外,还可以查看每个作业返回的详细报告。有关作业返回数据中所含自定义输出器的详细信息,请参见自定义输出器。
工作节点是运行工作节点服务的节点,可以侦听 Salt 主节点发出的命令并执行请求的任务。有关工作节点的详细信息,请参见工作节点。
按工作节点查看作业结果
要查看特定工作节点的作业结果,请执行以下操作:
- 转到工作节点工作区并选择一个工作节点 ID。
- 在详细信息页面中,选择活动选项卡。
活动选项卡在用户界面中显示针对所选工作节点运行的最近 500 个作业的列表。
- 选择要查看的作业返回的 JID。
按完成时间查看作业结果
要查看特定时间-日期范围的作业结果,请执行以下操作:
正在下载作业结果
要下载特定作业的作业结果,请执行以下操作:
- 单击一个 JID,按照以上部分所述的按工作节点或完成时间查看作业结果的步骤执行操作。
- 单击作业返回右上角的下载以打开一个菜单,然后选择 JSON。
.json
文件将开始下载到您的浏览器。
作业返回信息字段
作业结果页面显示有关所选作业运行的以下详细信息:
- 标题
- 作业结果页面的标题指明了作业的函数和作业 ID (JID)。
- 副标题
-
副标题因所执行作业的类型而异。副标题显示有关此作业运行的特定信息,其中可能包括:
- 作业名称
- 目标(例如所有工作节点)
- 发出作业的一个或多个 Salt 主节点
- 运行作业的用户的名称
- 返回详细信息
- 作业详细信息视图
-
通过从以下选项中进行选择更改返回数据格式。
- 汇总
- 作业的目标最小值列表。每个工作节点都包括其他详细信息,可以通过打开或关闭其相应的下拉列表进行查看。
- 自定义输出器
- 针对与作业关联的函数设计的自定义作业结果表示。有关详细信息,请参见 自定义输出器。
- 原始
- 格式最少的原始 JSON 数据结构。
- 作业信息
- 作业概要,包括应返回的工作节点以及未返回的工作节点。
自定义输出器
SaltStack Config 包括多个自定义输出器,用于设置常见作业类型结果的格式。输出器的名称因运行的作业或函数而异。可能的输出器标题包括:
- 状态作业
- test.ping
- disk.usage
- status.cpuinfo
- network.routes
- network.ipaddrs
- network.netstat
- cmd.run
- cmd.script
- pkg.list_pkgs
- 用户信息
自定义输出器示例
本部分包括精选的自定义作业返回输出器的示例。
状态作业
在运行状态作业时返回给定状态模块的结果,包括 state.sls
、state.highstate
state.apply
。状态函数是一种包含在状态模块中的函数,可以管理特定状态对系统的应用。状态函数会频繁调用一个或多个执行模块以执行给定任务。有关 Salt 状态的详细信息,请参见 Salt 文档:如何使用 Salt 状态?。有关作业的详细信息,请参见作业。
Test.ping
返回对目标组中的每个节点运行 test.ping
的结果。
磁盘使用情况
返回在目标组中的工作节点上挂载的卷的使用情况信息。
CPU 信息
此输出器包括不同视图,可以使用左列加以应用。
路由
从路由表返回当前配置的路由。
IP 地址
返回分配给主机的 IPv4 地址列表。
Netstat
交互式图形显示工作节点与 Salt 主节点之间的连接。
列示软件包
显示当前在每个分钟安装的软件包。
用户信息
返回目标工作节点上操作系统定义的用户组的信息。