CLI per esperti: attività e report email

Identificare installazione e account di esecuzione

Gli esempi usano /var/www/html/obelisk e /usr/bin/php. Sostituiscili con percorso reale e PHP CLI dell’installazione. Collegati al PBX via SSH con autorizzazione sudo ed esegui un comando alla volta. Worker e utility che caricano le impostazioni applicative si eseguono normalmente come asterisk. I comandi indicati con sudo senza -u richiedono privilegi amministrativi del sistema.

Conserva il kit originale estratto e lo stato salvato. La cartella dell’installer è diversa dalla cartella applicativa. Prima di una riparazione identifica il guasto e conserva un backup adeguato. Non inserire password, chiavi API o credenziali SQL negli argomenti dei comandi, nelle schermate o nei log condivisi.

1. Entrare nella cartella applicativa

   I percorsi PHP relativi seguenti partono da qui. Questo comando cambia soltanto la cartella della sessione.

   Comando

   cd /var/www/html/obelisk

Leggere la pianificazione installata

L’installazione standard crea /etc/cron.d/obelisk con sei tipi di lavoro, tutti eseguiti come asterisk. Le righe dei comandi sono sette perché audio ha due avvii sfalsati. La tabella mostra i valori iniziali; i comandi ufficiali di pausa e ripresa conservano orari e opzioni personalizzati.

Gli orari Linux seguono il fuso di cron sul server. Gli eventi SQL usano il pianificatore del database e il fuso registrato per ciascun evento. Il fuso del report definisce il periodo: cambiarlo non ripianifica cron. Consulta il file installato e il pannello Eventi del database prima di interpretare un ritardo.

1. Consultare gli orari Linux effettivi

   Comando di sola lettura. Le righe che iniziano con # sono inattive. Questo file resta in /etc/cron.d: non importarlo con crontab.

   Comando

   sudo cat /etc/cron.d/obelisk

Sospendere e riprendere le elaborazioni pianificate

Esegui questi comandi dalla cartella del kit originale, dopo il completamento dell’installazione. Per percorsi personalizzati aggiungi le stesse opzioni --path e --php usate durante l’installazione. Lo strumento usa lo stato salvato e può richiedere accesso SQL amministrativo. Se mancano kit o stato, chiedi al supporto: non eseguire una nuova installazione sopra l’applicazione attiva.

1. Sospendere i nuovi avvii

   Disabilita le pianificazioni Linux Obelisk e i suoi eventi SQL min_queue/min_out. Non interrompe processi già avviati: attendine il completamento prima della manutenzione. Leggi l’esito: se l’accesso SQL fallisce, le pianificazioni Linux possono essere già disabilitate senza conferma sugli eventi SQL.

   Comando

   sudo bash install.sh --disable-jobs

2. Riprendere dopo le verifiche

   Riabilita le pianificazioni e richiede l’attivazione degli eventi SQL. Conserva orari/opzioni esistenti e mantiene distinti gli interruttori di cancellazione audio. Se attivare il pianificatore SQL globale avvierebbe eventi di altre applicazioni, valuta la domanda esplicita con l’amministratore SQL. Risolvi gli avvisi e ripeti lo stesso comando: la sola abilitazione Linux non conferma l’elaborazione SQL.

   Comando

   sudo bash install.sh --activate-jobs

3. Verificare entrambi i livelli

   In Amministrazione controlla pianificazione, osservazioni recenti e stato dell’elaborazione SQL. Verifica un nuovo avvio idoneo dopo la ripresa. Sospendere queste pianificazioni non arresta FreePBX e non impedisce a un esperto di lanciare deliberatamente un worker a mano.

Scegliere report e periodo corretti

Prima di rilanciare un report verifica date desiderate, fuso PBX/report, analisi delle registrazioni disponibili, Gemini, lingua, mittente SMTP e destinatari REPORT_EMAIL_TO in Sistema e utilità. Il report usa analisi salvate: non analizza automaticamente ogni audio ancora da elaborare.

Il fuso del report definisce i confini del calendario: non riscrive gli orari cron. Il pianificatore segue gli orari e il fuso configurati sul server. Controlla entrambi e verifica le date effettive nell’anteprima.

Verificare l’idoneità senza AI o email

Usa l’entry point diretto per vedere i messaggi nel terminale oltre che nel log configurato. Questi script passano dallo stesso esecutore ufficiale. Scegli il comando settimanale o mensile pertinente.

1. Controllare il settimanale

   Leggi periodo, fuso, summaries, minimum_summaries, copertura ed eligible. Date sconosciute e analisi incomplete possono ridurre il campione utilizzabile.

   Comando

   sudo -u asterisk /usr/bin/php cron_weekly_trends.php --dry-run

2. Controllare il mensile

   Leggi valid_calls, minimum_calls ed eligible. Il minimo mensile è di 10 chiamate utilizzabili. L’output identifica il periodo reale: non dedurlo soltanto dalla data del comando.

   Comando

   sudo -u asterisk /usr/bin/php cron_monthly_report.php --dry-run

Eseguire una volta e verificare l’invio

Dopo aver risolto la causa e verificato che il report non sia già stato consegnato, scegli uno dei comandi seguenti. L’esecuzione può consumare quota Gemini e invia ai destinatari reali attuali. L’avvio manuale non modifica il cron installato.

1. Generare il settimanale

   Attendi e leggi l’esito finale AI/SMTP. Una sospensione per configurazione, dati insufficienti o lock di un processo attivo non equivale a invio.

   Comando

   sudo -u asterisk /usr/bin/php cron_weekly_trends.php

2. Generare il mensile

   Usalo per il mese precedente. Non aggiungere --test soltanto perché stai diagnosticando: cambia il periodo e continua a inviare email.

   Comando

   sudo -u asterisk /usr/bin/php cron_monthly_report.php

3. Verificare l’esito finale

   Controlla subito il codice di uscita, poi log, osservazione in Amministrazione e casella email. Codice 0 può indicare anche uno skip intenzionale. Successo SMTP significa accettazione del server, non prova di arrivo in posta in entrata. Controlla spam, quarantena o tracciamento del server email.

   Comando

   echo $?

Trovare i log e distinguere gli esiti

L’esecutore risolve i log dalle impostazioni: non presumere una cartella logs fissa. --log-path restituisce il percorso del lavoro scelto senza avviare quel worker. Sostituisci weekly con monthly, audio, logger, cleaner o retention. Leggi il file restituito con il tuo strumento autorizzato e oscura destinatari e dettagli infrastrutturali prima di condividerlo.

1. Trovare il log settimanale

   L’output è un percorso, non l’esito di generazione del report.

   Comando

   sudo -u asterisk /usr/bin/php cron_run.php --log-path weekly