夜莺-Nightingale
夜莺V8
前言必读 前言必读
项目介绍 对比 Prometheus 前置知识 夜莺架构 商业版 视频教程
安装 安装
前置说明 升级 二进制部署 Docker Compose Helm 配置讲解
采集器 采集器
前置说明 Categraf Telegraf Datadog-Agent
快速体验 快速体验
数据源 即时查询 指标告警 日志告警 通知规则 仪表盘
监控实践 监控实践
Linux OS 进程监控 端口监控 插件脚本 MySQL Redis Oracle Java
功能详解 功能详解
告警原理和流程说明 业务组 屏蔽规则 订阅规则 事件处理器 Processor 通知媒介 单点登录 SSO API
说明文档 说明文档
通知升级（商业版） 告警聚合（商业版） 告警抑制（商业版） 告警抑制 by 查询（商业版） 附加查询（商业版） 告警自愈（商业版）
告警管理 告警管理
查询统计 查询统计
Prometheus Elasticsearch MySQL VictoriaLogs 阿里云 SLS 腾讯云 CLS 变量查询
夜莺V7
项目介绍 功能概览
部署升级 部署升级
部署说明 老版本升级 附：Docker Compose 附：二进制部署 附：高可用部署 附：Prometheus 部署 附：部署采集器 附：边缘机房部署
数据接入 数据接入
数据源接入 导入仪表盘 数据采集
告警管理 告警管理
快速入门 PromQL 邮件推送 企微推送 钉钉推送 回调推送 脚本推送 自定义通知模板 告警屏蔽 告警自愈 告警事件
数据查看 数据查看
即时查询 仪表盘
功能介绍 功能介绍
告警管理 告警管理
告警规则 告警规则
基础配置 生效配置
查询统计 查询统计
Prometheus Elasticsearch MySQL 阿里云 SLS 腾讯云 CLS 变量查询
告警条件 告警条件
告警表达式 MySQL 举例
告警屏蔽 告警订阅 告警历史
通知管理 通知管理
通知规则介绍 阿里云短信 Relabel 事件处理 Event Drop 事件处理 Event Update 事件处理 Callback 事件处理 Script 事件处理 Label Enrich 事件处理 AI Summary 事件处理 模板函数
仪表盘 仪表盘
巡检报告 集成仪表盘
数据源 数据源
Prometheus Elasticsearch Loki TDengine MySQL SLS CLS Jaeger Zabbix
时序指标 时序指标
快捷视图
即时查询 即时查询
Prometheus TDengine MySQL Zabbix
日志分析 日志分析
Elasticserch 阿里云 SLS 腾讯云 CLS Loki
告警自愈 告警自愈
自愈脚本 临时任务
基础设施 基础设施
机器列表 采集配置 网络设备 设备采集模板
集成中心 集成中心
告警规则模板 仪表盘模板 指标模板 采集模板
人员组织 人员组织
用户管理 团队管理 业务组管理 权限管理 联系方式
系统配置 系统配置
单点登录 单点登录
dingtalk OIDC OAUTH2 LDAP CAS
通知设置 通知设置
通知媒介 阿里云短信 阿里云语音 腾讯云短信 腾讯云语音
通知模板 站点设置 变量设置 告警引擎
数据库表结构 数据库表结构
users notify_tpl board users target target user_group user_group_member task_tpl task_tpl_host task_record sso_config role role_operation recording_rule notify_tpl metric_view datasource configs chart_share busi_group busi_group_member builtin_cate builtin_cate builtin_cate builtin_cate board board_payload alerting_engines alert_subscribe alert_rule alert_mute alert_his_event alert_cur_event alert_aggr_view
API FAQ
夜莺V6
项目介绍 架构介绍
快速开始 快速开始
最快速体验
黄埔营
安装部署 安装部署
部署说明 Docker Compose 高级部署方案 附：Prometheus 部署
升级
采集器 采集器
概述 Categraf Datadog-agent Falcon插件 Grafana-agent Telegraf
使用手册 使用手册
仪表盘 仪表盘
仪表盘 图表配置
告警管理 告警管理
告警规则 内置规则 告警屏蔽 告警订阅 活跃告警 历史告警 通知媒介
时序指标 时序指标
即时查询 快捷视图 记录规则
日志分析 日志分析
即时查询
基础设施 基础设施
机器列表 采集配置
告警自愈 人员组织 数据源 通知配置 通知模板 单点登录 ES日志监控（专业版） 自监控 权限管理
API API
数据读取 数据推送 操作类接口 回调地址对接方式
数据库表结构 数据库表结构
users notify_tpl board users target target user_group user_group_member task_tpl task_tpl_host task_record sso_config role role_operation recording_rule notify_tpl metric_view datasource configs chart_share busi_group busi_group_member builtin_cate builtin_cate builtin_cate builtin_cate board board_payload alerting_engines alert_subscribe alert_rule alert_mute alert_his_event alert_cur_event alert_aggr_view
FAQ FAQ
转发数据给多个时序库 机器列表数据异常 数据流图 监控数据时有时无 查询原始监控数据 快捷视图详解 告警自愈模块使用 仪表盘里只展示我的机器 仪表盘里图表数据缺失 设置自定义告警通知方式 target_up指标的问题 夜莺可以监控 x 么 夜莺告警常见问题排查思路 告警和恢复的判断逻辑 容量规划问题 connection refused 登录与认证 数据采集器Categraf 日志写到`/var/log/messages` 告警规则&告警模板如何引用变量 采集到的数据是字符串怎么处理 管理员密码忘记了 制作大盘如何添加图片 添加loki数据源报错 v6小版本升级有什么 sql 要执行吗 机器列表有展示，但采集数据查询不到 n9e 启动异常报错 n9e集群部署配置修改 推送 Promethus 报错 OOO 机器列表怎么忽略云资源 告警规则仅在本业务组生效失败 categraf 启动 oracle 插件报错 告警自愈不生效 n9e查询时序库EOF报错 手动编译项目报错 promQL 使用函数标签信息丢失 内存使用率+可用率不等于100 夜莺仪表盘有哪些内置变量 categraf配置文件支持热加载吗 导入 Grafana 仪表盘无效数据源 如何查看报错消息
夜莺V5
项目介绍 藏经阁
安装部署 安装部署
事前必读 Docker Compose 方式 Helm 方式 二进制方式 VictoriaMetrics 告警自愈模块
采集器 采集器
Telegraf Grafana-agent Falcon插件 Datadog-agent Categraf
使用手册 使用手册
SNMP 应用监控 Mtail日志监控 JVM监控 钉钉告警 电话短信告警 告警通知 告警格式 Relabel 自监控
API API
数据读取 数据推送 Webapi接口
采集器-Categraf
总体介绍
安装部署
主配置文件
日志采集
Prometheus agent
Trace采集
高级配置
插件配置
插件综述 基础指标采集插件 Netstat 采集插件 Netstat_Filter 采集插件 Procstat 采集插件 HTTP_Response MySQL 插件 Redis 插件 SNMP_Zabbix插件 SNMP 插件 IPMI 采集插件 DNS_Query 插件 DCGM 采集插件 NVIDIA_SMI 插件 cAdvisor 采集插件 Huatuo 托管插件 SSHD 采集插件 Systemd 采集插件 S.M.A.R.T.采集插件 PostgreSQL 插件 MongoDB 插件 Elasticsearch 采集插件 EXEC 采集插件 EMQX 采集插件 阿里云指标采集插件 Zabbix 指标转换插件 CloudWatch 指标采集插件 Google Cloud 指标采集插件 Mtail 日志采集插件 Prometheus 采集插件 开启采集配置控制台下发 贡献新插件
Flashcat 企业版
总体介绍
北极星
简介 落地步骤 最佳实践 SLA管理实践
灭火图
简介 落地步骤 最佳实践
事件墙
简介 落地步骤 最佳实践
日志分析
简介 落地步骤 最佳实践
最佳实践
跳转链接中的时间戳如何自定义格式 如何获取Flashcat即时查询带参数的URL 如何修改北极星大屏的Logo 如何嵌入Flashcat Web页面
开源生态
Telegraf
介绍、安装、初步测试 CPU、MEM、DISK、IO插件 kernel、system、processes插件 exec、net、netstat插件 端口监控、TCP探测 PING、Procstat插件
Prometheus
版权声明
第1章:天降奇兵 第1章:天降奇兵
开篇 Prometheus简介
初识Prometheus 初识Prometheus
安装Prometheus Server 使用Node Exporter采集主机数据 使用PromQL查询监控数据 使用Grafana创建可视化Dashboard
任务和实例 Prometheus核心组件讲解 小结
第2章:探索PromQL 第2章:探索PromQL
开篇 理解时间序列 Metrics类型 初识PromQL PromQL操作符 PromQL聚合操作 PromQL内置函数 在HTTP API中使用PromQL 最佳实践：4个黄金指标和USE方法 小结
第3章:Prometheus告警处理 第3章:Prometheus告警处理
开篇 Prometheus告警简介 自定义Prometheus告警规则 部署Alertmanager Alertmanager配置概述 基于标签的告警处理路由
使用Receiver接收告警信息 使用Receiver接收告警信息
概述 与SMTP邮件集成 与Slack集成 与企业微信集成 集成钉钉：基于Webhook的扩展
告警模板详解 屏蔽告警通知 使用Recoding Rules优化性能 小结
第4章:Exporter详解 第4章:Exporter详解
开篇 Exporter是什么
常用Exporter 常用Exporter
容器监控：cAdvisor 使用 Prometheus 监控 MySQL 运行状态：MySQLD Exporter 网络探测：Blackbox Exporter
使用Java自定义Exporter 使用Java自定义Exporter
使用Client Java构建Exporter程序 在应用中内置Prometheus支持
小结
第5章:数据与可视化 第5章:数据与可视化
开篇 使用Console Template Grafana基本概念
Grafana与数据可视化 Grafana与数据可视化
概述 变化趋势：Graph面板 分布统计：Heatmap面板 当前状态：SingleStat面板
模板化Dashboard 小结
第6章:集群与高可用 第6章:集群与高可用
开篇 Prometheus 本地存储 Prometheus 远程存储 Prometheus 联邦集群 Prometheus 高可用 Alertmanager 高可用 小结
第7章:Prometheus服务发现 第7章:Prometheus服务发现
开篇 Prometheus与服务发现 基于文件的服务发现 基于Consul的服务发现 服务发现与Relabeling 小结
第8章:监控Kubernetes 第8章:监控Kubernetes
开篇 初识Kubernetes 在Kubernetes下部署Prometheus Kubernetes下的服务发现 使用Prometheus监控Kubernetes集群 基于Prometheus的弹性伸缩 小结
第9章:Prometheus Operator 第9章:Prometheus Operator
开篇 什么是Prometheus Operator 使用Operator管理Prometheus 使用Operator管理监控配置 在Prometheus Operator中使用自定义配置 本章小结
参考资料

