Xibo Log Information

The CMS has a central repository for all Log information, including the Players which send back Log information with each collection from the CMS.

The Log is split into Channels, Functions and Pages for easy searching. Each unique request has a runNo to group messages together.

The Log page is located under the Advanced section of the Menu.

Fields

Field	Explanation
ID	A sequential ID of log messages
Run	The run identifier used to group messages generated by a single request
Date	The CMS date of the message
Channel	The Channel that the message relates to.
Function	The HTTP verb used in the request the generated the message, GET, POST, PUT, DELETE, HEAD.
Level	The severity of log message
Display	The display name, if the log message came from a Player
Page	The page requested - usually the route
Message	The log message

Channels

Channel	Explanation
WEB	The CMS Web Portal
API	The CMS API
XMDS	The CMS/Player API (Media Distribution)
AUTH	The oauth authorization server for the API
CONSOLE	XTR task running

Finding your message

Understanding the log can be complicated in a busy system and it can often be hard to find messages related to your interest. The log can be filtered for this purpose, it is usually best to start with the Channel, then the Function and finally (if necessary) the Page.

Tip: For example, if an API call to the statistics search function is not working as expected the log can be searched for API, GET and /stats.

Log location

The default log location is the database which can be viewed from the CMS log page. It may be desirable to log to a different location, depending on your use case.

The CMS supports adding new log handlers that confirm to the PSR log handler format - we recommend Monolog. To add log handlers simply append to the $logHandlers array in settings.php.

For example to add a file log handler:

$logHandlers = [new \Monolog\Handler\StreamHandler(PROJECT_ROOT . '/log.txt')];