Auto-sync: 2026-04-22 04:02

wiki/entities/Prometheus.md

@@ -0,0 +1,63 @@
+---
+title: "Prometheus"
+type: entity
+aliases: [Prometheus OSS, Prometheus监控]
+tags: [monitoring, observability, time-series, alerting, prometheus]
+date: 2025-11-11
+---
+
+# Prometheus
+
+## Overview
+Prometheus 是 CNCF 毕业的开源系统监控和告警工具包，最初由 SoundCloud 开发，现已广泛用于云原生和家居服务器环境。作为时序数据库，Prometheus 通过 pull 模式定期从已配置的 targets 抓取指标数据，支持强大的 PromQL 查询语言和灵活的告警规则引擎。
+
+## Key Characteristics
+- **Pull 模式**：Prometheus 服务器定期从各 exporter 的 HTTP `/metrics` 端点拉取指标，无需在被监控主机安装代理
+- **PromQL**：强大的查询语言，支持聚合、函数、即时向量和范围向量查询
+- **告警规则**：基于 PromQL 表达式定义告警条件，触发后发送给 Alertmanager
+- **多数据出口**：支持 Remote Write 远端写入（VictoriaMetrics/Thanos/Cortex）、Grafana 可视化
+- **服务发现**：支持 Kubernetes、Consul、静态配置等多种发现机制
+
+## Home Server Deployment
+```yaml
+# docker-compose.yml 片段
+prometheus:
+  image: prom/prometheus:latest
+  container_name: prometheus
+  volumes:
+    - ./prometheus/prometheus.yml:/etc/prometheus/prometheus.yml:ro
+    - ./prometheus/alerts.yml:/etc/prometheus/alerts.yml:ro
+  ports:
+    - "9090:9090"
+  command:
+    - '--config.file=/etc/prometheus/prometheus.yml'
+    - '--storage.tsdb.path=/prometheus'
+    - '--web.enable-lifecycle'
+```
+
+## Core Metrics Types
+| 类型 | 示例 | 说明 |
+|------|------|------|
+| Gauge | `node_memory_MemAvailable_bytes` | 可增可减的当前值 |
+| Counter | `node_cpu_seconds_total` | 只增不减的累计值 |
+| Histogram | `prometheus_http_request_duration_seconds_bucket` | 分布统计 |
+| Summary | `go_gc_duration_seconds` | 分位数统计 |
+
+## Related Sources
+- [[家庭监控方案-prometheus-grafana-node-exporter-cadvisor-blackbox]]
+
+## Related Entities
+- [[Grafana]] — 可视化层
+- [[Alertmanager]] — 告警分发
+- [[node_exporter]] — 主机指标采集
+- [[cAdvisor]] — 容器指标采集
+- [[blackbox_exporter]] — HTTP/TCP 探测
+- [[Uptime Kuma]] — 合成监控（互补）
+
+## Related Concepts
+- [[PromQL]] — Prometheus 查询语言
+- [[Prometheus告警规则]] — 告警条件定义
+- [[Exporter]] — 指标暴露组件
+- [[时序数据库]] — 数据存储模式
+- [[System Monitoring]] — 上游领域
+- [[Centralized Logging]] — 可互补的日志聚合方案