On this page

Check the logfile

Every Mugnsoft component writes structured log files with rotation. Understanding how to read them is the first step in troubleshooting any issue.

Log File Locations

Each component stores logs in its log/ subdirectory:

Component Log Directory
Webserver <webserver_install>/log/
Monitor <monitor_install>/log/
Integrator <integrator_install>/log/
Sentinel Agent <discovery_agent_install>/log/

Log Levels

All components support these log levels (from most to least verbose):

Level Description When to Use
debug Detailed execution flow, variable values Diagnosing specific issues
info Normal operational events (startup, scheduled tasks) Default for production
warn Non-critical issues that may need attention Monitoring for problems
error Errors that affect functionality Investigating failures

Changing the Log Level

Via the Web UI: Go to Settings and change the log level for any component.

Via the API: 


curl -k -X POST https://<component>:<port>/updateSetting \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"logLevel": "debug"}'

Tip: Set the log level to debug temporarily when troubleshooting, then restore to info to avoid excessive disk usage.

Log Rotation

Logs are rotated automatically using these configurable settings:

Setting Default Description
maxSize 10 MB Maximum size of a single log file before rotation
maxBackups 5 Number of rotated log files to keep
maxAge 28 days Maximum age of rotated log files
logCompress true Compress rotated log files (gzip)

Reading Log Files

From the Web UI

  1. Navigate to the component in the Components view
  2. Click the Live View button to see real-time logs
  3. Click Download Logfile to download the full log file

From the API


# Stream the last N bytes of the server log
curl -k -X GET https://<component>:<port>/partServerlogfile/10000 \
  -H "Authorization: Bearer <token>"

From the Command Line

On the server where the component is installed:


# Linux - follow the log in real time
tail -f <install_dir>/log/*.log

# Windows - view the latest log
Get-Content <install_dir>\log\*.log -Tail 100

Common Log Patterns

Successful Startup

INFO  Service 'Mugnsoft...' started.
INFO  Installation directory: /opt/mugnsoft/monitor
INFO  API server listening on :8051

Authentication Failure

ERROR Authenticator - failed authentication for user: admin

Component Communication Error

ERROR Failed to reach the webserver endpoint (192.168.1.100:8050)
ERROR selfRegister - Could not reach the webserver

Certificate Issues

ERROR tls: failed to verify certificate
ERROR x509: certificate signed by unknown authority

License Error

FATAL ==> stopping the service/daemon since license is not valid

See also

Translations

Authentication