Compare commits

...

No commits in common. "main" and "docs" have entirely different histories.
main ... docs

36 changed files with 440 additions and 1359 deletions

View File

@ -1,161 +0,0 @@
local PipelineLinting = {
kind: 'pipeline',
name: 'linting',
platform: {
os: 'linux',
arch: 'amd64',
},
steps: [
{
name: 'ansible-later',
image: 'thegeeklab/ansible-later',
commands: [
'ansible-later',
],
},
{
name: 'python-format',
image: 'python:3.11',
environment: {
PY_COLORS: 1,
},
commands: [
'pip install -qq yapf',
'[ -z "$(find . -type f -name *.py)" ] || (yapf -rd ./)',
],
},
{
name: 'python-flake8',
image: 'python:3.11',
environment: {
PY_COLORS: 1,
},
commands: [
'pip install -qq flake8',
'flake8',
],
},
],
trigger: {
ref: ['refs/heads/main', 'refs/tags/**', 'refs/pull/**'],
},
};
local PipelineDeployment(scenario='centos7') = {
kind: 'pipeline',
name: 'testing-' + scenario,
platform: {
os: 'linux',
arch: 'amd64',
},
concurrency: {
limit: 1,
},
workspace: {
base: '/drone/src',
path: '${DRONE_REPO_NAME}',
},
steps: [
{
name: 'ansible-molecule',
image: 'thegeeklab/molecule:4',
environment: {
HCLOUD_TOKEN: { from_secret: 'hcloud_token' },
},
commands: [
'molecule test -s ' + scenario,
],
},
],
depends_on: [
'linting',
],
trigger: {
ref: ['refs/heads/main', 'refs/tags/**', 'refs/pull/**'],
},
};
local PipelineDocumentation = {
kind: 'pipeline',
name: 'documentation',
platform: {
os: 'linux',
arch: 'amd64',
},
steps: [
{
name: 'generate',
image: 'thegeeklab/ansible-doctor',
environment: {
ANSIBLE_DOCTOR_LOG_LEVEL: 'INFO',
ANSIBLE_DOCTOR_FORCE_OVERWRITE: true,
ANSIBLE_DOCTOR_EXCLUDE_FILES: 'molecule/',
ANSIBLE_DOCTOR_TEMPLATE: 'hugo-book',
ANSIBLE_DOCTOR_ROLE_NAME: '${DRONE_REPO_NAME#*.}',
ANSIBLE_DOCTOR_OUTPUT_DIR: '_docs/',
},
},
{
name: 'publish',
image: 'plugins/gh-pages',
settings: {
remote_url: 'https://gitea.rknet.org/ansible/${DRONE_REPO_NAME}',
netrc_machine: 'gitea.rknet.org',
username: { from_secret: 'gitea_username' },
password: { from_secret: 'gitea_token' },
pages_directory: '_docs/',
target_branch: 'docs',
},
when: {
ref: ['refs/heads/main'],
},
},
],
trigger: {
ref: ['refs/heads/main', 'refs/tags/**', 'refs/pull/**'],
},
depends_on: [
'testing-centos7',
'testing-rocky8',
],
};
local PipelineNotification = {
kind: 'pipeline',
name: 'notification',
platform: {
os: 'linux',
arch: 'amd64',
},
clone: {
disable: true,
},
steps: [
{
name: 'matrix',
image: 'thegeeklab/drone-matrix',
settings: {
homeserver: { from_secret: 'matrix_homeserver' },
roomid: { from_secret: 'matrix_roomid' },
template: 'Status: **{{ .Build.Status }}**<br/> Build: [{{ .Repo.Owner }}/{{ .Repo.Name }}]({{ .Build.Link }}){{ if .Build.Branch }} ({{ .Build.Branch }}){{ end }} by {{ .Commit.Author }}<br/> Message: {{ .Commit.Message.Title }}',
username: { from_secret: 'matrix_username' },
password: { from_secret: 'matrix_password' },
},
},
],
depends_on: [
'documentation',
],
trigger: {
status: ['success', 'failure'],
ref: ['refs/heads/main', 'refs/tags/**'],
},
};
[
PipelineLinting,
PipelineDeployment(scenario='centos7'),
PipelineDeployment(scenario='rocky8'),
PipelineDocumentation,
PipelineNotification,
]

View File

