cloudalchemy.fluentd

Panoramica Versioni Approfondimenti

<a href="https://www.fluentd.org">
    <img src="https://www.fluentd.org/assets/img/miscellany/fluentd-logo.png" alt="fluentd logo" title="fluentd" align="right" height="60" />
</a>

# Ansible Role: fluentd

[![Build Status](https://travis-ci.org/cloudalchemy/ansible-fluentd.svg?branch=master)](https://travis-ci.org/cloudalchemy/ansible-fluentd)
[![License: MIT](https://img.shields.io/badge/license-MIT%20License-brightgreen.svg)](https://opensource.org/licenses/MIT)
[![Ansible Role](http://img.shields.io/badge/ansible%20role-cloudalchemy.fluentd-blue.svg)](https://galaxy.ansible.com/cloudalchemy/fluentd/)
[![GitHub tag](https://img.shields.io/github/tag/cloudalchemy/ansible-fluentd.svg)](https://github.com/cloudalchemy/ansible-fluentd/tags)
[![IRC](https://img.shields.io/badge/irc.freenode.net-%23cloudalchemy-yellow.svg)](https://kiwiirc.com/nextclient/#ircs://irc.freenode.net/#cloudalchemy)

## Important!

We no longer support this role. We won’t accept pull requests or new issues. This repository will stay, but we recommend switching to alternatives like [idealista/fluentd-role](https://github.com/idealista/fluentd-role).

## Description

This role installs and manages the [fluentd](https://github.com/fluent/fluentd) log forwarder and aggregator.

## Requirements

- Ansible version 2.7 or higher (It may work with earlier versions, but we can't promise that)

## Role Variables

You can override all variables stored in the [defaults/main.yml](defaults/main.yml) file and the table below:

| Name                    | Default Value | Description                                       |
|-------------------------|---------------|---------------------------------------------------|
| `fluentd_custom_conf`   | []            | Paths to custom configuration templates. [Configuration examples]( https://github.com/fluent/fluentd/tree/master/example). |
| `fluentd_plugins`       | []            | List of extra plugins                              |

## Example

### Playbook

To use it in a playbook, do the following:
```yaml
- hosts: all
  become: true
  roles:
    - cloudalchemy.fluentd

Demo Site

We provide a demo site for a complete monitoring solution using Prometheus and Grafana. You can find the code and running instances on GitHub, and the site is hosted on DigitalOcean.

Local Testing

The best way to test this role locally is to use Docker and molecule (v2.x). You'll need to install Docker on your system. Check "Get started" for a suitable Docker package for your system. We use tox to make it easier to test with different Ansible versions. To install tox, run:

pip3 install tox

To run tests on all Ansible versions (WARNING: this might take some time):

tox

To run a specific molecule command with the default test scenario:

tox -e py35-ansible28 -- molecule test -s default

For more details about molecule, check their documentation.

If you want to test on a remote Docker host, set the DOCKER_HOST variable before running tox tests.

Travis CI

Using molecule with Travis CI allows us to test how new pull requests will work with different Ansible versions and operating systems. This lets us create test scenarios for various role configurations. The test matrix can get quite large, so it might take longer than local testing—please be patient.