告警变量字段统一规范表¶

文档版本：V1.4 发布日期：2026-09-02 文档性质：数据字典类

文档说明¶

本文档为告警通知、工单系统、日志记录及自动化脚本提供统一的变量命名规范。所有变量均采用 ${变量名} 格式（实际使用时请根据平台语法替换）。

命名原则：全部使用小写字母与下划线（snake_case），保持团队一致。

一、用户/身份信息类¶

变量名	说明	使用场景
`${userid}`	用户编号（唯一标识）	用户身份绑定
`${username}`	用户名（登录名）	操作者标识
`${password}`	密码（禁止明文输出）	脚本认证（仅内部加密传递）
`${realname}`	用户真实姓名	通知中显示
`${email}`	用户邮箱	邮件通知
`${phone}`	用户手机号	短信/语音告警
`${role}`	用户角色（admin/audit/user）	权限控制
`${token}`	API认证令牌	系统间调用（加密）
`${last_ip}`	最后登录IP	安全审计
`${department}`	所属部门	工单分配
`${mfa_enabled}`	是否启用多因素认证	安全审计
`${login_time}`	登录时间戳	审计追溯

二、工单/任务信息类¶

变量名	说明	使用场景
`${case_id}`	工单编号（唯一）	工单系统关联
`${case_title}`	工单标题	通知摘要
`${case_type}`	工单类型（故障/需求/变更）	流程分类
`${case_status}`	工单状态	流转控制
`${case_priority}`	工单优先级（复用告警权重0-6）	响应级别
`${assignee}`	当前处理人用户名	指派
`${creator}`	创建人用户名	溯源
`${create_time}`	创建时间（ISO 8601）	计时起点
`${update_time}`	最后更新时间	追踪
`${deadline}`	SLA截止时间	超时判断
`${sla_status}`	SLA状态（正常/即将超时/已超时）	预警
`${resolution}`	解决方案描述	关闭前填写
`${close_time}`	关闭时间	归档
`${transfer_count}`	转单次数	流程优化
`${pending_count}`	挂起次数	阻塞分析
`${pending_reason}`	挂起原因	阻塞溯源
`${sla_remaining}`	剩余SLA时长（秒或分钟）	倒计时展示
`${total_duration}`	工单总耗时（秒）	统计考核

三、系统/资源信息类¶

变量名	说明	使用场景
`${osid}`	NFOS核心编号	系统标识
`${server_id}`	服务器ID	资产库查询
`${server_name}`	服务器主机名	显示
`${server_ip}`	服务器IP地址	网络定位
`${os_type}`	操作系统类型	兼容性判断
`${os_version}`	操作系统版本	补丁管理
`${cpu_usage}`	CPU使用率（%）	性能告警
`${memory_usage}`	内存使用率（%）	性能告警
`${disk_usage}`	磁盘使用率（%）	存储告警
`${cpu_cores}`	CPU核心数	容量规划
`${memory_total}`	总内存（GB）	容量规划
`${disk_total}`	总磁盘容量（GB）	容量规划
`${disk_free}`	空闲磁盘容量（GB）	容量告警
`${instance_id}`	云实例ID	云环境
`${cluster_name}`	集群名称	集群告警
`${namespace}`	K8s命名空间	容器环境
`${pod_name}`	Pod名称	容器告警
`${node_name}`	节点名称	K8s节点告警
`${container_id}`	容器ID	容器告警
`${network_in}`	网络入流量（Mbps）	网络监控
`${network_out}`	网络出流量（Mbps）	网络监控
`${load_avg_1m}`	1分钟平均负载	系统负载监控
`${load_avg_5m}`	5分钟平均负载	系统负载监控
`${load_avg_15m}`	15分钟平均负载	系统负载监控
`${process_count}`	进程数	系统监控
`${uptime}`	系统运行时长（秒）	健康检查
`${swap_usage}`	Swap使用率（%）	性能监控

四、微服务/应用信息类¶

