I've created a host, but I can't find it in the hosts list¶
A newly created host will not automatically appear in the main host list. Instead, newly created hosts can be found in the host list under the
Not monitored tab. This means that the host exists in openITCOCKPIT, but is not yet known to the monitoring engine.
You will first need to export the configuration in order for the newly created host to be monitored.
Attention! Lost connection to SudoServer. External commands may not work. Please try to reload this page
Achtung! Verbindung zum SudoServer verloren. Externe Befehle funktionieren möglicherweise nicht. Bitte versuche diese Seite neu zu laden.
sudo_server.service is not running or the web interface has lost the connection.
Reload the web page. If the problem still exists, restart the sudo_server service.
systemctl restart sudo_server.service
If the problem persists, you can contact us for further assistance.
The interface information provides you with an overview of your openITCOCKPIT server. Information on the version and edition being used will also be displayed here. In addition, information on the monitoring engine being used as well as the paths to the configuration, backups and command interface are also provided here.
Administration -> System tools -> Debugging you will find the debugging (troubleshooting) overview. Using process information you can get an overview of the processes required for running openITCOCKPIT.
SQL Query Log¶
The SQL Query Log displays all SQL queries that are executed in the SQL database.
tip For SQL query logging to take place, the option
'log' => true must be set in the file
The server information contains various basic data about your openITCOCKPIT server. This includes information about the operating system, web server, basic PHP information and the CPU.
CPU load and RAM/hard disk utilisation of the openITCOCKPIT server¶
The openITCOCKPIT web interface offers an overview of the current CPU, RAM, SWAP and hard disk utilisation. This can be viewed on the debugging page.
You can get an overview of the current email configuration on the debugging page under "Email configuration".
An overview of the current overall PHP configuration can be found at the end of the debugging page.
The System Health display provides information about the overall status of the openITCOCKPIT system. See System Health display
Where can I find the various log files?¶
The log file for the Naemon monitoring engine can be found at
It is recommended to view the log file with the
oitc debug --tailf command, as this replaces the Unix timestamps and UUIDs, which significantly increases the readability of the log file.
openITCOCKPIT web frontend¶
Gearman Job Server¶
Refresh monitoring configuration is stucking¶
In case of an error with the openITCOCKPIT backend, it could happen that the refresh of the monitoring configuration is running forever. The refresh is done by a separate background worker. To resolve the issue please follow the steps described below. The current state of the refresh is stored in the openITCOCKPIT database, so rebooting the machine will not resolve the issue.
Stop the openITCOCKPIT
systemctl stop gearman_worker.service
Now execute the command
gearadmin --status, to verify that no pending Jobs are waiting in the
oitc_gearmanqueue. If there are no pending jobs, the output should look something like this:
oitc_gearman 0 0 0 # Pending jobs Actively running Available workers
If there are pending jobs, run the following command to truncate the queue. Repeat this until no more pending jobs are waiting in the queue.
gearman -w -c 1 -t 1000 -f oitc_gearman > /dev/null
Truncate the table
openitcockpitdatabase, to reset the current state of the refresh.
mysql --defaults-extra-file=/opt/openitc/etc/mysql/mysql.cnf -e "TRUNCATE TABLE openitcockpit.exports;"
systemctl start gearman_worker.service
Refresh is still crashing¶
Under some rare circumstances it could happen that the
gearman_worker is crashing due to an error within the code itself.
To print out any error messages, follow the steps 1 to 4 as described above. Instead of starting the
gearman_worker via systemd in the background,
start it in foreground mode and refresh the monitoring configuration via the openITCOCKPIT interface.
export OITC_DEBUG=1 oitc gearman_worker
Check the terminal for any errors.