awslogs-sd 0.5

general

Following option is required:

• state_file: path to daemon database. Must be in persistent storage.

Example:

[general]
state_file = /var/lib/awslogs-sd/state

include

Optional section with a single option:

• path: an Unix glob pattern to specify locations of additional configuration files to load and merge with main one. Used mostly to support popular conf.d drop-in pattern.

Example:

[include]
path = /etc/awslogs-sd.conf.d/*.conf

Unit sections

Example:

[httpd_error]
unit = httpd.service
priority = ERR
syslog_ident = httpd_error
syslog_facility = local1
log_group_name = httpd-access
log_stream_name = {instance_id}

Following options are supported:

• unit (required): systemd unit name

• log_group_name (required): destination CloudWatch log group

• log_stream_name (required): CloudWatch stream name inside group; support basic variable interpolation (see below)

• priority: minimum journal priority to match (default: INFO). See Arch wiki.

• format: output log format, one of text or json (default: text)

• datetime_format: datetime format in strftime format if text output is used (default: %b %d %H:%M:%S)

• syslog_ident: match by syslog ident (aka “tag”) if syslog transport is used

• syslog_facility: match by syslog facility if syslog transport is used

Stream name variables

Stream names support variable interpolation with {var} syntax. Following variables are available:

• instance_id: local EC2 instance id

• hostname: machine hostname