Skip to content

πŸ”₯πŸ”₯πŸ”₯πŸ”₯🧊πŸ”₯πŸ”₯ A Data Platform for Monitoring and Detecting Anomalies in Real-Time.

Notifications You must be signed in to change notification settings

koushikvikram/anomaly-detection-platform

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

89 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Real-Time Anomaly Detection Platform

GitHub URL LinkedIn URL

Contents

  1. Software Requirements
  2. Install make on Windows
  3. Platform Architecture
  4. How To Run The Platform
  5. Makefile Documentation
  6. API Documentation
  7. Acknowledgment

Software Requirements

You'll need the following sofware to run the Anomaly Detection Platform.

Python 3.x

Python is an interpreted high-level general-purpose programming language. Its design philosophy emphasizes code readability with its use of significant indentation. Its language constructs as well as its object-oriented approach aim to help programmers write clear, logical code for small and large-scale projects.

Python comes pre-installed with most Linux and Mac Systems. To install Python, follow the instructions provided here: https://www.python.org/downloads/

Please make sure you install a version of Python 3.x

Git BASH (for Windows users)

Git BASH is an application for Microsoft Windows environments which provides an emulation layer for a Git command line experience.

Install Git BASH if you're on a Windows machine by following the instructions here: https://gitforwindows.org/

make

GNU Make is a tool which controls the generation of executables and other non-source files of a program from the program's source files.

Follow the instructions in the Install make on Windows section to install make on Windows.

To install make on Linux, follow the instructions listed on GNU's website: https://www.gnu.org/software/make/

Docker

Docker is a set of platform as a service products that use OS-level virtualization to deliver software in packages called containers.

To install Docker, follow the instructions listed on Docker's website: https://docs.docker.com/desktop/#download-and-install

Install make on Windows

Windows does not support makefiles natively. So, we need to first install the chocolatey package manager before installing make.

Steps to Install chocolatey/choco on Windows 10

  1. Click Start and type "powershell"
  2. Right-click Windows Powershell and choose "Run as Administrator"
  3. Paste the following command into Powershell and press enter.
Set-ExecutionPolicy Bypass -Scope Process -Force; `iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))
  1. Answer Yes when prompted
  2. Close and reopen an elevated PowerShell window (Run as Administrator) to start using choco.

Source: How to install chocolatey/choco on Windows 10 by JC

Now, Run the following command in Powershell to install make and you can start using make in either the Command Prompt, Powershell or Git Bash:

choco install make

Platform Architecture

Our Platform is built using the following tools:

  • JupyterLab - An extensible environment for interactive and reproducible computing, based on the Jupyter Notebook and Architecture.
  • FastAPI - FastAPI is a Web framework for developing RESTful APIs in Python.
  • Caddy - The Caddy web server is an extensible, cross-platform, open-source web server written in Go. The name "Caddy" refers both to a helper for tedious tasks, and a way to organize multiple parts into a simplified system.
  • Prometheus - Prometheus is a free software application used for event monitoring and alerting.
  • Grafana - Grafana is a multi-platform open source analytics and interactive visualization web application. It provides charts, graphs, and alerts for the web when connected to supported data sources.

How To Run The Platform

We've done our development and testing on Windows 10 and used Git Bash to execute the commands and we recommend running Docker Engine as Administrator.

However, you shouldn't have any problem running the Platform on any other Operating System.

To watch a demo of the Real-Time Anomaly Detection Platform, execute the steps below.

  1. Clone this repository to your local computer. Alternatively, you can download the code as a zip file and extract it.
  2. Open Git Bash if you're on Windows or the Terminal if you're on Mac/Linux.
  3. cd into the anomaly-detection-platform directory.
  4. Open Makefile and set the variables DATASET_PATH and DOCKER_COMPOSE_PATH.
  5. Run the platform using the command make run-platform.
  6. Wait for docker to create/pull the necessary images and build all the containers. Upon completion, you should see the URLs to access the Prediction API, Prometheus and Grafana services.
  7. On your browser, access Grafana by gooing to the URL: http://localhost:3000/?orgId=1
  8. If prompted for Username and Password, use admin and admin respectively to login.
  9. Then, go to Dashboards -> Manage
  10. Click on the dashboard named Service.
  11. On the top-right corner, set Relative Time Range to 15 minutes and Refresh to 10s.
  12. Back on the Terminal/Git Bash, run make test-platform if you're on Windows. On Mac/Linux, use make test-platform OS=other.
  13. This should build a Python Virtual Environment on your local machine and run the tester.py script. Once you start seeing predictions on your terminal like the following: , switch back to Grafana on you browser and you should see the Prometheus metrics being tracked in real-time as long as tester.py is running.
  14. We're making only 1000 requests in tester.py. If you want the test to run longer, comment out
test_dataset[:1000].apply(predict, axis=1)

in tester/tester.py and uncomment the following line:

# test_dataset.apply(predict, axis=1) # uncomment to predict on full test set
  1. Once the simulation is done, it's time to clean up. First, stop the platform using the command make stop-platform.
  2. Then, clean up __pycache__ and the Python Virtual Environment using the command make remove-env.
  3. Finally, clean up the platform's docker images and containers by running the command make remove-all.

Makefile Documentation

Target Utility
help Lists all targets in this Makefile along with their descriptions
run-jupyter Build and Run a Jupyter Lab Container
build-api Build the Prediction API Docker Image
run-api Build and Run a Prediction API Container
run-platform Build and Run the entire Platform
run-all Run the Platform and the Jupyter Lab Container
stop-jupyter Kill and Delete the Jupyter Lab Container
stop-api Kill and Delete the Prediction API Container
stop-all Stop the Platform and the Jupyter Lab Container
remove-all Remove all the Docker images we've created
test-platform Create Python Virtual Environment, run the tester script and visualize output in Grafana
remove-env Delete the Python Virtual Environment created for testing

We recommend running make commands in run-stop pairs.

If you'd like to experiment with a different dataset or model, feel free to spin up a JupyterLab container by running the command, make run-jupyter. Once you're done with development, make sure to stop the container using the command make stop-jupyter.

To test the Prediction API, run make run-api and go to http://localhost:8000/docs. For each endpoint, you should have a button named Try it out. Click on it and then press Execute. Make sure that the data is in the right format when you make a POST request. Do make sure to stop the Prediction API container when you're done using the command make stop-api.

API Documentation

CURL Command for /prediction:

curl -X 'POST' \
  'http://localhost:8080/prediction' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "feature_vector": [
    194, 167
  ],
  "score": false
}'

Replace values for "feature_vector" with your input values for mean and standard deviation.

Set "score": true if you want anomaly_score included in the output.

CURL Command for /model_information:

curl -X 'GET' \
  'http://localhost:8080/model_information' \
  -H 'accept: application/json'

Acknowledgment

Articles and videos used as reference are documented in the reference directory.

If you run into issues while testing the platform, please create an issue on this GitHub repository at the following link and I'll be glad to fix it: https://github.com/koushikvikram/anomaly-detection-platform/issues

If you'd like to collaborate with me or hire me, please feel free to send an email to koushikvikram91@gmail.com

Make sure to check out other repositories on my homepage.