Überwachung des AWS IoT FleetWise mit Amazon CloudWatch Logs

Amazon CloudWatch Logs überwacht die Ereignisse, die in Ihren Ressourcen auftreten, und benachrichtigt Sie, wenn Probleme auftreten. Wenn Sie eine Warnung erhalten, können Sie auf die Protokolldateien zugreifen, um Informationen über das jeweilige Ereignis zu erhalten. Weitere Informationen finden Sie im Amazon CloudWatch Logs-Benutzerhandbuch.

AWS FleetWise IoT-Protokolle in der CloudWatch Konsole anzeigen

Wichtig

Bevor Sie die AWS FleetWise IoT-Protokollgruppe in der CloudWatch Konsole sehen können, stellen Sie sicher, dass Folgendes zutrifft:

• Sie haben die Protokollierung im AWS IoT aktiviert FleetWise. Weitere Informationen zur Protokollierung finden Sie unter AWS FleetWise IoT-Protokollierung konfigurieren.

• Es gibt bereits Protokolleinträge, die von AWS IoT Vorgängen geschrieben wurden.

So zeigen Sie Ihre AWS FleetWise IoT-Logs in der CloudWatch Konsole an

1. Öffnen Sie die CloudWatch -Konsole.

2. Wählen Sie im Navigationsbereich Logs, Log-Gruppen aus.

3. Wählen Sie die Protokollgruppe aus.

4. Wählen Sie Protokollgruppe suchen aus. Sie sehen eine vollständige Liste der Protokollereignisse, die für Ihr Konto generiert wurden.

5. Wählen Sie das Erweiterungssymbol, um sich einen einzelnen Stream anzusehen und alle Logs mit einem Log-Level von zu findenERROR.

   Sie können auch eine Abfrage in das Suchfeld Ereignisse filtern eingeben. Sie können beispielsweise die folgende Abfrage ausprobieren:

   { $.logLevel = "ERROR" }

Weitere Informationen zum Erstellen von Filterausdrücken finden Sie unter Filter- und Mustersyntax im Amazon CloudWatch Logs-Benutzerhandbuch.

Beispiel Protokolleintrag

{
  "accountId": "123456789012",
  "vehicleName": "test-vehicle",
  "message": "Unrecognized signal ID",
  "eventType": "MODELING_ERROR",
  "logLevel": "ERROR",
  "timestamp": 1685743214239,
  "campaignName": "test-campaign",
  "signalCatalogName": "test-catalog",
  "signalId": 10242
}

Arten von Signalereignissen
Ereignistyp	Beschreibung
MODELING_ERROR	Eine vom Fahrzeug gesendete und vom AWS IoT empfangene Nachricht FleetWise enthält Signale, die nicht mit dem Fahrzeugmodell verglichen werden können. Attribute: VehicleName, CampainName, SignalID signalCatalogName, SignalValue, Min, Max, signalValueRange signalValueRange modelManifestName
ILLEGAL_MESSAGE_FROM_EDGE	Eine vom Fahrzeug gesendete und vom AWS IoT empfangene Nachricht entsprach FleetWise nicht dem erforderlichen Format. Attribute: VehicleName, CampaignName, signalCatalogName
DECODIERUNGSFEHLER	Eine vom Fahrzeug gesendete und vom AWS IoT empfangene Nachricht FleetWise enthält Signale, die nicht anhand des Decoder-Manifests des Fahrzeugs dekodiert werden können. Attribute: CampaignName,, (optional) SignalName signalCatalogName decoderManifestName, (optional) S3URI

Ereignistypen der Kampagne
Ereignistyp	Beschreibung
FAHRZEUG NICHT GEFUNDEN	Eine Nachricht, die vom Fahrzeug gesendet und vom AWS IoT empfangen wurde FleetWise, wobei das Fahrzeug unbekannt war. Attribute: VehicleName, CampaignName
CAMPAIGN_NOT_FOUND	Eine Nachricht, die vom Fahrzeug gesendet und von AWS IoT empfangen wurde FleetWise, wobei die Kampagne unbekannt war. Attribute: VehicleName (optional), CampaignName
CAMPAIGN_INVALID	Eine vom Fahrzeug gesendete und vom AWS IoT empfangene Nachricht FleetWise, bei der die Kampagne nicht gültig war. Attribute: VehicleName (optional), CampaignName

Kampagnendaten, Zielereignistypen
Ereignistyp	Beschreibung
TIMESTREAM_WRITE_ERROR	AWSIoT FleetWise konnte keine Nachricht vom Fahrzeug in die Amazon Timestream-Tabelle schreiben. Attribute: Fahrzeugname, Kampagnenname, timestreamDatabaseName timestreamTableName
S3_WRITE_ERROR	AWSIoT FleetWise konnte keine Nachricht vom Fahrzeug in den Amazon Simple Storage Service (Amazon S3) -Bucket schreiben. Attribute: CampaignName, DestinationName
S3_READ_ERROR	AWSIoT FleetWise konnte keinen Objektschlüssel aus dem Fahrzeug im Amazon Simple Storage Service (Amazon S3) -Bucket lesen. Attribute: CampaignName, DestinationName

Vom Kunden verwaltete wichtige Ereignistypen AWS KMS
Ereignistyp	Beschreibung
KMS_KEY_ACCESS_DENIED	AWSIoT FleetWise konnte aufgrund eines Fehlers „AWS KMSSchlüsselzugriff verweigert“ keine Nachricht vom Fahrzeug in die Timestream-Tabelle oder den Amazon S3 S3-Bucket schreiben.

Attribute

Alle CloudWatch Log-Einträge enthalten die folgenden Attribute:

accountId

Deine AWS-Konto ID.

eventType

Der Ereignistyp, für den das Protokoll generiert wurde. Der Wert des Ereignistyps hängt vom Ereignis ab, das den Protokolleintrag generiert hat. Jede Beschreibung des Protokolleintrags enthält den Wert von eventType für diesen Protokolleintrag.

logLevel

Die Protokollebene, die verwendet wird. Weitere Informationen finden Sie unter Protokollebenen im AWS IoT CoreEntwicklerhandbuch.

Nachricht

Enthält spezifische Details zum Protokoll.

Zeitstempel

Der Epochen-Millisekunden-Zeitstempel, zu dem das IoT das Protokoll verarbeitet hat. AWS FleetWise

Optionale Attribute

CloudWatch Protokolleinträge enthalten optional diese Attribute, abhängig von: eventType

decoderManifestName

Der Name des Decoder-Manifests, das das Signal enthält.

Name des Ziels

Der Name des Ziels für Fahrzeugdaten. Zum Beispiel der Amazon S3 S3-Bucket-Name.

Name der Kampagne

Der Name der Kampagne.

signalCatalogName

Der Name des Signalkatalogs, der das Signal enthält.

SignalID

Die ID des Fehlersignals.

Signal-IDs

Eine Liste von Fehlersignal-IDs.

Signalname

Der Name des Signals.

signalTimestampEpochFrau

Der Zeitstempel des Fehlersignals.

SignalWert

Der Wert des Fehlersignals.

signalValueRangeMax

Die maximale Reichweite des Fehlersignals.

signalValueRangeMin.

Der Mindestbereich des Fehlersignals.

S3URI

Die eindeutige Amazon S3 S3-ID einer Amazon Ion-Datei aus einer Fahrzeugnachricht.

timestreamDatabaseName

Der Name der Timestream-Datenbank.

timestreamTableName

Der Name der Timestream-Tabelle.

Name des Fahrzeugs

Der Name des Fahrzeugs.