ansible-role-promtail

Example Playbook

- hosts: all
  roles:
    - grokon.promtail
  vars:
    promtail__loki_server_domain: my_loki_instance
    promtail__scrape_configs:
      - job_name: syslog
        static_configs:
          - targets:
              - localhost
            labels:
              job: syslog
              host: "{{ ansible_host }}"
              __path__: /var/log/syslog

This is an Ansible Role that installs promtail on Debian.

Table of Contents

• Default Variables
  • promtail__config_clients
  • promtail__config_dir
  • promtail__config_file
  • promtail__config_file_sd_dir
  • promtail__config_positions
  • promtail__config_server
  • promtail__install
  • promtail__log_level
  • promtail__loki_server_url
  • promtail__path
  • promtail__scrape_configs
  • promtail__target_config
  • promtail__tmp_dir
  • promtail__url
  • promtail__version
• Discovered Tags
• Open Tasks
• Dependencies
• License
• Author

---

Default Variables

promtail__config_clients

Configuration for Promtail clients.

Default Value

promtail__config_clients:
  - url: '{{ promtail__loki_server_url }}/loki/api/v1/push'

promtail__config_dir

Directory for Promtail configurations.

Default Value

promtail__config_dir: /etc/promtail

promtail__config_file

Path to the Promtail config file.

Default Value

promtail__config_file: '{{ promtail__config_dir }}/config.yml'

promtail__config_file_sd_dir

Directory for file-based service discovery.

Default Value

promtail__config_file_sd_dir: '{{ promtail__config_dir }}/file_sd'

promtail__config_positions

Configuration for Promtail positions.

Default Value

promtail__config_positions:
  filename: '{{ promtail__config_dir }}/positions.yaml'

promtail__config_server

Promtail server configuration for metrics listening.

Default Value

promtail__config_server:
  http_listen_port: 9080

promtail__install

Whether to install Promtail. Set to false to remove if already installed.

Default Value

promtail__install: true

promtail__log_level

Logging level for Promtail. Options: debug, info, warn, error.

Default Value

promtail__log_level: warn

promtail__loki_server_url

URL for the Promtail Loki server.

Default Value

promtail__loki_server_url: http://localhost:3100

promtail__path

Default path for Promtail executable.

Default Value

promtail__path: /usr/local/bin/promtail

promtail__scrape_configs

Configuration for Promtail scraping.

Default Value

promtail__scrape_configs: []

Example Usage

Example:
promtail__scrape_configs:
- job_name: syslog
  static_configs:
    - targets:
      - localhost
      labels:
        job: syslog
        host: "{{ ansible_host }}"
        __path__: /var/log/syslog

promtail__target_config

Default Value

promtail__target_config: {}

promtail__tmp_dir

Temporary directory for downloading Promtail.

Default Value

promtail__tmp_dir: /tmp

promtail__url

URL for the Promtail file.

Default Value

promtail__url: https://github.com/grafana/loki/releases/download/v{{ promtail__version }}/promtail-linux-amd64.zip

Example Usage

promtail_target_config:
   sync_period: "10s"

promtail__version

Default is the latest version, can pin to a specific version like 2.6.1.

Default Value

promtail__version: latest

Discovered Tags

promtail_configure

promtail_install

promtail_run

Open Tasks

• (improvement): Add variables for logs.

Dependencies

None.

License

MIT

Author

grokon