🚀 Umami
Umami 是一个强大而灵活的监控工具，支持多种数据源的日志收集和服务器资源的实时监控。通过合理配置和扩展，它能够满足多种性能分析需求，有效提升系统的稳定性和可维护性。
🚀 快速开始
安装步骤
使用以下命令安装 Umami：
pip install umami
环境变量配置
在 .env 文件中添加以下内容：
UMAMI_DB_TYPE=sqlite
UMAMI_DB_PATH=/var/lib/umami/umami.db
UMAMI_LISTEN_ADDRESS=0.0.0.0
UMawi_PORT=3000
启动服务
使用以下命令启动 Umami 服务：
umami serve --config ./config.yaml
✨ 主要特性
- 数据采集：支持多种数据源的日志收集，包括系统日志、应用程序日志等；实时监控服务器资源使用情况，如 CPU、内存、磁盘 I/O 等。
- 数据存储：提供数据库表结构用于存储监控指标。
- 性能分析：支持创建监控任务和数据可视化，包括仪表盘展示和报告生成。
- 功能扩展：允许添加自定义指标和实现插件系统。
📦 安装指南
安装步骤
pip install umami
环境变量配置
在 .env 文件中添加以下内容：
UMAMI_DB_TYPE=sqlite
UMAMI_DB_PATH=/var/lib/umami/umami.db
UMAMI_LISTEN_ADDRESS=0.0.0.0
UMawi_PORT=3000
启动服务
umami serve --config ./config.yaml
💻 使用示例
基础用法
创建监控任务
from umami import Monitor
monitor = Monitor()
monitor.start_collection()
添加自定义指标
from umami import Metric
class CustomMetric(Metric):
def collect(self):
return {
'custom_value': self.get_custom_data()
}
实现插件系统
from umami.plugins import Plugin
class MyPlugin(Plugin):
def on_data_collected(self, data):
print("New data collected:", data)
高级用法
数据可视化
- 仪表盘：提供实时数据的图形化展示，包括时间序列图、柱状图等。
- 报告生成：自动生成性能分析报告，支持 PDF 和 HTML 格式输出。
📚 详细文档
扩展 Umami 功能
添加自定义指标
from umami import Metric
class CustomMetric(Metric):
def collect(self):
return {
'custom_value': self.get_custom_data()
}
实现插件系统
from umami.plugins import Plugin
class MyPlugin(Plugin):
def on_data_collected(self, data):
print("New data collected:", data)
最佳实践
日志管理
- 定期清理旧日志，避免占用过多存储空间。
- 配置日志归档策略，便于长期分析和审计。
性能调优
- 根据实际需求调整数据采集频率，减少资源消耗。
- 使用高效的数据库索引优化查询性能。
故障排除
数据收集问题
# 检查服务状态
systemctl status umami
# 查看日志
journalctl -u umami --since "10 minutes ago"
连接问题
- 确保网络配置正确，防火墙规则允许相关端口通信。
- 检查目标服务器是否可达，ping 测试确认网络连通性。
🔧 技术细节
数据存储
CREATE TABLE metrics (
id INTEGER PRIMARY KEY AUTOINCREMENT,
name TEXT NOT NULL,
value REAL NOT NULL,
timestamp DATETIME DEFAULT CURRENT_TIMESTAMP
);