变量名	说明	使用场景
`${svr}`	微服务名称（核心）	标识
`${service_id}`	服务唯一ID	注册中心
`${service_version}`	服务版本号	灰度发布
`${app_name}`	所属应用名称	应用级告警
`${app_id}`	应用ID	关联
`${endpoint}`	API端点（URL）	监控
`${port}`	监听端口	健康检查
`${status}`	服务状态（up/down）	存活告警
`${error_rate}`	错误率（%）	质量监控
`${response_time}`	平均响应时间（ms）	性能监控
`${qps}`	每秒请求数	流量监控
`${instance_count}`	服务实例数	容量规划
`${active_connections}`	活跃连接数	并发监控
`${thread_pool_active}`	线程池活跃线程数	性能监控
`${heap_usage}`	JVM堆内存使用率（%）	Java应用监控
`${gc_count}`	GC次数	JVM监控
`${gc_time}`	GC耗时（ms）	JVM监控

五、告警/事件通用信息类¶

变量名	说明	使用场景
`${alarm_id}`	告警唯一ID	全局关联
`${alarm_name}`	告警规则名称	识别
`${alarm_level}`	告警级别名称	展示
`${alarm_weight}`	告警级别权重（6~0）	数字排序
`${alarm_status}`	告警状态（触发/恢复）	生命周期
`${alarm_time}`	告警触发时间戳	时序
`${recovery_time}`	告警恢复时间戳	恢复计算
`${alarm_content}`	告警详细描述	通知正文
`${trigger_condition}`	触发条件表达式	排查
`${current_value}`	当前指标值	上下文
`${threshold}`	配置阈值	比较
`${event_type}`	事件类型	分类
`${alarm_source}`	告警来源	溯源
`${previous_level}`	变更前告警级别	级别变更追踪
`${alarm_count}`	同告警触发次数	告警收敛
`${alarm_group}`	告警分组名称	分组收敛

六、时间/环境信息类¶

变量名	说明	使用场景
`${start_time}`	任务开始时间	耗时计算
`${end_time}`	任务结束时间	耗时计算
`${duration}`	任务持续时长（秒）	性能分析
`${env}`	环境标识（prod/test/dev）	隔离
`${region}`	云区域	地域
`${zone}`	可用区	容灾
`${timezone}`	时区	时间展示
`${timestamp}`	当前时间戳（Unix）	日志记录
`${date}`	日期（YYYY-MM-DD）	归档
`${time}`	时间（HH:MM:SS）	展示

七、数据库/存储类¶

变量名	说明	使用场景
`${db_name}`	数据库名称	数据库备份
`${db_instance}`	数据库实例ID	实例级操作
`${db_type}`	数据库类型	兼容性
`${db_connection_count}`	数据库连接数	性能告警
`${db_slow_queries}`	慢查询数量	性能告警
`${db_transactions}`	事务数/秒	性能监控
`${db_qps}`	数据库QPS	性能监控
`${db_tps}`	数据库TPS	性能监控
`${tablespace_usage}`	表空间使用率（%）	容量告警
`${tablespace_name}`	表空间名称	容量管理
`${archive_log_count}`	归档日志堆积数量	备份风险
`${archive_log_size}`	归档日志大小（GB）	容量告警
`${redo_log_status}`	Redo日志状态	数据库健康
`${backup_id}`	备份任务ID	备份链路追踪
`${backup_policy}`	备份策略名称	策略管理
`${backup_type}`	备份类型（全量/增量/差异）	存储规划
`${backup_status}`	备份执行状态	状态监控
`${backup_size}`	备份集大小（MB/GB）	容量统计
`${backup_speed}`	备份速度（MB/s）	性能监控
`${backup_time}`	备份执行时间戳	时序
`${source_path}`	备份源路径	排查
`${target_path}`	备份目标路径	存储定位
`${compression_ratio}`	压缩比率（%）	效率优化
`${retry_count}`	当前重试次数	稳定性判断
`${error_code}`	错误码	分类处理
`${storage_used}`	存储库已用容量（GB）	容量告警
`${storage_total}`	存储库总容量（GB）	容量规划
`${storage_usage_rate}`	存储库使用率（%）	阈值触发
`${storage_free}`	存储库剩余容量（GB）	容量告警
`${snapshot_id}`	快照ID	快照管理
`${snapshot_time}`	快照创建时间	快照管理

八、备份任务特定变量¶

