6 EIR Measurements

This chapter describes measurements that can be collected and generated for the EIR feature.

6.1 EIR Measurements

The EAGLE Measurements system supports the collection and retrieval of measurements related to the EIR feature. The EIR measurements can be collected and reported with either of the following collection methods:
  • The Measurements Platform feature enabled and the Measurements Platform collection option on
  • The E5-OAM Integrated Measurements feature enabled and on and the E5-OAM Integrated Measurements collection option on

15 Minute Measurements collection can be used with Measurements Platform or E5-OAM Integrated Measurements.

OAM-based measurements collection is not available for EIR.

The EAGLE Measurements system supports the collection and retrieval of measurements related to the EIR feature. The EIR measurement registers are supported only with the Measurements Platform feature enabled and the Measurements Platform collection option on.

Refer to Measurements Reference for descriptions of collection methods, measurements, and measurements reports.

Refer to Commands User's Guide for descriptions of the commands used to enable and turn on features, turn on measurements collection options, and schedule and generate measurements reports.

Refer to the procedures in Database Administration - System Management User's Guide to configure the Measurements Platform feature or E5-OAM Integrated Measurements feature and the EAGLE OA&M IP Security feature for use with EIR.

The EIR feature must be enabled to provision scheduling of the EIR measurements reports. The EIR feature must be turned on for full measurements collection functions to operate for the feature.

Table 6-1 describes eight measurement registers that are used specifically for the EIR feature. The registers are reported in two Per System reports for the EIR entity type: Hourly Maintenance Measurements (MTCHEIR) and Daily Maintenance Measurements (MTCDEIR). The data for these registers originates on the Service Module cards.

For IMEIs present in multiple lists, the appropriate measurement peg is determined by the logic in Table 2-2 and the outcome of the IMSI Check.

Table 6-1 Pegs for Per System EIR Measurements

Event Name Description Type Unit

IMEIRCV

Total number of MAP_CHECK_IMEI messages received.

System

Peg count

WHITEIMEI

Total number of searches that resulted in a match with a "Allow Listed" IMEI.

System

Peg count

GRAYIMEI

Total number of searches that resulted in a match with a "Gray Listed" IMEI.

System

Peg count

BLACKIMEI

Total number of searches that resulted in a match with a "Block Listed" IMEI.

System

Peg count

BLKALIMEI

Total number of searches that resulted in a match with a "Block Listed" IMEI, but were allowed due to IMSI Check match.

System

Peg count

BLKNALIMEI

Total number of searches that resulted in a match with a "Block Listed" IMEI, and the IMSI in the database did not match the IMSI in the message.

System

Peg count

UNKNIMEI

Total number of searches that resulted in a match with an "unknown" IMEI.

System

Peg count

NOMTCHIMEI

Total number of searches that resulted in no match in the database.

System

Peg count

Measurement Registers for EIR S13/S13' Support Feature

Eight new measurement registers are added for the EIR S13/S13' Interface Support feature and are supported on a per Diameter connection basis. These new measurement registers listed in Table 6-2 are supported only with the Measurements Platform feature enabled and the Measurements Platform option on. The data for these registers originate from the S13 cards running DEIR64 GPL. The existing SCTPASSOC and SCTPCARD measurement registers are also supported by the DEIR64 GPL.

Table 6-2 EIR S13/S13' Interface Support Measurement Registers

Register Description
ECRRCV Total number of ME-Identity-Check requests (ECR) received by the EIR
WHITEIMEI Total number of searches that resulted in a match with a whitelisted IMEI
GRAYIMEI Total number of searches that resulted in a match with a graylisted IMEI
BLACKIMEI Total number of searches that resulted in a match with a blacklisted IMEI
BLKALIMEI Total number of searches that resulted in a match with a blacklisted IMEI, but were allowed due to IMSI Check match
BLKNALIMEI Total number of searches that resulted in a match with a blacklisted IMEI, and the IMSI in the database did not match the IMSI in the message
UNKNIMEI Total number of searches that resulted in a match with an Unknown IMEI
NOMTCHIMEI Total number of searches that resulted in no match in the database

Measurement Reports for EIR S13/S13' Support Feature

The new measurement registers are reported in new DEIR SYS and DEIR DCONN measurement reports: Hourly Maintenance Measurements on S13 System (MTCHDEIR) and Daily Maintenance Measurements on S13 System (MTCDDEIR). The MTCHDEIR and MTCDDEIR reports are transferred to an FTP server.

Table 6-3 DEIR Measurement Reports

Report Reporting modes Period Retention Display Reports supported on GPLs

DEIR SYS System Wide report Hourly (60 minute) and Daily (24 hour)

On-demand, Scheduled (MTCHDEIR /MTCDDEIR)

Hourly

Daily

24 hours for Hourly data

7 days for Daily data

FTP

MCP / MCPHC / OAMHC

DEIR DCONN report Hourly (60 minute) and Daily (24 hour)

On-demand, Scheduled (MTCHDEIR /MTCDDEIR)

Hourly

Daily

24 hours for Hourly data

7 days for Daily data

FTP

MCP / MCPHC / OAMHC