| 1 | Introduction |
2 | Performance Measurement Groups |
3 | Measurements of EvipNetstat PM Group |
4 | Performance Measurement Jobs |
5 | Measurement Job Results |
| 5.1 | Example ROID or measObjLdn |
1 Introduction
This document describes the PM Counters interface provided by eVIP. A number of measurements are available to report network statistics provided by eVIP.
eVIP PM counters are only available when eVIP is run in a Core MW environment and cannot be used by eVIP for LSB.
For more information about Performance Management, refer to Core MW Performance Management Description.
2 Performance Measurement Groups
eVIP has one PM Group that applies to both real and virtualized hardware.
|
pmGroupId |
Properties |
|
EvipNetstat |
|
- Note:
- Providing the FEE name is optional. When FEE is omitted, aggregated values of all FEEs within the ALB are provided.
3 Measurements of EvipNetstat PM Group
PM producer daemons (apart of evip_amf_proxy) on each eVIP node collect statistical information which is reported via the Core MW Performance Management Interface. For more details on this interface, refer to Core MW Performance Management Description. All network measurements are reported as delta (change in value) from previous sample.
|
measurementTypeId |
Properties |
|
ip4OutOctets |
|
|
ip6OutOctets |
|
|
ip4OutDatagrams |
|
|
ip6OutDatagrams |
|
|
ip4InOctets |
|
|
ip6InOctets |
|
|
ip4InDatagrams |
|
|
ip6InDatagrams |
|
|
l2RxDropped |
|
|
l2RxErrors |
|
|
l2RxFifoErrors |
|
|
l2RxFrameErrors |
|
|
l2TxCarrierErrors |
|
|
l2TxCollisions |
|
|
l2TxDropped |
|
|
l2TxErrors |
|
|
l2TxFifoErrors |
4 Performance Measurement Jobs
Measurement jobs can be created as ECIM PM, Use Case Description. The COM CLI can be used to create, activate, modify, and delete PM jobs as per examples below.
Example 1 Example via ECIM, to set up a new measurement job:
configure ManagedElement=1,SystemFunctions=1,Pm=1 PmJob=MyEvipJob requestedJobState=STOPPED granularityPeriod=ONE_MIN reportingPeriod=ONE_MIN MeasurementReader=1 measurementSpecification,groupRef="ManagedElement=1,SystemFunctions=1,Pm=1,PmGroup=EvipNetstat" commit show exit |
Example 2 Example via ECIM, to activate the measurement job:
configure ManagedElement=1,SystemFunctions=1,Pm=1 PmJob=MyEvipJob requestedJobState=ACTIVE commit show exit |
Example 3 Example via ECIM, to change the reporting and granularity period to five minutes:
configure ManagedElement=1,SystemFunctions=1,Pm=1 PmJob=MyEvipJob granularityPeriod=FIVE_MIN reportingPeriod=FIVE_MIN commit exit |
Example 4 Example via ECIM, to delete a measurement job:
configure ManagedElement=1,SystemFunctions=1,Pm=1 PmJob=MyEvipJob requestedJobState=STOPPED commit up configure no PmJob=MyEvipJob commit exit |
Alternatively, Core MW command line tools can be used to create a job as per examples below.
Example 5 Example via Core MW commands:
cmw-pmjob-create MyEvipJob -u EvipNetstat -p3 -t1 -q1 -g3 -r3 cmw-pm-show-counters Alb=alb1,Fee=fee1 See further relevant command line tools provided by Core MW: cmw-pmjob-create, cmw-pmjob-delete, cmw-pmjob-list, cmw-pmjob-modify, cmw-pmjob-start, cmw-pmjob-status, cmw-pmjob-stop, cmw-pm-show-counters. |
- Note:
-
- Due to Core MW PM architecture and its method of collection, changes to FEE allocation, such as reboot, shutdown, scaling-in, can cause up to one granularity period of packet counter data to be lost.
- When adding a job, the granularity_period should be equal to reporting_period. Periods below one minute are not possible.
5 Measurement Job Results
- At the end of the configured granularity
period, a report with counter values is output to the folder
- /storage/no-backup/com-apr9010443/PerformanceManagementReportFiles
- Alternatively, the helper command "cmw-pm-show-counters"
can display counters at runtime, with the following syntax.
- cmw-pm-show-counters <measObjLdn>
For measObjLdn, see Section 5.1.
Here are some examples:
- Show counter values per FEE:
- cmw-pm-show-counters Alb=alb1,Fee=fee1
- Show the aggregated values of counters
per ALB:
- cmw-pm-show-counters Alb=alb1
5.1 Example ROID or measObjLdn
The ROID or measObjLdn (Measured Object Local Distinguished Name) can be constructed for each measurement instance by using the correct identifiers after the appropriate PM Group.
For example
- Alb=alb1
- Alb=alb1,Fee=fee1
- Alb=alb1,Fee=fee2
- Alb=alb2
- Alb=alb2,Fee=fee1
- Alb=alb2,Fee=fee2

Contents