Setup

Configure Fluentd

You’ll need: Ruby and ruby-dev 2.1 or higher,

  1. Install Fluentd and the Logz.io plugin

    gem install fluentd fluent-plugin-logzio
    
  2. Set up Fluentd

    fluentd --setup ./fluent
    
  3. Configure Fluentd with Logz.io output

    Add this code block to your Fluent configuration file (fluent.conf by default).

    See the configuration parameters below the code block.👇

    <match **>
      @type logzio_buffered
      endpoint_url https://<<LISTENER-HOST>>:8071?token=<<SHIPPING-TOKEN>>&type=my_type
      output_include_time true
      output_include_tags true
      http_idle_timeout 10
      <buffer>
          @type memory
          flush_thread_count 4
          flush_interval 3s
          chunk_limit_size 16m
          queue_limit_length 4096
      </buffer>
    </match>
    

    Parameters

    endpoint_url
    Your Logz.io region’s listener URL, account token, and log type.
    Replace <<LISTENER-HOST>> with your region’s listener host (for example, listener.logz.io). For more information on finding your account’s region, see Account region.
    Replace <<SHIPPING-TOKEN>> with the token of the account you want to ship to.
    output_include_time
    To add a timestamp to your logs when they’re processed, true (recommended). Otherwise, false.
    output_include_tags
    To add the fluentd tag to logs, true. Otherwise, false. If true, use in combination with output_tags_fieldname.
    output_tags_fieldname fluentd_tag
    If output_include_tags is true, sets output tag’s field name.
    http_idle_timeout
    Time, in seconds, that the HTTP connection will stay open without traffic before timing out.
  4. Run Fluentd

    fluentd -c ./fluent/fluent.conf -vv
    
  5. Check Logz.io for your logs

    Give your logs some time to get from your system to ours, and then open Kibana.

    If you still don’t see your logs, see log shipping troubleshooting.