GeekIt

Grafana CLI命令速查

服务启停、CLI 与配置、插件管理、管理员密码、数据库迁移、Provisioning、HTTP API、告警、备份与排障等 125 条命令

共 125 条命令 · 11 类场景 · 点击右侧图标可复制

命令 / 配置说明复制
grafana --version查看服务端版本
grafana server前台启动(10.x 推荐命令)
grafana server --homepath /usr/share/grafana --config /etc/grafana/grafana.ini指定安装目录与配置文件启动
grafana server cfg:default.paths.data=/var/lib/grafana用命令行覆盖单个配置项
grafana server --profile开启 CPU profiling,排查性能问题
grafana-server --config /etc/grafana/grafana.ini旧版二进制启动方式(9.x 及之前)
systemctl start grafana-serversystemd 方式启动
systemctl status grafana-server查看服务状态与最近日志
journalctl -u grafana-server -f实时查看服务日志
ss -lntp | grep 3000确认 3000 端口监听
curl -s http://localhost:3000/api/health健康检查,返回 database 状态与版本
docker run -d -p 3000:3000 -v grafana-data:/var/lib/grafana grafana/grafana容器方式启动
命令 / 配置说明复制
grafana cli --help查看 CLI 子命令(等价于旧版 grafana-cli)
grafana cli --version查看 CLI 版本
grafana cli --config /etc/grafana/grafana.ini plugins list-remote指定配置执行 CLI 命令
grafana cli --homepath /usr/share/grafana --pluginsDir /var/lib/grafana/plugins plugins list-remote指定 homepath 与插件目录
grafana cli --help-long查看带参数说明的完整帮助
/etc/grafana/grafana.ini主配置文件,升级时不要被模板覆盖
/usr/share/grafana/conf/defaults.ini默认配置参考,不要直接修改
GF_SERVER_HTTP_PORT=3000环境变量覆盖配置,容器部署最常用
GF_SECURITY_ADMIN_PASSWORD=admin123首次启动设置管理员密码
GF_PATHS_PROVISIONING=/etc/grafana/provisioning指定 provisioning 目录
GF_PATHS_DATA=/var/lib/grafana数据目录必须可写,否则启动失败
优先级:环境变量 > grafana.ini > defaults.ini排查“改了没生效”先确认是否被环境变量覆盖
命令 / 配置说明复制
grafana cli plugins list-remote列出官方仓库可用插件
grafana cli plugins list-remote | grep -i clock按关键字筛选插件
grafana cli plugins install grafana-clock-panel安装插件
grafana cli plugins install grafana-clock-panel 1.3.6安装指定版本,生产建议锁版本
grafana cli plugins list-versions grafana-clock-panel查看可安装版本
grafana cli plugins update-all升级全部插件
grafana cli plugins remove grafana-clock-panel卸载插件
grafana cli --pluginsDir /var/lib/grafana/plugins plugins install <id>指定插件目录安装(多实例共享目录时使用)
GF_PLUGINS_PREINSTALL=grafana-clock-panel,grafana-simple-json-datasource容器启动时预装插件
GF_PLUGINS_ALLOW_LOADING_UNSIGNED_PLUGINS=my-plugin允许加载未签名插件(谨慎)
systemctl restart grafana-server安装插件后需要重启生效
插件目录权限要与 grafana 用户一致权限错误会导致插件加载失败
命令 / 配置说明复制
grafana cli admin reset-admin-password NewPass123重置 admin 密码(最常用的救急命令)
echo "NewPass123" | grafana cli admin reset-admin-password --password-from-stdin从标准输入读密码,避免进入历史记录
grafana cli --config /etc/grafana/grafana.ini admin reset-admin-password NewPass123指定配置重置(多实例或多库时必带)
GF_SECURITY_ADMIN_USER=admin GF_SECURITY_ADMIN_PASSWORD=xxx首次启动初始化管理员账号
grafana cli admin reset-admin-password --help查看该子命令的全部参数
重置密码后确认数据库连接的是同一实例连错库会“重置成功但登录依旧失败”
忘记 admin 用户名时查数据库 user 表login 字段即为用户名,is_admin 标记管理员
命令 / 配置说明复制
[database] type = mysql host = 10.0.0.21:3306 name = grafana user = grafana password = xxxgrafana.ini 中配置外部数据库
GF_DATABASE_TYPE=postgres GF_DATABASE_HOST=db:5432 GF_DATABASE_NAME=grafana环境变量方式配置数据库
grafana server启动时自动执行数据库迁移
sqlite3 /var/lib/grafana/grafana.db ".tables"查看 sqlite 库中的表
sqlite3 /var/lib/grafana/grafana.db "select id,login,email,is_admin from user;"查看用户,确认管理员账号
sqlite3 /var/lib/grafana/grafana.db "select version from migration_log order by id desc limit 1;"查看当前数据库版本
mysql -u grafana -p grafana -e "select * from migration_log order by id desc limit 5;"MySQL 下查看迁移记录
database is lockedsqlite 并发写入限制,生产建议换 MySQL/PostgreSQL
升级前先备份数据库跨大版本升级迁移不可回退
max_open_conn / max_idle_conn连接池参数,数据库连接打满时调整
命令 / 配置说明复制
/etc/grafana/provisioning/datasources/ds.yaml数据源定义文件,启动时自动导入
/etc/grafana/provisioning/dashboards/dash.yaml仪表板提供者配置(路径与文件夹)
/etc/grafana/provisioning/alerting/rules.yaml告警规则与通知策略配置
apiVersion: 1 datasources: - name: Prometheus type: prometheus url: http://prometheus:9090 isDefault: true数据源 YAML 模板
providers: - name: default folder: Prod type: file options: path: /var/lib/grafana/dashboards仪表板提供者模板:目录下 JSON 自动加载
updateIntervalSeconds: 10provisioning 扫描间隔,修改文件后自动生效
allowUiUpdates: false禁止 UI 修改被覆盖,配置即代码场景建议 false
GF_PATHS_PROVISIONING=/etc/grafana/provisioning自定义 provisioning 根目录
仪表板 JSON 需放在 providers 指定目录文件不存在或 JSON 非法会被跳过并写日志
provisioning 覆盖 UI 修改UI 改动会在下次扫描被还原,排障前先确认是否被接管
命令 / 配置说明复制
curl -s -u admin:pass http://localhost:3000/api/health健康检查接口
curl -s -H "Authorization: Bearer $TOKEN" http://localhost:3000/api/search?query=node搜索仪表板(Service Account Token 认证)
curl -s -u admin:pass http://localhost:3000/api/datasources列出数据源
curl -s -u admin:pass http://localhost:3000/api/folders列出文件夹
curl -X POST -H "Content-Type: application/json" -d @dashboard.json http://localhost:3000/api/dashboards/db导入或更新仪表板
curl -s http://localhost:3000/api/dashboards/uid/abc123按 UID 获取仪表板 JSON
curl -X POST -H "Content-Type: application/json" -d @ds.json http://localhost:3000/api/datasources创建数据源
curl -X POST -H "Content-Type: application/json" -d '{"name":"ci"}' http://localhost:3000/api/serviceaccounts创建服务账号用于自动化
curl -X POST http://localhost:3000/api/serviceaccounts/<id>/tokens -H "Content-Type: application/json" -d '{"name":"ci-token"}'为服务账号签发 Token
curl -s http://localhost:3000/api/admin/stats实例统计:仪表板、用户、告警数量
curl -s http://localhost:3000/api/orgs列出组织
curl -s http://localhost:3000/api/admin/users列出用户(需管理员权限)
curl -s http://localhost:3000/api/annotations?from=now-1h查询注解事件,发布标记常用
命令 / 配置说明复制
curl -s http://localhost:3000/api/v1/provisioning/alert-rules列出告警规则
curl -s http://localhost:3000/api/v1/provisioning/contact-points列出通知渠道
curl -s http://localhost:3000/api/v1/provisioning/notification-policies列出通知策略
curl -X POST -H "Content-Type: application/json" -d @rule.json http://localhost:3000/api/v1/provisioning/alert-rules创建告警规则
curl -X PUT -H "Content-Type: application/json" -d @cp.json http://localhost:3000/api/v1/provisioning/contact-points/<uid>更新通知渠道
curl -s http://localhost:3000/api/alertmanager/grafana/api/v2/alerts查看当前触发的告警
curl -X POST http://localhost:3000/api/alertmanager/grafana/api/v2/silences -d @silence.json创建静默规则,维护期屏蔽告警
curl -s http://localhost:3000/api/alertmanager/grafana/api/v2/status查看 Alertmanager 状态
contact-points 中配置 webhook 做统一接入企业微信/钉钉通常走 webhook 中转
notification-policies 决定路由与分组改完记得确认默认接收器
告警规则也可用 provisioning YAML 管理YAML 与 API 同时改容易互相覆盖,选一种方式
命令 / 配置说明复制
sqlite3 /var/lib/grafana/grafana.db ".backup '/backup/grafana-20261102.db'"sqlite 热备份,比直接 cp 安全
mysqldump -u grafana -p --single-transaction grafana > /backup/grafana.sqlMySQL 备份(一致性快照)
pg_dump -U grafana -Fc grafana > /backup/grafana.dumpPostgreSQL 备份
tar -czf /backup/grafana-conf.tgz /etc/grafana /var/lib/grafana/plugins备份配置与插件
systemctl stop grafana-server恢复前停止服务,避免写入冲突
cp /backup/grafana-20261102.db /var/lib/grafana/grafana.dbsqlite 恢复:替换数据库文件
mysql -u grafana -p grafana < /backup/grafana.sqlMySQL 恢复
chown grafana:grafana /var/lib/grafana/grafana.db恢复后权限要正确,否则启动失败
grafana cli admin reset-admin-password NewPass123恢复后如密码不明可重置
备份要包含 provisioning 与 dashboards 目录只备数据库会丢失配置即代码部分
命令 / 配置说明复制
grafana cli plugins install grafana-image-renderer安装图像渲染插件,告警截图与报表依赖它
[rendering] server_url = http://renderer:8081/render使用独立渲染服务(推荐)
GF_RENDERING_SERVER_URL=http://renderer:8081/render环境变量方式配置渲染地址
curl -s -u admin:pass "http://localhost:3000/render/d-solo/<uid>?panelId=1&width=1000&height=500" -o panel.png渲染单个面板为图片
grafana server --profile采集 CPU profile 定位卡顿
GF_LOG_LEVEL=debug开启调试日志
GF_LOG_MODE=console file同时输出到控制台与文件
curl -s http://localhost:3000/metrics | grep grafana_httpPrometheus 指标(需开启 metrics)
[metrics] enabled = true开启 /metrics 端点
curl -s http://localhost:3000/api/admin/stats实例对象数量统计
tail -f /var/log/grafana/grafana.log | grep -i error过滤错误日志
插件与渲染器会显著增加内存占用按需安装,容器部署注意 limits
命令 / 配置说明复制
GF_PATHS_DATA is not writable数据目录权限不对,chown grafana:grafana 后重启
failed to open database / database is lockedsqlite 并发限制或文件损坏,换外部数据库或恢复备份
Failed to connect to database数据库地址、账号密码或白名单问题
migrate: no migration found / migration failed数据库版本与程序不匹配,检查升级步骤与备份
plugin signature invalid / plugin is unsigned插件未签名,确认来源或配置 allow_loading_unsigned_plugins
plugin not found插件未安装或目录权限错误,list-remote 确认 id
admin password reset failed配置文件指向了别的数据库,或没有库写权限
401 UnauthorizedToken 失效、Basic Auth 密码错误或未带认证头
403 Forbidden权限不足,检查组织角色与服务账号作用域
422 Unprocessable Entity(导入仪表板)JSON 结构不合法或 datasource 引用不存在
dashboard not foundUID 或 slug 写错,也可能在别的组织
render timeout渲染服务不可达或面板查询过慢,检查 renderer 与数据源
WebSocket connection failed(Live)反代未放通 Upgrade 头或未开启 Live 功能
登录后白屏 / 静态资源 404root_url 与 serve_from_sub_path 配置不匹配
告警不发通知依次检查规则状态、通知策略、联系点与静默
升级后仪表板异常部分面板/插件不兼容,先看 grafana.log 与插件版本

