MetricSLMEngined

The Oracle Communications Unified Assurance 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.

You can run this application as a service using the Services UI.

Metric Service-Level Management (SLM) Collector Setup

  1. 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:

    SLM Service Example

  2. Enable the default Service, unless a specific configuration option is needed.

    Configuration -> Broker Control -> Services

Default Service

The following table shows the settings for the default service. Actual values are in bold, descriptions of values are in plaintext.

Field Value
Package coreProcessing-app
Name Metric SLM Collector
Program bin/core/processing/MetricSLMEngined
Arguments This field is blank. There is no default value.
Description Metric SLM Collector
Failover Type Standalone (Supported: Standalone, Primary, Redundant/Backup)
Status Disabled
Privileged This option is not selected.

See Services in Unified Assurance User's Guide for general information about the settings for services.

See Using Application Primary/Backup Failover for more information about the different failover types.

Default Configuration

The following table shows the default configurations for the application. Actual values are in bold, descriptions of values are in plaintext.

Name Default Value Possible Values Notes
CheckTime 900 An integer This entry is used to check the service hierarchy for changes the specified number of seconds.
LogFile logs/MetricSLMCollector.log Text, 255 characters The relative path to the log file.
LogLevel ERROR OFF, FATAL, ERROR, WARN, INFO, DEBUG The logging level for the application.
PollTime 60 An integer How often will look for services to analyze in seconds (independant of the SLM service polltime).
Threads 3 An integer The number of processing threads created.
DBThreads This field is blank. There is no default value. An 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 or 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 you will need for advanced administration of the application: