Manual - SQKPICreator

8/10/2019 Manual - SQKPICreator

http://slidepdf.com/reader/full/manual-sqkpicreator 1/15

SQKPI Creator

User ManualOctober 2006

SwissQual® License AGBaarerstrasse 78CH-6301 ZugSwitzerland

Internet: http://www.swissqual.com Office: +41 32 686 65 65Fax: +41 32 686 65 66

Part Number: 16-100-200511 REV 1

http://www.swissqual.com/

http://www.swissqual.com/



Copyright © 2000 - 2008 SwissQual AG. All rights reserved.

No part of this publication may be copied, distributed, transmitted, transcribed, stored in a retrieval system,or translated into any human or computer language without the prior written permission of SwissQual AG.

SwissQual has made every effort to ensure that eventual instructions contained in the document areadequate and free of errors and omissions. SwissQual will, if necessary, explain issues which may not be

covered by the documents. SwissQual’s liability for any errors in the documents is limited to the correction oferrors and the aforementioned advisory services.

When you refer to a SwissQual technology or product, you must acknowledge the respective text or logotrademark somewhere in your text.

SwissQual®, Seven.Five®, SQuad®, QualiPoc®, NetQual®, VQuad® as well as the following logos areregistered trademarks of SwissQual AG.

Diversity™, NQDI™, VMon™, NiNA™, NiNA+™, NQView™, NQComm™, NQTM™, QualiWatch-M™,QualiWatch-S™, NQAgent™, NQWeb™, QPControl™, SystemInspector™, Diversity Unattended™ are

trademarks of SwissQual AG.

SwissQual acknowledges the following trademarks for company names and products:

Adobe®, Adobe Acrobat®, and Adobe Postscript® are trademarks of Adobe Systems Incorporated.

Apple is a trademark of Apple Computer, Inc.

DIMENSION®, LATITUDE®, and OPTIPLEX® are registered trademarks of Dell Inc.

ELEKTROBIT® is a registered trademark of Elektrobit Group Plc.

Google® is a registered trademark of Google Inc.

Intel®, Intel Itanium®, Intel Pentium®, and Intel Xeon™ are trademarks or registered trademarks of IntelCorporation.

INTERNET EXPLORER®, SMARTPHONE®, TABLET® are registered trademarks of Microsoft Corporation.

Java™ is a U.S. trademark of Sun Microsystems, Inc.

Linux® is a registered trademark of Linus Torvalds.

Microsoft®, Microsoft Windows®, Microsoft Windows NT®, and Windows Vista® are either registeredtrademarks or trademarks of Microsoft Corporation in the United States and/or other countries U.S.

NOKIA® is a registered trademark of Nokia Corporation.

Oracle® is a registered US trademark of Oracle Corporation, Redwood City, California.

SAMSUNG® is a registered trademark of Samsung Corporation.

SIERRA WIRELESS® is a registered trademark of Sierra Wireless, Inc.

TRIMBLE® is a registered trademark of Trimble Navigation Limited.

U-BLOX® is a registered trademark of u-blox Holding AG.

UNIX® is a registered trademark of The Open Group.



SQKPI Creator User Manual

© 2000 - 2008 SwissQual AG

Contents | 3

Contents

1 About this Guide................................................................................................................5

Introduction..........................................................................................................................5

Related Documentation .......................................................................................................5

2 Creating an Event ..............................................................................................................6

General Section...................................................................................................................6

ID.....................................................................................................................................6

Name...............................................................................................................................7

Type.................................................................................................................................7

Version ............................................................................................................................7

Active...............................................................................................................................7

Sources Section...................................................................................................................7

Type L3............................................................................................................................8

Any Other Type ...............................................................................................................9

Example 1 .......................................................................................................................9

Example 2 .......................................................................................................................9

Example 3 .....................................................................................................................10

Overview Section...............................................................................................................10

3 Creating a KPI ..................................................................................................................11

General Section.................................................................................................................11

ID and Name .................................................................................................................11

Start Event.....................................................................................................................12

End Event......................................................................................................................12

Options Section .................................................................................................................13

