xymon - 云端在线

程序：

您的姓名

xymon - Xymon 客户端通信程序

概要

西门 [选项] 接受者 的话

商品描述

西门(1) 是用于与 Xymon 服务器通信的客户端程序。 它经常
Xymon 客户端系统使用它在本地测试中发送状态消息和寻呼机警报。

在 Xymon 中，xymon 程序也用于管理目的，例如重命名或
删除主机，或禁用长时间停机的主机。

配置 AND 有无库存

-调试
启用调试。 这会打印出有关如何连接到 Xymon
服务器正在建立。

--代理=http://PROXYSERVER：代理端口/
通过 HTTP 发送状态消息时，请使用此服务器作为 HTTP 代理
直接连接到 Xymon 服务器。

--超时=N
指定连接到 Xymon 服务器的超时时间，以秒为单位。 默认的
是5秒。

- 回复
xymon 实用程序通常知道什么时候期待来自服务器的响应，所以这
选项不是必需的。 但是，它会导致来自服务器的任何响应
显示。

- 合并
将命令行消息文本与标准输入上提供的数据合并，以及
将结果发送到 Xymon 服务器。 命令行上提供的消息文本
成为合并消息的第一行。

接受者
接受者 参数定义哪个服务器接收消息。 如果收件人是
指定为“0.0.0.0”，则消息将发送到列在列表中的所有服务器
XYMSERVERS 环境变量。

通常，客户端将使用“$XYMSRV”作为 接受者 参数，因为这是
为客户端脚本定义以自动包含正确的值。

接受者 参数可以是具有 xymoncgimsg.cgi 的网络服务器的 URL
或类似的脚本安装。 这会将 Xymon 消息通过隧道传输到 Xymon 服务器
使用标准的 HTTP 协议。 这 xymoncgimsg.cgi文件(8) CGI 工具（包含在 Xymon 中）
必须在网络服务器上安装 HTTP 传输才能工作。

MESSAGE
的话 参数是要发送到 Xymon 服务器的消息。
消息必须用引号括起来，但这样做可以跨越多行。
消息的最大大小由您的最大允许长度定义
shell 的命令行，通常为 8-32 KB。

如果需要发送更长的状态消息，可以指定“@”作为消息：
xymon 然后将从其标准输入读取状态消息。

西蒙 MESSAGE 句法

本节列出了 Xymon 协议中最常用的消息。

每条消息都必须以 Xymon 命令之一开头。 在指定 HOSTNAME 的地方，它
如果启用了 Xymon FQDN 设置，则主机名中的任何点都必须更改为逗号
（这是默认设置）。 例如，主机“www.foo.com”将报告为
“www，foo，com”。

status[+LIFETIME][/group:GROUP] HOSTNAME.TESTNAME COLOR
这会为单个主机上的单个测试（列）发送状态消息。
TESTNAME 是将显示此测试的列的名称； 任何名称都是有效的
除了在测试名称中使用点不起作用。 颜色必须是其中之一
有效颜色：“green”、“yellow”、“red”或“clear”。 颜色“蓝色”和“紫色”
- 尽管颜色有效 - 不应在状态消息中发送，因为这些是
由 Xymon 服务器专门处理。 作为特殊情况（用于支持较旧的
客户），“客户”可以用作颜色的名称。 这导致状态
Xymon 作为“客户端”数据消息处理的消息，以及 TESTNAME
参数用作“收集器 ID”。
“附加文本”通常包括本地时间戳和测试摘要
结果在第一行。 第一行之后的任何行都是自由格式的，并且可以
包括可能有助于诊断所报告问题的任何信息。
LIFETIME 定义了此状态在被接收器接收后的有效时间。
赛蒙服务器。 默认为 30 分钟，但您可以设置任何您喜欢的时间段。 例如
对于每小时运行一次的自定义测试，您需要将其设置为至少 60
分钟 - 否则状态将在 30 分钟后变为紫色。 这是个好主意
将 LIFETIME 设置为略长于测试之间的间隔，以
允许完成测试所需的时间有所不同。 生命周期在
分钟，除非您在之后立即添加“h”（小时）、“d”（天）或“w”（周）
数字，例如“status+5h”表示有效期为 5 小时的状态。
GROUP 选项用于将警报从状态定向到特定组。 它
当前用于从 Xymon 客户端数据生成的状态，例如用于指导
向不同的人发出“procs”状态的警报，具体取决于哪个进程
下来了。

通知 HOSTNAME.TESTNAME
这会触发一条信息性消息发送给那些收到警报的人
这个 HOSTNAME+TESTNAME 组合，根据定义的规则 警报.cfg(5)
这是由 enadis.cgi文件(1) 通知人们有关主机被禁用的工具
或启用，但也可以作为通知服务器管理员的一般方式。