通知规则配置指南

功能概述

夜莺监控采用告警规则与通知规则分离的架构设计：

  • 告警规则：负责检测指标异常并生成告警事件
  • 通知规则：负责定义告警事件的通知渠道、接收人及发送策略

该设计支持按告警级别配置差异化通知策略，例如：Critical 级别告警通过电话、短信、钉钉发送，Info 级别告警仅通过邮件发送。

架构优势

相较于早期版本在告警规则中直接配置通知方式，当前架构具备以下优势：

特性 说明
告警级别与通知媒介联动 支持在启用告警抑制的场景下，为不同级别的告警事件配置独立的通知媒介
灵活的媒介接入方式 提供通用 HTTP 和脚本发送方式，支持自定义 HTTP 参数、Header 及 Body
通知配置集中管理 告警规则与通知规则解耦，修改通知策略仅需调整通知规则，即可批量生效至关联的所有告警规则
消息模板自定义 支持为同一通知媒介配置多个消息模板，满足不同团队的个性化需求

工作流程

告警事件的发送流程如下图所示：

通知规则和告警规则的联动逻辑

流程说明：

  1. 告警规则检测到异常指标后生成告警事件
  2. 告警事件根据关联的通知规则确定发送策略
  3. 通知规则按照配置的媒介和接收人发送告警通知

