Windows 11 启动 Grafana 报错:Failed to get renderer plugin sources

排查与解决 Grafana 渲染器插件路径错误

检查插件目录是否存在

Grafana 默认在安装目录的 data\plugins 文件夹中查找插件。若目录缺失或路径错误,需手动创建或修复路径。

  • 定位 Grafana 安装目录(如 C:\Program Files\GrafanaLabs\grafana),检查 data\plugins 是否存在。

  • 若目录不存在,右键点击 data 文件夹,新建子文件夹并命名为 plugins

    博主是因为插件目录不存在导致的报错,大家根据自己的报错情况自行选择处理方案

安装渲染器插件

Grafana 的渲染功能依赖 grafana-image-renderer 插件。若未安装,需通过命令行工具安装。

  • 以管理员身份打开命令提示符,切换到 Grafana 的 bin 目录(如 cd C:\Program Files\GrafanaLabs\grafana\bin)。

  • 执行安装命令:

    batch 复制代码
    grafana-cli.exe plugins install grafana-image-renderer
  • 安装完成后重启 Grafana 服务。

调整权限设置

权限不足可能导致无法访问插件目录。需确保运行 Grafana 的用户拥有足够权限。

  • 右键点击 grafana-server.exe,选择"以管理员身份运行"。
  • 检查文件夹权限:右键点击 Grafana 安装目录 → 属性 → 安全 → 赋予当前用户"修改"和"读取执行"权限。
验证配置文件路径

若手动修改过配置文件,可能导致路径指向无效位置。需恢复默认配置或修正路径。

  • 打开 conf\defaults.iniconf\custom.ini,检查 [paths] 部分:

    ini 复制代码
    [paths]
    plugins = data/plugins
  • 若路径被修改,删除自定义配置或恢复为默认值。

临时禁用渲染器插件(测试用)

若问题仍未解决,可临时禁用渲染器功能以确认问题来源。

  • conf\custom.ini 中添加以下配置:

    ini 复制代码
    [rendering]
    enabled = false
  • 重启 Grafana 并观察日志是否仍有报错。


验证解决方案

  • 重启 Grafana 服务,检查 data\logs\grafana.log 是否仍有错误。
  • 访问 http://localhost:3000,确认界面能否正常加载。
  • 若问题解决,重新启用渲染器插件以恢复完整功能。