Surveillance avec Amazon CloudWatch Logs

Configurez AWS IoT SiteWise pour consigner les informations dans CloudWatch les journaux afin de surveiller et de dépanner le service.

Lorsque vous utilisez la AWS IoT SiteWise console, AWS IoT SiteWise crée un rôle lié au service qui permet au service de consigner des informations en votre nom. Si vous n'utilisez pas la AWS IoT SiteWise console, vous devez créer manuellement un rôle lié à un service pour recevoir les journaux. Pour plus d’informations, consultez Création d'un rôle lié à un service pour AWS IoT SiteWise.

Vous devez disposer d'une politique de ressources permettant de AWS IoT SiteWise placer les événements du journal dans des CloudWatch flux. Pour créer et mettre à jour une politique de ressources pour CloudWatch les journaux, exécutez la commande suivante. Remplacez logging-policy-namepar le nom de la politique à créer.

aws logs put-resource-policy --policy-name logging-policy-name --policy-document "{ \"Version\": \"2012-10-17\", \"Statement\": [ { \"Sid\": \"IoTSiteWiseToCloudWatchLogs\", \"Effect\": \"Allow\", \"Principal\": { \"Service\": [ \"iotsitewise.amazonaws.com\" ] }, \"Action\":\"logs:PutLogEvents\", \"Resource\": \"*\" } ] }"

CloudWatch Logs prend également en charge les clés contextuelles de SourceAccount condition aws : SourceArn et aws :. Ces clés de contexte de condition sont facultatives.

Pour créer ou mettre à jour une politique de ressources qui AWS IoT SiteWise permet de placer uniquement les journaux associés à la AWS IoT SiteWise ressource spécifiée dans des CloudWatch flux, exécutez la commande et procédez comme suit :

• Remplacez logging-policy-namepar le nom de la politique à créer.

• Remplacez Source-ARN par l'ARN de votre AWS IoT SiteWise ressource, tel qu'un modèle d'actif ou un actif. Pour trouver l'ARN de chaque type de AWS IoT SiteWise ressource, consultez la section Types de ressources définis par AWS IoT SiteWise dans la référence d'autorisation de service.

• Remplacez Account-ID par l'ID de AWS compte associé à la ressource spécifiée AWS IoT SiteWise .

aws logs put-resource-policy --policy-name logging-policy-name --policy-document "{ \"Version\": \"2012-10-17\", \"Statement\": [ { \"Sid\": \"IoTSiteWiseToCloudWatchLogs\", \"Effect\": \"Allow\", \"Principal\": { \"Service\": [ \"iotsitewise.amazonaws.com\" ] }, \"Action\":\"logs:PutLogEvents\", \"Resource\": \"*\", \"Condition\":{\"StringLike\":{\"aws:SourceArn\":[\"source-ARN\"],\"aws:SourceAccount\":[\"account-ID\"]}}}]}"

Par défaut, AWS IoT SiteWise n'enregistre pas les informations dans CloudWatch Logs. Pour activer la journalisation, choisissez un niveau de journalisation autre que Disabled (OFF). AWS IoT SiteWise prend en charge les niveaux de journalisation suivants :

• OFF— La journalisation est désactivée.

• ERROR— Les erreurs sont enregistrées.

• INFO— Les erreurs et les messages d'information sont enregistrés.

Vous pouvez configurer les passerelles SiteWise Edge pour enregistrer les informations dans CloudWatch Logs through AWS IoT Greengrass. Pour plus d’informations, consultez Surveillance des journaux de la passerelle SiteWise Edge.

Vous pouvez également configurer AWS IoT Core pour consigner les informations dans les CloudWatch journaux si vous dépannez une action de AWS IoT SiteWise règle. Pour plus d’informations, consultez Résolution des problèmes liés à une action de AWS IoT SiteWise règle.

Table des matières

• Gestion de la connexion AWS IoT SiteWise
  • Trouver votre niveau de journalisation
  • Modification de votre niveau de journalisation
• Exemple : entrées de fichier AWS IoT SiteWise journal

Gestion de la connexion AWS IoT SiteWise

Utilisez la AWS IoT SiteWise console ou AWS CLI pour les tâches de configuration de journalisation suivantes.

Trouver votre niveau de journalisation

Console

Suivez la procédure suivante pour trouver votre niveau de journalisation actuel dans la console AWS IoT SiteWise .

Pour trouver votre niveau de AWS IoT SiteWise journalisation actuel

1. Accédez à la console AWS IoT SiteWise.

2. Dans le panneau de navigation de gauche, choisissez Options de journalisation.

   L'état de journalisation actuel apparaît sous Statut de journalisation. Si la journalisation est activée, le niveau de journalisation actuel apparaît sous Niveau de verbosité.

AWS CLI

Exécutez la commande suivante pour trouver votre niveau de AWS IoT SiteWise journalisation actuel avec le AWS CLI.

aws iotsitewise describe-logging-options

L'opération renvoie une réponse qui contient votre niveau de journalisation au format suivant.

{
  "loggingOptions": {
    "level": "String"
  }
}

Modification de votre niveau de journalisation

Utilisez la procédure suivante pour modifier votre niveau de journalisation dans la AWS IoT SiteWise console ou à l'aide de AWS CLI.

Console

Pour modifier votre niveau de AWS IoT SiteWise journalisation

1. Accédez à la console AWS IoT SiteWise.

2. Dans le panneau de navigation de gauche, choisissez Options de journalisation.

3. Choisissez Modifier.

4. Choisissez le niveau de verbosité à activer.

5. Choisissez Enregistrer.

AWS CLI

Exécutez la AWS CLI commande suivante pour modifier votre niveau de AWS IoT SiteWise journalisation. Remplacez le niveau de journalisation par le niveau de journalisation souhaité.

aws iotsitewise put-logging-options --logging-options level=logging-level

Exemple : entrées de fichier AWS IoT SiteWise journal

Chaque entrée de AWS IoT SiteWise journal inclut des informations sur l'événement et des ressources pertinentes pour cet événement, afin que vous puissiez comprendre et analyser les données du journal.

L'exemple suivant montre une entrée CloudWatch Logs qui AWS IoT SiteWise se connecte lorsque vous créez avec succès un modèle d'actif.

{
  "eventTime": "2020-05-05T00:10:22.902Z",
  "logLevel": "INFO",
  "eventType": "AssetModelCreationSuccess",
  "message": "Successfully created asset model.",
  "resources": {
    "assetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE"
  }
}