Log Analysis

Log Analysis

Every action in OpManager leaves a trace(s) in the log files. There are two logs folder in OpManager. One under the OpManager directory and the other under OpManager tomcat folder.


The logs folder under the OpManager directory contains various logs file mentioned below:

01. alert_audit.txt

02. applnerr.txt

03. ConfChange_AdventNet_ManageEngine_OpManager.log

04. ConfChangeErr_AdventNet_ManageEngine_OpManager.log

05. discoveryLogs.txt

06. disterr.txt

07. distout.txt

08. hyperverr.txt

09. mserr.txt

10. msout.txt

11. nmserr.txt

12. nmsout.txt

13. notificationLogs.txt

14. opmanager_IntfOut.txt

15. opmanager_serverOut.txt

16. rbaerr.txt

17. stderr.txt

18. stdout.txt

19. transactionLogs.txt

20. updatemanagerlog1.txt

21. wrapper.log

Every log file has a certain size limit and upon reaching the specified size, a new file is created and is appended with a file number at the end. For example, stderr1.txt, stderr2.txt etc.

Each group of these logs, records traces for specific actions or features in OpManager. As a standard, every log file has the Date & Time entry before the trace. We will look into each group of these logs now.

01. alert_audit.txt

As the name suggests, these log files record actions/events related to OpManager alarms. Every time an alarm in triggered in OpManager an entry is made in the alert_audit files.

As you can see, the Date & Time is recorded along with the Severity Change (i.e Attention from Clear, Trouble from Attention, etc), the Device Name and the Alarm message.

02. applnerr.txt

These logs contain CLI related traces.

03. ConfChange_AdventNet_ManageEngine_OpManager.log & 04. ConfChangeErr_AdventNet_ManageEngine_OpManager.log

These logs contain entries for actions occuring during an upgrade. So, if there are any upgrade related issues, these files can be used to debug the problem.

05. discoveryLogs.txt

Very evident from the file name, these logs contain records for Discovery related actions in OpManager. When you are faced with any device/interface addition issues, you can analyze these logs.

 06. disterr.txt & 07. distout.txt

These files contain Central-Probe communication related log traces.

08. hyperverr.txt

Again, like the file name suggests, these files contain log entries for HyperV related actions.

09. mserr.txt & 10. msout.txt

11. nmserr.txt & 12. nmsout.txt

OpManager is built on WebNMS framework. These files maintain framework related logs & errors.

13. notificationLogs.txt

These logs contain records for every notification (email, SMS etc) that is being triggered from OpManager.

14. opmanager_IntfOut.txt

15. opmanager_serverErr.txt & opmanager_serverOut.txt

These contain logs related to OpManager DB's table creation, backend queries for Reports generated in OpManager. Also, any traces for debugs enabled for troubleshooting purposes are also recorded here.

16. rbaerr.txt

These contain IT Automation/Workflow related logs.

17. stderr.txt

A standard log file referred the most in OpManager. This contains traces for most of the actions done in OpManager, though there are feature specific logs (like alert_audit, notificationLogs, hyperverr etc). When ever a feature does not work as expected, you are sure to find error traces in these logs that will help you debug the issue.

18. stdout.txt

These logs are mostly used to debug issues related to Reports. The SQL query is printed in these files for every report generated in OpManager.

19. transactionLogs.txt

Records Transaction log activities if the OpManager database is on MSSQL backend.

20. updatemanagerlog.txt

These logs contain entries for actions occuring during an upgrade like the ConfChange_AdventNet_ManageEngine_OpManager.log & ConfChangeErr_AdventNet_ManageEngine_OpManager.log. Combining these 3 logs, any upgrade related issue can be debug easily.

21. wrapper.log

This log is useful to debug OpManager start-up issues.


The logs folder under the OpManager\tomcat directory contains the below mentioned files:

1. catalina.XXX.log

2. localhost.XXX.log

3. localhost_access_log.XXX.

Unlike the previous set of the logs where the file number is appended at the end, here it is appended with the Date. For example, catalina.2012-07-09.log & localhost.2012-07-09.log

The Catalina & localhost files record logs when the OpManager UI redirects itself to an Error page or when any Action buttons (like Add Monitors, Test Credential etc) in the UI remains inactive.


Now, having got a brief idea on the files and their logging properties, lets look at some exceptions/error traces which can be found in the logs and the steps to troubleshoot/fix them.

1. stderr.txt

11:38:54:578 AM java.sql.SQLException: Table '.opmanagerdbpolleddata' is marked as crashed and should be repaired

11:38:54:578 AM  at com.mysql.jdbc.SQLError.createSQLException(SQLError.java:946)

11:38:54:578 AM  at com.mysql.jdbc.MysqlIO.checkErrorPacket(MysqlIO.java:2985)

11:38:54:578 AM  at com.mysql.jdbc.MysqlIO.sendCommand(MysqlIO.java:1631)

11:38:54:578 AM  at com.mysql.jdbc.MysqlIO.sqlQueryDirect(MysqlIO.java:1723)

11:38:54:578 AM  at com.mysql.jdbc.Connection.execSQL(Connection.java:3277)


In the above trace, you can clearly see the message that PolledData of the OpManagerDB has crashed. This issue can be resolved by doing a Database repair. To repair the database, execute RepairDB.batfound under OpManagerin folder. If this does not resolve the issue, follow the steps from the link : http://support.opmanager.com/sd/AddSolution.sd?solID=29701


06:29:18:796 AM com.adventnet.nms.store.NmsStorageException: The transaction log for database 'OpManager' is full. To find out why space in the log cannot be reused, see the log_reuse_wait_desc column in sys.databases

06:29:18:796 AM  at com.adventnet.management.transaction.ConnectionPool.executeUpdate(ConnectionPool.java:1798)

Here, the Transaction logs for the OpManager database is full. This issue will cause all the dials in OpManager to be greyed out and it will look like the data-collection has stopped.

You can follow the steps in the link to resolve this case:   http://support.opmanager.com/sd/AddSolution.sd?solID=24901


                    New to ADSelfService Plus?