0% found this document useful (0 votes)
54 views

Pro Traq User Manual

This user manual describes how to configure and use ProTraq network software. It provides overviews of the main interface, configuration options like adding corners, lines, columns and alarms. It also describes the types of statistics and alarms that can be generated.
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
54 views

Pro Traq User Manual

This user manual describes how to configure and use ProTraq network software. It provides overviews of the main interface, configuration options like adding corners, lines, columns and alarms. It also describes the types of statistics and alarms that can be generated.
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 32

User’s 

Manual

PROTRAQ
NETWORK SOFTWARE PLATFORM
1Doc-To-Help Standard Manual

Tekelec France
Headquarters Mulhouse Office Trappes Office
Le Meltem Parc de la Mer Rouge 46 avenue des Frères Lumière
2 allée des Séquoias 20E rue Salomon Grumbach 78190 Trappes (France)
69578 Limonest Cedex (France) 68059 Mulhouse Cedex (France)
Tel: +33 4 3749 7530 Tel: +33 3 8933 4900 Tel: +33 1 3013 2085
Fax: +33 4 3749 7575 Fax: +33 3 8933 4939 Fax: +33 1 3013 1727
E-mail: [email protected] Website: www.tekelec.com

Tekelec France, an incorporated company with capital of 1,518,070 euros – Registration no. 403 384 191 RCS Lyon NAF 721 Z

2 This document is confidential and remains the property of Tekelec France. It must not be reproduced or communicated to a third party
without the prior written agreement of Tekelec France.
In accordance with its policy of constant product improvement, Tekelec France reserves the right to change the
information in this manual without notice.

No part of this manual may be photocopied or reproduced in any form without the prior written permission of
Tekelec France.

If you have difficulty using ProTraq, we recommend that you:


1. Check the help function
2. Consult this manual
3. Contact technical support:

Tel.: +33 3 8933 5400


Fax: +33 3 8933 4939
Hotline: [email protected]

All product names mentioned are trademarks of their respective owners.

This manual is in accordance with ProTraq, release 2.0.

2 This document is confidential and remains the property of Tekelec France. It must not be reproduced or communicated to a third party
without the prior written agreement of Tekelec France.
Document history
Edition Date Status Author
1.0 14/05/05 Document creation JFM
2.0 28/09/05 Update JFM

Document Status: Edition 2.0

Prepared by: JFM

Reviewed by:

Approved by:

2 This document is confidential and remains the property of Tekelec France. It must not be reproduced or communicated to a third party
without the prior written agreement of Tekelec France.
(This page left blank intentionally)

2 This document is confidential and remains the property of Tekelec France. It must not be reproduced or communicated to a third party
without the prior written agreement of Tekelec France.
Table of contents
1.Overview..................................................................................................7
1.1Thanks for choosing ProTraq !.......................................................................................7
1.2Outline of this manual....................................................................................................7
1.3Conventions....................................................................................................................8
1.4System requirements.......................................................................................................8
1.5Abbreviations..................................................................................................................8
1.6Glossary..........................................................................................................................9

2.Configuring ProTraq.............................................................................11
2.1Main view.....................................................................................................................11
2.1.1Configuration management.........................................................................11
2.1.2Session management...................................................................................12
2.2Configuration view.......................................................................................................13
2.2.1Corner management....................................................................................13
2.2.2Line management........................................................................................13
2.2.3Column management..................................................................................14
2.2.4Alarm management.....................................................................................14
2.3Railway.........................................................................................................................15
2.4Menus...........................................................................................................................15
2.4.1Configuration menu....................................................................................15
2.4.2File menu.....................................................................................................16
2.4.3Options menu..............................................................................................16
2.4.4Help menu...................................................................................................17
2.4.5Railway........................................................................................................17
2.5Procedures....................................................................................................................18
2.5.1New corner..................................................................................................18
2.5.2New line......................................................................................................18
2.5.3No data filtering line type...........................................................................18
2.5.4Data filtering line type................................................................................19
2.5.5Top selection line type................................................................................21
2.5.6New column................................................................................................22
2.5.7Simple data counter column type................................................................23
2.5.8Filtered data counter column type...............................................................23
2.5.9Cumulative counter column type................................................................24
2.5.10Ratio column type.....................................................................................25
2.5.11Field column type......................................................................................26
2.5.12Filter definition..........................................................................................27
2.5.13Alarms.......................................................................................................28

