Lavorare con i controlli

Autore:Esadax
Aggiornato:15 mar 2025

Esadax monitora automaticamente vari aspetti della tua applicazione web utilizzando l'API Checks. Questa guida spiega come utilizzare i controlli nel flusso di lavoro Esadax.

Indice dei contenuti

  1. [Introduzione] (#introduction)
  2. Tipi di flussi
  3. Controlla il ciclo di vita
  4. Costruisci la tua integrazione di controlli

Introduzione

I controlli sono test e asserzioni che vengono eseguiti dopo ogni distribuzione riuscita. Contribuiscono a garantire l'integrità, l'affidabilità e le prestazioni dell'applicazione:

  • Verifica della correttezza del codice
  • Controllo delle connessioni interrotte
  • Monitoraggio dei parametri web vitali come il tempo di caricamento e i tassi di errore
  • Assicurarsi che tutti i componenti richiesti siano presenti

Tipi di flussi abilitati da Checks API

L'API Checks supporta tre tipi principali di flussi:

1. Controlli di base

  • Descrizione: Monitora pagine o API specifiche per assicurarti che rispondano correttamente.
  • Scopo: identificare problemi come errori, connessioni interrotte o risorse mancanti.

2. Performance

  • Descrizione: Raccogliere e confrontare le metriche vitali web (ad esempio, tempo di caricamento, dimensione della risposta).
  • Scopo: confrontare le nuove distribuzioni con le prestazioni di base per decidere il successo della distribuzione.

3. End-to-End

  • Descrizione: Consente di verificare che tutti i componenti richiesti siano presenti.
  • Scopo: garantire che la distribuzione sia completa e funzionale.

4. Ottimizzazione

  • Descrizione: Analizza le dimensioni dei pacchetti e ottimizza la gestione delle risorse.
  • Scopo: Migliorare le prestazioni del sito web riducendo i tempi di caricamento.

Ciclo di vita dei controlli

Il diagramma del ciclo di vita degli assegni spiega come Esadax gestisce gli assegni:

  1. Deployment creato (deployment.created webhook): si attiva quando viene creato un deployment, consentendo agli integratori di registrare i controlli.
  2. Pronto per la distribuzione (webhook deployment.ready): notifica agli integratori di iniziare a eseguire i controlli sulla nuova distribuzione.
  3. Completamento dei controlli: una volta ricevuti i risultati di tutti i controlli, Esadax applica gli alias e distribuisce l'applicazione live.

Costruisci la tua integrazione Checks

Per creare un'integrazione di successo:

  1. Soluzioni a bassa configurazione: fornisce controlli preconfigurati per una maggiore facilità d'uso.
  2. Processo di onboarding: guida gli sviluppatori dall'installazione alla distribuzione.
  3. Documentazione dei risultati: visualizza chiaramente i risultati dei test sulla dashboard di Esadax.
  4. Test personalizzati: consente agli utenti avanzati di estendere la funzionalità di controllo predefinita.

Anatomia delle API dei controlli

L'API Checks funziona nel modo seguente:

  • Eventi attivati:
    • deployment.created: Controlli del registro.
    • deployment.ready: Avvia l'esecuzione dei controlli.
  • Esecuzione dei controlli: Esadax attende il completamento di tutti i controlli prima di consentire la distribuzione live.

Questa guida ti aiuta a sfruttare l'API Checks di Esadax per garantire l'affidabilità e le prestazioni della tua applicazione web. Per ulteriori informazioni, consultare la documentazione di Esadax.