

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 Rekognition
<a name="monitoring-overview"></a>

Il monitoraggio è importante per garantire l'affidabilità, la disponibilità e le prestazioni di Amazon Rekognition e delle altre soluzioni AWS. AWS fornisce gli strumenti di monitoraggio seguenti per tenere sotto controllo Rekognition, segnalare un problema e intervenire automaticamente quando necessario:
+ *Amazon CloudWatch* monitora AWS le tue risorse e le applicazioni su cui esegui AWS in tempo reale. È possibile raccogliere e tenere traccia dei parametri, creare pannelli di controllo personalizzati e impostare allarmi per inviare una notifica o intraprendere azioni quando un parametro specificato raggiunge una determinata soglia. Ad esempio, puoi tenere CloudWatch traccia dell'utilizzo della CPU o di altri parametri delle tue istanze Amazon EC2 e avviare automaticamente nuove istanze quando necessario. Per ulteriori informazioni, consulta la [Amazon CloudWatch User Guide](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/).
+ *Amazon CloudWatch Logs* ti consente di monitorare, archiviare e accedere ai tuoi file di log da istanze Amazon EC2 e altre CloudTrail fonti. CloudWatch I log possono monitorare le informazioni nei file di registro e avvisarti quando vengono raggiunte determinate soglie. Puoi inoltre archiviare i dati del log in storage estremamente durevole. Per ulteriori informazioni, consulta la [Amazon CloudWatch Logs User Guide](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/).
+ *Amazon EventBridge* può essere utilizzato per automatizzare i AWS servizi e rispondere automaticamente agli eventi di sistema, come problemi di disponibilità delle applicazioni o modifiche delle risorse. Gli eventi AWS relativi ai servizi vengono forniti quasi EventBridge in tempo reale. Puoi compilare regole semplici che indichino quali eventi sono considerati di interesse per te e quali operazioni automatizzate intraprendere quando un evento corrisponde a una regola. Per ulteriori informazioni, consulta [Amazon EventBridge User Guide](https://docs.aws.amazon.com/eventbridge/latest/userguide/).
+ *AWS CloudTrail*acquisisce le chiamate API e gli eventi correlati effettuati da o per conto del tuo AWS account e invia i file di log a un bucket Amazon S3 da te specificato. Puoi identificare quali utenti e account hanno chiamato AWS, l'indirizzo IP di origine da cui sono state effettuate le chiamate e quando sono avvenute le chiamate. Per ulteriori informazioni, consulta la [Guida per l'utente AWS CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/).

# Monitoraggio di Rekognition con Amazon CloudWatch
<a name="rekognition-monitoring"></a>

Con CloudWatch, puoi ottenere metriche per le 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 parametri per il numero di volte che si è verificata una specifica operazione di Rekognition. Per visualizzare le metriche, puoi utilizzare [Amazon CloudWatch](https://console.aws.amazon.com/cloudwatch/) AWS Command Line Interface, [Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/cli/) o l'[CloudWatch API](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/).



Puoi anche visualizzare parametri aggregati per un determinato periodo di tempo utilizzando la console Rekognition. Per ulteriori informazioni, consulta [Esercizio 4: visualizzare i parametri aggregati (console)](aggregated-metrics.md).

## Utilizzo delle CloudWatch metriche per Rekognition
<a name="using-metrics"></a>

Per utilizzare le metriche, devi specificare le seguenti informazioni:
+ La dimensione del parametro o nessuna dimensione. Una *dimensione* è una coppia nome-valore che consente di identificare una metrica in modo univoco. In Rekognition è disponibile una dimensione denominata *Operation*, che fornisce parametri per un'operazione specifica. Se non specifichi una dimensione, l'ambito del parametro è rappresentato da tutte le operazioni di Rekognition nel tuo account.
+ Il nome del parametro, ad esempio `UserErrorCount`.

Puoi ottenere i dati di monitoraggio per Rekognition utilizzando l', Console di gestione AWS AWS CLI la o l'API. CloudWatch Puoi anche utilizzare l' CloudWatch API tramite uno degli Amazon AWS Software Development Kit (SDKs) o gli strumenti CloudWatch API. La console mostra una serie di grafici basati sui dati grezzi dell' CloudWatch API. In base alle tue esigenze, potresti decidere di utilizzare i grafici visualizzati nella console o quelli recuperati dall'API.

### 
<a name="how-do-i"></a>

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 la metrica `ResponseTime`.  | 
|  Come è possibile monitorare il numero di volte che `IndexFaces` aggiunge volti alle raccolte di 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 delle CloudWatch autorizzazioni appropriate per monitorare Rekognition. CloudWatch Per ulteriori informazioni, vedi [Autenticazione e controllo degli accessi per Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/auth-and-access-control-cw.html)).

