F7 · Raccolta dati per l'analisi e release di prova su Gitea #95

Closed
opened 2026-11-14 17:33:57 +01:00 by Alby96 · 1 comment
Owner

Fase 7 — Notizie · Decisione: docs/adr/0013-raccolta-dati-al-posto-della-prova-in-casa.md

Obiettivo

Al posto della prova di durata di 48 ore sul PC di sviluppo, interrotta più volte da spegnimenti e blocchi di Docker che non dipendevano da Anubis:

  1. L'utente scarica l'ultima release pubblicata su Gitea e la fa girare per il periodo che vuole.
  2. Poi scarica un rapporto di "dati per l'analisi" e lo incolla nella conversazione.
  3. L'analisi del rapporto sostituisce la verifica della prova di durata (#55).

Passi

  • Campionamento ogni 5 minuti del processo:

    • memoria (insieme di lavoro, privata, heap gestito), raccolte del GC e pause;
    • thread, handle, processore;
    • coda del pool di thread, contese dei lock, eccezioni;
    • dimensione del database.

    Il primo campione va scritto all'avvio. I campioni si conservano per 30 giorni.

  • Ogni esecuzione dei lavori in programma si registra: ritardo, durata, esito, errore.

  • Le chiamate HTTP verso l'esterno si misurano per destinazione: numero, errori, codici, tempi p50/p95/max. Si leggono dalle metriche di .NET, senza pacchetti.

  • Il rapporto in Markdown (anubis diagnostics) comprende:

    • versione e commit, piattaforma, sistema, motore del database, configurazione senza segreti;
    • i controlli della prova di durata sulla stessa finestra;
    • risorse nel tempo e tendenza, per riconoscere perdite di memoria;
    • riavvii, lavori, chiamate esterne;
    • avvisi ed errori dei registri raggruppati, dati, trading.

    Deve stare sotto i 60 KB e avere i segreti oscurati.

  • Il rapporto si scarica dal Diario ("Il computer che lo ospita") e da GET /api/diagnostica.md.

  • Test sui due motori: campioni, registrazione dei lavori, metriche HTTP, rapporto (sezioni, dimensione, oscuramento).

  • Release v0.7.0 su Gitea con la cartella per Windows e le istruzioni in italiano per avviarla e scaricare il rapporto.

Criteri di accettazione della fase a cui contribuisce

  • Il rapporto della prova di durata è in docs/ e non riporta ordini duplicati né differenze non spiegate. Qui diventa l'analisi del rapporto di raccolta dati dell'utente (ADR 0013).

Valgono sempre le sezioni 2, 16 e 19 della specifica, lo stack dell'ADR 0003 (al posto della sezione 3), i soli componenti esterni dell'ADR 0004 e le regole di docs/SVILUPPO.md.

**Fase 7 — Notizie** · Decisione: `docs/adr/0013-raccolta-dati-al-posto-della-prova-in-casa.md` ### Obiettivo Al posto della prova di durata di 48 ore sul PC di sviluppo, interrotta più volte da spegnimenti e blocchi di Docker che non dipendevano da Anubis: 1. L'utente scarica l'ultima release pubblicata su Gitea e la fa girare per il periodo che vuole. 2. Poi scarica un rapporto di "dati per l'analisi" e lo incolla nella conversazione. 3. L'analisi del rapporto sostituisce la verifica della prova di durata (#55). ### Passi - [ ] Campionamento ogni 5 minuti del processo: - memoria (insieme di lavoro, privata, heap gestito), raccolte del GC e pause; - thread, handle, processore; - coda del pool di thread, contese dei lock, eccezioni; - dimensione del database. Il primo campione va scritto all'avvio. I campioni si conservano per 30 giorni. - [ ] Ogni esecuzione dei lavori in programma si registra: ritardo, durata, esito, errore. - [ ] Le chiamate HTTP verso l'esterno si misurano per destinazione: numero, errori, codici, tempi p50/p95/max. Si leggono dalle metriche di .NET, senza pacchetti. - [ ] Il rapporto in Markdown (`anubis diagnostics`) comprende: - versione e commit, piattaforma, sistema, motore del database, configurazione senza segreti; - i controlli della prova di durata sulla stessa finestra; - risorse nel tempo e tendenza, per riconoscere perdite di memoria; - riavvii, lavori, chiamate esterne; - avvisi ed errori dei registri raggruppati, dati, trading. Deve stare sotto i 60 KB e avere i segreti oscurati. - [ ] Il rapporto si scarica dal Diario ("Il computer che lo ospita") e da `GET /api/diagnostica.md`. - [ ] Test sui due motori: campioni, registrazione dei lavori, metriche HTTP, rapporto (sezioni, dimensione, oscuramento). - [ ] Release `v0.7.0` su Gitea con la cartella per Windows e le istruzioni in italiano per avviarla e scaricare il rapporto. ### Criteri di accettazione della fase a cui contribuisce - Il rapporto della prova di durata è in `docs/` e non riporta ordini duplicati né differenze non spiegate. Qui diventa l'analisi del rapporto di raccolta dati dell'utente (ADR 0013). --- Valgono sempre le sezioni 2, 16 e 19 della specifica, lo stack dell'ADR 0003 (al posto della sezione 3), i soli componenti esterni dell'ADR 0004 e le regole di `docs/SVILUPPO.md`.
Alby96 added this to the Fase 7 — Notizie milestone 2026-11-14 17:33:57 +01:00
Alby96 added the Kind/FeatureKind/Testing
Priority
High
2
Area/Fondamenta
labels 2026-11-14 17:33:58 +01:00
Author
Owner

