Skip to content

Latest commit

 

History

History
81 lines (57 loc) · 3.92 KB

README.md

File metadata and controls

81 lines (57 loc) · 3.92 KB

Qelog

Build&Test Go Report Card Go Reference codecov

Qelog is a small, low cost and light operation and maintenance of the log service. The purpose of its birth is to solve the problem of small and medium-sized team multi-service group log and alarm.

It has been running stably for 2+ years and has been rolling over 100+TB of data.

中文文档

admin manager example address username:admin passwd:123456

Log System Features:

Client

  • qezap is the Go version Client of the project. Wrap Uber-zap ,Extension for local and remote implementations of WriteSyncer.
  • Local extension: log cutting, compression, retention period, dynamic switching level, etc.
  • Remote expansion: The buffer is packed and compressed for transmission log data, and the error backup is retried to ensure that the data is not lost. The GRPC(default) HTTP protocol is supported, and the I/O control ensures the bandwidth usage is controllable and the memory usage is low.

Log receiver server

  • The Receiver process can be expanded horizontally to ensure high availability and high performance.
  • Configure multiple storage instances on the Receiver to improve the storage capacity and write performance of the cluster.
  • Alarm module detects alarm rules for each log. The hit can be delivered according to the rules and different alarm methods. Currently supported DingTalk | Telegram
  • Implement data fragmentation storage rules, support automatic capacity management, monitoring and early warning. Store separate instances of extensions without bottlenecks due to middleware.
  • Log statistics, level distribution, and trend report.

Log manager server

  • Based on the vue-element-admin modification,support rich query dimensions, such as level, keyword, TraceId, ClientIP, multi-level conditions, etc. Due to cost and performance issues ** Full-text indexing ** is currently not supported
  • Friendly operation interaction, simple configuration, efficient content display, almost can be done out of the box quick used.
  • Cluster capacity statistics query, manual intervention, and other functions.

Performance test tool

  • /tools Includes benchmark and memory footprint tests.
  • Different operating environments and configurations have different performance. Therefore, you can conduct a comprehensive analysis to preliminarily check whether the service meets the requirements of scenarios.

Design drawing

Design drawing

Usage

Qezap Client import your project

go get -u github.com/bbdshow/qelog/qezap

Client use example

Quick Deploy

default use single node deploy

Docker Deploy
git clone https://github.com/bbdshow/qelog.git
cd qelog
# build docker image
make image
# docker-compose start container
docker-compose up -d
Binary Deploy
git clone https://github.com/bbdshow/qelog.git
cd qelog
make
cd bin
# ./qelog or nohup ./qelog &

Service cluster deployment

Cluster deployment time, pay attention to mongo configuration file and qelog service running mode "cluster_admin" | "cluster_receiver", use docker-compose.yaml for cluster layout...

Thank you for your support. If it is useful to you, I hope the Star can support you. If you have any questions, please Issues, keep updating and solve problems.