Http

Http plugin for Fluentd

Overview

Sends logs to HTTP/HTTPS endpoints. More info at https://docs.fluentd.org/output/http.

Example output configurations

spec:
  http:
    endpoint: http://logserver.com:9000/api
    buffer:
      tags: "[]"
      flush_interval: 10s

Configuration

Output Config

endpoint (string, required)

Endpoint for HTTP request.

Default: -

http_method (string, optional)

Method for HTTP request. [post, put]

Default: post

proxy (string, optional)

Proxy for HTTP request.

Default: -

content_type (string, optional)

Content-Profile for HTTP request.

Default: -

json_array (bool, optional)

Using array format of JSON. This parameter is used and valid only for json format. When json_array as true, Content-Profile should be application/json and be able to use JSON data for the HTTP request body.

Default: false

format (*Format, optional)

Format

Default: -

headers (map[string]string, optional)

Additional headers for HTTP request.

Default: -

open_timeout (int, optional)

Connection open timeout in seconds.

Default: -

read_timeout (int, optional)

Read timeout in seconds.

Default: -

ssl_timeout (int, optional)

TLS timeout in seconds.

Default: -

tls_version (string, optional)

The default version of TLS transport. [TLSv1_1, TLSv1_2]

Default: TLSv1_2

tls_ciphers (string, optional)

The cipher configuration of TLS transport.

Default: ALL:!aNULL:!eNULL:!SSLv2

tls_ca_cert_path (*secret.Secret, optional)

The CA certificate path for TLS.

Default: -

tls_client_cert_path (*secret.Secret, optional)

The client certificate path for TLS.

Default: -

tls_private_key_path (*secret.Secret, optional)

The client private key path for TLS.

Default: -

tls_private_key_passphrase (*secret.Secret, optional)

The client private key passphrase for TLS.

Default: -

tls_verify_mode (string, optional)

The verify mode of TLS. [peer, none]

Default: peer

error_response_as_unrecoverable (*bool, optional)

Raise UnrecoverableError when the response code is non success, 1xx/3xx/4xx/5xx. If false, the plugin logs error message instead of raising UnrecoverableError.

Default: true

retryable_response_codes ([]int, optional)

List of retryable response codes. If the response code is included in this list, the plugin retries the buffer flush. Since Fluentd v2 the Status code 503 is going to be removed from default.

Default: [503]

auth (*HTTPAuth, optional)

HTTP auth

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: -

HTTP auth config

http_auth

username (*secret.Secret, required) {#http auth-config-username}

Username for basic authentication. Secret

Default: -

password (*secret.Secret, required) {#http auth-config-password}

Password for basic authentication. Secret

Default: -

Last modified December 27, 2023: Version number bumps (00b4afd)