使用 CA AppLogic › 组件开发人员指南 › vme：CA AppLogic 组件的事件生成器

vme：CA AppLogic 组件的事件生成器

VME 是用户模式实用工具，CA AppLogic 组件在组件启动过程中以及运行时，用它来生成 CA AppLogic 的特定事件。 只要组件不是未受管理，组件在启动过程中必须使用 vme 来告诉 CA AppLogic 组件是否正常启动。 如果由于某些错误（无效属性设置、没有足够可用内存等）导致组件无法启动，组件可以使用 vme 使组件启动失败，并且将错误消息记录到网格控制器的系统日志中（使用网格的列表日志命令访问）。 在组件运行时也可以使用 vme 将严重错误消息记录到网格的显示板。

默认情况下，组件工具包 (APK) 安装到组件中时，vme 始终用于发送组件“正常启动”事件。 这可以由组件特定的脚本覆盖，该脚本在组件启动过程期间执行。

使用情况

vme id=<事件> [msg=<消息>] [severity=<重要级别>] [progress=<准备就绪>] [cnt_name=<计数器名称> cnt_value=<计数器值>]

示例

vme id=started_ok

vme id=start_failed msg="缺少 DNS 服务器地址"

vme id=maintenance msg="数据库恢复" progress=30

vme id=log msg="SSL 证书加载正常" severity=info

vme id=alert msg="检测到已损坏的数据库文件" severity=fatal

vme id=alert cnt_name=n_db_xact_per_min cnt_value=46 severity=fatal

注意：

• <event> 为下列之一：
• started_ok－组件正常启动
• start_failed－组件启动失败，原因如消息所述
• maintenance－组件为维护模式（即，数据库恢复）
• log－代表组件记录事件
• alert－组件检测到严重事件或错误，也用于报告计数器值的更改
• <消息> 是任意文本，如果需要空格或特殊字符，进行转义
• <重要级别> 可以为下列之一：

  debug－调试信息

  info－信息事件

  warn－警告事件

  error－错误事件

  fatal－致命的和不可校正的错误

<准备就绪> 以百分比报告，有效值为 1 到 100

维护模式中的组件必须定期报告它们的进度（频率不低于 30 秒）。

<计数器名称> 和 <计数器值> 仅用于报警

如果提供报警的消息，则消息将记录到网格的显示板