Thresholder and Profiler

1 © Nokia Siemens Networks v1.0 / 2008-08-30 / INo

For public use – IPR applies

Thresholder and Profiler

Application



Nokia Siemens Networks Academy

Legal notice

Intellectual Property Rights

All copyrights and intellectual property rights for Nokia Siemens Networks training documentation, product documentation and slide presentation material, all of which are forthwith known as Nokia Siemens Networks training material, are the exclusive property of Nokia Siemens Networks. Nokia Siemens Networks owns the rights to copying, modification, translation, adaptation or derivatives including any improvements or developments. Nokia Siemens Networks has the sole right to copy, distribute, amend, modify, develop, license, sublicense, sell, transfer and assign the Nokia Siemens Networks training material. Individuals can use the Nokia Siemens Networks training material for their own personal self-development only, those same individuals cannot subsequently pass on that same Intellectual Property to others without the prior written agreement of Nokia Siemens Networks. The Nokia Siemens Networks training material cannot be used outside of an agreed Nokia Siemens Networks training session for development of groups without the prior written agreement of Nokia Siemens Networks.



Document change history

Date Version Name Change comment

30/07/08 v1.0 Ina Noetzel First version

25/11/09 v1.1 Dirk Kilian Some additions (syntax of threshold formulas)



Using the Thresholder and Profiler

• Thresholder and Profiler Overview

• Main Terms and Concepts

• Typical Use Cases

• Step-by-Step example how to get PM data into SQM using the Thresholder&Profiler



Thresholder and Profiler Overview

• Thresholder and Profiler are NetAct applications that extend NetAct Reporter.

• They allow setting and managing thresholds or profiles for KPIs calculated in Reporter.

Measured values and KPIs often follow a

pattern. Profiler tracks this pattern and

provides a reliable approximation of the

typical value of the KPI based on a week’s

data

ProfilerThresholderThresholder compares KPI values with defined thresholds and sends notifications in case of a threshold violation.A threshold can be

also be defined as a deviation from a typical

KPI profile.

Profiler uses the output of the KPI value check done by

Thresholder to update profiles.

In case of profiled thresholds Thresholder uses the latest

profiles to determine if a threshold has been violated.



High-Level Architecture

• The Thresholder & Profiler accesses PM data from the Reporter Database (RC or GC)

• The Thresholder & Profiler uses KPI definitons from Report Builder

• Threshold definitions are stored as specific Report Builder reports with additional threshold and notification information

• Profiling information is stored in specific tables within the NetAct DB

• Threshold settings and notification methods may differ for different users

DB

(K)PIs

profile updates

alarm notification

email notificationSMS notification

NetAct cluster

Thresholder&

Profiler

xml n

otifica

tion

SQM Generic Data Collector



Typical Use Cases for Using the Thresholder & Profiler as a Data Collection Module for SQM

• Use cases based on profiled values for KPI:

• Profile Value Comparison for KPIs

• Profile Value Comparison with Significance Level for KPIs

• Use cases based on KPI processing

• Unconditional Problem Raising for KPI Events from T & P are processed and a problem is raised according to the expression defined in the T&P.

ThresholdThreshold

Report execution period (sample period)Report execution period (sample period)

KPI valueKPI value

threshold violationsthreshold violations

profile violationprofile violation



Thresholder and Profiler main terms and concepts (1/2)

• Measurement profile:• typical pattern of a measurement value. The profile for a KPI is based on

the measurement data available from the last weeks before the time stamp of the profile. By default profile is only initialized after 4 weeks.

• Threshold formula:• formula: defines when a threshold violation has taken place and what

severity this violation has. Formulas can use absolute values for thresholding and a number of functions:

• slope function: difference between two values of consecutive intervals• prof(ile) function: returns the typical pattern (measurement profile) of a value• var(iance) function: statistical variance • dev(iation) function: statistical deviation• abs(solute) function: absolute value • boolean expressions: and, not, or, true, false

• Threshold violation with single-/multispiking:• single spike mode: if the KPI violates the threshold once• multi spike mode (possible for absolute, slope, or profiled thresholds): if

the KPI violates the threshold at least N times, where N is the number of spikes in the spikes/time window formula



Thresholder and Profiler main terms and concepts (2/2)

• Thresholding interval:• Can be individually defined for each report in the Thresholder and Profiler

GUI. For each report a delay can be defined so that delayed values can be taken into account.

• Profiling interval:• Profiler is run by cron every 6 hours (by default). It uses the reporting

period when it evaluates the information received from Thresholder.

• Notifications:• information that a threshold has been violated, severity has changed or

that violation situation does not exist any more; can be sent as SMS, email, NetAct alarm, or SQM event (SQM events can also be sent continuously, regardless of threshold violations)



Threshold formulas (from NED)

Simple example: Simple example: ${KPI_NAME1} > 30 and ${KPI_NAME2} > 99${KPI_NAME1} > 30 and ${KPI_NAME2} > 99

