Skip to main content

Fluentd

You can configure the Fluentd integration to post data to Moogsoft when an alert occurs in Fluentd. The integration uses the Moogsoft Onprem plugin for Fluentd.

Refer to the LAM and Integration Reference to see the integration's default properties. When you use the integrations UI, you can only configure the visible properties.

If you want to implement a more complex Fluentd LAM with custom settings, see Configure the Fluentd LAM.

See the Fluentd documentation for details on Fluentd components.

Before You Begin

The Fluentd integration has been validated with Fluentd v0.12. Before you start to set up your integration, ensure you have met the following requirements:

  • You have installed Fluentd.

  • You have the permissions to edit the Fluentd configuration file.

  • You have installed Ruby Gems for Fluentd.

  • Fluentd can make requests to external endpoints over port 443. This is the default.

Configure the Fluentd Integration

To configure the Fluentd integration:

  1. Navigate to the Integrations tab.

  2. Click Fluentd in the Monitoring section.

  3. Provide a unique integration name. You can use the default name or customize the name according to your requirements.

  4. Set a Basic Authentication username and password.

Configure Fluentd

Install the Moogsoft Onprem plugin for Fluentd and add the configuration to your Fluentd configuration file. See fluent-plugin-moogaiops.

  1. To install the Moogsoft Onprem plugin for Fluentd, edit your application Gemfile to include the plugin:

    gem 'fluent-plugin-moogaiops'

    Alternatively, install the plugin yourself from the command line:

    $ gem install fluent-plugin-moogaiops
  2. Edit fluentd.conf and include the following configuration for the plugin:

    <match system.** *.access.* error.**>
      @type moogaiops
      uri https://<YOUR MOOGAIOPS>.moogsoft.com/events/generic_generic1
      auth <YOUR USER>:<YOUR PASSWORD>
      sourcetype fluentd
      location london
      severity 3
    </match>

    Field

    Value

    Request URL

    <your Fluentd integration URL>

    For example: https://example.Moogsoft.com/events/fluentd_fluentd1

    User

    Username generated in the Moogsoft Onprem UI

    Password

    Password generated in the Moogsoft Onprem UI

  3. Restart Fluentd.

The plugin forwards events that conform to the matcher in the Fluentd integration. The default Fluentd Cookbook shows all failed jobs that impact the same or overlapping hosts.