Konfiguration AWS IoT Protokollierung

1. Wählen Sie unter Vertrauenswürdige Entität auswählen die Option AWS -Service aus. Wählen Sie dann die Option IoT unter Anwendungsfall aus. Wenn IoT nicht angezeigt wird, geben Sie IoT im Drop-down-Menü Anwendungsfälle für andere AWS -Services ein und suchen Sie danach. Klicken Sie auf Weiter.

2. Auf der Seite Berechtigungen hinzufügen sehen Sie die Richtlinien, die automatisch mit der Servicerolle verknüpft werden. Wählen Sie Weiter aus.

3. Geben Sie auf der Seite Name, Überprüfen und Erstellen einen Rollennamen und eine Rollenbeschreibung für die Rolle ein und wählen Sie dann Rolle erstellen.

Um zu konfigurieren AWS IoT Protokollierung:

1. Loggen Sie sich in die AWS IoT Konsole ein. Weitere Informationen finden Sie unter Öffnen Sie AWS IoT Konsole.

2. Wählen Sie im linken Navigationsbereich Logs aus (zuvor ein Abschnitt unter Einstellungen).

3. Konfiguriere die Protokollierung auf Kontoebene: Die Protokollierung auf Kontoebene gilt für deine gesamte AWS IoT Flotte (Geräte oder Endpunkte), sofern sie nicht durch ereignisspezifische oder ressourcenspezifische Einstellungen außer Kraft gesetzt wird.

   1. Wählen Sie unter Protokollierung Account-level die Option Protokollierung auf Kontoebene verwalten aus, um Aktualisierungen vorzunehmen.

   2. Markieren Sie das Kontrollkästchen „Protokollierung aktivieren“, um mit dem Senden von Protokollen an diese Adresse zu beginnen. CloudWatch Wenn „Protokollierung aktivieren“ nicht markiert ist, AWS IoT werden unabhängig von den Protokollierungskonfigurationen auf Ereignis- oder Ressourcenebene keine Protokolle an CloudWatch Protokollgruppen gesendet.

   3. Wählen Sie unter IAM-Protokollrolle eine vorhandene Rolle aus der Dropdownliste aus. Sie können Rollendetails anzeigen, um die Rollenberechtigungen zu überprüfen. Wählen Sie alternativ Neue Rolle erstellen aus, um eine neue IAM-Rolle einzurichten. Die Logging-Rolle bietet Richtlinien, die es AWS IoT ermöglichen, Logeinträge in Ihrem Namen CloudWatch an Dritte zu senden. Wenn Sie die Protokollierung auf Veranstaltungsebene mit einer benutzerdefinierten CloudWatch Protokollgruppe konfigurieren, müssen Sie die Rollenrichtlinie so aktualisieren, dass sie den ARN für diese Protokollgruppe enthält.

   4. Wählen Sie die Standard-Protokollebene, die der https://docs.aws.amazon.com/iot/latest/developerguide/configure-logging.html#log-level Detailebene der Protokolleinträge entspricht, die in den CloudWatch Protokollen angezeigt werden sollen. Hinweis: Die Protokollebene „DEBUG“ bietet die meisten Details, erhöht jedoch die CloudWatch Kosten. CloudWatch Ziele für Protokollgruppen können nicht auf Kontoebene konfiguriert werden. Sie können jedoch benutzerdefinierte Protokollgruppen für einzelne Ereignistypen angeben, wie im folgenden Abschnitt beschrieben.

   5. Wählen Sie Protokollierung aktualisieren, um Ihre Änderungen zu speichern.

