andyafter/merlin

Merlin 指标引擎

镜像概述

Merlin是一款解决传统指标系统数据分散、定义脱节问题的集中化指标引擎。它通过统一指标的存储schema和嵌入定义的测量方式，实现指标的集中管理，支持层级化聚合与多维度分析，为监控、业务决策及跨系统数据复用提供支撑。

核心功能

1. 统一指标Schema：为所有指标提供通用数据结构，确保不同来源指标遵循一致规范。
2. 嵌入定义的测量：将指标定义与测量数据直接关联，避免定义丢失或与数据脱节。
3. 层级化聚合：支持按时间、位置、属性等多维度进行层级聚合，满足不同场景分析需求。
4. 功能变量与表达式：记录指标计算中的变量（如温度区间）和表达式，确保计算逻辑可追溯。

使用场景

• 系统监控：集中管理各业务系统指标，生成统一监控视图。
• 业务分析：通过多维度聚合（如区域、时间统计）支撑业务决策。
• 数据复用：统一的指标定义与schema便于跨团队、跨系统共享数据。

配置说明

Merlin核心配置需根据实际需求定义：

• group_map：聚合变量映射（如位置、温度）。
• func_map：功能变量映射（如温度区间计算）。
• func_expr：指标计算表达式（如sum(Weight)按位置聚合）。

部署示例

Docker Run

bash
docker run -d --name merlin andyafter/merlin

Docker Compose（示例）

yaml
version: '3'
services:
  merlin:
    image: andyafter/merlin
    container_name: merlin
    restart: always
    # 若需暴露端口，添加ports配置（如ports: ["8080:8080"]）

贡献指南

Merlin欢迎社区贡献，参与开发或提出建议请参考项目https://github.com/andyafter/merlin/blob/main/CONTRIBUTING.md%EF%BC%8C%E6%88%96%E9%80%9A%E8%BF%87GitHub Issues发起讨论。