promtail

Ansible role to install and configure promtail.

Sponsor

Building and improving this Ansible role have been sponsored by my current and previous employers like Cloudpunks GmbH and Proact Deutschland GmbH.

Table of content

• Requirements
• Default Variables
  • promtail_client_configs
  • promtail_cpu_shares
  • promtail_default_folders
  • promtail_default_labels
  • promtail_default_publish
  • promtail_default_volumes
  • promtail_extra_folders
  • promtail_extra_labels
  • promtail_extra_publish
  • promtail_extra_volumes
  • promtail_image
  • promtail_memory_limit
  • promtail_memory_soft_limit
  • promtail_memory_swap
  • promtail_network
  • promtail_number_of_cpus
  • promtail_pull_image
  • promtail_scrape_configs
  • promtail_version
• Discovered Tags
• Dependencies
• License
• Author

---

Requirements

• Minimum Ansible version: 2.10

Default Variables

promtail_client_configs

List of client configs for Promtail

Default value

promtail_client_configs: []

Example usage

promtail_client_configs:
  - url: http://loki.example.com/promtail/api/v1/push

promtail_cpu_shares

CPU shares with Docker deployment

Default value

promtail_cpu_shares:

Example usage

promtail_cpu_shares: '512'

promtail_default_folders

List of default folders to create

Default value

promtail_default_folders:
  - /etc/promtail

promtail_default_labels

List of default labels to assign to docker

Default value

promtail_default_labels: []

promtail_default_publish

List of default port publishing for docker

Default value

promtail_default_publish: []

Example usage

promtail_default_publish:
  - 127.0.0.1:3100:3100

promtail_default_volumes

List of default volumes to mount for docker

Default value

promtail_default_volumes:
  - /etc/promtail:/etc/promtail

promtail_extra_folders

List of extra folders to create

Default value

promtail_extra_folders: []

Example usage

promtail_extra_folders:
  - /path/to/host/folder1
  - /path/to/host/folder2
  - /path/to/host/folder3

promtail_extra_labels

List of extra labels to assign to docker

Default value

promtail_extra_labels: []

promtail_extra_publish

List of extra port publishing for docker

Default value

promtail_extra_publish: []

Example usage

promtail_extra_publish:
  - 127.0.0.1:3100:3100

promtail_extra_volumes

List of extra volumes to mount for docker

Default value

promtail_extra_volumes: []

Example usage

promtail_extra_volumes:
  - /path/to/host/folder1:/path/within/container1
  - /path/to/host/folder2:/path/within/container2
  - /path/to/host/folder3:/path/within/container3

promtail_image

Docker image to use for deployment

Default value

promtail_image: grafana/promtail:{{ promtail_version }}

promtail_memory_limit

Memory limit with Docker deployment

Default value

promtail_memory_limit:

Example usage

promtail_memory_limit: 1024m

promtail_memory_soft_limit

Soft memory limit with Docker deployment

Default value

promtail_memory_soft_limit:

Example usage

promtail_memory_soft_limit: 512m

promtail_memory_swap

Swap usage with Docker deployment

Default value

promtail_memory_swap:

Example usage

promtail_memory_swap: 2048m

promtail_network

Optional docker network to attach

Default value

promtail_network:

promtail_number_of_cpus

Number of CPUs with Docker deployment

Default value

promtail_number_of_cpus:

Example usage

promtail_number_of_cpus: '1.0'

promtail_pull_image

Pull image as part of the tasks

Default value

promtail_pull_image: true

promtail_scrape_configs

List of scrape configs for Promtail

Default value

promtail_scrape_configs: []

Example usage

promtail_scrape_configs:
  - job_name: system
    static_configs:
      - targets:
          - localhost
        labels:
          job: varlogs
          __path__: /var/log/*log

promtail_version

Version of the release to install

Default value

promtail_version: 3.3.1

Discovered Tags

promtail

Dependencies

• rolehippie.docker
• community.docker

License

Apache-2.0

Author

Thomas Boerger