AWS IoT Dépannage des tâches - AWS IoT Core

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

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 ?

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.

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

Note

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 describe-endpointCLI ci-dessous ou l'DescribeEndpointAPI REST. Pour le type de point de terminaison, utilisez iot:Jobs.

      aws iot describe-endpoint --endpoint-type iot:Jobs
  • Protocole MQTT

    • Utilisez la commande describe-endpointCLI ci-dessous ou l'DescribeEndpointAPI REST. Pour le type de point de terminaison, utilisez iot:Data-ATS (recommandé) ouiot:Data.

      aws iot describe-endpoint --endpoint-type iot:Data-ATS (recommended)
      aws iot describe-endpoint --endpoint-type iot:Data

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

Comment puis-je surveiller l'activité AWS IoT des offres d'emploi et fournir des statistiques ?

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.

Pour plus d'informations sur Amazon CloudWatch et sur la manière 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.

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

Gestion des flottes d'appareils et résolution des problèmes liés à un seul appareil

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. Pour plus d'informations, reportez-vous à la section Surveillance à AWS IoT l'aide CloudWatch des journaux.

  • 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'describe-jobAPI 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 AssumeRoleAPI 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 statutIN_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'thinga 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 describe-jobAPI.

    • Utilisez la commande describe-jobAPI 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.

  • 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 ciblaitThingGroup, 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'Thinga 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'Thinga pas encore été exécutée. Pour les tâches continues uniquement, vous pouvez également supprimer le Thing du, ThingGroup puis le Thing rajouter auThingGroup.

    • S'il s'agit d'une tâche instantanée dont l'état de IN_PROGRESS statut est non simultané, 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 votreJob. Vous pouvez également passer à la sélection cibleContinuous, ce qui permettra au service de remplacer l'événement retardé Thing et de rattachement de l'ThingGroupadhésion.

La nouvelle tâche échoue en raison d'une LimitedExceededExceptionerreur

Si la création de votre tâche échoue avec une réponse d'erreur deLimitedExceededException, appelez l'list-jobsAPI 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 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.

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'CreateJobAPI 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.

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

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