

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Résolution des problèmes de streaming vidéo
<a name="streaming-video-troubleshooting"></a>

**Note**  
Les vidéos en streaming et l'analyse d'images en masse ne sont plus disponibles pour les nouveaux clients. Pour de plus amples informations, veuillez consulter [Modifications relatives à la disponibilité des fonctionnalités Amazon Rekognition](rekognition-availability-changes.md).  
**Cette modification n'a aucune incidence sur la disponibilité des autres fonctionnalités d'Amazon Rekognition.**

Cette rubrique fournit des informations permettant de résoudre les problèmes d’utilisation de Vidéo Amazon Rekognition avec des vidéos en streaming.

**Topics**
+ [Je ne sais pas si mon processeur de flux a été créé avec succès](#ts-streaming-video-create-sp)
+ [Je ne sais pas si j’ai configuré mon processeur de flux correctement](#ts-configured-sp)
+ [Mon processeur de flux ne renvoie pas de résultats.](#ts-streaming-video-no-results-from-sp)
+ [L’état de mon processeur de flux est FAILED](#ts-failed-state)
+ [Mon processeur de flux ne renvoie pas les résultats attendus](#w2aac27c79c29c17)

## Je ne sais pas si mon processeur de flux a été créé avec succès
<a name="ts-streaming-video-create-sp"></a>

Utilisez la AWS CLI commande suivante pour obtenir la liste des processeurs de flux et leur état actuel.

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

Vous pouvez obtenir des informations supplémentaires à l'aide de la AWS CLI commande suivante. Remplacez `stream-processor-name` par le nom du processeur de flux requis.

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

## Je ne sais pas si j’ai configuré mon processeur de flux correctement
<a name="ts-configured-sp"></a>

Si votre code ne donne pas des résultats d’analyse à partir de Vidéo Amazon Rekognition, votre processeur de flux n’est peut-être pas configuré correctement. Procédez comme suit pour vérifier que votre processeur de flux est configuré correctement et capable de produire des résultats.

**Pour déterminer si votre solution est configurée correctement**

1. Exécutez la commande suivante pour vérifier que votre processeur de flux est en cours d’exécution. Remplacez `stream-processor-name` par le nom de votre processeur de flux. Le processeur de flux est en cours d’exécution si la valeur de `Status` est `RUNNING`. Si le statut est `RUNNING` et que vous n’obtenez pas de résultats, consultez [Mon processeur de flux ne renvoie pas de résultats.](#ts-streaming-video-no-results-from-sp). Si l’état est `FAILED`, consultez [L’état de mon processeur de flux est FAILED](#ts-failed-state).

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

1. Si votre processeur de flux est en cours d'exécution, exécutez le Bash ou la PowerShell commande suivante pour lire les données du flux de données Kinesis en sortie. 

   **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. Utilisez l’[outil de décodage](https://www.base64decode.org/) sur le site web Base64 Decode pour décoder la sortie en chaîne compréhensible par les utilisateurs. Pour plus d’informations, consultez [Etape 3 : Obtenir l’enregistrement](https://docs.aws.amazon.com/streams/latest/dev/fundamental-stream.html#get-records).

1. Si les commandes fonctionnent et que vous voyez des résultats de détection de visages dans les flux de données Kinesis, cela signifie que votre solution a été configurée correctement. Si la commande échoue, vérifiez les autres suggestions de résolution de problèmes et consultez [Octroi à Vidéo Amazon Rekognition d’un accès à vos ressources](api-streaming-video-roles.md).

Vous pouvez également utiliser le AWS Lambda plan « kinesis-process-record » pour enregistrer les messages du flux de données Kinesis à des fins de visualisation continue. CloudWatch Cela entraîne des coûts supplémentaires pour AWS Lambda et. CloudWatch 

## Mon processeur de flux ne renvoie pas de résultats.
<a name="ts-streaming-video-no-results-from-sp"></a>

Plusieurs raisons peuvent expliquer pourquoi votre processeur de flux ne renvoie pas de résultats. 

### Raison 1 : votre processeur de flux n’est pas configuré correctement
<a name="w2aac27c79c29c13b5"></a>

Il est possible que votre processeur de flux ne soit pas configuré correctement. Pour de plus amples informations, veuillez consulter [Je ne sais pas si j’ai configuré mon processeur de flux correctement](#ts-configured-sp).

### Raison 2 : votre processeur de flux n’est pas dans l’état RUNNING
<a name="w2aac27c79c29c13b7"></a>

**Pour résoudre un problème d’état du processeur de flux**

1. Vérifiez l'état du processeur de flux à l'aide de la AWS CLI commande suivante.

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

1. Si la valeur de `Status` est `STOPPED`, démarrez votre processeur de flux à l’aide de la commande suivante :

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

1. Si la valeur de `Status` est `FAILED`, consultez [L’état de mon processeur de flux est FAILED](#ts-failed-state).

1. Si la valeur de `Status` est `STARTING`, attendez 2 minutes et vérifiez l’état en répétant l’étape 1. Si la valeur de l’état est toujours `STARTING`, procédez comme suit :

   1. Supprimez le processeur de flux à l’aide de la commande suivante.

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

   1. Créez processeur de flux avec la même configuration. Pour de plus amples informations, veuillez consulter [Utilisation des vidéos streaming](streaming-video.md).

   1. Si le problème persiste, contactez le AWS Support.

1. Si la valeur de `Status` est `RUNNING`, consultez [Raison 3 : il n’y a pas de données actives dans le flux vidéo Kinesis](#ts-no-data).

### Raison 3 : il n’y a pas de données actives dans le flux vidéo Kinesis
<a name="ts-no-data"></a>

**Pour vérifier s’il n’y a pas de données actives dans le flux vidéo Kinesis**

1. Connectez-vous à la AWS Management Console console [https://console.aws.amazon.com/kinesisvideo/](https://console.aws.amazon.com/kinesisvideo/)Amazon Kinesis Video Streams et ouvrez-la à l'adresse.

1. Sélectionnez le flux vidéo Kinesis qui est l’entrée du processeur de flux Amazon Rekognition.

1. Si l’aperçu indique **No data on stream**, cela signifie qu’il n’y a pas de données à traiter dans le flux d’entrée par Vidéo Amazon Rekognition.

Pour plus d’informations sur la production de vidéos avec Kinesis Video Streams, consultez [Bibliothèques de production de flux vidéo Kinesis](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/producer-sdk.html). 

## L’état de mon processeur de flux est FAILED
<a name="ts-failed-state"></a>

Vous pouvez vérifier l'état d'un processeur de flux à l'aide de la AWS CLI commande suivante.

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

Si la valeur de l’état est FAILED, vérifiez les informations de résolution de problèmes pour les messages d’erreur suivants.

### Erreur : »Accès refusé à « Role »
<a name="w2aac27c79c29c15b9"></a>

Le rôle IAM qui est utilisé par le processeur de flux n’existe pas ou Vidéo Amazon Rekognition n’a pas l’autorisation d’assumer ce rôle.

**Pour résoudre les problèmes d’accès au rôle IAM**

1. Connectez-vous à la console IAM AWS Management Console et ouvrez-la à [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)l'adresse.

1. Dans le panneau de navigation gauche, choisissez **Roles (Rôles)** et vérifiez que le rôle existe. 

1. Si le rôle existe, vérifiez qu'il est conforme à la politique *AmazonRekognitionServiceRole*d'autorisation.

1. Si le rôle n’existe pas ou n’a pas les autorisations appropriées, consultez [Octroi à Vidéo Amazon Rekognition d’un accès à vos ressources](api-streaming-video-roles.md).

1. Démarrez le processeur de flux à l'aide de la AWS CLI commande suivante.

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

### Erreur : « Accès refusé à Kinesis Video *or* Accès refusé à Kinesis Data »
<a name="w2aac27c79c29c15c11"></a>

Le rôle n’a pas accès aux opérations d’API Kinesis Video Streams `GetMedia` et `GetDataEndpoint`. Il est également possible qu’il n’ait pas accès aux opérations d’API flux de données Kinesis `PutRecord` et `PutRecords`. 

**Pour résoudre les problèmes relatifs aux autorisations d’API**

1. Connectez-vous à la console IAM AWS Management Console et ouvrez-la à [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)l'adresse.

1. Ouvrez le rôle et assurez-vous que la stratégie d’autorisations suivante lui est attachée.

1. S’il manque l’une des autorisations, mettez à jour la stratégie. Pour de plus amples informations, veuillez consulter [Octroi à Vidéo Amazon Rekognition d’un accès à vos ressources](api-streaming-video-roles.md).

### Erreur : « Diffusez {{nom du flux vidéo d'entrée}} n'existe pas »
<a name="w2aac27c79c29c15c13"></a>

L’entrée flux vidéo Kinesis du processeur de flux n’existe pas ou n’a pas été configurée correctement. 

**Pour résoudre les problèmes de flux de vidéo Kinesis**

1. Utilisez la commande suivante pour vérifier que le flux existe. 

   ```
   aws kinesisvideo list-streams
   ```

1. Si le flux existe, vérifiez les points suivants.
   + L’Amazon Resource Name (ARN) est identique à l’ARN du flux d’entrée pour le processeur de flux.
   + Le flux vidéo Kinesis doit se trouver dans la même région que le processeur de flux.

   Si le processeur de flux n'est pas configuré correctement, supprimez-le à l'aide de la AWS CLI commande suivante.

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

1. Créez un processeur de flux avec les flux vidéo Kinesis. Pour de plus amples informations, veuillez consulter [Création du processeur de flux de recherche faciale Vidéo Amazon Rekognition](rekognition-video-stream-processor-search-faces.md#streaming-video-creating-stream-processor).

### Erreur  : « Collection non trouvée »
<a name="w2aac27c79c29c15c15"></a>

La collection Amazon Rekognition utilisée par le processeur de flux pour trouver les correspondances de visages n’existe pas ou la mauvaise collection est utilisée.

**Pour vérifier qu’il s’agit de la bonne collection**

1. Utilisez la AWS CLI commande suivante pour déterminer si la collection requise existe. Passez `region` à la AWS région dans laquelle vous utilisez votre processeur de streaming.

   ```
   aws rekognition list-collections --region {{region}}
   ```

   Si la collection requise n’existe pas, créez-en une nouvelle et ajoutez des informations sur le visage. Pour de plus amples informations, veuillez consulter [Recherche de visages dans une collection](collections.md).

1. Dans votre appel à [CreateStreamProcessor](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateStreamProcessor.html), vérifiez que la valeur du paramètre d'entrée `CollectionId` est correcte.

1. Démarrez le processeur de flux à l'aide de la AWS CLI commande suivante.

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

### Erreur : « Stream {{nom-flux de données kinésien de sortie}} sous compte {{id-compte}} non trouvé »
<a name="w2aac27c79c29c15c17"></a>

Le flux de données Kinesis de sortie utilisé par le processeur de flux n'existe pas dans votre région Compte AWS ou ne se trouve pas dans la même AWS région que votre processeur de flux.

**Pour résoudre les problèmes de flux de données Kinesis**

1. Utilisez la AWS CLI commande suivante pour déterminer si le flux de données Kinesis existe. Passez `region` à la AWS région dans laquelle vous utilisez votre processeur de streaming.

   ```
   aws kinesis list-streams --region {{region}}
   ```

1. Si le flux de données Kinesis existe, vérifiez que le nom de flux de données Kinesis est le même que celui du flux de sortie qui est utilisé par le processeur de flux.

1. Si le flux de données Kinesis n'existe pas, il se peut qu'il existe dans une autre AWS région. Le flux de données Kinesis doit se trouver dans la même région que le processeur de flux.

1. Le cas échéant, créez un flux de données Kinesis. 

   1. Créez un flux de données Kinesis avec le même nom que celui utilisé par le processeur de flux. Pour plus d’informations, consultez [Etape 1 : Création d’un flux de données](https://docs.aws.amazon.com/streams/latest/dev/learning-kinesis-module-one-create-stream.html).

   1. Démarrez le processeur de flux à l'aide de la AWS CLI commande suivante.

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

## Mon processeur de flux ne renvoie pas les résultats attendus
<a name="w2aac27c79c29c17"></a>

Si votre processeur de flux ne renvoie pas les correspondances de visages attendues, utilisez les informations suivantes.
+ [Recherche de visages dans une collection](collections.md)
+ [Recommandations pour la configuration de la caméra (vidéo en streaming)](recommendations-camera-streaming-video.md)