Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Richten Sie CloudWatch Protokolle für OTA Updates ein
Der OTA Update-Service unterstützt die Protokollierung bei Amazon CloudWatch. Sie können die AWS IoT Konsole verwenden, um die CloudWatch Amazon-Protokollierung für OTA Updates zu aktivieren und zu konfigurieren. Weitere Informationen finden Sie unter Cloudwatch Logs.
Um die Protokollierung zu aktivieren, müssen Sie eine IAM Rolle erstellen und die OTA Aktualisierungsprotokollierung konfigurieren.
Anmerkung
Bevor Sie die OTA Aktualisierungsprotokollierung aktivieren, sollten Sie sich mit den Zugriffsberechtigungen für CloudWatch Protokolle vertraut machen. Benutzer mit Zugriff auf CloudWatch Protokolle können Ihre Debugging-Informationen sehen. Weitere Informationen finden Sie unter Authentifizierung und Zugriffskontrolle für Amazon CloudWatch Logs.
Erstellen einer Protokollierungsrolle und Aktivieren der Protokollierung
Verwenden Sie die AWS IoT -Konsole
-
Wählen Sie im Navigationsbereich Settings (Einstellungen) aus.
-
Wählen Sie unter Logs (Protokolle) die Option Edit (Bearbeiten) aus.
-
Wählen Sie unter Level of verbosity (Umfang) die Option Debug (Debuggen) aus.
-
Wählen Sie unter Rolle festlegen die Option Neu erstellen aus, um eine IAM Rolle für die Protokollierung zu erstellen.
-
Geben Sie unter Name einen eindeutigen Namen für Ihre Rolle ein. Ihre Rolle wird mit allen erforderlichen Berechtigungen erstellt.
-
Wählen Sie Aktualisieren.
OTALogs aktualisieren
Der OTA Aktualisierungsdienst veröffentlicht Protokolle in Ihrem Konto, wenn einer der folgenden Fälle eintritt:
-
Ein OTA Update wird erstellt.
-
Ein OTA Update ist abgeschlossen.
-
Ein Code-Signing-Job wird erstellt.
-
Ein Code-Signing-Job ist abgeschlossen.
-
Ein AWS IoT Job wird erstellt.
-
Ein AWS IoT Job ist abgeschlossen.
-
Ein Stream wird erstellt.
Sie können Ihre Logs in der CloudWatch Konsole einsehen.
Um ein OTA Update in CloudWatch Logs einzusehen
-
Wählen Sie im Navigationsbereich Logs (Protokolle) aus.
-
Wählen Sie unter Protokollgruppen AWSIoTLogsV2.
OTAAktualisierungsprotokolle können die folgenden Eigenschaften enthalten:
- accountId
-
Die AWS Konto-ID, in der das Protokoll generiert wurde.
- actionType
-
Die Aktion, die das Protokoll erzeugt hat. Diese Eigenschaft kann einen der folgenden Werte haben:
-
CreateOTAUpdate
: Ein OTA Update wurde erstellt. -
DeleteOTAUpdate
: Ein OTA Update wurde gelöscht. -
StartCodeSigning
: Es wurde eine Codesignierungsaufgabe gestartet. -
CreateAWSJob
: Ein AWS IoT Job wurde erstellt. -
CreateStream
: Es wurde ein Stream erstellt. -
GetStream
: Eine Anfrage für einen Stream wurde an die AWS IoT MQTT basierte Dateizustellungsfunktion gesendet. -
DescribeStream
: Eine Anfrage nach Informationen zu einem Stream wurde an die AWS IoT MQTT basierte Dateizustellungsfunktion gesendet.
-
- awsJobId
-
Die AWS IoT Job-ID, die das Protokoll generiert hat.
- clientId
-
Die MQTT Client-ID, die die Anforderung gestellt hat, die das Protokoll generiert hat.
- clientToken
-
Das Client-Token, das der Anforderung im Protokolleintrag zugeordnet ist.
- Details
-
Zusätzliche Informationen über den Vorgang, der das Protokoll generiert hat.
- logLevel
-
Die Protokollierungsstufe des Protokolls. Bei OTA Aktualisierungsprotokollen ist diese Einstellung immer auf gesetzt
DEBUG
. - otaUpdateId
-
Die ID des OTA Updates, das das Protokoll generiert hat.
- Protokoll
-
Das Protokoll, mit dem die Anforderung gestellt wurde, die den Protokolleintrag generiert hat.
- Status
-
Der Status des Vorgangs, der den Protokolleintrag generiert hat. Gültige Werte für sind:
-
Herzlichen Glückwunsch
-
Fehler
-
- streamId
-
Die AWS IoT Stream-ID, die das Protokoll generiert hat.
- Zeitstempel
-
Der Zeitpunkt, zu dem der Protokolleintrag generiert wurde.
- topicName
-
Ein MQTT Thema, das verwendet wurde, um die Anfrage zu stellen, mit der das Protokoll generiert wurde.
Beispielprotokolle
Im Folgenden finden Sie ein Beispielprotokoll, das beim Starten eines Code-Signing-Jobs erzeugt wird:
{
"timestamp": "2018-07-23 22:59:44.955",
"logLevel": "DEBUG",
"accountId": "123456789012",
"status": "Success",
"actionType": "StartCodeSigning",
"otaUpdateId": "08957b03-eea3-448a-87fe-743e6891ca3a",
"details": "Start code signing job. The request status is SUCCESS."
}
Im Folgenden finden Sie ein Beispielprotokoll, das bei der Erstellung eines AWS IoT Jobs generiert wird:
{
"timestamp": "2018-07-23 22:59:45.363",
"logLevel": "DEBUG",
"accountId": "123456789012",
"status": "Success",
"actionType": "CreateAWSJob",
"otaUpdateId": "08957b03-eea3-448a-87fe-743e6891ca3a",
"awsJobId": "08957b03-eea3-448a-87fe-743e6891ca3a",
"details": "Create AWS Job The request status is SUCCESS."
}
Im Folgenden finden Sie ein Beispielprotokoll, das generiert wird, wenn ein OTA Update erstellt wird:
{
"timestamp": "2018-07-23 22:59:45.413",
"logLevel": "DEBUG",
"accountId": "123456789012",
"status": "Success",
"actionType": "CreateOTAUpdate",
"otaUpdateId": "08957b03-eea3-448a-87fe-743e6891ca3a",
"details": "OTAUpdate creation complete. The request status is SUCCESS."
}
Im Folgenden finden Sie ein Beispielprotokoll, das beim Erstellen eines Streams erzeugt wird:
{
"timestamp": "2018-07-23 23:00:26.391",
"logLevel": "DEBUG",
"accountId": "123456789012",
"status": "Success",
"actionType": "CreateStream",
"otaUpdateId": "3d3dc5f7-3d6d-47ac-9252-45821ac7cfb0",
"streamId": "6be2303d-3637-48f0-ace9-0b87b1b9a824",
"details": "Create stream. The request status is SUCCESS."
}
Im Folgenden finden Sie ein Beispielprotokoll, das generiert wird, wenn ein OTA Update gelöscht wird:
{
"timestamp": "2018-07-23 23:03:09.505",
"logLevel": "DEBUG",
"accountId": "123456789012",
"status": "Success",
"actionType": "DeleteOTAUpdate",
"otaUpdateId": "9bdd78fb-f113-4001-9675-1b595982292f",
"details": "Delete OTA Update. The request status is SUCCESS."
}
Im Folgenden finden Sie ein Beispielprotokoll, das generiert wird, wenn ein Gerät einen Stream von der MQTT basierten Dateizustellungsfunktion anfordert:
{
"timestamp": "2018-07-25 22:09:02.678",
"logLevel": "DEBUG",
"accountId": "123456789012",
"status": "Success",
"actionType": "GetStream",
"protocol": "MQTT",
"clientId": "b9d2e49c-94fe-4ed1-9b07-286afed7e4c8",
"topicName": "$aws/things/b9d2e49c-94fe-4ed1-9b07-286afed7e4c8/streams/1e51e9a8-9a4c-4c50-b005-d38452a956af/get/json",
"streamId": "1e51e9a8-9a4c-4c50-b005-d38452a956af",
"details": "The request status is SUCCESS."
}
Im Folgenden finden Sie ein Beispielprotokoll, das generiert wird, wenn ein Gerät Folgendes aufruft DescribeStream
API:
{
"timestamp": "2018-07-25 22:10:12.690",
"logLevel": "DEBUG",
"accountId": "123456789012",
"status": "Success",
"actionType": "DescribeStream",
"protocol": "MQTT",
"clientId": "581075e0-4639-48ee-8b94-2cf304168e43",
"topicName": "$aws/things/581075e0-4639-48ee-8b94-2cf304168e43/streams/71c101a8-bcc5-4929-9fe2-af563af0c139/describe/json",
"streamId": "71c101a8-bcc5-4929-9fe2-af563af0c139",
"clientToken": "clientToken",
"details": "The request status is SUCCESS."
}