S3
Fastly will upload log messages to the S3 bucket in the format specified in the S3 object.
Data model
access_key | string | The access key for your S3 account. Not required if iam_role is provided. |
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. |
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. |
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. |
iam_role | string | The Amazon Resource Name (ARN) for the IAM role granting Fastly access to S3. Not required if access_key and secret_key are provided. |
message_type | string | How the message should be formatted. |
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). |
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. |
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 | The secret key for your S3 account. Not required if iam_role is provided. |
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. |
timestamp_format | string | Date and time in ISO 8601 format. |
created_at | string | Date and time in ISO 8601 format. |
deleted_at | string | Date and time in ISO 8601 format. |
service_id | string | Alphanumeric string identifying the service. |
updated_at | string | Date and time in ISO 8601 format. |
version | integer | Integer identifying a service version. |