Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

div
styleclear:both;
SettingDescription

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

Do not report more than N volumes, where N = maxNumberVolumes.

Default = 5

Warning

Changing this setting can affect the resource consumption of your deployment. Before you increase this setting, verify that your application environment and Controller can handle the increased resource requirements.


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 blacklist and whitelist regexes, metrics for that network are reported (the whitelist 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

Do not report more than N networks, where N = maxNumberNetworks.

Default = 5

Warning

Changing this setting can affect the resource consumption of your deployment. Before you increase this setting, verify that your application environment and Controller can handle the increased resource requirements.


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 Standalone 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 whitelists.

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 blacklist and whitelist regexes, metrics for that network are reported (the whitelist 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 Standalone 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 blacklists.

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.

Here is an 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).

The following 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, it is good practice to
    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. It is good practice to 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, then verify that the matching process(es) appear in the Controller UI.

samplingInterval

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

Default = 60000 (60 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

Anchor
processSelectorRegex
processSelectorRegex
processSelectorRegex

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, this means that the process arguments could not be found and usually that is a kernel process.

For Windows, no processes should end with a bracket character, so consequently 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. This is useful for preventing the machine agent from being overloaded by monitoring short-lived processes. Units in milliseconds.

Default = 60000 (60 seconds)

maxNumberMonitoredClasses

Specifies the maximum number of process classes that the machine agent monitors.

The processes that are reported are the processes using the highest CPU and memory that match the regex specified by processSelectorRegex.

Default = 5020

Warning

Changing this setting can affect the resource consumption of your deployment. Before you change this setting verify your application environment and Controller can handle the increased resource requirements.

defaultDiskSectorSize

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

memoryMonitorConfig

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

tag
A list of user-defined tags for the individual server. You can use these tags to query, filter, aggregate, and compare related servers. See Server Tagging.
Each tag is specified by a key-value pair. You can define tag names up to 127 unicode characters and tag values up to 255 unicode characters. Define each each key on a separate line. All key/value strings should be within single quotes. If a key has multiple values, delineate the list with commas:
<key>: [ <value> ]  
tags:
    'Location': ['NYC', 'Data Center', 'Server Room 7']
    'Environment': ['preProduction']

...