3.Results of ProTraq................................................................................30
3.1Principle........................................................................................................................30
3.2The statistics.................................................................................................................30

Table of contents ProTraq user's manual 5 / 32


3.3The alarms....................................................................................................................32

Overview ProTraq user's manual 6 / 32


1.Overview

1.1Thanks for choosing ProTraq !


Congratulations ! You have just acquired ProTraq, a tool developed by
Tekelec.
This product generates call statistics and alarms. You can specify what kinds of
records you wish to count and define the counter thresholds. You can link this
information to a Data Server.
As a result, you get:
• a statistics session containing records for each period of accounting and for
each kind of record;
• alarm events sent, through the ProTraq dedicated management agent, to a
TMN platform.
The records kinds are defined with the help of filters. Filters can be based on
field and value comparisons (e.g.: number called, calling number, cause value,
conversation time, etc.).

1.2Outline of this manual


ProTraq’s User Manual is divided into the following sections:
Chapter 1 Overview
This introductory chapter presents ProTraq. It provides
details on the conventions used throughout this Manual, the
organization of this document, and the abbreviations used. A
glossary has also been included.
Chapter 2 Configuring ProTraq
This chapter explains how to access ProTraq. You will learn
how to start ProTraq Configuration to take full advantage of
the system’s user-friendly environment, letting you define the
statistics you need.
Chapter 3 Results of ProTraq

Table of contents ProTraq user's manual 7 / 32


This chapter contains examples of the statistics and alarms
you can set.

1.3Conventions
This Manual uses a number of conventions to help you better understand
ProTraq:
• Keyboard shortcuts – such as letters used when activating a menu, choosing
a command, selecting a given option in a dialog box, etc. - are underlined
and written in bold types as in Edit,or Copy.
• Italics are used to indicate function names, icons or software products such
as Ascending Order, or Word.
• References to other chapters contained in the Manual or to other modules
are written in bold types, as in Overview.
• Clickable zone such as buttons or hyperlinks are enclosed between square
braces [].
• Finally, cartoon graphics provide specific-purpose information such as:

Information: Additional explanations on a function or


topic described previously.

Warning: Denotes risks of possible misuse.

Hint: Provides useful clues on a specific function or


mode of operation.

1.4System requirements
To be fully functional, ProTraq requires the following configuration:
• A server platform with BEA Weblogic 8.1 SP4, Oracle 9+, Tekelec NSP
2.0.0 (including at least Core, Config and Portal applications and possibly
xDR Browser, ProAlarm and ProConfig applications)
• A client platform with Microsoft Internet Explorer 6+
• A data server platform with Tekelec Data Server 3.2+, Tekelec ProTraq
Library 4.3+

1.5Abbreviations
HTML HyperText Markup Language.

Overview ProTraq user's manual 8 / 32


IMSI International Mobile Subscriber Identity.
MSISDN Mobile Subscriber ISDN (Integrated
Services Digital Network).
PDF Portable Document Format.
TMN Telecommunications Management Network.
xDR All the Detailed Record types.
XML EXtensible Markup Language.

