/demo-network-operations

Primary LanguageJupyter NotebookApache License 2.0Apache-2.0

Network Operations - MLRun MLOps Demo

This demo shows a full ML Pipeline for error prediction based on network device telematry using MLRun.

In this demo we show:

  • Managing an MLRun Project
  • Using github as a source for functions to use in our pipeline workflows
  • Use MLRun logging to track results and artifacts
  • Running a Kubeflow Pipeline using MLRun
  • Deploy live endpoints
  • Deploy Concept Drift

The demo applications are tested on the Iguazio's Data Science PaaS, and use Iguazio's shared data fabric (v3io), and can be modified to work with any shared file storage by replacing the apply(v3io_mount()) calls with other KubeFlow volume modifiers (e.g. apply(mlrun.platforms.mount_pvc())) . You can request a free trial of Iguazio PaaS.

How the system is built

This demo aims to show an example of a production system deployed fully by an automated pipeline.

There are three main parts to this demo.

  • Training pipeline to create new model.
  • Streaming pipeline endpoints for production
  • Concept Drift detection to monitor the model's performance

You can select which parts of the workflow to run via the deploy_streaming flag for the Production deployment and the deploy_concept_drift for the drift detection flags.

For retraining purposes and scheduling of workflows we can use the project runner function from the marketplace to create an HTTP endpoint (or any other nuclio trigger) that can run a workflow based on an event.

Training pipeline

The training pipeline includes the following process (based on our functions market):
Exploratory Data Analysis: Provides histogram maps, class imbalance, correlation matrix, etc...
Aggregation: run different rolling aggregations on top of the dataset to create temporal features.
Feature Selection: Select the best features to use using a vote based on multiple metrics and basic model estimators.
Training: Train multiple SKLearn API based models (Using automated hyperparams search) and select the best one according to a selected metric.
Test: Using a dedicated Test dataset, provide performence benchmarks for the model.

Production deployment pipeline

In the production deployment phase we aim to deploy a full system to ingest new data, create the necessary features and provide predictions. We are using the Nuclio serverless runtime to create the live endpoints, which for ease-of-use as open source will work by passing parquets at a set directory between each other. (Using a streaming engine would require many dependencies which will make open-source deployment difficult)

Our production process is made of a setup stage to start the generator to mimic incoming data and the [(done automatically in the pipeline). The netops pipeline itself is made from the following components:
Preprocessor: Taking the selected features and creating them upon ingestion.
Model Server: Deploy the model to a live endpoint.
Model Server Tester: Verify our model endpoint is live and provides good predictions.
Labeled stream creator: Join the incoming labels and predictions to a single source to assess the model's performence.

Concept drift deployment pipeline

The concept drift pipeline is made of two main components:
Concept Drift Detectors: Using streaming drift detectors like DDM and PH. we use a job to initialise the models with a base labeled dataset and produce a live Nuclio endpoint to enlist to the labeled stream.
Drift Magnitude: Taking batches of data via parquet, we apply multiple drift magnitude metrics like TVD, Helinger and KL Divergence to assess the drift between a base dataset and the latest data.



Running the demo

Pre-requisites:

  • A Kubernetes cluster with pre-installed KubeFlow, Nuclio.
  • MLRun Service and UI installed, see MLRun readme.
  1. Clone this repo to your own Git.
  2. in a client or notebook properly configured with MLRun and KubeFlow run:

mlrun project demo-network-operations/ -u git://github.com/<your-fork>/demo-network-operations.git

  1. Run the Generator notebook to create the metrics dataset.

  2. Open the project notebook and follow the instructions to develop and run an automated ML Pipeline.

Note: alternatively you can run the main pipeline from the CLI and specify artifacts path using:

mlrun project demo-network-operations/ -r main -p "/User/kfp/{{workflow.uid}}/"

Files

Notebooks

Project Files

Workflow code

Pipeline