@ -1,187 +0,0 @@
---
kind: pipeline
name: linting
platform:
os: linux
arch: amd64
steps:
- name: ansible-later
image: thegeeklab/ansible-later
commands:
- ansible-later
- name: python-format
image: python:3.11
commands:
- pip install -qq yapf
- "[ -z \"$(find . -type f -name *.py)\" ] || (yapf -rd ./)"
environment:
PY_COLORS: 1
- name: python-flake8
image: python:3.11
commands:
- pip install -qq flake8
- flake8
environment:
PY_COLORS: 1
trigger:
ref:
- refs/heads/main
- refs/tags/**
- refs/pull/**
---
kind: pipeline
name: testing-centos7
platform:
os: linux
arch: amd64
concurrency:
limit: 1
workspace:
base: /drone/src
path: ${DRONE_REPO_NAME}
steps:
- name: ansible-molecule
image: thegeeklab/molecule:4
commands:
- molecule test -s centos7
environment:
HCLOUD_TOKEN:
from_secret: hcloud_token
trigger:
ref:
- refs/heads/main
- refs/tags/**
- refs/pull/**
depends_on:
- linting
---
kind: pipeline
name: testing-rocky8
platform:
os: linux
arch: amd64
concurrency:
limit: 1
workspace:
base: /drone/src
path: ${DRONE_REPO_NAME}
steps:
- name: ansible-molecule
image: thegeeklab/molecule:4
commands:
- molecule test -s rocky8
environment:
HCLOUD_TOKEN:
from_secret: hcloud_token
trigger:
ref:
- refs/heads/main
- refs/tags/**
- refs/pull/**
depends_on:
- linting
---
kind: pipeline
name: documentation
platform:
os: linux
arch: amd64
steps:
- name: generate
image: thegeeklab/ansible-doctor
environment:
ANSIBLE_DOCTOR_EXCLUDE_FILES: molecule/
ANSIBLE_DOCTOR_FORCE_OVERWRITE: true
ANSIBLE_DOCTOR_LOG_LEVEL: INFO
ANSIBLE_DOCTOR_OUTPUT_DIR: _docs/
ANSIBLE_DOCTOR_ROLE_NAME: ${DRONE_REPO_NAME#*.}
ANSIBLE_DOCTOR_TEMPLATE: hugo-book
- name: publish
image: plugins/gh-pages
settings:
netrc_machine: gitea.rknet.org
pages_directory: _docs/
password:
from_secret: gitea_token
remote_url: https://gitea.rknet.org/ansible/${DRONE_REPO_NAME}
target_branch: docs
username:
from_secret: gitea_username
when:
ref:
- refs/heads/main
trigger:
ref:
- refs/heads/main
- refs/tags/**
- refs/pull/**
depends_on:
- testing-centos7
- testing-rocky8
---
kind: pipeline
name: notification
platform:
os: linux
arch: amd64
clone:
disable: true
steps:
- name: matrix
image: thegeeklab/drone-matrix
settings:
homeserver:
from_secret: matrix_homeserver
password:
from_secret: matrix_password
roomid:
from_secret: matrix_roomid
template: "Status: **{{ .Build.Status }}**<br/> Build: [{{ .Repo.Owner }}/{{ .Repo.Name }}]({{ .Build.Link }}){{ if .Build.Branch }} ({{ .Build.Branch }}){{ end }} by {{ .Commit.Author }}<br/> Message: {{ .Commit.Message.Title }}"
username:
from_secret: matrix_username
trigger:
ref:
- refs/heads/main
- refs/tags/**
status:
- success
- failure
depends_on:
- documentation
---
kind: signature
hmac: 07ce4ef75e7f5244213c9d1aa9301a230bb4874fd278ec2b2d392937d6dde789
...

13
.gitignore vendored
View File

@ -1,13 +0,0 @@
# ---> Ansible
*.retry
plugins
library
# ---> Python
# Byte-compiled / optimized / DLL files
__pycache__/
*.py[cod]
*$py.class
# ---> Docs
/_docs

View File

@ -1,19 +0,0 @@
---
ansible:
custom_modules:
- iptables_raw
- openssl_pkcs12
- proxmox_kvm
- ucr
- corenetworks_dns
- corenetworks_token
rules:
exclude_files:
- molecule/
- "LICENSE*"
- "**/*.md"
- "**/*.ini"
exclude_filter:
- LINT0009

View File

@ -1 +0,0 @@
.drone*

21
LICENSE
View File

@ -1,21 +0,0 @@
MIT License
Copyright (c) 2022 Robert Kaussow <mail@thegeeklab.de>
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is furnished
to do so, subject to the following conditions:
The above copyright notice and this permission notice (including the next
paragraph) shall be included in all copies or substantial portions of the
Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS
OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF
OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

View File

