Monitoraggio di Rekognition con Amazon CloudWatch

Con CloudWatch, puoi ottenere metriche per singole operazioni di Rekognition o metriche globali di Rekognition per il tuo account, puoi utilizzare le metriche per monitorare lo stato della tua soluzione basata su Rekognition e impostare allarmi per avvisarti quando una o più metriche superano una soglia definita. Ad esempio, puoi impostare parametri per una serie di errori del server che si sono verificati oppure per il numero di volti che sono stati rilevati. Puoi anche visualizzare le metriche relative al numero di volte in cui una specifica operazione di Rekognition ha avuto successo. Per visualizzare le metriche, puoi usareAmazon CloudWatch,AmazonAWS Command Line Interface, o ilCloudWatch API.

Puoi anche visualizzare le metriche aggregate, per un periodo di tempo selezionato, utilizzando la console Rekognition. Per ulteriori informazioni, consulta Esercizio 4: visualizzare i parametri aggregati (console).

Usando CloudWatch metriche per Rekognition

Per utilizzare i parametri, devi specificare le seguenti informazioni:

• La dimensione del parametro o nessuna dimensione. Una dimensione è una coppia nome-valore che consente di identificare un parametro in modo univoco. Rekognition ha una dimensione, denominataOperazione. che fornisce parametri per un'operazione specifica. Se non specifichi una dimensione, la metrica è limitata a tutte le operazioni di Rekognito e delle tue altre soluzioni.

• Il nome del parametro, ad esempio UserErrorCount.

È possibile ottenere i dati di monitoraggio per Rekognition utilizzando ilAWS Management Console, ilAWS CLI, o CloudWatch API. È inoltre possibile utilizzare il CloudWatch API tramite uno degli Amazon AWS CloudWatch Strumenti API. La console visualizza una serie di grafici basati sui dati grezzi di CloudWatch API. In base alle tue esigenze, potresti decidere di utilizzare i grafici visualizzati nella console o quelli recuperati dall'API.

L'elenco seguente mostra alcuni usi comuni dei parametri. Questi suggerimenti sono solo introduttivi e non costituiscono un elenco completo.

Come?	Parametri rilevanti
Come è possibile monitorare il numero di volti riconosciuti?	Monitora la statistica Sum del parametro DetectedFaceCount.
Come è possibile sapere se l'applicazione ha raggiunto il numero massimo di richieste al secondo?	Monitora la statistica Sum del parametro ThrottledCount.
Come è possibile monitorare gli errori di richiesta?	Utilizza la statistica Sum del parametro UserErrorCount.
Come è possibile trovare il numero totale di richieste?	Utilizza le statistiche ResponseTime e Data Samples del parametro ResponseTime. Questo parametro include tutte le richieste che generano un errore. Se desideri visualizzare solo le chiamate alle operazioni riuscite, utilizza il parametro SuccessfulRequestCount.
Come è possibile monitorare la latenza delle chiamate alle operazioni di Rekognition?	Utilizza il parametro ResponseTime.
Come posso monitorare quante volteIndexFaceshai aggiunto con successo volti alle collezioni Rekognition?	Monitora la statistica Sum con il parametro SuccessfulRequestCount e l'operazione IndexFaces. Utilizza la dimensione Operation per selezionare l'operazione e il parametro.

È necessario disporre dell'appropriato CloudWatch autorizzazioni per monitorare Rekognition con CloudWatch. Per ulteriori informazioni, vedi Autenticazione e controllo degli accessi per Amazon CloudWatch).

Accedi alle metriche di Rekognito

I seguenti esempi mostrano come accedere alle metriche di Rekognito e delle tue altre soluzioni. CloudWatch console,AWS CLI, e il CloudWatchAPI.

Come visualizzare i parametri (console)

1. Aprire il CloudWatch console ahttps://console.aws.amazon.com/cloudwatch/.

2. Scegli Metrics (Parametri), scegli la scheda All Metrics (Tutti i parametri), quindi Rekognition.

3. Scegli Metrics with no dimensions (Parametri senza dimensioni), quindi scegli un parametro.

   Ad esempio, scegliDetectedFacemetrica per misurare quanti volti sono stati rilevati.

4. Seleziona un valore per l'intervallo di date. Il conteggio dei parametri viene visualizzato nel grafico.

Per visualizzare i parametri delle chiamate all'operazione DetectFaces eseguite correttamente in un periodo di tempo (CLI)

