In my previous post I introduced the OMS Agent for Linux. This time I would like to give you some troubleshooting starting points. There are countless possibilities for errors to occur, so it is nice to have at least a consolidated list where to find a log or configuration file. This should give you a pretty good overview of the most important places to look for. For detailed configuration scenarios read the documentation on GitHub .
Log file paths:
In general the logs for the OMS Agent for Linux can be found at:
/var/opt/microsoft/omsagent/log/
The logs for the omsconfig (agent configuration) program can be found at:
/var/opt/microsoft/omsconfig/log/
Logs for the OMI and SCX components (which provide performance metrics data) can be found at:
/var/opt/omi/log/ and /var/opt/microsoft/scx/log
Logs for the DSC setting can be found at:
/opt/microsoft/omsconfig/Scripts/
Specific log files:
The log files for omsagent (fluentd) can be found here:
/var/opt/microsoft/omsagent/log/omsagent.log
The log files for onboarding & certificates:
/var/opt/microsoft/omsagent/bin/omsadmin.log
The log files about DSC feature omsconfig (DSC):
var/opt/microsoft/omsconfig/omsconfig.log
var/opt/omi/log/omiserver.log
The log files for perf counters issues:
/var/opt/microsoft/scx/log/scx.log
/var/opt/omi/log/omiserver.log
Specific OMS agent tests:
Operating system namespace probe on OMI agent:
/opt/microsoft/scx/bin/tools/omicli ei root/scx SCX_OperatingSystem
Agent namespace probe on OMI agent:
/opt/microsoft/scx/bin/tools/omicli ei root/scx SCX_Agent
If you want to display the desired configuration:
sudo su omsagent –c /opt/microsoft/omsconfig/Scripts/GetDscConfiguration.py
If you want to test desired configuration:
sudo su omsagent –c /opt/microsoft/omsconfig/Scripts/TestDscConfiguration.py
Configuration files:
If you want to configure the Syslog collection edit one of these files, depending on your distribution:
/etc/rsyslog.d/rsyslog-oms.conf
/etc/syslog.conf
/etc/rsyslog.conf
/etc/syslog-ng/syslog-ng.conf (SLES)
If you want to configure general agent settings:
/etc/opt/microsoft/omsagent/conf/omsadmin.conf
If you want to configure performance counter, alert settings for Zabbix, Nagios and Container data:
/etc/opt/microsoft/omsagent/conf/omsagent.conf
If you want to configure omiserver:
/etc/opt/omi/conf/omiserver.conf
If you want to configure omicli:
/etc/opt/omi/conf/omicli.conf
General problems & solutions:
(Source: Microsoft)
Some more OMI specific troubleshooting steps you can find here http://social.technet.microsoft.com/wiki/contents/articles/19527.scom-2012-r2-manually-installing-and-troubleshooting-linuxunix-agents.aspx