Speichereinstellungen konfigurieren - AWS IoT SiteWise

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.

Speichereinstellungen konfigurieren

Sie können Speichereinstellungen so konfigurieren, dass Sie sich für die Wartung von verwaltetem Speicher auf der warmen Ebene entscheiden und Daten auch auf das kalte Tier replizieren. Weitere Informationen zur Aufbewahrungsdauer für die Warm- und Hot-Tarife finden Sie unterAuswirkungen auf die Datenspeicherung. Gehen Sie bei der Konfiguration der Speichereinstellungen wie folgt vor:

  • Aufbewahrung auf hoher Ebene — Legen Sie einen Aufbewahrungszeitraum fest, in dem Ihre Daten auf der heißen Ebene gespeichert werden, bevor sie gelöscht und je nach Ihren Speichereinstellungen in den vom Service verwalteten Speicher auf der warmen oder kalten Ebene verschoben werden. AWS IoT SiteWise löscht alle Daten in der Hot-Tier, die vor Ablauf der Aufbewahrungsfrist vorhanden waren. Wenn Sie keinen Aufbewahrungszeitraum festlegen, werden Ihre Daten auf unbestimmte Zeit im Hot-Tier gespeichert.

  • Aufbewahrung auf der warmen Ebene — Legen Sie einen Aufbewahrungszeitraum fest, in dem Ihre Daten auf der Warm-Tier-Ebene gespeichert werden, bevor sie aus dem AWS IoT SiteWise Speicher gelöscht und in den vom Kunden verwalteten Cold-Tier-Speicher verschoben werden. AWS IoT SiteWise löscht alle Daten aus der Warm-Tier, die vor Ablauf der Aufbewahrungsfrist vorhanden waren. Wenn kein Aufbewahrungszeitraum festgelegt ist, werden Ihre Daten auf unbestimmte Zeit in der Warm-Tier gespeichert.

Anmerkung

Um die Abfrageleistung zu verbessern, legen Sie mit Warm-Tier-Speicher einen Hot-Tier-Aufbewahrungszeitraum fest.

Auswirkungen der Datenspeicherung auf Speicher der heißen und warmen Speicherebene

  • Wenn Sie die Aufbewahrungsdauer des Hot-Tier-Speichers verkürzen, werden Daten dauerhaft vom Hot-Tier in das Warm- oder Cold-Tier verschoben. Wenn Sie die Aufbewahrungsdauer der warmen Schicht verkürzen, werden Daten in die kalte Schicht verschoben und dauerhaft aus der warmen Schicht gelöscht.

  • Wenn Sie die Aufbewahrungsdauer des Speichers der heißen oder warmen Ebene verlängern, wirkt sich die Änderung auf Daten aus, an die AWS IoT SiteWise ab diesem Zeitpunkt gesendet werden. AWS IoT SiteWise ruft keine Daten aus dem warmen oder kalten Speicher ab, um den heißen Speicher zu füllen. Wenn beispielsweise die Aufbewahrungsdauer des Hot-Tier-Speichers zunächst auf 30 Tage festgelegt und dann auf 60 Tage erhöht wird, dauert es 30 Tage, bis der Hot-Tier-Speicher Daten im Wert von 60 Tagen enthält.

Konfigurieren Sie die Speichereinstellungen für die Warm-Stufe (Konsole)

Das folgende Verfahren zeigt Ihnen, wie Sie die Speichereinstellungen für die Replikation von Daten auf das warme Tier in der AWS IoT SiteWise Konsole konfigurieren.

