https://github.com/soxft/busuanzi

A simple website statistics analyzer
https://github.com/soxft/busuanzi

analyzer busuanzi busuanzi-statistics golang hexo hugo statistics

Last synced: about 5 hours ago
JSON representation

A simple website statistics analyzer

• Host: GitHub
• URL: https://github.com/soxft/busuanzi
• Owner: soxft
• License: apache-2.0
• Created: 2022-04-24T07:13:31.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-12-13T02:20:20.000Z (9 days ago)
• Last Synced: 2024-12-14T08:04:39.036Z (7 days ago)
• Topics: analyzer, busuanzi, busuanzi-statistics, golang, hexo, hugo, statistics
• Language: Go
• Homepage: https://busuanzi.9420.ltd
• Size: 665 KB
• Stars: 179
• Watchers: 1
• Forks: 27
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-ops - soxft/busuanzi - 2.0|161|2022-04-24|2024-09-25 | 一个简单的网站统计分析器 | (Monitor)

README

        
[![soxft/busuanzi](https://socialify.cmds.run/soxft/busuanzi/image?description=1&font=Raleway&forks=1&language=1&logo=https%3A%2F%2Fraw.githubusercontent.com%2Fsoxft%2Fbusuanzi%2Fmain%2Fdist%2Ffavicon.png&name=1&owner=1&pattern=Circuit%20Board&stargazers=1&theme=Dark&cache=43200)](https://busuanzi.9420.ltd)

- [简体中文](README.zh_CN.md)

## self-hosted busuanzi

> A simple visitor statistics system based on Golang + Redis

- Calculate the UV and PV of the website

- Calculate the UV and PV of the subpage

- One-click deployment using Docker

- Privacy protection only stores HASH

- Pjax compatible webpage

- Support migration from the original busuanzi

## Installation

Support multiple running methods: compile and run from source code, run with Docker. See [Install](https://github.com/soxft/busuanzi/wiki/install) for details

### Quick Start with Docker

1. Edit the `docker-compose.yaml` file with your own configuration.

2. Run `docker-compose up -d` to start the service. 

3. Visit `http://localhost:8080` to view the data.

## Usage

Supports multiple custom attributes, compatible with pjax web pages, supports custom tag prefixes. See: [Usage documentation](https://github.com/soxft/busuanzi/wiki/usage)

## Principle

- `Busuanzi` uses Redis for data storage and retrieval. Redis, as an in-memory database, has extremely high read and write performance. At the same time, its unique RDB and AOF persistence mechanisms ensure the security of Redis data.

UV and PV data are stored in the following keys:

| index  | Types       | key                               |

|--------|-------------|-----------------------------------|

| sitePv | String      | bsz:site_pv:md5(host)             |

| siteUv | HyperLogLog | bsz:site_uv:md5(host)             |

| pagePv | ZSet        | bsz:page_pv:md5(host) / md5(path) |

| pageUv | HyperLogLog | bsz:site_uv:md5(host):md5(path)   |

## Data Migration

- You can use the [busuanzi-sync](https://github.com/soxft/busuanzi-sync) tool to sync data from the [original busuanzi](http://busuanzi.ibruce.info) to the self-hosted busuanzi.

## Other

Logo created by ChatGPT

## Upgrade Suggestions

- Please be sure to back up your data (dump.rdb) before upgrading.

- New and old version data may not be compatible, please pay attention to the instructions on the Release interface, upgrade cautiously

- 2.5.x - 2.7.x can use the [bsz-transfer](https://github.com/soxft/busuanzi-transfer) tool to migrate data to 2.8.x.