ostent - Golang系统指标收集与展示库

ostent是一个用Go语言编写的轻量级系统指标收集和展示工具，支持将指标转发到Graphite和InfluxDB等时间序列数据库。

主要特性

1. 实时收集系统指标（CPU、内存、磁盘、网络等）
2. 提供简洁的Web界面展示
3. 支持指标转发到Graphite和InfluxDB
4. 轻量级，易于部署

安装与使用

安装

go get github.com/rzab/ostent

基本使用

package main

import (
	"log"
	"github.com/rzab/ostent/ostent"
)

func main() {
	// 创建ostent实例
	o := ostent.NewOstent()

	// 配置基本参数
	o.Addr = ":8080" // Web界面监听端口
	o.Interval = 5   // 收集间隔(秒)

	// 启动服务
	if err := o.Run(); err != nil {
		log.Fatal(err)
	}
}

配置转发到Graphite/InfluxDB

Graphite配置示例

package main

import (
	"log"
	"github.com/rzab/ostent/ostent"
	"github.com/rzab/ostent/graphite"
)

func main() {
	o := ostent.NewOstent()
	o.Addr = ":8080"
	o.Interval = 5

	// 配置Graphite转发
	graphiteConfig := &graphite.Config{
		Host:     "graphite.example.com",
		Port:     2003,
		Prefix:   "ostent",
		Interval: 60, // 转发间隔(秒)
	}
	
	// 添加Graphite转发器
	o.AddFlusher(graphite.NewFlusher(graphiteConfig))

	if err := o.Run(); err != nil {
		log.Fatal(err)
	}
}

InfluxDB配置示例

package main

import (
	"log"
	"github.com/rzab/ostent/ostent"
	"github.com/rzab/ostent/influxdb"
)

func main() {
	o := ostent.NewOstent()
	o.Addr = ":8080"
	o.Interval = 5

	// 配置InfluxDB转发
	influxConfig := &influxdb.Config{
		Host:     "influxdb.example.com",
		Port:     8086,
		Database: "metrics",
		Username: "user",
		Password: "pass",
		Interval: 60, // 转发间隔(秒)
	}
	
	// 添加InfluxDB转发器
	o.AddFlusher(influxdb.NewFlusher(influxConfig))

	if err := o.Run(); err != nil {
		log.Fatal(err)
	}
}

自定义指标收集

ostent允许添加自定义指标收集器：

package main

import (
	"log"
	"time"
	"github.com/rzab/ostent/ostent"
	"github.com/rzab/ostent/params"
)

// 自定义指标收集器
type CustomCollector struct{}

func (c *CustomCollector) Collect() ([]params.Param, error) {
	return []params.Param{
		{
			Name:  "custom.metric",
			Value: float64(time.Now().Unix()),
			Unit:  "timestamp",
		},
	}, nil
}

func main() {
	o := ostent.NewOstent()
	o.Addr = ":8080"
	o.Interval = 5

	// 添加自定义收集器
	o.AddCollector(&CustomCollector{})

	if err := o.Run(); err != nil {
		log.Fatal(err)
	}
}

命令行参数

ostent也支持通过命令行参数配置：

# 基本运行
ostent -addr :8080 -interval 5

# 启用Graphite转发
ostent -graphite-host graphite.example.com -graphite-port 2003 -graphite-prefix ostent

# 启用InfluxDB转发
ostent -influxdb-host influxdb.example.com -influxdb-port 8086 -influxdb-database metrics

注意事项

1. ostent默认会收集系统基础指标，包括CPU、内存、磁盘、网络等
2. Web界面访问地址为 http://localhost:8080
3. 转发到Graphite/InfluxDB的间隔建议大于收集间隔，以减少网络开销
4. 在生产环境中，建议通过systemd或supervisor管理ostent进程

ostent是一个轻量级的解决方案，适合需要快速搭建系统监控但不想部署复杂监控系统的场景。对于更复杂的需求，可能需要考虑Prometheus等更全面的监控方案。