So konfigurieren Sie die Speichereinstellungen in der Konsole
  1. Navigieren Sie zur AWS IoT SiteWise -Konsole.

  2. Wählen Sie im Navigationsbereich unter Einstellungen die Option Speicher aus.

  3. Wählen Sie rechts oben die Option Edit (Bearbeiten) aus.

  4. Gehen Sie auf der Seite Speicher bearbeiten wie folgt vor:

  5. Gehen Sie für Hot-Tier-Einstellungen wie folgt vor:

    • Wenn Sie einen Aufbewahrungszeitraum für die Dauer festlegen möchten, für die Ihre Daten auf dem Hot-Tier gespeichert werden, bevor sie gelöscht und in den vom Service verwalteten Warm-Tier-Speicher verschoben werden, wählen Sie Aufbewahrungszeitraum aktivieren.

    • Um einen Aufbewahrungszeitraum zu konfigurieren, geben Sie eine ganze Zahl ein und wählen Sie eine Einheit aus. Die Aufbewahrungsfrist muss mindestens 30 Tage betragen.

    AWS IoT SiteWise löscht alle Daten im Hot-Tier, die älter als die Aufbewahrungsfrist sind. Wenn Sie keinen Aufbewahrungszeitraum festlegen, werden Ihre Daten auf unbestimmte Zeit gespeichert.

  6. (Empfohlen) Gehen Sie für die Warm-Tier-Einstellungen wie folgt vor:

    • Um sich für den Warm-Tier-Speicher zu entscheiden, wählen Sie Ich bestätige die Option Ich bestätige die Option Warm-Tier-Speicher, um sich für den Warm-Tier-Speicher zu entscheiden.

    • (Optional) Um einen Aufbewahrungszeitraum zu konfigurieren, geben Sie eine ganze Zahl ein und wählen Sie eine Einheit aus. Die Aufbewahrungsdauer muss mindestens 365 Tage betragen.

    AWS IoT SiteWise löscht Daten in der Warm-Tier, die vor dem Aufbewahrungszeitraum existierten. Wenn Sie keinen Aufbewahrungszeitraum festlegen, werden Ihre Daten auf unbestimmte Zeit gespeichert.

    Anmerkung
    • Wenn Sie sich für die Warm-Stufe entscheiden, wird die Konfiguration nur einmal angezeigt.

    • Um die Aufbewahrung auf der heißen Ebene festzulegen, müssen Sie entweder über einen warmen oder einen kalten Speicher verfügen. Aus Gründen der Kosteneffizienz und des Abrufs historischer Daten AWS IoT SiteWise empfiehlt es sich, Langzeitdaten im Warm-Tier zu speichern.

    • Um die Aufbewahrung auf der Warm-Tier-Ebene festzulegen, müssen Sie über einen Cold-Tier-Speicher verfügen.

  7. Wählen Sie Speichern, um Ihre Speichereinstellungen zu speichern.

Im AWS IoT SiteWise Speicherbereich befindet sich der Warm Tier-Speicher in einem der folgenden Zustände:

  • Aktiviert — Wenn Ihre Daten bereits vor dem Aufbewahrungszeitraum für das heiße Tier vorhanden waren, werden die Daten auf das Warm-Tier AWS IoT SiteWise verschoben.“

  • Deaktiviert — Der Warm-Tier-Speicher ist deaktiviert.

Konfigurieren Sie die Speichereinstellungen für die Warmstufe (AWS CLI)

Sie können Speichereinstellungen so konfigurieren, dass Daten auf die warme Ebene verschoben werden, indem Sie die AWS CLI und die folgenden Befehle verwenden.

Um zu verhindern, dass die bestehende Konfiguration überschrieben wird, rufen Sie die aktuellen Speicherkonfigurationsinformationen ab, indem Sie den folgenden Befehl ausführen:

aws iotsitewise describe-storage-configuration
Beispiel Antwort ohne bestehende Cold-Tier-Konfiguration
{ "storageType": "SITEWISE_DEFAULT_STORAGE", "disassociatedDataStorage": "ENABLED", "configurationStatus": { "state": "ACTIVE" }, "lastUpdateDate": "2021-10-14T15:53:35-07:00", "warmTier": "DISABLED" }
Beispiel Antwort mit vorhandener Cold-Tier-Konfiguration
{ "storageType": "MULTI_LAYER_STORAGE", "multiLayerStorage": { "customerManagedS3Storage": { "s3ResourceArn": "arn:aws:s3:::bucket-name/prefix/", "roleArn": "arn:aws:iam::aws-account-id:role/role-name" } }, "disassociatedDataStorage": "ENABLED", "retentionPeriod": { "numberOfDays": retention-in-days }, "configurationStatus": { "state": "ACTIVE" }, "lastUpdateDate": "2023-10-25T15:59:46-07:00", "warmTier": "DISABLED" }

