Machine Agent Settings for Server Visibility

basicEnabled

Indicates whether the Machine Agent should report the basic metrics through the SIM extension. Set this to false to use Sigar to report basic metrics. This setting only affects monitoring on Linux.

Default = true

volumeMonitorConfig:

maxNumberVolumes

volumeMonitorConfig:

whitelistSelectorRegex

Volumes with names that match this regular expression are always reported, up to the maximum specified by maxNumberVolumes.

Default = ""

volumeMonitorConfig:

blacklistSelectorRegex

Volumes with names that match this regular expression are excluded. This setting is useful for filtering out irrelevant metrics.

If a volume name matches both the blocklist and allowlist regexes, metrics for that network are reported (the allowlist takes priority) up to the maximum specified by maxNumberVolumes.

The default ServerMonitoring.yml file does not include a blacklistSelectorRegex field for volumes. If you want to add one, use the same indentation and formatting as the volumeMonitorConfig:whitelistSelectorRegex field.

volumeMonitorConfig:

samplingInterval

Specifies a custom sampling interval for collecting volume metrics on Linux.

Default = 3000

networkMonitorConfig:

maxNumberNetworks

networkMonitorConfig:

whitelistSelectorRegex

Networks with names that match this regular expression are always reported, up to the maximum specified by maxNumberNetworks.

To report metrics for one or more virtual networks, specify a regex that matches the virtual network names.

When collecting Process metrics on Solaris, the Machine Agent observes and captures only the first 80 characters of each process name and argument list. This means that the Agent considers only the first 80 characters of each process string when it applies allowlists.

Default = ""

networkMonitorConfig:

blacklistSelectorRegex

Networks with names that match this regular expression are excluded. This setting is useful for filtering out irrelevant metrics.

If a network name matches both the blocklist and allowlist regexes, metrics for that network are reported (the allowlist takes priority) up to the maximum specified by maxNumberNetworks.

The default regex excludes virtual networks. To monitor a set of one or more virtual networks, edit whitelistSelectorRegex to include the networks of interest. To monitor all virtual networks, change the blacklistSelectorRegex to an empty string.

When collecting Process metrics on Solaris, the Machine Agent observes and captures only the first 80 characters of each process name and argument list. This means that the Agent considers only the first 80 characters of each process string when it applies blocklists.

Default = "^veth.*|^vnet.*"

 defaultProcessClassSelector

The default "class selector" based on a class_selector_regex. If this regex is defined, and a match is found in the process command line, the class name is the first group occurrence of that regex in the command line.

Default = ""

 processClassSelectorRegexList

A list of class_name:regex mappings. If the command line for a process matches regex, the metrics for that process are assigned to class_name. This setting is useful when you want to ensure that high-priority processes get reported, even if the number of defined classes is higher than the maxNumberMonitoredClasses setting.

For example:

processMonitorConfig:

processClassSelectorRegexList :

machineAgentTasks: '.*java.*machineagent.*'

controllerTasks: '.*java.*controller.*'

nextOne: '.*svchost.*'

The Machine Agent assigns a process to a class as follows:

1. Assign to the first match in processClassSelectorRegexList.
2. If there is no match for the processClassSelectorRegexList (step1), apply the defaultProcessClassSelector regex to the command line.
3. If there is no match for the defaultProcessClassSelector regex (step 2), use the process name (truncated if the name exceeds the maxClassIdLength).

These steps outline the recommended workflow for updating this list:

1. The default ServerMonitoring.yml file includes an example that is commented out. If you are updating the default list for the first time, you should:
   1. Create a copy of the example. 
   2. Uncomment the copy (remove the <!-- and --> comment tags), and edit it as needed.
2. Choose the process(es) that you want to monitor on the host machine.
3. Create a regex to match the process name(s) of interest. You should test the regex using an online regex validator.
4. Add the regex to the list. You should order the mappings by priority, highest to lowest. If a command line matches multiple regexes, the first match is used.
5. Save the ServerMonitoringConfiguration.yml file.
6. Wait 15 minutes or longer for the updated list to take effect, and then verify that the matching process(es) display in the Controller UI.

samplingInterval

Indicates how often to gather metric data. Units in milliseconds.

Default = 30000 (30 seconds)

maxClassIdLength

Specifies the maximum process class name length. Any process class name that is longer than the specified maximum is truncated. The global maximum of the process class name is 100. If this variable is set to be greater than 100, then the process name is truncated at 100.

Default = 50

Contains a regular expression that specifies which processes should be monitored by the Machine Agent. The regular expression is compared against the full command line that was used to start the process.

The default regular expression will filter out any processes where the command line ends with a close bracket (']').

For Linux, the process arguments could not be found, which usually indicates a kernel process.

For Windows, no processes should end with a bracket character, so the regex should include all processes on Windows.

Default = ""^.+[^]]$""

minLiveTimeMillisBeforeMonitoring

Specifies the minimum amount of time a process must be alive before it is monitored by the Machine Agent. Use this to prevent the Machine Agent from being overloaded by monitoring short-lived processes. Units in milliseconds.

Default = 60000 (60 seconds)

maxNumberMonitoredClasses

Specifies the default sector size (in bytes) for each disk if the Machine Agent cannot determine the sector size. This value is used to calculate the number of bytes read/written for the disk.

Default = 512

Specifies a custom sampling interval for collecting memory metrics on Linux.

Default = 3000

cpusMonitorConfig

Specifies a custom sampling interval for collecting CPU metrics on Linux.

Default = 3000