## Accesso ai parametri di Rekognition
<a name="how-to-access"></a>

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

**Come visualizzare le metriche (console)**

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

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

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

   Ad esempio, scegli la **DetectedFace**metrica per misurare quanti volti sono stati rilevati.

1. 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)**
+ Aprite AWS CLI e immettete il seguente comando:

  `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 [get-metric-statistics](https://docs.aws.amazon.com/cli/latest/reference/get-metric-statistics.html).

**Per accedere alle metriche (CloudWatch API)**
+  Chiama `[GetMetricStatistics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricStatistics.html)`. Per ulteriori informazioni, consulta [Amazon CloudWatch API Reference](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/). 

## Creazione di un allarme
<a name="alarms"></a>

Puoi 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 azioni solo per cambiamenti di stato sostenuti. 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 

**Come impostare un allarme (console)**

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

1. Scegli **Crea allarme**. Viene avviata la **procedura guidata per la creazione di allarmi**. 

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

   Ad esempio, scegli **DetectedFaceCount**di impostare un allarme per un numero massimo di volti rilevati.

1. 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).

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

1. Se desideri CloudWatch inviarti un'e-mail quando viene raggiunto lo stato di allarme, per **Ogni volta che questo allarme:**, scegli **State is ALARM**. 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 un nuovo elenco di sottoscrizioni e-mail, scegli **Crea argomento**, CloudWatch salva l'elenco e lo visualizza nel campo in modo da poterlo utilizzare per impostare allarmi futuri. 
**Nota**  
Se utilizzi **Crea argomento** per creare un nuovo argomento Amazon SNS, gli indirizzi e-mail 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 lo stato cambia prima della verifica degli indirizzi e-mail, i destinatari previsti non riceveranno una notifica.

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

**Per impostare un allarme (AWS CLI)**
+ Apri AWS CLI e inserisci il seguente comando. Cambia il valore del parametro `alarm-actions` per fare riferimento a un argomento 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 [put-metric-alarm](https://docs.aws.amazon.com/cli/latest/reference/put-metric-alarm.html).

**Per impostare un allarme (CloudWatch API)**
+ Chiama `[PutMetricAlarm](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricAlarm.html)`. Per ulteriori informazioni, consulta *[Amazon CloudWatch API Reference](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/)*.

## CloudWatch metriche per Rekognition
<a name="cloudwatch-metricsdim"></a>

Questa sezione contiene informazioni sui CloudWatch parametri Amazon e sulla dimensione *Operation* disponibili per Amazon Rekognition.

Puoi anche visualizzare una vista aggregata dei parametri di Rekognition dalla console di Rekognition. Per ulteriori informazioni, consulta [Esercizio 4: visualizzare i parametri aggregati (console)](aggregated-metrics.md).

### CloudWatch metriche per Rekognition
<a name="cloudwatch-metrics"></a>

La tabella seguente riepiloga i parametri di Rekognition.


| Metrica | Description | 
| --- | --- | 
|  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 sottopone a throttling una richiesta quando riceve più richieste del limite di transazioni per 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](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html).  Unità: numero Statistiche valide: `Sum,Average`  | 
|  ResponseTime  |  Il periodo di tempo, in millisecondi, impiegato da Rekognition per calcolare la risposta.  Unità:  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/rekognition/latest/dg/rekognition-monitoring.html) Statistiche valide: `Data Samples,Average`  Il parametro `ResponseTime` non è incluso nel riquadro del parametro 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 durante la richiesta StartProjectVersion.Unità: numeroStatistiche valide: `Average` | 
| MaxInferenceUnits | Il numero massimo di unità di inferenza specificato durante la richiesta StartProjectVersion .Unità: numeroStatistiche 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
<a name="cloudwatch-streaming-metrics"></a>

Rekognition ha anche un secondo spazio dei nomi utilizzato per le operazioni di streaming, “Rekognition Streaming”. La tabella seguente riepiloga i parametri di Rekognition Streaming.


| Metrica | Description | 
| --- | --- | 
|  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 sottopone a throttling una richiesta quando riceve più richieste del limite di transazioni per 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](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html).  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`  | 
| ConcurrentSessions | Il numero di sessioni simultanee attualmente utilizzate dal tuo account.Unità: numeroStatistiche valide: `Max,Average` | 

