__prometheus_{server,alertmanager}: new man pages

This commit is contained in:
kamila 2018-03-11 01:35:16 +01:00
parent ee6d63325d
commit 34aefbc0f6
3 changed files with 13 additions and 17 deletions

View file

@ -18,19 +18,20 @@ REQUIRED PARAMETERS
------------------- -------------------
config config
Alertmanager configuration file. It will be saved as /etc/alertmanager/alertmanager.yml on the target. Alertmanager configuration file. It will be saved as /etc/alertmanager/alertmanager.yml on the target.
listen-address
Passed as web.listen-address.
OPTIONAL PARAMETERS OPTIONAL PARAMETERS
------------------- -------------------
storage-path storage-path
Where to put data. Default: /data/alertmanager. (Directory will be created if needed.) Where to put data. Default: /data/alertmanager. (Directory will be created if needed.)
retention-days
How long to retain data. Default: 90 days.
BOOLEAN PARAMETERS BOOLEAN PARAMETERS
------------------ ------------------
None install-from-backports
Valid on Devuan only. Will enable the backports apt source and install the package from there. Useful for getting a newer version.
EXAMPLES EXAMPLES
@ -38,21 +39,15 @@ EXAMPLES
.. code-block:: sh .. code-block:: sh
ALERTPORT=9093 __prometheus_alertmanager \
--install-from-backports \
__daemontools --config "$__manifest/files/alertmanager.yml" \
__golang_from_vendor --version 1.8.1 # required for prometheus and many exporters --storage-path /data/alertmanager
require="__daemontools __golang_from_vendor" __prometheus_alertmanager \
--with-daemontools \
--config "$__manifest/files/alertmanager.yml" \
--storage-path /data/alertmanager \
--listen-address "[::]:$ALERTPORT"
SEE ALSO SEE ALSO
-------- --------
:strong:`cdist-type__prometheus_server`\ (7), :strong:`cdist-type__daemontools`\ (7), :strong:`cdist-type__prometheus_server`\ (7), :strong:`cdist-type__grafana_dashboard`\ (7),
Prometheus alerting documentation: https://prometheus.io/docs/alerting/overview/ Prometheus alerting documentation: https://prometheus.io/docs/alerting/overview/
AUTHORS AUTHORS
@ -61,7 +56,7 @@ Kamila Součková <kamila--@--ksp.sk>
COPYING COPYING
------- -------
Copyright \(C) 2017 Kamila Součková. You can redistribute it Copyright \(C) 2018 Kamila Součková. You can redistribute it
and/or modify it under the terms of the GNU General Public License as and/or modify it under the terms of the GNU General Public License as
published by the Free Software Foundation, either version 3 of the published by the Free Software Foundation, either version 3 of the
License, or (at your option) any later version. License, or (at your option) any later version.

View file

@ -48,7 +48,6 @@ require="$require $require_pkg" __directory "$storage_path" --owner prometheus -
require="$require $require_pkg" \ require="$require $require_pkg" \
__key_value alertmanager_fix_init_script --file /etc/init.d/prometheus-alertmanager --key="NAME" --value="prometheus-alertmanager" --delimiter "=" __key_value alertmanager_fix_init_script --file /etc/init.d/prometheus-alertmanager --key="NAME" --value="prometheus-alertmanager" --delimiter "="
##### CONFIGURE ############################################################# ##### CONFIGURE #############################################################
FLAGS="--storage.path $storage_path --data.retention $(($retention_days*24))h --web.listen-address [::]:9093" FLAGS="--storage.path $storage_path --data.retention $(($retention_days*24))h --web.listen-address [::]:9093"

View file

@ -30,7 +30,8 @@ storage-path
BOOLEAN PARAMETERS BOOLEAN PARAMETERS
------------------ ------------------
None install-from-backports
Valid on Devuan only. Will enable the backports apt source and install the package from there. Useful for getting a newer version.
EXAMPLES EXAMPLES
@ -42,6 +43,7 @@ EXAMPLES
ALERTPORT=9093 ALERTPORT=9093
__prometheus_server \ __prometheus_server \
--install-from-backports \
--config "$__manifest/files/prometheus.yml" \ --config "$__manifest/files/prometheus.yml" \
--retention-days 14 \ --retention-days 14 \
--storage-path /data/prometheus \ --storage-path /data/prometheus \