变量名	说明	使用场景
`${job_id}`	备份作业ID	作业控制
`${job_name}`	备份作业名称	用户识别
`${job_type}`	作业类型（backup/restore）	区分
`${vcenter_host}`	vCenter主机名	虚拟化备份
`${vm_name}`	虚拟机名称	虚机备份
`${vm_uuid}`	虚拟机UUID	唯一标识
`${backup_retention_days}`	保留天数	合规检查
`${backup_chain_length}`	备份链长度	完整性检查
`${last_success_time}`	上次成功备份时间	监控缺失备份
`${backup_window_start}`	备份窗口开始时间	窗口控制
`${backup_window_end}`	备份窗口结束时间	窗口控制
`${backup_server}`	备份管理服务器主机名	服务端
`${proxy_server}`	代理服务器主机名	网络拓扑
`${tape_library}`	磁带库名称	磁带备份
`${tape_id}`	磁带ID	磁带管理
`${dedup_ratio}`	重删比率	效率优化

九、传感器/硬件监控类¶

变量名	说明	使用场景
`${sensor_id}`	传感器ID	硬件监控
`${sensor_name}`	传感器名称	识别
`${sensor_type}`	传感器类型	分类
`${sensor_value}`	传感器当前读数	实时监控
`${sensor_unit}`	传感器单位	单位标识
`${sensor_status}`	传感器状态	健康检查
`${sensor_location}`	传感器位置	物理定位
`${temperature_cpu}`	CPU温度（℃）	过热告警
`${temperature_system}`	系统环境温度（℃）	机房监控
`${temperature_disk}`	硬盘温度（℃）	存储设备监控
`${humidity}`	湿度（%）	环境监控
`${fan_speed}`	风扇转速（RPM）	散热监控
`${voltage}`	电压（V）	电源监控
`${power_status}`	电源状态	电源告警
`${battery_health}`	电池健康度（%）	UPS/RAID卡监控
`${chassis_temp}`	机箱内部温度（℃）	硬件监控
`${pdu_outlet}`	PDU插座编号	电源管理
`${rack_unit}`	机架U位编号	物理定位
`${hardware_model}`	硬件型号	资产管理
`${hardware_vendor}`	硬件厂商	资产管理
`${serial_number}`	设备序列号	资产管理
`${firmware_version}`	固件版本	固件管理
`${raid_status}`	RAID阵列状态	存储硬件监控
`${disk_smart_status}`	硬盘SMART状态	硬盘健康监控
`${disk_predict_fail}`	硬盘预测性故障	提前预警
`${psu_status}`	电源模块状态	冗余电源监控
`${nic_status}`	网卡状态	网络硬件监控

十、安全/合规类¶

变量名	说明	使用场景
`${security_event_id}`	安全事件ID	安全告警溯源
`${security_event_type}`	安全事件类型	分类
`${security_severity}`	安全事件严重性	响应分级
`${attack_source_ip}`	攻击源IP	溯源封堵
`${attack_target}`	攻击目标	定位
`${attack_type}`	攻击类型	分类应对
`${auth_method}`	认证方式	审计
`${auth_result}`	认证结果	审计
`${cert_common_name}`	证书通用名（CN）	证书管理
`${cert_issuer}`	证书颁发者	证书管理
`${cert_serial}`	证书序列号	证书管理
`${cert_expire_time}`	证书过期时间	过期告警
`${cert_remaining_days}`	证书剩余有效天数	过期预警
`${tls_version}`	TLS版本	安全合规
`${cipher_suite}`	加密套件名称	安全审计
`${firewall_rule_id}`	防火墙规则ID	安全策略管理
`${firewall_action}`	防火墙动作	安全审计
`${vulnerability_id}`	漏洞编号（CVE）	漏洞管理
`${vulnerability_score}`	CVSS风险评分	漏洞优先级
`${vulnerability_name}`	漏洞名称	漏洞识别
`${patch_id}`	补丁编号	补丁管理
`${patch_status}`	补丁安装状态	合规检查
`${compliance_standard}`	合规标准	合规审计
`${compliance_status}`	合规状态	合规告警
`${audit_log_id}`	审计日志ID	审计追溯
`${audit_operation}`	审计操作类型	审计记录
`${encryption_status}`	加密状态	数据安全
`${backup_encryption}`	备份加密状态	备份安全
`${access_control}`	访问控制策略	权限审计
`${ip_whitelist}`	IP白名单	访问控制
`${ip_blacklist}`	IP黑名单	安全防护
`${login_fail_count}`	登录失败次数	暴力破解检测
`${session_id}`	会话ID	会话审计
`${user_agent}`	用户浏览器/客户端标识	安全审计