• Apri AWS CLI e immetti il comando seguente:

  aws cloudwatch get-metric-statistics --metric-name SuccessfulRequestCount --start-time 2017-1-1T19:46:20 --end-time 2017-1-6T19:46:57 --period 3600 --namespace AWS/Rekognition --statistics Sum --dimensions Name=Operation,Value=DetectFaces --region us-west-2

  Questo esempio mostra le chiamate all'operazione DetectFaces eseguite correttamente in un periodo di tempo. Per ulteriori informazioni, consulta la paginaget-metric-statistics.

Per accedere alle metriche (CloudWatch API)

• Chiamare GetMetricStatistics. Per ulteriori informazioni, consulta ilAmazon CloudWatch Riferimento API.

Creazione di un allarme

È possibile creare un CloudWatch allarme che invia un messaggio Amazon Simple Notification Service (Amazon SNS) quando l'allarme cambia stato. Un allarme controlla un singolo parametro in un periodo di tempo specificato ed esegue una o più operazioni in base al valore del parametro relativo a una determinata soglia in una serie di periodi di tempo. L'operazione corrisponde all'invio di una notifica a un argomento di Amazon SNS o a una policy di Auto Scaling.

Gli allarmi richiamano operazioni solo per le modifiche di stato prolungate. CloudWatch gli allarmi non richiamano azioni semplicemente perché si trovano in uno stato particolare. È necessario che lo stato cambi e rimanga costante per un periodo specificato

Per impostare un allarme (console)

1. Accedi alAWS Management Consolee apri il CloudWatch console ahttps://console.aws.amazon.com/cloudwatch/.

2. Scegli Create Alarm (Crea allarme). Viene avviata la procedura guidata per la creazione di allarmi.

3. Nell'elenco Metrics with no dimensions (Parametri senza dimensioni), scegli Rekognition Metrics (Parametri Rekognition), quindi scegli un parametro.

   Ad esempio, scegliDetectedFaceCountper impostare un allarme per un numero massimo di volti rilevati.

4. Nell'area Time Range (Intervallo di tempo), seleziona un valore per l'intervallo di tempo che includa le operazioni di rilevamento facciale che hai richiamato. Seleziona Next (Successivo).

5. Compila i campi Name (Nome) e Description (Descrizione). Per Whenever (Ogni volta), scegli >= e inserisci un valore massimo che preferisci.

6. Se vuoi CloudWatch per inviarti un'e-mail quando viene raggiunto lo stato di allarme, perOgni volta che viene emesso questo allarme:, scegliLo stato è ALLARME. Per inviare allarmi a un argomento esistente di Amazon SNS, perInvia notifica a:, scegli un argomento SNS. Per impostare il nome e gli indirizzi e-mail per un nuovo elenco di abbonamenti e-mail, scegliCrea argomento CloudWatch salva l'elenco e lo visualizza sul campo in modo da poterlo utilizzare per impostare allarmi futuri.

   Nota

   Se si utilizzaCrea argomentoper creare un nuovo argomento Amazon SNS, gli indirizzi e-mail devono essere verificati prima che i destinatari previsti ricevano le notifiche. Amazon SNS invia e-mail solo quando l'allarme entra in uno stato di allarme. Se lo stato cambia prima della verifica degli indirizzi e-mail, i destinatari previsti non riceveranno una notifica.

7. Visualizza un'anteprima dell'allarme nella sezione Alarm Preview (Anteprima allarme). Scegli Create Alarm (Crea allarme).

Per impostare un allarme (AWS CLI)

• Apri AWS CLI e immetti il comando seguente. Modifica il valore dialarm-actionsparametro per fare riferimento a un argomento di Amazon SNS creato in precedenza.

  aws cloudwatch put-metric-alarm --alarm-name UserErrors --alarm-description "Alarm when more than 10 user errors occur" --metric-name UserErrorCount --namespace AWS/Rekognition --statistic Average --period 300 --threshold 10 --comparison-operator GreaterThanThreshold --evaluation-periods 2 --alarm-actions arn:aws:sns:us-west-2:111111111111:UserError --unit Count

  Questo esempio mostra come creare un allarme quando si verificano più di 10 errori utente in 5 minuti. Per ulteriori informazioni, consulta la paginaput-metric-alarm.

Per impostare una sveglia (CloudWatch API)

• Chiamare PutMetricAlarm. Per ulteriori informazioni, consulta la paginaAmazon CloudWatch Riferimento API.

CloudWatchmetriche per Rekognition

Questa sezione contiene informazioni su Amazon CloudWatch metriche eOperazionedimensione disponibile per Amazon Rekognito.

Puoi anche visualizzare una vista aggregata delle metriche di Rekognition dalla console Rekognition. Per ulteriori informazioni, consulta Esercizio 4: visualizzare i parametri aggregati (console).

CloudWatch metriche per Rekognition

La tabella seguente riassume le metriche di Rekognito.

