https://github.com/springrain/owl
https://github.com/springrain/owl
Last synced: 5 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/springrain/owl
- Owner: springrain
- License: apache-2.0
- Created: 2023-04-05T13:02:38.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-12-03T03:43:01.000Z (over 1 year ago)
- Last Synced: 2024-12-03T04:23:57.807Z (over 1 year ago)
- Language: Go
- Size: 65 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
开源告警管理专家 一体化的可观测平台
[English](./README_en.md) | [中文](./README.md)
## 夜莺 Nightingale 是什么
夜莺监控是一款开源云原生观测分析工具，采用 All-in-One 的设计理念，集数据采集、可视化、监控告警、数据分析于一体，与云原生生态紧密集成，提供开箱即用的企业级监控分析和告警能力。夜莺于 2020 年 3 月 20 日，在 GitHub 上发布 v1 版本，已累计迭代 100 多个版本。
夜莺最初由滴滴开发和开源，并于 2022 年 5 月 11 日，捐赠予中国计算机学会开源发展委员会（CCF ODC），为 CCF ODC 成立后接受捐赠的第一个开源项目。夜莺的核心研发团队，也是 Open-Falcon 项目原核心研发人员，从 2014 年（Open-Falcon 是 2014 年开源）算起来，也有 10 年了，只为把监控这个事情做好。
## 快速开始
- 👉 [文档中心](https://flashcat.cloud/docs/) | [下载中心](https://flashcat.cloud/download/nightingale/)
- ❤️ [报告 Bug](https://github.com/ccfos/nightingale/issues/new?assignees=&labels=&projects=&template=question.yml)
- ℹ️ 为了提供更快速的访问体验，上述文档和下载站点托管于 [FlashcatCloud](https://flashcat.cloud)
- 💡 前后端代码分离，前端代码仓库：[https://github.com/n9e/fe](https://github.com/n9e/fe)
## 功能特点
- 对接多种时序库：支持对接 Prometheus、VictoriaMetrics、Thanos、Mimir、M3DB、TDengine 等多种时序库，实现统一告警管理。
- 专业告警能力：内置支持多种告警规则，可以扩展支持常见通知媒介，支持告警屏蔽/抑制/订阅/自愈、告警事件管理。
- 高性能可视化引擎：支持多种图表样式，内置众多 Dashboard 模版，也可导入 Grafana 模版，开箱即用，开源协议商业友好。
- 支持常见采集器：支持 [Categraf](https://flashcat.cloud/product/categraf)、Telegraf、Grafana-agent、Datadog-agent、各种 Exporter 作为采集器，没有什么数据是不能监控的。
- 👀无缝搭配 [Flashduty](https://flashcat.cloud/product/flashcat-duty/)：实现告警聚合收敛、认领、升级、排班、IM集成，确保告警处理不遗漏，减少打扰，高效协同。
## 截图演示
你可以在页面的右上角，切换语言和主题，目前我们支持英语、简体中文、繁体中文。
即时查询，类似 Prometheus 内置的查询分析页面，做 ad-hoc 查询，夜莺做了一些 UI 优化，同时提供了一些内置 promql 指标，让不太了解 promql 的用户也可以快速查询。
当然，也可以直接通过指标视图查看，有了指标视图，即时查询基本可以不用了，或者只有高端玩家使用即时查询，普通用户直接通过指标视图查询即可。
夜莺内置了常用仪表盘，可以直接导入使用。也可以导入 Grafana 仪表盘，不过只能兼容 Grafana 基本图表，如果已经习惯了 Grafana 建议继续使用 Grafana 看图，把夜莺作为一个告警引擎使用。
除了内置的仪表盘，也内置了很多告警规则，开箱即用。
## 产品架构
社区使用夜莺最多的场景就是使用夜莺做告警引擎，对接多套时序库，统一告警规则管理。绘图仍然使用 Grafana 居多。作为一个告警引擎，夜莺的产品架构如下：
对于个别边缘机房，如果和中心夜莺服务端网络链路不好，希望提升告警可用性，我们也提供边缘机房告警引擎下沉部署模式，这个模式下，即便网络割裂，告警功能也不受影响。
## 交流渠道
- 报告Bug，优先推荐提交[夜莺GitHub Issue](https://github.com/ccfos/nightingale/issues/new?assignees=&labels=kind%2Fbug&projects=&template=bug_report.yml)
- 推荐完整浏览[夜莺文档站点](https://flashcat.cloud/docs/content/flashcat-monitor/nightingale-v7/introduction/)，了解更多信息
- 推荐搜索关注夜莺公众号，第一时间获取社区动态：`夜莺监控Nightingale`
- 日常问题交流：
- QQ群：730841964
- [加入微信群](https://download.flashcat.cloud/ulric/20241022141621.png)，如果二维码过期了，可以联系我（我的微信：`picobyte`）拉群，备注： `夜莺互助群`
## 广受关注
[](https://star-history.com/#ccfos/nightingale&Date)
## 社区共建
- ❇️ 请阅读浏览[夜莺开源项目和社区治理架构草案](./doc/community-governance.md)，真诚欢迎每一位用户、开发者、公司以及组织，使用夜莺监控、积极反馈 Bug、提交功能需求、分享最佳实践，共建专业、活跃的夜莺开源社区。
- ❤️ 夜莺贡献者
## License
- [Apache License V2.0](https://github.com/didi/nightingale/blob/main/LICENSE)
## 源码编译
```shell
##详细命令参见 Makefile
#sql文件是 ./docker/initsql/a-n9e.sql
#数据库和redis配置文件 ./etc/config.toml
##下载编译好的前端项目fe,https://github.com/n9e/fe/releases
## 使用statik把前端打包的执行程序,也可以配置 UseFileAssets = true,外部加载pub文件夹
go install github.com/rakyll/statik
## Linux
statik -src=./pub -dest=./front -f
go build -ldflags "-w -s" -o n9e ./cmd/center/main.go
## Windows
# statik -src=pub -dest=front -f
# go build -ldflags "-w -s" -o n9e.exe ./cmd/center/main.go
# n9e-edge/n9e-alert等其他模块参见 Makefile
## 前端访问 http://127.0.0.1:17000 账号:root 密码:root.2020
```
## ClickHouse / Doris
维护一套数据库的成本是巨大的,最好复用现有的业务大数据库.
- https://github.com/jamessanford/remote-tsdb-clickhouse
## 不兼容说明
https://gitee.com/chunanyong/owl/commit/fc6460913b5f12ee08bf7442f0207f454ea71a7e