Menu

HTTP Syslog Configuration

Your log data must not contain any personal data, such as names, email addresses, etc. It is your responsibility to ensure this data is filtered out before being sent to AppSignal, and when identifying a person is necessary that your application uses alternative forms of identification such as a user ID, hash, or pseudonym.

Endpoint

You can POST logs to AppSignal. Your logs must be formatted in Syslog and sent to the following endpoint:

shell
https://appsignal-endpoint.net/logs/syslog?api_key=YOUR_LOG_SOURCE_API_KEY

ReplaceYOUR_LOG_SOURCE_API_KEY with the key provided when creating a log source.

The Syslog lines should be separated by a newline character: \n. The log line should be sent in the syslog RFC 5424 (Request For Comment) format:

shell
<%pri%>%protocol-version% %timestamp:::date-rfc3339% %HOSTNAME% %app-name% %procid% %msgid% %msg%\n"
<14>1 2017-07-26T14:47:35.869952+05:30 my_hostname custom_appname 5678 some_unique_msgid - Some other message"

Structured messages

The message part of a syslog message can be formatted either in JSON, Logfmt or Plaintext.

Formatting the message in JSON or Logfmt allows you to add additional (structured) data attributes that can be used to find/filter messages on.

For more information about the specifics of message formatting, see our formatting documentation.