Konfigurieren Sie die Speichereinstellungen für die warme Stufe mit AWS CLI

Führen Sie den folgenden Befehl aus, um die Speichereinstellungen zu konfigurieren. file-nameErsetzen Sie es durch den Namen der Datei, die die AWS IoT SiteWise Speicherkonfiguration enthält.

aws iotsitewise put-storage-configuration --cli-input-json file://file-name.json
Beispiel AWS IoT SiteWise Konfiguration mit heißer und warmer Stufe
{ "storageType": "SITEWISE_DEFAULT_STORAGE", "disassociatedDataStorage": "ENABLED", "warmTier": "ENABLED", "retentionPeriod": { "numberOfDays": hot-tier-retention-in-days } }

hot-tier-retention-in-daysmuss eine ganze Zahl größer oder gleich 30 Tagen sein.

Beispiel response
{ "storageType": "SITEWISE_DEFAULT_STORAGE", "configurationStatus": { "state": "UPDATE_IN_PROGRESS" } }

Wenn Sie Cold-Tier-Speicher aktiviert haben, finden Sie weitere Informationen unterKonfigurieren Sie Speichereinstellungen mit einem AWS CLI vorhandenen Cold-Tier.

Konfigurieren Sie Speichereinstellungen mit einem AWS CLI vorhandenen Cold-Tier

Konfigurieren Sie die Speichereinstellungen AWS CLI mithilfe des vorhandenen Cold-Tier-Speichers
  • Führen Sie den folgenden Befehl aus, um die Speichereinstellungen zu konfigurieren. Ersetzen file-name mit dem Namen der Datei, die die AWS IoT SiteWise Speicherkonfiguration enthält.

    aws iotsitewise put-storage-configuration --cli-input-json file://file-name.json
    Beispiel AWS IoT SiteWise Speicherkonfiguration
    • Ersetzen bucket-name mit Ihrem Amazon S3 S3-Bucket-Namen.

    • Ersetzen prefix mit Ihrem Amazon S3 S3-Präfix.

    • Ersetzen aws-account-id mit Ihrer AWS Konto-ID.

    • Ersetzen role-name mit dem Namen der Amazon S3-Zugriffsrolle, die das Senden von Daten AWS IoT SiteWise an Amazon S3 ermöglicht.

    • Ersetzen hot-tier-retention-in-days mit einer ganzen Zahl größer oder gleich 30 Tagen.

    • Ersetzen warm-tier-retention-in-days mit einer ganzen Zahl größer oder gleich 365 Tagen.

    Anmerkung

    AWS IoT SiteWise löscht alle Daten in der warmen Stufe, die älter sind als die Aufbewahrungsfrist der kalten Stufe. Wenn Sie keinen Aufbewahrungszeitraum festlegen, werden Ihre Daten auf unbestimmte Zeit gespeichert.

    { "storageType": "MULTI_LAYER_STORAGE", "multiLayerStorage": { "customerManagedS3Storage": { "s3ResourceArn": "arn:aws:s3:::bucket-name/prefix/", "roleArn": "arn:aws:iam::aws-account-id:role/role-name" } }, "disassociatedDataStorage": "ENABLED", "retentionPeriod": { "numberOfDays": hot-tier-retention-in-days }, "warmTier": "ENABLED", "warmTierRetentionPeriod": { "numberOfDays": warm-tier-retention-in-days } }
    Beispiel response
    { "storageType": "MULTI_LAYER_STORAGE", "configurationStatus": { "state": "UPDATE_IN_PROGRESS" } }

Konfigurieren Sie die Speichereinstellungen für das Cold-Tier (Konsole)

Das folgende Verfahren zeigt Ihnen, wie Sie die Speichereinstellungen so konfigurieren, dass Daten auf das Cold-Tier in der AWS IoT SiteWise Konsole repliziert werden.

