applausearchives / heroku-fluentd-datadog

Heroku application to run fluentd and output to Datadog

heroku-fluentd-datadog

This is a Heroku application which contains everything to run fluentd on Heroku to accept logs from HTTPS drains using the in_heroku_http plugin to fluentd. The filter_record_transformer plugin is used to inject the source application's hostname, service name, and fluent tag into the record. The out_datadog plugin is used to stream the records to DataDog Logging.

This application uses the request PATH to specify the fluentd tag to use for routing. This matches the behavior of the in_http plugin. The value of the hostname attribute of the record can be set by specifying the desired value as the second (or more) part of the tag, using a . separator, with .herokuapp.com automatically appended to the value. To set the hostname to my-example-app.herokuapp.com and route to DataDog, you would send requests to /datadog.my-example-app of this application.

Setup

Check out this repository and create a Heroku application from it.

# Login to Heroku, then create
$ heroku apps:create YOUR-LOGGING-APP-NAME

# Next, configure your API key
$ heroku config:set DD_API_KEY=YOUR-DATADOG-API-KEY -a YOUR-LOGGING-APP-NAME

# Push your application
$ git push heroku master

Next, you configure Heroku HTTPS log drains to publish logs to this application.

$ heroku drains:add https://YOUR-LOGGING-APP-NAME/datadog.YOUR-SOURCE-APP-NAME -a YOUR-SOURCE-APP-NAME

Logs should now be flowing from your service to DataDog.

Testing

This application supports sending incoming events to STDOUT using a debug tag prefix.

# debug using curl
$ curl "https://YOUR-LOGGING-APP-NAME/debug.YOUR-SOURCE-APP-NAME" -d "60 <13>1 2014-01-29T06:25:52.589365+00:00 host app web.1 - foo"

This should show up in the logging application's logs on Heroku.