fluent-plugin-sentry

Overview

fluent-plugin-sentry is a fluentd output plugin that sends aggregated errors/exception events to Sentry. Sentry is a event logging and aggregation platform.

Sentry alone does not buffer incoming requests, so if your Sentry instance is under load, Sentry can respond with a 503 Service Unavailable.

fluent-plugin-sentry extends fluent buffered output and enables a fluend user to buffer and flush messages to Sentry with reliable delivery.

• Sentry Official web
• Sentry Documents Screenshots

(quoted from http://blog.getsentry.com/)

Installation

install with gem or td-agent provided command as:

# for fluentd
$ gem install fluent-plugin-sentry

# for td-agent
$ sudo /usr/lib64/fluent/ruby/bin/fluent-gem install fluent-plugin-sentry

# for td-agent2
$ sudo td-agent-gem install fluent-plugin-sentry

Preparation

create sentry dashboard first. It could start with cost free!!

• Create an account at https://getsentry.com/pricing/

OR

• Launch Sentry at the self manager server with https://github.com/getsentry/sentry

Usage

<source>
 @type forward
</source>

<match notify.**>
  @type sentry

  # Set endpoint API URL
  endpoint_url       https://API_KEY:API_PASSWORD@app.getsentry.com/PROJECT_ID

  # Set default events value of 'server_name'
  # To set short hostname, set like below.
  hostname_command   hostname -s

  # rewrite shown tag name for Sentry dashboard
  remove_tag_prefix  notify.
</match>

Parameters

• endpoint_url (Required)
  Set endpoint API URL which shows at Sentry dashboard. (it is not sentry account information)

• default_level
  [default] error

• defalut_logger
  [default] flunetd

• hostname_command
  [default] hostname Set default frontend value of 'server_name'

• flush_interval
  [default] 0sec

It also support rewriting Tag with SetTagKeyMixin.

• remove_tag_prefix
• remove_tag_suffix
• add_tag_prefix
• add_tag_suffix

Blog Articles

TODO

Pull requests are very welcome!!

Copyright

Copyright © 2014- Kentaro Yoshida (@yoshi_ken)

License

Apache License, Version 2.0