S3
Fastly will upload log messages to the S3 bucket in the format specified in the S3 object.
Data model
access_key | string | Your S3 account access key. |
acl | string | The access control list (ACL) specific request header. See the AWS documentation for Access Control List (ACL) Specific Request Headers for more information. |
bucket_name | string | The bucket name for S3 account. |
compression_codec | string | The codec used for compression of your logs. Valid values are zstd , snappy , and gzip . If the specified codec is "gzip", gzip_level will default to 3. To specify a different level, leave compression_codec blank and explicitly set the level using gzip_level . Specifying both compression_codec and gzip_level in the same API request will result in an error. |
created_at | string | Date and time in ISO 8601 format. |
deleted_at | string | Date and time in ISO 8601 format. |
domain | string | The domain of the Amazon S3 endpoint. |
format | string | A Fastly log format string. |
format_version | integer | The version of the custom logging format used for the configured endpoint. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1 . |
1 | Version 1 log format. | |
2 | Version 2 log format. | |
gzip_level | integer | What level of gzip encoding to have when sending logs (default 0 , no compression). If an explicit non-zero value is set, then compression_codec will default to "gzip." Specifying both compression_codec and gzip_level in the same API request will result in an error. |
message_type | string | How the message should be formatted. |
blank | No prefix. Useful for writing JSON and CSV. | |
classic | (default) RFC 3164 syslog prefix. | |
loggly | RFC 5424 structured syslog. | |
logplex | Heroku-style length prefixed syslog. | |
name | string | The name for the real-time logging configuration. |
path | string | The path to upload logs to. |
period | integer | How frequently log files are finalized so they can be available for reading (in seconds, default 3600 ). |
placement | string | Where in the generated VCL the logging call should be placed. If not set, endpoints with format_version of 2 are placed in vcl_log and those with format_version of 1 are placed in vcl_deliver . |
none | Do not render a log statement into VCL. Use this option if you intend to write a log statement manually. | |
waf_debug | Put the log statement in the waf_debug_log subroutine, which allows for logging of WAF-specific variables. | |
public_key | string | A PGP public key that Fastly will use to encrypt your log files before writing them to disk. |
redundancy | string | The S3 redundancy level. |
response_condition | string | The name of an existing condition in the configured endpoint, or leave blank to always execute. |
secret_key | string | Your S3 account secret key. |
server_side_encryption | string | Set this to AES256 or aws:kms to enable S3 Server Side Encryption. |
server_side_encryption_kms_key_id | string | Optional server-side KMS Key Id. Must be set if server_side_encryption is set to aws:kms or AES256 . |
service_id | string | Alphanumeric string identifying the service. |
timestamp_format | string | Date and time in ISO 8601 format. |
updated_at | string | Date and time in ISO 8601 format. |
version | integer | Integer identifying a service version. |