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.

Mit Amazon CloudWatch Logs überwachen

Stellen Sie AWS IoT SiteWise die Konfiguration so ein, dass Informationen in CloudWatch Logs protokolliert werden, um den Dienst zu überwachen und Fehler zu beheben.

Wenn Sie die AWS IoT SiteWise Konsole verwenden, AWS IoT SiteWise wird eine dienstbezogene Rolle erstellt, die es dem Dienst ermöglicht, Informationen in Ihrem Namen zu protokollieren. Wenn Sie die AWS IoT SiteWise Konsole nicht verwenden, müssen Sie manuell eine dienstbezogene Rolle erstellen, um Protokolle zu empfangen. Weitere Informationen finden Sie unter Erstellen einer serviceverknüpften Rolle für AWS IoT SiteWise.

Sie benötigen eine Ressourcenrichtlinie, die es ermöglicht, Protokollereignisse in CloudWatch Streams AWS IoT SiteWise zu speichern. Führen Sie den folgenden Befehl aus, um eine Ressourcenrichtlinie für CloudWatch Logs zu erstellen und zu aktualisieren. Ersetzen logging-policy-name mit dem Namen der zu erstellenden Richtlinie.

aws logs put-resource-policy --policy-name logging-policy-name --policy-document "{ \"Version\": \"2012-10-17\", \"Statement\": [ { \"Sid\": \"IoTSiteWiseToCloudWatchLogs\", \"Effect\": \"Allow\", \"Principal\": { \"Service\": [ \"iotsitewise.amazonaws.com\" ] }, \"Action\":\"logs:PutLogEvents\", \"Resource\": \"*\" } ] }"

CloudWatch Logs unterstützt auch die Kontextschlüssel aws: SourceArn und aws: SourceAccount condition. Diese Bedingungskontextschlüssel sind optional.

Um eine Ressourcenrichtlinie zu erstellen oder AWS IoT SiteWise zu aktualisieren, die es erlaubt, nur Protokolle, die mit der angegebenen AWS IoT SiteWise Ressource verknüpft sind, in CloudWatch Streams zu speichern, führen Sie den Befehl aus und gehen Sie wie folgt vor:

aws logs put-resource-policy --policy-name logging-policy-name --policy-document "{ \"Version\": \"2012-10-17\", \"Statement\": [ { \"Sid\": \"IoTSiteWiseToCloudWatchLogs\", \"Effect\": \"Allow\", \"Principal\": { \"Service\": [ \"iotsitewise.amazonaws.com\" ] }, \"Action\":\"logs:PutLogEvents\", \"Resource\": \"*\", \"Condition\":{\"StringLike\":{\"aws:SourceArn\":[\"source-ARN\"],\"aws:SourceAccount\":[\"account-ID\"]}}}]}"

Standardmäßig werden AWS IoT SiteWise keine Informationen in CloudWatch Logs protokolliert. Um die Protokollierung zu aktivieren, wählen Sie eine andere Protokollierungsebene als Deaktiviert (OFF). AWS IoT SiteWise unterstützt die folgenden Protokollierungsebenen:

Sie können SiteWise Edge-Gateways so konfigurieren, dass sie Informationen in CloudWatch Logs protokollieren. AWS IoT Greengrass Weitere Informationen finden Sie unter SiteWise Edge-Gateway-Protokolle überwachen.

Sie können auch so konfigurieren AWS IoT Core , dass Informationen in CloudWatch Protokollen protokolliert werden, wenn Sie eine AWS IoT SiteWise Regelaktion beheben. Weitere Informationen finden Sie unter Problembehandlung bei einer AWS IoT SiteWise Regelaktion.

Die Anmeldung verwalten AWS IoT SiteWise

Verwenden Sie die AWS IoT SiteWise Konsole oder AWS CLI für die folgenden Aufgaben zur Konfiguration der Protokollierung.

Finden Sie Ihre Protokollierungsstufe

Console

Gehen Sie wie folgt vor, um die aktuelle Protokollierungsstufe in der AWS IoT SiteWise -Konsole zu finden.

Um Ihre aktuelle AWS IoT SiteWise Protokollierungsstufe zu ermitteln

1. Navigieren Sie zur AWS IoT SiteWise -Konsole.

2. Wählen Sie im linken Navigationsbereich Logging options (Protokollierungsoptionen) aus.

   Der aktuelle Protokollierungsstatus wird unter Logging status (Protokollierungsstatus) angezeigt. Wenn die Protokollierung aktiviert ist, wird die aktuelle Protokollierungsstufe unter Ausführlichkeitsstufe angezeigt.

AWS CLI

Führen Sie den folgenden Befehl aus, um Ihre aktuelle AWS IoT SiteWise Protokollierungsstufe mit dem zu ermitteln. AWS CLI

aws iotsitewise describe-logging-options

Die Operation gibt eine Antwort mit Ihrer Protokollierungsstufe im folgenden Format zurück.

{
  "loggingOptions": {
    "level": "String"
  }
}

Ändern Sie Ihre Protokollierungsebene

Gehen Sie wie folgt vor, um Ihre Protokollierungsstufe in der AWS IoT SiteWise Konsole oder mithilfe von zu ändern AWS CLI.

Console

Um Ihre AWS IoT SiteWise Protokollierungsstufe zu ändern

1. Navigieren Sie zur AWS IoT SiteWise -Konsole.

2. Wählen Sie im linken Navigationsbereich Logging options (Protokollierungsoptionen) aus.

3. Wählen Sie Edit (Bearbeiten) aus.

4. Wählen Sie den Grad der Ausführlichkeit, den Sie aktivieren möchten.

5. Wählen Sie Save (Speichern) aus.

AWS CLI

Führen Sie den folgenden AWS CLI Befehl aus, um Ihre AWS IoT SiteWise Protokollierungsstufe zu ändern. Ersetzen logging-level mit der gewünschten Protokollierungsebene.

aws iotsitewise put-logging-options --logging-options level=logging-level

Beispiel: Einträge in AWS IoT SiteWise Protokolldateien

Jeder AWS IoT SiteWise Protokolleintrag enthält Ereignisinformationen und relevante Ressourcen für dieses Ereignis, sodass Sie die Protokolldaten verstehen und analysieren können.

Das folgende Beispiel zeigt einen CloudWatch Logs-Eintrag, der AWS IoT SiteWise protokolliert, wann Sie ein Asset-Modell erfolgreich erstellt haben.

{
  "eventTime": "2020-05-05T00:10:22.902Z",
  "logLevel": "INFO",
  "eventType": "AssetModelCreationSuccess",
  "message": "Successfully created asset model.",
  "resources": {
    "assetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE"
  }
}