Overview Section...............................................................................................................15

Figures

Figure 2-1 New Event .......................................................................................................................6

Figure 2-2 Event creation .................................................................................................................6

Figure 2-3 General parameters ........................................................................................................7

Figure 2-4 Layer 3 Source parameters.............................................................................................8

Figure 2-5 Other Source parameters................................................................................................9

Figure 2-6 Overview .......................................................................................................................10

Figure 3-1 New KPI ........................................................................................................................11

Figure 3-2 KPI Creation..................................................................................................................11

Figure 3-3 General parameters ......................................................................................................12

Figure 3-4 Start Event.....................................................................................................................12

Figure 3-5 End Event......................................................................................................................13

Figure 3-6 Options ..........................................................................................................................13





4 | Contents

Figure 3-7 Overview .......................................................................................................................15





Chapter 1 • About this Guide | 5

1 About this Guide

IntroductionThis User’s Manual describes the usage and the functionality of the SQKPICreator. This tool canbe used to create events and KPI’s for the use in NQDI and Diversity.

The manual is divided into the following sections:

• Introduction

• Creating an event

• Creating a KPI

Related Documentation• For a brief description of NetQual see: ‘Brief Description - NetQual.pdf ’

• For a description of NQDI see: ‘Manual-NQDI.pdf ”





6 | Chapter 2 • Creating an Event

2 Creating an Event

Starting the event creation:

Right-click in the left-hand tree and select the menu “New event”:

Figure 2-1 New Event

On the right-hand side the event creation frame opens.

Figure 2-2 Event creation

General Section

IDThe ID parameter is automatically generated. The ID can’t be changed and ensures, that everygenerated event has a unique identification.





Chapter 2 • Creating an Event | 7

NameThe name parameter can be chosen freely, although the name has to be unique.

Type

The type parameter defines, which kind of event should be created. The following options areavailable:

L3 : The generated event is a GSM or WCDMA layer 3 event. All possible layer 3 valuesare available for this event.

Ethereal: The generated event is handling ethereal trace messages.

Marker: The generated event is handling marker messages.

Protocol: The generated event is handling protocol messages.

Trace: The generated event is handling trace messages.

VersionThe version parameter is automatically set and will help converting old event files, if new featuresare added to the SQKPICreator.

ActiveThe active parameter specifies if the event will be written as a message (active) or just used forKPIs to be generated (inactive).

Figure 2-3 General parameters

Sources SectionDepending on which Type you have selected in the previous section the sources screen has anindividual view.






Type L3

Figure 2-4 Layer 3 Source parameters

Main Group

The main group contains a selection of the layer 3 base types (RR, GMM, RRC, and so on).

You have to choose an option before the other controls are activated.

Sub group: The sub group contains the sub types of the chosen item in the “Main group”.Chosen one of these types will further decrease the number of choices in the “Item” list.

Item: This parameter finally defines, which layer 3 item should be chosen as a source for this

event. After selecting the desired item, press the “Add” button to add the item to the list.Set item filter: After selecting a Main group, you have the possibility to decrease the number ofoptions in the “Item” list by entering the starting letters of your desired item into the “Set item filter”box. Pressing the “Clear filter” button will remove all the letters inside the box.

Add: Adds the selected item to the list. This item will be used as a trigger for the generated event.

Remove: Remove the selected item from the list.

Clear filter: Clears the edit box for filtering items in the “Item” list.





Chapter 2 • Creating an Event | 9

Any Other Type

Figure 2-5 Other Source parameters

Item:

This parameter defines, which text should be looked up in the chosen category.

Type marker: The entered text must exactly match the marker, which is sent (including casesensitivity).

Type ethereal, trace, and protocol: The entered text can be found at any place inside the sentmessage.

If a text is entered using commas, the sent messages will be parsed for the first defined item, then

for the second one, and so on. The sent message must have the same order of words as definedin the text

Example 1Type: Marker

Entered Text: DIAL

1. Marker text occurred: DIALStatus: Successful

2. Marker text occurred: DialStatus: Failed

3. Marker text occurred: DIAL STARTStatus: Failed

