CloudWatch Logs aktivieren

Das Hub-SDK bietet umfassende Protokollierungsfunktionen. Standardmäßig schreibt das Hub-SDK Protokolle in das lokale Dateisystem. Sie können jedoch die Cloud-API nutzen, um das Log-Streaming in CloudWatch Logs zu konfigurieren, was Folgendes bietet:

• Geräteleistung überwachen: Erfassen Sie detaillierte Laufzeitprotokolle für eine proaktive Geräteverwaltung. Ermöglichen Sie erweiterte Protokollanalysen und -überwachungen für Ihre gesamte Geräteflotte

• Probleme beheben: Generieren Sie detaillierte Protokolleinträge für eine schnelle Diagnoseanalyse. Zeichnen Sie Ereignisse auf System- und Anwendungsebene auf, um sie eingehend zu untersuchen.

• Flexible und zentralisierte Protokollierung: Protokollverwaltung aus der Ferne ohne direkten Gerätezugriff. Aggregieren Sie Protokolle von mehreren Geräten in einem einzigen, durchsuchbaren Repository.

Voraussetzungen

• Integrieren Sie das verwaltete Gerät in die Cloud. Details dazu finden Sie unter Einrichtung des Hub-Onboardings.

• Überprüfen Sie den Start und die erfolgreiche Initialisierung des Hub-Agenten. Details dazu finden Sie unter Installieren und validieren Sie das Hub-SDK für verwaltete Integrationen.

Anmerkung

Einzelheiten zum Erstellen von Protokollierungskonfigurationen finden Sie unter PutRuntimeLogConfiguration API.

Warnung

Die Aktivierung von Protokollen wird auf die gestaffelte Kontingentmessung angerechnet. Eine Erhöhung der Protokollebenen führt zu einem höheren Nachrichtenvolumen und zusätzlichen Kosten.

Richten Sie die Hub SDK-Protokollkonfigurationen ein

Konfigurieren Sie die Hub-SDK-Protokolleinstellungen, indem Sie die API aufrufen, um die Laufzeitprotokollkonfiguration einzurichten.

Beispiel für eine API-Anfrage

aws iot-managed-integrations put-runtime-log-configuration \
    --managed-thing-id MANAGED_THING_ID \
    --runtime-log-configurations LogLevel=DEBUG,UploadLog=TRUE               

RuntimeLogConfigurations Attribute

Die folgenden Attribute sind optional und können in der RuntimeLogConfigurations API konfiguriert werden.

LogLevel

Legt den Mindestschweregrad für Runtime-Traces fest. Werte: DEBUG, ERROR, INFO, WARN

Standard: WARN (veröffentlichter Build)

LogFlushLevel

Legt den Schweregrad für die sofortige Übertragung von Daten in den lokalen Speicher fest. Werte: DEBUG, ERROR, INFO, WARN

Standard: DISABLED

LocalStoreLocation

Gibt den Speicherort für Runtime-Traces an. Standard: /var/log/awsiotmi

• Aktives Protokoll: /var/log/awsiotmi/ManagedIntegrationsDeviceSdkHub.log

• Rotierte Protokolle: /var/log/awsiotmi/ManagedIntegrationsDeviceSdkHub.N.log (N gibt die Reihenfolge der Rotation an)

LocalStoreFileRotationMaxBytes

Löst die Dateirotation aus, wenn die aktuelle Datei die angegebene Größe überschreitet.

Wichtig

Um eine optimale Effizienz zu erzielen, sollten Sie die Dateigröße unter 125 KB halten. Werte über 125 KB werden automatisch begrenzt.

LocalStoreFileRotationMaxFiles,

Legt die maximale Anzahl von Rotationsdateien fest, die vom Log-Daemon zulässig sind.

UploadLog

Steuert die Runtime-Trace-Übertragung in die Cloud. Protokolle werden in der Gruppe /aws/iotmanagedintegration CloudWatch Protokolle gespeichert.

Standard: false.

UploadPeriodMinutes

Definiert die Häufigkeit von Runtime-Trace-Uploads. Standard: 5

DeleteLocalStoreAfterUpload

Steuert das Löschen von Dateien nach dem Upload. Standard: true

Anmerkung

Wenn der Wert auf false gesetzt ist, werden hochgeladene Dateien umbenannt in: /var/log/awsiotmi/ManagedIntegrationsDeviceSdkHub.uploaded.{uploaded_timestamp}

Beispiel für eine Protokolldatei

Unten finden Sie ein Beispiel für eine CloudWatch Log-Datei: