Google Cloud Storage


Store logs in Google Cloud Storage. For details, see


    project: logging-example
    bucket: banzai-log-test
    path: logs/${tag}/%Y/%m/%d/



acl (string, optional)

Permission for the object in GCS: auth_read owner_full owner_read private project_private public_read

auto_create_bucket (bool, optional)

Create GCS bucket if it does not exists

Default: true

bucket (string, required)

Name of a GCS bucket

buffer (*Buffer, optional)


client_retries (int, optional)

Number of times to retry requests on server error

client_timeout (int, optional)

Default timeout to use in requests

credentials_json (*secret.Secret, optional)

GCS service account credentials in JSON format Secret

encryption_key (string, optional)

Customer-supplied, AES-256 encryption key

format (*Format, optional)


hex_random_length (int, optional)

Max length of %{hex_random} placeholder(4-16)

Default: 4

keyfile (string, optional)

Path of GCS service account credentials JSON file

object_key_format (string, optional)

Format of GCS object keys

Default: %{path}%{time_slice}_%{index}.%{file_extension}

object_metadata ([]ObjectMetadata, optional)

User provided web-safe keys and arbitrary string values that will returned with requests for the file as “x-goog-meta-” response headers. Object Metadata

overwrite (bool, optional)

Overwrite already existing path

Default: false

path (string, optional)

Path prefix of the files on GCS

project (string, required)

Project identifier for GCS

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.

storage_class (string, optional)

Storage class of the file: dra nearline coldline multi_regional regional standard

store_as (string, optional)

Archive format on GCS: gzip json text

Default: gzip

transcoding (bool, optional)

Enable the decompressive form of transcoding


key (string, required)


value (string, required)