SumoLogic

SumoLogic output plugin for Fluentd

Overview

This plugin has been designed to output logs or metrics to SumoLogic via a HTTP collector endpoint More info at https://github.com/SumoLogic/fluentd-output-sumologic

Example secret for HTTP input URL

export URL='https://endpoint1.collection.eu.sumologic.com/receiver/v1/http/.......'
kubectl create secret generic sumo-output --from-literal "endpoint=$URL"

Example ClusterOutput

apiVersion: logging.banzaicloud.io/v1beta1
kind: ClusterOutput
metadata:
  name: sumo-output
spec:
  sumologic:
    buffer:
      flush_interval: 10s
      flush_mode: interval
    compress: true
    endpoint:
      valueFrom:
        secretKeyRef:
          key: endpoint
          name: sumo-output
    source_name: test1

Configuration

Output Config

data_type (string, optional)

The type of data that will be sent to Sumo Logic, either logs or metrics

Default: logs

endpoint (*secret.Secret, required)

SumoLogic HTTP Collector URL

Default: -

verify_ssl (bool, optional)

Verify ssl certificate.

Default: true

metric_data_format (string, optional)

The format of metrics you will be sending, either graphite or carbon2 or prometheus

Default: graphite

log_format (string, optional)

Format to post logs into Sumo.

Default: json

log_key (string, optional)

Used to specify the key when merging json or sending logs in text format

Default: message

source_category (string, optional)

Set _sourceCategory metadata field within SumoLogic

Default: nil

source_name (string, required)

Set _sourceName metadata field within SumoLogic - overrides source_name_key (default is nil)

Default: -

source_name_key (string, optional)

Set as source::path_key’s value so that the source_name can be extracted from Fluentd’s buffer

Default: source_name

source_host (string, optional)

Set _sourceHost metadata field within SumoLogic

Default: nil

open_timeout (int, optional)

Set timeout seconds to wait until connection is opened.

Default: 60

add_timestamp (bool, optional)

Add timestamp (or timestamp_key) field to logs before sending to sumologic

Default: true

timestamp_key (string, optional)

Field name when add_timestamp is on

Default: timestamp

proxy_uri (string, optional)

Add the uri of the proxy environment if present.

Default: -

disable_cookies (bool, optional)

Option to disable cookies on the HTTP Client.

Default: false

delimiter (string, optional)

Delimiter

Default: .

custom_fields ([]string, optional)

Comma-separated key=value list of fields to apply to every log. more information

Default: -

sumo_client (string, optional)

Name of sumo client which is send as X-Sumo-Client header

Default: fluentd-output

compress (*bool, optional)

Compress payload

Default: false

compress_encoding (string, optional)

Encoding method of compression (either gzip or deflate)

Default: gzip

custom_dimensions (string, optional)

Dimensions string (eg “cluster=payment, service=credit_card”) which is going to be added to every metric record.

Default: -

buffer (*Buffer, optional)

Buffer

Default: -

slow_flush_log_threshold (string, optional)

The threshold for chunk flush performance check. Parameter type is float, not time, default: 20.0 (seconds) If chunk flush takes longer time than this threshold, fluentd logs warning message and increases metric fluentd_output_status_slow_flush_count.

Default: -