运维常用组合

首次部署grafana server --config → GF_SECURITY_ADMIN_PASSWORD → /api/health → provisioning 数据源 → 导入仪表板
插件管理plugins list-remote → plugins list-versions → plugins install <id> <ver> → systemctl restart → UI 验证
密码救援grafana cli admin reset-admin-password → 确认连的是同一数据库 → 登录验证
迁移实例备份数据库 + provisioning → 新实例建库 → 恢复数据 → 权限修正 → health 校验
自动化接入创建 service account → 签发 token → /api/dashboards/db 导入 → /api/search 校验
告警排障/api/v1/provisioning/alert-rules → contact-points → notification-policies → alertmanager v2/alerts → 检查静默

常见问题排查

1. 生产用外部数据库

sqlite 并发能力有限,多实例或高写入场景换 MySQL/PostgreSQL

2. 配置即代码优先

数据源与仪表板用 provisioning 管理,避免 UI 改动无法追溯

3. 插件锁版本

升级插件可能改变面板行为,生产固定版本并纳入变更流程

4. 备份包含三部分

数据库、provisioning 配置与插件目录,缺一恢复后都不完整

5. 渲染器独立部署

图像渲染吃内存,独立服务化可避免拖垮主进程

6. 升级前读变更说明

跨大版本可能涉及数据库迁移与插件兼容,务必先备份再升级

