1/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

User guide for KPI Reporter

Author: Janne Kolehmainen, NWS TS SysS Mgmt FI

Summary: User guide for KPI Reporter

Project: KPI Reporter

Version: v336 (r2739)

Document-ID:
2/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

Table of Contents
1. Introduction ............................................................................................... 4
1.1. Purpose of this document ....................................................................................................... 4
1.2. Documentation History ............................................................................................................ 4
1.3. References ............................................................................................................................. 4

2. Installation ................................................................................................. 5
2.1. Requirements ......................................................................................................................... 5
2.2. Install Microsoft .NET Framework 3.5 SP1 .............................................................................. 5
2.3. Install PostgreSQL .................................................................................................................. 6
2.4. Configure Microsoft Excel ....................................................................................................... 8
2.5. Configure Microsoft Excel 2007 .............................................................................................. 9
2.6. Install KPI Reporter ............................................................................................................... 10
2.7. SQL Settings......................................................................................................................... 12
2.7.1. PostgreSQL settings ........................................................................................................ 12
2.7.2. PostgreSQL autovacuum ................................................................................................. 13
2.7.3. MSSQL settings (If possible use PostgreSQL instead)..................................................... 15

3. Network element setup............................................................................ 16

3.1. RNC / I-HSPA / LTE.............................................................................................................. 16
3.1.1. Xml file backup ................................................................................................................ 16
3.1.2. Enable xmlfilesBU manually in OMS (RN3.0->) ............................................................... 17
3.1.3. Enable xmlfilesBU manually in Nemu (<-RN2.2) .............................................................. 17

4. Main menu .............................................................................................. 18

4.1. File menu .............................................................................................................................. 18
4.2. NE menu............................................................................................................................... 18
4.3. Help menu ............................................................................................................................ 18

5. Network Element settings........................................................................ 19

5.1. General settings.................................................................................................................... 19
5.1.1. Add Database .................................................................................................................. 20
5.1.2. Manage Database............................................................................................................ 21
5.2. Connection ........................................................................................................................... 21
5.3. Polling ................................................................................................................................... 22
5.4. DB Cleanup .......................................................................................................................... 22
5.5. Aggregation .......................................................................................................................... 23
5.6. Dat-file .................................................................................................................................. 23
5.7. Delete Network Element ....................................................................................................... 24

6. NE Control .............................................................................................. 25
6.1. NE Settings ........................................................................................................................... 25
6.2. Measurement table handling ................................................................................................. 25
6.3. Templates used information .................................................................................................. 26
6.4. Database Update .................................................................................................................. 26
6.4.1. Select files ....................................................................................................................... 27
6.4.2. Select Directory................................................................................................................ 27
6.4.3. Database update process ................................................................................................ 28
3/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

7. BTS Control ............................................................................................ 29

7.1. General ................................................................................................................................. 29
7.2. RNC Specific information ...................................................................................................... 30
7.3. BSC Specific information ...................................................................................................... 30

8. Reporting ................................................................................................ 31
8.1. Toolbar ................................................................................................................................. 31
8.2. Reporting settings ................................................................................................................. 31
8.2.1. General Settings .............................................................................................................. 31
8.2.2. KPI Report ....................................................................................................................... 32
8.2.3. Single Measurement parameters ..................................................................................... 34
8.2.4. Worst items Report .......................................................................................................... 35
8.2.5. Complete HTML Report ................................................................................................... 36
8.2.6. Automated Report ............................................................................................................ 37

9. Network reporter ..................................................................................... 38

10. Template editor ..................................................................................... 39
10.1. V2 template format.............................................................................................................. 39
10.1.1. Template format version history ....................................................................................... 39
10.2. Template editor components ............................................................................................... 40
10.2.1. Toolbar ............................................................................................................................ 40
10.2.2. Template treeview............................................................................................................ 41
10.2.3. Group editor panel ........................................................................................................... 46
10.2.4. KPI editor panel ............................................................................................................... 48
10.2.5. Preview panel .................................................................................................................. 50

11. Troubleshooting .................................................................................... 52

11.1. Program crash / program works incorrectly (bug) ................................................................ 52
11.2. Questions/need help how to use the program ..................................................................... 52
11.3. Feature request / new measurement................................................................................... 53
11.4. Database connection problems ........................................................................................... 53

12. Formula definition.................................................................................. 54

12.1. Counter format .................................................................................................................... 54
12.2. Special objects.................................................................................................................... 54
12.3. Supported functions ............................................................................................................ 54
12.3.1. Comparision functions...................................................................................................... 54
12.3.2. Aggregate functions ......................................................................................................... 54
12.3.3. Mathematical functions .................................................................................................... 55
12.4. Case - structure .................................................................................................................. 55
12.5. Decode structure................................................................................................................. 56
12.6. Distinct ................................................................................................................................ 56
12.7. Examples ............................................................................................................................ 57
12.7.1. RNC/I-HSPA/LTE............................................................................................................. 57
12.7.2. BSC ................................................................................................................................. 57
12.8. FAQ .................................................................................................................................... 58
12.9. Template file example ......................................................................................................... 60
4/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

1. Introduction
1.1. Purpose of this document
This document contains user guide for KPI Reporter tool. Guide is based on 2G
KPI Report Training&User Guide 2.0 created by Janne Väättäri.

1.2. Documentation History

Date Author Version Description

14.05.2008 Janne Kolehmainen r307 Document created.

15.05.2008 Janne Kolehmainen r309 Chapter 2 added.

19.05.2008 Janne Kolehmainen r313 Chapter 2.7, 3.1-3.3 added. 3.4

started.

20.05.2008 Janne Kolehmainen r314 First version to be commented.

04.06.2008 Janne Kolehmainen r350 Chapter 6 updated.

28.07.2008 Janne Kolehmainen r388 Chapter 5.1: 1 parameter added.

Chapter 8.3 added.

05.01.2009 Janne Kolehmainen r556 Chapters 2.6, 5.1, 5.1.1, 7, 8.2

updated.
Chapter 6.3 added

11.06.2010 Janne Kolehmainen r1054 .Net Framework changed from

2.0 to 3.5.
PostgreSql installation
instructions added.
Reporting updated.

19.12.2011 Janne Kolehmainen r2043 Updated to version 242 level.

20.12.2011 Janne Kolehmainen r2070 SVGImage information added.

12.1.2012 Janne Kolehmainen v250 (r2115)r FAQ added to formula definition

chapter

19.1.2012 Janne Kolehmainen v255 (rxxxx) Added some worst items

changes.

7.2.2012 Janne Kolehmainen v270 (r2209) Group kpi attempt list selection
information added. New Svg
image added.

8.10.2012 Janne Kolehmainen v336 (r2739) - Added some information

about temporary table
addition
- Added some information
about Template settings

1.3. References
5/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

2. Installation
2.1. Requirements
Following requirements must be filled to use this tool successfully.

 Microsoft Windows 2000, Windows XP or Windows 7

 Microsoft Office 2003 / 2007 (Excel, Powerpoint) (see chapter 2.4/2.5)
 Microsoft .NET Framework 3.5 SP1 (see chapter 2.2)
 SQL Server
o PostgreSQL Server (recommended)
o Microsoft SQL Server (not maintained anymore)

2.2. Install Microsoft .NET Framework 3.5 SP1

Microsoft .NET Framework 3.5 SP1 is runtime environment needed by KPI
Reporter. It must be installed before those can be installed.

1 Download .NET Framework 3.5 SP1 from Microsoft web page. (Download
isn’t possible with Internet Explorer with NSN package. Use Firefox or
Netscape instead)

2 Start dotnetfx.exe file.

4 Tick I have read an Accept the ...

checkbox and click Install. Wait
installation progress to finish.

5 Installation is compelet, click Exit

6/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

2.3. Install PostgreSQL

PostgreSQL is a powerful, open source object-relational database system. It has
more than 15 years of active development and a proven architecture that has
earned it a strong reputation for reliability, data integrity, and correctness. It runs on
all major operating systems, including Linux, UNIX (AIX, BSD, HP-UX, SGI IRIX,
Mac OS X, Solaris, Tru64), and Windows. It is fully ACID compliant, has full support
for foreign keys, joins, views, triggers, and stored procedures (in multiple
languages). It includes most SQL:2008 data types, including INTEGER, NUMERIC,
BOOLEAN, CHAR, VARCHAR, DATE, INTERVAL, and TIMESTAMP.

1 Download newest PostgreSQL version from PostgreSQL.org web page.

2 Start installer.

3 Click Run (If this window is shown)

4 Click Next

5 Select installation folder and click Next

7/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

6 Select Data Directory and click Next

7 Give valid password twice and click Next.

(This password is used for postgres user)

8 Select server port number (this should be

5432) and click Next

9 Deselect Install pl/pgsql in template1

database and click Next

10 Click Next to start the installation

8/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

11 Wait until installation is finished

12 Untick the Launch Stack Builder at Exit

and click Finish. Installation of the
PostgreSQL server is complete.

2.4. Configure Microsoft Excel

Microsoft Excel must be configured to enable KPI Reporter to create Charts.

1 Start Microsoft Excel