数据主机名.数据名
“数据”消息允许工具发送有关主机的数据，而不会显示为
Xymon 网页上的一栏。 例如，这用于报告统计信息
关于主机，例如 vmstat 数据，它本身并不代表某些东西
具有红色、黄色或绿色标识。 它由 RRD 底部馈线模块使用，其中
其他。 在 Xymon 中，默认情况下数据消息仅由 xymond_rrd(8)
模块。 如果您想使用外部应用程序处理数据消息，您可以
想要启用 xymond_文件存储(8) 用于数据消息的模块，用于存储数据-
以与 Big Brother 守护程序的方式兼容的格式发送消息。

禁用 HOSTNAME.TESTNAME DURATION
在 DURATION 分钟内禁用特定测试。 这会导致这个状态
测试在 Xymon 服务器上列为“蓝色”，并且此主机/测试没有警报
会生成。 如果 DURATION 以数字形式给出，后跟 s/m/h/d，则为
分别解释为秒/分钟/小时/天。 禁用一个
测试直到它变得OK，使用“-1”作为DURATION。 禁用所有测试
主机，对 TESTNAME 使用星号“*”。

启用 HOSTNAME.TESTNAME
重新启用已禁用的测试。

查询 HOSTNAME.TESTNAME
查询 Xymon 服务器以获取针对此特定测试报告的最新状态。 如果
主机/测试状态已知，响应是状态报告的第一行
- 当前颜色将是该行的第一个单词。 额外的文本行
无法检索状态消息中可能出现的信息。
这允许任何 Xymon 客户端确定特定测试的状态，是否
它与运行客户端的主机、其他主机有关，或
也许是来自由管理的多个主机的组合测试的结果 组合状态(1)
这通常对 Xymon 客户端扩展脚本很有用，需要
确定其他主机的状态，例如，决定是否自动
应启动恢复行动。

配置文件名
从服务器检索 Xymon 配置文件之一。 该命令允许
一个客户端从服务器上的 $XYMONHOME/etc/ 目录中提取文件，允许
用于客户端配置的半自动更新。 由于配置
文件被设计成有一个公共文件，用于配置所有主机
系统 - 这实际上是配置客户端的推荐方式 - 这
使保持配置文件同步更容易。

删除主机名
删除存储的有关主机 HOSTNAME 的所有数据。 假设你有
已经从 hosts.cfg 配置文件中删除了主机。

删除 HOSTNAME TESTNAME
删除有关单个测试（列）的数据。

重命名 OLDHOSTNAME NEWHOSTNAME
重命名已更改名称的主机的所有数据。 你应该这样做
更改 hosts.cfg 配置文件中的主机名。

重命名 HOSTNAME OLDTESTNAME NEWTESTNAME
重命名有关单个测试（列）的数据。

xymondlog 主机名.TESTNAME
检索单个测试的 Xymon 状态日志。 响应的第一行
包含一系列由管道符号分隔的字段：

主机 主机名

测试名称 测试名称

颜色 状态颜色（绿色、黄色、红色、蓝色、透明、紫色）

测试标志 对于网络测试，指示有关测试的详细信息的标志（由
xymongen）。

最后一次变更 上次更改状态颜色时的 Unix 时间戳。

登录时间 收到日志消息时的 Unix 时间戳。

有效时间 日志消息不再有效时的 Unix 时间戳（在
这次）。

确认时间 活动确认到期时的 -1 或 Unix 时间戳。

禁用时间 状态不再禁用时的 -1 或 Unix 时间戳。

寄件人 接收状态的 IP 地址。

饼干 -1 或用于确认警报的 cookie 值。

确认信息 Empty 或确认状态时发送的确认消息。
换行符、管道符号和反斜杠用反斜杠转义，C 风格。

取消消息 空或状态禁用时发送的消息。 换行符，管道标志
和反斜杠用反斜杠转义，C 风格。

第一行之后是纯文本格式的完整状态日志。

xymondxlog 主机名.TESTNAME
使用“xymondlog”命令检索包含状态日志的 XML 字符串。

xymondboard [标准] [字段=FIELDLIST]
检索 Xymon 守护程序可用的所有已知测试的状态摘要。

默认情况下 - 如果未提供 CRITERIA - 它为所有状态返回一行
在 Xymon 中找到的消息。 您可以通过选择特定的过滤响应
页面、主机、测试、颜色或其他各种领域。 PAGEPATH、网络、主机名、
TESTNAME 和 *MSG 参数被解释为与 perl 兼容的正则表达式；
COLOR 参数接受以逗号分隔的多种颜色； *TIME 值
接受 Unix 纪元时间戳。 中确定的其他变量 赛蒙-xmh(5) 也可以
使用。

