Configurer AWS IoT journalisation

1. Sous Sélectionner une entité approuvée, choisissez AWS Service . Choisissez ensuite IoT sous Cas d'utilisation. Si vous ne voyez pas IoT, saisissez et recherchez IoT dans le menu déroulant Cas d'utilisation pour d'autres AWS services :. Sélectionnez Suivant.

2. Sur la page Ajouter des autorisations, vous verrez les politiques automatiquement associées au rôle de service. Choisissez Suivant.

3. Sur la page Name, review, and Create (Créer un rôle et vérifier), saisissez un Role name (Nom du rôle) etRole description (Description de Role) pour le role, puis Create role(Créer un rôle).

Pour configurer AWS IoT journalisation :

1. Connectez-vous à la AWS IoT console. Pour de plus amples informations, veuillez consulter Ouvrez le fichier AWS IoT console.

2. Dans le volet de navigation de gauche, choisissez Journaux (auparavant, une section sous Paramètres).

3. Configurez la journalisation au niveau du compte : la journalisation au niveau du compte s'applique à l'ensemble de votre AWS IoT parc (appareils ou terminaux), sauf si elle est remplacée par des paramètres spécifiques au niveau des événements ou des ressources.

   1. Dans la section Account-level Journalisation, sélectionnez Gérer la journalisation au niveau du compte pour effectuer les mises à jour.

   2. Cochez la case « Activer la journalisation » pour commencer à envoyer des journaux à CloudWatch. Lorsque « Activer la journalisation » n'est pas cochée, AWS IoT aucun CloudWatch journal n'est envoyé aux groupes de journaux, quelles que soient les configurations de journalisation au niveau des événements ou des ressources.

   3. Sous Rôle de journal IAM, sélectionnez un rôle existant dans la liste déroulante. Vous pouvez Afficher les détails des rôles pour inspecter les autorisations des rôles. Vous pouvez également sélectionner Créer un nouveau rôle pour configurer un nouveau rôle IAM. Le rôle de journalisation fournit des politiques qui permettent AWS IoT de soumettre des entrées de journal CloudWatch à en votre nom. Si vous configurez la journalisation au niveau des événements avec un groupe de CloudWatch journaux personnalisé, vous devez mettre à jour la politique de rôle pour inclure l'ARN de ce groupe de journaux.

   4. Choisissez le niveau de journal par défaut qui correspond au niveau de détail des entrées de journal que vous souhaitez voir apparaître dans les CloudWatch journaux. Remarque : le niveau de journalisation « DEBUG » fournit le plus de détails mais augmente CloudWatch les coûts. CloudWatch les destinations des groupes de journaux ne peuvent pas être configurées au niveau du compte. Vous pouvez toutefois spécifier des groupes de journaux personnalisés pour des types d'événements individuels, comme décrit dans la section suivante.

   5. Choisissez Mettre à jour la journalisation pour enregistrer vos modifications.

4. Event-level la journalisation vous permet de capturer des journaux de manière sélective pour les événements pertinents et de les diriger vers des groupes de CloudWatch journaux dédiés. Cela vous permet d'organiser les journaux par cas d'utilisation pour une meilleure visibilité, de les partager avec différents publics et de réduire les CloudWatch coûts en activant les journaux et en définissant des niveaux de journalisation en fonction de la criticité des événements.

   Configurer la journalisation au niveau des événements  : la journalisation au niveau des événements capture des AWS IoT événements spécifiques, tels que les tentatives d'authentification des clients. Ces paramètres annulent la Account-Level journalisation.

   1. Dans la section Event-level Journalisation, sélectionnez Gérer la journalisation au niveau des événements pour effectuer des mises à jour.

   2. Par défaut, les types d'événements héritent de la configuration de journalisation au niveau du compte. Remarque : Lorsque la journalisation spécifique à une ressource est configurée, elle remplace les paramètres au niveau du compte et de l'événement.

   3. Pour modifier les paramètres d'événements individuels, cliquez sur la valeur dans la ligne d'événements correspondante. Vous pouvez régler à la fois le niveau de journalisation et la destination du groupe de CloudWatch logs. Lorsque vous spécifiez une destination de groupe de CloudWatch journaux personnalisée, vous devez vérifier que la politique de rôle IAM inclut des autorisations pour le nouveau groupe de journaux. L'absence de mise à jour de la politique de rôle AWS IoT empêchera l'écriture de journaux dans le groupe de journaux personnalisé. Après avoir effectué votre sélection, cliquez sur la coche pour confirmer votre choix. La colonne « Modifié » affichera « Oui » pour indiquer les modifications en attente.

   4. Cliquez sur Mettre à jour la journalisation pour appliquer vos modifications ou cliquez sur Annuler pour les annuler.