2 Select Tools -> Macro -> Security

3 Select Trusted Publishers tab page and

select tick box Trust access to Visual
Basic Project and click OK.
9/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

2.5. Configure Microsoft Excel 2007

Microsoft Excel 2007 must be configured to enable KPI Reporter to create Charts.

!!! Excel 2007 is officially supported from version 2009-10/134 onwards !!!

1 Start Microsoft Excel

2 Select Office Button -> Excel Options

3 Trust Center -> Trust Center Settings

4 Select Macro Settings and enable Trust

access to the VBA project object
model

5 Click OK, OK and close all Excel 2007 instances

10/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

2.6. Install KPI Reporter

Before you start installing the tool, be sure you have required software installed
(see chapter 2.1).

!!! If you have earlier version of the tool installed, uninstall it first from Control Panel
-> Add/Remove programs. If this is not done, there might be problems. !!!

1 Download KPI Reporter installation package from iSource. You have to

download newest KPI Reporter package KPI_Reporter_xxxx_xx_xx.msi and
also newest reporting templates. Look under BSC Templates and RNC
Templates.

2 Start KPI_Reporter_xxxx_xx_xx.msi installation by clicking the file.

3 Click Next.

4 Check that Everyone is selected, select

desired folder if wanted and click Next.

5 Click Next.

6 Click Close.
11/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

7 Copy downloaded KPI template (*.kpi) files to

installation folder defined in step 4.

8 Start the program and fill in licensing

information.

If you have working e-mail you can select

send via e-mail and new e-mail is created
automatically.
If you don’t have e-mail possibility in your
computer select Save to file and attach
saved file to e-mail.

Select needed network elements from the list

in right. If you select all of them we have to
send you e-mail and ask what network
elements you are really working with.

Send e-mail to
Nsn, Bts I&V Ta Support (NSN - Global)
(bts_i&[email protected])
You will get license file within few days to you
e-mail.

9 After you have received the email containing

the license file, start program again. Select
Load button from the first row.

You have few choices how to load your

license.

1) you can save license xml to hard disk

and select Load from file.
2) You can select license text from the
file, copy it to clipboard and click
paste button.
3) You can drag and drop the file to field
below.

If license is valid, click Ok and start the

program.
12/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

2.7. SQL Settings

2.7.1. PostgreSQL settings
In SQL Settings you have to different connection to configure, reading connection
and saving connection settings. Reading connection settings must be configured
always. Saving connection settings is needed if tool is used to save data to
database, not only to report.

1 Start the tool and select File -> Settings

2 Configure Measurement Reading SQL
Server Settings.

Local PostgreSQL server

 Server: 127.0.0.1
 Username: postgres
 Password: defined in installation
Remote PostgreSQL server
 Ask settings from administrator

3 Configure Measurement Saving settings if

needed.

See settings above.

4 Click Test Connection and check if

connection is working.

If there are problems see chapter 11.4

5 Click OK to close the settings window.

13/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

2.7.2. PostgreSQL autovacuum

PostgreSQL has an optional but highly recommended feature called autovacuum,
whose purpose is to automate the execution if VACUUM and ANALYZE
commands. When enabled, autovacuum checks for tables that have had a large
number of inserted, updated or deleted tuples. These checks use the statistics
collection facility; therefore, autovacuum cannot be used unless track_counts is set
to true. In the default configuration, autovacuuming is enabled and the related
configuration parameters are appropriately set.

It is advicable to set up the autovacuum if you are updating tables automatically

and using also the database cleanup feature.

VACUUM FULL

If your database has been in use for long time and you have used database
cleanup feature it is advisable to run vacuum FULL before setting up the
autovacuum. (see VACUUM for space recovery).

!!! VACUUM FULL is only needed when you have a table that is mostly dead rows -
ie, the vast majority of its contents have been deleted. Even then, there's no point
using VACUUM FULL unless you urgently need that disk space back for other
things or you expect that the table will never again grow to its past size. Do not use
it for table optimization or periodic maintenance, as it's counterproductive. !!!

This can be done also with pgadmin tool (see below for instruction to create server
with the tool). Select correct database from Databases treenode then select Tools
– Maintenance – VACUUM check FULL (only check this if you need to free the
used space for OS) and then click OK

Autovacuum tuning (by Heikki Simola)

1 To edit postgresql.conf open pgadmin

III program from start menu

2 Add Server (if not done already),

Click File – Add Server

3 Set correct settings

Name: ex. Local server
Host: localhost
Port: normally 5432
Username: postgres
Password: defined in installation

Click OK
14/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

4 Select your server from the treeview

and click Connect from context
menu.

5 Click Tools – Server Configuration

– postgresql.conf

...

6 Edit following settings from there:

autovacuum = on # enable autovacuum subprocess?
autovacuum_naptime = 60 # time between autovacuum runs, in secs
autovacuum_vacuum_threshold = 1000 # min # of tuple updates before vacuum
autovacuum_analyze_threshold = 500 # min # of tuple updates before analyze
autovacuum_vacuum_scale_factor = 0.4 # fraction of rel size before vacuum
autovacuum_analyze_scale_factor = 0.2 # fraction of rel size before analyze
autovacuum_vacuum_cost_delay = -1 # default vacuum cost delay for autovac,
# -1 means use vacuum_cost_delay
autovacuum_vacuum_cost_limit = -1 # default vacuum cost limit for autovac,
# -1 means use vacuum_cost_limit
shared_buffers = 40000 # min 16 or max_connections*2, 8KB each
max_fsm_pages = 10000000 # min max_fsm_relations*16, 6 bytes each
max_fsm_relations = 10000 # min 100, ~70 bytes each

7 After you have edited the settings

click File – Save and then Reload
server to take settings into use.

8 If you have any problems see

information from chapter 10
15/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

2.7.3. MSSQL settings (If possible use PostgreSQL instead)

In SQL Settings you have to different connection to configure, reading connection
and saving connection settings. Reading connection settings must be configured
always. Saving connection settings is needed if tool is used to save data to
database, not only to report.

1 Start the tool and select File -> Settings

2 Configure Measurement Reading SQL
Server Settings.

Local MSDE2000A
 Server: (local)
 Username: sa
 Password: defined in installation

Local MSSQL 2005

 Server: .\SQLExpress
 Use Windows Authentication

MSSQL 2005 server

 Ask settings from administrator

3 Configure Measurement Saving settings if

needed.

See settings above.

4 Click Test Connection and check if

connection is working.

If there are problems see chapter 11.4

5 Click OK to close the settings window.

16/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

3. Network element setup

Here is explained details what is needed to do in network element, to be able to
start kpi reporting with this tool.

3.1. RNC / I-HSPA / LTE

KPI data is retrieved from OMS/Nemu unit. If unit is not installed then KPI data is
not possible to retrieve. To be able to collect the data, Xml backup feature is
needed to be turned on in OMS/Nemu. After feature is turned on all NEW
measurement data is possible to move to KPI Reporter database. It isn’t possible to
get old data.

3.1.1. Xml file backup

Xml file backup is needed for KPI Reporter to be able to download measurement
data from OMS using Ftp data transfer

Purpose

After OMS (NEMU) has postprocessed the measurement data, it writes the data
into a gzip-compressed XML file in directory /var/opt/OMSftproot/xmlfiles
(e:\nemu\inetpub\ftproot\xmlfiles). After writing the file, OMS (Nemu) sends a
notification to NetAct. NetAct downloads the file using FTP and acknowledges the
transfer to OMS (Nemu). When OMS (Nemu) receives the acknowledgement, it
deletes the XML file from the disk. Usually the file is deleted within a few minutes
after its creation.

You can change the OMS (Nemu) configuration so that copies of measurement
files are stored into the /var/opt/OMSftproot/xmlfilesBU
(e:\nemu\inetpub\ftproot\xmlfilesBU) directory, from where they are automatically
deleted 7 days after creation. You can use the stored measurement file copies for
manual download of measurement data if some data has been lost in NetAct
processing.
17/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

3.1.2. Enable xmlfilesBU manually in OMS (RN3.0->)

Steps

1. Change the OMS LDAP configuration settings.

Start the Parameter Tool GUI in the RNC Element Manager

2. Open the LDAP path.

ClusterRoot/OMS/OMSPlatform/SS_GenericPM/OMSNMSFWriter/

3. Set the BackupEnabled value to 1.

Double-click the BackupEnabled value and set it to 1. Process restarts
are not needed because the change takes effect immediately when the
next measurement file is written.

To deactivate saving copies of measurement files on OMS disk, set the

BackupEnabled parameter value to 0.

Expected outcome

The file duplication is active. Copies of measurement files are written into the
/var/opt/OMSftproot/xmlfilesBUdirectory.

3.1.3. Enable xmlfilesBU manually in Nemu (<-RN2.2)

NOTE !!! Current measurement period is lost!!!
Measurements are started again in next measurement period

Steps

1. Open NetOp connection to NEMU and start Registry Editor.

Start/Run, regedit

2. Open the registry branch.

HKEY_LOCAL_MACHINE\SOFTWARE\Nokia\NEMU\InstalledModules
\i_services\nemugenericpm\NemuNMSFWriter\CurrentVersion\Settings

