View a markdown version of this page

Monitoraggio di Amazon Textract - Amazon Textract
Utilizzo delle CloudWatch metriche per Amazon TextractAccedi a Amazon Textract MetricsCreazione di un allarme

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Monitoraggio di Amazon Textract

Con CloudWatch, puoi ottenere le metriche per le singole operazioni di Amazon Textract o le metriche globali di Amazon Textract per il tuo account. Puoi utilizzare le metriche per monitorare lo stato della tua soluzione basata su Amazon Textract e impostare allarmi per notificarti quando una o più metriche superano una soglia definita. Ad esempio, puoi visualizzare le metriche relative al numero di errori del server che si sono verificati. Puoi anche visualizzare le metriche relative al numero di volte in cui una specifica operazione di Amazon Textract è riuscita. Per visualizzare le metriche, puoi utilizzare Amazon CloudWatch AWS CLI, the o l'API. CloudWatch

Utilizzo delle CloudWatch metriche per Amazon Textract

Per utilizzare le metriche, devi specificare le seguenti informazioni:

  • La dimensione metrica o nessuna dimensione. Una dimensione è una coppia nome-valore che consente di identificare una metrica in modo univoco. Amazon Textract ha una dimensione, denominata Operazione. che fornisce parametri per un'operazione specifica. Se non specifichi una dimensione, la metrica è limitata a tutte le operazioni di Amazon Textract all'interno del tuo account.

  • Il nome del parametro, ad esempio UserErrorCount.

Puoi ottenere dati di monitoraggio per Amazon Textract utilizzando Console di gestione AWS, the o l'API AWS CLI. CloudWatch Puoi anche utilizzare l' CloudWatch API tramite uno degli Amazon AWS Software Development Kit (SDK) o gli CloudWatch strumenti API. La console mostra una serie di grafici basati sui dati grezzi dell'API. CloudWatch 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 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 la statistica SampleCount 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 posso monitorare la latenza delle chiamate operative di Amazon Textract?

Utilizza la metrica ResponseTime.

Devi disporre delle CloudWatch autorizzazioni appropriate con cui monitorare Amazon Textract. CloudWatch Per ulteriori informazioni, vedi Autenticazione e controllo degli accessi per Amazon CloudWatch).

Accedi a Amazon Textract Metrics

Gli esempi seguenti mostrano come accedere alle metriche di Amazon Textract utilizzando la CloudWatch console, l'API e l'API AWS CLI. CloudWatch

Come visualizzare le metriche (console)

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

  2. Scegli Metriche, scegli la scheda Tutte le metriche, quindi scegli Amazon Textract.

  3. Scegli Per operazione, quindi scegli una metrica.

    Ad esempio, scegli la StartDocumentAnalysis metrica per misurare quante volte è stata avviata l'analisi asincrona del documento.

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

Per visualizzare le metriche relative alle StartDocumentAnalysis operazioni riuscite, chiamate effettuate in un determinato periodo di tempo (CLI)

  • Apri AWS CLI e inserisci il seguente comando:

    aws cloudwatch get-metric-statistics \
    --metric-name SuccessfulRequestCount \
    --start-time 2019-02-01T00:00:00Z \
    --period 3600 \
    --end-time 2019-03-01T00:00:00Z \
    --namespace AWS/Textract \
    --dimensions Name=Operation,Value=StartDocumentAnalysis \
    --statistics Sum

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

Per accedere alle metriche (CloudWatch API)

Creazione di un allarme

Puoi creare un CloudWatch allarme che invia un messaggio Amazon Simple Notification Service (Amazon SNS) quando l'allarme cambia stato. Un allarme monitora una singola metrica per un periodo di tempo specificato. L'allarme esegue una o più operazioni basate sul valore del parametro relativo a una soglia prestabilita per un certo numero di periodi. L'operazione corrisponde all'invio di una notifica a un argomento di Amazon SNS o a una policy di Auto Scaling.

Gli allarmi richiamano azioni solo per modifiche prolungate dello stato. CloudWatch gli allarmi non richiamano azioni semplicemente perché si trovano in uno stato particolare. È necessario che lo stato cambi e rimanga costante per un determinato numero di periodi.

Come impostare un allarme (console)

  1. Accedi Console di gestione AWS e apri la CloudWatch console all'indirizzo. https://console.aws.amazon.com/cloudwatch/

  2. Nel riquadro di navigazione, seleziona Allarmi, quindi Crea allarme. Viene aperta la procedura guidata per la creazione di allarmi.

  3. Scegli Seleziona metrica.

  4. Nella scheda Tutte le metriche, scegli Textract.

  5. Scegli Per operazione, quindi scegli una metrica.

    Ad esempio, scegliete StartDocumentAnalysis di impostare un allarme per un numero massimo di operazioni asincrone di analisi dei documenti.

  6. Seleziona la scheda Graphed metrics (Parametri nel grafico).

  7. Per Statistic (Statistica), scegliere Sum (Somma).

  8. Scegli Seleziona metrica.

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

  10. Se desideri CloudWatch inviarti un'e-mail quando viene raggiunto lo stato di allarme, per Ogni volta che questo allarme:, scegli Lo stato è ALLARME. Per inviare allarmi a un argomento Amazon SNS esistente, in Invia notifica a:, scegli un argomento SNS esistente. Per impostare il nome e gli indirizzi e-mail per una nuova lista di abbonati e-mail, scegli Nuova lista. CloudWatch salva l'elenco e lo visualizza nel campo in modo da poterlo utilizzare per impostare allarmi futuri.

    Nota

    Se utilizzi New list per creare un nuovo argomento Amazon SNS, gli indirizzi email devono essere verificati prima che i destinatari previsti ricevano le notifiche. Le e-mail vengono inviate da Amazon SNS solo quando l'allarme passa allo stato definito. Se questa modifica dello stato di allarme avviene prima della verifica degli indirizzi e-mail, i destinatari previsti non ricevono una notifica.

  11. Scegli Crea allarme.

Per impostare un allarme (AWS CLI)

  • Apri AWS CLI e inserisci il seguente comando. Modifica il valore del alarm-actions parametro per fare riferimento a un argomento Amazon SNS creato in precedenza. 

    aws cloudwatch put-metric-alarm \
    --alarm-name StartDocumentAnalysisUserErrors \
    --alarm-description "Alarm when more than 10 StartDocumentAnalysys user errors occur within 5 minutes" \
    --metric-name UserErrorCount \
    --namespace AWS/Textract \
    --statistic Sum \
    --period 300 \
    --threshold 10 \
    --comparison-operator GreaterThanThreshold \
    --evaluation-periods 1 \
    --unit Count \
    --dimensions Name=Operation,Value=StartDocumentAnalysis \
    --alarm-actions arn:aws:sns:us-east-1:111111111111:alarmtopic

    Questo esempio mostra come creare un allarme per quando si verificano più di 10 errori utente entro 5 minuti dalle chiamate aStartDocumentAnalysis. Per ulteriori informazioni, consultare put-metric-alarm.

Per impostare un allarme (CloudWatch API)