Creazione di un Canary

Per creare un Canary

1. Apri la CloudWatch console all'indirizzo. https://console.aws.amazon.com/cloudwatch/

2. Nel riquadro di navigazione, scegli Application Signals, Synthetics Canaries.

3. Scegli Create Canary (Crea Canary).

4. Scegli una delle seguenti opzioni:

   • Per basare il canary su uno script di blueprint, scegli Use a blueprint (Usa un blueprint), quindi scegli il tipo di canary che desideri creare. Per ulteriori informazioni sulle attività di ciascun tipo di blueprint, consulta Utilizzo dei blueprint dei canary.

   • Per caricare il tuo script Node.js per creare un Canary personalizzato, scegli Upload a script (Carica uno script).

     Puoi quindi trascinare lo script in Script o scegliere Browse files (Sfoglia file) per passare allo script nel file system.

   • Per importare lo script da un bucket S3, scegli Import from S3 (Importa da S3). Quindi, in Source location (Posizione origine), digita il percorso completo al canary o scegli Browse S3 (Sfoglia S3).

     È necessario disporre delle autorizzazioni s3:GetObject e s3:GetObjectVersion per il bucket S3 in uso. Il bucket deve trovarsi nella stessa AWS regione in cui state creando il canarino.

5. In Name (Nome), immetti un nome per il Canary. Il nome viene utilizzato in molte pagine, pertanto è consigliabile assegnare un nome descrittivo che lo distingua da altri canary creati.

6. In Applicazione o endpoint URL, inserisci URL quello che desideri venga testato dal canarino. Questo URL deve includere il protocollo (ad esempio https://).

   Se desideri che Canary esegua il test di un endpoint su un dispositivoVPC, devi anche inserire le informazioni relative a una fase VPC successiva di questa procedura.

7. Se utilizzi il tuo script per il canary, in Lambda handler (Gestore Lambda), immetti il punto d'ingresso da cui avviare il canary. Se utilizzi un runtime precedente a syn-nodejs-puppeteer-3.4 o syn-python-selenium-1.1, la stringa immessa deve terminare con .handler. Se utilizzi syn-nodejs-puppeteer-3.4 o syn-python-selenium-1.1 oppure un runtime successivo, questa restrizione non viene applicata.

8. Se utilizzi variabili di ambiente nello script, scegli Environment variables (Variabili di ambiente) e specifica un valore per ciascuna variabile di ambiente definita nello script. Per ulteriori informazioni, consulta Variabili di ambiente.

9. In Schedule (Pianifica), scegli se eseguire questo canary una volta, continuamente utilizzando un'espressione Rate o utilizzando un'espressione Cron.

   • Quando usi la CloudWatch console per creare un canarino che funziona ininterrottamente, puoi scegliere una frequenza compresa tra una volta al minuto e una volta all'ora.

   • Per ulteriori informazioni sulla scrittura di un'espressione Cron per la pianificazione del canary, consulta Pianificazione delle esecuzioni di canary usando cron.

10. (Facoltativo) Per impostare un valore di timeout per il canary, scegli Additional configuration (Configurazione aggiuntiva), quindi specificare il valore di timeout. Non più breve di 15 secondi per consentire l'avvio a freddo Lambda e il tempo necessario per avviare la strumentazione canary.

11. In Data retention (Conservazione dei dati), specifica per quanto tempo conservare le informazioni relative a esecuzioni Canary non riuscite e riuscite. L'intervallo è 1-455 giorni.

    Questa impostazione influisce solo sui dati che CloudWatch Synthetics archivia e visualizza nella console. Non influisce sui dati memorizzati nei bucket Amazon S3 o su registri o parametri pubblicati dal Canary.

12. In Data Storage (Storage dati), seleziona il bucket S3 da utilizzare per memorizzare i dati delle esecuzioni del canary. Il nome del bucket non può contenere un punto (.). Se lo lasci vuoto, verrà utilizzato o creato un bucket S3 predefinito.

    Se si utilizza il runtime syn-nodejs-puppeteer-3.0 o una versione successiva, quando si immette il URL parametro for the bucket nella casella di testo, è possibile specificare un bucket nella regione corrente o in un'altra regione. Se utilizzi una versione runtime precedente, il bucket deve trovarsi nell'area corrente.

13. (Facoltativo) Per impostazione predefinita, i canarini archiviano i propri artefatti su Amazon S3 e gli artefatti vengono crittografati quando sono inattivi utilizzando una chiave gestita. AWS AWS KMS È possibile utilizzare un'opzione di crittografia diversa scegliendo Configurazione aggiuntiva nella sezione Archiviazione dati. È quindi possibile scegliere il tipo di chiave da utilizzare per la crittografia. Per ulteriori informazioni, consulta Crittografia di artefatti canary.

14. In Autorizzazioni di accesso, scegli se creare un IAM ruolo per eseguire The Canary o utilizzarne uno esistente.

    Se il ruolo è stato CloudWatch creato da Synthetics, include automaticamente tutte le autorizzazioni necessarie. Se si desidera creare personalmente il ruolo, consulta Ruoli e autorizzazioni richiesti per i canary per ottenere informazioni sulle autorizzazioni necessarie.

    Se usi la CloudWatch console per creare un ruolo per un canarino quando crei il canarino, non puoi riutilizzare il ruolo per altri canarini, perché questi ruoli sono specifici per un solo canarino. È possibile utilizzare un ruolo esistente solo se è stato creato manualmente un ruolo che funziona per più canary.

    Per utilizzare un ruolo esistente, è necessario disporre dell' autorizzazione iam:PassRole per passare tale ruolo a Synthetics e Lambda. Devi anche avere l'autorizzazione iam:GetRole.

15. (Facoltativo) In Allarmi, scegli se desideri creare CloudWatch allarmi predefiniti per questo canarino. Se scegli di creare allarmi, questi vengono creati con la seguente convenzione di denominazione: Synthetics-Alarm-canaryName-index

    index è un numero che rappresenta ogni allarme creato per questo canary. Il primo allarme ha un indice di 1, il secondo allarme ha un indice di 2 e così via.

16. (Facoltativo) Per fare in modo che questo canarino verifichi un endpoint che si trova su aVPC, scegli VPCle impostazioni, quindi procedi come segue:

    1. Seleziona VPC quello che ospita l'endpoint.

    2. Seleziona una o più sottoreti sul tuo. VPC È necessario selezionare una sottorete privata perché l'istanza Lambda non può essere configurata per l'esecuzione in una sottorete pubblica quando non è possibile assegnare un indirizzo IP all'istanza Lambda durante l'esecuzione. Per ulteriori informazioni, consulta Configurazione di una funzione Lambda per accedere alle risorse in a. VPC

    3. Seleziona uno o più gruppi di sicurezza sul tuo. VPC

    Se l'endpoint è su unVPC, devi abilitare il tuo canary a inviare informazioni ad CloudWatch Amazon S3. Per ulteriori informazioni, consulta Far correre un canarino su un VPC.

17. (Facoltativo) In Tags (Tag), aggiungere facoltativamente una o più coppie chiave/valore come tag per questo canary. I tag possono aiutarti a identificare e organizzare le tue AWS risorse e tenere traccia dei costi. AWS Per ulteriori informazioni, consulta Taggare le tue risorse Amazon CloudWatch .

18. (Facoltativo) In Active tracing (Tracciamento attivo) scegli se abilitare il tracciamento attivo con X-Ray per questo canary. Questa opzione è disponibile solo se il canary utilizza la versione runtime syn-nodejs-2.0 o versione successiva. Per ulteriori informazioni, consulta Canary e tracciamento X-Ray.