So konfigurieren Sie die Speichereinstellungen in der Konsole
  1. Navigieren Sie zur AWS IoT SiteWise -Konsole.

  2. Wählen Sie im Navigationsbereich unter Einstellungen die Option Speicher aus.

  3. Wählen Sie rechts oben die Option Edit (Bearbeiten) aus.

  4. Gehen Sie auf der Seite Speicher bearbeiten wie folgt vor:

    1. Wählen Sie unter Speichereinstellungen die Option Cold-Tier-Speicher aktivieren aus. Der Cold-Tier-Speicher ist standardmäßig deaktiviert.

    2. Geben Sie für S3-Bucket-Standort den Namen eines vorhandenen Amazon S3 S3-Buckets und ein Präfix ein.

      Anmerkung
      • Amazon S3 verwendet das Präfix als Ordnernamen im Amazon S3 S3-Bucket. Das Präfix muss 1—255 Zeichen lang sein und mit einem Schrägstrich (/) enden. Ihre AWS IoT SiteWise Daten werden in diesem Ordner gespeichert.

      • Wenn Sie keinen Amazon S3 S3-Bucket haben, wählen Sie View und erstellen Sie dann einen in der Amazon S3 S3-Konsole. Weitere Informationen finden Sie unter Erstellen Sie Ihren ersten S3-Bucket im Amazon S3 S3-Benutzerhandbuch.

    3. Gehen Sie für die S3-Zugriffsrolle wie folgt vor:

      • Wählen Sie „Eine Rolle aus einer AWS verwalteten Vorlage erstellen“. Dadurch AWS wird automatisch eine IAM Rolle erstellt, mit der Daten AWS IoT SiteWise an Amazon S3 gesendet werden können.

      • Wählen Sie Bestehende Rolle verwenden und wählen Sie dann die Rolle, die Sie erstellt haben, aus der Liste aus.

        Anmerkung
        • Sie müssen denselben Amazon S3 S3-Bucket-Namen für den S3-Bucket-Standort verwenden, den Sie im vorherigen Schritt und in Ihrer IAM Richtlinie verwendet haben.

        • Stellen Sie sicher, dass Ihre Rolle über die im folgenden Beispiel gezeigten Berechtigungen verfügt.

          Beispiel Berechtigungsrichtlinie:
          { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "s3:PutObject", "s3:GetObject", "s3:DeleteObject", "s3:GetBucketLocation", "s3:ListBucket" ], "Resource": [ "arn:aws:s3:::bucket-name", "arn:aws:s3:::bucket-name/*" ] } ] }

          Ersetzen bucket-name mit dem Namen Ihres Amazon S3 S3-Buckets.

        • Wenn der S3-Bucket mit einem vom Kunden verwalteten KMS Schlüssel verschlüsselt ist, muss für den KMS Schlüssel eine Zugriffsrichtlinie mit einer IAM Rolle kms:Decrypt und einem kms:GenerateDataKey Betrieb gelten.

    4. Informationen zur Einrichtung von Hot Tier finden Sie unter Schritt 5 unterKonfigurieren Sie die Speichereinstellungen für die Warm-Stufe (Konsole).

    5. (Optional) Gehen Sie zur AWS IoT Analytics Integration wie folgt vor.

      1. Wenn Sie Ihre Daten abfragen AWS IoT Analytics möchten, wählen Sie Enabled AWS IoT Analytics data store aus.

      2. AWS IoT SiteWise generiert einen Namen für Ihren Datenspeicher, oder Sie können einen anderen Namen eingeben.

      AWS IoT SiteWise erstellt automatisch einen Datenspeicher AWS IoT Analytics zum Speichern Ihrer Daten. Um die Daten abzufragen, können Sie sie verwenden, AWS IoT Analytics um Datensätze zu erstellen. Weitere Informationen finden Sie im AWS IoT Analytics Benutzerhandbuch unter Arbeiten mit AWS IoT SiteWise Daten.

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