1.6Glossary
CDR/TDR session This is a Data Server database containing
call/transaction data records.
Configuration This is a file with the .FSE extension,
containing all the information needed to
produce statistics and to generate alarms.
Cumulative counter This counter agregates given fields of
records ; it can only be used in a column and
the result is an optionally scaled value. The
alarm levels for such filters are defined by
scaled values.
Exclusive filter With non-exclusive filters, every record is
compared to every filter. Exclusive filters can
reduce the number of filters any given record
is compared to. Exclusive filters
corresponding to specific records stops the
comparisons that would have been made to
the remaining filters for that record.
Filtering conditions A filtering condition is a comparison
expression between a field and a value; the
comparison operator depends on the field
type (it's usually <, <=, =, >=, >, <>).
Filtering expression Combines filtering conditions by using the
logical comparison operators NOT, AND
and OR. Parentheses are also permitted.
Query A query uses filtering conditions and a
filtering expression to determine what
records will be used. The queries are used in
data filtering (line) and filtered data counters
(column). They may also be used in top
selection.
Ratio This counter type defines the ratio between
two other counters. The result is expressed
as a number or a percent.

Table of contents ProTraq user's manual 9 / 32


Statistics session This is a Data Server database containing
statistics records (these statistics are usually
quality of service statistics).
Top selection This line filter can be used to analyze the best
or worst records of a kind. A field is used to
dispatch the records (every record with the
same value for that field are grouped
together, and each value of that field
produces a new results line). A column and a
sort order are needed to classify the results.
The final classification is truncated to the N
best (or worst). If necessary, the dynamic
depth of the internal classification can be
specified.

Overview ProTraq user's manual 10 / 32


2.Configuring ProTraq

2.1Main view
The main window contains a menu bar, an icon tool bar and the list of all
existing configurations available to the current user. Optionally, a list of the
sessions to which the selected configuration is applied can be displayed with its
own icon tool bar.

Configurations list

Sessions associated with the selected configuration

2.1.1Configuration management
In the configurations list, click to navigate
through the configurations.
By clicking , you can add a new configuration: enter its initial parameters
and click [Apply].
Click to edit the currently selected configuration (the one that has its
thumbtack knocked in): change its parameters and click [Apply].

Table of contents ProTraq user's manual 11 / 32


At configuration time, some parameters can not be
changed:
- Name (when configuration is already applied)
- Dictionary
- Comment (when configuration is already applied)
- Data server (when configuration is already applied)
- Statistic session (when configuration is already
applied)
- Session duration (when configuration is already
applied)
Click to delete the currently selected configuration.
Click to add/remove selection criteria.
Click to export the actual configuration’s list view (as HTML or XML file).
Click to show/hide the session’s list to which the currently selected
configuration is applied
Click to display the number of configurations (available to the current user).
Click to set the rights for each user role (a user belongs to one or more
groups, each of these having one or more roles) to the currently selected
configuration.
Click to refresh the list.
To change the number of configurations displayed per page, enter a new value
for Records per page, and click .
Click [View/Change] to display the given configuration’s lines, columns and
alarms.
Click [Apply] of the given configuration to reapply it to all the associated
sessions (this operation must be done after the lines or alarms of an already
applied configuration have been modified).

2.1.2Session management
In the sessions list, click to navigate through
the sessions.
By clicking , you can apply the currently selected configuration to sessions:
check the wanted sessions and click [Apply].
Click to remove the currently selected session from the sessions to which
the currently selected configuration is applied to.
Click to display the number of sessions (to which the currently selected
configuration is applied).

Overview ProTraq user's manual 12 / 32


2.2Configuration view
The configuration window contains the menu bar (same as the main window)
and the configuration itself (its lines, columns, alarms, corner). In the Main
view, click [View/Change] in a configuration to enter this view.

Configuration’s elements

In this view you can:


• Manage the filters (whose names appear in the line headers along with the
exclusivity state [red or green led specifying exclusive or not]); the counters
(whose names appear in the column headers), and the optional main filter
(whose name appears in the top left corner of the grid);
• Define the alarm levels alphanumerically.

2.2.1Corner management
To create the corner filter, click in the top left of the table; enter its initial
parameters and a filter and click [Apply]; click [Cancel] to abort the corner filter
creation.
If the corner has already been defined, click its name (top-left cell in the table),
then:
• Click [Edit] to change its parameters; validate it by clicking [Apply]; click
[Cancel] to abort your choice
• Click [Delete] to remove the corner; validate the deletion by answering
[OK] to the question.

2.2.2Line management
Click at the bottom of the lines to create a new line; select a line type and
click [Apply], enter its initial parameters (enter a filter if required) and click
[Apply]. At any time, clicking [Cancel] or closing the popup window aborts the
line creation.
To select a line, click its name, then:

Table of contents ProTraq user's manual 13 / 32


• Click [Edit] to change its parameters; validate by clicking [Apply]; click
[Cancel] to abort;
• Click [Delete] to remove this line; validate the deletion by answering [OK]
to the question.
Click [Automatic line] to quickly create several lines.
You can change the order of the line(s) by using the arrows - to move it down
(click ), or up (click ).
To delete several lines at once, select them all (click a line’s name, then click
the other lines’ names by pressing [Shift] key) and click [Delete].

2.2.3Column management
Click at the right of the columns to create a new column; select a column
type and click [Apply], enter its initial parameters (enter a filter if required) and
click [Apply]. At any time, clicking [Cancel] or closing the popup window
aborts the new column creation.
To select a column, click its name, then:
• Click [Edit] to change its parameters; validate by clicking [Apply]; click
[Cancel] to abort;
• Click [Delete] to remove this line; validate the deletion by answering [OK]
to the question.
Click [Automatic column] to quickly create several columns.
You can change the order of the column by using the arrows - to move it left
(click ), or right (click ).
To delete several columns at once, select them all (click a column’s name, then
click the other columns’ names by pressing [Shift] key) and click [Delete].

Columns cannot be managed if the configuration is


already applied to session(s).

2.2.4Alarm management
To create a new alarm, click in a blank cell and click [Edit]: enter its initial
parameters and click [Apply]; click [Cancel] to abort the new alarm’s creation.
To select an alarm, click it, then:
• Click [Edit] to change its parameters; validate by clicking [Apply]; abort
edition by clicking [Cancel];
• Click [Delete] to remove this alarm; validate the deletion by answering
[OK] to the question;
• Click [Copy] to copy the alarm to an internal clipboard;
• Click [Paste] to paste the internal clipboard’s content to the selected alarm.
To delete several alarms at once, select them all (click an alarm, then click the
other alarms by pressing [Shift] key) and click [Delete].

Overview ProTraq user's manual 14 / 32


To paste to several alarms at once, select them all (click an alarm, then click the
other alarms by pressing [Shift] key) and click [Paste].

2.3Railway
The railway is displayed at the top of the screen (under the menu). It provides
an easy way to navigate from configuration view to the main view (click
ProTraq), or from main view to the portal (click Configuration).

Railway in the configuration view of stat_classic_1 configuration

2.4Menus
The menu bar displays the following :
• Configuration menu: ProTraq, Others;
• File menu: Import...;
• Options menu: Preferences...;
• Help menu: Contents…, About ProTraq…;

2.4.1Configuration menu
2.4.1.1ProTraq command
This command displays a list of all the available ProTraq configurations (see
Main view), and, possibly, the sessions associated with a given configuration.

2.4.1.2Others command
This command displays a list of all the available non-ProTraq configurations
(static mapping or dynamic xDR enrichment configurations) and, possibly, the
sessions associated with a given configuration. The only way to create non-
ProTraq configurations is to import them.

Table of contents ProTraq user's manual 15 / 32


Non-ProTraq configurations

Sessions to which the selected configuration is associated

2.4.2File menu
2.4.2.1Import command
You can create a new configuration by importing an existing .fse file. Select the
given file, choose the proper dictionary (this is the dictionary of the source
session), enter an optional decryption password and click [Import].

The imported configuration is added to the ProTraq configurations list or in the


non-ProTraq configurations list (depending on what type of .fse file was
imported ).

Warning: in case of an import error, a ProTraq


configuration file can be partially imported (missing
some columns, lines or alarms). So always check the
import result.

2.4.3Options menu
2.4.3.1Preferences command
You can change the preferences: enter the new values and click [Apply]. The
view is refreshed to take into account the new visual preferences (e.g.
display/hide exclusivity status).

Overview ProTraq user's manual 16 / 32


Alarm constraint defines:
• Above how many xDR accounted an alarm in percent can to be triggered
• If the cancellation of an alarm in percent is also managed by the constraint

2.4.4Help menu
2.4.4.1Contents command
This command displays the user manual.

Warning: to display the user manuel, a PDF viewer


must be installed.

2.4.4.2About ProTraq command


This command gives information about ProTraq, the software platform and the
company.

2.4.5Railway
Depending on the current view, the railway displays 2 or 3 elements (the
element at the farthest right describes the current view).
To go back to a previous view, click the relevant item in the railway (e.g. in the
configuration view, click Configuration in the railway to display the
configurations list).

Table of contents ProTraq user's manual 17 / 32


2.5Procedures

2.5.1New corner
This window lets you create the main filter. In the configuration view, select the
top-left cell of the table (if the corner has already been defined, click [Edit] to
modify it).

Corner filter creation

Enter the corner’s name, select whether the selected records are removed from
the source session or not, and define a filter.

2.5.2New line
This window lets you create a line. In the configuration view, click the bottom-
left cell of the table.

Line creation

Choose a line type and click [Apply]; then enter other requested information (like
name and exclusivity). Possible line types are:

• No data filtering: all the xDR are selected in such lines


• Data filtering: only xDR matching the given filter are selected in such lines
• Top selection: a possible filter can limit the xDR selected in such lines

2.5.3No data filtering line type


This window lets you create/edit the line type “No data filtering”.

Overview ProTraq user's manual 18 / 32


No data filtering creation/edition

Enter mandatory name and check whether this line is exclusive or not. Click
[Apply] to create or validate changes. Click [Reset] to restore the system default
values.

2.5.4Data filtering line type


2.5.4.1Line edition
This window lets you create/edit the line type “Data filtering”.

Data filtering creation/edition

Enter mandatory name and filter, and check whether this line is exclusive or not.
Click [Apply] to create or validate changes. Click [Reset] to restore the system
default values.

2.5.4.2Multiple line addition


It is possible to create multiple data filtering lines at once. All these lines will
have a single filtering condition applying to the same xDR field compared to a
given value. In the Configuration view, click [Automatic line].

Table of contents ProTraq user's manual 19 / 32


Choose a default naming convention by entering a possible prefix and choosing
between a serial number or the value as the prefix. It is possible to rename all
the previously entered values by clicking [Apply default name].
Select the fields to be compared and the comparison operator. It is possible to
automatically enter all predefined values of a selected field by clicking [Add
predefined values].
It is also possible to enter a single value: enter a value and a name and click
[Add]. Entered values can also be reordered, renamed or removed: select an
entered value in the table, then:
• Type a new name and click [Rename] to rename it;
• Click [Remove] to remove it;
• Click the up arrow to move it up, or the down arrow to move it down.
• Click[Remove all] to clear the entered values list.

To create the new lines click [Apply]; click [Cancel] to abort lines creation.
When the user applies the changes, ProTraq tries to create a new Data filtering
line for each entered value:
• The field, the operator and the value are used to create a single condition
filter;

Overview ProTraq user's manual 20 / 32


• The name is used to name the new line;
• The line’s exclusivity state is set according to the user’s preference.
The creation process can be aborted if a line with the same name as that of one
of the entered values already exists.

2.5.5Top selection line type


A top selection let's you dispatch the tickets with as many as 3 fields (filters do
not select the tickets according to given field values). These filters build a list
of all encountered values of the selected fields and equally create as many
virtual line statistics. Each virtual line is defined by a query filter comparing the
top filter fields and, for each field, one of its encountered values.
It is sometimes interesting to group numbers using only a portion of the number.
For example, it may be interesting to group the international calls by nationality.
The substring function will allow you to select part of an address (give the start
position, from left or right, and the length).
When the period (statistics or alarms) ends, these virtual lines are sorted in
ascending or descending order according to one of the counters values. The N
first virtual lines are kept and saved to the statistics session (at the statistics
period ending) or checked for alarms at start or termination (at the alarms period
ending).
This window lets you create/edit the line type “Top selection”.

