

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.

# AWS IoT Dépannage des tâches
<a name="jobs-troubleshooting"></a>

Il s'agit de la section de résolution des problèmes pour AWS IoT Jobs.

## Comment localiser un point de terminaison AWS IoT Jobs ?
<a name="jobs-endpoint-troubleshooting"></a>

**Comment localiser le point de terminaison du plan de contrôle des AWS IoT tâches ?**  
AWS IoT Jobs prend en charge les opérations de l'API du plan de contrôle à l'aide du protocole HTTPS. Vérifiez que vous vous êtes connecté au point de terminaison du plan de contrôle approprié à l'aide du protocole HTTPS.  
Pour obtenir la liste des points de terminaison AWS spécifiques à une région, voir Points de terminaison du plan de [contrôle AWS IoT du noyau](https://docs.aws.amazon.com/general/latest/gr/iot-core.html#iot-core-control-plane-endpoints).  
Pour obtenir la liste des points de terminaison du **AWS IoT plan de contrôle des tâches** conformes à la norme FIPS, voir [Points de terminaison FIPS par service](https://aws.amazon.com//compliance/fips/#FIPS_Endpoints_by_Service)  
AWS IoT Emplois et AWS IoT Core partage les mêmes points de terminaison AWS spécifiques à une région.

**Comment localiser le point de terminaison du plan de données AWS IoT Jobs ?**  
AWS IoT Jobs prend en charge les opérations d'API du plan de données à l'aide des protocoles HTTPS et MQTT. Vérifiez que vous vous êtes connecté au point de terminaison du plan de données approprié à l'aide du protocole HTTPS ou MQTT.  
+ Protocole : HTTP
  + Utilisez la commande [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-endpoint.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-endpoint.html)CLI ci-dessous ou l'[https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeEndpoint.html](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeEndpoint.html)API REST. Pour le type de point de terminaison, utilisez `iot:Jobs`.

    ```
    aws iot describe-endpoint --endpoint-type iot:Jobs
    ```
+ Protocole MQTT
  + Utilisez la commande [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-endpoint.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/describe-endpoint.html)CLI ci-dessous ou l'[https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeEndpoint.html](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeEndpoint.html)API REST. Pour le type de point de terminaison, utilisez `iot:Data-ATS`.

    ```
    aws iot describe-endpoint --endpoint-type iot:Data-ATS
    ```
Pour une liste des points de terminaison du **AWS IoT plan de données des Tâches** conformes à la norme FIPS, voir [Points de terminaison FIPS par service](https://aws.amazon.com//compliance/fips/#FIPS_Endpoints_by_Service)

## Comment puis-je surveiller l'activité AWS IoT des offres d'emploi et fournir des statistiques ?
<a name="jobs-logs-troubleshooting"></a>

Le suivi de l'activité des AWS IoT Jobs à l'aide d'Amazon CloudWatch fournit une visibilité en temps réel des opérations AWS IoT Jobs en cours et permet de contrôler les coûts grâce à des CloudWatch alarmes via AWS IoT des règles. Vous devez configurer la journalisation avant de pouvoir surveiller l'activité AWS IoT des tâches et configurer des CloudWatch alarmes. Pour plus d'informations sur la mise en place de la journalisation, consultez [Configuration de la AWS IoT journalisation](configure-logging.md).

Pour plus d'informations sur Amazon CloudWatch et sur la façon de configurer l'autorisation via un rôle d'utilisateur IAM pour utiliser les CloudWatch ressources, consultez [Gestion des identités et des accès pour Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/auth-and-access-control-cw.html).

**Comment configurer les statistiques et le suivi AWS IoT des offres d'emploi à l'aide d'Amazon CloudWatch ?**  
Pour configurer la AWS IoT journalisation, suivez les étapes décrites dans [Configurer la AWS IoT journalisation](https://docs.aws.amazon.com/iot/latest/developerguide/configure-logging.html). AWS IoT la configuration de la journalisation peut être effectuée dans l'API AWS Management Console AWS CLI, ou. AWS IoT la configuration de la journalisation pour des groupes d'objets spécifiques doit être effectuée uniquement dans l'API AWS CLI or.  
La section [Mesures relatives aux AWS IoT tâches](https://docs.aws.amazon.com/iot/latest/developerguide/metrics_dimensions.html#jobs-metrics) contient les mesures relatives aux AWS IoT tâches utilisées pour surveiller l'activité AWS IoT des tâches. Il explique comment afficher les métriques dans le AWS Management Console et AWS CLI.  
En outre, vous pouvez configurer des CloudWatch alarmes pour vous avertir des mesures spécifiques que vous souhaitez surveiller de près. Pour obtenir des conseils sur la configuration des alarmes, consultez la section [Utilisation des CloudWatch alarmes Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html).

## Gestion des flottes d'appareils et résolution des problèmes liés à un seul appareil
<a name="jobs-troubleshooting-for-fleethub"></a>

**L'exécution d'une tâche conserve un statut `QUEUED` indéfini**  
Lorsqu'une exécution de tâche dont l'état d'état est égal à `QUEUED` ne passe pas à l'état logique suivant, tel que `IN_PROGRESS`, `FAILED`, ou `TIMED_OUT`, l'un des scénarios suivants peut en être la cause :  
+ Passez en revue l'activité de votre appareil dans les CloudWatch journaux situés dans la [CloudWatch console](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/WhatIsCloudWatchLogs.html). Pour plus d'informations, reportez-vous à la section [Surveillance à AWS IoT l'aide CloudWatch des journaux](https://docs.aws.amazon.com/iot/latest/developerguide/cloud-watch-logs.html).
+ Le rôle IAM associé à la tâche et à son exécution ultérieure peut ne pas disposer des autorisations correctes répertoriées dans l'une des déclarations de politique de la stratégie IAM attachée à ce rôle IAM. Utilisez l'[https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeJob.html](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeJob.html)API pour identifier le rôle IAM lié à cette tâche et à son exécution ultérieure, et vérifiez la politique IAM pour connaître les autorisations correctes. Une fois que les déclarations d'autorisation de politique ont été mises à jour, vous devriez être en mesure d'exécuter la commande [https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)API sur la ressource.

**Aucune exécution de tâche n'a été créée pour mon objet ou mon groupe d'objets**  
Lorsqu'une tâche met à jour son statut`IN_PROGRESS`, elle commence à déployer le document de tâche sur tous les appareils de votre groupe cible. Cette mise à jour de l'état créera une exécution de tâche pour chaque équipement cible. Si aucune exécution de tâche n'a été créée pour l'un des équipements cibles, reportez-vous aux instructions suivantes :  
+ La tâche est-elle `thing` *directement* ciblée par la tâche, la tâche a-t-elle un statut égal `IN_PROGRESS` à et la tâche est-elle simultanée ? Si les trois conditions sont remplies, la tâche continue d'envoyer des exécutions de tâches à tous les appareils de votre groupe cible et cette tâche spécifique n'`thing`a pas encore été exécutée.
  + Vérifiez les appareils de votre groupe cible pour connaître la tâche et l'état de l'état de la tâche dans la console de AWS gestion ou utilisez la commande [https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeJob.html](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeJob.html)API.
  + Utilisez la commande [https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeJob.html](https://docs.aws.amazon.com/iot/latest/apireference/API_DescribeJob.html)API pour vérifier si la `IsConcurrent` propriété de la tâche est définie sur true ou false. Pour plus d'informations, consultez [Job Limits](https://docs.aws.amazon.com/iot/latest/developerguide/job-limits.html).
+ Le n’`thing` est * pas directement* visé par la tâche.
  + Si le `Thing` a été ajouté à un `ThingGroup` et que la tâche le ciblait`ThingGroup`, vérifiez `Thing` qu'il fait partie du `ThingGroup`.
  + S'il s'agit d'un travail de `IN_PROGRESS` capture instantanée dont le statut est simultané, le travail envoie toujours des exécutions de tâches à tous les appareils de votre groupe cible et cette tâche spécifique n'`Thing`a pas encore été exécutée.
  + S'il s'agit d'une tâche continue dont le statut de `IN_PROGRESS` et est simultané, la tâche continue d'envoyer des exécutions de tâches à tous les appareils de votre groupe cible et cette tâche spécifique n'`Thing`a pas encore été exécutée. Pour les tâches continues uniquement, vous pouvez également supprimer le `Thing` du, `ThingGroup` puis le `Thing` rajouter au`ThingGroup`.
  + S'il s'agit d'une tâche instantanée dont l'état de statut est égal à `IN_PROGRESS` et qu'elle n'est pas simultanée, il est probable que la relation `ThingGroup` d'adhésion `Thing` ou d'adhésion ne soit pas reconnue par AWS IoT Jobs. Il est recommandé d'ajouter quelques secondes d'attente après votre `AddThingToThingGroup` appel avant de créer votre`Job`. Vous pouvez également passer à la sélection cible`Continuous`, ce qui permettra au service de remplacer l'événement retardé `Thing` et de rattachement de l'`ThingGroup`adhésion.

**La nouvelle tâche échoue en raison d'une `LimitedExceededException`erreur**  
Si la création de votre tâche échoue avec une réponse d'erreur de`LimitedExceededException`, appelez l'`list-jobs`API et passez en revue toutes les tâches `isConcurrent=true` pour déterminer si vous avez atteint votre limite de simultanéité des tâches. Voir [Limites de tâches](https://docs.aws.amazon.com/iot/latest/developerguide/job-limits.html) pour plus d'informations sur les tâches simultanées. Pour consulter vos limites de simultanéité de tâches et pour demander une augmentation de la limite, consultez [AWS IoT Device Management Limites et quotas de tâches](https://docs.aws.amazon.com/general/latest/gr/iot_device_management.html#job-limits).

 **Limite de taille du document**  
La taille du document de travail est limitée par la taille de la charge utile MQTT. Si vous avez besoin d'un document de travail supérieur à 32 kB (kilo-octets) ou 32 000 Go (octets), créez et stockez le document de travail dans Amazon S3 et ajoutez l'URL d'un objet Amazon S3 dans le `documentSource` champ de l'`CreateJob`API ou à l'aide du AWS CLI. Pour le AWS Management Console, ajoutez l'URL d'un objet Amazon S3 dans la zone de texte URL Amazon S3 lors de la création d'une tâche.  
+ AWS Management Console créer de la documentation sur les tâches : [créez et gérez les tâches à l'aide du AWS Management Console](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-console.html)
+ AWS CLI créer de la documentation sur les tâches : [créez et gérez les tâches à l'aide du AWS CLI](https://docs.aws.amazon.com/iot/latest/developerguide/manage-job-cli.html)
+ `CreateJob`Documentation de l'API : [CreateJob](https://docs.aws.amazon.com/iot/latest/apireference/API_CreateJob.html)

**Les messages MQTT côté appareil demandent des limites de limitation**  
Si vous recevez un code d'erreur 400 `ThrottlingException`, le message MQTT côté appareil a échoué car la limite de demandes simultanées côté appareil a été atteinte. Consultez les [AWS IoT Device Management limites et quotas des tâches](https://docs.aws.amazon.com/general/latest/gr/iot_device_management.html#job-limits) pour plus d'informations sur les limites d'accélération et pour savoir si elles sont ajustables.

**Erreur de délai de connexion**  
Un code d'erreur 400 `RequestExpired` indique un échec de connexion dû à une latence élevée ou à de faibles valeurs de délai d'attente côté client.  
+ Voir [Tester la connectivité avec le point de terminaison de données de votre appareil](https://docs.aws.amazon.com/iot/latest/developerguide/iot-quick-start-test-connection.html) pour plus d'informations sur le test de la connexion entre le côté client et le côté serveur.

**Commande d'API non valide**  
Vérifiez que la bonne commande d'API a été saisie pour éviter un message d'erreur indiquant que la commande d'API n'est pas valide. Consultez la [AWS IoT Référence d'API](https://docs.aws.amazon.com/iot/latest/apireference/Welcome.html) pour une liste complète de toutes les commandes AWS IoT d'API.

**Erreur de connexion côté service**  
Un code d'erreur 503 `ServiceUnavailable` indique que l'erreur provient du côté serveur.  
+ Voir [Tableau de bord AWS Health (tous les AWS services)](https://health.aws.amazon.com/health/status) pour connaître l'état actuel de tous les AWS services.
+ Voir [Tableau de bord AWS Health (personnel Compte AWS)](https://aws.amazon.com/premiumsupport/technology/aws-health-dashboard/) pour le statut actuel de votre compte personnel Compte AWS.