Grafana 配置基础

本节将学习：配置文件的位置、基本配置项、数据源配置，以及用户和权限配置。这些是配置 Grafana 的基础知识。

配置文件位置

Grafana 配置文件在哪里？ 配置文件的位置取决于你的安装方式。

Ubuntu：/etc/grafana/grafana.ini
Windows：C:\grafana\conf\grafana.ini
macOS：/usr/local/etc/grafana/grafana.ini
Docker：/etc/grafana/grafana.ini

grafana.ini 是什么？ grafana.ini 是 Grafana 的主配置文件，包含所有 Grafana 的配置选项。

环境变量配置： Grafana 也支持通过环境变量配置，环境变量会覆盖配置文件中的设置。

例如：

```
GF_SERVER_HTTP_PORT=3000
```
：设置 HTTP 端口
```
GF_SECURITY_ADMIN_PASSWORD=secret
```
：设置管理员密码

这就是配置文件的位置。

基本配置项

Grafana 有哪些基本配置项呢？

第一个是 server。 服务器配置。

```
http_port
```
：HTTP 端口，默认是 3000。
```
domain
```
：域名，例如 localhost。
```
root_url
```
：根 URL，例如 http://localhost:3000。

第二个是 database。 数据库配置。

```
type
```
：数据库类型，可以是 sqlite3、mysql、postgres。默认是 sqlite3。
```
path
```
：数据库文件路径（SQLite），例如 grafana.db。

第三个是 security。 安全配置。

```
admin_user
```
：管理员用户名，默认是 admin。
```
admin_password
```
：管理员密码，默认是 admin。建议修改。
```
secret_key
```
：加密密钥，用于加密敏感数据。

第四个是 log。 日志配置。

```
mode
```
：日志模式，可以是 console、file。
```
level
```
：日志级别，可以是 debug、info、warn、error。默认是 info。

这就是 Grafana 基本配置项。这些是最常用的配置项。

数据源配置

数据源可以通过什么方式配置呢？

第一种方式：UI 配置（推荐）。 在 Grafana UI 中配置，易于管理和修改。这是最常用的方式。

第二种方式：配置文件配置。 在 grafana.ini 或 provisioning 配置，适合自动化部署。

UI 配置步骤：

登录 Grafana。
进入 Configuration > Data Sources。
点击 Add data source。
选择数据源类型，例如 Prometheus。
配置连接信息，例如 URL。
测试连接，确保连接正常。
保存配置。

配置文件示例（Provisioning）： 使用 provisioning 配置，适合自动化部署。

# datasources.yaml
apiVersion: 1

datasources:
  - name: Prometheus
    type: prometheus
    access: proxy
    url: http://prometheus:9090
    isDefault: true

这个配置展示了如何通过配置文件配置数据源。配置了 Prometheus 数据源，URL 是 http://prometheus:9090，设置为默认数据源。

这就是数据源配置。我们等一下会详细讲如何连接 Prometheus 数据源。

用户和权限配置

Grafana 支持多用户和权限管理。

用户角色有哪些呢？

Admin： 管理员，拥有所有权限。可以管理用户、配置数据源、创建 Dashboard 等。
Editor： 编辑者，可以创建和编辑 Dashboard。但不能管理用户和配置数据源。
Viewer： 查看者，只能查看 Dashboard。不能创建和编辑 Dashboard。

用户管理： 在 Grafana UI 中管理用户。

进入 Administration > Users。
点击 Invite user。
输入用户信息，例如邮箱、用户名。
选择角色，例如 Editor、Viewer。
发送邀请。

权限配置：

组织权限： 用户属于一个或多个组织，每个组织可以有不同的权限。

Dashboard 权限： 可以设置 Dashboard 的权限，控制谁可以查看和编辑。

配置文件示例：

[users]
allow_sign_up = false
allow_org_create = false
auto_assign_org = true
auto_assign_org_role = Viewer

这个配置展示了如何配置用户。

allow_sign_up = false

表示不允许用户注册，

auto_assign_org_role = Viewer

表示自动分配的角色是 Viewer。

这就是用户和权限配置。可以根据需要配置用户和权限。

本节小结

在本节中，我们学习了 Grafana 配置基础：

第一个是配置文件位置。 根据安装方式不同而不同，Ubuntu、Windows、macOS、Docker 都有不同的位置。

第二个是基本配置项。 server、database、security、log。这些是最常用的配置项。

第三个是数据源配置。 UI 配置或配置文件配置。UI 配置适合手动管理，配置文件配置适合自动化部署。

第四个是用户和权限。 Admin、Editor、Viewer 三种角色。可以根据需要配置用户和权限。

配置结构： Grafana 配置包括基本配置、数据源配置、用户权限。这些配置组合在一起，构成了完整的 Grafana 配置。

这就是 Grafana 配置基础。理解这些基础知识，是掌握 Grafana 的关键。

在下一节，我们将学习连接 Prometheus 数据源。学习如何添加和配置 Prometheus 数据源，测试连接，配置认证。