多个告警规则可关联同一通知规则，实现通知策略的统一管理。

通知规则配置

配置说明

通知规则支持为不同告警级别配置独立的通知媒介。以下为配置示例：

通知规则配置样例

配置项说明：

  • 生效级别：指定该通知媒介适用的告警级别（Critical/Warning/Info）
  • 通知媒介：选择用于发送告警的渠道
  • 接收人/接收团队：指定告警通知的接收人或团队

内置通知媒介

系统预置以下通知媒介，可直接使用：

内置媒介列表

通知媒介变量配置

应用场景

当多个团队需要使用同一类型的通知媒介但配置不同参数时（例如：DBA 团队和大数据团队使用不同的企业微信机器人），可通过变量配置实现。

配置方法

以企业微信机器人为例，内置的企微通知媒介包含以下两个变量参数：

变量名 说明
Key 企业微信机器人的唯一标识
Bot Name 机器人名称（备注信息，便于识别）

在通知媒介的 HTTP 配置中引用变量（变量配置部分类似 function 的参数，下面部分类似 function 的实现，实现部分可以引用参数）：

通知媒介变量定义

配置完成后，各团队在创建通知规则时选择企微媒介并填写各自的机器人 Key 即可。

用户联系方式关联

对于短信、电话等需要使用用户个人联系方式的场景，系统支持从用户 Profile 中自动获取联系信息。

