Step 1: Mobility Performance Monitoring Collector Configuration Procedure

Prev Next

This section provides detailed step-by-step instructions to configure the Mobility performance monitoring collector.

Pre-requisites for 4G Mobility Devices

  • 4G Mobility devices must be configured to stream bulkstats. Refer to Cisco reference instructions to set up bulkstats.

  • FM and Mobility PM collector must be reachable from the mobility devices

Pre-requisites for 5G Mobility Devices

  • 5G mobility device bulkstats are polled by the Mobility performance monitoring Collector component (not streamed). The user must configure the specific stats they are interested in ingesting to Provider Connectivity Assurance via the Common Execution Environment (CEE) configuration file on the device

  • The CEE Bulkstats container on the 5G device must be reachable from Fault and Mobility performance monitoring collector for SCP/SFTP communication

1 Configuring Mobility Performance Monitoring Collector

To configure mobility performance monitoring in Provider Connectivity Assurance, the steps are as follows:

  1. Enable the Mobility plugin within the Fault and Mobility performance monitoring Collector

  2. If 4G devices are required, set up the SFTP collector, which imports the data pushed from 4G Mobility devices

  3. Configure mobility performance monitoring data consumer:            

    1. Create mobility performance monitoring data ingestion cluster

    2. Set up topic catalog for mobility performance monitoring

    3. Create the schema for each data type

    4. Create Consumers and handlers for data processing

  4. Enable the performance monitoring data flow from the Fault and Mobility performance monitoring Collector to Provider Connectivity Assurance            

    1. Create and deploy Censor Collector

    2. Create, customize and deploy a Telemetry Collector

    3. Install ingestion dictionaries

    4. Enable data flow

    5. Set up dashboard

2 Enable Mobility Plug-In from the Configuration User Interface

To enable the Mobility plugin from the configuration user interface:

  1. Login to the configuration UI with the default username and password provided, which have administrative privileges

  2. Follow the path Admin->Tenant->App Plugins

  3. Add mobility plugin and select enabled and click save. The plugin will be enabled.

3 Set Up 4G Devices to Push Data

4G Mobility devices will stream (push) Bulkstats to the SFTP collector. The configuration file on each 4G device must be updated to contain the IP address and credentials of the SFTP collector, so that it can connect to the Fault and Mobility performance monitoring Collector. The following commands must be executed on the 4G device:

Note: This step is not required for 5G devices, because they are polled rather than pushing out a stream of data.  

bulkstats collection
  bulkstats mode
    sample-interval 5
    transfer-interval 5
    file 1
      remotefile format /home/callmodel/bulkstats/<HostName>/bulkstat%date%%time%.txt primary-receiver
      receiver <SFTP Collector IP> primary mechanism sftp login <SFTP username> encrypted password 

Note: This step is not required for 5G devices, because they are polled rather than pushing out a stream of data.  

4 Set-Up Mobility Performance Monitoring Data Ingestion Cluster

The data ingestion cluster imports the data after it has been collected from the devices (i.e via SFTP collector from 4G Devices and/or polled from the CEE Bulkstats container for 5G Devices).

To set this up:

  1. Login to Fault and Mobility performance monitoring collector configuration UI with administrative access credentials

  2. Follow the path Admin->Data Pipeline -> Ingestion Cluster

  3. Click on the add icon on top of the list. Enter the required details in the available fields.

  4. Enter name for the ingestion cluster.

  5. Select ingestion type as “File

  6. Configure the required mandatory parameters for file-based ingestion types            

    1. Host – Host of SFTP Collector

    2. Port – SFTP port 22

    3. Max sessions – ten

    4. File sync method - SFTP

    5. Username – User name of SFTP collector

    6. Password – password of SFTP collector (if private or public SSH key not available)

    7. Private key – private ssh key for SFTP collector

    8. Public key

  7. After entering all the required details click Save and continue.

5 Set-Up Topic Catalog

Topic Catalog maintains the configuration of Kafka topic in case Kafka based ingestion and File path on SFTP server in case of file-based ingestion.

To set this up:

  1. Login to FM and Mobility PM collector configuration admin UI with administrative access credentials

  2. Follow the path Admin->Data Pipeline -> Topic Catalog

  3. 4G Mobility devices - Bulkstats and SSD Topic configurations are created automatically when the mobility performance monitoring is enabled.            

    1. Configure the path where the SSD and Bulkstats files path

  4. For 5G Mobility devices - Click on the add icon on top of the list.            

    Create an individual Topic for SMF

  5. After entering all the required details click Save and continue.

5 Set-Up Data Pipeline Handlers

To configure the Data stream handlers:

  1. Login to FM and Mobility PM collector configuration UI with administrative access credentials

  2. Follow the path Admin->Data Pipeline -> Handlers

In the list of available handlers, Bulkstats and SSD Handlers were created automatically when the mobility performance monitoring was enabled by adding the mobility plugin.

  1. Edit the “Bulkstats” handler and the “SSD” handler using the edit button in the UI, and select the following configuration:            

    1. BulkStats Handler                    

      To process the bulkstats file, set the following values:

      • Handler Type: BulkstatsHandler

      • Post Process: saveToDB

    2. SSD Handler                    

      This SSD handler is responsible of processing the ssd file and create the entry in database. To process the ssd files, configure these values:

      • Handler Type: SSDHandler

      • Post Process: saveToDB

  2. 5G Mobility devices – Add the Handlers - Click on the add icon on top of the list.



  3. After entering all the required details click Save and continue.

5 Set-Up Data Pipeline Schema

To set-up data stream Schema configurations:

  1. Login to FM and Mobility PM collector configuration admin UI with administrative access credentials

  2. Follow the path Admin->Data Pipeline -> Schema

Bulkstats and SSD Schema were created automatically when the mobility performance monitoring is enabled

  1. Edit Schema “Bulkstats” and “SSD” using the edit button in the UI, choosing the following settings:

  2. 5G Mobility devices - Add the Schema - Click on the add icon on top of the list.            

    1. Add Three individual Schema based on this configuration

  3. After entering all the required details click Save and continue.

6 Set-Up Consumers for Data Processing

Consumers are those who are processing the data which is imported from mobility devices ingested via file based ingestion type as configured.

To set this up:

  1. Login to FM and Mobility PM collector configuration admin UI with administrative access credentials

  2. Follow the path Admin->Data Pipeline -> Consumer

  3. Bulkstats and SSD Consumer configurations are created automatically when the mobility performance monitoring is enabled.

  4. Edit Bulkstats and SSD Consumer for 4G Mobility devices KPI processing as given below            

    1. SSD Consumer                    

      To consume ssd file user need to configure the ssd consumer which will consume from the topic <tenant>.ssd. The Ingestion cluster should be file based which will work as scheduler and can be configurable. Handler will be ssd related handler and schema will ssd related schema which will configure in Schema and handler section.

    2. BulkStats Consumer                    

      To consume BulkStats file user need to configure the Bulkstat consumer which will consume from the topic <tenant>.bulkstats. The Ingestion cluster should be file based which will work as scheduler and can be configurable. Handler will be bulkstats related handler and schema will bulkstats related schema which will configure in Schema and handler section.



  5. For 5G Mobility devices add following consumer            

    1. SMF Consumer:

  6. After entering all the required details click Save and continue.

Next Step

At this stage, the Fault and Mobility Performance Monitoring Collector has been configured. Next you can proceed to: Step 2: Provider Connectivity Assurance for Mobility PM Configuration Procedure