### CloudWatch dimensione per Rekognition
<a name="cloudwatch-dimensions"></a>

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

Per ulteriori informazioni sulle dimensioni, consulta [Dimensions](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Dimension) nella *Amazon CloudWatch User Guide*. 

### CloudWatch dimensione per le etichette personalizzate Rekognition
<a name="cloudwatch-dimensions"></a>

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


****  

| Dimensione | Description | 
| --- | --- | 
| ProjectName | Il nome del progetto Rekognition Custom Labels che hai creato con CreateProject. | 
| VersionName | Il nome della versione di progetto Rekognition Custom Labels che hai creato con CreateProjectVersion. | 

Per ulteriori informazioni sulle dimensioni, consulta [Dimensions](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Dimension) nella *Amazon CloudWatch User Guide*. 

# Registrazione delle chiamate API Amazon Rekognition con AWS CloudTrail
<a name="logging-using-cloudtrail"></a>

Amazon Rekognition è AWS CloudTrail integrato con un servizio che fornisce un registro delle azioni intraprese da un utente, ruolo o AWS servizio in Amazon Rekognition. CloudTrail acquisisce tutte le chiamate API per Amazon Rekognition come eventi. Le chiamate acquisite includono le chiamate dalla console Amazon Rekognition e le chiamate di codice alle operazioni API di Amazon Rekognition. Se crei un trail, puoi abilitare la distribuzione continua di CloudTrail eventi a un bucket Amazon S3, inclusi gli eventi per Amazon Rekognition. **Se non configuri un percorso, puoi comunque visualizzare gli eventi più recenti nella console in Cronologia eventi. CloudTrail ** Utilizzando le informazioni raccolte da CloudTrail, puoi determinare la richiesta che è stata fatta ad Amazon Rekognition, l'indirizzo IP da cui è stata effettuata la richiesta, chi ha effettuato la richiesta, quando è stata effettuata e ulteriori dettagli. 

