Skip to content

Latest commit

 

History

History
180 lines (111 loc) · 4.59 KB

README.md

File metadata and controls

180 lines (111 loc) · 4.59 KB
Raw

Ansible Role: loki

Ansible role to setup Loki.

GitHub Workflow Status GitHub issues GitHub release (latest by date) Ansible Quality Score

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

Apache

FREE SOFTWARE, HELL YEAH!