如何在Grafana仪表盘中正确显示自定义面板插件？

1. 确认插件已成功加载到Grafana容器 #

• 启动yarn server后，查看终端日志，确认存在类似Loading plugin my-panel-plugin的加载成功提示
• 检查项目根目录package.json中的grafana配置段，确保id（如my-panel-plugin）和type设置为panel，示例：

  "grafana": {
    "id": "my-panel-plugin",
    "type": "panel",
    "name": "My Panel Plugin"
  }
  

• 确保yarn dev持续运行，开发模式下插件会实时构建到dist目录，容器通过挂载该目录加载插件

2. 手动添加自定义面板到仪表盘 #

• 访问http://localhost:3000，使用默认账号admin/admin登录
• 点击左侧菜单栏的「+」→「Dashboard」进入空白仪表盘
• 点击「Add panel」→「Add a new panel」
• 在面板选择界面，搜索你的插件名称my-panel-plugin，选中后即可将自定义面板添加到仪表盘

3. 消除provisioning目录报错 #

• 报错原因是Grafana容器默认尝试读取/etc/grafana/provisioning目录，但新版@grafana/create-plugin不再自动生成该目录
• 在项目根目录手动创建空的provisioning文件夹
• 打开项目自动生成的docker-compose.yml，确认volumes中包含./provisioning:/etc/grafana/provisioning映射，若没有则添加：

  volumes:
    - ./dist:/var/lib/grafana/plugins/my-panel-plugin
    - ./provisioning:/etc/grafana/provisioning
  

• 重启yarn server，日志中的provisioning相关报错会消失

4. 可选：预配置默认仪表盘（启动即显示） #

• 在provisioning/dashboards目录下创建dashboard.yml，写入以下配置：

  apiVersion: 1
  providers:
    - name: 'Default Dashboard'
      orgId: 1
      folder: ''
      type: file
      disableDeletion: false
      updateIntervalSeconds: 10
      options:
        path: /var/lib/grafana/dashboards
  

• 在项目根目录创建dashboards文件夹，将手动创建的仪表盘导出为JSON文件放入该目录
• 修改docker-compose.yml的volumes，添加仪表盘目录映射：

  volumes:
    - ./dist:/var/lib/grafana/plugins/my-panel-plugin
    - ./provisioning:/etc/grafana/provisioning
    - ./dashboards:/var/lib/grafana/dashboards
  

• 重启容器后，Grafana会自动加载预配置的仪表盘

内容的提问来源于stack exchange，提问作者Hongbo Miao