prometheus-adlermanager/dotenv.example
Evilham 23134fa2d6
All checks were successful
ci/woodpecker/push/linters Pipeline was successful
Config: add new settings replacing hard-coded values
This mostly relates to timeouts.

We are using minutes because it is human-friendly, but some could
benefit in certain cases from using seconds.

We are open to changing this in the future.
2023-12-11 19:09:07 +01:00

120 lines
3.9 KiB
Plaintext

#
# Automatically generated, manual changes will be lost
# Run: python -m adlermanager.Config dotenv.example
#
# If using Pipenv or similar, you probably want:
# To load the adlermanager module:
PYTHONPATH="./src"
# To instruct mypy to find the adlermanager module:
MYPYPATH="./src"
# All settings can be set via Environment variables.
# If you use pipenv, you are encouraged to use the .env file.
# See pipenv's documentation for more information.
#DATA_DIR="../data"
#
# Environment: DATA_DIR.
# Directory to save persistent data in.
# # Web
#WEB_ENDPOINT="tcp6:interface=\:\::port=8080"
#
# Environment: WEB_ENDPOINT.
# Where we should listen for HTTP connections.
# This defaults to TCP port 8080, but you can also use a UNIX socket,
# which you can proxy from your web server.
#
# See:
# https://docs.twisted.org/en/stable/core/howto/endpoints.html#servers
# https://klein.readthedocs.io/en/latest/examples/alternativerunning.html#example-ipv6-tls-unix-sockets-endpoints
#WEB_STATIC_DIR="../static"
#
# Environment: WEB_STATIC_DIR.
# Directory to server static files from.
# # SSH
#SSH_ENABLED="YES"
#
# Environment: SSH_ENABLED.
# If this environment variable is anything other than empty,
# SSH_ENDPOINT will be used to listen for SSH connections.
#SSH_ENDPOINT="tcp6:interface=\:\::port=2222"
#
# Environment: SSH_ENDPOINT.
# Where we should listen for SSH connections if SSH_ENABLED is
# anything other than empty.
#
# See:
# https://docs.twisted.org/en/stable/core/howto/endpoints.html#servers
# https://klein.readthedocs.io/en/latest/examples/alternativerunning.html#example-ipv6-tls-unix-sockets-endpoints
#SSH_KEY_SIZE="4096"
#
# Environment: SSH_KEY_SIZE.
# Size for server's auto-generated SSH host key.
#SSH_KEYS_DIR="../data/ssh"
#
# Environment: SSH_KEYS_DIR.
# Directory to save SSH keys in.
# This includes the server private key and users' public keys.
# # Alerts processing
#ALERT_RESOLVE_MINUTES="5"
#
# Environment: ALERT_RESOLVE_MINUTES.
# Prometheus keeps sending alerts periodically as long as it is aware
# of them, and when it determines they have been resolved, it too
# sends us that information.
# However, under certain circumstances, an alert may be raised and it
# can just stop being sent.
# This variable marks how long we should remember such alerts that
# stop arriving but are not explicitly marked as resolved.
# Default value: 5 (minutes), as AlertManager
#GROUP_INCIDENTS_MINUTES="60"
#
# Environment: GROUP_INCIDENTS_MINUTES.
# Alerts incoming at roughly the same time are grouped into incidents.
# Use this to configure the timeout after which alerts will be
# considered separate incidents, in minutes.
# Example: If it is set for 30 minutes, and alerts come at 09:00,
# 09:20, 09:40, and 11:00, then the first 3 will be the same incident and
# the last one will begin a new incident.
# Default value: 60 (i.e. 1 hour).
#MONITORING_DOWN_MINUTES="2"
#
# Environment: MONITORING_DOWN_MINUTES.
# We expect prometheus to get in touch with AdlerManager periodically.
# In order to achieve this, a special rule should be created (and
# silenced in AlertManager!), which acts as a "Heartbeat" signal.
# If we do not do this, monitoring may be down and we'll never get
# see that.
# The rule should look like this:
#
# # groups:
# # - name: "AdlerManager at example.org"
# # interval: 30s
# # rules:
# # - alert: "AdlerManager: Everything is fine"
# # # This expression should always be true.
# # # A neat trick is using the job that gathers prometheus metrics
# # expr: up{job="prometheus"} == 1
# # labels:
# # # This must match the sitename in AdlerManager
# # adlermanager: "example.org"
# # # This must be set
# # heartbeat: True
# # # This is optional, but it is nice to have
# # severity: OK
#
#
# This variable determines how long we can go without having contact
# from Prometheus. When this time is exceeded, AdlerManager will
# fallback to a "Monitoring is Down" state.
# Default value: 2 (minutes)