API

本节会介绍Nightingale对外提供的API,您可以利用这些API做二次开发,与内部系统相集成。页面上面的所有操作,都有API提供

夜莺涉及的API有两类,一类是页面上对应了相关逻辑的,比如用户相关的、策略相关的、资产相关的,另一类是页面上没有相关逻辑的,比如数据推送的API、资产注册的API。

页面有相关逻辑的

页面如果有相关逻辑的,那就打开chrome的开发者工具,Network菜单,勾选Preserve log,开始操作页面,即可看到往后台发起的请求,请求的url路径、参数、返回值,一目了然,参照这些信息自己写程序调用相关接口即可。

当然了,页面上的操作,认证是通过cookie来的,自己写程序调用这些api,如何认证呢?打开 用户资源中心 > 人员信息 > 我的信息 > 密钥管理 即可看到个人密钥,没有的话点击创建按钮,会自动生成。自己写程序就可以拿着这个token来做认证,把token放到header里即可,比如:

curl -H "X-User-Token: 169b90a1e758b354a9b9bede03d5ec30" http://${server.addr}/api/rdb/self/profile

上面的例子是调用rdb的接口,因为夜莺系统前面一般会部署nginx,所以 ${server.addr} 可以是nginx的地址,也可以直接就是rdb模块的ip:port,如果部署了多个rdb,直接请求nginx的话,nginx会自动做负载均衡以及故障摘除,如果直接请求rdb的ip:port,就要注意负载均衡和故障摘除的逻辑了。

另外,上面的token是谁的,就相当于以谁的身份来操作,如果这个人权限不足,有些接口可能会调用失败,返回没有权限的错误提示。简单起见,可以直接使用root账号的token,或者创建个虚拟账号,设置为超管,也就具备了所有操作的权限。

页面没有相关逻辑的

查看下面各个子章节。


监控数据

本节讲解监控数据相关API

自定义告警通知接口

如果贵司有自己的短信、电话通知接口,可以接入夜莺,只要在rdb里做简单配置即可

诚邀各位小伙伴:

一起参与夜莺社区建设,多写一些夜莺的文章,咱们一起把夜莺做成最好用的国产智能监控。各位甲方上帝们,也可联系我们(18612185520,微信同号)寻求技术支持护航服务,贵司业务发展这么快,我们帮你做好监控!