cbepx / fluent-plugin-sentry

Fluentd output plugin to aggregate errors/exception to sentry which are a realtime event logging and aggregation platform.

fluent-plugin-sentry

Overview

Fluentd output plugin to send aggregated errors/exception events to Sentry which are a realtime event logging and aggregation platform.

If you have sent events to Sentry directory from front webpage without aggregation, you may got down response time and performance problem especially in PHP.
To use Sentry and Fluentd together, it will got best performance because Fluentd acts messege queue for Sentry.

• Sentry Official web
• Sentry Documents Screenshots

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

Installation

install with gem or fluent-gem command as:

# for fluentd
$ gem install fluent-plugin-sentry

# for td-agent
$ sudo /usr/lib64/fluent/ruby/bin/fluent-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:[email protected]/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