Protocol Log

The Log service centralizes log information and provides a syslog-ish REST-interface for client applications. Three levels are available:

• Info
• Error
• Critical

The meaning and severity of these should be obvious. Note that Alice use syslog to handle all logging, and syslog truncates log messages with a size larger than 1K. Also pre- and postfixed whitespace is removed from the log message before it is written to syslog.

Log messages

POST /log/[info | error | critical]

With the object body: { "message" : <string> } will send an event with the message to the corresponding stream.

Success

An empty object is returned along with a success status.

Example response.

HTTP status: 200 OK

{}

Failure - malformed request object

If the message field is empty (or all whitespace) then the request is ignored and this error message is returned. The description may be more or less specific on what the actual error is.

Example response.

HTTP status: 400 Bad request

{
   "status"      : "bad request",
   "description" : "Invalid, missing or malformed parameters"
 }