十一、消息队列类¶

变量名	说明	使用场景
`${mq_type}`	消息队列类型	识别
`${mq_cluster}`	消息队列集群名称	集群管理
`${mq_broker}`	Broker节点地址	节点监控
`${topic_name}`	Topic名称	消息监控
`${topic_partitions}`	Topic分区数	容量规划
`${queue_name}`	队列名称	队列监控
`${consumer_group}`	消费者组名称	消费监控
`${producer_id}`	生产者ID	生产监控
`${consumer_id}`	消费者ID	消费监控
`${partition_id}`	分区ID	分区监控
`${offset}`	当前消费位移	消费延迟计算
`${lag_count}`	消息堆积数量	核心告警指标
`${lag_duration}`	消息堆积时间（秒）	延迟告警
`${incoming_rate}`	消息生产速率（条/秒）	流量监控
`${outgoing_rate}`	消息消费速率（条/秒）	流量监控
`${queue_depth}`	队列深度（消息数）	队列监控
`${broker_status}`	Broker状态	节点健康
`${controller_status}`	控制器状态	集群健康
`${isr_count}`	ISR副本数	副本同步监控
`${under_replicated}`	未同步副本数	数据可靠性
`${message_size}`	消息大小（bytes）	性能监控
`${message_count}`	消息总数	统计
`${retry_times}`	消息重试次数	稳定性监控
`${dead_letter_count}`	死信消息数	异常监控
`${ack_mode}`	确认模式	消费模式
`${exchange_name}`	交换机名称	路由监控
`${routing_key}`	路由键	路由监控
`${vhost}`	虚拟主机名称	多租户隔离
`${connection_count}`	连接数	连接池监控
`${channel_count}`	通道数	通道监控

十二、中间件类¶

变量名	说明	使用场景
`${middleware_type}`	中间件类型	识别
`${redis_instance}`	Redis实例名称	Redis监控
`${redis_memory_usage}`	Redis内存使用率（%）	内存告警
`${redis_connected_clients}`	Redis客户端连接数	连接监控
`${redis_keys_total}`	Redis键总数	数据量监控
`${redis_hit_rate}`	Redis命中率（%）	缓存效率
`${redis_ops_per_sec}`	Redis QPS	流量监控
`${redis_replication_lag}`	Redis主从复制延迟（秒）	复制监控
`${es_cluster}`	Elasticsearch集群名称	集群管理
`${es_node}`	ES节点名称	节点监控
`${es_shard_count}`	ES分片数	集群监控
`${es_unassigned_shards}`	ES未分配分片数	核心告警指标
`${es_disk_usage}`	ES磁盘使用率（%）	容量告警
`${es_cluster_status}`	ES集群状态	核心告警指标
`${es_search_latency}`	ES查询延迟（ms）	性能监控
`${nginx_server}`	Nginx服务器名	Nginx监控
`${nginx_conn_active}`	Nginx活跃连接数	并发监控
`${nginx_conn_reading}`	Nginx读连接数	状态监控
`${nginx_conn_writing}`	Nginx写连接数	状态监控
`${nginx_waiting}`	Nginx等待连接数	状态监控
`${nginx_request_rate}`	Nginx请求速率（req/s）	流量监控
`${nginx_4xx_rate}`	Nginx 4xx错误率	错误监控
`${nginx_5xx_rate}`	Nginx 5xx错误率	核心告警指标
`${apache_server}`	Apache服务器名	Apache监控
`${apache_total_accesses}`	Apache总访问数	统计
`${apache_total_kbytes}`	Apache总流量（KB）	流量监控
`${apache_cpuload}`	Apache CPU负载	性能监控
`${tomcat_instance}`	Tomcat实例名	Tomcat监控
`${tomcat_session_active}`	Tomcat活跃会话数	会话监控
`${tomcat_heap_usage}`	Tomcat JVM堆使用率	JVM监控
`${tomcat_thread_pool}`	Tomcat线程池使用率	线程监控

十三、VPN类¶

