Scollector will monitor any Linux processes specified in the configuration file.
Command is a partial text match (older versions) or regular expression (as of 0.5.0-rc1) against the full path of all executing programs. You can use just the executable or include part of the path like “/bin/java”. This will not match against arguments except when the cmdline is rewritten by the program (See below).
Name is the value that will be used in the name tag of the
os.proc.* metrics that are created. If Name is not specified then a sanitized version of the command text will be used as the name tag value.
Args is a optional regular expression (case sensitive by default) used to select a specific instance of a program. If multiple processes match the given Command and Args they will be assigned incrementing id tag values starting at 1.
IncludeCount is a optional boolean (default is false) to enable the
linux.proc.count metric as a count of matched processes on each system. This can be used to create alerts when count = 0 or count > 1.
When setting up process monitoring you can use
ps -ef to see a list of running processes and their arguments. Some processes change the command stored in /proc/pid/cmdline to be more user friendly, but scollector is looking for NUL delimited arguments so this can cause issues. For instance, to monitor a redis process you must look at the raw value of the cmdline and set the Command to match since the arguments are delimited by 0x20 spaces instead of 0x00 NUL bytes:
Scollector uses the D-Bus API to determine the state of services managed by systemd and specified in the configuration file.
Name is a regular expression that matches against the service unit names. If the Name matches then it will be monitored under the
WatchProc is an optional boolean (default is false) to specify if the primary process for the service should be included as a monitored linux process under
os.proc.*. This may not work for processes that fork, use init scripts, or launch multiple sub processes.
Scollector will monitor any Windows processes or services specified in the configuration file.
Name is a regular expression (case sensitive by default) that matches against the Name property of the service or process WMI classes. Use
gwmi Win32_Service and
gwmi Win32_Process in PowerShell to see a list of possible values. If the Name matches a Win32_Service name then that process will be monitored under the
os.service.* metrics. If the name matches a process or a service (with ProcessId != 0) that process will be monitored under the
os.proc.* metrics. If there is more than one matching process they will be assigned incrementing id tag values starting at 1.
Note: IIS worker pool processes are automatically monitored using iis_pool-name as the name tag value. These will also have additional metrics under
Scollector can also monitor any Windows processes using the .NET framework. If no ProcessDotNet settings are specified it will default to just monitoring the w3wp worker processes for IIS. You can specify which applications to monitor in the configuration file.
Name is a regular expression (case sensitive by default) that matches against the Name property of the .NET Performance counters. Matching process will be monitored under the
dotnet.* metrics, and if there is more than one matching process they will be assigned incrementing id tag values starting at 1. Where possible the w3wp names will be changed to match the iis_pool-names used for process monitoring.