Vai al contenuto

Runbook Analytics Engine Pilot

Obiettivo

Attivare analytics-engine in modo progressivo su SafeOps, tenant per tenant, senza spostare in una volta sola tutti i calcoli fuori dal portale.

Perimetro iniziale

Primo vertical slice attivo: - snapshot commerciale.v1 - badge commerciali pesanti - contatore Bozze RAS

SafeOps resta: - host applicativo - IAM e tenant resolution - fallback locale se il motore esterno non e' disponibile

Prerequisiti

  • VM analytics-engine raggiungibile dalla VM SafeOps
  • ANALYTICS_ENGINE_INTERNAL_TOKEN identico su entrambi i lati
  • GET /health ok
  • GET /api/system/info ok con header token

Configurazione SafeOps

Pilot consigliato iniziale solo su tenant_safecondo:

ANALYTICS_ENGINE_ENABLED=true
ANALYTICS_ENGINE_ENABLED_TENANTS=tenant_safecondo
ANALYTICS_ENGINE_BASE_URL=http://<analytics-vm>:8091
ANALYTICS_ENGINE_INTERNAL_TOKEN=<shared-token>
ANALYTICS_ENGINE_TIMEOUT_SECONDS=10

Configurazione analytics-engine

ANALYTICS_ENGINE_INTERNAL_TOKEN=<shared-token>
ANALYTICS_SNAPSHOT_BACKEND=file
ANALYTICS_SNAPSHOT_DIR=./var/snapshots

Regola Tenant

Il collegamento a analytics-engine si attiva solo se: - ANALYTICS_ENGINE_ENABLED=true - il tenant effettivo e' dentro ANALYTICS_ENGINE_ENABLED_TENANTS

Se la allowlist e' vuota: - il collegamento vale per tutti i tenant

Attivazione Pilot

  1. configurare gli env reali su SafeOps
  2. configurare gli env reali su analytics-engine
  3. riavviare i due servizi
  4. testare tenant_safecondo
  5. verificare il cruscotto commerciale

Collaudo Minimo

Controllare su tenant_safecondo: - new portal count - unread admin replies - pending milestones - Bozze RAS

Controllare anche: - risposta 200 di POST /api/jobs/rebuild-snapshot - risposta 200 di GET /api/metrics/snapshot/commerciale - fallback locale ancora funzionante se il servizio esterno viene spento

Checklist Post-Attivazione

  • token interno coerente
  • tenant pilotato corretto
  • snapshot commerciale.v1 generato
  • Bozze RAS valorizzato
  • nessun errore 401 o 503 nel collegamento
  • nessun rallentamento nuovo lato dashboard commerciale

Rollback

Rollback rapido lato SafeOps:

ANALYTICS_ENGINE_ENABLED=false

oppure:

ANALYTICS_ENGINE_ENABLED_TENANTS=

se vuoi spegnere il pilot tenant-specifico senza rimuovere il codice.

Effetto: - SafeOps torna al percorso snapshot locale - dashboard e badge continuano a funzionare - nessun impatto sui workflow operativi

Cosa Non Toccare

  • non spostare ancora workflow o CRUD nel microservizio
  • non togliere il fallback locale in SafeOps
  • non aprire il servizio analytics a internet pubblica
  • non riusare token diversi tra SafeOps e analytics-engine