Splunk via Hec output plugin for Fluentd 🔗︎

Overview 🔗︎

More info at https://github.com/splunk/fluent-plugin-splunk-hec

Example output configurations 🔗︎

spec:
  SplunkHec:
    host: splunk.default.svc.cluster.local
    port: 8088
    protocol: http

Configuration 🔗︎

SplunkHecOutput 🔗︎

SplunkHecOutput sends your logs to Splunk via Hec 🔗︎

Variable Name Type Required Default Description
data_type string No event The type of data that will be sent to Sumo Logic, either event or metric
hec_host string Yes - You can specify SplunkHec host by this parameter.
hec_port int No 8088 The port number for the Hec token or the Hec load balancer.
protocol string No https This is the protocol to use for calling the Hec API. Available values are: http, https.
hec_token *secret.Secret Yes - Identifier for the Hec token.
Secret
metrics_from_event *bool No - When data_type is set to “metric”, the ingest API will treat every key-value pair in the input event as a metric name-value pair. Set metrics_from_event to false to disable this behavior and use metric_name_key and metric_value_key to define metrics. (Default:true)
metric_name_key string No true Field name that contains the metric name. This parameter only works in conjunction with the metrics_from_event parameter. When this prameter is set, the metrics_from_event parameter is automatically set to false.
metric_value_key string No - Field name that contains the metric value, this parameter is required when metric_name_key is configured.
coerce_to_utf8 *bool No true Indicates whether to allow non-UTF-8 characters in user logs. If set to true, any non-UTF-8 character is replaced by the string specified in non_utf8_replacement_string. If set to false, the Ingest API errors out any non-UTF-8 characters. .
non_utf8_replacement_string string No ' ' If coerce_to_utf8 is set to true, any non-UTF-8 character is replaced by the string you specify in this parameter. .
index string No - Identifier for the Splunk index to be used for indexing events. If this parameter is not set, the indexer is chosen by HEC. Cannot set both index and index_key parameters at the same time.
index_key string No - The field name that contains the Splunk index name. Cannot set both index and index_key parameters at the same time.
host string No - The host location for events. Cannot set both host and host_key parameters at the same time. (Default:hostname)
host_key string No - Key for the host location. Cannot set both host and host_key parameters at the same time.
source string No - The source field for events. If this parameter is not set, the source will be decided by HEC. Cannot set both source and source_key parameters at the same time.
source_key string No - Field name to contain source. Cannot set both source and source_key parameters at the same time.
sourcetype string No - The sourcetype field for events. When not set, the sourcetype is decided by HEC. Cannot set both source and source_key parameters at the same time.
sourcetype_key string No - Field name that contains the sourcetype. Cannot set both source and source_key parameters at the same time.
keep_keys bool No - By default, all the fields used by the *_key parameters are removed from the original input events. To change this behavior, set this parameter to true. This parameter is set to false by default. When set to true, all fields defined in index_key, host_key, source_key, sourcetype_key, metric_name_key, and metric_value_key are saved in the original event.
idle_timeout int No - If a connection has not been used for this number of seconds it will automatically be reset upon the next use to avoid attempting to send to a closed connection. nil means no timeout.
read_timeout int No - The amount of time allowed between reading two chunks from the socket.
open_timeout int No - The amount of time to wait for a connection to be opened.
client_cert string No - The path to a file containing a PEM-format CA certificate for this client.
client_key string No - The private key for this client.‘
ca_file string No - The path to a file containing a PEM-format CA certificate.
ca_path string No - The path to a directory containing CA certificates in PEM format.
ssl_ciphers string No - List of SSL ciphers allowed.
insecure_ssl *bool No false Indicates if insecure SSL connection is allowed
fields Fields No - In this case, parameters inside are used as indexed fields and removed from the original input events
format *Format No - Format
buffer *Buffer No - Buffer