fluent-plugin-raygun is a FluentD output plugin that sends aggregated errors/exception events to Raygun.
This plugin extends the fluent buffered output and reports the events as crash reports to your Raygun dashboard. Currently we support limited information in the reports sent by our plugin. The reports include the following information:
OccuredOn - The date & time in which the event was sent by the raygun plugin.
MachineName - The hostname provided through the plugin configuration.
ErrorMessage - The event's record message.
Tags - The tag used to seperate the event in the fluentd logging.
This plugin requires:
- Ruby v1.9.3 or higher
- FluentD v0.12 or v0.10
Once FluentD has been installed following the instructions detailed here.
Install the Raygun plugin using
fluent-gem install fluent-plugin-raygun
Update your FluentD config to include a matching rule to output to Raygun:
api_key - The key used to validate the reports sent to Raygun. Found in the Raygun dashboard under application settings.
default_level - The logging level at which to send events (options: fatal, error, warning, info or debug). The default is set to error.
default_logger - If a logger is not provided the default logger is used. The default is set to fluentd.
endpoint_url - The URL used by the raygun plugin to post reports to. The default is set to https://api.raygun.com.
flush_interval - The time between data flushes. The default is set to zero (0) seconds.
hostname_command - The name of the server reporting the error. The default is set to hostname.
record_already_formatted - If set to false we transform the event's record into the format required by raygun's API. The default is set to false.
Visit the fluent-plugin-raygun GitHub repository to view the code. Like all our providers, it is available under the MIT license.
Not satisfied with our provider? We are open to pull requests, so feel free to submit one for us to review!