Syslog

Fastly will stream log messages to the location in the format specified in the Syslog object.

Data model

addressStringA hostname or IPv4 address.
created_atStringTime-stamp (GMT) when the endpoint was created.
deleted_atStringTime-stamp (GMT) when the endpoint was deleted.
formatStringApache style log formatting.
format_versionIntegerThe 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.
hostnameStringThe hostname used for the syslog endpoint.
ipv4StringThe IPv4 address used for the syslog endpoint.
message_typeStringHow the message should be formatted One of:.
classic(default) RFC 3164 syslog prefix.
logglyRFC 5424 structured syslog.
logplexHeroku-style length prefixed syslog.
blankNo prefix. Useful for writing JSON and CSV.
nameStringThe name of the syslog rule.
placementStringWhere 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.
portIntegerThe port number.
response_conditionStringThe name of an existing condition in the configured endpoint, or leave blank to always execute.
service_idStringThe alphanumeric string identifying a service.
tls_ca_certStringA secure certificate to authenticate the server with. Must be in PEM format.
tls_client_certStringThe client certificate used to make authenticated requests. Must be in PEM format.
tls_client_keyStringThe client private key used to make authenticated requests. Must be in PEM format.
tls_hostnameStringUsed during the TLS handshake to validate the certificate.
tokenStringWhether to prepend each message with a specific token.
updated_atStringTime-stamp (GMT) when the endpoint was updated.
use_tlsStringWhether to use TLS for secure logging. Can be either "0" or "1".
versionIntegerThe current version of a service.

Endpoints

List Syslog log endpoints

GET/service/service_id/version/version/logging/syslog

Get a syslog log endpoint

GET/service/service_id/version/version/logging/syslog/name

Create a syslog log endpoint

POST/service/service_id/version/version/logging/syslog

Update a syslog log endpoint

PUT/service/service_id/version/version/logging/syslog/old_name

Delete a syslog log endpoint

DELETE/service/service_id/version/version/logging/syslog/name

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.