Prometheus 项目文档教程

1. 项目目录结构及介绍

Prometheus 项目的文档仓库 (prometheus/docs) 的目录结构如下：

docs/
├── content/
│   ├── getting_started.md
│   ├── installation.md
│   ├── configuration/
│   │   ├── configuration.md
│   │   ├── rules.md
│   │   └── ...
│   ├── querying/
│   │   ├── query_language.md
│   │   ├── examples.md
│   │   └── ...
│   ├── storage/
│   │   ├── local_storage.md
│   │   ├── remote_storage.md
│   │   └── ...
│   ├── alerting/
│   │   ├── alerting_rules.md
│   │   ├── alert_manager.md
│   │   └── ...
│   ├── ...
│   └── index.md
├── static/
│   ├── images/
│   └── ...
├── themes/
│   └── hugo-theme-relearn/
└── config.toml

目录结构介绍

• content/: 包含所有文档内容，按照不同的主题进行分类，如入门指南、安装、配置、查询、存储、告警等。
• static/: 存放静态资源文件，如图片等。
• themes/: 存放文档网站的主题文件。
• config.toml: 文档网站的配置文件。

2. 项目的启动文件介绍

Prometheus 项目的启动文件是 prometheus 二进制文件。启动 Prometheus 服务器的命令如下：

./prometheus --config.file=prometheus.yml

启动文件参数介绍

• --config.file: 指定 Prometheus 的配置文件路径，默认是 prometheus.yml。
• --web.listen-address: 指定 Prometheus 服务器监听的地址和端口，默认是 0.0.0.0:9090。
• --storage.tsdb.path: 指定 Prometheus 存储数据的目录，默认是 data/。

3. 项目的配置文件介绍

Prometheus 的配置文件是 prometheus.yml，通常位于项目的根目录下。配置文件使用 YAML 格式编写。

配置文件结构

global:
  scrape_interval: 15s
  evaluation_interval: 15s

scrape_configs:
  - job_name: 'prometheus'
    static_configs:
      - targets: ['localhost:9090']

alerting:
  alertmanagers:
    - static_configs:
        - targets: ['localhost:9093']

rule_files:
  - "first_rules.yml"
  - "second_rules.yml"

配置文件参数介绍

• global: 全局配置项，如 scrape_interval 和 evaluation_interval。
• scrape_configs: 定义 Prometheus 抓取目标的配置，包括 job_name 和 targets。
• alerting: 定义告警管理器的配置，包括 alertmanagers 和 targets。
• rule_files: 定义告警规则文件的路径。

通过以上配置，Prometheus 可以自动抓取目标的指标数据，并根据规则文件触发告警。