@ -1,10 +0,0 @@
# xoxys.telegraf
[![Build Status](https://img.shields.io/drone/build/ansible/xoxys.telegraf?logo=drone&server=https%3A%2F%2Fdrone.rknet.org)](https://drone.rknet.org/ansible/xoxys.telegraf)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?label=license)](LICENSE)
Setup [Telegraf](https://github.com/influxdata/telegraf) metrics agent. You can find the full documentation at [https://galaxy.geekdocs.de](https://galaxy.geekdocs.de/roles/cloud/telegraf/).
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

View File

@ -1,141 +0,0 @@
---
telegraf_packages_extra: []
# @var telegraf_requires_docker_group:description: Optionally disable docker group join.
telegraf_requires_docker_group: False
telegraf_docker_group_name: dockerroot
# @var telegraf_interval:description: Default data collection interval for all inputs.
telegraf_interval: 10s
# @var telegraf_round_interval:description: Rounds collection interval to interval.
telegraf_round_interval: True
# @var telegraf_metric_batch_size:description: Telegraf will send metrics to outputs in batches of this amount.
telegraf_metric_batch_size: 1000
# @var telegraf_metric_buffer_limit:description: Maximum number of unwritten metrics per output.
telegraf_metric_buffer_limit: 10000
# @var telegraf_collection_jitter:description: Collection jitter is used to jitter the collection by a random amount.
telegraf_collection_jitter: 0s
# @var telegraf_flush_interval:description: Default flushing interval for all outputs.
telegraf_flush_interval: 10s
# @var telegraf_flush_jitter:description: Jitter the flush interval by a random amount.
telegraf_flush_jitter: 0s
# @var telegraf_precision:description: Precision will be set to the same timestamp order as the collection interval.
# @var telegraf_precision:default: $ "_unset_"
# @var telegraf_debug:description: Log at debug level.
telegraf_debug: False
# @var telegraf_quiet:description: Log only error level messages.
telegraf_quiet: True
# @var telegraf_logtarget:description: Log target controls the destination for logs.
telegraf_logtarget: stderr
# @var telegraf_logfile:description: Name of the file to be logged to when using the file logtarget.
# @var telegraf_logfile:default: $ "_unset_"
# @var telegraf_logfile_rotation_interval:description: The logfile will be rotated after the time interval specified.
# @var telegraf_logfile_rotation_interval:default: $ "_unset_"
# @var telegraf_logfile_rotation_max_size:description: The logfile will be rotated when it becomes larger than the specified size.
# @var telegraf_logfile_rotation_max_size:default: $ "_unset_"
# @var telegraf_logfile_rotation_max_archives:description: Maximum number of rotated archives to keep, any older logs are deleted.
# @var telegraf_logfile_rotation_max_archives:default: $ "_unset_"
# @var telegraf_hostname:description: Override default hostname.
telegraf_hostname: "{{ inventory_hostname }}"
# @var telegraf_omit_hostname:description: If set to True, do no set the host tag in the telegraf agent.
telegraf_omit_hostname: False
# @var telegraf_template_files:description: Path to templates loaded into telegraf.d directory.
telegraf_template_files:
- telegraf/templates/*.conf.j2
telegraf_prometheus_bind_ip: 127.0.0.1
telegraf_prometheus_bind_port: 9273
# @var telegraf_prometheus_username:description: Username used by Prometheus.
telegraf_prometheus_username: prometheus
# @var telegraf_prometheus_password:description: Password used by Prometheus.
telegraf_prometheus_password: secure
telegraf_prometheus_tls_enabled: False
telegraf_prometheus_tls_cert_path: /etc/pki/tls/certs/mycert.pem
telegraf_prometheus_tls_key_path: /etc/pki/tls/private/mykey.pem
telegraf_prometheus_tls_cert_source: mycert.pem
telegraf_prometheus_tls_key_source: mykey.pem
# @var telegraf_global_tags:description: List of global tags.
# @var telegraf_global_tags:example: >
# telegraf_global_tags:
# - key: rack
# value: r155
# - key: switch
# value: sw5
# @end
telegraf_global_tags: []
# @var telegraf_processors:description: List of default processors, combined with extra.
# @var telegraf_processors:example: >
# telegraf_processors:
# - plugin: foo
# config:
# - option1 = "value1"
# - option2 = "value2"
# @end
telegraf_processors: []
telegraf_processors_extra: []
# @var telegraf_aggregators:description: List of default aggregators, combined with extra.
# @var telegraf_aggregators:example: >
# telegraf_aggregators:
# - plugin: foo
# config:
# - option1 = "value1"
# - option2 = "value2"
# @end
telegraf_aggregators: []
telegraf_aggregators_extra: []
# @var telegraf_plugins:description: List of default plugins, combined with extra.
telegraf_plugins:
- plugin: net
config:
- ignore_protocol_stats = false
- interfaces = ["eth*"]
- plugin: cpu
config:
- percpu = true
- totalcpu = true
- collect_cpu_time = false
- report_active = false
- plugin: disk
config:
- ignore_fs = ["tmpfs", "devtmpfs", "devfs"]
- plugin: filestat
config:
- files = ["/var/log/**.log"]
- plugin: procstat
config:
- pattern = ".*"
- plugin: netstat
- plugin: diskio
- plugin: kernel
- plugin: mem
- plugin: processes
- plugin: swap
- plugin: system
- plugin: kernel_vmstat
- plugin: linux_sysctl_fs
telegraf_plugins_extra: []

View File

@ -1,18 +0,0 @@
---
- name: Restart Telegraf
service:
name: telegraf
state: restarted
daemon_reload: yes
enabled: yes
listen: __telegraf_restart
become: True
become_user: root
- name: Reload Telegraf
service:
name: telegraf
state: reloaded
listen: __telegraf_reload
become: True
become_user: root

440
index.md Normal file
View File

@ -0,0 +1,440 @@
---
title: telegraf
type: docs
---
[![Source Code](https://img.shields.io/badge/gitea-source%20code-blue?logo=gitea&amp;logoColor=white)](https://gitea.rknet.org/ansible/xoxys.telegraf) [![Build Status](https://img.shields.io/drone/build/ansible/xoxys.telegraf?logo=drone&amp;server=https%3A%2F%2Fdrone.rknet.org)](https://drone.rknet.org/ansible/xoxys.telegraf) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?label=license)](https://gitea.rknet.org/ansible/xoxys.telegraf/src/branch/main/LICENSE)
Setup [Telegraf](https://github.com/influxdata/telegraf) metrics agent.
<!--more-->
- [Default Variables](#default-variables)
- [telegraf_aggregators](#telegraf_aggregators)
- [telegraf_aggregators_extra](#telegraf_aggregators_extra)
- [telegraf_collection_jitter](#telegraf_collection_jitter)
- [telegraf_debug](#telegraf_debug)
- [telegraf_docker_group_name](#telegraf_docker_group_name)
- [telegraf_flush_interval](#telegraf_flush_interval)
- [telegraf_flush_jitter](#telegraf_flush_jitter)
- [telegraf_global_tags](#telegraf_global_tags)
- [telegraf_hostname](#telegraf_hostname)
- [telegraf_interval](#telegraf_interval)
- [telegraf_logfile](#telegraf_logfile)
- [telegraf_logfile_rotation_interval](#telegraf_logfile_rotation_interval)
- [telegraf_logfile_rotation_max_archives](#telegraf_logfile_rotation_max_archives)
- [telegraf_logfile_rotation_max_size](#telegraf_logfile_rotation_max_size)
- [telegraf_logtarget](#telegraf_logtarget)
- [telegraf_metric_batch_size](#telegraf_metric_batch_size)
- [telegraf_metric_buffer_limit](#telegraf_metric_buffer_limit)
- [telegraf_omit_hostname](#telegraf_omit_hostname)
- [telegraf_packages_extra](#telegraf_packages_extra)
- [telegraf_plugins](#telegraf_plugins)
- [telegraf_plugins_extra](#telegraf_plugins_extra)
- [telegraf_precision](#telegraf_precision)
- [telegraf_processors](#telegraf_processors)
- [telegraf_processors_extra](#telegraf_processors_extra)
- [telegraf_prometheus_bind_ip](#telegraf_prometheus_bind_ip)
- [telegraf_prometheus_bind_port](#telegraf_prometheus_bind_port)
- [telegraf_prometheus_password](#telegraf_prometheus_password)
- [telegraf_prometheus_tls_cert_path](#telegraf_prometheus_tls_cert_path)
- [telegraf_prometheus_tls_cert_source](#telegraf_prometheus_tls_cert_source)
- [telegraf_prometheus_tls_enabled](#telegraf_prometheus_tls_enabled)
- [telegraf_prometheus_tls_key_path](#telegraf_prometheus_tls_key_path)
- [telegraf_prometheus_tls_key_source](#telegraf_prometheus_tls_key_source)
- [telegraf_prometheus_username](#telegraf_prometheus_username)
- [telegraf_quiet](#telegraf_quiet)
- [telegraf_requires_docker_group](#telegraf_requires_docker_group)
- [telegraf_round_interval](#telegraf_round_interval)
- [telegraf_template_files](#telegraf_template_files)
- [Discovered Tags](#discovered-tags)
- [Dependencies](#dependencies)
---
## Default Variables
### telegraf_aggregators
List of default aggregators, combined with extra.
#### Default value
```YAML
telegraf_aggregators: []
```
#### Example usage
```YAML
telegraf_aggregators:
- plugin: foo
config:
- option1 = "value1"
- option2 = "value2"
```
### telegraf_aggregators_extra
#### Default value
```YAML
telegraf_aggregators_extra: []
```
### telegraf_collection_jitter
Collection jitter is used to jitter the collection by a random amount.
#### Default value
```YAML
telegraf_collection_jitter: 0s
```
### telegraf_debug
Log at debug level.
#### Default value
```YAML
telegraf_debug: false
```
### telegraf_docker_group_name
#### Default value
```YAML
telegraf_docker_group_name: dockerroot
```
### telegraf_flush_interval
Default flushing interval for all outputs.
#### Default value
```YAML
telegraf_flush_interval: 10s
```
### telegraf_flush_jitter
Jitter the flush interval by a random amount.
#### Default value
```YAML
telegraf_flush_jitter: 0s
```
### telegraf_global_tags
List of global tags.
#### Default value
```YAML
telegraf_global_tags: []
```
#### Example usage
```YAML
telegraf_global_tags:
- key: rack
value: r155
- key: switch
value: sw5
```
### telegraf_hostname
Override default hostname.
#### Default value
```YAML
telegraf_hostname: '{{ inventory_hostname }}'
```
### telegraf_interval
Default data collection interval for all inputs.
#### Default value
```YAML
telegraf_interval: 10s
```
### telegraf_logfile
Name of the file to be logged to when using the file logtarget.
### telegraf_logfile_rotation_interval
The logfile will be rotated after the time interval specified.
### telegraf_logfile_rotation_max_archives
Maximum number of rotated archives to keep, any older logs are deleted.
### telegraf_logfile_rotation_max_size
The logfile will be rotated when it becomes larger than the specified size.
### telegraf_logtarget
Log target controls the destination for logs.
#### Default value
```YAML
telegraf_logtarget: stderr
```
### telegraf_metric_batch_size
Telegraf will send metrics to outputs in batches of this amount.
#### Default value
```YAML
telegraf_metric_batch_size: 1000
```
### telegraf_metric_buffer_limit
Maximum number of unwritten metrics per output.
#### Default value
```YAML
telegraf_metric_buffer_limit: 10000
```
### telegraf_omit_hostname
If set to True, do no set the host tag in the telegraf agent.
#### Default value
```YAML
telegraf_omit_hostname: false
```
### telegraf_packages_extra
#### Default value
```YAML
telegraf_packages_extra: []
```
### telegraf_plugins
List of default plugins, combined with extra.
#### Default value
```YAML
telegraf_plugins:
- plugin: net
config:
- ignore_protocol_stats = false
- interfaces = ["eth*"]
- plugin: cpu
config:
- percpu = true
- totalcpu = true
- collect_cpu_time = false
- report_active = false
- plugin: disk
config:
- ignore_fs = ["tmpfs", "devtmpfs", "devfs"]
- plugin: filestat
config:
- files = ["/var/log/**.log"]
- plugin: procstat
config:
- pattern = ".*"
- plugin: netstat
- plugin: diskio
- plugin: kernel
- plugin: mem
- plugin: processes
- plugin: swap
- plugin: system
- plugin: kernel_vmstat
- plugin: linux_sysctl_fs
```
### telegraf_plugins_extra
#### Default value
```YAML
telegraf_plugins_extra: []
```
### telegraf_precision
Precision will be set to the same timestamp order as the collection interval.
### telegraf_processors
List of default processors, combined with extra.
#### Default value
```YAML
telegraf_processors: []
```
#### Example usage
```YAML
telegraf_processors:
- plugin: foo
config:
- option1 = "value1"
- option2 = "value2"
```
### telegraf_processors_extra
#### Default value
```YAML
telegraf_processors_extra: []
```
### telegraf_prometheus_bind_ip
#### Default value
```YAML
telegraf_prometheus_bind_ip: 127.0.0.1
```
### telegraf_prometheus_bind_port
#### Default value
```YAML
telegraf_prometheus_bind_port: 9273
```
### telegraf_prometheus_password
Password used by Prometheus.
#### Default value
```YAML
telegraf_prometheus_password: secure
```
### telegraf_prometheus_tls_cert_path
#### Default value
```YAML
telegraf_prometheus_tls_cert_path: /etc/pki/tls/certs/mycert.pem
```
### telegraf_prometheus_tls_cert_source
#### Default value
```YAML
telegraf_prometheus_tls_cert_source: mycert.pem
```
### telegraf_prometheus_tls_enabled
#### Default value
```YAML
telegraf_prometheus_tls_enabled: false
```
### telegraf_prometheus_tls_key_path
#### Default value
```YAML
telegraf_prometheus_tls_key_path: /etc/pki/tls/private/mykey.pem
```
### telegraf_prometheus_tls_key_source
#### Default value
```YAML
telegraf_prometheus_tls_key_source: mykey.pem
```
### telegraf_prometheus_username
Username used by Prometheus.
#### Default value
```YAML
telegraf_prometheus_username: prometheus
```
### telegraf_quiet
Log only error level messages.
#### Default value
```YAML
telegraf_quiet: true
```
### telegraf_requires_docker_group
Optionally disable docker group join.
#### Default value
```YAML
telegraf_requires_docker_group: false
```
### telegraf_round_interval
Rounds collection interval to interval.
#### Default value
```YAML
telegraf_round_interval: true
```
### telegraf_template_files
Path to templates loaded into telegraf.d directory.
#### Default value
```YAML
telegraf_template_files:
- telegraf/templates/*.conf.j2
```
## Discovered Tags
tls_renewal
: &nbsp;
## Dependencies
None.

View File

@ -1,23 +0,0 @@
# Standards: 0.2
---
galaxy_info:
# @meta author:value: [Robert Kaussow](https://gitea.rknet.org/xoxys)
author: "Robert Kaussow <mail@thegeeklab.de>"
namespace: xoxys
role_name: telegraf
# @meta description: >
# [![Source Code](https://img.shields.io/badge/gitea-source%20code-blue?logo=gitea&logoColor=white)](https://gitea.rknet.org/ansible/xoxys.telegraf)
# [![Build Status](https://img.shields.io/drone/build/ansible/xoxys.telegraf?logo=drone&server=https%3A%2F%2Fdrone.rknet.org)](https://drone.rknet.org/ansible/xoxys.telegraf)
# [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?label=license)](https://gitea.rknet.org/ansible/xoxys.telegraf/src/branch/main/LICENSE)
#
# Setup [Telegraf](https://github.com/influxdata/telegraf) metrics agent.
# @end
description: Setup Telegraf metrics agent
license: MIT
min_ansible_version: 2.10
platforms:
- name: EL
versions:
- 7
galaxy_tags: []
dependencies: []

View File

@ -1,7 +0,0 @@
---
- name: Converge
hosts: all
vars:
telegraf_quiet: False
roles:
- role: xoxys.telegraf

View File

@ -1,120 +0,0 @@
---
- name: Create
hosts: localhost
connection: local
gather_facts: false
no_log: "{{ molecule_no_log }}"
vars:
ssh_port: 22
ssh_user: root
ssh_path: "{{ lookup('env', 'MOLECULE_EPHEMERAL_DIRECTORY') }}/ssh_key"
tasks:
- name: Create SSH key
user:
name: "{{ lookup('env', 'USER') }}"
generate_ssh_key: true
ssh_key_file: "{{ ssh_path }}"
force: true
register: generated_ssh_key
- name: Register the SSH key name
set_fact:
ssh_key_name: "molecule-generated-{{ 12345 | random | to_uuid }}"
- name: Register SSH key for test instance(s)
hcloud_ssh_key:
name: "{{ ssh_key_name }}"
public_key: "{{ generated_ssh_key.ssh_public_key }}"
state: present
- name: Create molecule instance(s)
hcloud_server:
name: "{{ item.name }}"
server_type: "{{ item.server_type }}"
ssh_keys:
- "{{ ssh_key_name }}"
image: "{{ item.image }}"
location: "{{ item.location | default(omit) }}"
datacenter: "{{ item.datacenter | default(omit) }}"
user_data: "{{ item.user_data | default(omit) }}"
api_token: "{{ lookup('env', 'HCLOUD_TOKEN') }}"
state: present
register: server
loop: "{{ molecule_yml.platforms }}"
async: 7200
poll: 0
- name: Wait for instance(s) creation to complete
async_status:
jid: "{{ item.ansible_job_id }}"
register: hetzner_jobs
until: hetzner_jobs.finished
retries: 300
loop: "{{ server.results }}"
- name: Create volume(s)
hcloud_volume:
name: "{{ item.name }}"
server: "{{ item.name }}"
location: "{{ item.location | default(omit) }}"
size: "{{ item.volume_size | default(10) }}"
api_token: "{{ lookup('env', 'HCLOUD_TOKEN') }}"
state: "present"
loop: "{{ molecule_yml.platforms }}"
when: item.volume | default(False) | bool
register: volumes
async: 7200
poll: 0
- name: Wait for volume(s) creation to complete
async_status:
jid: "{{ item.ansible_job_id }}"
register: hetzner_volumes
until: hetzner_volumes.finished
retries: 300
when: volumes.changed
loop: "{{ volumes.results }}"
# Mandatory configuration for Molecule to function.
- name: Populate instance config dict
set_fact:
instance_conf_dict:
{
"instance": "{{ item.hcloud_server.name }}",
"ssh_key_name": "{{ ssh_key_name }}",
"address": "{{ item.hcloud_server.ipv4_address }}",
"user": "{{ ssh_user }}",
"port": "{{ ssh_port }}",
"identity_file": "{{ ssh_path }}",
"volume": "{{ item.item.item.volume | default(False) | bool }}",
}
loop: "{{ hetzner_jobs.results }}"
register: instance_config_dict
when: server.changed | bool
- name: Convert instance config dict to a list
set_fact:
instance_conf: "{{ instance_config_dict.results | map(attribute='ansible_facts.instance_conf_dict') | list }}"
when: server.changed | bool
- name: Dump instance config
copy:
content: |
# Molecule managed
{{ instance_conf | to_nice_yaml(indent=2) }}
dest: "{{ molecule_instance_config }}"
when: server.changed | bool
- name: Wait for SSH
wait_for:
port: "{{ ssh_port }}"
host: "{{ item.address }}"
search_regex: SSH
delay: 10
loop: "{{ lookup('file', molecule_instance_config) | from_yaml }}"
- name: Wait for VM to settle down
pause:
seconds: 30

View File

@ -1,78 +0,0 @@
---
- name: Destroy
hosts: localhost
connection: local
gather_facts: false
no_log: "{{ molecule_no_log }}"
tasks:
- name: Check existing instance config file
stat:
path: "{{ molecule_instance_config }}"
register: cfg
- name: Populate the instance config
set_fact:
instance_conf: "{{ (lookup('file', molecule_instance_config) | from_yaml) if cfg.stat.exists else [] }}"
- name: Destroy molecule instance(s)
hcloud_server:
name: "{{ item.instance }}"
api_token: "{{ lookup('env', 'HCLOUD_TOKEN') }}"
state: absent
register: server
loop: "{{ instance_conf }}"
async: 7200
poll: 0
- name: Wait for instance(s) deletion to complete
async_status:
jid: "{{ item.ansible_job_id }}"
register: hetzner_jobs
until: hetzner_jobs.finished
retries: 300
loop: "{{ server.results }}"
- pause:
seconds: 5
- name: Destroy volume(s)
hcloud_volume:
name: "{{ item.instance }}"
server: "{{ item.instance }}"
api_token: "{{ lookup('env', 'HCLOUD_TOKEN') }}"
state: "absent"
register: volumes
loop: "{{ instance_conf }}"
when: item.volume | default(False) | bool
async: 7200
poll: 0
- name: Wait for volume(s) deletion to complete
async_status:
jid: "{{ item.ansible_job_id }}"
register: hetzner_volumes
until: hetzner_volumes.finished
retries: 300
when: volumes.changed
loop: "{{ volumes.results }}"
- name: Remove registered SSH key
hcloud_ssh_key:
name: "{{ instance_conf[0].ssh_key_name }}"
state: absent
when: (instance_conf | default([])) | length > 0
# Mandatory configuration for Molecule to function.
- name: Populate instance config
set_fact:
instance_conf: {}
- name: Dump instance config
copy:
content: |
# Molecule managed
{{ instance_conf | to_nice_yaml(indent=2) }}
dest: "{{ molecule_instance_config }}"
when: server.changed | bool

View File

@ -1,24 +0,0 @@
---
dependency:
name: galaxy
options:
role-file: molecule/requirements.yml
requirements-file: molecule/requirements.yml
env:
ANSIBLE_GALAXY_DISPLAY_PROGRESS: "false"
driver:
name: delegated
platforms:
- name: centos7-telegraf
image: centos-7
server_type: cx11
lint: |
/usr/local/bin/flake8
provisioner:
name: ansible
env:
ANSIBLE_FILTER_PLUGINS: ${ANSIBLE_FILTER_PLUGINS:-./plugins/filter}
ANSIBLE_LIBRARY: ${ANSIBLE_LIBRARY:-./library}
log: False
verifier:
name: testinfra

View File

@ -1,15 +0,0 @@
---
- name: Prepare
hosts: all
gather_facts: false
tasks:
- name: Bootstrap python for Ansible
raw: |
command -v python3 python || (
(test -e /usr/bin/dnf && sudo dnf install -y python3) ||
(test -e /usr/bin/apt && (apt -y update && apt install -y python-minimal)) ||
(test -e /usr/bin/yum && sudo yum -y -qq install python3) ||
echo "Warning: Python not boostrapped due to unknown platform."
)
become: true
changed_when: false

View File

@ -1,4 +0,0 @@
[[inputs.ping]]
## Hosts to send ping packets to.
urls = ["1.1.1.1", "{{ ansible_default_ipv4.address }}"]
method = "exec"

View File

@ -1,23 +0,0 @@
import os
import testinfra.utils.ansible_runner
testinfra_hosts = testinfra.utils.ansible_runner.AnsibleRunner(
os.environ["MOLECULE_INVENTORY_FILE"]
).get_hosts("all")
def test_telegraf_installed(host):
pkg = host.package("telegraf")
assert pkg.is_installed
def test_telegraf_running_and_enabled(host):
telegraf = host.service("telegraf")
assert telegraf.is_running
assert telegraf.is_enabled
def test_telegraf_socket(host):
# Verify the socket is listening for telegraf traffic
assert host.socket("tcp://127.0.0.1:9273").is_listening

View File

@ -1 +0,0 @@
rocky8

View File

@ -1,3 +0,0 @@
[pytest]
filterwarnings =
ignore::DeprecationWarning

View File

@ -1,6 +0,0 @@
---
collections:
- name: https://gitea.rknet.org/ansible/xoxys.general/releases/download/v2.1.1/xoxys-general-2.1.1.tar.gz
- name: community.general
roles: []

View File

@ -1,7 +0,0 @@
---
- name: Converge
hosts: all
vars:
telegraf_quiet: False
roles:
- role: xoxys.telegraf

View File

@ -1,120 +0,0 @@
---
- name: Create
hosts: localhost
connection: local
gather_facts: false
no_log: "{{ molecule_no_log }}"
vars:
ssh_port: 22
ssh_user: root
ssh_path: "{{ lookup('env', 'MOLECULE_EPHEMERAL_DIRECTORY') }}/ssh_key"
tasks:
- name: Create SSH key
user:
name: "{{ lookup('env', 'USER') }}"
generate_ssh_key: true
ssh_key_file: "{{ ssh_path }}"
force: true
register: generated_ssh_key
- name: Register the SSH key name
set_fact:
ssh_key_name: "molecule-generated-{{ 12345 | random | to_uuid }}"
- name: Register SSH key for test instance(s)
hcloud_ssh_key:
name: "{{ ssh_key_name }}"
public_key: "{{ generated_ssh_key.ssh_public_key }}"
state: present
- name: Create molecule instance(s)
hcloud_server:
name: "{{ item.name }}"
server_type: "{{ item.server_type }}"
ssh_keys:
- "{{ ssh_key_name }}"
image: "{{ item.image }}"
location: "{{ item.location | default(omit) }}"
datacenter: "{{ item.datacenter | default(omit) }}"
user_data: "{{ item.user_data | default(omit) }}"
api_token: "{{ lookup('env', 'HCLOUD_TOKEN') }}"
state: present
register: server
loop: "{{ molecule_yml.platforms }}"
async: 7200
poll: 0
- name: Wait for instance(s) creation to complete
async_status:
jid: "{{ item.ansible_job_id }}"
register: hetzner_jobs
until: hetzner_jobs.finished
retries: 300
loop: "{{ server.results }}"
- name: Create volume(s)
hcloud_volume:
name: "{{ item.name }}"
server: "{{ item.name }}"
location: "{{ item.location | default(omit) }}"
size: "{{ item.volume_size | default(10) }}"
api_token: "{{ lookup('env', 'HCLOUD_TOKEN') }}"
state: "present"
loop: "{{ molecule_yml.platforms }}"
when: item.volume | default(False) | bool
register: volumes
async: 7200
poll: 0
- name: Wait for volume(s) creation to complete
async_status:
jid: "{{ item.ansible_job_id }}"
register: hetzner_volumes
until: hetzner_volumes.finished
retries: 300
when: volumes.changed
loop: "{{ volumes.results }}"
# Mandatory configuration for Molecule to function.
- name: Populate instance config dict
set_fact:
instance_conf_dict:
{
"instance": "{{ item.hcloud_server.name }}",
"ssh_key_name": "{{ ssh_key_name }}",
"address": "{{ item.hcloud_server.ipv4_address }}",
"user": "{{ ssh_user }}",
"port": "{{ ssh_port }}",
"identity_file": "{{ ssh_path }}",
"volume": "{{ item.item.item.volume | default(False) | bool }}",
}
loop: "{{ hetzner_jobs.results }}"
register: instance_config_dict
when: server.changed | bool
- name: Convert instance config dict to a list
set_fact:
instance_conf: "{{ instance_config_dict.results | map(attribute='ansible_facts.instance_conf_dict') | list }}"
when: server.changed | bool
- name: Dump instance config
copy:
content: |
# Molecule managed
{{ instance_conf | to_nice_yaml(indent=2) }}
dest: "{{ molecule_instance_config }}"
when: server.changed | bool
- name: Wait for SSH
wait_for:
port: "{{ ssh_port }}"
host: "{{ item.address }}"
search_regex: SSH
delay: 10
loop: "{{ lookup('file', molecule_instance_config) | from_yaml }}"
- name: Wait for VM to settle down
pause:
seconds: 30

View File

@ -1,78 +0,0 @@
---
- name: Destroy
hosts: localhost
connection: local
gather_facts: false
no_log: "{{ molecule_no_log }}"
tasks:
- name: Check existing instance config file
stat:
path: "{{ molecule_instance_config }}"
register: cfg
- name: Populate the instance config
set_fact:
instance_conf: "{{ (lookup('file', molecule_instance_config) | from_yaml) if cfg.stat.exists else [] }}"
- name: Destroy molecule instance(s)
hcloud_server:
name: "{{ item.instance }}"
api_token: "{{ lookup('env', 'HCLOUD_TOKEN') }}"
state: absent
register: server
loop: "{{ instance_conf }}"
async: 7200
poll: 0
- name: Wait for instance(s) deletion to complete
async_status:
jid: "{{ item.ansible_job_id }}"
register: hetzner_jobs
until: hetzner_jobs.finished
retries: 300
loop: "{{ server.results }}"
- pause:
seconds: 5
- name: Destroy volume(s)
hcloud_volume:
name: "{{ item.instance }}"
server: "{{ item.instance }}"
api_token: "{{ lookup('env', 'HCLOUD_TOKEN') }}"
state: "absent"
register: volumes
loop: "{{ instance_conf }}"
when: item.volume | default(False) | bool
async: 7200
poll: 0
- name: Wait for volume(s) deletion to complete
async_status:
jid: "{{ item.ansible_job_id }}"
register: hetzner_volumes
until: hetzner_volumes.finished
retries: 300
when: volumes.changed
loop: "{{ volumes.results }}"
- name: Remove registered SSH key
hcloud_ssh_key:
name: "{{ instance_conf[0].ssh_key_name }}"
state: absent
when: (instance_conf | default([])) | length > 0
# Mandatory configuration for Molecule to function.
- name: Populate instance config
set_fact:
instance_conf: {}
- name: Dump instance config
copy:
content: |
# Molecule managed
{{ instance_conf | to_nice_yaml(indent=2) }}
dest: "{{ molecule_instance_config }}"
when: server.changed | bool

View File

@ -1,24 +0,0 @@
---
dependency:
name: galaxy
options:
role-file: molecule/requirements.yml
requirements-file: molecule/requirements.yml
env:
ANSIBLE_GALAXY_DISPLAY_PROGRESS: "false"
driver:
name: delegated
platforms:
- name: rocky8-telegraf
image: rocky-8
server_type: cx11
lint: |
/usr/local/bin/flake8
provisioner:
name: ansible
env:
ANSIBLE_FILTER_PLUGINS: ${ANSIBLE_FILTER_PLUGINS:-./plugins/filter}
ANSIBLE_LIBRARY: ${ANSIBLE_LIBRARY:-./library}
log: False
verifier:
name: testinfra

View File

@ -1,15 +0,0 @@
---
- name: Prepare
hosts: all
gather_facts: false
tasks:
- name: Bootstrap python for Ansible
raw: |
command -v python3 python || (
(test -e /usr/bin/dnf && sudo dnf install -y python3) ||
(test -e /usr/bin/apt && (apt -y update && apt install -y python-minimal)) ||
(test -e /usr/bin/yum && sudo yum -y -qq install python3) ||
echo "Warning: Python not boostrapped due to unknown platform."
)
become: true
changed_when: false

View File

@ -1,4 +0,0 @@
[[inputs.ping]]
## Hosts to send ping packets to.
urls = ["1.1.1.1", "{{ ansible_default_ipv4.address }}"]
method = "exec"

View File

@ -1,23 +0,0 @@
import os
import testinfra.utils.ansible_runner
testinfra_hosts = testinfra.utils.ansible_runner.AnsibleRunner(
os.environ["MOLECULE_INVENTORY_FILE"]
).get_hosts("all")
def test_telegraf_installed(host):
pkg = host.package("telegraf")
assert pkg.is_installed
def test_telegraf_running_and_enabled(host):
telegraf = host.service("telegraf")
assert telegraf.is_running
assert telegraf.is_enabled
def test_telegraf_socket(host):
# Verify the socket is listening for telegraf traffic
assert host.socket("tcp://127.0.0.1:9273").is_listening

View File

@ -1,12 +0,0 @@
[flake8]
ignore = D100, D101, D102, D103, D105, D107, E402, W503
max-line-length = 99
inline-quotes = double
exclude = .git,.tox,__pycache__,build,dist,tests,*.pyc,*.egg-info,.cache,.eggs,env*
[yapf]
based_on_style = google
column_limit = 99
dedent_closing_brackets = true
coalesce_brackets = true
split_before_logical_operator = true

View File

@ -1,6 +0,0 @@
---
- include_tasks: setup.yml
- import_tasks: tls.yml
when: telegraf_prometheus_tls_enabled | bool
tags: tls_renewal
- include_tasks: post_tasks.yml

View File

@ -1,9 +0,0 @@
---
- name: Ensure Telegraf is up and running
service:
name: telegraf
daemon_reload: yes
enabled: yes
state: started
become: True
become_user: root

View File

@ -1,64 +0,0 @@
---
- block:
- name: Add Telegraf repository
yum_repository:
name: influxdb
file: InfluxDB
description: InfluxDB Repository
baseurl: "https://repos.influxdata.com/rhel/{{ ansible_distribution_major_version }}/$basearch/stable"
gpgkey: https://repos.influxdata.com/influxdata-archive_compat.key
gpgcheck: yes
- name: Ensure dependencies are installed
package:
name: "{{ item }}"
state: present
loop: "{{ telegraf_packages_extra }}"
- name: Ensure Telegraf is installed
package:
name: "{{ item }}"
state: present
loop:
- telegraf
- name: Ensure Telegraf directories exist
file:
path: "{{ item }}"
state: directory
owner: telegraf
group: telegraf
mode: 0750
loop:
- /etc/telegraf/.cache/snowflake
- name: Copy custom Telegraf template files
template:
src: "{{ item }}"
dest: /etc/telegraf/telegraf.d/{{ item | basename | splitext | first }}
owner: telegraf
group: root
mode: 0640
with_fileglob: "{{ telegraf_template_files }}"
loop_control:
label: "{{ item | basename | splitext | first }}"
notify: __telegraf_reload
- name: Add docker group
user:
name: telegraf
groups: "{{ telegraf_docker_group_name }}"
append: True
notify: __telegraf_restart
when: telegraf_requires_docker_group
- name: Write config file
template:
src: etc/telegraf/telegraf/telegraf.conf.j2
dest: /etc/telegraf/telegraf.conf
owner: telegraf
group: root
mode: 0600
notify: __telegraf_reload
become: True
become_user: root

View File

@ -1,30 +0,0 @@
---
- block:
- name: Create tls folder structure
file:
path: "{{ item }}"
state: directory
recurse: True
loop:
- "{{ telegraf_prometheus_tls_cert_path | dirname }}"
- "{{ telegraf_prometheus_tls_key_path | dirname }}"
- name: Copy certs and private key
copy:
src: "{{ item.src }}"
dest: "{{ item.dest }}"
owner: telegraf
group: root
mode: "{{ item.mode }}"
loop:
- src: "{{ telegraf_prometheus_tls_key_source }}"
dest: "{{ telegraf_prometheus_tls_key_path }}"
mode: "0600"
- src: "{{ telegraf_prometheus_tls_cert_source }}"
dest: "{{ telegraf_prometheus_tls_cert_path }}"
mode: "0750"
loop_control:
label: "{{ item.dest }}"
notify: __telegraf_reload
become: True
become_user: root

View File

@ -1,92 +0,0 @@
#jinja2: lstrip_blocks: True
{{ ansible_managed | comment }}
[agent]
interval = "{{ telegraf_interval }}"
round_interval = {{ telegraf_round_interval | lower }}
metric_batch_size = {{ telegraf_metric_batch_size }}
metric_buffer_limit = {{ telegraf_metric_buffer_limit }}
collection_jitter = "{{ telegraf_collection_jitter }}"
flush_interval = "{{ telegraf_flush_interval }}"
flush_jitter = "{{ telegraf_flush_jitter }}"
precision = "{{ telegraf_precision | default('') }}"
debug = {{ telegraf_debug | lower }}
quiet = {{ telegraf_quiet | lower }}
logtarget = "{{ telegraf_logtarget }}"
{% if telegraf_logfile is defined %}
logfile = "{{ telegraf_logfile }}"
{% endif %}
{% if telegraf_logfile_rotation_interval | default(False) %}
logfile_rotation_interval = "{{ telegraf_logfile_rotation_interval }}"
{% endif %}
{% if telegraf_logfile_rotation_max_size | default(False) %}
logfile_rotation_max_size = "{{ telegraf_logfile_rotation_max_size }}"
{% endif %}
{% if telegraf_logfile_rotation_max_archives | default(False) %}
logfile_rotation_max_archives = {{ telegraf_logfile_rotation_max_archives }}
{% endif %}
hostname = "{{ telegraf_hostname }}"
omit_hostname = {{ telegraf_omit_hostname | lower }}
{% if telegraf_global_tags | length > 0 %}
[global_tags]
{% for tag in telegraf_global_tags %}
{{ tag.key }} = "{{ tag.value }}"
{% endfor %}
{% endif %}
[[outputs.prometheus_client]]
listen = "{{ telegraf_prometheus_bind_ip }}:{{ telegraf_prometheus_bind_port }}"
basic_username = "{{ telegraf_prometheus_username }}"
basic_password = "{{ telegraf_prometheus_password }}"
ip_range = []
{% if telegraf_prometheus_tls_enabled | bool %}
tls_cert = "{{ telegraf_prometheus_tls_cert_path }}"
tls_key = "{{ telegraf_prometheus_tls_key_path }}"
{% endif %}
export_timestamp = false
{% if (telegraf_processors + telegraf_processors_extra) | length > 0 %}
{% for item in (telegraf_processors + telegraf_processors_extra) %}
[[processors.{{ item.plugin }}]]
{% if item.config is defined and item.config is iterable %}
{% for item in item.config %}
{{ item }}
{% endfor %}
{% else %}
# no configuration
{% endif %}
{% endfor %}
{% endif %}
{% if (telegraf_aggregators + telegraf_aggregators_extra) | length > 0 %}
{% for item in (telegraf_aggregators + telegraf_aggregators_extra) %}
[[aggregators.{{ item.plugin }}]]
{% if item.period | default(False) %}
period = "{{ item.interval }}s"
{% endif %}
{% if item.config is defined and item.config is iterable %}
{% for item in item.config %}
{{ item }}
{% endfor %}
{% else %}
# no configuration
{% endif %}
{% endfor %}
{% endif %}
{% if (telegraf_plugins + telegraf_plugins_extra) | length > 0 %}
{% for item in (telegraf_plugins + telegraf_plugins_extra) %}
[[inputs.{{ item.plugin }}]]
{% if item.interval | default(False) %}
interval = "{{ item.interval }}s"
{% endif %}
{% if item.config is defined and item.config is iterable %}
{% for item in item.config %}
{{ item }}
{% endfor %}
{% else %}
# no configuration
{% endif %}
{% endfor %}
{% endif %}