共 125 条 Grafana 命令 · 示例中的地址、账号与路径请替换为实际环境

关于Grafana CLI命令速查

在线 Grafana CLI 命令速查手册,按服务与启动、CLI 总览与配置、插件管理、管理员与密码、数据库与迁移、Provisioning 配置即代码、HTTP API 与自动化、告警与通知、备份与恢复、渲染性能与排障、常见报错与排查等 11 类场景整理 120+ 条常用命令,每条附中文说明与可直接复制的写法,支持关键词搜索、分类折叠和一键复制,打开网页即可查阅。涵盖 grafana --version 与 grafana server 与 --homepath/--config/--profile 与 cfg:default.paths.data 与 grafana-server 旧命令与 systemctl/journalctl 与 3000 端口与 /api/health、grafana cli --help/--help-long/--config/--homepath/--pluginsDir 与 grafana.ini 与 defaults.ini 与 GF_SERVER_HTTP_PORT/GF_SECURITY_ADMIN_PASSWORD/GF_PATHS_DATA/GF_PATHS_PROVISIONING 环境变量优先级、grafana cli plugins list-remote 与 list-versions 与 install 指定版本与 update-all 与 remove 与 GF_PLUGINS_PREINSTALL 与 GF_PLUGINS_ALLOW_LOADING_UNSIGNED_PLUGINS、grafana cli admin reset-admin-password 与 --password-from-stdin、数据库配置 type/host/name/user/password 与 GF_DATABASE_* 与 migration_log 查询与 sqlite 锁问题与连接池参数、provisioning 的 datasources/dashboards/alerting YAML 模板与 updateIntervalSeconds 与 allowUiUpdates、/api/health 与 /api/search 与 /api/datasources 与 /api/folders 与 /api/dashboards/db 与 /api/dashboards/uid 与 serviceaccounts 与 tokens 与 /api/admin/stats/users 与 /api/annotations、/api/v1/provisioning/alert-rules 与 contact-points 与 notification-policies 与 alertmanager v2/alerts 与 silences 与 status、sqlite3 .backup 与 mysqldump 与 pg_dump 与配置插件目录备份恢复与权限修正、grafana-image-renderer 与 rendering server_url 与 /render/d-solo 与 metrics 与 admin/stats,以及 GF_PATHS_DATA is not writable、database is locked、Failed to connect to database、migration failed、plugin signature invalid、401/403、422 导入仪表板失败、render timeout、WebSocket Live 失败等报错排查。适用于 Grafana 部署与升级、插件与渲染器管理、管理员密码找回、数据源与仪表板配置即代码、告警与通知策略治理、备份恢复与实例迁移、API 自动化与 CI 集成,以及可观测平台运维与面试复习。

