Statsite 按照和使用文档

1. 项目目录结构及介绍

Statsite 是一个基于 C 语言实现的.metrics 聚合服务器，其目录结构如下：

• bench.py: 性能测试脚本，用于测试 Statsite 的性能。
• bench_bin.py: 二进制性能测试脚本，与 bench.py 功能相似。
• configure.ac: 自动配置脚本，用于生成 Makefile。
• Dockerfile: Docker 容器构建文件，用于创建 Statsite 的 Docker 容器。
• INSTALL.md: 安装指南，详细介绍了如何从源代码构建和安装 Statsite。
• LICENSE: 许可证文件，Statsite 采用 Apache 许可证。
• Makefile.am: Makefile 模板文件，用于构建 Statsite。
• README.md: 项目自述文件，包含了项目的基本信息和安装使用说明。
• statsite: Statsite 的主执行文件。
• statsite.conf.example: 配置文件示例，用于指导用户如何配置 Statsite。
• statsite.docker.example: Docker 配置文件示例，用于指导用户如何在 Docker 容器中运行 Statsite。
• Vagrantfile: Vagrant 配置文件，用于在虚拟环境中自动部署 Statsite。
• Vagrantfile.centos、Vagrantfile.debian: 针对特定 Linux 发行版的 Vagrant 配置文件。
• autogen.sh: 自动生成脚本，用于生成构建系统文件。
• deps: 依赖目录，包含了项目依赖的第三方库。
• src: 源代码目录，包含了 Statsite 的 C 语言源代码。
• tests: 测试目录，包含了用于测试 Statsite 的测试代码。

2. 项目的启动文件介绍

Statsite 的启动非常简单，主要使用以下命令：

./statsite

如果需要指定配置文件，可以使用 -f 或 --config 参数：

./statsite -f /path/to/config/file

在 Docker 容器中运行 Statsite，可以使用以下命令：

docker run statsite/statsite:latest

如果要挂载自定义配置文件，可以使用 -v 参数：

docker run -v /config/statsite:/etc/statsite statsite/statsite:latest

3. 项目的配置文件介绍

Statsite 使用 INI 格式的配置文件，配置文件的基本结构如下：

[statsite]
port = 8125
udp_port = 8125
log_level = INFO
log_facility = local0
flush_interval = 10
timer_eps = 0.01
set_eps = 0.02
stream_cmd = python sinks/graphite.py localhost 2003 statsite

以下是配置文件中一些重要选项的说明：

• port: TCP 监听端口，默认为 8125。
• udp_port: UDP 监听端口，默认为 8125。
• log_level: 日志级别，可以是 DEBUG、INFO、WARN、ERROR 或 CRITICAL。
• log_facility: 日志设施，决定了日志的输出位置，可以是 user、daemon、local0 等。
• flush_interval: 刷新间隔，单位为秒，默认为 10 秒。
• timer_eps: 计时器误差，用于调整计时器百分位的精度。
• set_eps: 集合误差，用于调整集合大小的估计精度。
• stream_cmd: 用于指定聚合后数据流的处理命令，例如发送到 Graphite。

具体的配置选项和详细说明可以在项目的 README.md 文件中找到。