/fluent-plugin-insight

Fluentd Plugin for InsightOPS

Primary LanguageRubyMIT LicenseMIT

Fluent::Plugin::Insight

Forward logs to Insight, using token based input.

Using Insight REST API gets log tokens by logset id and matches record['log'] of every record to a log name in logset

Installation

install with gem or fluent-gem command as:

native gem

$ gem install fluent-plugin-insight

fluentd gem

$ /opt/td-agent/embedded/bin/fluent-gem install fluent-plugin-insight

Usage

    <match pattern>
      type insight
      tags hostname,environment,application
      prefix %{hostname} %{environment}-%{application}
      api_key test
      logset_id id
      region eu
    </match>

Parameters

type (required)

The value must be insight.

logset_id (required)

InsightOPS logset id

region (required)

InsightOPS region

tags

List of record keys which can be retrieved from record to build a log record prefix

prefix

Prefix is added to every log record. It's a format string which uses tags values

protocol

The default is tcp.

use_ssl

Enable/disable SSL for data transfers between Fluentd and Insight. The default is true.

port

Only in case you don't use SSL, the value must be 80, 514, or 10000. The default is 20000 (SSL)

max_retries

Number of retries on failure.

Contributing

  1. Fork it ( http://github.com/Tweddle-SE-Team/fluent-plugin-insight/fork )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

MIT

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.