Skip to content

AI-powered NOC assistant for forecasting network outages, analyzing root causes, and recommending proactive resolutions using LLM and time-series intelligence.

License

Notifications You must be signed in to change notification settings

moses000/mysoftware-nocNetIntel

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

4 Commits
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿง  Noc-netIntel โ€“ AI-Powered Network Operations Intelligence Assistant

Noc-netIntel is an intelligent chat-driven platform designed to forecast critical network outages, provide possible root cause explanations, suggest proactive FME (Field Maintenance Engineer) deployment, and recommend resolutions โ€” all powered by advanced AI, NLP, and time-series forecasting.

๐Ÿ’ก What It Does

  • ๐Ÿ”ฎ Predicts outages today, tomorrow, and over the week
  • ๐Ÿ“‰ Identifies root causes using LSTM + LLM reasoning
  • ๐Ÿ“… Schedules field engineers proactively
  • ๐Ÿง  Suggests resolutions from a growing knowledge base
  • ๐Ÿ’ฌ Conversational interface with LLM (DeepSeek/OpenAI-compatible)

๐Ÿ›  Technology Stack

Layer Tech
AI/NLP DeepSeek / Custom LLM
ML/Forecasting PyTorch + Custom LSTM
Backend Python (FastAPI preferred)
Frontend JavaScript (React recommended)
Database PostgreSQL
Data Pipeline Python Scripts / Celery Tasks
Deployment Docker & Docker Compose
Scheduler (optional) Celery + Redis for task management

๐Ÿงฌ End-to-End Workflow

1. ๐Ÿ”— Data Collection

  • Sources: Sensor logs, BTS data, voltage/current levels, historical tickets, alarms
  • Stored in PostgreSQL (structured) and optional object storage (raw logs)

2. ๐Ÿงน Data Preprocessing

  • Cleansing missing/nulls, noise filtering
  • Timestamp alignment, interpolation
  • Scaling, encoding categorical signals (battery status, alarm type)

3. ๐Ÿ”ง Feature Engineering

  • Temporal signals: time of day, day of week, holiday
  • Environmental: power metrics, weather (optional)
  • Historical: frequency of past outages, lag features
  • Rolling stats: moving average, rate of failure

4. ๐Ÿ“Š ML Forecasting (PyTorch + LSTM)

  • Input: Sequence of multivariate time series
  • Architecture: Multi-head LSTM โ†’ Dense heads (classification + regression)
  • Outputs:
    • Outage probability
    • Affected region/site
    • Possible root cause embeddings
  • Metrics: F1, AUC for classification; RMSE for regression

5. ๐Ÿง  NLP Reasoning Layer (DeepSeek / LLM)

  • Converts ML output into readable advice
  • Enhances with historical patterns and predefined rules
  • Formats chat response: outage + root cause + FME plan + resolution

6. ๐Ÿ“… Proactive FME Scheduler

  • Ranks urgency and location clustering
  • Optimizes FME routing using heuristic or ML-based dispatch
  • Integrates with external calendars/ticketing if needed

๐Ÿ’ฌ Sample Chat Interaction

User: "What outages are expected tomorrow in the North East zone?"
Noc-netIntel:

๐Ÿ›‘ Predicted 3 possible outages:

  • Site BGH-29 (Power drain) โ€“ 87% chance
  • Site TMT-02 (Overload) โ€“ 72% chance
  • Site JAK-10 (Backhaul degradation) โ€“ 55% chance

๐Ÿ“Œ Root Causes: Battery degradation, high load demand, backhaul link instability ๐Ÿ›  Recommended Actions: Pre-deploy backup power units, initiate remote checks ๐Ÿ‘ท FME Suggestion: Team Alpha, report at 06:30 AM

๐Ÿš€ API Overview

  • POST /chat โ€“ Accepts user prompt, returns AI-generated insight
  • GET /forecast โ€“ Returns raw model prediction
  • GET /schedule โ€“ Lists recommended FME deployments
  • GET /logs โ€“ Access recent outage logs (if allowed)

Full Swagger UI at: http://localhost:8000/docs

๐Ÿ—ƒ Sample PostgreSQL Schema

CREATE TABLE outage_forecasts ( id SERIAL PRIMARY KEY, site_code TEXT, prediction_date TIMESTAMP, outage_probability FLOAT, root_cause TEXT, fme_plan TEXT, resolution TEXT );

๐Ÿณ Setup and Deployment

โœ… Prerequisites

  • Docker & Docker Compose
  • Python 3.9+
  • Node.js (for frontend)

๐Ÿ“ฆ Running Locally

bash git clone https://github.com/moses000/mysoftware-nocNetIntel cd noc-netintel

Run with Docker Compose

docker-compose up --build

Services:

  • backend: FastAPI ML/NLP engine
  • frontend: React chat UI (optional)
  • ml_worker: PyTorch + model runner
  • postgres: SQL data store

๐Ÿ” Auth & Roles

  • JWT-based auth
  • Roles: Admin, Analyst, Engineer
  • Granular data access policies

๐Ÿ“Š Monitoring & Logging

  • Optional: Add Grafana for real-time alert visualization
  • Backend logs all predictions and user queries
  • Alerts for model drift / threshold breaches

โœ๏ธ Wiki & Docs

  • ๐Ÿ“˜ docs/data-pipeline.md: Ingestion, ETL, transformations
  • ๐Ÿ“˜ docs/model.md: LSTM architecture, training notes
  • ๐Ÿ“˜ `docs

About

AI-powered NOC assistant for forecasting network outages, analyzing root causes, and recommending proactive resolutions using LLM and time-series intelligence.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published