变量名	说明	使用场景
`${vpn_connection_id}`	VPN连接ID	连接状态追踪
`${vpn_connection_name}`	VPN连接名称	识别
`${vpn_type}`	VPN类型	协议区分
`${vpn_status}`	VPN连接状态	健康监控
`${vpn_gateway_ip}`	VPN网关公网IP	网络定位
`${vpn_peer_ip}`	对端设备IP	对端识别
`${vpn_tunnel_id}`	VPN隧道ID	隧道监控
`${vpn_tunnel_status}`	VPN隧道状态	核心告警指标
`${vpn_bytes_in}`	VPN入流量	带宽统计
`${vpn_bytes_out}`	VPN出流量	带宽统计
`${vpn_session_count}`	当前活跃会话数	用户接入监控
`${vpn_establish_time}`	隧道建立时间	排查
`${vpn_last_down_reason}`	上次断开原因	故障定位
`${vpn_phase1_algo}`	阶段1加密算法	安全审计
`${vpn_phase2_algo}`	阶段2加密算法	安全审计
`${vpn_dpd_status}`	DPD状态	连接稳定性
`${vpn_rekey_count}`	重协商次数	稳定性监控

十四、WAF类¶

变量名	说明	使用场景
`${waf_instance_id}`	WAF实例ID	实例管理
`${waf_instance_name}`	WAF实例名称	识别
`${waf_policy_id}`	防护策略ID	策略管理
`${waf_policy_name}`	防护策略名称	识别
`${waf_mode}`	防护模式	策略状态
`${waf_status}`	WAF服务状态	健康监控
`${waf_domain}`	保护的域名	关联资源
`${waf_attack_count}`	攻击次数	核心告警指标
`${waf_attack_type}`	攻击类型	分类应对
`${waf_attack_source_ip}`	攻击源IP	溯源封堵
`${waf_blocked_count}`	拦截次数	防护效果
`${waf_passed_count}`	放行次数	流量统计
`${waf_rule_id}`	触发规则ID	规则匹配
`${waf_rule_name}`	触发规则名称	识别
`${waf_rule_severity}`	规则严重性	告警分级
`${waf_qps}`	WAF处理的QPS	性能监控
`${waf_latency}`	WAF处理延迟（ms）	性能告警
`${waf_4xx_count}`	4xx错误响应数	异常监控
`${waf_5xx_count}`	5xx错误响应数	异常监控
`${waf_cc_rate}`	CC攻击速率	频率防护
`${waf_bypass_status}`	旁路状态	故障切换
`${waf_cert_id}`	关联的证书ID	证书管理
`${waf_cert_expire}`	证书过期时间	过期预警
`${waf_log_stream_id}`	日志流ID	日志审计
`${waf_alert_level}`	WAF自定义告警级别	告警联动

十五、SQLite/通用数据表类¶

变量名	说明	使用场景
`${table_name}`	通用数据表名称	表操作/监控
`${table_schema}`	表所属Schema	归属
`${table_type}`	表类型	元数据管理
`${table_rows}`	表行数（估算）	容量监控
`${table_size}`	表占用空间（MB/GB）	容量告警
`${table_index_size}`	索引占用空间（MB/GB）	存储优化
`${table_engine}`	存储引擎	兼容性
`${sqlite_db_path}`	SQLite数据库文件路径	文件管理
`${sqlite_db_name}`	SQLite数据库名称	标识
`${sqlite_table_name}`	SQLite表名	备份/恢复目标
`${sqlite_table_row_count}`	SQLite表当前记录数	数据量监控
`${sqlite_table_size}`	SQLite表文件大小	存储监控
`${sqlite_page_count}`	SQLite页数	存储分析
`${sqlite_auto_vacuum}`	自动清理状态	维护状态
`${sqlite_integrity_check}`	完整性检查结果	健康告警
`${sqlite_journal_mode}`	日志模式	性能调优
`${sqlite_cache_size}`	缓存大小（KB）	性能监控
`${sqlite_temp_store}`	临时存储策略	性能优化
`${table_last_analyze}`	最后分析时间	统计信息新鲜度
`${table_last_vacuum}`	最后清理时间	维护记录
`${table_creation_time}`	表创建时间	元数据

十六、网络性能与可用性类¶