Example 2Type: Protocol

Entered text: >21 FTP

1. Protocol message received: >21 FTPStatus: Successful

2. Protocol message received: >21 FTP onlineStatus: Successful

3. Protocol message received: US >21 FTP onlineStatus: Successful






4. Protocol message received: >21 ftpStatus: Successful

5. Protocol message received: > AB21 FTPStatus: Failed

Example 3Type: Protocol

Entered text: >21 FTP, >20 IO

1. Protocol message received: >21 FTP ABC >20 IOStatus: Successful

2. Protocol message received: ABC >21 FTP >20 IO DEFStatus: Successful

3. Protocol message received: >20 IO >21 FTPStatus: Failed

Overview Section

Figure 2-6 Overview

On the overview section you see all settings and modification you have chosen in the previoussections.

If you are in the overview section than a save button appears on the bottom of the application.

After pressing the button the configured event will be saved.





Chapter 3 • Creating a KPI | 11

3 Creating a KPI

Starting the KPI creation:

Right-click in the left-hand tree and select the menu “NewKPI”.

Figure 3-1 New KPIOn the right-hand side the KPI creation frame opens.

Figure 3-2 KPI Creation

General Section

ID and NameThe ID parameter is automatically generated. The ID can’t be changed and ensures, that everygenerated KPI has a unique identification.

Parameter name

The name parameter can be chosen freely, although the name has to be unique.





12 | Chapter 3 • Creating a KPI

Figure 3-3 General parameters

Start EventIn this section the user chooses the event(s), which will start the KPI.

Figure 3-4 Start Event

Start Events

A selection of existing events, which will start this KPI.

Half t ime start event:

To adjust the written start time of a KPI it’s possible to define a half time event. If one of the startevents was found, then the KPI start time is defined as the half time between this one and thechosen half time event.

End EventIn this section the user chooses the end event(s) which will end the KPI.






Figure 3-5 End Event

End events

A selection of existing events which will end this KPI. The box error code has also to be chosen,to ensure a fully configured ending condition. After selecting both an end event and an error code,press the add button to add this end event configuration to the list.

Half time end event

Like the

Half time start event, the half time end event can be configured to change the end time of anevent.

Save first end event

Normally if an event is written at the test or session end (see Written on) the last occurred endevent time will be chosen for the end time of the KPI. If this box is checked, then the first occurredend event time will be chosen.

Options SectionFinally in this section some additional configuration can be defined.

Figure 3-6 Options

Written on

Defines when the KPI will be written. Options are:





14 | Chapter 3 • Creating a KPI

immediately : The KPI will be written, as soon as the end event occurs

sessionEnd : The KPI will be written at the end of the session

testEnd : The KPI will be written at the end of the test

Incomplete on

This parameter defines, when a KPI will be written as failed (incomplete).

timeout: A time (in milliseconds) can be specified, after which the KPI will be marked asincomplete

testEnd: If the KPI is not complete at the end of a test, it will be marked as incomplete.

sessionEnd: If the KPI is not complete at the end of a session, it will be marked as incomplete.

NewStart: If a valid start event of this KPI occurs a second time, than it will be marked asincomplete. Furthermore the new start event will be chosen for the start of a new KPI of this type.

Direction

With this parameter it is possible to choose the direction in which the start and end events mustoccur to be accepted for this KPI.

Data test type

With this parameter a data test type can be defined to only allow start and end events while thisspecific data test is running.

Possible data test types are:

• Ping

• PingTrace

• FTP

• HTTP

•

UDP• UDPDL

• Email

• GPRSAttach

• GPRSDetach

• PDPActivation

• PDPDeactivation

• GPRSAvailability

• HTTPBrowser

• EMailSend

• EMailReceive

• WAP

• MMSSend

• MMSReceive

• SMSSend

• SMSReceive

• UDPPlus

• MsgReceive






Overview Section

Figure 3-7 Overview

On the overview section you see all settings and modification you have chosen in the previoussections.

If you are in the overview section than a save button appears on the bottom of the application. After pressing the button the configured KPI will be saved.

Documents

Manual - SQKPICreator