核心能力

  • 涵盖 grafana --version 与 grafana server 与 --homepath/--config/--profile 与 cfg:default.paths.data 与 grafana-server 旧命令与 systemctl/journalctl 与 3000 端口与 /api/health、grafana cli --help/--help-long/--config/--homepath/--pluginsDir 与 grafana.ini 与 defaults.ini 与 GF_SERVER_HTTP_PORT/GF_SECURITY_ADMIN_PASSWORD/GF_PATHS_DATA/GF_PATHS_PROVISIONING 环境变量优先级、grafana cli plugins list-remote 与 list-versions 与 install 指定版本与 update-all 与 remove 与 GF_PLUGINS_PREINSTALL 与 GF_PLUGINS_ALLOW_LOADING_UNSIGNED_PLUGINS、grafana cli admin reset-admin-password 与 --password-from-stdin、数据库配置 type/host/name/user/password 与 GF_DATABASE_* 与 migration_log 查询与 sqlite 锁问题与连接池参数、provisioning 的 datasources/dashboards/alerting YAML 模板与 updateIntervalSeconds 与 allowUiUpdates、/api/health 与 /api/search 与 /api/datasources 与 /api/folders 与 /api/dashboards/db 与 /api/dashboards/uid 与 serviceaccounts 与 tokens 与 /api/admin/stats/users 与 /api/annotations、/api/v1/provisioning/alert-rules 与 contact-points 与 notification-policies 与 alertmanager v2/alerts 与 silences 与 status、sqlite3 .backup 与 mysqldump 与 pg_dump 与配置插件目录备份恢复与权限修正、grafana-image-renderer 与 rendering server_url 与 /render/d-solo 与 metrics 与 admin/stats,以及 GF_PATHS_DATA is not writable、database is locked、Failed to connect to database、migration failed、plugin signature invalid、401/403、422 导入仪表板失败、render timeout、WebSocket Live 失败等报错排查