配置步骤：

  1. 在通知媒介的变量配置中，将联系方式设置为相应类型（如 Phone）

通知媒介管理用户 Profile

  1. 配置完成后，系统将自动实现以下功能：
    • 通知规则配置界面支持选择联系人或团队作为接收对象
    • HTTP 请求的 Body 或 Query String 中可使用 {{ $sendto }} 变量引用接收人的联系方式

说明：{{ $sendto }} 为系统内置变量，用于动态获取通知接收人的联系信息。

媒介对接指南

IM 类媒介配置

请参考以下文档完成 IM 类通知媒介的对接：

通知媒介 配置文档
钉钉 对接钉钉告警
企业微信 对接企微告警
飞书 对接飞书告警
钉钉（含 @人功能） 对接钉钉告警-配置 @人
多媒介综合配置 对接钉钉、飞书、企微通知
阿里云短信 对接阿里云短信

提示：微信视频号「SRETALK」提供飞书告警对接的视频教程，可搜索查看。

邮件告警配置

邮件告警配置包含以下 4 个步骤：

步骤 1：配置 SMTP 发信服务器

  1. 进入 系统配置 > 通知媒介 菜单
  2. 选择内置的 Email 通知媒介，点击编辑
  3. 填写 SMTP 服务器配置信息：

邮件通知媒介配置

必填参数：

参数 说明
服务器 邮件服务器主机名或 IP 地址
端口 邮件服务器端口号（通常为 25、465 或 587）
用户名 SMTP 服务器认证用户名
密码 SMTP 服务器认证密码或授权码
发件人 用于发送告警邮件的邮箱地址

步骤 2：配置用户收件邮箱

  1. 点击页面右上角用户头像
  2. 进入 个人信息 配置页面
  3. 在联系方式中填写收件邮箱地址

步骤 3：创建邮件通知规则

  1. 进入 通知规则 菜单
  2. 点击 新建通知规则（或编辑现有规则）
  3. 配置通知规则参数：

邮件通知规则配置

配置项说明：

配置项 说明
生效级别 选择需要邮件通知的告警级别
通知媒介 选择 Email
接收对象 选择接收告警的用户或团队
  1. 点击 通知测试，选择一条历史告警事件进行发送测试
  2. 在告警规则中关联该通知规则

步骤 4：自定义邮件消息模板（可选）

  1. 进入 消息模板 菜单
  2. 选择 Email 消息模板进行编辑

模板变量说明：

变量名 说明
content 邮件正文内容
subject 邮件主题

说明：消息模板使用 Go Template 语法，可根据业务需求自定义邮件内容格式。

快猫星云 联系方式 快猫星云 联系方式
快猫星云 联系方式
快猫星云 联系方式
快猫星云 联系方式
快猫星云Email
申请技术交流产品试用
快猫星云
OpenSource
开源版
Nightingale
Categraf
Flashcat
Flashcat
企业版
Flashduty
Flashduty
On-call
RUM
控制台
API
文档中心
下载中心
视频中心
开发者中心
话题中心