Assure1 Metric Service-Level Management (SLM) Collector¶
Overview¶
The Assure1 Metric Service-Level Management (SLM) Collector leverages Service Hierarchies with weights to generate SLM availability metrics. To that end, it allows administrators to create and manage metric-based services and their relationships with thresholds.
Service-Level Management (SLM) Collector Setup¶
-
Navigate to the SLM "Service Management" UI and define a service hierarchy:
Configuration -> Service Management
An additional example of creating a SLM service is available via the documentation:
-
Enable the default Service, unless a specific configuration option is needed.
Default Service¶
| Field | Value |
|---|---|
| Package Name | coreProcessing-app |
| Service Name | Metric SLM Collector |
| Service Program | bin/core/processing/MetricSLMEngined |
| Service Arguments | |
| Service Description | Metric SLM Collector |
| Failover Type | Standalone (Supported: Standalone, Primary/Backup) |
| Status | Disabled |
| Privileged | (Unchecked) |
Default Configuration¶
| Name | Value | Possible Values | Notes |
|---|---|---|---|
| CheckTime | 900 | Integer | This entry is used to check the service hierarchy for changes the specified number of seconds. |
| LogFile | logs/MetricSLMCollector.log | Text, 255 characters | Relative path to Log File. |
| LogLevel | ERROR | OFF, FATAL, ERROR, WARN, INFO, DEBUG | Logging level used by application. |
| PollTime | 60 | Integer | How often will look for services to analyze in seconds (independant of the SLM service polltime). |
| Threads | 3 | Integer | The number of processing threads created. |
| DBThreads | Integer | Optional - Number of database threads to be created. If not specified, defaults to a third (rounded up) of "Threads" application configuration. | |
| PreferIPv4 | Disabled | Enabled/Disabled | Optional - Controls whether or not to prefer IPv4 transport for Devices. This option is only considered if both IPv4 and IPv6 are available for a device. If this config is missing, IPv6 will be preferred. |
Supported Notification Tokens¶
| Keyword | Template Type(s) | Template Field(s) | Description |
|---|---|---|---|
$TYPE |
Email, Syslog, Trap | Email{Subject, Body}, Syslog, Varbind (#) Value | Value type: Availability, Utilization, or Value |
$DATE_TEXT |
Email, Syslog, Trap | Email{Subject, Body}, Syslog, Varbind (#) Value | Long date |
$DATE_EPOCH |
Email, Syslog, Trap | Email{Subject, Body}, Syslog, Varbind (#) Value | UTC epoch |
$POLLER |
Email, Syslog, Trap | Email{Subject, Body}, Syslog, Varbind (#) Value | Name of SLM Collector engine: 'SLMCollector' |
$MESSAGE |
Email, Syslog, Trap | Email{Subject, Body}, Syslog, Varbind (#) Value | Threshold message |
$SAMPLERATE |
Email, Syslog, Trap | Email{Subject, Body}, Syslog, Varbind (#) Value | Threshold sample rate: 1 |
$COMPARE |
Email, Syslog, Trap | Email{Subject, Body}, Syslog, Varbind (#) Value | Threshold value |
$VALUE |
Email, Syslog, Trap | Email{Subject, Body}, Syslog, Varbind (#) Value | Calculated value |
$UTIL |
Email, Syslog, Trap | Email{Subject, Body}, Syslog, Varbind (#) Value | Calculated utilization (for services it is the same as $VALUE) |
$STATUS |
Email, Syslog, Trap | Email{Subject, Body}, Syslog, Varbind (#) Value | Calculated metric Status (Availability) (for services it is the same as $VALUE) |
$METRICID |
Email, Syslog, Trap | Email{Subject, Body}, Syslog, Varbind (#) Value | Metric ID of the threshold metric |
$DEVICENAME |
Email, Syslog, Trap | Email{Subject, Body}, Syslog, Varbind (#) Value | Name of device using the first of the following device fields if populated: Custom Name, DNS, SNMP Sysname, or IP. |
$DNS |
Email, Syslog, Trap | Email{Subject, Body}, Syslog, Varbind (#) Value | DNSName of device that has the threshold assigned (for services it is the server running SLM Collector) |
$IP |
Email, Syslog, Trap | Email{Subject, Body}, Syslog, Varbind (#) Value | IP (either IPv4 or IPv6) of device that has the threshold assigned (for services it is the server running SLM Collector), if any. If device has both IPv4 and IPv6 information this will be IPv6 unless PreferIPv4 is enabled. |
$INSTANCE |
Email, Syslog, Trap | Email{Subject, Body}, Syslog, Varbind (#) Value | Metric Instance name of the threshold metric |
$STATE |
Email, Syslog, Trap | Email{Subject, Body}, Syslog, Varbind (#) Value | State of threshold: ACTIVE or CLEAR |
Administration Details¶
The following list shows the technical details needed for advanced administration of the application:
-
Package - coreProcessing-app
-
Synopsis -
./MetricSLMEngined [OPTIONS] -
Options:
-c, --AppConfigID N Application Config ID (Service, Job, or Request ID) -?, -h, --Help Print usage and exit -
Threaded - Multi-Threaded