5. Configurer les Resource-specific remplacements : les Resource-specific remplacements appliquent un paramètre de journalisation aux ressources sélectionnées. Une ressource peut être un groupe d'objets, une adresse IP source, un identifiant client ou un identifiant principal. Resource-specific la configuration de journalisation remplace les paramètres au niveau du compte et au niveau des événements. Lorsqu'il est activé, il génère des journaux pour tous les types d'événements au niveau de journalisation configuré pour les ressources spécifiées. Par exemple, vous pouvez définir la journalisation au niveau du débogage pour un objet spécifique tout en conservant la journalisation au niveau des informations pour tous les autres objets.

   1. Sélectionnez Ajouter des remplacements spécifiques à la ressource dans la Resource-specific section Dérogations.

   2. Choisissez une cible de journal : groupe d'objets, adresse IP source, identifiant client ou identifiant principal.

   3. Entrez la valeur cible de journal correspondante pour le type de cible que vous avez sélectionné.

   4. Sélectionnez le niveau de journalisation souhaité dans le menu déroulant de la section Niveau de Resource-specific journalisation.

   5. Cliquez sur Soumettre pour ajouter la modification ou sur Annuler pour annuler les modifications.

   6. Pour modifier une dérogation spécifique à une ressource existante, cochez la case à côté de la ressource et cliquez sur « Supprimer » pour supprimer la dérogation ou sur « Modifier » pour la modifier.

Pour utiliser l'interface de ligne de commande afin de configurer la journalisation par défaut pour AWS IoT

1. Utilisez la commande set-v2-logging-options pour définir les options de journalisation de votre compte.

   aws iot set-v2-logging-options \
       --event-configurations event-configuration-list \
       --role-arn logging-role-arn \
       --default-log-level log-level

   où :

   --role-arn

   Le rôle ARN qui accorde AWS IoT l'autorisation d'écrire dans vos CloudWatch journaux dans Logs. Role-arn la configuration est requise pour la configuration initiale.

   --default-log-level

   Le niveau de journalisation à utiliser. Les valeurs valides sont : ERROR WARNINFO,DEBUG, ouDISABLED. Default-log-level la configuration est requise pour la configuration initiale.

   --no-disable-all-logs

   Paramètre facultatif qui active l'ensemble de la AWS IoT journalisation. Utilisez ce paramètre pour activer la journalisation lorsqu'elle est désactivée.

   --disable-all-logs

   Paramètre facultatif qui désactive toute AWS IoT journalisation. Utilisez ce paramètre pour désactiver la journalisation lorsqu'elle est activée.

   --event-configurations

   Ce paramètre est facultatif et vous permet de personnaliser les paramètres de journalisation pour chaque type d'événement :

   • EventType : type d'événement qui remplace le paramètre au niveau du compte

   • LogLevel : remplacez le paramètre au niveau du compte par DEBUG, INFO, ERROR, WARN ou DISABLED

   • LogDestination : Spécifiez un groupe de CloudWatch journaux personnalisé pour la remise des journaux

   Vous pouvez configurer le niveau de journalisation et la destination du journal indépendamment pour chaque type d'événement. Si ce n'est pas spécifié, les événements hériteront des paramètres au niveau du compte

   aws iot set-v2-logging-options \
       --event-configurations "[{\"eventType\":\"Publish-In\",\"logLevel\":\"INFO\",\"logDestination\":\"examplePublishInLogGroup\"}]"

2. Utilisez la commande get-v2-logging-options pour obtenir vos options de journalisation actuelles.

   aws iot get-v2-logging-options \
       --verbose

   où :

   --verbose

   Paramètre facultatif qui vous permet de récupérer tous les EventTypes et leurs configurations.

Pour utiliser l'interface de ligne de commande afin de configurer des Resource-specific remplacements pour AWS IoT

1. Activez la journalisation au niveau du compte avant de configurer la journalisation spécifique aux ressources à l'aide de la commande suivante : commande aws iot set-v2-logging-options

2. Utilisez la set-v2-logging-level commande pour configurer les Resource-specific remplacements. Consultez l'exemple suivant pour la configuration des groupes d'objets :

   aws iot set-v2-logging-level \
                 --log-target targetType=THING_GROUP,targetName=thing_group_name \
                 --log-level log_level

   --log-target

   Type et nom de la ressource pour laquelle vous configurez la journalisation. La targetType valeur doit être l'une des suivantes : THING_GROUP | CLIENT_ID | SOURCE_IP |PRINCIPAL_ID. La valeur du paramètre log-target peut être du texte, comme indiqué dans l'exemple de commande précédent, ou une chaîne JSON, telle que l'exemple suivant.

   aws iot set-v2-logging-level \
                 --log-target '{"targetType": "THING_GROUP","targetName": "thing_group_name"}' \
                 --log-level log_level

   --log-level

   Le niveau de journalisation utilisé lors de la génération de journaux pour la ressource spécifiée. Les valeurs valides sont : DEBUG, INFO, ERROR, WARN et DISABLED.

3. Utilisez la commande list-v2-logging-levels pour répertorier les niveaux de journalisation actuellement configurés.

   aws iot list-v2-logging-levels

4. Utilisez la commande delete-v2-logging-level pour supprimer un niveau de journalisation spécifique à la ressource, tel que les exemples suivants.

   aws iot delete-v2-logging-level \
                 --target-type "THING_GROUP" \
                 --target-name "thing_group_name"

   aws iot delete-v2-logging-level \
                 --target-type=CLIENT_ID 
                 --target-name=ClientId1

   --target-type

   La target-type valeur doit être l'une des suivantes : THING_GROUP | CLIENT_ID | SOURCE_IP |PRINCIPAL_ID.

   --target-name

   Nom du groupe d'objets pour lequel le niveau de journalisation doit être supprimé.