4. Event-level Mit der Protokollierung können Sie selektiv Protokolle für relevante Ereignisse erfassen und sie an spezielle CloudWatch Protokollgruppen weiterleiten. Auf diese Weise haben Sie die Flexibilität, Protokolle zur besseren Auffindbarkeit nach Anwendungsfällen zu organisieren, sie für verschiedene Zielgruppen freizugeben und die CloudWatch Kosten zu senken, indem Sie Protokolle aktivieren und Protokollebenen auf der Grundlage der Ereigniskritik einrichten.

   Konfigurieren Sie die Protokollierung auf Ereignisebene: Die Protokollierung auf Ereignisebene erfasst bestimmte AWS IoT Ereignisse, wie z. B. Client-Authentifizierungsversuche. Diese Einstellungen überschreiben die Protokollierung. Account-Level

   1. Wählen Sie im Abschnitt Event-level Protokollierung die Option Protokollierung auf Veranstaltungsebene verwalten aus, um Aktualisierungen vorzunehmen.

   2. Standardmäßig übernehmen Ereignistypen die Protokollierungskonfiguration auf Kontoebene. Hinweis: Wenn die ressourcenspezifische Protokollierung konfiguriert ist, überschreibt sie die Einstellungen auf Konto- und Veranstaltungsebene.

   3. Um die Einstellungen für einzelne Ereignisse zu ändern, klicken Sie auf den Wert in der entsprechenden Ereigniszeile. Sie können sowohl die Protokollebene als auch das Ziel der CloudWatch Protokollgruppe anpassen. Wenn Sie ein benutzerdefiniertes CloudWatch Protokollgruppenziel angeben, müssen Sie sicherstellen, dass die IAM-Rollenrichtlinie Berechtigungen für die neue Protokollgruppe enthält. Wenn die Rollenrichtlinie nicht aktualisiert wird, können keine AWS IoT Protokolle in die benutzerdefinierte Protokollgruppe geschrieben werden. Nachdem Sie Ihre Auswahl getroffen haben, klicken Sie auf das Häkchen, um Ihre Auswahl zu bestätigen. In der Spalte „Ist geändert“ wird „Ja“ angezeigt, um auf ausstehende Änderungen hinzuweisen.

   4. Klicken Sie auf Protokollierung aktualisieren, um Ihre Änderungen zu übernehmen, oder wählen Sie Abbrechen, um sie zu verwerfen.

5. Resource-specific Überschreibungen konfigurieren: Bei Resource-specific Überschreibungen wird eine Protokollierungseinstellung auf ausgewählte Ressourcen angewendet. Bei einer Ressource kann es sich um eine Dinggruppe, Quell-IP, Client-ID oder Prinzipal-ID handeln. Resource-specific Die Protokollierungskonfiguration überschreibt sowohl Einstellungen auf Konto- als auch auf Veranstaltungsebene. Wenn diese Option aktiviert ist, generiert sie Protokolle für alle Ereignistypen auf der konfigurierten Protokollierungsebene für die angegebenen Ressourcen. Sie können beispielsweise die Protokollierung auf Debug-Ebene für ein bestimmtes Ding einrichten und gleichzeitig die Protokollierung auf Infoebene für alle anderen Dinge beibehalten.

   1. Wählen Sie im Abschnitt Überschreibungen die Option Ressourcenspezifische Überschreibungen hinzufügen aus. Resource-specific

   2. Wählen Sie ein Protokollziel: Dinggruppe, Quell-IP, Client-ID oder Prinzipal-ID.

   3. Geben Sie den entsprechenden Log-Zielwert für den ausgewählten Zieltyp ein.

   4. Wählen Sie das gewünschte Log-Level aus dem Drop-down-Menü im Abschnitt Resource-specific Log Level aus.

   5. Klicken Sie auf Senden, um die Überschreibung hinzuzufügen, oder auf Abbrechen, um die Änderungen zu verwerfen.

   6. Um eine bestehende ressourcenspezifische Überschreibung zu ändern, markieren Sie das Kontrollkästchen neben der Ressource und klicken Sie auf „Entfernen“, um die Überschreibung zu löschen, oder auf „Bearbeiten“, um sie zu ändern.

Um die CLI zum Konfigurieren der Standardprotokollierung für zu verwenden AWS IoT