NoteNote: Formulas may contain a references to the : Formulas may contain a references to the PI/KPI values defined in the scope of the PI/KPI values defined in the scope of the current report. References to the PI/KPI current report. References to the PI/KPI values have the following syntax: "$values have the following syntax: "${KPI_NAME}", where KPI_NAME is the {KPI_NAME}", where KPI_NAME is the name of the PI or KPI.name of the PI or KPI.



Threshold formulas (from NED)

For using profiles and slope formulas, a number of formulas are supported:For using profiles and slope formulas, a number of formulas are supported:

Sample Threshold formulas:Sample Threshold formulas:



Using the Thresholder & Profiler to get PM data into SQM step by step

In the following example we will use Thresholder and Profiler to monitor a KPI named Traffic_CS_Total. For this KPI we will initialize a profile, so that in future the typical KPI value can be compared to the latest measurement. In case the condition:

(prof(${TRAFFIC_CS_TOTAL}) > 0.2) and((prof(${TRAFFIC_CS_TOTAL}) - ${TRAFFIC_CS_TOTAL})/ var(${TRAFFIC_CS_TOTAL})) > 2

is violated, a notification should then be sent to SQM. SQM should then handle this event in a respective rule.

These are the needed steps for this example:

• Step 1: Define a KPI in Report Builder (or you can use an already existing KPI definition from Report Builder).

• Step 2: Create a Report definition in Thresholder and Profiler

• Step 3: Define threshold formulas for the KPI in Thresholder and Profiler

• Step 4: Adjust the interval and delay settings of the report in Thresholder&Profiler

• Step 5: Initialize Profile in Thresholder&Profiler

• Step 6: Create Rule with SQM Rule Wizard



Example Step 1: Define a KPI in Report Builder - 1

1. Open the Reporting folder on the NetAct Start page and start the Report Builder

2. In Report Builder check if there is a suitable folder structure available to store SQM KPIs. If not, create

one with Report -> New -> Folder

3. Change to the Formula

view




4. Start the Formula Wizard

5. Select the Target Folder

6. Define the Unit

6. Give a description of your Formula

7. Give the formula a

name

8. Click Next




10. Click Validate

11. Click Finish

9. Enter in the frame Time Aggregation Rule the formula: You

can select the appropriate Performance Indicators in the tree

on the left hand side and move them into the formula you are

editing using the “Arrow” button.



Example Step 2: Define Reports in Thresholder&Profiler - 1

1. Open the Reporting folder on the NetAct Start

page and start the Thresholder&Profiler

2. In Thresholder&Profiler check if there is a suitable folder structure available to store SQM Reports. If not, select TPDefinitions and click

“Create Subfolder”




1. Select the folder in which you want to create the report and click “Create

Report”

2. Give the Report a name and click “Next”

3. Select the Report Builder KPI from the menu tree (directory

depends where you have defined the KPI). Then click “Next”




1. In the Time pane select

hierarchy and summary level

2. In the 2G Network pane select hierarchy, summary level, include

or excluded, and objects to include or

exclude

3. In the Segment ID pane select hierarchy,

summary level and include or exclude

4. Click “Finish”



Example Step 3: Define Threshold Formulas for the KPI in Thresholder and Profiler

1. In the menu tree select the KPI that is used in your report.

2. In the Threshold pane define a formula which will

determine a threshold violation. Then click “Save”.

If needed, define more formulas.



Example Step 4: Adjust Interval and Delay Settings in Thresholder&Profiler

1. In the menu tree select the report that

you have defined.

2. In the options tab you can define the

scheduling details of the report. Click “Save

Settings” to submit changes.



Example Step 5: Initialize Profile in Thresholder&Profiler

If you want to use profiled values for thresholding then you must enable Profiling in the Profile tab. Click “Save

Changes” to submit you changes.



Example Step 5: Initialize Forwarding to SQM

If you want to use Thresholder and Profiler together with SQM you must forward the Thresholder & Profiler notifications to SQM. Click “Save Changes” to submit you changes.

Note: SQM can only deal with (K)PI names consisting of capital letters, underscores and dashes. If the KPI you are forwarding does not fulfil this requirement you must define an alias in the Threshold definition.

Set here the number of spikes (threshold violations) and the number of reporting periods, needed to raise an T&P event



Example Step 6: Create Rule with SQM Rule Wizard

On SQM side a rule must exist that handles the KPI you are forwarding.

If such a rule does not exist yet, then you must create a rule using

the SQM rule wizard.



Summary

• Thresholder and Profiler are NetAct applications that extend NetAct Reporter.

• They allow setting and managing thresholds or profiles for KPIs defined in Report Builder.

• You must define a formula which determines when a threshold has been violated; you can use a number of functions to define complex thresholds.

• Thresholds can be in single or multi-spike mode

• Thresholder and Profiler events can be forwarded as NetAct Alarms, SMS, email or SQM events

Thresholder and Profiler

Documents

Transcript of Thresholder and Profiler