3. Set the BackupEnabled value to 1.

Double-click the BackupEnabled value and set it to 1.

4. Restart the NemuGenericPMCtrl process from the Platform Manager

User Interface.
Select Start->programs->Nemu->Platform Manager User Interface-
>pmui.
In RNC-NEMU, restart also the NemuMeaHandler process.

Expected outcome

After the process restart, the file duplication is active. Copies of measurement
files are written into the e:\nemu\inetpub\ftproot\xmlfilesBU directory.
18/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

4. Main menu
Main menu can be used to access different settings and functionality.

4.1. File menu

 New: Clear all network elements and start setting new ones.
 Open: Open existing KPI Reporter Settings (*.krs) file (Also old xml files can be
opened).
 Save: Save settings to current file. If settings are not saved before then file is
asked before saving.
 Save As: Ask for file where to save the settings
 Settings: Edit SQL Settings (see chapter 2.7).
 Exit: Exit program

4.2. NE menu

 Add: Add new network element. Program will open network element settings
window (see chapter 5).
 Delete: Remove network element from the list. (see chapter 5.7)
 Start Monitoring: Start monitoring to all defined network elements. (see
chapter 6.4)
 Stop Monitoring: Stop monitoring to all defined network elements. Asks "Do
you want to wait until current table is synchronized? If you select
yes then currently updated table will be synchronized first and after that process
is stopped. If you select no then process is stopped immediately.
 Add Network Reporter: Open network level reporter where you are able to
create reports over multiple network elements of same type. All network
elements must be in same database with different element id. (see chapter 9)

4.3. Help menu

 Start tracelog: Start kpireporter internal message tracing. (see chapter Error!
Reference source not found.)
 Extented Trace: Enables extended trace information to be shown to external
traceviewer tool (see chapter Error! Reference source not found.)
 About: Show about dialog or update license.
19/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

5. Network Element settings

5.1. General settings

Settings available when adding new network element:

 NE Number: define number for Network element. !!! If you are using multiple
network elements in one database (KPI Database name) make sure that you have
individual number for every NE !!!
 NE Name: This is extra information that can be used to identify network element

Settings that are always available

 Network Element: Select wanted network element type. List shows only NE’s that
are enabled in license file.
 Connection Type:
o FTP Transfer: Data is read directly from NE
o Select Files: Select measurement files by hand (only 500 files once possible)
o Select Directory: Go through all files in specified directory.
o Poll Directory: Poll specified directory to check for new files. Files are deleted
after read.
o SCP Transfer: Data is read directly from NE using SSH and SFTP connection
 KPI Database name: Select database to be used with tool. You can create new
one be clicking Add (see chapter 5.1.1). If saving sql settings are set you can also
delete databases. This will delete db permanently and is not recoverably. !!! If
Reading DB List… is showing, wait until box is back to white !!!
 Only transfer recent data: If you are transferring data directly from network
element then you can only transfer data for last few days. !!! If you are transferring
data from files which are older than 7 days, uncheck this option. !!!
 Days read before current date: Determines how many days before current date
data is transferred to database. !!! Available only when Only transfer recent data is
checked. !!!
 Fill in missing data: If checked then latest added measurement data is not
checked from database. All the available measurement data is gone through. Rows
that are added already are skipped. !!! Data addition will take longer time. !!!
 Match NE Id to measurement file: If checked then network element id is read
from measurement file. Data is only imported if neid’s match. (not used with bsc)
 Update Temp Table: If automatic reporting is used, tick this. Otherwise it is best
not to include this. It will create temporary table for every measurement and keep
last 27 hours of data there.
20/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

5.1.1. Add Database

1 Open either Add new NE or edit NE settings

1 Click Add (If you are using FTP Transfer or
SCP Transfer then transfer settings must be
set before you can add new database)
2 Add database name.

If you want to create database to be used

only with certain template(s) you can check
Create template specific database and
select needed templates. !!! If you create
database with specific template(s) you are
not able to use other templates with the
received data. !!!

!!! Using specific template to create database

makes databases smaller when only needed
counters are moved to database. Size
reduction depends from the template. (With
KPI_Report_2g it was 68%) !!!

After you have made needed decisions, click

Create.
3 Select desired tables (Measurements) from
left and click ->. !!! If tables doesn’t show up
in right check your saving sql settings. !!!

!!! If you have selected KPI Template(s) to be

used with the database, then only needed
measurement are shown !!!

More info see chapter 5.1.2.

4 Click Close.
21/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

5.1.2. Manage Database

These window is used to modify tables (measurements) used with database
update.

 Available Tables: Contains tables that are defined in network element settings.
(see chapter Error! Reference source not found.) Tables that are moved to
Added tables column is not shown here.
 ->: You can move one or more selected tables to added tables column.
 <-: You can delete one or more selected tables in Added tables column. After
deletion deleted tables will be moved to available tables column.
 Added Tables: Contains tables that are created to database.

5.2. Connection
These settings are enabled only if FTP or SCP Transfer is selected.

 Update IP Addresses Hourly: This will enable automatic IP Address updating

every hour. This is not available when using BSC connection.
 FTP/FTT Settings: Setup ipaddress, username and password for BSC or
Nemu/OMS units.
 OMU Settings: This is used to get WBTS information from RNC. If needed put
ipaddress, username and password for OMU connection.
 NEMU / OMS Settings: Fill in ipaddress, username and passwords used with
