夜莺-Nightingale
夜莺V7
项目介绍
功能概览
API
FAQ
部署升级
数据接入
告警管理
数据查看
功能介绍
告警管理
通知管理
通知规则介绍
阿里云短信
Relabel 事件处理
Event Drop 事件处理
Event Update 事件处理
Callback 事件处理
Script 事件处理
Label Enrich 事件处理
AI Summary 事件处理
仪表盘
数据源
时序指标
日志分析
告警自愈
基础设施
集成中心
人员组织
系统配置
夜莺V6
项目介绍
架构介绍
快速开始
黄埔营
安装部署
升级
采集器
使用手册
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
转发数据给多个时序库
机器列表数据异常
数据流图
监控数据时有时无
查询原始监控数据
快捷视图详解
告警自愈模块使用
仪表盘里只展示我的机器
仪表盘里图表数据缺失
设置自定义告警通知方式
target_up指标的问题
夜莺可以监控 x 么
夜莺告警常见问题排查思路
告警和恢复的判断逻辑
容量规划问题
connection refused
登录与认证
数据采集器Categraf
日志写到`/var/log/messages`
告警规则&告警模板如何引用变量
采集到的数据是字符串怎么处理
管理员密码忘记了
制作大盘如何添加图片
添加loki数据源报错
v6小版本升级有什么 sql 要执行吗
机器列表有展示,但采集数据查询不到
n9e 启动异常报错
n9e集群部署配置修改
推送 Promethus 报错 OOO
机器列表怎么忽略云资源
告警规则仅在本业务组生效失败
categraf 启动 oracle 插件报错
告警自愈不生效
n9e查询时序库EOF报错
手动编译项目报错
promQL 使用函数标签信息丢失
内存使用率+可用率不等于100
夜莺仪表盘有哪些内置变量
categraf配置文件支持热加载吗
导入 Grafana 仪表盘无效数据源
如何查看报错消息
采集器-Categraf
插件配置
插件综述
基础指标采集插件
netstat采集插件
netstat_filter采集插件
procstat采集插件
http_response
mysql插件
redis插件
snmp插件
ipmi采集插件
dns_query插件
dcgm插件
nvidia_smi插件
cadvisor采集插件
smart采集插件
postgresql插件
mongodb插件
elasticsearch采集插件
exec采集插件
emqx采集插件
阿里云指标采集插件
Zabbix 指标转换插件
cloudwatch指标采集插件
google cloud指标采集插件
mtail插件
prometheus采集插件
页面配置采集插件
Flashcat 企业版
开源生态
Telegraf
Prometheus
版权声明
第1章:天降奇兵
第2章:探索PromQL
开篇
理解时间序列
Metrics类型
初识PromQL
PromQL操作符
PromQL聚合操作
PromQL内置函数
在HTTP API中使用PromQL
最佳实践:4个黄金指标和USE方法
小结
第3章:Prometheus告警处理
开篇
Prometheus告警简介
自定义Prometheus告警规则
部署Alertmanager
Alertmanager配置概述
基于标签的告警处理路由
使用Receiver接收告警信息
告警模板详解
屏蔽告警通知
使用Recoding Rules优化性能
小结
第4章:Exporter详解
第5章:数据与可视化
第6章:集群与高可用
第7章:Prometheus服务发现
第8章:监控Kubernetes
开篇
初识Kubernetes
在Kubernetes下部署Prometheus
Kubernetes下的服务发现
使用Prometheus监控Kubernetes集群
基于Prometheus的弹性伸缩
小结
第9章:Prometheus Operator
参考资料
联系方式
联系方式
联系方式主要用途有两个
- 可以控制用户信息中展示哪些联系方式,把不会用到的联系方式可以关闭
- 有时候用户自己新增加的通知媒介,比如公司内部的im,需要配置用户的联系方式,可以在这里创建
新增联系方式后可以在创建用户-联系方式选择。
使用场景
用户自己创建的通知媒介和联系方式主要在自定义通知脚本中使用,下面是一个脚本调用举例,你可以参考样例脚本,对接自己的内部通信工具。
系统会把告警事件的内容encode成json,然后通过stdin的方式传给通知脚本,脚本示例如下:
#!/usr/bin/env python
# -*- coding: UTF-8 -*-
import sys
import json
import urllib2
reload(sys)
sys.setdefaultencoding('utf8') # 设置默认编码为utf-8
class Sender(object):
@classmethod
# 方法send_newtalk,newtalk要和配置的通知媒介一致;
def send_newtalk(cls, payload):
try:
#print("Starting send_newtalk".encode('utf-8'))
# 从payload中获取事件数据
event = payload.get('event')
# 获取通知用户对象
users = event.get("notify_users_obj")
# 获取告警规则名称
rule_name = event.get("rule_name")
# 默认事件状态为“触发
event_state = "Triggered"
# 如果事件已恢复,则状态为“恢复”
if event.get("is_recovered"):
event_state = "Recovered"
# 用于存储Dingtalk机器人令牌和用户电话
tokens = {}
phones = {}
#print("Extracting user information".encode('utf-8'))
# 遍历用户,收集电话和Dingtalk令牌
for u in users:
if u.get("phone"):
phones[u.get("phone")] = 1
contacts = u.get("contacts")
# dingtalk_robot_token,需要根据需求替换对应名称,在夜莺通知设置-联系方式设定名称,用户里面配置参数
if contacts.get("dingtalk_robot_token", ""):
tokens[contacts.get("dingtalk_robot_token", "")] = 1
# 设置请求头
headers = {
"Content-Type": "application/json;charset=utf-8"
}
#print("Tokens: {}".format(tokens).encode('utf-8'))
#print("Phones: {}".format(phones).encode('utf-8'))
# 遍历令牌,构建请求并发送到Dingtalk
for t in tokens:
url = "https://oapi.dingtalk.com/robot/send?access_token={}".format(t)
body = {
"msgtype": "markdown",
"markdown": {
"title": "{} - {}".format(event_state, rule_name),
"text": "{} {}".format(payload.get('tpls').get("dingtalk.tpl", "dingtalk.tpl not found"), ' '.join(["@"+i for i in phones.keys()]))
},
"at": {
"atMobiles": list(phones.keys()),
"isAtAll": False
}
}
#print("Sending request to URL: {}".format(url).encode('utf-8'))
#print("Request body: {}".format(body).encode('utf-8'))
data = json.dumps(body)
req = urllib2.Request(url, data=data, headers=headers)
req.get_method = lambda: "POST"
response = urllib2.urlopen(req)
result = response.read()
#print("Response status code: {}".format(response.getcode()).encode('utf-8'))
#print("Response text: {}".format(result).encode('utf-8'))
# 捕获所有异常,防止程序崩溃
except Exception as e:
#print("Error in send_newtalk: {}".format(e).encode('utf-8'))
def main():
try:
#print("Reading payload from stdin".encode('utf-8'))
payload = json.load(sys.stdin)
with open(".payload", 'w') as f:
f.write(json.dumps(payload, indent=4))
#print("Payload written to .payload file".encode('utf-8'))
for ch in payload.get('event').get('notify_channels'):
send_func_name = "send_{}".format(ch.strip())
#print("Processing channel: {}, function name: {}".format(ch, send_func_name).encode('utf-8'))
if not hasattr(Sender, send_func_name):
#print("Function {} not found".format(send_func_name).encode('utf-8'))
continue
send_func = getattr(Sender, send_func_name)
send_func(payload)
except Exception as e:
print("Error in main: {}".format(e).encode('utf-8'))
def hello():
print("hello nightingale".encode('utf-8'))
if __name__ == "__main__":
if len(sys.argv) == 1:
main()
elif sys.argv[1] == "hello":
hello()
else:
print("I am confused".encode('utf-8'))
示例脚本中有很多 print 打印的输出,主要是为了方便调试使用。如果开启,可通过 n9e 的日志进行查看,日志调试在 INFO.log,报错状态在 ERROR.log,过滤关键词 event_script_notify
。
更新说明
从 v8.0.0-beta7 版本开始,抽象了通知规则的概念,这个用户自定义联系方式的功能,已经基本用不到了。比如各种机器人 token(企微机器人Key、钉钉机器人Token等),都不应该放到用户联系方式里。
那这个用户联系方式是否可以下线呢?也不是。还有一些个别场景有需求。比如企微除了机器人的通知方式,还有企微应用的通知方式,企微应用通知的话,需要拿到用户的企微账号(一般公司的企微账号都是和员工邮箱前缀保持一致),这里的企微账号信息,就适合放到用户联系方式里。
即:只有真正和用户个人相关的信息,才应该放到用户联系方式里。