Im Bereich AWS IoT SiteWise Speicher kann der Cold-Tier-Speicher einen der folgenden Werte annehmen:

  • Aktiviert — AWS IoT SiteWise repliziert Ihre Daten in den angegebenen Amazon S3 S3-Bucket.

  • Aktiviert — AWS IoT SiteWise verarbeitet Ihre Anfrage zur Aktivierung des Cold-Tier-Speichers. Dieser Vorgang kann mehrere Minuten in Anspruch nehmen.

  • Enable_Failed — Ihre Anfrage zur Aktivierung des Cold-Tier-Speichers AWS IoT SiteWise konnte nicht verarbeitet werden. Wenn Sie AWS IoT SiteWise das Senden von Protokollen an Amazon CloudWatch Logs aktiviert haben, können Sie diese Protokolle zur Behebung von Problemen verwenden. Weitere Informationen finden Sie unter Mit Amazon CloudWatch Logs überwachen.

  • Deaktiviert — Der Cold-Tier-Speicher ist deaktiviert.

Konfigurieren Sie die Speichereinstellungen für Cold Tier (AWS CLI)

Das folgende Verfahren zeigt Ihnen, wie Sie die Speichereinstellungen für die Replikation von Daten auf das Cold-Tier mithilfe von AWS CLI konfigurieren.

Um Speichereinstellungen zu konfigurieren mit AWS CLI
  1. Um Daten in einen Amazon S3 S3-Bucket in Ihrem Konto zu exportieren, führen Sie den folgenden Befehl aus, um die Speichereinstellungen zu konfigurieren. Ersetzen file-name mit dem Namen der Datei, die die AWS IoT SiteWise Speicherkonfiguration enthält.

    aws iotsitewise put-storage-configuration --cli-input-json file://file-name.json
    Beispiel AWS IoT SiteWise Speicherkonfiguration
    • Ersetzen bucket-name mit Ihrem Amazon S3 S3-Bucket-Namen.

    • Ersetzen prefix mit Ihrem Amazon S3 S3-Präfix.

    • Ersetzen aws-account-id mit Ihrer AWS Konto-ID.

    • Ersetzen role-name mit dem Namen der Amazon S3-Zugriffsrolle, die das Senden von Daten AWS IoT SiteWise an Amazon S3 ermöglicht.

    • Ersetzen retention-in-days mit einer ganzen Zahl, die größer oder gleich 30 Tagen ist.

    { "storageType": "MULTI_LAYER_STORAGE", "multiLayerStorage": { "customerManagedS3Storage": { "s3ResourceArn": "arn:aws:s3:::bucket-name/prefix/", "roleArn": "arn:aws:iam::aws-account-id:role/role-name" } }, "retentionPeriod": { "numberOfDays": retention-in-days, "unlimited": false } }
    Anmerkung
    • Sie müssen denselben Amazon S3 S3-Bucket-Namen in der AWS IoT SiteWise Speicherkonfiguration und IAM -richtlinie verwenden.

    • Stellen Sie sicher, dass Ihre Rolle über die im folgenden Beispiel gezeigten Berechtigungen verfügt.

      Beispiel Berechtigungsrichtlinie:
      { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "s3:PutObject", "s3:GetObject", "s3:DeleteObject", "s3:GetBucketLocation", "s3:ListBucket" ], "Resource": [ "arn:aws:s3:::bucket-name", "arn:aws:s3:::bucket-name/*" ] } ] }

      Ersetzen bucket-name mit dem Namen Ihres Amazon S3 S3-Buckets.

    • Wenn der S3-Bucket mit einem vom Kunden verwalteten KMS Schlüssel verschlüsselt ist, muss für den KMS Schlüssel eine Zugriffsrichtlinie mit einer IAM Rolle kms:Decrypt und einem kms:GenerateDataKey Betrieb gelten.

    Beispiel response
    { "storageType": "MULTI_LAYER_STORAGE", "retentionPeriod": { "numberOfDays": 100, "unlimited": false }, "configurationStatus": { "state": "UPDATE_IN_PROGRESS" } }
    Anmerkung

    Es kann einige Minuten dauern AWS IoT SiteWise , bis die Speicherkonfiguration aktualisiert ist.

  2. Führen Sie den folgenden Befehl aus, um die Informationen zur Speicherkonfiguration abzurufen.

    aws iotsitewise describe-storage-configuration
    Beispiel response
    { "storageType": "MULTI_LAYER_STORAGE", "multiLayerStorage": { "customerManagedS3Storage": { "s3ResourceArn": "arn:aws:s3:::DOC-EXAMPLE-BUCKET/torque/", "roleArn": "arn:aws:iam::123456789012:role/SWAccessS3Role" } }, "retentionPeriod": { "numberOfDays": 100, "unlimited": false }, "configurationStatus": { "state": "ACTIVE" }, "lastUpdateDate": "2021-03-30T15:54:14-07:00" }
  3. Um den Export von Daten in den Amazon S3 S3-Bucket zu beenden, führen Sie den folgenden Befehl aus, um die Speichereinstellungen zu konfigurieren.

    aws iotsitewise put-storage-configuration --storage-type SITEWISE_DEFAULT_STORAGE
    Anmerkung

    Standardmäßig werden Ihre Daten nur im Hot-Tier von gespeichert AWS IoT SiteWise.

    Beispiel response
    { "storageType": "SITEWISE_DEFAULT_STORAGE", "configurationStatus": { "state": "UPDATE_IN_PROGRESS" } }
  4. Führen Sie den folgenden Befehl aus, um die Informationen zur Speicherkonfiguration abzurufen.

    aws iotsitewise describe-storage-configuration
    Beispiel response
    { "storageType": "SITEWISE_DEFAULT_STORAGE", "configurationStatus": { "state": "ACTIVE" }, "lastUpdateDate": "2021-03-30T15:57:14-07:00" }

