Files
ja4-platform/shared/clickhouse
toto f6e2d3c0ca feat(bot-detector): implement 8 state-of-art improvements
- EIF: Extended Isolation Forest via isotree (fallback to sklearn IF)
- Benford's Law deviation feature on inter-request timing
- Lag-1 autocorrelation feature for cadence analysis
- Validation gate: reject model if val_anomaly_rate > 20%
- Feature pruning: remove variance < 1e-6 features before training
- Quantile drift: replace N(μ,σ) synthetic with quantile interpolation
- Thread safety: Lock for _service_healthy/_consecutive_failures
- Score normalization: inverted to [0,1] where 1=most anomalous

SQL: add lag1_autocorrelation + benford_deviation to view_thesis_features_1h
Tests: 10 new test functions covering all improvements
Integration: verify_mvs.py checks new thesis feature columns

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-04-08 02:31:26 +02:00
..

ClickHouse Migrations — ja4-platform

Migration Order

Apply these files in numeric order against the ClickHouse server:

clickhouse-client --multiquery < 00_database.sql
clickhouse-client --multiquery < 01_raw_tables.sql
clickhouse-client --multiquery < 02_dictionaries.sql
clickhouse-client --multiquery < 03_anubis_tables.sql
clickhouse-client --multiquery < 04_mv_http_logs.sql
clickhouse-client --multiquery < 05_aggregation_tables.sql
clickhouse-client --multiquery < 06_ml_tables.sql
clickhouse-client --multiquery < 07_ai_features_view.sql
clickhouse-client --multiquery < 08_users.sql
clickhouse-client --multiquery < 09_audit_table.sql

File Descriptions

File Contents
00_database.sql CREATE DATABASE
01_raw_tables.sql http_logs_raw ingest table
02_dictionaries.sql ASN geo dict, bot IP/JA4/network reference tables
03_anubis_tables.sql Anubis crawler rule tables and dictionaries (UA, IP, ASN, country)
04_mv_http_logs.sql Canonical http_logs target table + mv_http_logs materialized view with full Anubis enrichment
05_aggregation_tables.sql agg_host_ip_ja4_1h, agg_header_fingerprint_1h + their MVs
06_ml_tables.sql ml_detected_anomalies, ml_all_scores
07_ai_features_view.sql view_ai_features_1h with Anubis enrichment
08_users.sql ClickHouse users and grants
09_audit_table.sql audit_logs table for SOC dashboard audit trail

Prerequisites

Place CSV data files in /var/lib/clickhouse/user_files/:

  • iplocate-ip-to-asn.csv — IP-to-ASN mapping (from IPLocate)
  • bot_ip.csv — Known bot IP prefixes
  • bot_ja4.csv — Known bot JA4 fingerprints
  • asn_reputation.csv — ASN reputation labels

Notes

  • 04_mv_http_logs.sql is the canonical version of the MV, superseding the base version in services/correlator/sql/init.sql. It includes full Anubis enrichment.
  • All migrations are idempotent (use IF NOT EXISTS / IF EXISTS).
  • Anubis dictionary passwords in 03_anubis_tables.sql must be changed before production use.