Top selection creation/edition

Table of contents ProTraq user's manual 21 / 32


Top selection creation/edition

Enter mandatory name, top count and maximum count, check whether this line
is exclusive or not, choose an ordering column and a sort order and, possibly,
define a query filter.

Top selection creation/edition

Set up to 3 selection fields (for address fields like Bnumber, Anumber, IMSI,
MSISDN… set a possible subString, as you would for string fields).
Click [Apply] to create or validate changes. Click [Reset] to restore the system
default values.

2.5.6New column
This window lets you create a column. In the configuration view, click the top-
right cell.

Overview ProTraq user's manual 22 / 32


Column creation

Choose a column type and click [Apply]; then, enter other requested
information (like name, and possibly comment). The possible column types are:
• Simple data counter: provides the number of xDR selected in a line
• Filtered data counter: among all the xDR selected in line, provides the
number of xDR matchin the given filter
• Cumulative counter: provides the sum for all the xDR – or the greatest or
the smallest value for a single xDR – of the sum of the chosen field(s) of
the xDR
• Column ratio: calculates the ratio between 2 other columns (the result is
either expressed as an integer or as a percentage)
• Field value: reports the value of a field of an xDR or reports the textual
representation of a field chosen in a Top selection line

2.5.7Simple data counter column type


This window lets you create/edit a column type “Simple data counter”.