[Per ulteriori informazioni CloudTrail, consulta la Guida per l'AWS CloudTrail utente.](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/)

## Informazioni su Amazon Rekognition in CloudTrail
<a name="service-name-info-in-cloudtrail"></a>

CloudTrail è abilitato sul tuo AWS account al momento della creazione dell'account. **Quando si verifica un'attività in Amazon Rekognition, tale attività viene registrata CloudTrail in un evento AWS insieme ad altri eventi di servizio nella cronologia degli eventi.** Puoi visualizzare, cercare e scaricare eventi recenti nel tuo account. AWS Per ulteriori informazioni, consulta [Visualizzazione degli eventi con la cronologia degli CloudTrail eventi](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html). 

Per una registrazione continua degli eventi nel tuo AWS account, inclusi gli eventi per Amazon Rekognition, crea un percorso. Un *trail* consente di CloudTrail inviare file di log a un bucket Amazon S3. Per impostazione predefinita, quando si crea un trail nella console, il trail sarà valido in tutte le regioni AWS. Il trail registra gli eventi di tutte le regioni della AWS partizione e consegna i file di log al bucket Amazon S3 specificato. Inoltre, puoi configurare altri AWS servizi per analizzare ulteriormente e agire in base ai dati sugli eventi raccolti nei log. CloudTrail Per ulteriori informazioni, consulta gli argomenti seguenti: 
+ [Panoramica della creazione di un trail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [CloudTrail Servizi e integrazioni supportati](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)
+ [Configurazione delle notifiche Amazon SNS per CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html)
+ [Ricezione di file di CloudTrail registro da più regioni](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) e [ricezione di file di CloudTrail registro da](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html) più account

[Tutte le azioni di Amazon Rekognition vengono CloudTrail registrate e documentate nel riferimento all'API Amazon Rekognition.](https://docs.aws.amazon.com/rekognition/latest/dg/API_Operations.html) Ad esempio, le chiamate a e le azioni generano voci nei `CreateCollection` file di `CreateStreamProcessor` registro`DetectCustomLabels`. CloudTrail 

Ogni evento o voce di log contiene informazioni sull’utente che ha generato la richiesta. Le informazioni di identità consentono di determinare quanto segue: 
+ Se la richiesta è stata effettuata con credenziali utente root o AWS Identity and Access Management (IAM).
+ Se la richiesta è stata effettuata con le credenziali di sicurezza temporanee per un ruolo o un utente federato.
+ Se la richiesta è stata effettuata da un altro AWS servizio.

Per ulteriori informazioni, consulta [Elemento CloudTrail userIdentity](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html).

## Informazioni sulle voci dei file di log Amazon Rekognition
<a name="understanding-service-name-entries"></a>

Un trail è una configurazione che consente la distribuzione di eventi come file di log in un bucket Amazon S3 specificato dall'utente. CloudTrail i file di registro contengono una o più voci di registro. Un evento rappresenta una singola richiesta proveniente da qualsiasi fonte e include informazioni sull'azione richiesta, la data e l'ora dell'azione, i parametri della richiesta e così via. CloudTrail i file di registro non sono una traccia ordinata dello stack delle chiamate API pubbliche, quindi non vengono visualizzati in un ordine specifico. 

L'esempio seguente mostra una voce di CloudTrail registro con azioni per la seguente API: `StartLabelDetection` and`DetectLabels`.

```
{
    "Records": [
        
        {
            "eventVersion": "1.05",
            "userIdentity": {
                "type": "AssumedRole",
                "principalId": "AIDAJ45Q7YFFAREXAMPLE",
                "arn": "arn:aws:sts::111122223333:assumed-role/Admin/JorgeSouza",
                "accountId": "111122223333",
                "accessKeyId": "AKIAIOSFODNN7EXAMPLE",
                "sessionContext": {
                    "sessionIssuer": {
                        "type": "Role",
                        "principalId": "AIDAJ45Q7YFFAREXAMPLE",
                        "arn": "arn:aws:iam::111122223333:role/Admin",
                        "accountId": "111122223333",
                        "userName": "Admin"
                    },
                    "webIdFederationData": {},
                    "attributes": {
                        "mfaAuthenticated": "false",
                        "creationDate": "2020-06-30T20:10:09Z"
                    }
                }
            },
            "eventTime": "2020-06-30T20:42:14Z",
            "eventSource": "rekognition.amazonaws.com",
            "eventName": "StartLabelDetection",
            "awsRegion": "us-east-1",
            "sourceIPAddress": "192.0.2.0",
            "userAgent": "aws-cli/3",
            "requestParameters": {
                "video": {
                    "s3Object": {
                        "bucket": "my-bucket",
                        "name": "my-video.mp4"
                    }
                }
            },
            "responseElements": {
                "jobId": "653de5a7ee03bd5083edde98ea8fce5794fcea66d077bdd4cfb39d71aff8fc25"
            },
            "requestID": "dfcef8fc-479c-4c25-bef0-d83a7f9a7240",
            "eventID": "b602e460-c134-4ecb-ae78-6d383720f29d",
            "readOnly": false,
            "eventType": "AwsApiCall",
            "recipientAccountId": "111122223333"
        },
        {
            "eventVersion": "1.05",
            "userIdentity": {
                "type": "AssumedRole",
                "principalId": "AIDAJ45Q7YFFAREXAMPLE",
                "arn": "arn:aws:sts::111122223333:assumed-role/Admin/JorgeSouza",
                "accountId": "111122223333",
                "accessKeyId": "AKIAIOSFODNN7EXAMPLE",
                "sessionContext": {
                    "sessionIssuer": {
                        "type": "Role",
                        "principalId": "AIDAJ45Q7YFFAREXAMPLE",
                        "arn": "arn:aws:iam::111122223333:role/Admin",
                        "accountId": "111122223333",
                        "userName": "Admin"
                    },
                    "webIdFederationData": {},
                    "attributes": {
                        "mfaAuthenticated": "false",
                        "creationDate": "2020-06-30T21:19:18Z"
                    }
                }
            },
            "eventTime": "2020-06-30T21:21:47Z",
            "eventSource": "rekognition.amazonaws.com",
            "eventName": "DetectLabels",
            "awsRegion": "us-east-1",
            "sourceIPAddress": "192.0.2.0",
            "userAgent": "aws-cli/3",
            "requestParameters": {
                "image": {
                    "s3Object": {
                        "bucket": "my-bucket",
                        "name": "my-image.jpg"
                    }
                }
            },
            "responseElements": null,
            "requestID": "5a683fb2-aec0-4af4-a7df-219018be2155",
            "eventID": "b356b0fd-ea01-436f-a9df-e1186b275bfa",
            "readOnly": true,
            "eventType": "AwsApiCall",
            "recipientAccountId": "111122223333"
        }       
    ]
}
```