适用场景

适用于 Grafana 部署与升级、插件与渲染器管理、管理员密码找回、数据源与仪表板配置即代码、告警与通知策略治理、备份恢复与实例迁移、API 自动化与 CI 集成,以及可观测平台运维与面试复习。Grafana CLI命令速查全程在浏览器中完成,无需安装插件,可放心用于日常办公与排障。

常见问题

Grafana CLI命令速查是免费的吗?需要注册或安装吗?
Grafana CLI命令速查完全免费,无需注册、无需下载安装任何软件,用浏览器打开网页即可直接使用,也不限制使用次数。
Grafana CLI命令速查支持哪些功能?
涵盖 grafana --version 与 grafana server 与 --homepath/--config/--profile 与 cfg:default.paths.data 与 grafana-server 旧命令与 systemctl/journalctl 与 3000 端口与 /api/health、grafana cli --help/--help-long/--config/--homepath/--pluginsDir 与 grafana.ini 与 defaults.ini 与 GF_SERVER_HTTP_PORT/GF_SECURITY_ADMIN_PASSWORD/GF_PATHS_DATA/GF_PATHS_PROVISIONING 环境变量优先级、grafana cli plugins list-remote 与 list-versions 与 install 指定版本与 update-all 与 remove 与 GF_PLUGINS_PREINSTALL 与 GF_PLUGINS_ALLOW_LOADING_UNSIGNED_PLUGINS、grafana cli admin reset-admin-password 与 --password-from-stdin、数据库配置 type/host/name/user/password 与 GF_DATABASE_* 与 migration_log 查询与 sqlite 锁问题与连接池参数、provisioning 的 datasources/dashboards/alerting YAML 模板与 updateIntervalSeconds 与 allowUiUpdates、/api/health 与 /api/search 与 /api/datasources 与 /api/folders 与 /api/dashboards/db 与 /api/dashboards/uid 与 serviceaccounts 与 tokens 与 /api/admin/stats/users 与 /api/annotations、/api/v1/provisioning/alert-rules 与 contact-points 与 notification-policies 与 alertmanager v2/alerts 与 silences 与 status、sqlite3 .backup 与 mysqldump 与 pg_dump 与配置插件目录备份恢复与权限修正、grafana-image-renderer 与 rendering server_url 与 /render/d-solo 与 metrics 与 admin/stats,以及 GF_PATHS_DATA is not writable、database is locked、Failed to connect to database、migration failed、plugin signature invalid、401/403、422 导入仪表板失败、render timeout、WebSocket Live 失败等报错排查。
Grafana CLI命令速查适合哪些场景使用?
适用于 Grafana 部署与升级、插件与渲染器管理、管理员密码找回、数据源与仪表板配置即代码、告警与通知策略治理、备份恢复与实例迁移、API 自动化与 CI 集成,以及可观测平台运维与面试复习。