> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flashcat.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# 数据源管理

> 配置和管理 Monitors 的数据源，包括 Prometheus、Elasticsearch、Loki、ClickHouse、MySQL、Oracle、PostgreSQL、SLS、VictoriaLogs 等类型

数据源是告警引擎查询数据的来源。你需要先配置数据源，告警引擎才能从中读取数据进行异常判定。

**菜单入口**：数据源

## 支持的数据源类型

Monitors 支持以下 9 种数据源类型：

| 类型                | 说明                              |
| ----------------- | ------------------------------- |
| **Prometheus**    | 时序数据库，通过 PromQL 查询              |
| **Elasticsearch** | 分布式搜索与分析引擎                      |
| **Loki**          | 轻量级日志聚合系统                       |
| **ClickHouse**    | 列式分析数据库                         |
| **MySQL**         | 关系型数据库                          |
| **Oracle**        | 关系型数据库                          |
| **PostgreSQL**    | 关系型数据库                          |
| **SLS**           | 阿里云日志服务                         |
| **VictoriaLogs**  | 日志数据库，VictoriaMetrics 生态的日志解决方案 |

## 数据源列表

数据源列表展示所有已配置的数据源，包括以下信息：

* **名称**：数据源的标识名称
* **类型**：数据源类型及图标
* **连接地址**：数据源的访问地址
* **关联告警引擎**：绑定的告警引擎集群名称，附带引擎在线状态指示
* **备注**：补充说明

你可以通过搜索框按名称或类型过滤数据源。列表每 5 秒自动刷新，实时反映引擎连接状态。

## 新建数据源

<Steps>
  <Step title="选择数据源类型">
    点击**新建**按钮，在表单顶部选择数据源类型（如 Prometheus、MySQL 等）。
  </Step>

  <Step title="填写基本信息">
    | 配置项        | 说明                                           |
    | ---------- | -------------------------------------------- |
    | **名称**     | 数据源的唯一标识名称，告警规则可通过名称通配或精确匹配两种方式关联数据源（详见下方说明） |
    | **备注**     | 可选的补充说明                                      |
    | **关联告警引擎** | 选择负责查询该数据源的引擎集群，通常选择与数据源同机房的集群               |
  </Step>

  <Step title="配置连接参数">
    根据数据源类型填写对应的连接参数，详见下方各类型说明。
  </Step>

  <Step title="保存">
    点击**确定**完成创建。
  </Step>
</Steps>

### 告警规则关联数据源的两种方式

告警规则支持两种方式绑定数据源，可以同时使用，至少填写一种。规则会作用于两种方式匹配到的所有数据源的并集。

| 绑定方式     | 字段          | 匹配逻辑                                            | 适用场景                       |
| -------- | ----------- | ----------------------------------------------- | -------------------------- |
| **名称通配** | `数据源（名称通配）` | 按名称做通配符匹配。`*` 匹配所有数据源；`Prom*` 匹配名称以 Prom 开头的数据源 | 需要动态匹配一批数据源，例如同类型数据源统一命名前缀 |
| **精确匹配** | `数据源（精确匹配）` | 按数据源 ID 精确关联，从下拉列表中选择具体数据源                      | 需要精确绑定特定数据源，不受数据源改名影响      |

<Warning>
  名称通配方式存储的是名称字符串，如果数据源改名，已有的通配规则可能不再匹配。精确匹配方式存储的是数据源 ID，不受改名影响。如果对稳定性要求高，建议优先使用精确匹配。
</Warning>

## 各数据源类型配置

### Prometheus

| 配置项                                 | 说明                                        |
| ----------------------------------- | ----------------------------------------- |
| **Server URL**                      | Prometheus 服务地址，如 `http://localhost:9090` |
| **Headers**                         | 自定义 HTTP 请求头，支持添加多组 Key-Value             |
| **Params**                          | 自定义 URL 查询参数，支持添加多组 Key-Value             |
| **Basic Authentication**            | 启用后需填写用户名和密码                              |
| **Self-Signed Certificate**         | 启用后填写 CA 证书内容                             |
| **TLS Client Authentication**       | 启用后需填写 ServerName、客户端证书和客户端密钥             |
| **Skip TLS Certificate Validation** | 跳过 TLS 证书验证                               |

### MySQL / Oracle / PostgreSQL

关系型数据库共享相似的配置结构：

| 配置项           | 说明                                                                                    | 默认值  |
| ------------- | ------------------------------------------------------------------------------------- | ---- |
| **连接地址**      | 数据库地址，如 `localhost:3306`（MySQL）、`localhost:1521`（Oracle）、`localhost:5432`（PostgreSQL） | -    |
| **最大连接数**     | 连接池最大打开连接数                                                                            | 32   |
| **空闲连接数**     | 连接池最大空闲连接数                                                                            | 4    |
| **连接存活时长（秒）** | 连接最大存活时间                                                                              | 600  |
| **超时时间（毫秒）**  | 查询超时时间                                                                                | 5000 |
| **用户名**       | 数据库用户名                                                                                | -    |
| **密码**        | 数据库密码                                                                                 | -    |

同样支持自签名证书和 TLS 客户端认证配置。

### Elasticsearch / Loki / ClickHouse / SLS / VictoriaLogs

这些数据源的连接配置与 Prometheus 类似，包括服务地址、认证和 TLS 配置。其中 VictoriaLogs 的默认服务地址为 `http://localhost:9428`。具体参数请参考创建表单中的说明。

## 测试数据源

在数据源列表中，点击对应数据源的**测试**按钮，可以打开查询预览窗口，验证数据源连接是否正常并预览查询结果。

## 编辑和删除

* **编辑**：在数据源列表中点击**编辑**按钮，修改数据源配置后保存。
* **删除**：在数据源列表中点击**删除**按钮，确认后删除数据源。

<Warning>
  删除数据源前，请确保没有告警规则引用该数据源，否则相关告警规则将无法正常执行。
</Warning>