Files
ppf/documentation/dashboard.md
2025-12-24 00:20:29 +01:00

4.4 KiB

PPF Dashboard

Web dashboard available at /dashboard endpoint. Dark theme UI with auto-refresh (3s polling).

Header

Element Description
Checktype Badge Current validation mode (SSL/HTTP)
Profiling Badge Shown when profiling is enabled
Status Indicator Connection status (green dot = connected)
Last Update Timestamp of last data refresh

System Monitor Bar

Real-time system resource monitoring:

Metric Description
Load System load average (1m/5m/15m)
Memory RAM usage with progress bar and percentage
Disk Disk usage with progress bar and percentage
Process PPF process memory (RSS)

Primary Stats

Five key metrics displayed prominently:

Stat Description
Working Proxies Count of currently valid proxies (of total in database)
Tests This Session Total tests run, with passed/failed breakdown
Success Rate Percentage of successful proxy validations with progress bar
Test Rate Average tests per second
Uptime Session duration

Charts

Test Rate History (10 min)

  • Sparkline chart showing test rate over time
  • Current rate, peak rate, pass rate indicators

Success Rate History

  • Sparkline chart showing success rate over time
  • Recent success rate indicator

Latency Analysis

Metric Description
Average Mean response time
Min/Max Range of response times
P50/P90/P99 Percentile latencies
Histogram Response time distribution chart

Protocol Performance

Per-protocol statistics for HTTP, SOCKS4, and SOCKS5:

Field Description
Passed Number of successful validations
Tested Total tests for this protocol
Rate Success rate percentage

Test Results

Results Pie Chart

  • Visual breakdown of passed vs failed tests
  • Legend with counts and percentages

Failure Breakdown

  • Pie chart categorizing failure reasons:
    • timeout
    • refused
    • ssl
    • proxy (protocol error)
    • closed (connection closed)
    • unreachable
    • auth (authentication required)
    • judge_block (judge service blocked)
    • other

Geographic Distribution

Top Countries

  • Leaderboard of countries with most working proxies (session)

Top ASNs

  • Leaderboard of autonomous system numbers with most proxies

Worker Pool

Metric Description
Active Threads Current worker thread count with progress bar
Job Queue Pending validation jobs

Judge Services

Metric Description
Available Judges ready to use
In Cooldown Judges temporarily rate-limited
Top Performers Leaderboard of most successful judges

Tor Pool

Metric Description
Total Requests Cumulative Tor requests
Success Rate Tor circuit success percentage
Healthy Nodes Number of working exit nodes
Avg Latency Mean Tor circuit latency
Exit Nodes Visual grid of Tor host status

Anonymity Levels

Breakdown of proxy anonymity classifications:

Level Description
Elite No proxy headers revealed
Anonymous Adds proxy headers but hides real IP
Transparent Reveals original IP address

Search Engines

Scraper engine status:

Metric Description
Available Engines ready to query
In Backoff Engines temporarily rate-limited
Total Total configured engines
Top Engines Leaderboard by successful queries

SSL/TLS Security

Metric Description
SSL Tests Total SSL validations performed
Passed Successful SSL handshakes
Failed SSL validation failures
MITM Detected Proxies intercepting/modifying TLS
Cert Errors Certificate validation failures

Database Overview

Summary Stats

Metric Description
Database Size Total proxies in database
Tested (1h) Proxies tested in last hour
Added (24h) New proxies added in last 24 hours
Dead Proxies Proxies marked as non-working

Working by Protocol

  • Bar chart showing working proxy counts per protocol

Top Countries (All Time)

  • Leaderboard of countries in database

Technical Details

  • Endpoint: GET /dashboard
  • Refresh: 3 second polling via JavaScript
  • Data source: /api/stats JSON endpoint
  • Theme: Dark mode with color-coded status indicators