Simple data counter creation/edition

Enter mandatory name and optional comment. Click [Apply] to create or


validate changes. Click [Reset] to restore the system default values.

2.5.8Filtered data counter column type


2.5.8.1Column edition
This window lets you create/edit a column type “Filtered data counter”.

Table of contents ProTraq user's manual 23 / 32


Filtered data counter creation/edition

Enter mandatory name and filter, and optional comment. Click [Apply] to create
or validate changes. Click [Reset] to restore the system default values.

2.5.8.2Multiple column addition


It is possible to create multiple filtered data counter columns at once. All these
columns will have a single filtering condition applying to the same xDR field
compared to a given value. In the Configuration view, click [Automatic
column].
Refer to Multiple line addition to learn how to use this function.
When the user applies the changes, ProTraq tries to create a new Filtered Data
Counter column for each entered value:
• The field, the operator, and the value, are used to create a single condition
filter;
• The name is used to name the new column;
• The column’s comment is left empty.
The creation process can be aborted if a column with the same name as that of
one of the entered values already exists.

2.5.9Cumulative counter column type


This window lets you create/edit a column type “Cumulative data counter”.

Overview ProTraq user's manual 24 / 32


Cumulative data counter creation/edition

Enter mandatory name and optional comment (an optional filter can be
provided). Select the fields to aggregate. Choose an optional scale factor and
set the result type. Click [Apply] to create or validate changes. Click [Reset] to
restore the system default values.

