By default, Papertrail log destinations accept logs from new senders and create the new sender name automatically (see How are senders named?). Adding a sender is as simple as configuring logging for a new machine or app.
In some cases, this relatively open default policy might not be the best fit, so Papertrail also provides more controlled options. Choose the balance between security and flexibility that best fits your environment.
For each log destination, disable auto-detection by unchecking Yes, recognize logs from new systems to make Papertrail silently drop messages sent from system names that don’t already exist.
To register new systems after auto-recognition is disabled, either enable auto-recognition long enough to send a single message, then disable auto-recognition again, or use papertrail-add-system (or the corresponding HTTP API call) to register the system(s).
For environments where integrity is critical or where hostnames are publicly known, Papertrail can match messages against a value other than the sender’s hostname, such as an assigned random string.
For example, here’s how to tell Papertrail that the sender named www42
will send with this random string as the syslog hostname:
$ papertrail-add-system --hostname C9M-0t3NxZ2XlpBS-y8upepeS1zNurT -s www42
Papertrail will show the system’s hostname, www42
, but its messages must contain the C9M...
string as the hostname. This string can be used with remote_syslog2
(example), rsyslog
(example), and most other senders.
Typically, the combination of the system hostname and the account-specific log destination is unique enough that using a separate random string as an identifier isn’t required.
Alternatively, on Add Systems, select My syslogd only uses the default port and then provide the IP of each sender.
Optionally, you may also wish to ensure that every sender has gone through the TCP three-way handshake. To do so, disable UDP logging on the log destination.
Log senders like rsyslog and remote_syslog2 typically set a sender identifier field in each syslog packet to the system hostname, though it can be set to other values (see Override the hostname sent by a logger).
Because Papertrail accepts inbound links that use the sender name, such
as https://papertrailapp.com/systems/www42
, the sender name must be
unique. When Papertrail receives a log message from a new sender and:
Papertrail will append a hyphen and sequence number (-1
) to the default
sender name shown in Papertrail. For example: www42-1
This display name in Papertrail can still be edited, but it ensures that administrators do not confuse the new sender with an existing sender.
If Automatically remove idle senders? is checked for a log destination, idle senders will be removed two days after their most recent log message is no longer searchable, or one week after they’ve stopped sending, whichever is longer.
If Automatically remove idle senders? (in Log Destination settings) is not checked for a given destination, you’ll need to manually remove any sender that’s no longer needed.
To remove a sender: