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.

Surveillez 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 de plus amples informations, veuillez consulter Créer 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-name avec 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 :

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 :

Vous pouvez configurer les passerelles SiteWise Edge pour enregistrer les informations dans CloudWatch Logs through AWS IoT Greengrass. Pour de plus amples informations, veuillez consulter Surveiller les 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 de plus amples informations, veuillez consulter Résoudre les problèmes liés à une action de AWS IoT SiteWise règle.

Gérer la connexion AWS IoT SiteWise

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

Trouvez 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"
  }
}

Modifier votre niveau de journalisation

Utilisez la procédure suivante pour modifier votre niveau de journalisation dans la AWS IoT SiteWise console ou en utilisant 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 Save (Enregistrer).

AWS CLI

Exécutez la AWS CLI commande suivante pour modifier votre niveau de AWS IoT SiteWise journalisation. Remplacez logging-level avec le niveau de journalisation que vous souhaitez.

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"
  }
}