The result of a cumulative counter may be:


• the sum of all selected fields of all records
• the lowest sum of all selected fields of one
record
• the highest sum of all selected fields of one
record

2.5.10Ratio column type


Ratios (or means values) result in the division of one counter by another ; the
result may be expressed as a number (mean-value) or a percent (ratio).
This window lets you create/edit a column type “Ratio”.

Table of contents ProTraq user's manual 25 / 32


Ratio creation/edition

Enter mandatory name and optional comment; choose the divisor (value
counter) and the dividend (reference counter) and check whether the result is
expressed as a percentage or not (this cannot be changed at edition time). Click
[Apply] to create or validate changes. Click [Reset] to restore the system default
values.

2.5.11Field column type


This window lets you create/edit a column type “Field”.

Field creation/edition

Enter mandatory name and optional comment. Choose between an input field in
a top selection (enter its rank from 1 to 3) and an xDR field (select its name in
the combo box). Click [Apply] to create or validate changes. Click [Reset] to
restore the system default values.

Overview ProTraq user's manual 26 / 32


There are 2 ways to select a field :
• with a number (the value of the first, second or
third field selected in a Top selection line will be
stored in this column, as a string value, i.e.
without any formatting information); set Top
field with the appropriate number
• with a session field's definition (the value stored
in this column is that of the same field in the first
record accounted in the line; all formatting and
presentation information is kept and also
displayed in the xDR browser) ; set Ticket field
with the appropriate field name
Top field creates a text column in the statistical session holding the textual
representation of the given field number chosen in a Top line. Ticket field
creates a column having the same definition than the field chosen (e.g. if A-
Number is chosen, this column in the statistical session will hold the A-Number
of the xDR).

