Diagnostica, quote, recupero e reset
La diagnostica va letta su tre livelli: disponibilità del modulo, stato del profilo SMTP e stato della campagna o del piano. Una prova del profilo riuscita non elimina un blocco di autorizzazione della campagna; un worker attivo non dimostra la consegna di un messaggio.
Percorso di diagnosi
| Sintomo | Primo controllo | Decisione successiva |
|---|---|---|
| Il modulo non apre le schede | Tenant selezionato, messaggio di configurazione e capacità | Risolvere disponibilità/accesso prima di intervenire sui profili |
| Il profilo si salva ma il test non parte | Modifiche non salvate, permessi manage+send, prova già pendente, quote | Salvare o recuperare il tentativo esistente; leggere il codice prima di crearne un altro |
| Test accepted, campagna bloccata | Preflight nel riepilogo | Correggere ambito, versioni, destinatari o calendario: non riqualificare SMTP senza motivo |
| Campagna apparentemente ferma | Data del dato, motivo d'attesa e prossimo istante idoneo | Distinguere attesa programmata/quota da dato non aggiornato o errore del servizio |
| Destinatario segnala mancata ricezione con accepted | Tracciamento e quarantena del provider | La piattaforma ha conferma SMTP, non conferma del recapito nella posta in arrivo |
| Report non generato | Stato richiesta, assestamento invii e diagnostica report/storage | Ritentare il solo report dopo la correzione |
| Esito SMTP incerto | Riferimento del tentativo e verifica presso il provider | Conservare l'incertezza finché non risolta; non compensare con un nuovo invio automatico |
Controllare una campagna senza avanzamento
- Aprire Dettaglio → Avanzamento e leggere l'istante del dato. Usare Riprova/Aggiorna se la lettura è fallita o non aggiornata.
- Espandere Ripartizione completa e dettagli operativi: annotare pendenti, in corso, incerti, motivo attesa e prossimo invio idoneo.
- Se il motivo è
scheduledoquota, confrontare il prossimo istante con il calendario e la scadenza dell'ambito. Un'attesa prevista non richiede un riavvio. - Aprire Errori e blocchi e leggere fase, codice e azione suggerita. Un errore risolto storico non va confuso con un blocco attivo.
- Con i permessi amministrativi, aggiornare la diagnostica del modulo e confrontare ultima attività worker e code. Se le informazioni non bastano, inviare al supporto i riferimenti tecnici minimizzati.
- Dopo la correzione aggiornare lo stato; riprendere una campagna in pausa tramite Verifica e riprendi, senza ricrearla per tentativi.
Diagnostica del modulo
Aprire Diagnostica del modulo · amministrazione con authorization.manage. La schermata verifica:
| Componente | Cosa rappresenta |
|---|---|
| Gestione campagne | Disponibilità delle operazioni di gestione |
| Invii | Configurazione del servizio SMTP |
| Collegamenti delle simulazioni | Disponibilità del runtime pubblico delle landing |
| Report | Configurazione della produzione dei report |
| Protezione credenziali | Configurazione per proteggere e recuperare le credenziali |
| Archivio file | Configurazione dello storage di immagini ed export |
| Elaborazione campagne | Worker che elabora le attività |
Gli stati sono Configurato (ready), Non abilitato dalla piattaforma (disabled), Da verificare (blocked) e Configurato, accesso non verificato (unknown). Quest'ultimo non è una verifica riuscita dello storage o del provider.
Il pannello mostra data della verifica, ultima attività del worker e, quando disponibili, code di invio, report e retention. Il flag di conteggio limitato indica che sono stati rilevati soltanto i primi 1.000 elementi. Usare Aggiorna diagnostica dopo una modifica amministrativa.
Quote e attese SMTP
Questi sono i default dello schema di servizio nel repository; non sono una garanzia delle quote effettive dell'ambiente o del provider. Non sono campi del profilo mittente.
| Parametro | Default | Vincolo del servizio |
|---|---|---|
| Destinatari per campagna | 10.000 | Intero positivo, massimo 10.000 |
| Capacità campagne condivisa | 5 | Intero positivo, massimo 5 |
| Invii per account/minuto | 10 | Intero positivo, massimo 10 |
| Invii per account/giorno | 500 | Intero positivo, massimo 500 |
| Invii tenant/minuto | 50 | Intero positivo |
| Invii piattaforma/minuto | 50 | Intero positivo |
| Prove SMTP per ora | 10 | Intero positivo, massimo 10 |
| Intervallo minimo prove profilo | 60.000 ms | Almeno 60.000 ms |
| Timeout tentativo SMTP | 120.000 ms | Positivo, massimo 120.000 ms |
| Timeout preflight | 120.000 ms | Positivo, massimo 120.000 ms |
| Nuovi tentativi massimi | 2 | Intero 0–3 |
| Ritardo fra nuovi tentativi | 60.000 ms | Almeno 60.000 ms |
Il consumo è condiviso tra profili dello stesso account e con i limiti tenant/piattaforma. La quota giornaliera non va interpretata automaticamente come reset a mezzanotte: la stima del servizio considera la finestra di consumo. maxRetries riguarda gli esiti ritentabili; non autorizza a ripetere un messaggio di cui l'accettazione è incerta.
| Motivo di attesa | Interpretazione |
|---|---|
scheduled | Data o finestra di invio non ancora raggiunta |
quota | Quota temporaneamente esaurita; leggere Prossimo invio idoneo |
paused | Campagna in pausa |
profile_or_authorization | Profilo o autorizzazione da verificare |
transport_unavailable | Servizio di invio non disponibile |
Errori del profilo e della prova
| Codici / sintomo | Controlli e azione |
|---|---|
smtp_profile_changed, credential_context_mismatch | Ricaricare la configurazione; ricollegare o sostituire la credenziale se non corrisponde al profilo |
smtp_authentication_failed | Verificare account, password oppure OAuth e policy del provider |
oauth_not_configured | L'amministratore deve configurare OAuth nell'ambiente; la sola registrazione del profilo non basta |
oauth_refresh_required, oauth_reconnect_required, oauth_invalid_grant | Ricollegare Microsoft 365 prima di una nuova prova |
oauth_refresh_in_progress | Attendere l'esito del rinnovo già in corso |
oauth_provider_unavailable, oauth_refresh_unavailable | Attendere il ripristino del provider o del servizio di rinnovo |
profile_credentials_unavailable, smtp_credentials_unavailable | Verificare disponibilità delle credenziali del profilo |
sending_secret_key_unavailable, sending_secret_configuration_unavailable | Verifica amministrativa della protezione delle credenziali |
smtp_endpoint_unavailable, smtp_connection_failed | Verificare hostname, porta, TLS e raggiungibilità dal worker |
smtp_recipient_rejected | Verificare il destinatario del test presso il provider |
recipient_excluded | Scegliere un destinatario ammesso; non aggirare l'esclusione cambiando la forma dell'indirizzo |
sending_account_suspended | Registrare la risoluzione della sospensione dopo il riesame |
sending_quota_exhausted, sending_test_quota_exhausted | Attendere il ripristino della quota |
smtp_diagnostic_already_pending | Attendere e aggiornare la prova in corso |
smtp_diagnostic_key_invalid, smtp_diagnostic_request_conflict | Ricaricare e verificare lo stato della richiesta prima di crearne una nuova |
Errori di invio e report
| Esito | Azione |
|---|---|
smtp_temporary_rejection | Rifiuto prima dell'accettazione; leggere ritentabilità e prossimo tentativo |
smtp_permanent_rejection | Rifiuto definitivo; correggere profilo o destinatari prima di una nuova campagna |
smtp_acceptance_unknown, smtp_attempt_timeout, smtp_attempt_expired | Verificare l'esito presso il fornitore: un secondo invio può duplicare il messaggio |
PHISHING_REPORT_GENERATION_FAILED | Riprovare la generazione del solo report |
PHISHING_STORAGE_UNAVAILABLE, PHISHING_STORAGE_LIMIT | Verificare storage e capacità; ripetere l'operazione sul file quando disponibile |
public_runtime_unavailable | Correggere disponibilità delle landing prima di inviare; le bozze possono essere preparate |
identity_authority_unavailable | Attendere la verifica dell'autorità degli accessi; non dedurre che i permessi siano cambiati |
Nella scheda Errori e blocchi leggere fase (preflight, authentication, connection, dispatch, reconciliation, report), destinatari interessati, ritentabilità e risoluzione (active, resolved, terminal, uncertain). L'assenza di una scheda errore non annulla un conteggio delivery_unknown.
Per assistenza annotare l'istante, lo stato del tenant, versione della configurazione del profilo, codice e ID di correlazione. Non includere password, token OAuth o destinatari reali in materiale pubblico.
Recupero, esclusioni e disponibilità
restore_reconciliation_required, journal_reconciliation_required, perimeter_review_required e phishing_recovery_pending richiedono gestione amministrativa. In recupero non vengono riavviate automaticamente le campagne. La configurazione di piattaforma distingue abilitazione generale, invii, runtime pubblico e report: correggere il livello che produce il blocco.
La UI di riferimento non espone un editor generale delle variabili di runtime del modulo. Le impostazioni di ambiente e le chiavi sono responsabilità del gestore. La documentazione descrive i blocchi osservabili e i requisiti, senza presentare chiamate interne come API pubbliche.
Reset amministrativo
Il reset elimina i dati operativi delle simulazioni del tenant selezionato. È diverso da pausa, arresto campagna e disabilitazione del modulo. È riservato all'amministratore della piattaforma con accesso al tenant e compare nella diagnostica amministrativa.
L'anteprima mostra tenant, cliente, percorso, ambiente, versione dello stato, scadenza e conteggi degli elementi interessati:
- campagne e destinatari;
- profili, credenziali, modelli e immagini;
- autorizzazioni e grant;
- token, eventi e tentativi;
- report, export e oggetti storage;
- esclusioni, impostazioni delle chiavi di esclusione e altri record operativi.
Procedura
- Aprire l'anteprima e verificare tenant e ambiente, oltre ai conteggi.
- Usare Aggiorna anteprima se scaduta, indisponibile o non coerente con lo stato corrente.
- Scegliere Esamina il reset e leggere la conferma dell'operazione distruttiva.
- Digitare esattamente il testo di conferma indicato e avviare il reset.
- Seguire lo stato e i conteggi effettivamente eliminati fino al completamento.
| Stato | Fase |
|---|---|
requested | Richiesta registrata |
fenced | Operazioni ordinarie del tenant bloccate per il reset |
settling | Assestamento delle attività già in corso |
deleting-objects | Eliminazione degli oggetti storage |
deleting-rows | Eliminazione dei record operativi |
reinitializing | Ricostruzione dello stato iniziale |
completed | Reset completato, senza avvio automatico di invii |
failed-retryable | Interrotto; serve una ripetizione esplicita verificata |
Se resta un numero di operazioni I/O senza esito confermato, il blocco rimane attivo finché queste non sono state verificate. phishing_reset_io_unsettled riguarda l'assestamento; phishing_reset_storage_unavailable lo storage; phishing_reset_authority_unavailable la disponibilità dell'autorità/worker; phishing_reset_inventory_changed o phishing_reset_state_changed richiedono una nuova verifica dello stato.
Quando è ammesso il retry, Esamina la ripetizione richiede un'anteprima valida e la conferma corrente. Se non è chiaro se la prima richiesta sia stata registrata, usare Verifica la richiesta inviata per recuperarla, anziché avviare un reset indipendente.
Il reset non richiama email già accettate dal server di posta. Al termine il modulo torna allo stato iniziale: non esegue una nuova campagna automaticamente.