Quạ tư duy canh giữ hạ tầng của bạn.
Self-hosted observability platform có AI agent, của timezlab.
Trong thần thoại Bắc Âu, Huginn là quạ "Tư duy" của thần Odin. Mỗi sáng nó bay khắp chín thế giới, tối về thì thầm vào tai Odin tất cả những gì đã thấy. Huginn ở đây cũng vậy — quan sát hạ tầng của bạn, suy nghĩ về nó, và báo cho bạn khi có chuyện.
Huginn là nền tảng observability self-hosted xây trên stack LGTM (Loki, Grafana, Tempo, Mimir) + Pyroscope + Alloy, kèm AI agent làm 3 việc mà tool monitoring truyền thống không làm:
- RCA tự động khi alert fire — agent đọc metrics/logs/traces, đề xuất nguyên nhân kèm citation tới Grafana.
- Conversational chat — hỏi agent "tại sao service X chậm?" qua Telegram, agent reply có dữ liệu kèm.
- Gợi ý remediation — match runbook, suggest action với inline keyboard approve/reject. Auto-execute là opt-in per-action sau khi có audit track record, chạy trong sandbox + command whitelist.
Khác với Datadog Watchdog / New Relic AI: self-hosted thuần, BYOK LLM, không phụ thuộc cloud provider.
- Homelab / solo dev (1-5 servers) — observability nhẹ nhưng smart.
- Small team / startup DevOps (5-50 servers) — giảm cognitive load lúc on-call.
- Lộ trình nâng cấp: single-instance ↔ central+members, cùng codebase.
┌──────────────────────────────────────────────────────┐
│ Member nodes (Alloy push, multi-tenant) │
│ node-exporter, app logs, OTLP traces, profiles │
└─────────────────┬────────────────────────────────────┘
│ HTTPS + Bearer token
│ X-Scope-OrgID: <member-id>
▼
┌──────────────────────────────────────────────────────┐
│ Central │
│ ┌───────┐ ┌──────┐ ┌──────┐ ┌──────────┐ │
│ │ Mimir │ │ Loki │ │ Tempo│ │ Pyroscope│ ──► MinIO │
│ └───┬───┘ └──────┘ └──────┘ └──────────┘ (S3 obj │
│ │ rule fires store) │
│ ▼ │
│ ┌──────────────┐ webhook ┌──────────────────┐ │
│ │ Alertmanager ├───────────►│ Huginn Agent │ │
│ └──────────────┘ │ (Python + │ │
│ │ LangGraph) │ │
│ └──────┬───────────┘ │
│ │ │
│ ▼ │
│ ┌──────────────┐ │
│ │ Telegram bot │ │
│ └──────────────┘ │
└──────────────────────────────────────────────────────┘
Chi tiết kiến trúc: ARCHITECTURE.md · Quyết định & lý do: VISION.md
| Layer | Component |
|---|---|
| Metrics | Grafana Mimir (monolithic) |
| Logs | Grafana Loki (SSD mode) |
| Traces | Grafana Tempo (monolithic) |
| Profiles | Grafana Pyroscope |
| Object store | MinIO (S3-compat) |
| Collector | Grafana Alloy |
| Dashboard | Grafana |
| Alerting | Alertmanager |
| Bot channels | Telegram (chính) + Slack + Discord adapter |
| Agent runtime | Python 3.12 + FastAPI + LangGraph + LangChain |
| AI Agent LLM | BYOK (Anthropic / OpenAI-compat / Ollama) |
| Delivery | Docker Compose + Helm chart (shared config) |
Tất cả backend bật multi-tenancy (X-Scope-OrgID), MinIO làm object store cho Mimir/Loki/Tempo/Pyroscope. Single-instance = central với 0 member, tenant local.
Quyết định chi tiết: docs/design-docs/.
| Mode | Mục đích | Layout |
|---|---|---|
| Single-instance | Homelab, dev, demo | Tất cả component trên 1 host (Docker Compose) |
| Central + members | Small production, multi-server | Central nhận push từ N member nodes; member chỉ chạy Alloy |
Cùng codebase, cùng config schema. Single-instance là central + members = 0.
Design phase. Repo hiện chỉ chứa docs định hướng. Code chưa bắt đầu.
MIT — xem LICENSE.