因为主机过滤是在测试过滤之前完成的，所以效率更高（与
非常大的数据集）使用 PAGEPATH、HOSTNAME、NETWORK 和其他 XMH_ 过滤器
如果可能，在使用 COLOR、*MSG、*TIME 或 TESTNAME 进行全局过滤之前。

例如，您可以过滤主机名和测试名。

页=PAGEPATH 仅包括来自在 PAGEPATH 页面上找到的主机的测试
hosts.cfg 文件。

网络=网络 仅包含来自具有此 NET: 标记的主机的测试

ip=ip地址仅包括来自具有此 IP 地址的主机的测试。 这是一个正则表达式，
不是 CIDR。

主机=主机名 仅包含来自主机 HOSTNAME 的测试

测试=测试名称 仅包含测试名称为 TESTNAME 的测试

颜色=颜色名称 仅包括状态颜色为 COLORNAME 的测试

标签=TAGNAME 仅包含具有特定标签的主机 主机配置文件(5)
线。 请注意，此处仅包含 xymon 组件已知的项目； 随意的
文本不包括在内

XMH_string=值 仅包括具有 赛蒙-xmh(5) 匹配 this 的变量
折扣值

进阶筛选

味精=信息 仅包括具有完整内容匹配 MESSAGE 的测试。 使用“\s”
转义空格（或其他 PCRE 字符串）

确认消息=消息 仅包括带有确认消息的测试。 使用“\s”
转义空格（或其他 PCRE 字符串）

dismsg=消息 仅包括已禁用字符串匹配的测试
信息。 使用“\s”来转义空格（或其他 PCRE 字符串）。 （这是最有效的
将其与 color=blue 配对。）

时间戳过滤器

某些字段（如下所述）可以使用 unix 时间戳和
以下不等式： >= > <= < = !=

这些过滤器是：lastchange、logtime、validtime、acktime、disabletime

对于与 CRITERIA 或所有状态匹配的每个状态，响应为一行
如果没有指定标准。 该行由多个字段组成，分隔
通过管道标志。 您可以通过在
字段列表。 以下字段可用：

主机 主机名

测试名称 测试名称

颜色 状态颜色（绿色、黄色、红色、蓝色、透明、紫色）

标志 对于网络测试，指示有关测试的详细信息的标志（由
xymongen）。

最后一次变更 上次更改状态颜色时的 Unix 时间戳。

登录时间 收到日志消息时的 Unix 时间戳。

有效时间 日志消息不再有效时的 Unix 时间戳（在
这次）。

确认时间 活动确认到期时的 -1 或 Unix 时间戳。

禁用时间 状态不再禁用时的 -1 或 Unix 时间戳。

寄件人 接收状态的 IP 地址。

饼干 -1 或用于确认警报的 cookie 值。

1号线 状态日志的第一行。

确认信息 空（如果没有激活的确认），或确认的文本
信息。

取消消息 空（如果状态当前已启用），或禁用的文本
信息。

味精 当前状态消息的全文。

客户 如果有可用的客户端数据，则显示“Y”，如果没有，则显示“N”。

印章 收到最后一条客户端消息的时间戳，在 Unix“纪元”中
格式。

确认名单 测试的当前确认列表。 这是一个文本字符串
多个字段，以冒号字符分隔。 有 5 个字段：时间戳
确认何时生成以及何时到期； “确认级别”； 用户
发送确认； 和确认文本。

翻页信息 告诉状态是否正在摆动。 5 个字段，以“/”分隔：如果是“0”
状态不是摆动，如果摆动则为“1”； 最新状态的时间戳
记录了更改以及记录了第一个状态更改的时间； 和两个
状态之间摆动的颜色。

统计 自 xymond 以来已为此状态记录的状态更改数
开始了。

修饰符 列出此状态的所有活动修饰符（即使用
“修改”命令）。

XMH_* XMH 标签是指 Xymon 主机配置文件(5) 配置设置。 满满的
这些列表可以在 赛蒙-xmh(5) 手册页。

ackmsg、dismsg 和 msg 字段具有某些字符编码：换行符是“\n”，
TAB 是“\t”，回车是“\r”，管道符号是“\p”，反斜线是“\\”。

如果省略“fields”参数，则默认设置一组
主机名、测试名、颜色、标志、上次更改、日志时间、有效时间、确认时间、禁用时间、发件人、cookie、第 1 行
用来。

木板
检索包含所有状态日志摘要的 XML 字符串
“xymondboard”命令。

主机信息 [标准]
检索主机的当前配置（即 主机配置文件(5) 定义）。
CRITERIA 选择要报告的主机，并且与
xymondboard 命令。

对于与 CRITERIA 匹配的每个主机或所有主机，响应为一行，如果
没有指定标准。 该行由多个字段组成，由多个字段分隔
一个管道标志。 前两个字段将始终是主机名和 IP 地址。
其余字段 - 如果有 - 是没有特定顺序的 hosts.cfg 标签。

