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-server | systemd 方式启动 | |
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 = xxx | grafana.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 locked | sqlite 并发写入限制,生产建议换 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: 10 | provisioning 扫描间隔,修改文件后自动生效 | |
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.sql | MySQL 备份(一致性快照) | |
pg_dump -U grafana -Fc grafana > /backup/grafana.dump | PostgreSQL 备份 | |
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.db | sqlite 恢复:替换数据库文件 | |
mysql -u grafana -p grafana < /backup/grafana.sql | MySQL 恢复 | |
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_http | Prometheus 指标(需开启 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 locked | sqlite 并发限制或文件损坏,换外部数据库或恢复备份 | |
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 Unauthorized | Token 失效、Basic Auth 密码错误或未带认证头 | |
403 Forbidden | 权限不足,检查组织角色与服务账号作用域 | |
422 Unprocessable Entity(导入仪表板) | JSON 结构不合法或 datasource 引用不存在 | |
dashboard not found | UID 或 slug 写错,也可能在别的组织 | |
render timeout | 渲染服务不可达或面板查询过慢,检查 renderer 与数据源 | |
WebSocket connection failed(Live) | 反代未放通 Upgrade 头或未开启 Live 功能 | |
登录后白屏 / 静态资源 404 | root_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. 升级前读变更说明
跨大版本可能涉及数据库迁移与插件兼容,务必先备份再升级
相关工具
Linux命令速查
文件、文本、权限、进程、网络、磁盘、systemd与防火墙等 Linux 常用命令速查手册
Docker命令速查
镜像、容器、网络、数据卷、Compose、Swarm、清理与排障等 Docker 常用命令速查手册
Nginx命令速查
服务管理、配置指令、反向代理、HTTPS、限流缓存、日志排查等 Nginx 常用命令速查手册
K8S命令速查
集群上下文、Pod调试、工作负载、Service与Ingress、存储、权限、排障等 kubectl 常用命令速查手册
Windows CMD命令速查
文件目录、网络诊断、进程服务、系统信息、用户权限、注册表、批处理等 Windows CMD 常用命令速查手册
systemctl服务管理速查
服务启停、开机自启、unit文件编写、日志查看、定时器、依赖分析与排障等 systemctl 命令速查手册
关于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 集成,以及可观测平台运维与面试复习。