

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à.

# Risoluzione dei problemi dello streaming di video
<a name="streaming-video-troubleshooting"></a>

In questo argomento sono disponibili le informazioni per l'uso di Video Amazon Rekognition con i video in streaming.

**Topics**
+ [Non so se il processore di streaming è stato creato](#ts-streaming-video-create-sp)
+ [Non so se il processore di streaming è stato configurato correttamente](#ts-configured-sp)
+ [Il processore di streaming non restituisce risultati](#ts-streaming-video-no-results-from-sp)
+ [Lo stato del processore di streaming è FAILED](#ts-failed-state)
+ [Il processore di streaming non restituisce i risultati previsti](#w2aac27c79c27c15)

## Non so se il processore di streaming è stato creato
<a name="ts-streaming-video-create-sp"></a>

Usa il AWS CLI comando seguente per ottenere un elenco degli stream processor e il loro stato attuale.

```
aws rekognition list-stream-processors
```

È possibile ottenere ulteriori dettagli utilizzando il AWS CLI comando seguente. Sostituisci `stream-processor-name` con il nome processore di streaming desiderato.

```
aws rekognition describe-stream-processor --name stream-processor-name
```

## Non so se il processore di streaming è stato configurato correttamente
<a name="ts-configured-sp"></a>

Se il codice non restituisce i risultati dell'analisi di Video Amazon Rekognition, è possibile che l'elaboratore di flussi non sia configurato correttamente. Esegui le operazioni seguenti per verificare che il processore di streaming sia configurato correttamente e in grado di produrre risultati.

**Per determinare se la soluzione è stata configurata correttamente**

1. Eseguire il seguente comando per verificare che il processore di streaming sia in esecuzione. Sostituire `stream-processor-name` con il nome del processore di streaming. Il processore di streaming è in esecuzione se il valore di `Status` è `RUNNING`. Se lo stato è `RUNNING` e non vengono restituiti risultati, consultare [Il processore di streaming non restituisce risultati](#ts-streaming-video-no-results-from-sp). Se lo stato è `FAILED`, consultare [Lo stato del processore di streaming è FAILED](#ts-failed-state).

   ```
   aws rekognition describe-stream-processor --name stream-processor-name
   ```

1. Se lo stream processor è in esecuzione, esegui il seguente PowerShell comando o Bash per leggere i dati dal flusso di dati Kinesis in uscita. 

   **Bash**

   ```
   SHARD_ITERATOR=$(aws kinesis get-shard-iterator --shard-id shardId-000000000000 --shard-iterator-type TRIM_HORIZON --stream-name kinesis-data-stream-name --query 'ShardIterator')
                           aws kinesis get-records --shard-iterator $SHARD_ITERATOR
   ```

   **PowerShell**

   ```
   aws kinesis get-records --shard-iterator ((aws kinesis get-shard-iterator --shard-id shardId-000000000000 --shard-iterator-type TRIM_HORIZON --stream-name kinesis-data-stream-name).split('"')[4])
   ```

1. Utilizzare lo [strumento di decodifica](https://www.base64decode.org/) sul sito Web di Base64 Decode per decodificare l'output in una stringa leggibile. Per ulteriori informazioni consultare [Fase 3: estrazione del record](https://docs.aws.amazon.com/streams/latest/dev/fundamental-stream.html#get-records).

1. Se i comandi funzionano e i risultati del rilevamento facciale sono presenti nel flusso di dati Kinesis, la soluzione è configurata correttamente. Se il comando non riesce, verificare gli altri suggerimenti della risoluzione dei problemi e consultare [Concessione ad Video Amazon Rekognition dell'accesso alle risorse](api-streaming-video-roles.md).

In alternativa, puoi utilizzare il AWS Lambda modello "kinesis-process-record" per registrare i messaggi dal flusso di dati Kinesis CloudWatch per una visualizzazione continua. Ciò comporta costi aggiuntivi per e. AWS Lambda CloudWatch 

## Il processore di streaming non restituisce risultati
<a name="ts-streaming-video-no-results-from-sp"></a>

Il processore di streaming potrebbe non restituire risultati per diversi motivi. 

### Motivo 1: il processore di streaming non è configurato correttamente
<a name="w2aac27c79c27c11b5"></a>

Il processore di streaming potrebbe non essere configurato correttamente. Per ulteriori informazioni, consulta [Non so se il processore di streaming è stato configurato correttamente](#ts-configured-sp).

### Motivo 2: il processore di streaming non è nello stato RUNNING
<a name="w2aac27c79c27c11b7"></a>

**Per risolvere il problema dello stato del processore di streaming**

1. Controllate lo stato dello stream processor con il seguente AWS CLI comando.

   ```
   aws rekognition describe-stream-processor --name stream-processor-name
   ```

1. Se il valore di `Status` è `STOPPED`, avviare del processore di streaming con il seguente comando:

   ```
   aws rekognition start-stream-processor --name stream-processor-name
   ```

1. Se il valore di `Status` è `FAILED`, consultare [Lo stato del processore di streaming è FAILED](#ts-failed-state).

1. Se il valore di `Status` è `STARTING`, attendere 2 minuti e controllare lo stato ripetendo la fase 1. Se il valore dello stato è ancora `STARTING`, procedere nel seguente modo:

   1. Eliminare il processore di streaming con il seguente comando.

      ```
      aws rekognition delete-stream-processor --name stream-processor-name
      ```

   1. Creare un nuovo processore di streaming con la stessa configurazione. Per ulteriori informazioni, consulta [Utilizzo degli eventi video in streaming](streaming-video.md).

   1. Se i problemi persistono, contatta l' AWS assistenza.

1. Se il valore di `Status` è `RUNNING`, consultare [Motivo 3: non sono presenti dati attivi nel flusso video Kinesis](#ts-no-data).

### Motivo 3: non sono presenti dati attivi nel flusso video Kinesis
<a name="ts-no-data"></a>

**Per controllare se sono presenti dati attivi nel flusso video Kinesis**

1. Accedi a e apri Console di gestione AWS la console Amazon Kinesis Video [https://console.aws.amazon.com/kinesisvideo/](https://console.aws.amazon.com/kinesisvideo/)Streams all'indirizzo.

1. Seleziona il flusso video Kinesis che è l'input per l'elaboratore di flussi Amazon Rekognition.

1. Se l'anteprima indica **Dati non presenti nel flusso**, non sono presenti dati nel flusso di input per l'elaborazione di Video Amazon Rekognition.

Per informazioni su come produrre video con Kinesis Video Streams, consulta [Librerie Producer di Kinesis Streams](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/producer-sdk.html). 

## Lo stato del processore di streaming è FAILED
<a name="ts-failed-state"></a>

Puoi controllare lo stato di uno stream processor utilizzando il seguente AWS CLI comando.

```
aws rekognition describe-stream-processor --name stream-processor-name
```

Se il valore dello stato è FAILED, verifica le informazioni della risoluzione dei problemi per i seguenti messaggi di errore.

### Errore di accesso negato al ruolo
<a name="w2aac27c79c27c13b9"></a>

Il ruolo IAM utilizzato dall'elaboratore di flussi non esiste o Video Amazon Rekognition non dispone dell'autorizzazione per assumere il ruolo.

**Per risolvere i problemi relativi all'accesso al ruolo IAM**

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

1. Dal riquadro di navigazione a sinistra, scegliere **Ruoli** e verificare che il ruolo esista. 

1. Se il ruolo esiste, verifica che il ruolo abbia la politica delle *AmazonRekognitionServiceRole*autorizzazioni.

1. Se il ruolo non esiste o non dispone delle autorizzazioni appropriate, vedere [Concessione ad Video Amazon Rekognition dell'accesso alle risorse](api-streaming-video-roles.md).

1. Avvia lo stream processor con il seguente AWS CLI comando.

   ```
   aws rekognition start-stream-processor --name stream-processor-name
   ```

### Errore di accesso negato a Kinesis Video *o* a Kinesis Data
<a name="w2aac27c79c27c13c11"></a>

Il ruolo non dispone dell'accesso alle operazioni API Kinesis Video Streams `GetMedia` e `GetDataEndpoint`. È inoltre possibile che non abbia accesso alle operazioni API Kinesis Data Streams `PutRecord` e `PutRecords`. 

**Per risolvere i problemi relativi alle autorizzazioni delle API**

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

1. Aprire il ruolo e verificare che sia collegata la seguente policy di autorizzazioni.

1. Se mancano le autorizzazioni, aggiornare la policy. Per ulteriori informazioni, consulta [Concessione ad Video Amazon Rekognition dell'accesso alle risorse](api-streaming-video-roles.md).

### Errore: «Lo stream *input-video-stream-name* non esiste»
<a name="w2aac27c79c27c13c13"></a>

L'input del flusso video Kinesis per l'elaboratore di flussi non esiste o non è configurato correttamente. 

**Per risolvere i problemi relativi al flusso video Kinesis**

1. Utilizzare il comando seguente per verificare che il flusso esista. 

   ```
   aws kinesisvideo list-streams
   ```

1. Se il flusso è presente, verificare quanto segue.
   + Il nome della risorsa Amazon (ARN) deve essere uguale all'ARN del flusso di input per il processore di streaming.
   + Il flusso video Kinesis è nella stessa regione dell'elaboratore di flussi.

   Se lo stream processor non è configurato correttamente, eliminalo con il seguente AWS CLI comando.

   ```
   aws rekognition delete-stream-processor --name stream-processor-name
   ```

1. Creare un nuovo processore di streaming con il flusso video Kinesis desiderato. Per ulteriori informazioni, consulta [Creazione dell'elaboratore di flussi per la ricerca di volti Video Amazon Rekognition](rekognition-video-stream-processor-search-faces.md#streaming-video-creating-stream-processor).

### Errore di raccolta non trovata
<a name="w2aac27c79c27c13c15"></a>

La raccolta Amazon Rekognition utilizzata dall'elaboratore di flussi per il riconoscimento dei volti non esiste oppure viene utilizzata una raccolta non corretta.

**Per verificare la raccolta**

1. Utilizzate il AWS CLI comando seguente per determinare se esiste la raccolta richiesta. Passa `region` alla AWS regione in cui stai utilizzando lo stream processor.

   ```
   aws rekognition list-collections --region region
   ```

   Se la raccolta non esiste, creare una nuova raccolta e aggiungere le informazioni per il riconoscimento facciale. Per ulteriori informazioni, consulta [Ricerca di volti in una raccolta](collections.md).

1. Nella chiamata a [CreateStreamProcessor](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateStreamProcessor.html), controllare che il valore del parametro di input `CollectionId` sia corretto.

1. Avvia lo stream processor con il seguente AWS CLI comando.

   ```
   aws rekognition start-stream-processor --name stream-processor-name
   ```

### Errore: «Stream *output-kinesis-data-stream-name* nell'account *account-id* non trovato»
<a name="w2aac27c79c27c13c17"></a>

Il flusso di dati Kinesis in uscita utilizzato dallo stream processor non esiste nella tua regione Account AWS o non si trova nella stessa AWS regione dello stream processor.

**Per risolvere i problemi relativi al flusso di dati Kinesis**

1. Usa il seguente AWS CLI comando per determinare se esiste il flusso di dati Kinesis. Passa `region` alla AWS regione in cui stai utilizzando lo stream processor.

   ```
   aws kinesis list-streams --region region
   ```

1. Se il flusso di dati Kinesis esiste, verificare che il nome del flusso di dati Kinesis sia uguale al nome del flusso di output utilizzato dal processore di streaming.

1. Se il flusso di dati Kinesis non esiste, potrebbe esistere in un'altra AWS regione. Il flusso di dati Kinesis deve essere nella stessa regione del processore di streaming.

1. Se necessario, creare un nuovo flusso di dati Kinesis. 

   1. Creare un flusso di dati Kinesis con lo stesso nome del processore di flusso. Per ulteriori informazioni, consultare [Fase 1: creazione di un flusso di dati](https://docs.aws.amazon.com/streams/latest/dev/learning-kinesis-module-one-create-stream.html).

   1. Avvia lo stream processor con il seguente AWS CLI comando.

      ```
      aws rekognition start-stream-processor --name stream-processor-name
      ```

## Il processore di streaming non restituisce i risultati previsti
<a name="w2aac27c79c27c15"></a>

Se il processore di streaming non restituisce le corrispondenze previste per il riconoscimento facciale, utilizza le seguenti informazioni.
+ [Ricerca di volti in una raccolta](collections.md)
+ [Raccomandazioni per le impostazioni della fotocamera (video in streaming)](recommendations-camera-streaming-video.md)