https://github.com/sofastack/sofa-lookout

SOFALookout is a light-weight monitoring and analysis tool
https://github.com/sofastack/sofa-lookout

metrics sofa-boot sofa-lookout sofastack

Last synced: 5 days ago
JSON representation

SOFALookout is a light-weight monitoring and analysis tool

• Host: GitHub
• URL: https://github.com/sofastack/sofa-lookout
• Owner: sofastack
• License: apache-2.0
• Created: 2018-05-14T15:17:39.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2023-12-01T03:46:45.000Z (about 1 year ago)
• Last Synced: 2024-12-22T14:06:16.107Z (12 days ago)
• Topics: metrics, sofa-boot, sofa-lookout, sofastack
• Language: Java
• Homepage:
• Size: 1.34 MB
• Stars: 374
• Watchers: 46
• Forks: 119
• Open Issues: 37
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# SOFALookout

[![Build Status](https://travis-ci.org/sofastack/sofa-lookout.svg?branch=master)](https://travis-ci.org/sofastack/sofa-lookout)

[![Coverage Status](https://coveralls.io/repos/github/alipay/sofa-lookout/badge.svg?branch=master)](https://coveralls.io/github/alipay/sofa-lookout?branch=master)

![license](https://img.shields.io/badge/license-Apache--2.0-green.svg)

![maven](https://img.shields.io/github/release/alipay/sofa-lookout.svg)

[English Document](./README_EN.md)

访问 [WIKI](http://www.sofastack.tech/sofa-lookout/docs/Home) 查看完整的文档使用指南。

SOFALookout（已开源部分）是一个利用多维度的 metrics 对目标系统进行度量和监控的项目。SOFALookout 的多维度 metrics 参考[Metrics2.0 标准](http://metrics20.org/)。

```

+----------------+

| Lookout Client +----+

+----------------+    |

+----------------+    |

| Prometheus SDK +----+  +-------------------+   +------------+  +------------------+  +-----------+

+----------------+    +-->  Lookout Gateway  +--->  DB(ES/...)<--+  Lookout Server  <--+  Grafana  |

+----------------+    |  +-------------------+   +------------+  +------------------+  +-----------+

|   Metricbeat   +----+

+----------------+    |

+----------------+    |

|       ...      +----+

+----------------+

```

SOFALookout 项目分为客户端部分与服务器端部分：

- 客户端是一个 Java 的类库，可以将它植入您的应用代码中采集 metrics 信息，[客户端更多详情](./client/README.md)。

- 服务端代码（Metrics）部分，对 Metrics 数据进行收集、加工、存储和查询等处理，另外结合 [grafana](https://grafana.com)，可做数据可视化展示。

## 相较于常用的监控方案：

- 多维度的 metrics, 在传统的 metrics 的 name 基础上，又加上了一组 tags 的集合；因此相较于 Dropwizard, Spring Boot 的 actuator 等而言可以提供更丰富的 tags 维度方便监控分析；

- 相比于通过收集、加工应用系统产生的日志进行监控分析的方案，metrics 会显得更轻量，对系统资源的消耗也比较固定，不会随着业务量增加而增加；

- SOFALookout 除了对自身的 Java SDK 客户端采集源支持，还支持业界主流的采集 Agent 的数据汇报；

- 采集源可以通过配置文件或者服务发现机制找到 SOFALookout 的采集服务；

- SOFA 的体系中产品都会默认集成了 SOFALookout SDK 进行状态度量；

我们在分布式场景已经积累了一定的经验，但也处于探索的过程中。开源 SOFALookout 项目，我们是希望以更开放方式来合作确保该项目向正确的方向持续演化。后续我们可能也会开源更多的解决海量数据的配套设施。

## 下一步

会持续开源 tracing，eventing 功能。

## 编译

  - 代码编译: 至少Maven 3.2.5+, JDK Version 8+；

  - all-in-one 启动模块编译: `./boot/all-ine-one-bootstrap/build.sh`, 打包结果在`boot/all-in-one-bootstrap/target/xxx-executable-ark.jar`

  

## 致谢

Lookout 的 promQL 相关解析逻辑是从 Prometheus 移植而来，做了一些优化和改进， 感谢 Prometheus 开源了如此易用和强大的 golang 版本的 QL 实现

## 样例工程

样例工程演示了如何快速使用 SOFALookout，[详细可参考](https://www.sofastack.tech/sofa-lookout/docs/useguide-samples)。

## 贡献

如何参与 SOFALookout [代码贡献](./CONTRIBUTING.md)

## 开源许可

SOFALookout 基于 [Apache License 2.0](./LICENSE) 协议，SOFALookout 依赖了一些三方组件，它们的开源协议参见[依赖组件版权说明](https://github.com/sofastack/sofa-lookout/wiki/NOTICE)。