Documentazione / Per iniziare
Database
Cos'è il database, cosa contiene, quanto restano i dati e quanto spazio occupa.
CloseYourIt tiene tutto in PostgreSQL 17 con l'estensione pgvector. L'installer lo avvia in un container: non devi installarlo né configurarlo.
Cosa contiene
Un solo server PostgreSQL contiene quattro database:
| Database | Contiene | Nel backup |
|---|---|---|
closeyourit | i tuoi dati: progetti, ticket, errori, log, metriche, visite | sì |
closeyourit_queue | il lavoro in background in attesa | no |
closeyourit_cache | valori temporanei che si possono ricalcolare | no |
closeyourit_cable | gli aggiornamenti in diretta verso le pagine aperte | no |
Gli ultimi tre non contengono niente che ti mancherebbe: dopo un ripristino partono vuoti e si riempiono da soli.
I dati stanno nel volume Docker closeyourit_postgres. L'utente è closeyourit; la sua password è POSTGRES_PASSWORD in /opt/closeyourit/.env. Il database non è raggiungibile da fuori del server: nessuna porta è pubblicata.
Aprire una console
cd /opt/closeyourit
docker compose exec postgres psql -U closeyourit -d closeyourit
Leggi quanto vuoi. Non cambiare le righe a mano: l'app si aspetta che cambino seguendo le sue regole.
Quanto restano i dati
I dati vecchi si cancellano da soli. I valori predefiniti:
| Dati | Restano |
|---|---|
| Log | 14 giorni |
| Errori | 30 giorni |
| Campioni di prestazioni | 30 giorni |
| Campioni dei server | 30 giorni |
| Registrazioni delle sessioni | 30 giorni |
| Statistiche web | 365 giorni |
| Controlli di disponibilità | 730 giorni |
Ticket, commenti, progetti e persone non si cancellano mai per età.
Puoi cambiare ogni durata a tre livelli: l'intera installazione (area di amministrazione), una organizzazione, un progetto. Vince il livello più vicino: il valore del progetto batte quello dell'organizzazione, che batte quello dell'installazione. Un progetto può tenere i dati più a lungo della sua organizzazione.
Quanto spazio occupa
Dipende da quanto mandano le tue applicazioni. Log e statistiche web crescono più in fretta. Per vedere la dimensione:
cd /opt/closeyourit
docker compose exec postgres psql -U closeyourit -d closeyourit \
-c "SELECT pg_size_pretty(pg_database_size('closeyourit'))"
Se il disco si riempie, accorcia le durate qui sopra per i progetti più rumorosi. closeyourit doctor avvisa quando resta libero meno del 10% del disco.
Errori, log, metriche, visite e campioni dei server sono salvati in fette mensili. Quando un mese intero è oltre ogni durata, la sua fetta si cancella in un colpo e lo spazio torna subito libero sul disco.
Usare un tuo PostgreSQL
L'installer non lo prevede: l'indirizzo del database è fisso in compose.yml e punta al container che avvia. Un PostgreSQL esterno richiederebbe PostgreSQL 17, l'estensione pgvector, i quattro database qui sopra e un compose.yml modificato a mano. I comandi closeyourit backup e restore smetterebbero di funzionare, perché girano dentro il container del database.