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:
Enable the Mobility plugin within the Fault and Mobility performance monitoring Collector
If 4G devices are required, set up the SFTP collector, which imports the data pushed from 4G Mobility devices
Configure mobility performance monitoring data consumer:
Create mobility performance monitoring data ingestion cluster
Set up topic catalog for mobility performance monitoring
Create the schema for each data type
Create Consumers and handlers for data processing
Enable the performance monitoring data flow from the Fault and Mobility performance monitoring Collector to Provider Connectivity Assurance
Create and deploy Censor Collector
Create, customize and deploy a Telemetry Collector
Install ingestion dictionaries
Enable data flow
Set up dashboard
2 Enable Mobility Plug-In from the Configuration User Interface
To enable the Mobility plugin from the configuration user interface:
Login to the configuration UI with the default username and password provided, which have administrative privileges
Follow the path Admin->Tenant->App Plugins
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:
Login to Fault and Mobility performance monitoring collector configuration UI with administrative access credentials
Follow the path Admin->Data Pipeline -> Ingestion Cluster
Click on the add icon on top of the list. Enter the required details in the available fields.
Enter name for the ingestion cluster.
Select ingestion type as “File”
Configure the required mandatory parameters for file-based ingestion types
Host – Host of SFTP Collector
Port – SFTP port 22
Max sessions – ten
File sync method - SFTP
Username – User name of SFTP collector
Password – password of SFTP collector (if private or public SSH key not available)
Private key – private ssh key for SFTP collector
Public key
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:
Login to FM and Mobility PM collector configuration admin UI with administrative access credentials
Follow the path Admin->Data Pipeline -> Topic Catalog
4G Mobility devices - Bulkstats and SSD Topic configurations are created automatically when the mobility performance monitoring is enabled.
Configure the path where the SSD and Bulkstats files path
For 5G Mobility devices - Click on the add icon on top of the list.
Create an individual Topic for SMF
After entering all the required details click Save and continue.
5 Set-Up Data Pipeline Handlers
To configure the Data stream handlers:
Login to FM and Mobility PM collector configuration UI with administrative access credentials
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.
Edit the “Bulkstats” handler and the “SSD” handler using the edit button in the UI, and select the following configuration:
BulkStats Handler
To process the bulkstats file, set the following values:
Handler Type: BulkstatsHandler
Post Process: saveToDB
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
5G Mobility devices – Add the Handlers - Click on the add icon on top of the list.
After entering all the required details click Save and continue.
5 Set-Up Data Pipeline Schema
To set-up data stream Schema configurations:
Login to FM and Mobility PM collector configuration admin UI with administrative access credentials
Follow the path Admin->Data Pipeline -> Schema
Bulkstats and SSD Schema were created automatically when the mobility performance monitoring is enabled
Edit Schema “Bulkstats” and “SSD” using the edit button in the UI, choosing the following settings:
5G Mobility devices - Add the Schema - Click on the add icon on top of the list.
Add Three individual Schema based on this configuration
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:
Login to FM and Mobility PM collector configuration admin UI with administrative access credentials
Follow the path Admin->Data Pipeline -> Consumer
Bulkstats and SSD Consumer configurations are created automatically when the mobility performance monitoring is enabled.
Edit Bulkstats and SSD Consumer for 4G Mobility devices KPI processing as given below
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.
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.
For 5G Mobility devices add following consumer
SMF Consumer:
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