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. |
created_at | String | Time-stamp (GMT) when the endpoint was created. |
deleted_at | String | Time-stamp (GMT) when the endpoint was deleted. |
domain | String | The domain of the Amazon S3 endpoint. |
format | String | Apache style log formatting. |
format_version | Integer | The version of the custom logging format used for the configured endpoint. Can be either 2 (the default, version 2 log format) or 1 (the version 1 log format). 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 dumping logs (default 0, no compression). |
message_type | String | How the message should be formatted One of:. |
classic | (default) RFC 3164 syslog prefix. | |
loggly | RFC 5424 structured syslog. | |
logplex | Heroku-style length prefixed syslog. | |
blank | No prefix. Useful for writing JSON and CSV. | |
name | String | The name of the s3 rule. |
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, overriding any format_version default. Can be none or waf_debug. This field is not required and has no default value. |
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_kms_key_id | String | Optional server-side KMS Key Id. Must be set if server_side_encryption is set to aws:kms. |
server_side_encryption | String | Set this to AES256 or aws:kms to enable S3 Server Side Encryption. |
service_id | String | The alphanumeric string identifying a service. |
timestamp_format | String | strftime specified timestamp formatting (default "%Y-%m-%dT%H:%M:%S.000"). |
updated_at | String | Time-stamp (GMT) when the endpoint was deleted. |
version | Integer | The current version of a service. |
Endpoints
User contributed notes
We welcome comments that add use cases, ideas, tips, and caveats. All comments will be moderated before publication. To post support questions, visit our support center and we'll find you the help you need.