https://github.com/monasca/fluentd-monasca

Fluentd output plugin for Monasca API
https://github.com/monasca/fluentd-monasca

Last synced: 6 months ago
JSON representation

Fluentd output plugin for Monasca API

• Host: GitHub
• URL: https://github.com/monasca/fluentd-monasca
• Owner: monasca
• License: apache-2.0
• Created: 2018-09-17T08:14:46.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2021-01-06T11:40:11.000Z (over 5 years ago)
• Last Synced: 2023-08-29T21:30:41.368Z (almost 3 years ago)
• Language: Ruby
• Size: 26.4 KB
• Stars: 0
• Watchers: 7
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# fluentd-monasca

Fluentd output plugin for the Monasca API.

Note that this does not support the Monasca Log API which has been

deprecated. If you wish to use the Monasca Log API, please use release

0.1.1.

## Requirements

* `ruby`

* `td-agent`

## Installation

To install the `fluentd-monasca-output` gem:

    gem build fluentd-monasca-output.gemspec

    gem install fluentd-monasca-output-.gem

    td-agent-gem install fluentd-monasca-output

## Configuration

Example `td-agent.conf` configuration that forwards all logs to Monasca:

    

        type copy

        

           @type monasca

           keystone_url 

           monasca_api 

           monasca_api_version v2.0

           username 

           password 

           domain_id 

           project_name 

        

    

Note that by default the `message` field is used to extract the log message, and all other fields are forwarded as dimensions. If the log message is extracted to a different field, for example the `Payload` field by Fluentd, this can be configured with the following config line:

    message_field_name Payload

Buffering of logs by default is to memory. Buffering settings are detailed in the [Fluent documentation](https://docs.fluentd.org/v/0.12/buffer/file). Example settings for buffering to file are given below:

    buffer_type file

    buffer_path /var/lib/fluentd/data/monasca.*.buffer

    max_retry_wait 10s

There is currently no support for looking up a logging endpoint from the Keystone catalogue.

## Changelog

### 1.0.0

 - Support posting logs to the unified Monasca API

 - Remove support for posting logs to Monasca Log API

### 1.0.1

 - Switch to yajl JSON parser to fix issue parsing some logs

### 1.0.2

 - Upgrade rest-client library to work with openssl 2.x