Monitoraggio di Amazon Textract - Amazon Textract
Utilizzo di CloudWatch Metrics for Amazon TextractAccedi ai parametri Amazon TextractCreazione 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 parametri per singole operazioni Amazon Textract o parametri Amazon Textract globali per il tuo account. Puoi utilizzare i parametri per monitorare la soluzione basata su Amazon Texttract e impostare allarmi di notifica quando uno o più parametri sono al di fuori di una soglia definita. Ad esempio, puoi visualizzare le metriche per il numero di errori del server che si sono verificati. Puoi anche visualizzare parametri per il numero di volte che si è verificata una specifica operazione Amazon Textract. Per visualizzare i parametri, puoi utilizzareAmazon CloudWatch, ilAWS CLI, o ilAPI di CloudWatch.

Utilizzo di CloudWatch Metrics for Amazon Textract

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. Amazon Textract ha una dimensione denominataOperazione. che fornisce parametri per un'operazione specifica. Se non specifichi una dimensione, l'ambito del parametro è rappresentato da tutte le operazioni Amazon Textract nell'account.

  • Il nome del parametro, ad esempio UserErrorCount.

Puoi monitorare i dati per Amazon Textract utilizzando ilAWS Management Console, ilAWS CLIo l'API di CloudWatch. Puoi anche usare l'API CloudWatch tramite uno degli SDK (Software Development Kit) di Amazon AWS o gli strumenti API CloudWatch. La console visualizza una serie di grafici in base ai dati non elaborati 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 è possibile monitorare la latenza delle chiamate alle operazioni Amazon Textract?

Utilizza il parametro ResponseTime.

Per monitorare Amazon Textract con CloudWatch, devi disporre delle autorizzazioni di CloudWatch appropriate. Per ulteriori informazioni, consulta Autenticazione e controllo degli accessi per Amazon CloudWatch.

Accedi ai parametri Amazon Textract

Gli esempi seguenti mostrano come accedere ai parametri di Amazon Textract utilizzando la console CloudWatch,AWS CLIe l'API di CloudWatch.

Come visualizzare i parametri (console)

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

  2. ScegliereParametri, scegli ilTutte le metrichescheda, quindi scegliAmazon Textract.

  3. SceglierePer operazione, quindi scegliere un parametro.

    Ad esempio, scegli laStartDocumentAnalysismetrica per misurare quante volte è stata avviata l'analisi asincrona dei documenti.

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

Per visualizzare i parametri per avere successoStartDocumentAnalysischiamate alle operazioni effettuate in un periodo di tempo (CLI)

  • Apri AWS CLI e immetti il comando seguente:

    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 ai parametri (API di CloudWatch)

Creazione di un allarme

Puoi creare un allarme CloudWatch che invia un messaggio Amazon Simple Notification Service (Amazon SNS) quando cambia stato. Un allarme monitora un singolo parametro 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 operazioni solo per le modifiche di stato prolungate. Gli allarmi CloudWatch non richiamano le operazioni 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 all'AWS Management Console e apri la console CloudWatch all'indirizzo https://console.aws.amazon.com/cloudwatch/.

  2. Nel riquadro di navigazione, scegliereAllarmie scegliCrea allarme. In questo modo si apre laProcedura guidata Create Alarm (Crea allarme).

  3. Scegli Select Metric (Seleziona parametro).

  4. NellaTutte le metrichetab, scegliTextract.

  5. SceglierePer operazione, quindi scegliere un parametro.

    Ad esempio, scegliStartDocumentAnalysisper impostare un allarme per un numero massimo di operazioni di analisi dei documenti asincrona.

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

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

  8. Scegli Select Metric (Seleziona parametro).

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

  10. Se vuoi che CloudWatch invii un'e-mail quando viene raggiunto lo stato dell'allarme, perOgni volta che questo allarme:, scegliLo stato è ALARM. Per inviare allarmi a un argomento Amazon SNS esistente, perInvia notifica a:, scegliere un argomento SNS esistente. Per impostare il nome e gli indirizzi e-mail per un nuovo elenco di sottoscrizioni e-mail, scegliNuovo elenco. CloudWatch salva l'elenco e lo visualizza nel campo in modo da poterlo utilizzare per impostare allarmi in futuro.

    Nota

    Se utilizziNuovo elencoper 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 passa allo stato definito. Se lo stato cambia prima della verifica degli indirizzi e-mail, i destinatari previsti non riceveranno una notifica.

  11. Scegliere Create Alarm (Crea allarme).

Per impostare un allarme (AWS CLI)

  • Apri AWS CLI e immetti il comando seguente. Modifica il valore dellaalarm-actionsparametro 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 quando si verificano più di 10 errori utente in 5 minuti per le chiamate aStartDocumentAnalysis. Per ulteriori informazioni, consultare put-metric-alarm.

Per impostare un allarme (API di CloudWatch)