2.5.12Filter definition
This window lets you define or modify a filter.

Filter edition

To add an empty condition, click [New condition >>]. Conditions no longer


used can be removed by selecting the relevant checkboxes and click [Delete
condition].

Table of contents ProTraq user's manual 27 / 32


You can create a new filter by clearing the expression and all the conditions you
defined (just click [Clear]). You can publish the current filter (type a name and
click [Publish]). You can reuse a published filter by selecting it in the list.
To confirm the changes, click [Apply]; to abort click [Cancel]. If an error occurs
while the filter is created, the process stops and a message box displays the error
cause.

2.5.13Alarms
This window lets you create or modify alarms. In the configuration view, click a
cell which is neither a line header, neither a column header, nor the corner, then
click [Edit].

Alarms on counters and integral ratios

Alarms on ratios in percentage

Overview ProTraq user's manual 28 / 32


Depending on which column type, alarms are configured differently:
• For Simple data counters, Filtered data counters, Cumulative counters and
Column ratios (expressed as integers), you only have to defined 2 possible
thresholds (one triggering a minor alarm event, the other triggering a major
alarm event). These thresholds are expressed s integer.
• For Column ratios (expressed as percentages), you can also change the
constraint defining after how many xDR accounted the alarms events have
to be triggered (and possibly cancelled). In this case, the thresholds are
expressed as percentages (from 0.00 to 100.00).
• For Field values, no alarm can be defined (these are not counters)
By default, for percent alarms, the alarm constraint is the one defined at
configuration level; it is possible to set a specific constraint by selecting a
different counter and/or a different threshold. Such alarms cancellation can also
be managed by this constraint.

Table of contents ProTraq user's manual 29 / 32


3.Results of ProTraq

3.1Principle
The Data Server uses the configuration generated with the Configuration tool to
produce statistics and alarms.
The statistics are given in the form of a Data Server session, so they can be used
with xDR Browser. Referring to the xDR Browser User's manual, you will find
that it let’s you sort your statistical results, make selections, and present results
as graphs (you will need Microsoft Excel to do this).
The alarms are sent to the management platform through the management agent.

3.2The statistics
The statistics session conforms to what was defined. Each time a statistics
period ends, a set of records is written to the session. There are as many records
as there are defined filters - plus, at most, N lines for each top selection (where
N is the number of results retained in the final classification). Each counter
produces one column (record field). A record contains the counters
corresponding to one filter in one statistics time period plus some other
information :
• the end time of the period,
• the real period duration (it can be less than the defined statistics time
period),
• a sample rate, which is more than one if the Tool was working in degraded
mode (due to processing overhead),
• the main filter name (if one has been defined),
• the filter name (or a compound filter name with the field values, for the top
selection lines).
Example :
The configuration contains :
• 3 filters - "Not answered calls" (selecting the unanswered calls), "Busy
calls" (selecting the busy calls), and a top selection "Cause family"

Overview ProTraq user's manual 30 / 32


dispatching the calls according to their cause family value (other than
unanswered and busy)
• 3 counters for the total number of calls - incoming calls, outgoing calls,
and a field for the cause family name.
• 1 field holding the cause family field

The statistics results (screen copy of xDR browser) :

Table of contents ProTraq user's manual 31 / 32


3.3The alarms
The alarm events are sent to the management platform through the agent.
When the Data Server tool starts, each time an alarm period ends captured
events can be sent to the management platform. Each event is attached to one
statistic counter.
An event can be :
• a major alarm due to a counter overflow (or underflow), in comparison with
a high threshold, that appeared in the current alarm period ;
• a minor alarm due to a counter overflow (or underflow), in comparison
with a low threshold, that appeared in the current alarm period ;
• a clear of alarm because all overflow or underflow conditions disappeared
in the current alarm period.
The following information is transmitted with each event :
• session name, line number and reference, column number;
• event severity (major, minor, clear);
• threshold value, counter value.

Overview ProTraq user's manual 32 / 32

You might also like