Troubleshooting

This section explains how to view various log files, which may be useful when troubleshooting your installation of WebHosting Plesk.

All events related to WebHosting Plesk are recorded to log files on the Websites Manager node. The log files are kept in the /var/log/shm-dispatcher/ directory:

dispatcher.log - this is the main log file of the WebHosting Plesk application. All messages from other log files (doctrine.log, dispatcher_requests.log, and whp-api-requests.log) are recorded in this file as well.
doctrine.log - this is the log of requests sent to the Websites Manager's database.
dispatcher_requests.log - this is the log of requests coming to the Websites Manager node from the APS controller. The APS controller is an essential service of the cloud platform, which is responsible for the interaction of all its elements.
whp-api-requests.log - this is the log of API requests sent to Plesk nodes.

By default, the level of logging is set to INFO, which means that no debugging information is recorded in log files. There are the following levels of logging:

DEBUG (100): Detailed debugging information.
INFO (200): Interesting events. Examples: A user logs in, SQL logs.
NOTICE (250): Normal but significant events.
WARNING (300): Exceptional occurrences that are not errors. Examples: Use of deprecated APIs, poor use of an API, undesirable things that are not necessarily wrong.
ERROR (400): Run-time errors that do not require an immediate action but should typically be logged and monitored.
CRITICAL (500): Critical conditions. Example: An application component is unavailable, an unexpected exception occurs.
ALERT (550): An action must be taken immediately. Example: The entire website is down, a database is unavailable.
EMERGENCY (600): The system is unusable.

If you need to change the level of logging:

Open for editing the file /opt/shm-dispatcher/app/config/config_prod.yml.
Add the following lines after the section "monolog: handlers:" :
```
main:
    level:  debug
dispatcher_requests:
    level:  debug
whp_requests:
    level:  debug
apsc_requests:
    level:  debug
```
Note: Be sure to preserve the proper indentation in the file to comply with the YAML syntax.
If you do not want to use the debug level, use any of the following instead of "debug": notice, warning, error, critical, alert, or emergency. Save the file.
Clear the application's cache: /opt/parallels/shm-dispatcher/bin/console cache:clear