AWS IoT Greengrass Version 1 è entrato nella fase di estensione della vita utile il 30 giugno 2023. Per ulteriori informazioni, consulta la politica AWS IoT Greengrass V1 di manutenzione. Dopo questa data, AWS IoT Greengrass V1 non rilascerà aggiornamenti che forniscano funzionalità, miglioramenti, correzioni di bug o patch di sicurezza. I dispositivi che funzionano AWS IoT Greengrass V1 non subiranno interruzioni e continueranno a funzionare e a connettersi al cloud. Ti consigliamo vivamente di eseguire la migrazione a AWS IoT Greengrass Version 2, che aggiunge nuove importanti funzionalità e supporto per piattaforme aggiuntive.

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 i log AWS IoT Greengrass

AWS IoT Greengrass è costituito dal servizio cloud e dal software AWS IoT Greengrass Core. Il software AWS IoT Greengrass Core può scrivere log su Amazon CloudWatch e sul file system locale del dispositivo principale. Le funzioni e i connettori Lambda in esecuzione sul core possono anche scrivere log su CloudWatch Logs e sul file system locale. Puoi utilizzare i log di eventi per monitorare e risolvere i problemi. Tutte le voci di log di AWS IoT Greengrass includono un timestamp, un livello di log e le informazioni sull'evento. Le modifiche alle impostazioni di registrazione diventano effettive dopo la distribuzione del gruppo.

La registrazione è configurata a livello del gruppo. Per i passaggi che mostrano come configurare la registrazione per un gruppo Greengrass, consulta Configurazione della registrazione per AWS IoT Greengrass.

Accesso ai log CloudWatch

Se configuri CloudWatch la registrazione, puoi visualizzare i log nella pagina Logs della console Amazon. CloudWatch I gruppi di log per i log di AWS IoT Greengrass utilizzano le seguenti convenzioni di denominazione:

/aws/greengrass/GreengrassSystem/greengrass-system-component-name
/aws/greengrass/Lambda/aws-region/account-id/lambda-function-name

Ogni gruppo di log contiene flussi di log che utilizzano la seguente convenzione di denominazione:

date/account-id/greengrass-group-id/name-of-core-that-generated-log

Le seguenti considerazioni si applicano quando utilizzi Logs: CloudWatch

Accesso ai log del file system

Se configuri la registrazione del file system, i file di log vengono archiviati in greengrass-root/ggc/var/log sul dispositivo core. Di seguito è riportata la struttura di directory generale:

greengrass-root/ggc/var/log
    - crash.log
    - system
        - log files for each Greengrass system component
    - user
        - region
            - account-id
                - log files generated by each user-defined Lambda function
            - aws
                - log files generated by each connector

Le seguenti considerazioni si applicano quando si utilizzano i log del file system:

Configurazione della registrazione predefinita

Se le impostazioni di registrazione non vengono configurate in modo esplicito, dopo la prima distribuzione di gruppo AWS IoT Greengrass utilizza la seguente configurazione di registrazione predefinita:

Configurazione della registrazione per AWS IoT Greengrass

È possibile utilizzare la AWS IoT console o le AWS IoT GreengrassAPI per configurare la registrazione. AWS IoT Greengrass

Configurazione della registrazione (console)

Puoi configurare la registrazione nella pagina Impostazioni del gruppo.

Configurazione della registrazione (API)

Puoi utilizzare le API di logger AWS IoT Greengrass per configurare la registrazione in modo programmatico. Ad esempio, puoi utilizzare l'operazione CreateLoggerDefinition per creare una definizione di logger basata su un payload LoggerDefinitionVersion, che utilizza la sintassi seguente:

{
  "Loggers": [
    {
      "Id": "string",
      "Type": "FileSystem|AWSCloudWatch",
      "Component": "GreengrassSystem|Lambda",
      "Level": "DEBUG|INFO|WARN|ERROR|FATAL",
      "Space": "integer"
    },
    {
      "Id": "string",
      ...
    }
  ]
}

LoggerDefinitionVersion è una serie di uno o più oggetti Logger che hanno le seguenti proprietà:

Esempio di configurazione

L'esempio LoggerDefinitionVersion seguente specifica una configurazione di registrazione che effettua le seguenti operazioni:

{
  "Name": "LoggingExample",
  "InitialVersion": {
    "Loggers": [
      {
        "Id": "1",
        "Component": "GreengrassSystem",
        "Level": "ERROR",
        "Space": 10240,
        "Type": "FileSystem"
      },
      {
        "Id": "2",
        "Component": "Lambda",
        "Level": "INFO",
        "Space": 10240,
        "Type": "FileSystem"
      },
      {
        "Id": "3",
        "Component": "Lambda",
        "Level": "INFO",
        "Type": "AWSCloudWatch"
      }
    ]
  }
}

Dopo aver creato una versione della definizione di logger, puoi utilizzare l'ARN della versione per creare una versione di gruppo prima di distribuire il gruppo.

Limitazioni di registrazione

AWS IoT Greengrass presenta le seguenti limitazioni di registrazione.

Transazioni al secondo

Quando la registrazione CloudWatch è abilitata, il componente di registrazione registra in batch gli eventi localmente prima di inviarli a CloudWatch, in modo che tu possa effettuare il log a una velocità superiore a cinque richieste al secondo per flusso di log.

Memoria

Se AWS IoT Greengrass è configurato per inviare log a CloudWatch e una funzione Lambda registra più di 5 MB/secondo per un periodo di tempo prolungato, la pipeline di elaborazione interna alla fine si riempie. Il caso peggiore teorico è di 6 MB per funzione Lambda.

Differenza dell'ora

Quando la registrazione a CloudWatch è abilitata, il componente di registrazione firma le richieste CloudWatch utilizzando il normale processo di firma Signature versione 4. Se l'ora di sistema sul dispositivo AWS IoT Greengrass principale non è sincronizzata per più di 15 minuti, le richieste vengono rifiutate.

Utilizzo del disco

Utilizza la seguente formula per calcolare il volume totale massimo di utilizzo del disco per la registrazione.

greengrass-system-component-space * 8    // 7 if automatic IP detection is disabled
  + 128KB                                // the internal log for the local logging component
  + lambda-space * lambda-count          // different versions of a Lambda function are treated as one

Dove:

Perdita di log

Se il dispositivo AWS IoT Greengrass principale è configurato per accedere solo a CloudWatch e non è disponibile alcuna connettività Internet, non è possibile recuperare i log attualmente presenti in memoria.

Quando le funzioni Lambda vengono terminate (ad esempio durante la distribuzione), non vengono scritti registri di alcuni secondi. CloudWatch

CloudTrail registri

AWS IoT Greengrassviene eseguito conAWS CloudTrail, un servizio che fornisce un registro delle azioni intraprese da un utente, un ruolo o un AWS servizio inAWS IoT Greengrass. Per ulteriori informazioni, consulta Registrazione delle chiamate API AWS IoT Greengrass con AWS CloudTrail.