下载文件名
从 Xymon 服务器的下载目录下载文件。

客户端[/COLLECTORID] HOSTNAME.OSTYPE [HOSTCLASS]
用于向 Xymon 服务器发送“客户端”消息。 生成客户端消息
由 Xymon 客户提供； 当发送到 Xymon 服务器时，它们与
中的规则 分析.cfg(5) 配置文件，并生成状态消息
用于客户端测试。 COLLECTORID 在发送客户端数据时使用
是对标准客户数据的补充。 数据将与
正常的客户数据。

客户端日志主机名 [section=SECTIONNAME[,SECTIONNAME...]]
检索 HOSTNAME 最后发送的当前原始客户端消息。 可选的
“section”过滤器用于选择客户端数据的特定部分。

ping 尝试联系 Xymon 服务器。 如果成功，则 Xymon 服务器版本 ID 为
报告。

拉客户端
当通过实现的“拉”机制获取客户端数据时使用此消息
by xymonfetch(8) 和 消息缓存(8) 对于无法直接连接到
赛蒙服务器。

鬼名单
报告名单 鬼 Xymon 服务器看到的客户端。 幽灵系统
向 Xymon 服务器报告数据，但未在 hosts.cfg 文件中列出。

时间表 [时间戳命令]
安排发送到 Xymon 服务器以供稍后执行的命令。 例如
用于安排在将来某个时间禁用主机或服务。 命令
是一个完整的 Xymon 命令，例如上面列出的命令。 TIMESTAMP 是 Unix
命令将被执行的纪元时间。
如果没有给出参数，则当前调度的任务列在
回复。 响应是每个调度命令一行，带有作业 ID，
执行命令的时间，发送此命令的 IP 地址，
和完整的命令字符串。
要取消先前计划的命令， “日程 取消 乔比德” 可以使用。
JOBID 是作为调度列表输出中第一项提供的数字。

笔记文件名
消息文本将存储在 $XYMONHOME/notes/FILENAME 中，然后用作
来自主机名或列名的超链接。 这需要“storenotes”任务
在 tasks.cfg 中启用（默认情况下禁用）。 FILENAME 不能包含任何
目录路径 - 这些会被自动剥离。

用户信息 ID
这些消息将直接中继到侦听“用户”频道的模块
Xymon 守护进程。 这是用于客户端之间的自定义通信
模块和 Xymon 服务器。

修改 HOSTNAME.TESTNAME COLOR SOURCE CAUSE
修改特定状态的颜色，不生成完整状态
信息。 这适用于可以覆盖
基于在正常流程之外确定的某些标准的状态颜色
地位。 例如，正常的“conn”状态可能看起来是绿色的，因为它只是检查
是否可以ping通主机； 然后 RRD 处理程序可以使用“修改”
命令覆盖这是实际 ping 响应时间超过给定阈值。
（请参阅中的“DS”配置设置 分析.cfg(5) 如何做到这一点）。 来源
是生成“修改”消息的模块的一些标识 - 未来
修改必须使用相同的来源。 可能有几个来源可以修改
相同的状态（最严重的状态然后变成实际的颜色
地位）。 CAUSE 是解释覆盖原因的单行文本字符串
正常状态颜色 - 将显示在状态网页上。

例

使用 TCP 上的标准 Xymon 协议向 Xymon 服务器发送正常状态消息
端口 1984：
$ $XYMON $XYMSRV "状态 www,foo,com.http green `date` Web OK"

发送相同的状态消息，但通过网络服务器的 xymoncgimsg.cgi 使用 HTTP 协议
脚本：
$$XYMON http://bb.foo.com/cgi-bin/xymoncgimsg.cgi "状态 www,foo,com.http 绿色
`date` Web OK"

使用“查询”消息来确定“www”测试的颜色，如果是则重新启动Apache
红色：

$ WWW=`$XYMON $XYMSRV "查询 www,foo,com.www" | awk '{print $1}'`
$ if [ "$WWW" = "red" ]; 然后/etc/init.d/apache重启； 菲

使用“config”消息更新本地 mytest.cfg 文件（但仅当我们收到响应时）：

$ $XYMON $XYMSRV "config mytest.cfg" >/tmp/mytest.cfg.new
$ if [ -s /tmp/mytest.cfg.new ]; 然后
mv /tmp/mytest.cfg.new $XYMONHOME/etc/mytest.cfg
fi

发送已内置在“statusmsg.txt”文件中的非常大的状态消息。 反而
在命令行上提供它，通过 stdin 将它传递给 xymon 命令：

$ cat statusmsg.txt | $XYMON $XYMSRV "@"

使用 onworks.net 服务在线使用 xymon