bodsch.loki
Ansible Role: loki
Further development of this Ansible role has been moved to Collection bodsch.grafana. This repository will therefore no longer be actively maintained.
Ansible role to setup Loki.
If latest is set for loki_version, the role tries to install the latest release version.
Please use this with caution, as incompatibilities between releases may occur!
The binaries are installed below /usr/local/bin/loki/${loki_version} and later linked to /usr/bin.
This should make it possible to downgrade relatively safely.
The Loki archive is stored on the Ansible controller, unpacked and then the binaries are copied to the target system.
The cache directory can be defined via the environment variable CUSTOM_LOCAL_TMP_DIRECTORY.
By default it is ${HOME}/.cache/ansible/loki.
If this type of installation is not desired, the download can take place directly on the target system.
However, this must be explicitly activated by setting loki_direct_download to true.
Requirements & Dependencies
Ansible Collections
ansible-galaxy collection install bodsch.core
ansible-galaxy collection install bodsch.scm
or
ansible-galaxy collection install --requirements-file collections.yml
Operating systems
Tested on
- Arch Linux
- Debian based
- Debian 10 / 11 / 12
- Ubuntu 20.04 / 22.04
RedHat-based systems are no longer officially supported! May work, but does not have to.
usage
Upstream configuration examples can be found in the Configuration Examples document.
For config upgrades read!
default configuration
loki_version: "2.6.1"
loki_release_download_url: https://github.com/grafana/loki/releases
loki_system_user: loki
loki_system_group: loki
loki_config_dir: /etc/loki
loki_storage_dir: /var/lib/loki
loki_direct_download: false
loki_targets:
- all
loki_auth_enabled: false
loki_config_server: {}
loki_config_common: {}
loki_config_distributor: {}
loki_config_querier: {}
loki_config_ingester: {}
loki_config_ingester_client: {}
loki_config_storage: {}
loki_config_chunk_store: {}
loki_config_schema: {}
loki_config_limits: {}
loki_config_frontend_worker: {}
loki_config_runtime: {}
loki_config_table_manager: {}
loki_config_memberlist: {}
loki_config_compactor: {}
loki_config_ruler: {}
loki_targets
A list of components to run.
The default value all runs Loki in single binary mode.
The value read is an alias to run only read-path related components such as the querier and query-frontend, but all in the same process.
The value write is an alias to run only write-path related components such as the distributor and compactor, but all in the same process.
Supported values:
all, compactor, distributor, ingester, querier, query-scheduler,
ingester-querier, query-frontend, index-gateway, ruler, table-manager, read, write.
loki_auth_enabled
defaults
loki_auth_enabled: false
loki_config_service
Values to configure the service directly.
Only values that are not listed in the configuration file are defined here.
loki_config_service:
validation:
create_grace_period: ""
enforce_metric_name: ""
increment_duplicate_timestamps: ""
max_entries_limit: ""
max_label_names_per_series: ""
max_length_label_name: ""
reject_old_samples: ""
reject_old_samples_max_age: ""
for more, see.
Contribution
Please read Contribution
Development, Branches (Git Tags)
The master Branch is my Working Horse includes the "latest, hot shit" and can be complete broken!
If you want to use something stable, please use a Tagged Version!
Author and License
- Bodo Schulz
License
FREE SOFTWARE, HELL YEAH!
ansible role to setup loki
ansible-galaxy install bodsch.loki