(Optional) Erstellen Sie einen AWS IoT Analytics Datenspeicher (AWS CLI)

Ein AWS IoT Analytics Datenspeicher ist ein skalierbares und abfragbares Repository, das Daten empfängt und speichert. Sie können die AWS IoT SiteWise Konsole verwenden oder einen AWS IoT Analytics Datenspeicher AWS IoT Analytics APIs zum Speichern Ihrer AWS IoT SiteWise Daten erstellen. Um die Daten abzufragen, erstellen Sie Datensätze mithilfe AWS IoT Analytics von. Weitere Informationen finden Sie im AWS IoT Analytics Benutzerhandbuch unter Arbeiten mit AWS IoT SiteWise Daten.

Die folgenden Schritte dienen AWS CLI zum Erstellen eines Datenspeichers in AWS IoT Analytics.

Führen Sie den folgenden Befehl aus, um einen Datenspeicher zu erstellen. Ersetzen file-name mit dem Namen der Datei, die die Datenspeicherkonfiguration enthält.

aws iotanalytics create-datastore --cli-input-json file://file-name.json
Anmerkung
  • Sie müssen den Namen eines vorhandenen Amazon S3 S3-Buckets angeben. Wenn Sie keinen Amazon S3 S3-Bucket haben, erstellen Sie zuerst einen. Weitere Informationen finden Sie unter Erstellen Ihres ersten S3-Buckets im Amazon S3 S3-Benutzerhandbuch.

  • Sie müssen denselben Amazon S3 S3-Bucket-Namen in der AWS IoT SiteWise Speicherkonfiguration, IAM Richtlinie und AWS IoT Analytics Datenspeicherkonfiguration verwenden.

Beispiel AWS IoT Analytics Datenspeicher-Konfiguration

Ersetzen data-store-name and s3-bucket-name mit Ihrem AWS IoT Analytics Datenspeicher-Namen und dem Amazon S3 S3-Bucket-Namen.

{ "datastoreName": "data-store-name", "datastoreStorage": { "iotSiteWiseMultiLayerStorage": { "customerManagedS3Storage": { "bucket": "s3-bucket-name" } } }, "retentionPeriod": { "numberOfDays": 90 } }
Beispiel response
{ "datastoreName": "datastore_IoTSiteWise_demo", "datastoreArn": "arn:aws:iotanalytics:us-west-2:123456789012:datastore/datastore_IoTSiteWise_demo", "retentionPeriod": { "numberOfDays": 90, "unlimited": false } }