2022-06-22 17:13:29 +00:00
|
|
|
From 0402fb034c2785d286f0d85f8e264a4ab8bfcb7a Mon Sep 17 00:00:00 2001
|
|
|
|
From: Andreas Gerstmayr <agerstmayr@redhat.com>
|
|
|
|
Date: Wed, 22 Jun 2022 17:01:09 +0200
|
|
|
|
Subject: [PATCH] add manpages
|
|
|
|
|
|
|
|
|
2020-04-22 16:14:45 +00:00
|
|
|
diff --git a/docs/man/man1/grafana-cli.1 b/docs/man/man1/grafana-cli.1
|
|
|
|
new file mode 100644
|
2022-06-22 17:13:29 +00:00
|
|
|
index 0000000000..736c6f7506
|
2020-04-22 16:14:45 +00:00
|
|
|
--- /dev/null
|
|
|
|
+++ b/docs/man/man1/grafana-cli.1
|
2022-06-22 17:13:29 +00:00
|
|
|
@@ -0,0 +1,63 @@
|
|
|
|
+.TH GRAFANA "1" "June 2022" "Grafana cli version 8.5.6" "User Commands"
|
2020-04-22 16:14:45 +00:00
|
|
|
+.SH NAME
|
|
|
|
+grafana-cli \- command line administration for the Grafana metrics dashboard and graph editor
|
|
|
|
+.SH DESCRIPTION
|
|
|
|
+.SS "NAME:"
|
|
|
|
+.IP
|
|
|
|
+grafana-cli
|
|
|
|
+.SS "USAGE:"
|
|
|
|
+.IP
|
|
|
|
+\fBgrafana\-cli\fP [\fIglobal options\fP] \fIcommand\fP [\fIcommand options\fP] [\fIarguments\fP...]
|
|
|
|
+.SS "COMMANDS:"
|
|
|
|
+.TP
|
|
|
|
+plugins
|
|
|
|
+Manage plugins for grafana
|
|
|
|
+.TP
|
|
|
|
+admin
|
|
|
|
+Grafana admin commands
|
|
|
|
+.TP
|
2022-06-22 17:13:29 +00:00
|
|
|
+cue
|
|
|
|
+Cue validation commands
|
|
|
|
+.TP
|
2020-04-22 16:14:45 +00:00
|
|
|
+help, h
|
|
|
|
+Shows a list of commands or help for one command
|
|
|
|
+.SS "GLOBAL OPTIONS:"
|
|
|
|
+.TP
|
|
|
|
+\fB\-\-pluginsDir\fR value
|
|
|
|
+path to the grafana plugin directory (default: "/var/lib/grafana/plugins") [$GF_PLUGIN_DIR]
|
|
|
|
+.TP
|
|
|
|
+\fB\-\-repo\fR value
|
|
|
|
+url to the plugin repository (default: "https://grafana.com/api/plugins") [$GF_PLUGIN_REPO]
|
|
|
|
+.TP
|
|
|
|
+\fB\-\-pluginUrl\fR value
|
|
|
|
+Full url to the plugin zip file instead of downloading the plugin from grafana.com/api [$GF_PLUGIN_URL]
|
|
|
|
+.TP
|
|
|
|
+\fB\-\-insecure\fR
|
2022-06-22 17:13:29 +00:00
|
|
|
+Skip TLS verification (insecure) (default: false)
|
2020-04-22 16:14:45 +00:00
|
|
|
+.TP
|
2022-06-22 17:13:29 +00:00
|
|
|
+\fB\-\-debug\fR
|
|
|
|
+Enable debug logging (default: false)
|
2020-04-22 16:14:45 +00:00
|
|
|
+.TP
|
2020-11-04 16:44:15 +00:00
|
|
|
+\fB\-\-configOverrides\fR value
|
|
|
|
+Configuration options to override defaults as a string. e.g. cfg:default.paths.log=/dev/null
|
|
|
|
+.TP
|
|
|
|
+\fB\-\-homepath\fR value
|
|
|
|
+Path to Grafana install/home path, defaults to working directory
|
|
|
|
+.TP
|
|
|
|
+\fB\-\-config\fR value
|
|
|
|
+Path to config file
|
|
|
|
+.TP
|
2020-04-22 16:14:45 +00:00
|
|
|
+\fB\-\-help\fR, \fB\-h\fR
|
|
|
|
+show help
|
|
|
|
+.TP
|
|
|
|
+\fB\-\-version\fR, \fB\-v\fR
|
|
|
|
+print the version
|
|
|
|
+.SH "SEE ALSO"
|
|
|
|
+Additional documentation for
|
|
|
|
+.B grafana-cli
|
|
|
|
+is available on-line at
|
|
|
|
+.BR http://docs.grafana.org/administration/cli/ .
|
|
|
|
+The full documentation for
|
|
|
|
+.B Grafana
|
|
|
|
+is available on-line at
|
|
|
|
+.BR http://docs.grafana.org/ .
|
|
|
|
diff --git a/docs/man/man1/grafana-server.1 b/docs/man/man1/grafana-server.1
|
|
|
|
new file mode 100644
|
2022-06-22 17:13:29 +00:00
|
|
|
index 0000000000..1f48e898fb
|
2020-04-22 16:14:45 +00:00
|
|
|
--- /dev/null
|
|
|
|
+++ b/docs/man/man1/grafana-server.1
|
2022-06-22 17:13:29 +00:00
|
|
|
@@ -0,0 +1,80 @@
|
|
|
|
+.TH VERSION "1" "June 2022" "Version 8.5.6" "User Commands"
|
2020-04-22 16:14:45 +00:00
|
|
|
+.SH NAME
|
|
|
|
+grafana-server \- back-end server for the Grafana metrics dashboard and graph editor
|
|
|
|
+.SH DESCRIPTION
|
|
|
|
+.B grafana-server
|
|
|
|
+is the back-end server for the Grafana metrics dashboard and graph editor.
|
|
|
|
+The
|
|
|
|
+.B grafana-server
|
|
|
|
+program should not normally be run from the command line,
|
|
|
|
+except when testing or for development purposes.
|
|
|
|
+Rather it should be managed by
|
|
|
|
+.BR systemd .
|
|
|
|
+After installing Grafana, the systemd service should be enabled and started as follows:
|
|
|
|
+.P
|
|
|
|
+.in 1i
|
|
|
|
+.B systemctl daemon-reload
|
|
|
|
+.br
|
|
|
|
+.B systemctl enable grafana-server.service
|
|
|
|
+.br
|
|
|
|
+.B systemctl start grafana-server.service
|
|
|
|
+.in
|
|
|
|
+.P
|
|
|
|
+.SH OPTIONS
|
|
|
|
+The
|
|
|
|
+.B gafana-server
|
|
|
|
+configuration is specified in
|
|
|
|
+.BR /etc/grafana/grafana.ini
|
|
|
|
+and is well documented with comments.
|
|
|
|
+The command-line options listed below override options of
|
2020-11-04 16:44:15 +00:00
|
|
|
+the same (or similar) name in the configuration file.
|
2020-04-22 16:14:45 +00:00
|
|
|
+.P
|
|
|
|
+.HP
|
|
|
|
+\fB\-config\fR string
|
|
|
|
+.IP
|
|
|
|
+path to config file
|
|
|
|
+.HP
|
|
|
|
+\fB\-homepath\fR string
|
|
|
|
+.IP
|
|
|
|
+path to grafana install/home path, defaults to working directory
|
|
|
|
+.HP
|
|
|
|
+\fB\-packaging\fR string
|
|
|
|
+.IP
|
|
|
|
+describes the way Grafana was installed (default "unknown")
|
|
|
|
+.HP
|
|
|
|
+\fB\-pidfile\fR string
|
|
|
|
+.IP
|
|
|
|
+path to pid file
|
|
|
|
+.HP
|
|
|
|
+\fB\-profile\fR
|
|
|
|
+.IP
|
|
|
|
+Turn on pprof profiling
|
|
|
|
+.HP
|
2022-06-22 17:13:29 +00:00
|
|
|
+\fB\-profile\-addr\fR string
|
|
|
|
+.IP
|
|
|
|
+Define custom address for profiling (default "localhost")
|
|
|
|
+.HP
|
2020-11-04 16:44:15 +00:00
|
|
|
+\fB\-profile\-port\fR uint
|
2020-04-22 16:14:45 +00:00
|
|
|
+.IP
|
|
|
|
+Define custom port for profiling (default 6060)
|
|
|
|
+.HP
|
2020-11-04 16:44:15 +00:00
|
|
|
+\fB\-tracing\fR
|
2020-04-22 16:14:45 +00:00
|
|
|
+.IP
|
2020-11-04 16:44:15 +00:00
|
|
|
+Turn on tracing
|
2020-04-22 16:14:45 +00:00
|
|
|
+.HP
|
2020-11-04 16:44:15 +00:00
|
|
|
+\fB\-tracing\-file\fR string
|
2020-04-22 16:14:45 +00:00
|
|
|
+.IP
|
2020-11-04 16:44:15 +00:00
|
|
|
+Define tracing output file (default "trace.out")
|
2020-04-22 16:14:45 +00:00
|
|
|
+.TP
|
|
|
|
+\fB\-v\fR
|
2020-11-04 16:44:15 +00:00
|
|
|
+.IP
|
2020-04-22 16:14:45 +00:00
|
|
|
+prints current version and exits
|
2022-06-22 17:13:29 +00:00
|
|
|
+.TP
|
|
|
|
+\fB\-vv\fR
|
|
|
|
+.IP
|
|
|
|
+prints current version, all dependencies and exits
|
2020-04-22 16:14:45 +00:00
|
|
|
+.SH "SEE ALSO"
|
|
|
|
+The full documentation for
|
|
|
|
+.B Grafana
|
|
|
|
+is available on-line at
|
|
|
|
+.BR http://docs.grafana.org/ .
|