Fatto, con la PR #96 (merge 25e71b6) e la release v0.7.0.

Prove:

  • CI verde sul commit 9cf386d: test su SQLite e PostgreSQL e immagine, sia per il push sia per la PR.
    • Il primo tentativo su PostgreSQL del push era caduto perché il servizio del database dell'esecutore si era riavviato ("database system is in recovery mode").
    • Rilanciato, è passato. La stessa suite passa in locale su PostgreSQL 18.
  • DiagnosticsTests: 4 test su entrambi i motori. Campioni, esecuzioni dei lavori e chiamate HTTP diventano un rapporto senza segreti, sotto i 60 KB.
  • Prova dallo zip vero:
    • avviato in una cartella temporanea sulla porta 8899, procedura guidata completata;
    • /api/diagnostica.md e anubis diagnostics danno lo stesso rapporto, con versione 0.7.0 e commit;
    • il secondo campione conta le chiamate verso eea.okx.com con le durate.
  • Lo zip della release, anubis-0.7.0-win-x64.zip (3,4 MB), è costruito dal merge: versione 0.7.0+25e71b679ffb. L'hash dello zip riscaricato coincide (SHA-256 b284ccc4…a24ae8).

La prova di durata (#55) resta aperta finché il rapporto dell'utente non arriva in chat (ADR 0013).

Fatto, con la PR #96 (merge `25e71b6`) e la release [v0.7.0](https://gitea.encke-hake.ts.net/BalboSoft/Anubis/releases/tag/v0.7.0). Prove: - CI verde sul commit `9cf386d`: test su SQLite e PostgreSQL e immagine, sia per il push sia per la PR. - Il primo tentativo su PostgreSQL del push era caduto perché il servizio del database dell'esecutore si era riavviato ("database system is in recovery mode"). - Rilanciato, è passato. La stessa suite passa in locale su PostgreSQL 18. - `DiagnosticsTests`: 4 test su entrambi i motori. Campioni, esecuzioni dei lavori e chiamate HTTP diventano un rapporto senza segreti, sotto i 60 KB. - Prova dallo zip vero: - avviato in una cartella temporanea sulla porta 8899, procedura guidata completata; - `/api/diagnostica.md` e `anubis diagnostics` danno lo stesso rapporto, con versione 0.7.0 e commit; - il secondo campione conta le chiamate verso eea.okx.com con le durate. - Lo zip della release, `anubis-0.7.0-win-x64.zip` (3,4 MB), è costruito dal merge: versione `0.7.0+25e71b679ffb`. L'hash dello zip riscaricato coincide (SHA-256 `b284ccc4…a24ae8`). La prova di durata (#55) resta aperta finché il rapporto dell'utente non arriva in chat (ADR 0013).
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: BalboSoft/Anubis#95