Monitoraggio con Amazon CloudWatch Logs - AWS IoT SiteWise
Gestisci l'accesso AWS IoT SiteWiseEsempio: voci dei file di AWS IoT SiteWise registro

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Monitoraggio con Amazon CloudWatch Logs

Configura AWS IoT SiteWise per registrare le informazioni in CloudWatch Logs per monitorare e risolvere i problemi del servizio.

Quando usi la AWS IoT SiteWise console, AWS IoT SiteWise crea un ruolo collegato al servizio che consente al servizio di registrare le informazioni per tuo conto. Se non utilizzi la AWS IoT SiteWise console, devi creare manualmente un ruolo collegato al servizio per ricevere i log. Per ulteriori informazioni, consulta Creare un ruolo collegato al servizio per AWS IoT SiteWise.

È necessario disporre di una politica delle risorse che AWS IoT SiteWise consenta di inserire gli eventi di registro negli stream. CloudWatch Per creare e aggiornare una politica delle risorse per CloudWatch Logs, esegui il comando seguente. Sostituisci logging-policy-name con il nome della politica da creare.

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 supporta anche le chiavi di contesto aws: SourceArn e aws: SourceAccount condition. Queste chiavi di contesto delle condizioni sono opzionali.

Per creare o aggiornare una politica delle risorse che AWS IoT SiteWise consenta di inserire solo i log associati alla AWS IoT SiteWise risorsa specificata negli CloudWatch stream, esegui il comando ed esegui quanto segue:

  • Sostituisci logging-policy-name con il nome della politica da creare.

  • Sostituisci source-ARN con l'ARN della tua AWS IoT SiteWise risorsa, ad esempio un modello o un asset di asset. Per trovare l'ARN per ogni tipo di AWS IoT SiteWise risorsa, vedere Tipi di risorse definiti da AWS IoT SiteWise nel Service Authorization Reference.

  • Sostituisci account-ID con l'ID AWS dell'account associato alla AWS IoT SiteWise risorsa specificata.

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

Per impostazione predefinita, AWS IoT SiteWise non registra le informazioni CloudWatch nei registri. Per attivare la registrazione, scegliete un livello di registrazione diverso da Disabilitato (). OFF AWS IoT SiteWise supporta i seguenti livelli di registrazione:

  • OFF— La registrazione è disattivata.

  • ERROR— Gli errori vengono registrati.

  • INFO— Gli errori e i messaggi informativi vengono registrati.

È possibile configurare i gateway SiteWise Edge per registrare le informazioni su Logs through. CloudWatch AWS IoT Greengrass Per ulteriori informazioni, consulta Monitora i log del gateway SiteWise Edge.

È inoltre possibile configurare AWS IoT Core la registrazione delle informazioni nei CloudWatch registri se si sta risolvendo un'azione relativa a una AWS IoT SiteWise regola. Per ulteriori informazioni, consulta Risolvere i problemi relativi a un' AWS IoT SiteWise azione delle regole.

Gestisci l'accesso AWS IoT SiteWise

Utilizza la AWS IoT SiteWise console o AWS CLI per le seguenti attività di configurazione della registrazione.

Trova il tuo livello di registrazione

Console

Utilizza la procedura seguente per trovare il livello di registrazione corrente nella console AWS IoT SiteWise .

Per trovare il tuo attuale livello di AWS IoT SiteWise registrazione

  1. Passare alla console AWS IoT SiteWise.

  2. Nel riquadro di navigazione a sinistra, scegliere Logging options (Opzioni di registrazione).

    Lo stato di registrazione corrente viene visualizzato in Logging status (Stato di registrazione). Se la registrazione è attivata, il livello di registrazione corrente viene visualizzato in Livello di dettaglio.

AWS CLI

Esegui il comando seguente per trovare il tuo attuale livello di AWS IoT SiteWise registrazione con. AWS CLI

aws iotsitewise describe-logging-options

L'operazione restituisce una risposta contenente il livello di registrazione nel formato seguente.

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

Cambia il tuo livello di registrazione

Utilizzare la procedura seguente per modificare il livello di registrazione nella AWS IoT SiteWise console o in uso. AWS CLI

Console
Per modificare il livello di AWS IoT SiteWise registrazione

  1. Passare alla console AWS IoT SiteWise.

  2. Nel riquadro di navigazione a sinistra, scegliere Logging options (Opzioni di registrazione).

  3. Scegli Modifica.

  4. Scegli il livello di verbosità da attivare.

  5. Seleziona Salva.

AWS CLI

Esegui il AWS CLI comando seguente per modificare il livello di AWS IoT SiteWise registrazione. Sostituisci logging-level con il livello di registrazione desiderato.

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

Esempio: voci dei file di AWS IoT SiteWise registro

Ogni voce di AWS IoT SiteWise registro include informazioni sull'evento e risorse pertinenti per quell'evento, in modo da poter comprendere e analizzare i dati di registro.

L'esempio seguente mostra una voce CloudWatch Logs che AWS IoT SiteWise registra quando si crea correttamente un modello di asset.

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