3、首次启动与界面导航：登录、主界面布局、菜单功能、数据源与仪表盘的基本概念
当您完成 Grafana 的安装并启动服务后，面对的第一个界面往往既让人兴奋又略带陌生。作为数据可视化领域的标准工具，Grafana 的界面设计遵循“配置驱动、视图分离”的原则：所有数据接入、面板构建和告警策略都通过统一的 Web 控制台完成。本章将带您完成首次登录，系统拆解主界面的功能分区，并厘清“数据源”与“仪表盘”这两个核心对象的关系。理解这些基础概念，是后续构建复杂可视化大屏的基石。
上图清晰地展示了 Grafana 首次启动后需要掌握的四层逻辑关系：登录认证是入口，主界面布局是操作框架，菜单功能是导航工具，而数据源与仪表盘则是整个可视化体系的两大支柱。下面我们将逐一深入每个环节。
3.1 首次登录与初始配置
核心原理：默认凭证与安全策略
Grafana 安装完成后，服务默认监听 3000 端口。首次访问 http://服务器IP:3000 时，系统会跳转到登录页面。默认管理员账号为 admin，密码为 admin。这里有一个关键的安全设计：Grafana 强制要求首次登录后修改默认密码。这一机制是为了避免因默认凭证未修改而导致的数据泄露风险。修改密码后，系统会要求您填写当前密码、新密码和确认密码，新密码需满足最小长度要求（默认 4 位，建议使用更复杂的组合）。
user 表重置，或使用 CLI 命令 grafana-cli admin reset-admin-password 进行重置。但切勿在公网环境使用默认密码，否则极易被扫描工具攻击。
操作流程：从登录到进入主界面
- 在浏览器中打开 Grafana 地址，看到登录表单。
- 输入
admin/admin，点击 Log In。 - 系统弹出“Change Password”强制修改页面，输入新密码并确认。
- 点击 Submit 后，系统自动跳转到 Grafana 首页（Home Dashboard）。
首页默认展示一个欢迎仪表盘，包含一些示例面板和快速入门链接。此时您已经完成了登录流程，可以开始探索界面了。
3.2 主界面布局与功能分区
核心原理：左侧边栏与顶部导航的协作
Grafana 的主界面采用经典的 “左侧边栏 + 顶部区域” 布局。左侧边栏是核心导航区，包含所有主要功能的入口；顶部区域则根据当前页面动态变化，通常显示搜索框、时间选择器、刷新按钮和用户菜单。这种设计的优势在于：无论您身处哪个页面，都可以通过左侧边栏快速跳转到其他功能模块，而顶部的时间选择器则全局控制所有面板的数据时间范围。
| 界面区域 | 主要元素 | 功能说明 |
|---|---|---|
| 左侧边栏顶部 | Grafana Logo、搜索图标 | 点击 Logo 返回首页；搜索图标用于全局搜索仪表盘、面板、数据源等 |
| 左侧边栏中部 | Dashboard、Explore、Alerting、Configuration 等图标 | 各功能模块的入口，鼠标悬停会显示文字提示 |
| 左侧边栏底部 | 用户头像、帮助文档、版本信息 | 用户菜单可切换组织、退出登录；帮助文档链接至官方文档 |
| 顶部区域 | 时间选择器、刷新按钮、仪表盘设置 | 时间选择器控制数据查询的时间范围；刷新按钮手动触发数据更新 |
判断方法：如何快速定位功能
如果您需要创建一个新仪表盘，应该点击左侧边栏的 “+” 图标（或 Dashboard 图标下的 New Dashboard 按钮）。如果您想临时查询数据并验证查询语句，应该进入 Explore 模块。如果您需要配置告警规则，则进入 Alerting 模块。理解每个图标对应的功能域，可以避免在界面中盲目寻找。
3.3 菜单功能详解
核心原理：模块化设计思想
Grafana 的菜单功能遵循模块化设计，每个模块解决一类特定问题。以下是核心菜单的详细说明：
- Dashboard（仪表盘）：管理所有仪表盘资源，支持新建、导入、导出、搜索和文件夹管理。这是日常使用最频繁的模块。
- Explore（探索）：提供一个临时查询界面，允许您直接连接数据源编写查询语句，并以图表形式快速预览结果。适合调试查询和探索数据。
- Alerting（告警）：集中管理告警规则、通知策略和静默设置。Grafana 告警支持多数据源、多条件判断，并可对接钉钉、邮件、Webhook 等渠道。
- Configuration（配置）：包含数据源管理、用户管理、团队管理、插件管理、s 和系统设置等。这是管理员进行系统级配置的核心区域。
- Server Admin（服务器管理）：仅超级管理员可见，用于管理用户、组织和系统全局设置。
3.4 数据源与仪表盘的基本概念
核心原理：数据源是“水管”，仪表盘是“水龙头”
在 Grafana 中，数据源（Data Source） 是指您要从中查询数据的系统，例如 Prometheus、MySQL、InfluxDB、Elasticsearch 或 ClickHouse。数据源定义了连接信息（如地址、端口、认证方式）和查询能力。而 仪表盘（Dashboard） 是一个可视化的容器，它包含一个或多个 面板（Panel），每个面板通过查询数据源获取数据，并以图表、表格、日志等形式展示。
理解两者的关系至关重要：数据源是后端数据访问层，仪表盘是前端展示层。一个仪表盘可以引用多个数据源，一个数据源也可以被多个仪表盘使用。在创建面板时，您需要先选择数据源，然后编写查询语句（如 PromQL、SQL），Grafana 会将查询结果转换为可视化图表。
操作流程：添加第一个数据源
- 点击左侧边栏的 Configuration（齿轮图标），选择 Data Sources。
- 点击右上角的 Add data source 按钮。
- 在类型列表中选择您需要的数据库类型（例如 Prometheus）。
- 填写连接参数：URL（如
http://localhost:9090）、访问方式（Server 或 Browser）、是否开启 TLS 认证等。 - 点击 Save & Test，如果配置正确，系统会提示 “Data source is working”。
案例拆解：从零搭建一个系统监控仪表盘
假设您已经有一个 Prometheus 数据源，并且采集了 CPU 使用率指标 node_cpu_seconds_total。现在我们要创建一个简单的仪表盘来展示 CPU 使用率。
背景与目标：运维团队需要实时监控一台 Linux 服务器的 CPU 空闲率，以便在负载过高时及时扩容。
操作步骤：
- 点击左侧边栏 Dashboard，选择 New Dashboard，然后点击 Add panel。
- 在面板编辑器中，选择数据源为
Prometheus。 - 在查询编辑器中输入 PromQL 表达式：
100 - (avg by (instance) (rate(node_cpu_seconds_total{mode="idle"}[5m])) * 100)。 - 右侧预览区域会立即显示图表。调整图表类型为 Time series，并设置标题为 “CPU 使用率”。
- 点击右上角 Apply 保存面板，然后点击 Save dashboard 保存整个仪表盘。
结果与复盘：通过这个案例，您可以看到数据源和仪表盘的协作流程：数据源提供原始指标，仪表盘通过面板查询并渲染。如果查询结果为空，请检查数据源连接是否正常、指标名称是否正确、时间范围是否覆盖了数据点。常见误区是忘记切换时间范围，导致查询不到历史数据。
3.5 常见误区与总结复盘
误区一：混淆数据源与仪表盘的关系
很多初学者会试图在仪表盘里直接“导入数据”，这是错误的。仪表盘本身不存储数据，它只是数据的“消费者”。您必须先配置好数据源，然后在面板中引用它。
误区二：忽略时间范围设置
Grafana 默认查询最近 6 小时的数据。如果您刚添加了数据源，但图表显示空白，请检查右上角的时间选择器是否覆盖了数据产生的时间段。例如，如果数据是昨天写入的，您需要将时间范围调整为“Last 24 hours”或自定义范围。
误区三：在 Explore 中修改了查询却忘记保存
Explore 是一个临时工作区，它的查询结果不会自动保存到仪表盘。如果您在 Explore 中调试好了一个查询，需要手动复制查询语句，然后粘贴到仪表盘的面板编辑器中。