Parametro	Descrizione
SuccessfulRequestCount	Il numero di richieste eseguite correttamente. L'intervallo di codici di risposta per una richiesta eseguita correttamente è compreso tra 200 a 299. Unità: numero Statistiche valide: Sum,Average
ThrottledCount	Il numero di richieste sottoposte a throttling. Rekognition limita una richiesta quando riceve più richieste rispetto al limite di transazioni al secondo impostato per il tuo account. Se il limite impostato per il tuo account viene superato frequentemente, puoi richiedere un aumento del limite. Per richiedere un aumento, consulta Service Limits per AWS. Unità: numero Statistiche valide: Sum,Average
ResponseTime	Il tempo in millisecondi impiegato da Rekognition per calcolare la risposta. Unità: Conteggio delle statistiche Data Samples Millisecondi per le statistiche Average Statistiche valide: Data Samples,Average Nota LaResponseTimela metrica non è inclusa nel riquadro delle metriche Rekognition.
DetectedFaceCount	Il numero di volti rilevati con l'operazione IndexFaces o DetectFaces. Unità: numero Statistiche valide: Sum,Average
DetectedLabelCount	Il numero di etichette rilevate con l'operazione DetectLabels. Unità: numero Statistiche valide: Sum,Average
ServerErrorCount	Il numero di errori del server. L'intervallo di codici di risposta per un errore del server è compreso tra 500 a 599. Unità: numero Statistiche valide: Sum, Average
UserErrorCount	Il numero di errori utente (parametri non validi, immagine non valida, nessuna autorizzazione e così via). L'intervallo di codici di risposta per un errore utente è compreso tra 400 e 499. Unità: numero Statistiche valide: Sum,Average
MinInferenceUnits	Il numero minimo di unità di inferenza specificato duranteStartProjectVersionrichiesta. Unità: numero Statistiche valide: Average
MaxInferenceUnits	Il numero massimo di unità di inferenza specificato duranteStartProjectVersion richiesta. Unità: numero Statistiche valide: Average
DesiredInferenceUnits	Il numero di unità di inferenza a cui Rekognition sta aumentando o diminuendo. Unità: numero Statistiche valide: Average
InServiceInferenceUnits	Il numero di unità di inferenza utilizzate dal modello. Unità: numero Statistiche valide: Average Si consiglia di utilizzare la statistica Average per ottenere la media di 1 minuto del numero di istanze utilizzate.

CloudWatch metriche per Rekognition Streaming

Rekognition ha anche un secondo namespace utilizzato per le operazioni di streaming, «Rekognition Streaming». La tabella seguente riassume le metriche di Rekognito e delle tue metriche.

Parametro	Descrizione
SuccessfulRequestCount	Il numero di richieste eseguite correttamente. L'intervallo di codici di risposta per una richiesta eseguita correttamente è compreso tra 200 a 299. Unità: numero Statistiche valide: Sum,Average
CallCount	Il numero di operazioni specificate eseguite nel tuo account. Statistiche valide: Sum,Average
ThrottledCount	Il numero di richieste sottoposte a throttling. Rekognition limita una richiesta quando riceve più richieste rispetto al limite di transazioni al secondo impostato per il tuo account. Se il limite impostato per il tuo account viene superato frequentemente, puoi richiedere un aumento del limite. Per richiedere un aumento, consulta Service Limits per AWS. Unità: numero Statistiche valide: Sum,Average
ServerErrorCount	Il numero di errori del server. L'intervallo di codici di risposta per un errore del server è compreso tra 500 a 599. Unità: numero Statistiche valide: Sum, Average
UserErrorCount	Il numero di errori utente (parametri non validi, immagine non valida, nessuna autorizzazione e così via). L'intervallo di codici di risposta per un errore utente è compreso tra 400 e 499. Unità: numero Statistiche valide: Sum,Average

CloudWatch dimensione per Rekognito

Per recuperare i parametri specifici delle operazioni, utilizza il namespace di Rekognition e fornisci una dimensione per l'operazione.

Per ulteriori informazioni sulle dimensioni, vedereDimensioninelAmazon CloudWatch Guida per l'utente.

CloudWatch dimensione per le etichette personalizzate Rekognito

La tabella seguente mostra le CloudWatch dimensioni disponibili per l'uso con le etichette personalizzate Rekognition:

Dimensione	Descrizione
ProjectName	Il nome del progetto Rekognition Custom Labels con cui hai creatoCreateProject.
VersionName	Il nome della versione del progetto Rekognition Custom Labels con cui hai creatoCreateProjectVersion.

Per ulteriori informazioni sulle dimensioni, vedereDimensioninelAmazon CloudWatch Guida per l'utente.