变量名	说明	使用场景
`${availability_rate}`	可用性百分比	SLA考核
`${uptime_duration}`	连续运行时长（秒）	稳定性统计
`${uptime_days}`	连续运行天数	长稳运行统计
`${downtime_duration}`	停机/不可用时长（秒）	故障影响评估
`${sla_target}`	承诺的SLA目标值	合规对比
`${sla_breach_risk}`	SLA违约风险	提前预警
`${health_check_status}`	健康检查结果	存活探测
`${reachability}`	网络可达性	连通性告警
`${icmp_latency}`	ICMP平均延迟（ms）	网络质量监控
`${icmp_loss_rate}`	ICMP丢包率（%）	核心网络健康告警
`${tcp_connect_time}`	TCP连接建立耗时（ms）	服务端口可用性
`${http_status_code}`	HTTP/S状态码	Web服务可用性监控
`${http_body_match}`	HTTP响应体关键字匹配	业务层可用性校验
`${dns_resolve_time}`	DNS解析耗时（ms）	域名解析质量
`${dns_resolve_status}`	DNS解析状态	域名解析可用性
`${packet_loss_rate}`	总丢包率（%）	核心告警指标
`${packet_loss_count}`	丢包计数	瞬断分析
`${packet_send_rate}`	数据包发送速率（pps）	流量模型分析
`${packet_receive_rate}`	数据包接收速率（pps）	流量模型分析
`${jitter}`	网络抖动（ms）	实时备份/数据库同步质量
`${bandwidth_usage}`	带宽使用率（%）	链路容量告警
`${bandwidth_total}`	总带宽（Mbps/Gbps）	容量规划
`${bandwidth_used}`	已用带宽（Mbps/Gbps）	流量监控
`${bandwidth_remaining}`	剩余带宽（Mbps/Gbps）	容量预警
`${tcp_retransmission_rate}`	TCP重传率（%）	网络质量间接指标
`${connection_timeout_count}`	连接超时次数	网络抖动排查
`${rtt_min}`	最小RTT（ms）	延迟分析
`${rtt_max}`	最大RTT（ms）	延迟分析
`${rtt_avg}`	平均RTT（ms）	延迟基准
`${rtt_stddev}`	RTT标准差（ms）	延迟稳定性评估
`${link_status}`	物理/逻辑链路状态	链路健康总览
`${link_speed}`	链路协商速率	硬件/交换机监控
`${link_flap_count}`	链路震荡次数	物理层稳定性告警
`${path_health}`	端到端路径健康度（0-100）	综合质量评分
`${next_hop_ip}`	下一跳网关IP	路由追踪
`${vpn_tunnel_availability}`	VPN隧道可用性（%）	VPN SLA
`${waf_backend_availability}`	WAF后端源站可用性（%）	WAF回源健康
`${waf_backend_latency}`	WAF后端响应延迟（ms）	源站性能监控

附录：变量命名规范速查¶

分类	前缀建议	示例
用户信息	`user`	`${userid}`、`${username}`
工单信息	`case` / `ticket`	`${case_id}`、`${case_status}`
系统资源	`server` / `os` / `cpu` / `memory`	`${server_ip}`、`${cpu_usage}`
微服务	`service` / `app`	`${service_id}`、`${app_name}`
告警事件	`alarm` / `event`	`${alarm_id}`、`${event_type}`
时间环境	`time` / `env` / `region`	`${start_time}`、`${env}`
数据库/存储	`db` / `backup` / `storage`	`${db_name}`、`${backup_size}`
传感器/硬件	`sensor` / `temp` / `fan` / `disk`	`${sensor_value}`、`${temperature_cpu}`
安全合规	`security` / `cert` / `auth` / `audit`	`${security_event_type}`、`${cert_expire_time}`
消息队列	`mq` / `topic` / `queue` / `consumer`	`${mq_type}`、`${lag_count}`
中间件	`redis` / `es` / `nginx` / `tomcat`	`${redis_memory_usage}`、`${es_cluster_status}`
VPN	`vpn_`	`${vpn_tunnel_status}`
WAF	`waf_`	`${waf_attack_count}`
数据表/SQLite	`table_` / `sqlite_`	`${table_rows}`、`${sqlite_db_path}`
网络性能	`availability_` / `packet_` / `bandwidth_` / `rtt_`	`${availability_rate}`、`${packet_loss_rate}`