1. Verwenden Sie den Befehl set-v2-logging-options, um die Protokollierungsoptionen für Ihr Konto festzulegen.

   aws iot set-v2-logging-options \
       --event-configurations event-configuration-list \
       --role-arn logging-role-arn \
       --default-log-level log-level

   Wobei:

   --role-arn

   Der Rollen-ARN, der die AWS IoT Schreibberechtigung für Ihre Logs in CloudWatch Logs gewährt. Role-arn Für die Ersteinrichtung ist eine Konfiguration erforderlich.

   --default-log-level

   Die zu verwendende Protokollstufe. Gültige Werte sind: ERRORWARN,INFO,DEBUG, oderDISABLED. Default-log-level Für die Ersteinrichtung ist eine Konfiguration erforderlich.

   --no-disable-all-logs

   Ein optionaler Parameter, der die gesamte AWS IoT Protokollierung ermöglicht. Verwenden Sie diesen Parameter zum Aktivieren der Protokollierung, wenn sie derzeit deaktiviert ist.

   --disable-all-logs

   Ein optionaler Parameter, der die gesamte AWS IoT Protokollierung deaktiviert. Verwenden Sie diesen Parameter zum Deaktivieren der Protokollierung, wenn sie derzeit aktiviert ist.

   --event-configurations

   Dieser Parameter ist optional und ermöglicht es Ihnen, die Protokollierungseinstellungen für einzelne Ereignistypen anzupassen:

   • EventType: Der Ereignistyp, der die Einstellung auf Kontoebene überschreibt

   • LogLevel: Überschreiben Sie die Einstellung auf Kontoebene mit DEBUG, INFO, ERROR, WARN oder DISABLED

   • LogDestination: Geben Sie eine benutzerdefinierte CloudWatch Protokollgruppe für die Protokollzustellung an

   Sie können die Protokollierungsstufe und das Protokollziel für jeden Ereignistyp unabhängig voneinander konfigurieren. Wenn nicht angegeben, übernehmen Ereignisse die Einstellungen auf Kontoebene

   aws iot set-v2-logging-options \
       --event-configurations "[{\"eventType\":\"Publish-In\",\"logLevel\":\"INFO\",\"logDestination\":\"examplePublishInLogGroup\"}]"

2. Verwenden Sie den Befehl get-v2-logging-options, um Ihre aktuellen Protokollierungsoptionen abzurufen.

   aws iot get-v2-logging-options \
       --verbose

   Wobei:

   --verbose

   Ein optionaler Parameter, mit dem Sie alle EventTypes und ihre Konfigurationen abrufen können.

Um die CLI zum Konfigurieren von Resource-specific Überschreibungen für zu verwenden AWS IoT

1. Aktivieren Sie die Protokollierung auf Kontoebene, bevor Sie die ressourcenspezifische Protokollierung mit dem folgenden Befehl konfigurieren: Befehl aws iot set-v2-logging-options

2. Verwenden set-v2-logging-level Sie den Befehl Resource-specific, um Overrides zu konfigurieren. Sehen Sie sich das folgende Beispiel für die Konfiguration von Dinggruppen an:

   aws iot set-v2-logging-level \
                 --log-target targetType=THING_GROUP,targetName=thing_group_name \
                 --log-level log_level

   --log-target

   Typ und Name der Ressource, für die Sie die Protokollierung konfigurieren. Der Wert targetType muss einer der folgenden sein: THING_GROUP | CLIENT_ID | SOURCE_IP | PRINCIPAL_ID. Der Wert des Parameters log-target kann Text (wie im Befehlsbeispiel oben) oder eine JSON-Zeichenfolge wie im folgenden Beispiel sein.

   aws iot set-v2-logging-level \
                 --log-target '{"targetType": "THING_GROUP","targetName": "thing_group_name"}' \
                 --log-level log_level

   --log-level

   Die Protokollierungsebene, die beim Generieren von Protokollen für die angegebene Ressource verwendet wird. Gültige Werte: DEBUG, INFO, ERROR, WARN und DISABLED.

3. Verwenden Sie den Befehl list-v2-logging-levels, um die aktuell konfigurierten Protokollierungsstufen aufzulisten.

   aws iot list-v2-logging-levels

4. Verwenden Sie den Befehl delete-v2-logging-level, um eine ressourcenspezifische Protokollierungsstufe zu löschen, ähnlich dem folgenden Beispiel.

   aws iot delete-v2-logging-level \
                 --target-type "THING_GROUP" \
                 --target-name "thing_group_name"

   aws iot delete-v2-logging-level \
                 --target-type=CLIENT_ID 
                 --target-name=ClientId1

   --target-type

   Der Wert target-type muss einer der folgenden sein: THING_GROUP | CLIENT_ID | SOURCE_IP | PRINCIPAL_ID.

   --target-name

   Der Name der Objektgruppe, für welche die Protokollierungsstufe entfernt werden soll.