4. 创建第一个库面板：从已有面板创建库面板，命名规范与版本管理，库面板的权限控制

库面板（Library Panel）是 Grafana 面板复用的核心载体。本章将带你完成从已有面板创建库面板的完整流程，并深入讲解命名规范、版本管理机制以及权限控制策略，确保团队协作中的复用安全与一致性。

4.1 从已有面板创建库面板

假设你已经在某个 Dashboard 中完成了一个“黄金指标”面板的调优，现在希望将其发布为库面板供其他仪表盘引用。操作路径如下：

1. 进入面板编辑模式：在目标 Dashboard 中，点击面板标题 → Edit。
2. 打开面板选项：点击右侧面板编辑区的 General 标签。
3. 创建库面板：在 Library panel 区域，点击 Create library panel 按钮。
4. 填写元数据：在弹出的对话框中输入面板名称、描述，并选择保存的文件夹。
5. 确认创建：点击 Create，原面板即被替换为库面板引用。

4.2 命名规范与版本管理

4.2.1 命名规范

库面板的命名直接影响团队检索效率和复用准确性。建议采用以下分层命名结构：

完整示例：api-gateway_latency-p99_by-route

4.2.2 版本管理机制

Grafana 的库面板自带版本管理功能，每次保存修改都会自动生成一个新版本。关键操作如下：

• 查看版本历史：在库面板编辑页面 → Versions 标签，可查看所有历史版本及修改时间、修改人。
• 版本对比：选择两个版本，点击 Compare 可查看 JSON 差异。
• 版本回滚：点击目标版本的 Restore 按钮，即可将面板恢复至该版本状态。

4.3 库面板的权限控制

库面板的权限独立于 Dashboard 权限体系，需要单独配置。权限控制分为三个层级：

4.3.1 配置权限的步骤

1. 进入 Library panels 页面（Dashboards → Library panels）。
2. 找到目标库面板，点击右侧 Permissions 图标（锁形）。
3. 点击 Add permission，选择用户、团队或角色。
4. 分配对应的权限级别（View / Edit / Admin）。
5. 点击 Save 生效。

4.3.2 权限继承与覆盖规则

• 文件夹级权限：如果库面板存放在某个文件夹中，默认继承该文件夹的权限。
• 面板级覆盖：在库面板上单独设置的权限会覆盖文件夹级权限。
• 最高权限优先：如果用户同时属于多个团队，取最高权限。

4.4 实战：创建第一个库面板

以下是一个完整的操作示例，假设你已有一个名为“API P99 Latency”的面板：

# 步骤 1：进入面板编辑
# 在 Dashboard 中点击面板标题 → Edit

# 步骤 2：创建库面板
# 右侧面板 → General → Library panel → Create library panel

# 步骤 3：填写元数据
# Name: api-gateway_latency-p99_by-route
# Description: API Gateway P99 延迟，按路由分组
# Folder: /Shared/Library Panels/API Gateway

# 步骤 4：确认创建
# 点击 Create，面板变为引用状态

# 步骤 5：验证
# 在 Library panels 页面查看新创建的面板
# 确认版本号为 v1.0