Grafana CLI
Grafana CLI是一个与Grafana服务器绑定的小型可执行文件。它可以在运行Grafana服务器的同一台机器上执行。Grafana CLI有插件
而且管理
命令,以及全局选项。
查询所有命令和选项。
grafana-cli - h
调用Grafana CLI
要调用Grafana CLI,请在文件中添加Grafana二进制文件的路径路径
环境变量。或者,如果您的当前目录是箱子
目录,使用。/ grafana-cli
.否则,可以指定CLI的全路径。例如,在Linux上/usr/share/grafana/bin/grafana-cli
在Windows上C:\Program Files\ GrafanaLabs \ grafana \ bin \ grafana-cli.exe
.
注意:一些命令,如安装或删除插件,需要
sudo
在Linux上。如果您使用的是Windows系统,请以管理员身份运行Windows PowerShell。
Grafana CLI命令语法
Grafana CLI命令的通用语法是:
Grafana-cli[全局选项]command[命令选项][参数…]
全局选项
Grafana CLI允许您临时覆盖某些Grafana默认设置。除了——帮助
而且——版本
,大多数全局选项仅供开发人员使用。
每个全局选项只应用于使用它的命令。例如,——pluginsDir价值
不会永久改变Grafana保存插件的位置。它只会为应用该选项的命令更改它。
显示Grafana CLI帮助
——帮助
或- h
显示帮助,包括默认路径和Docker配置信息。
例子:
grafana-cli - h
显示Grafana CLI版本
——版本
或- v
打印当前运行的Grafana CLI的版本。
例子:
grafana-cli - v
覆盖默认插件目录
——pluginsDir价值
覆盖本地Grafana实例存储插件的路径。如果你想在默认目录("/var/lib/grafana/plugins") [$GF_PLUGIN_DIR]之外的地方安装、更新或删除插件,请使用此选项。
例子:
grafana-cli——pluginsDir "/var/lib/grafana/devplugins" plugins install
覆盖默认插件repo URL
——回购价值
除了默认的Grafana repo,允许你从其他存储库下载、安装或更新插件。
例子:
Grafana-cli——repo "https://example.com/plugins" plugins install
覆盖默认插件.zip URL
——pluginUrl价值
允许您从本地URL下载包含插件的.zip文件,而不是从默认的Grafana源下载。
例子:
grafana-cli——pluginUrl https://company.com/grafana/plugins/-.zip plugins install .zip
覆盖传输层安全性
警告:关闭TLS是一个重大的安全风险。我们不建议使用此选项。
——不安全
允许您关闭传输层安全(TLS)验证(不安全)。如果你从非默认源下载插件,你可能需要这样做。
例子:
grafana-cli——insecure——pluginUrl https://company.com/grafana/plugins/-.zip plugins install .zip
启用调试日志记录
——调试
或- d
启用调试日志记录。调试输出返回并显示在终端中。
例子:
Grafana-cli——debug plugins install
重写配置设置
——configOverrides
是一个命令行参数,其作用类似于环境变量重写。
例如,您可以使用它将日志重定向到另一个文件(可能是Grafana Cloud中的日志插件安装),或者在重置管理员密码时使用一些重要配置值(如数据库所在位置)的非默认值。
例子:
grafana-cli——configOverrides cfg:default.paths.log=/dev/null plugins install .log
覆盖主路径值
设置Grafana安装/home路径,默认为工作目录。如果使用命令行操作时在Grafana安装目录下,则不需要使用此选项。
例子:
grafana-cli——homeepath "/usr/share/grafana" admin reset-admin-password <新密码>
覆盖配置文件
——配置值
重写Grafana期望配置文件的默认位置。指配置有关配置Grafana和默认配置文件位置的更多信息。
例子:
Grafana-cli——config "/etc/configuration/" admin reset-admin-password mynewpassword
插件命令
Grafana CLI允许您安装、升级和管理您的Grafana插件。有关安装插件的更多信息,请参阅插件页面.
所有列出的命令都适用于Grafana默认存储库和目录。您可以使用全局选项.
列出可用的插件
Grafana-cli plugins list-remote
安装插件的最新版本
Grafana-cli plugins install
安装插件的特定版本
Grafana-cli plugins install
已安装插件列表
Grafana-cli plugins ls
更新所有已安装的插件
Grafana-cli插件更新全部
更新一个插件
Grafana-cli plugins update
移除一个插件
移除
管理命令
管理命令仅在Grafana 4.1及更高版本中可用。
显示所有管理命令
grafana-cli管理
重置admin密码
Grafana-cli admin reset-admin-password <新密码>
使用实例通过CLI重置admin用户密码。如果您丢失了管理密码,您可能需要这样做。
如果有两个标志被用来设置主路径和配置文件路径,那么运行该命令将返回以下错误:
找不到配置默认值,请确保home路径命令行参数已设置或工作目录是home路径
要纠正此错误,请使用——homepath
global选项用于指定Grafana的默认路径:
grafana-cli——homeepath "/usr/share/grafana" admin reset-admin-password <新密码>
如果您没有丢失管理员密码,我们建议您在“用户首选项”或“服务器管理员>用户”选项卡中更改用户密码。
如果需要在脚本中设置密码,则可以使用Grafana用户API.
数据迁移和密码加密
数据迁移
运行一个脚本,用于迁移或清理数据库中的数据。
encrypt-datasource-passwords
将密码从不安全字段迁移到secure_json_data字段。返回好吧
除非出现错误。可以安全执行多次。
例子:
Grafana-cli admin data-migration encrypt-datasource-passwords
相关Grafana资源
开幕主题演讲:《Grafana 9》有什么新内容?
Raj Dutt, Myrle Krantz和Torkel Ödegaard揭开了Grafana 9的新内容。观看2022年GrafanaCONline开幕式主题演讲。随需应变。
使用Grafana插件统一您的数据:Datadog, Splunk, MongoDB等
在本次网络研讨会中,学习如何利用Grafana的插件生态系统访问80多个数据源,包括Datadog、Splunk、MongoDB等的插件。
从Grafana Enterprise和可观察性开始
加入Grafanabob电竞频道实验室团队,进行30分钟的演示,演示如何开始使用Grafana堆栈,这样您就可以在短短几分钟内从零到可观察性。