Documentazione / Usare CloseYourIt

Lavori programmati

Accorgersi quando un lavoro che deve partire da solo smette di partire, o parte e finisce male.

Un lavoro programmato parte da solo a intervalli: un backup notturno, un invio di email, una pulizia. CloseYourIt non lo fa partire. Ti avvisa quando non parte. A ogni giro il lavoro dice «sono partito»; se smette di dirlo, qualcuno se ne accorge.

Collegare un lavoro

Non c'è niente da creare in anticipo: il lavoro compare in elenco la prima volta che si fa vivo.

Apri Infrastruttura → Cron e premi Collega un lavoro. La pagina ha l'indirizzo e il comando già compilati per il progetto che scegli.
Serve il token di ingest del progetto. Se non ne hai uno, crealo da Vai ai codici di collegamento del progetto.
Scegli un nome breve per il lavoro, per esempio backup-notturno. È la parte finale dell'indirizzo.
Aggiungi questa riga in fondo al tuo lavoro, così parte solo quando il lavoro è arrivato alla fine:

curl -X POST https://<tuo-dominio>/api/v1/projects/<id-progetto>/crons/backup-notturno/check_in \
  -H "Authorization: Bearer $CYI_TOKEN"

Alla prima chiamata il lavoro compare in elenco. Nell'indirizzo non c'è nessun segreto: il token viaggia a parte, nell'intestazione.

Dire ogni quanto deve partire

Di partenza CloseYourIt si aspetta una chiamata ogni 60 minuti, con 5 minuti di tolleranza. Per cambiarli, aggiungi alla chiamata:

Campo	Significa
`expected_interval_minutes`	ogni quanti minuti dovrebbe partire
`grace_minutes`	quanti minuti di ritardo accetti prima di considerarlo mancato
`name`	il nome da mostrare nell'elenco
`environment`	l'ambiente, per esempio `production`

Per esempio, un lavoro che parte una volta al giorno:

curl -X POST https://<tuo-dominio>/api/v1/projects/<id-progetto>/crons/backup-notturno/check_in \
  -H "Authorization: Bearer $CYI_TOKEN" \
  -d 'expected_interval_minutes=1440' -d 'grace_minutes=30'

Puoi cambiare intervallo e tolleranza anche dopo, con Modifica nella pagina del lavoro.

Dire che è andato male

Se il lavoro è partito ma è finito male, dillo con status=fail e, se vuoi, il motivo:

curl -X POST https://<tuo-dominio>/api/v1/projects/<id-progetto>/crons/backup-notturno/check_in \
  -H "Authorization: Bearer $CYI_TOKEN" \
  -d 'status=fail' -d 'reason=Backup fallito: disco pieno'

La pagina del lavoro mostra il motivo accanto al tentativo, invece di un semplice «fallito». Con duration_ms puoi mandare anche quanto è durato.

Leggere lo stato

Stato	Significa
In attesa	non è ancora arrivata nessuna chiamata
OK	l'ultima chiamata è arrivata in tempo ed è andata bene
Mancato	la chiamata non è arrivata entro intervallo più tolleranza: il lavoro non è partito
Fallito	la chiamata è arrivata, ma il lavoro ha segnalato un errore

Nella pagina di un lavoro trovi i Check-in recenti, con esito, durata e motivo, e i Guasti: da quando, quanto sono durati e quanti tentativi.

Farsi avvisare

Quando un lavoro risulta Mancato parte l'avviso Cron mancato, se una regola lo copre. Le organizzazioni nuove hanno già la regola. Se manca, la pagina Cron dice quanti lavori sono senza avviso: premi Crea la regola. Oppure, in Avvisi → Regole di avviso, usa il modello Avvisami se un lavoro programmato non parte. Vedi Avvisi.

Un lavoro Fallito si vede nella sua pagina, ma non fa partire un avviso.

Sospendere o eliminare

Sospendi ferma i controlli e gli avvisi di un lavoro. Lo storico resta. Riprendi lo riaccende.

Elimina cancella il lavoro e tutto il suo storico. Se il lavoro continua a chiamare, ricompare alla chiamata successiva, con le impostazioni di partenza.