Fluentd output plugin for Logmatic.io.

Link to the Logmatic.io documentation

It mainly contains a proper JSON formatter and a socket handler that streams logs directly to Logmatic.io - so no need to use a log shipper if you don't wan't to.

To add the plugin to your fluentd agent, use the following command:

gem install fluent-plugin-logmatic

To match events and send them to logmatic.io, simply add the following code to your configuration file.

TCP example

# Match events tagged with "logmatic.**" and
# send them to Logmatic.io
<match logmatic.**>

  @type logmatic
  @id awesome_agent
  api_key <your_api_key>

  # Optional
  include_tag_key true
  tag_key 'tag'
  
</match>

HTTP example

# Match events tagged with "logmatic.**" and
# send them to Logmatic.io
<match logmatic.**>

  @type logmatic_http
  @id awesome_agent
  api_key <your_api_key>

  # Optional
  include_tag_key true
  tag_key 'tag'
  
</match>

After a restart of FluentD, any child events tagged with logmatic are shipped to your plateform.

Let's make a simple test.

echo '{"message":"hello Logmatic from fluentd"}' | fluent-cat logmatic.demo

Produces the following event:

{ 
    "custom": {
        "message": "hello Logmatic from fluentd"
     }
}

Let's go deeper on the plugin configuration.

As fluent-plugin-logmatic is an output_buffer, you can set all output_buffer properties like it's describe in the fluentd documentation.