application launcher.
 Disable BTS List update: If checked then bts list is not updated periodically (only
available when OMU connection is set.
22/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

5.3. Polling
Available when FTP Transfer or Poll directory selected.

 Delay between Pollings (minutes): How many minutes to wait after last polling
before checking measurements again.
 Polling Directory: (Only when poll directory selected) Select polled directory.
 Delete files after copy: (Only when poll directory selected) Delete files from
directory after files are copied to local disk.

5.4. DB Cleanup
DB Cleanup can be used to automatically delete measurement data from database
to save space (There are limitations with DB size with free MSSQL Server
versions)

 Enable automatic database cleanup: this will enable automatic cleanup

functionality
 Clear data by specific date: If this is checked then everything before set day is
deleted from database automatically.
 Clear data by specific timespan: If this is checked then everything before set
timespan is deleted. (Ex. if timespan is set to 1 month and day is 1.1.2008, then
everything before 1.12.2007 is cleared)
!!! If automatic database cleanup is used then make sure that autovacuuming is
working (see chapter 2.7.2) !!!
23/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

5.5. Aggregation
Aggregation is used to compress data to save space. Aggregation combines values
in measurements in time level. Ex. if database contains data with interval 15
minutes and data is aggregated to day level, 4 old data is combined to 1 value and
then 4 old data is deleted. Day aggregation is done first and after that hour level
aggregation.

 Enable aggregation to hour level: if this is selected then all data that is older than
set day count is aggregated to hour level.
 Days after hour level aggregation is used: set how many days to keep intact
before data is aggregated to hour level. Ex. value is set to 2; last data in database
is dated to 1.1.2008. All data dated older than 31.12.2007 is aggregated. Minimum
value is 1, so last addition day is never aggregated.
 Enable aggregation to day level: if this is selected then all data that is older than
set day count is aggregated to day level.
 Days after day level aggregation is used: set how many days to keep intact
before data is aggregated to day level. Ex. value is set to 2; last data in database is
dated to 1.1.2008. All data dated older than 31.12.2007 is aggregated. Minimum
value is 1, so last addition day is never aggregated.

5.6. Dat-file
These settings can be used to handle gz and dat file handling.

 Move KPI data only for selected BTS: If this is set then only data for those BTS’s
that are in BTS list (see chapter xxx) is moved to database.
 Save dat files to hard disk: if this is set then dat/gz files are saved to hard disk
after data is saved to database. Filenames are changed to contain data starttime.
 Directory: Directory where dat/gz files are saved.
 Use CopyIn feature: If this is checked then copyin command is used instead of
insert. This is quicker method to put lot’s of data to database
!!! This is still under testing and if you have any problem with adding data don’t use
this !!!
24/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

5.7. Delete Network Element

Select desired network element from the list and click delete.
25/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

6. NE Control
Network Element control can be used to modify NE settings, manage tables and to
start database update.

6.1. NE Settings
You can see defined settings in the read only text box. You can also edit current ne
settings by clicking Edit Settings button. See chapter 0 for NE settings.

6.2. Measurement table handling

You can see added tables and little more information in here

 List Type:
o Measurements: shows only measurement names.
o Measurements with dates: Shows data start and end date in
measurements (this can take some time to complete or if there is too
many rows in the database it may fail)
o Measurements with intervals: Shows intervals in measurements (this
can take some time to complete or if there is too many rows in the
database it may fail)
o Measurements with row counts: Shows row counts in measurements.
 Manage Tables: Open manage database dialog (see chapter 5.1.2).
 Compact DB: Executes script to make database size smaller (Database size
doesn’t get smaller automatically even if rows are deleted). !!! Make sure there
isn’t any other connection reading/writing to that database while using this
command !!!
 Database size: Shows used database size as well as free space in database
file.
26/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

6.3. Templates used information

You can see templates that are used when creating the database. You are not able
to use any other templates than those.

6.4. Database Update

This will start Database update process for specified network element.

 Start Database Update: Starts database update process (see chapter 6.4.3). If
read directory/select files is selected as connection type directory/files are
asked after you have clicked the button (see chapter 6.4.1 and 6.4.2).
 Stop Database Update: Stops database update process. Asks "Do you want
to wait until current table is synchronized? If you select yes then
currently updated table will be synchronized first and after that process is
stopped. If you select no then process is stopped immediately.
 Auto Scroll: If selected then newest status message will be shown in the
bottom of the status box.
 Clear List: All the messages in the status message box is deleted.
 Message buffer length: Determines how many messages are shown in status
box. Default is 100.
 RNC SW Version: Shows current RNC SW version number.
27/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

6.4.1. Select files

If select files is selected from connection type then files are asked before process
can go on. !!! Only 500 files can be selected. !!!

Select desired files using shift + mouse click to select all files between first and last
selected file and ctrl + mouse click to select multiple individual files. When all
needed files are selected press Open.

6.4.2. Select Directory

If Select Directory is selected as connection type then dat/gz file directory is asked
before update process can go on. Select directory and press OK.
28/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

6.4.3. Database update process

Database update process depends from used network element type. Basic
functionality is the same: first files are downloaded / read from disk and then the
parsed data is put to database.

You can see in status window how many rows have been added to specific
database table and also other information as well. When process is finished
Database update stopped message is shown (if select files/directory is selected). If
FTP/SCP Connection or polling is selected then after update process is finished,
system will wait delay between polling time and then start process again. You have
to push stop database update button to stop the process.
29/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

7. BTS Control
BTS Control can be used to retrieve BTS information from BSC dat files, ZEEI and
ZEQO listings, RNC/LTE/I-HSPA measurement files or database (from specific
measurement).

7.1. General

 Start BTS List Reading: Start BTS list updating process. If BSC and select
files are selected then you have to first select files you want to use to update
the settings. If network element is RNC then after BTS numbers and names has
been updated it continues to get BTS ip addresses. This process can be
stopped.
NOTE! WBTS list reading uses MML connection to RNC and in there it
connects OMU’s terminal interface. After that it will try to connect each WBTS
using FTP connection and retrieve SW information.

Consult operator that you are allowed to do that!!!

If you don’t want to use this feature click Don’t Update WBTS List in
RNCSettings

If you are using RNC network element and other than FTP transfer then BTS
information is taken from database.

 Stop BTS List Reading: If this button is pressed, BTS update process is
stopped.
 Read from database: It is also possible to read bts information from database.
When Start BTS list Reading button is pressed tool will connect the current
database and read bts’s from specific measurement
o RNC: cellresource
o LTE: lte_s1ap
o I-HSPA: cell_resource_IH
o BSC: not supported at the moment
!! Measurements have to be selected and data imported this feature to work !!
30/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

7.2. RNC Specific information

 Edit Settings: Edit BTS settings (RNC)

 Update IPAddress: Updates BTS ipaddress from OMU (RNC)
 Set Settings to all BTS’s: Copies current BTS settings to all BTS’s in the list.
(RNC)
 Remove BTS: Removes BTS from the list. If BTS is removed and Move KPI
data only for selected BTS (see chapter 5.6) is selected in NE settings then
measurement data from those BTS’s is not moved to database.
 Update BTS Configuration Information: Start BTS configuration information
update (RNC)
 Update BTS SW Information: Start BTS SW information update (RNC)

7.3. BSC Specific information

 With BSC you can import also other information about the network using ZEEI
and ZEQO listings as a help. Update procedure is started in the same way as
normally, but instead of using dat files, ZEEI.txt and ZEQO.txt files used
instead and then tool parses radio network parameters from them. This
information can be used when selecting reported BTS’s.

 Click Update BTS List and then change file type to ZEEI/ZEQO listing and
select correct files.
31/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

8. Reporting
Reporting is used to output the data saved in database.

8.1. Toolbar
 Start: Starts report creation process.
 Stop: Stops automated report generation. Not working in other report types
than Automated Report.
 New: Create new settings. All settings are changed to default.
 Save: Saves current settings with the name that is Report Name field. If no
name is set the name is asked.
 Save As: Saves settings as a new one. New name is asked in separate
dialog.
 Report Name: Shows current settings name. Different report settings can be
selected from this combobox.

8.2. Reporting settings

8.2.1. General Settings

 Report Type: Defines what report type is used to output

o KPI Measurement Report: Basic report type to output all kpis once.
o Single Measurement Report: This report type can be used to create
more detailed report from one kpi. Select desired measurement(s) from
Single Measurement tab page.
o Worst items report: Will show worst items (BTS, Cell) in different kpis.
o Complete HTML Report: Creates HTML report that contains kpi’s in
RNC and also to every BTS in BTS list.
o Automated Report Generation: This will create complete HTML
reports automatically.
 10 minutes after the hour: last 24 hours. (this needs temporary
table to be present.)
 01:00 every night: last 1 and 2 weeks.
 Report Template: Shows the list of the available KPI Report template files in
program folder and Common app path. Only templates that are correctly
created are shown. If you are editing template by hand and made some mistake
it is possible that template won’t show in the list. If no files are shown here get
correct KPI template file from iSource. Report template files can be created and
edited with KPI Template editor (ask availability from Janne Kolehmainen).
 Refresh: Refresh template list (needed if template is added manually or
new template is created with template editor)
 Import template: User can select template to be imported to tool. Template
is saved to Common app path folder. If template already exists then user is
asked permission to replace the existing template
32/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

o Windows XP: C:\Documents and Settings\All Users\Application Data\

Nokia Siemens Networks\KPIReporter\Templates
o Windows 7: C:\ProgramData\Nokia Siemens Networks\
KPIReporter\Templates
 Delete template: Currently selected template file is deleted.
!!! Make sure that you delete correct template. There is no undo command !!!
 Report Directory: Select folder where reports are saved.
 Ask filename: If checked then filename is asked from the user. (Available only
when using excel or powerpoint output types).

8.2.2. KPI Report

KPI Report is basic report that can output reports from the templates to Excel,
Powerpoint or HTML format.

 Report Output Type

o Excel: Creates spreadsheet that contains kpi values and charts.
o Powerpoint: Creates powerpoint file that contains only charts. (not
available with BSC)
o HTML: Creates pictures and html files that contains only charts.
o Excel2007: Creates spreadsheet that contains kpi values and charts to
xlsx format.
!!! Can cause tool to crash due to out of memory exception if lot’s of
rows are reported (more than 64000) !!!
 Level:
o NE: Report is done in network element level. You can affect which
BTS’s are used with this with BTS List. Only selected BTS’s is used in
this report.
o BTS: Create report with one or more BTS’s. Select BTS’s from BTS list.
If Put BTSs to individual excel files is selected one Excel is created to
every BTS.
o Cell/TRX: Create report showing also the cell/trx level.
!!! If measurement doesn’t have cell/trx level then values are shown to
cell/trx object 0. This can cause problems with kpi’s that combine data
from two measurement where both doesn’t contain cell/trx level
information !!!
 Period: Reporting period; 15min, 1h, 1day. If data only contains data with 1h
interval and period is selected to 15min there are empty spaces in charts.
33/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

 Reporting Time Periods: Define what periods you want to report. Select data
and time from timebox and click + button.
o Get Dates: You can select desired measurement from the list on the left
from this button and click this button. You will get date from the first and
last value from the selected measurement.
o Daily Period: You can select daily periods that are reporter (ex. Busy
hours)
 Highlight Times: You can highlight specified periods in charts with red to show
ex. trial start and stop times. Remember to click the + button.
 Selection parameters
o Include All: Include all items in the database.
o Include: Report is created using only items selected in item List.
o Exclude: Report is create using only items that are NOT selected in
item List.
o Clear selections: All checked bts’s are unchecked.
o Selection types
 Select BTS: Select which BTS’s to be used in reporting
o Bsc selection types
 Select BCF: Select which BCF’s to be used in reporting
 Select SEG: Select which Segments to be used in reporting
 Select Feature: Select which features are used in reporting
 Extra Parameters:
o Include Configuration: WBTS configuration can be included to
powerpoint report (RNC only)
o Put BTSs to individual excel files: If multiple BTS’s are selected and
reporting level is BTS then it is possible to create individual excel files to
every BTS.
o Report using original timezone: Make report using timezone in
original measurement file.
 Datatable have to be created with version 09.10.140 or newer !
 Supported only with RNC, I-HSPA and LTE.
o Don’t create graphs: If checked then graphs are not created in excel
reports.
34/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

8.2.3. Single Measurement parameters

 Period: Reporting period; 15min, 1h, 1day. If data only contains data with 1h
interval and period is selected to 15min there are empty spaces in charts.
 Create Excel 2007 report: If checked then report is created in xlsx format.
 Level:
o NE: Report is done in network element level. You can affect which
BTS’s are used with this with BTS List. Only selected BTS’s is used in
this report.
o BTS: Create report with one or more BTS’s. Select BTS’s from BTS list.
If Put BTSs to individual excel files is selected one Excel is created to
every BTS.
o Cell/TRX: Create report showing also the cell/trx level.
!!! If measurement doesn’t have cell/trx level then values are shown to
cell/trx object 0. This can cause problems with kpi’s that combine data
from two measurement where both doesn’t contain cell/trx level
information !!!
 Reporting Time Periods: Define what periods you want to report. Select data
and time from timebox and click + button.
o Get Dates: You can select desired measurement from the list on the left
from this button and click this button. You will get date from the first and
last value from the selected measurement.
o Daily Period: You can select daily periods that are reporter (ex. Busy
hours)
 Highlight Times: You can highlight specified periods in charts with red to show
ex. trial start and stop times. Remember to click the + button.
 Selection parameters
o Include All: Include all items in the database.
o Include: Report is created using only items selected in item List.
o Exclude: Report is create using only items that are NOT selected in
item List.
o Clear selections: All checked bts’s are unchecked.
o Selection types
 Select BTS: Select which BTS’s to be used in reporting
o Bsc selection types
 Select BCF: Select which BCF’s to be used in reporting
 Select SEG: Select which Segments to be used in reporting
 Select Feature: Select which features are used in reporting
 KPI List: Select kpi(s) that you are interested in. Each measurement is put to
own Excel file.
35/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

8.2.4. Worst items Report

 Level:
o BTS: Create report with one or more BTS’s. Select BTS’s from BTS list.
BTS will be shown in the report in own column
o Cell: If selected then worst cell is found out instead of worst BTS.
 Period: Reporting period; 15min, 1h, 1day. If data only contains data with 1h
interval and period is selected to 15min there are empty spaces in charts.
 Reporting Time Periods: Define what periods you want to report. Select data
and time from timebox and click + button.
o Get Dates: You can select desired measurement from the list on the left
from this button and click this button. You will get date from the first and
last value from the selected measurement.
o Daily Period: You can select daily periods that are reporter (ex. Busy
hours)
 Highlight Times: You can highlight specified periods in charts with red to show
ex. trial start and stop times. Remember to click the + button.
 Selection parameters
o Include All: Include all items in the database.
o Include: Report is created using only items selected in item List.
o Exclude: Report is create using only items that are NOT selected in
item List.
o Clear selections: All checked bts’s are unchecked.
o Selection types
 Select BTS: Select which BTS’s to be used in reporting
o Bsc selection types
 Select BCF: Select which BCF’s to be used in reporting
 Select SEG: Select which Segments to be used in reporting
 Select Feature: Select which features are used in reporting
 Number of worst items: How many worst BTS’s/Cell’s/TRX’s are selected to
reporting.
 Attempt Limit: If KPI has attempt counter attached to it then attempt limit can
be set. !!! If attempt limit is set in template then this value is not used !!!
 Get Worst Periods: Normally you get worst BTS/Cell over whole period. If this
is selected then worst periods to BTS/Cells are found out.
 Max number periods / item: How many periods for one bts/cell/trx is shown in
list. !!! If ex. 5 is set and Number of worst items is 5 then it is possible that all
items shown in list is from one item. !!!
36/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

8.2.5. Complete HTML Report

This will create complete html report where there is report in Network element level
as well as BTS level.

 Period: Reporting period; 15min, 1h, 1day. If data only contains data with 1h
interval and period is selected to 15min there are empty spaces in charts.
 Reporting Time Periods: Define what periods you want to report. Select data
and time from timebox and click + button.
o Get Dates: You can select desired measurement from the list on the left
from this button and click this button. You will get date from the first and
last value from the selected measurement.
o Daily Period: You can select daily periods that are reporter (ex. Busy
hours)
 Highlight Times: You can highlight specified periods in charts with red to show
ex. trial start and stop times. Remember to click the + button.
 Selection parameters
o Include All: Include all items in the database.
o Include: Report is created using only items selected in item List.
o Exclude: Report is create using only items that are NOT selected in
item List.
o Clear selections: All checked bts’s are unchecked.
o Selection types
 Select BTS: Select which BTS’s to be used in reporting
o Bsc selection types
 Select BCF: Select which BCF’s to be used in reporting
 Select SEG: Select which Segments to be used in reporting
 Select Feature: Select which features are used in reporting
37/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

8.2.6. Automated Report

This will create complete HTML reports automatically.
 10 minutes after the hour: last 24 hours. (this needs temporary table to be
present.)
 01:00 every night: last 1 and 2 weeks.

 Selection parameters
o Include All: Include all items in the database.
o Include: Report is created using only items selected in item List.
o Exclude: Report is create using only items that are NOT selected in
item List.
o Clear selections: All checked bts’s are unchecked.
o Selection types
 Select BTS: Select which BTS’s to be used in reporting
o Bsc selection types
 Select BCF: Select which BCF’s to be used in reporting
 Select SEG: Select which Segments to be used in reporting
 Select Feature: Select which features are used in reporting
 Compare report
o Can be used to compare to different BTS groups in same time span.
Compare report can be selected when automated report generation is
selected. Three separate group compare can be created.
 Create Group Compare: Enable group compare to selected
compare number.
 Set Compare Start Time: Start the time when to start group
compare.
 Group1 Name: Define name for the first group.
 Group1: Select BTS’s that are used with first group.
 Group2 Name: Define name for the second group.
 Group2: Select BTS’s that are used with second group.
38/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

9. Network reporter
Network reported is used to create reports over multiple network elements of same
type. Used network elements must be configured to same settings file.

 Network element: Select desired network element type.

 KPI Database name: Select database to be used (only databases used in
current settings are shown)
 Network elements: Check network elements that you want to use.

For other tab pages and settings you can check appropriate chapters from this
document. Only difference is that bts list is retrieved from all network elements
selected and reporting is done over all selected elements.
39/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

10. Template editor

Integrated template editor replaces KPI Template editor tool. It is possible to edit
templates and preview kpi’s using template editor tab page. Template editor only
supports v2 template format (xkt extension). It is possible to compile v2 template to
v1 format (kpi extension) which is in encrypted format and can be then distributed
more openly.
!!! If you don’t see template editor tab and you need one, send e-mail to
Nsn, Bts I&V Ta Support (bts_i&[email protected]) !!!

10.1. V2 template format

V2 template format uses xkt (xml kpi template) extension and is pure xml text file.
Template file can be edited with any text editor, xml editor or KPI Reporter.

Example template in chapter 12.

10.1.1. Template format version history

Ver. Reporter ver. Description
0 222 Original version
253 [#16326] Version history in KPI template
[#16242] Possibility to create svg based images from
KPIData
256 [#16612] Possibility to define how many items is show /
period in worst items report
1 270 [#16870] Possibility to map specific attempt from attempt list
to specific kpi.
[#16886] Warning message if one is saving older template
editor version than the template is created.
2 336-> [#20124] Possiblity to select grouping objects/Template
40/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

10.2. Template editor components

Template editor can be used to edit or create new v2 templates. It cannot edit v1
templates. Only templates located in common app path are shown in template list.

Common app path:

 Windows XP: C:\Documents and Settings\All Users\Application Data\ Nokia
Siemens Networks\KPIReporter\Templates
 Windows 7: C:\ProgramData\Nokia Siemens Networks\ KPIReporter\Templates

10.2.1. Toolbar
 New: Create new template. After clicking this button filename is asked.

 Save: Save current template

 Save As: Save current template with different filename
 Compile to kpi format: Compiles template to v1 format. This file cannot be
edited with template editor.
 Delete: Delete current template.
!!! Template file is delete so be sure that you delete correct template !!!
 Template: Select used template from the combobox.
!!! Changes are lost from current template when template is changed. !!!
 Refresh: Refresh template list.
 Release: Selected release defines what counters and measurements are
shown.
 Show Kpi editor: If checked then kpi editor panel is shown.
 Show preview: If checked then preview panel is shown.
 Auto refresh: If checked then preview graph is updated when group or kpi
is selected.
41/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

10.2.2. Template treeview

 Version: Version number that is shown after template name in

comboboxes.
 Version history: Possibility to save changes done to template in different
versions.
 Single KPI Charts: Simple kpi’s list can contain following types of charts:
o kpi that is shown in extra counters sheet
o kpi that is shown in own sheet (Isgroup = true). KPI name = sheet
name
o kpi and attempt counter in own sheet (attempt counter is defined.
KPI name = sheet name
 Groups: group is always shown in own sheet in excel. Group can contain
multiple attempts and kpi’s that has same kind of report type (ex.
Successratio)
o Attempts: List of attempt counters / kpi’s that are shown normally in
columns
o KPIList: List of counters / kpi’s that are shown normally in lines.
 Temporary table list: It is possible to create “new” measurements by
filtering out unwanted data.
 Template settings: Possibility to change template level settings.
 Count: Shows the count of counter/kpi’s in the template. Counter value
cannot exceed aprx. 254 if Excel report is used (Excel 2003 format has
limitation of 255 columns in one sheet).
 Multiselect: Adds checkboxes in the start of each row.
 Delete checked: This will remove all counters/kpi’s in the list that has been
checked (after multiselect)
42/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

KPI context menu

 Add: Add new kpi from the scratch

 Add KPI: Select kpi from the list exported from Rise (BSC list is not got
from RISE at the moment)

o Check wanted kpi’s from the list

 Edit User KPIs: Edit list of user defined and saved KPI’s
43/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

 Add counter: Select counter from counter list exported from Rise

o Select first desired measurement and then check desired

counters.
!!! There are measurements that are not supported by the
KPIReporter !!!
o Select all: select all counters from one measurement
o Deselect all: deselect all counters.
o Find what: Set search words that are tried to find from all the
counters. Filtered list is then shown in counter list.
o Find: Start the search (can also be triggered with enter in
textbox)
o Clear: Clear the find results.

Group context menu

 Add Group: Add new group to grouplist

44/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

Temporary table list context menu

Temporary tables can be used to filter out some values when creating kpi’s.

 Add: Add new temporary table to template

 Add TempTable: Add temptables defined in RISE

o
MeasurementName: Name to be used in formula (ex.
Sum(CellResource.c3)
o Formula: Shows formula that is currently generated from the fields.
o Select: SQL query select part
o From: SQL query from part
o Where: SQL query where part.
 Edit User TempTables: Edit list of user defined temptables.
45/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

Template settings

Template settings can be used to change template level settings

 Specific grouping enabled: If checked then results are grouped based

selected objects defined below.
!! NOTE !! You should only use measurement with same objects in
template
 MeasurementList: Select measurement that can be used in help to fill in
the objects. Objects included in specific measurement will be shown next to
each checkbox below.
 Fill: Measurement objects will be filled to textboxes beside the object and
will be used in reporting.
 Clear: All the fields are cleared.
 Objects that can be defined at the moment:
o dwobj1
o dwobj2
o dwobj3
o dwobj4
o dwobj5
o dwobj6
o strobj
46/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

10.2.3. Group editor panel

Group editor panel contains settings for group

 Name: Name of the group

 ReportType:
o SuccessRatio: Best value is 100%, worst value is 0%. If minimum
value is > 95% then minimum value is set to 95%

o PositiveValue: Best value is biggest positive value. Autoscaling is in

use.

o NegativeValue: Best value is biggest negative value. Autoscaling is

in use.

o FailureRatio: Best value is 0%, worst value is 100%. If maximum

value is < 5% then minimum value is set to 5%

o Stacked_Area: All kpi’s are shown as stacked area graph.

47/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

o XYScatter: Scattograph where first item from attemplist is put to x

axel instead of time and first item from kpilist is put to y axel.

o SVGImage: Svg image is text based image that are created by

replacing KPI tags from the svg xml with periods real kpi data

 Attempt bar type:

o Cluster: Multiple attempt bars are shown side by side

o Stacked: Multiple attempt bars are shown stacked in one column

 SVG Code text box: Svg code text box contains svg xml code that is used
to create svg images. Definition for the svg can be found from
http://www.w3.org/TR/SVG/. Good program for creating svg images is
InkSpace (http://inkscape.org/).
KPI / counter-data is put to images by replacing tags %<kpiname>% ex.
%072084% with periods real kpi data. KPI/counter has to be defined in
KPIList in the group that is using SVGImage reporting type.
!!! SVG image can only been seen in Template editor tab at the
moment !!!
48/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

10.2.4. KPI editor panel

Attempt KPI/Counter

Settings available in attemps list.

 Name: Name of the kpi

 Formula: Formula in counter id format (see chapter 12)
 Hyperlink: Link to kpi web page (ex. Rise link)
 Unit: result unit type (ex. %, pcs, erl, kbit/s)
 TrendLine: If selected then trendline is drawn for the graph. More
information about trend lines: http://en.wikipedia.org/wiki/Linear_regression
 Worst item report limits: It is possible to limit values to be shown in worst
items report by setting limit for attemts when the kpi is shown
o LimitType: not working at the moment
o Worst item limit: set the limitation function (ex. > 1000, < 50)

Group KPI

Settings available in group kpi list. Only addition to attempt is shown.

 Targets: it is possible to define target values for the kpi.

o Summary Target: Affecting values shown in summary sheet
 If value > Summary Target it will be shown in green.
 If value > Summary Target – Yellow size it will be
shown in yellow
 If value < Summary Target – Yellow size it will be
shown in red
o Period Target: Affecting values shown in kpi counters sheet
 If value > Period Target it will be shown in green.
 If value < Period Target it will be shown in red
o Yellow size: Affecting values shown in summary sheet. See
Summary Target.
 Attempt KPI: It is possible to define which attempt kpi are used with
specific kpi. When this mapping is used then kpi existence is checked
using this specific attempt kpi(s) instead of all attempt kpi’s in the attempt
kpi list.
49/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

Single KPI

Settings available in single KPI Charts list. Only addition to attempt and Group
KPI is shown.

 Report type: See chapter 10.2.3

 Attempt counter:
o KPI: Select attempt counter from KPI list. Will add name and formula
to advanced attempt counter settings.
o Counter: Select attempt counter from counter list. Will add name
and formula to advanced attempt counter settings.
o Disabled: There is no attempt counter in use

o Simple: Define attempt counter setting only counter id and limitation

in worst item report. Attempt name will be the counter id
 Examples: M1000C0 > 1000, 001000 > 1000

o Advanced: Define attept counter settings given the name, formula

and optionally the attempt limit.
 Attempt name: Name of the attempt
 Attempt formula: Formula in counter id format (see chapter
12)
 Attempt limit: Limitation in worst item report
50/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

10.2.5. Preview panel

Preview panel is used to show preview of the data available in database with
selected kpi / group. Preview to work you have to import data to database normally
and then select correct settings (time period, report level etc.) from the KPIReporter
tab. It is possible to create graphs in different levels:

 Network element level: All selected bts’s are used (in this example
numbers 5, 6 and 7).

 BTS level: Graphs for all selected bts’s are shown in individual tabs.

 Cell/TRX level: Graphs in cell level for all selected bts’s are shown in
individual tabs. !!! Cell/trx level reporting depends on measurement that
is used with the kpi. If measurement doesn’t contain cell/trx object then
number 0 is shown. !!!
51/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

Zooming

It is possible to zoom in and out in image. Just press left mouse button down and
then highlight the are you are interested in.

You can zoom out using zoom out buttons (1 and 2). You can also scroll the
graph with current zooming level using scrollbars (3)

Tooltip

It is possible to check point values simply hovering over the point in graph.

Context menu

 Save to File: Save image to file.

 Copy: Copy image to clipboard
 Default view: Show default view if zoomed in
 Refresh: Refresh current image (if auto-refresh is off)
52/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

11. Troubleshooting
Below are listed actions to be done in case of problems.

11.1. Program crash / program works incorrectly (bug)

1. Check that you are using the latest version of the KPIReporter. If not then
install the latest version and test if that corrects the problem. Newest version
can be found from iSource
https://isource.access.nokiasiemensnetworks.com/projects/kpireporter/.
2. If the problem still exist with latest version.
a. Crash
i. Save crash report.
ii. Check that bug is not already filed. If it is just add comment to
existing report. Attach also the crash report to that.
iii. fill bug report in iSource. Attach crash report to bug report.
https://isource.access.nokiasiemensnetworks.com/tracker/?at
id=3645&group_id=896&func=browse.
b. Program works incorrectly:
i. Start tracelog from Help -> Start tracelog
ii. Reproduce the bug
iii. Stop tracelog from Help -> Stop tracelog
iv. Check that bug is not already filed. If it is just add comment to
existing report. Attach also the tracelog to that.
v. fill bug report in iSource. Attach tracelog to bug report.
https://isource.access.nokiasiemensnetworks.com/tracker/?at
id=3645&group_id=896&func=browse.

11.2. Questions/need help how to use the program

1. Check that you have latest user manual at hand. Latest one can be found
from (KPIReporter User Guid xxx <- bigger number is better):
https://isource.access.nokiasiemensnetworks.com/docman/index.php?group
_id=896&selected_doc_group_id=1772&language_id=1
-> Check manual for answers
2. Check KPIReporter forum if there is answer to your question. If not found
write a new one:
https://isource.access.nokiasiemensnetworks.com/tracker/?group_id=896
3. -Another possibility is to send the question to resource mail box
Nsn, Bts I&V Ta Support (bts_i&[email protected]).
Forum is preferred way because it can help others in the future.
53/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

11.3. Feature request / new measurement

1. If you are unsure if the feature really doesn’t exist, check KPIReporter forum
if there is answer to your question. If not found write a new one:
https://isource.access.nokiasiemensnetworks.com/tracker/?group_id=896
2. If you are sure that this feature is new one fill in feature request in iSource.
https://isource.access.nokiasiemensnetworks.com/tracker/?atid=3648&grou
p_id=896&func=browse
Check that feature request is not already filed. If it is just add comment to
existing report.
3. If it doesn’t exist, fill new feature request. Attach any extra documentation
also to new request.

11.4. Database connection problems

Error Message Resolution
Login failed for user ‘xxxxx’…  Check that username and password
are correct.
 Check that server supports Windows
authentication if selected.
An error has occurred while  Check that server address/name is
establishing a connection to correct
server.  Check that service is started (if local
server). Control Panel ->
Administrative tools -> Services ->
MSSQLSERVER / SQL Server ->
Status should be started.

PostgreSQLServer:  Check that username and password
The connection is not open are correct.
 Check that ipaddress is correct
54/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

12. Formula definition

Following example data is used in examples when appropriate

Measurement 1000
realintervalstarttime winterval dwobj1 dwobj2 c0 c1
2011-12-16 18:00 15 1 1 72 3
2011-12-16 18:00 15 2 1 71 2
2011-12-16 19:00 15 1 1 78 5

12.1. Counter format

RNC/I-HSPA/LTE: MxxxxCxx (ex. M1000C0)

BSC: xxxyyy (ex. 001000) !! You cannot use 6 digit numbers due to conversion.
You should use 100*100 instead of 100100 example !!
Temporary table: <name of the temporary table>.c0 (ex. MCS_0.c0)

12.2. Special objects

realintervalstarttime: Measurement period start time

winterval: Measurement period in minutes
dwObj1: Bts number (not always available)
dwObj2: Cell/TRX number (not always available)
dwObj3-6: Depends on measurement (see chapter Error! Reference source not
found.)

12.3. Supported functions

12.3.1. Comparision functions
See following link for more information:
http://www.postgresql.org/docs/9.1/static/functions-comparison.html

12.3.2. Aggregate functions

See following link for more information:
http://www.postgresql.org/docs/9.1/static/functions-aggregate.html

Function: sum
Explanation: sum over grouping period
Example: sum(M1000C0) = 72 + 71 + 78 = 221

Function: avg
Explanation: average over period
Example: avg(M1000C0) = (72 + 71 + 78)/3 = 73.66

Function: max
Explanation: maximum value
Example: max(M1000C0) = 78
55/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

Function: min
Explanation: minimum value
Example: min(M1000C0) = 71

Function: count
Explanation: amount of rows (see also chapter 12.6)
Example: count(realintervalstarttime) = 3

12.3.3. Mathematical functions

See following link for more information and functions. !!! Calculations are normally
double values (dp) so you can only use functions that have dp on them)
http://www.postgresql.org/docs/9.1/static/functions-math.html

Function: *
Explanation: multiplication
Example: sum(M1000C0)*3 = 221 * 3 = 462

Function: /
Explanation: division
Example: sum(M1000C0)/3 = 221 / 3 = 73.66
sum(M1000C0)/sum(M1000C1) = 221 / 10 = 22.1
Note: aggregation functions cannot be used over division
(ex. sum(M1000C0/M1000C1) doesn’t work)

Function: log
Explanation: base 10 logarithm
Example: log(sum(M1000C0)) = ~2,344
Function: power(10.0, b)
Explanation: 10.0 raised to the power of b
Example: power(10.0, log(sum(M1000C0))) = 211

12.4. Case - structure

See following link for more information:
http://www.postgresql.org/docs/9.1/static/functions-conditional.html

It is possible to use case structure to show kpi only in specific situation. Following
syntaxes can be used.

Syntax: CASE xxx WHEN m THEN yyyy END

Example: CASE M1000C0 WHEN 1 THEN sum(M1000C1) END

Syntax: CASE WHEN xxx > m THEN yyyy ELSE zzzz END
Example: sum(CASE WHEN M1000C0 > 1 THEN M1000C1 ELSE 0 END)

Syntax: CASE WHEN xxx > m THEN (yyyy)/(wwww) ELSE zzzz END
Example: sum
(
CASE WHEN M1000C0 > 1
THEN (M1000C1)/(M1000C0)
ELSE 0 END
)
Note: Paranthesis are needed in then - clause if division is used
56/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

12.5. Decode structure

At the moment there is limited support for Oracle style decode structures.
KPIReporter supports following syntaxes:

decode(<case>, <when>, <then>)

decode(<case>, <when>, <then>, <else>)

These are compiled to case - structure automatically. There are however

limitations:
 Then clause cannot contain any parenthesis: ( )
 Else clause cannot contain any parenthesis: ( )
If paranthesis are needed convert decode structure manually to case – structure
(see chapter 12.4)

12.6. Distinct

Distinct keyword can be used to count unique row count example how many
unique measurement periods there are.

Example: count(distinct realintervalstarttime)

57/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

12.7. Examples
12.7.1. RNC/I-HSPA/LTE
LTE_5001a/Cell Availability excluding BLU
100*sum(M8020C3)/sum(M8020C6-M8020C4)

Average CS Erlang
sum(M1001c199+ M1001c368* 64 / 12.2 + M1001c370* 14.4 / 12.2
+ M1001c372* 57.6 / 12.2)/(sum(winterval))* 100 * 60

12.7.2. BSC
ulq_2a/Bad UL cumulative quality % in class 5,6,7
100 *(sum(014007+ 014008+ 014009))/((sum(014002+ 014003+
014004+ 014005+ 014006+ 014007+ 014008+ 014009)))

BAD FER - AMR HR 7.5

100*(sum(case 077002 when 5 then 077016 + 077017 + 077018 +
077019 + 077020 + 077021 + 077022 else 0 end))/ (sum(077015 +
077016 + 077017 + 077018 + 077019 + 077020 + 077021 +
077022)+ 0.000001)
58/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

12.8. FAQ

 Can I use 7-digit id's used ex. 050 bsclevelclearcode measurement.

o KPIReporter doesn’t fully support the 050 measurement at the moment.
KPIReporter assumes that counter id’s goes from 0 to x (ex. 0 to 250). In
050 measurement you have however counter id’s that match state id’s and
they are all over between 300 – 999. There is plan to implement so called
mapping feature in the future where you could use 500300 id instead of
050000. There is readymade template that can be used before new
feature is ready.
 “You cannot use 6 digit numbers due to conversion. You should use
100*100 instead of 100100 example”. What does this means?
o It just mean that if you have number instead of counter that have 6
numbers it will be tried to convert and errors will come. Ex. sum(100001) *
100000 will be converted to sum(isnull(dfca.c1, 0)) * isnull(dfca.c0, 0)
instead of sum(isnull(dfca.c1, 0)) * 100000
 What means if counter has _1 at the end (ex. 002046_1)? How this should
be handled?
o It usually means that that NetAct saves result of the nominator and
denominator to nominator field when importing data. KPIReporter however
saves both nominator and denominator to database so 002046_1 should
be converted as 002046/(002047) when used in KPIReporter.
 How to create formula that contains counting rows in specific conditions
ex. ava_72 in BSC.

Nameformat:
------------------------------------------------------------
count(*)
where (a.ave_tch_busy_full + a.ave_tch_busy_half) >= 0.2 and
(a.ave_gprs_channels_sum > 0) and
(b.packet_ch_req = 0 and c.tch_call_req > 10)

IDFormat:
------------------------------------------------------------
count(*)
where (002046_1 + 002048_1) >= 0.2 and
(002061 > 0) and
(072082 = 0 and 057028 > 10)

o This can be handled with case clause which gives 1 when condition
is met and zero when not. Then these values are summed together.

sum (
case when
((002046 / (002047) + 002048 / (002049)) >=0.2) and
(002061 > 0) and (072082 = 0) and (057028 > 10)
then 1 else 0 end
)

 In example above there is 002046 / (002047). Why there are those brackets
beside 002047.
o Denominator needs to be explicitly defined so that tool can add zero
checking for denominator. !!! Formula will work unless division with zero
situation occurs. !!!
59/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

 Is it possible to report kpi’s based on Coding scheme measurement.

Coding scheme contains multiple rows / bts with different coding scheme
value.
o Coding scheme value is saved to dwobj4 in database. To utilize this
column on have to first create temporary tables / coding scheme and then
use those temporary tables in kpi’s.

Example trf_214a/EGPRS UL payload data:

sum(
decode(coding_scheme,1,(xx)*22,0)+ ;MCS-1
decode(coding_scheme,2,(xx)*28,0)+ ;MCS-2
decode(coding_scheme,3,(xx)*37,0)+ ;MCS-3
decode(coding_scheme,4,(xx)*44,0)+ ;MCS-4
decode(coding_scheme,5,(xx)*56,0)+ ;MCS-5
decode(coding_scheme,6,(xx)*74,0)+ ;MCS-6
decode(coding_scheme,7,(xx/2)*112,0)+ ;MCS-7
decode(coding_scheme,8,(xx/2)*136,0)+ ;MCS-8
decode(coding_scheme,9,(xx/2)*148,0) ;MCS-9
) / 1024

where xx = (UL_RLC_BLOCKS_IN_ACK_MODE +
UL_RLC_BLOCKS_IN_UNACK_MODE)

Counters from table(s):

p_nbsc_coding_scheme

First we have to define temporary table / coding scheme. This is done by

going temporary table list and click add. Then set values to following
Measurement name: mcs_x (x = 1-9)
Select: *
From: CodingScheme
Where: dwObj4 = x (x= 1-9, same as measurement name.

When temporary tables are added we can create the kpi. See formula
example below.
sum
(
(mcs_1.c2 + mcs_1.c3)*22 + (mcs_2.c2 + mcs_2.c3)*28 +
(mcs_3.c2 + mcs_3.c3)*37 + (mcs_4.c2 + mcs_4.c3)*44 +
(mcs_5.c2 + mcs_5.c3)*56 + (mcs_6.c2 + mcs_6.c3)*74 +
(mcs_7.c2 + mcs_7.c3)*56 + (mcs_8.c2 + mcs_8.c3)*68 +
(mcs_9.c2 + mcs_9.c3)*74
)/ 1024
!!! You don’t have to care about decode part cause KPIReporter is handling
that one automatically.!!!
60/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

12.9. Template file example

<?xml version="1.0" encoding="utf-8"?>
<KPITemplate xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<NetworkElement>LTE</NetworkElement>
<VersionNumber>0.1</VersionNumber>
<KPIList>
<!--LTE_5001a/Cell Availability excluding BLU-->
<KPI>
<!--true/false, If IsGroup is set to true then kpi is drawn to own chart page. Default: false-->
<IsGroup>true</IsGroup>
<ReportType>SuccessRatio</ReportType>
<Name>LTE_5001a/Cell Availability excluding BLU</Name>
<LimitType>MeasurementPeriod</LimitType>
<WorstItemLimit>&lt;90</WorstItemLimit>
<SummaryTarget>0</SummaryTarget>
<PeriodTarget>0</PeriodTarget>
<YellowSize>0</YellowSize>
<Formula>100*sum(M8020C3)/sum(M8020C6-M8020C4)</Formula>
<Hyperlink />
<Unit>%</Unit>
</KPI>
<!--LTE_5058a/Total HO Success Ratio, inter eNB-->
<KPI>
<!--SuccessRatio = Best value is 100%, line graph
FailureRatio = Best value is 0%, line graph
PositiveValue = Best value is positive integer, line graph
NegativeValue = Best value is negative integer, line graph
Stacked_Area = All KPI's in current group are put to area graph.
XYScatter = Create scattograph: attempt kpi in x axcel and first kpi from kpi list in y axcel
Throughput = Best value is positive integer, line graph (OBSOLETE: use PositiveValue instead)
Stacked_FailureRatio = All KPI's in current group are put to area graph (OBSOLETE: use Stacked_Area instead).-->
<ReportType>SuccessRatio</ReportType>
<Name>LTE_5058a/Total HO Success Ratio, inter eNB</Name>
<Formula>100*sum(M8014C7) / sum(M8014C0)</Formula>
<LimitType>MeasurementPeriod</LimitType>
<!--Worst limit for kpi ex. > 100 = &gt; 100, < 50 = &lt; 50 -->
<WorstItemLimit>&lt;90</WorstItemLimit>
<!--Amount of tries/Result. ex. MxxxCx&gt;100 (>), MxxxCx&lt;50 (<) aggregation formula is always sum-->
<WorstItemCount>M8014C0&gt;1000</WorstItemCount>
<Unit>%</Unit>
<!--Reporting groups where specific KPI is used.-->
<ReportingGroups>
<ReportingGroup>Acceptance KPI</ReportingGroup>
<ReportingGroup>Troubleshooting KPI</ReportingGroup>
</ReportingGroups>
</KPI>
<!--LTE_5043a/Total HO Success Ratio, intra eNB-->
<KPI>
<ReportType>SuccessRatio</ReportType>
<Name>LTE_5043a/Total HO Success Ratio, intra eNB</Name>
<Formula>100*sum(M8009C7) / sum(M8009C2)</Formula>
<LimitType>MeasurementPeriod</LimitType>
<WorstItemLimit>&lt;90</WorstItemLimit>
<AttemptName>M8009C0/HO Attempts, intra eNB</AttemptName>
<AttemptFormula>sum(M8009C0)</AttemptFormula>
<AttemptLimit>&gt;1000</AttemptLimit>
<Hyperlink>http://www.address.com/kpi</Hyperlink>
<Unit>%</Unit>
</KPI>
</KPIList>
<GroupList>
<!--Data Radio Bearer Setup-->
<Group>
<Name>Data Radio Bearer Setup</Name>
<ReportType>SuccessRatio</ReportType>
<!--Reporting groups where specific KPI is used.-->
<ReportingGroups>
<ReportingGroup>Acceptance KPI</ReportingGroup>
<ReportingGroup>Troubleshooting KPI</ReportingGroup>
</ReportingGroups>
<AttemptList>
<!--M8007C0/Data Radio Bearer Attempts-->
<KPI>
<Name>M8007C0/Data Radio Bearer Attempts</Name>
<Formula>sum(M8007C0)</Formula>
<WorstItemLimit>&gt;1000</WorstItemLimit>
<Unit>pcs</Unit>
</KPI>
</AttemptList>
<KPIList>
<!--LTE_5003a/Data Radio Bearer Setup Success Ratio-->
<KPI>
<Name>LTE_5003a/Data Radio Bearer Setup Success Ratio</Name>
<ReportType>SuccessRatio</ReportType>
<SummaryTarget>0</SummaryTarget>
<PeriodTarget>0</PeriodTarget>
<YellowSize>0</YellowSize>
<Formula>100*sum(M8007C1) / sum(M8007C0)</Formula>
<WorstItemLimit>&lt;90</WorstItemLimit>
<Hyperlink />
<Unit>%</Unit>
</KPI>
</KPIList>
</Group>
<!--S1 Init Cont Failure Ratio-->
<Group>
<Name>S1 Init Cont Failure Ratio</Name>
<ReportType>Stacked_Area</ReportType>
61/61 Specification User guide for KPI Reporter

Janne Kolehmainen 8.10.2012, v336 ( r2739)

NWS TS SysS Mgmt FI For internal use

<ReportingGroups>
<ReportingGroup>Acceptance KPI</ReportingGroup>
<ReportingGroup>Troubleshooting KPI</ReportingGroup>
</ReportingGroups>
<AttemptList>
<!--M8000C0/Initial Context Setup requests-->
<KPI>
<Name>M8000C0/Initial Context Setup requests</Name>
<Formula>sum(M8000C0)</Formula>
<Hyperlink>http://esodts052.emea.nsn-net.net:8080/ContentViewer/RISEViewer?_shortcut=3252</Hyperlink>
<Unit>pcs</Unit>
<!--Reporting groups where specific KPI is used.-->
<ReportingGroups>
<ReportingGroup>Acceptance KPI</ReportingGroup>
<ReportingGroup>Troubleshooting KPI</ReportingGroup>
</ReportingGroups>
<!--Settings for worst items reporting. If this tag is empty (or not existing) then settings from UI is used -->
<WorstItemsReporting>
<!--Amount of tries/Result. ex. > 100 = &gt; 100, < 50 = &lt; 50 -->
<Limit>&gt;100</Limit>
<!--MeasurementPeriod/ReportingPeriod-->
<LimitType>MeasurementPeriod</LimitType>
</WorstItemsReporting>
</KPI>
</AttemptList>
<KPIList>
<!--LTE_5093a/radio network layer failure (RNL) cause-->
<KPI>
<ReportType>FailureRatio</ReportType>
<Name>LTE_5093a/radio network layer failure (RNL) cause</Name>
<Formula>100*sum(M8000C2) / sum(M8000C0)</Formula>
<Hyperlink>http://esodts052.emea.nsn-net.net:8080/ContentViewer/RISEViewer?_shortcut=3255</Hyperlink>
<Unit>%</Unit>
</KPI>
<!--LTE_5094a/radio transport layer failure (TRPORT) cause-->
<KPI>
<ReportType>FailureRatio</ReportType>
<Name>LTE_5094a/radio transport layer failure (TRPORT) cause</Name>
<Formula>100*sum(M8000C3) / sum(M8000C0)</Formula>
<Hyperlink>http://esodts052.emea.nsn-net.net:8080/ContentViewer/RISEViewer?_shortcut=3256</Hyperlink>
<Unit>%</Unit>
</KPI>
<!--LTE_5095a/resource failure (RESOUR) cause-->
<KPI>
<ReportType>FailureRatio</ReportType>
<Name>LTE_5095a/resource failure (RESOUR) cause</Name>
<Formula>100*sum(M8000C4) / sum(M8000C0)</Formula>
<Hyperlink>http://esodts052.emea.nsn-net.net:8080/ContentViewer/RISEViewer?_shortcut=3254</Hyperlink>
<Unit>%</Unit>
</KPI>
<!--LTE_5096a/other failure (OTH) cause-->
<KPI>
<ReportType>FailureRatio</ReportType>
<Name>LTE_5096a/other failure (OTH) cause</Name>
<Formula>100*sum(M8000C5) / sum(M8000C0)</Formula>
<Hyperlink>http://esodts052.emea.nsn-net.net:8080/ContentViewer/RISEViewer?_shortcut=3257</Hyperlink>
<Unit>%</Unit>
</KPI>
</KPIList>
</Group>
</GroupList>
<TemporaryTableList>
<TemporaryTable>
<MeasurementName>cellresource</MeasurementName>
<Formula>Select * from cellresource where dwObj2 &lt;&gt; '300000000'</Formula>
</TemporaryTable>
</TemporaryTable>
</TemporaryTableList>
</KPITemplate>