設定 AWS IoT SiteWise 發行者元件 - AWS IoT SiteWise

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

設定 AWS IoT SiteWise 發行者元件

建立 AWS IoT SiteWise Edge 閘道並安裝軟體之後，您可以設定發行者元件，讓 SiteWise Edge 閘道可以將資料匯出至 AWS 雲端。使用發行者元件可啟用其他功能或設定預設設定。如需詳細資訊，請參閱AWS IoT Greengrass Version 2 開發人員指南中的發AWS IoT SiteWise 行者。

Console

  1. 導覽至 AWS IoT SiteWise 主控台。

  2. 在瀏覽窗格中，選擇 [邊緣閘道]。

  3. 選取您要為其設定發行者的 SiteWise Edge 閘道。

  4. 在 [發行者設定] 區段中，選擇 [編輯

  5. 對於「發佈順序」，請選擇下列其中一項：

    • 首先發佈最舊的資料 — SiteWise Edge 閘道預設會先將最舊的資料發佈到雲端。

    • 先發佈最新資料 — SiteWise Edge 閘道會先將最新資料發佈到雲端。

  6. (選擇性) 如果您不想讓 SiteWise Edge 閘道壓縮資料，請取消選取 [上傳資料時啟用壓縮]。

  7. (選擇性) 如果您不想發佈舊資料，請選擇 [排除過期資料]，然後執行下列動作：

    1. 對於截止期間，輸入值並選擇一個單位。截止時間必須介於 5 分鐘至 7 天之間。例如，如果截止期間為三天，則不會將超過三天的資料發佈到雲端。

  8. (選擇性) 若要設定本機裝置上資料處理方式的自訂設定，請選擇本機儲存設定，然後執行下列動作：

    1. 在「保留期間」中，輸入數字並選擇單位。保留期間必須介於 1 分鐘到 30 天之間，且大於或等於輪替週期。例如，如果保留期為 14 天，則 SiteWise Edge 閘道會刪除邊緣上超過指定截止期限儲存 14 天之後的任何資料。

    2. 在循環週期中，輸入一個數字並選擇一個單位。輪替期間必須大於一分鐘，且等於或小於保留期間。例如，假設輪換週期為兩天， SiteWise Edge 閘道會批次處理，並將超過截止期間的資料儲存到單一檔案中。對於透過自我託管的閘道 AWS IoT Greengrass V2， SiteWise Edge 閘道會每兩天將一批資料傳輸到下列本機目錄一次：/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/exports

    3. 對於儲存容量，請輸入大於或等於 1 的值。如果儲存容量為 2 GB，則當本機儲存超過 2 GB 的資料時， SiteWise Edge 閘道會開始刪除資料。

  9. 選擇 Save (儲存)。

AWS CLI

您可以使用UpdateGatewayCapabilityConfigurationAPI來配置發行者。將 capabilityNamespace 參數設為 iotsitewise:publisher:2。

發行者提供下列可自訂的組態參數：

SiteWisePublisherConfiguration
publishingOrder

資料發佈至雲端的順序。此參數的值可以是下列其中一項：

  • TIME_ORDER(先發佈最舊的資料) — 依預設，最早的資料會先發佈到雲端。

  • RECENT_DATA(先發佈最新資料) — 最新資料會先發佈至雲端。

dropPolicy

(選擇性) 控制要將哪些資料發佈到雲端的原則。

cutoffAge

早於截止期間的資料不會發佈到雲端。截止年齡必須介於五分鐘至七天之間。

您可以m在指定截止年齡d時使用h、和。請注意，m代表分鐘，h代表小時，並d代表天。

exportPolicy

(選擇性) 在邊緣管理資料儲存的原則。此政策適用於早於截止期限的資料。

retentionPeriod

在儲存指定的保留期間內， SiteWise Edge 閘道會從本機儲存區刪除邊緣位於截止期間之前的任何資料。保留期間必須介於 1 分鐘到 30 天之間，且大於或等於輪替週期。

您可以m在指定保留期間d時使用h、和。請注意，m代表分鐘，h代表小時，並d代表天。

rotationPeriod

批次處理並將資料儲存至單一檔案的截止期間之前的時間間隔。 SiteWise Edge 閘道會在每個輪換期間結束時，將一批資料傳輸到下列本機目錄：/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/exports輪換期間必須大於一分鐘，且等於或小於保留期間。

您可以m在指定輪替週期d時使用h、和。請注意，m代表分鐘，h代表小時，並d代表天。

exportSizeLimitGB

允許的本機儲存資料大小上限 (以 GB 為單位)。如果違反此配額， SiteWise Edge 閘道會開始刪除最早的資料，直到儲存在本機的資料大小等於或小於配額為止。此參數的值必須大於或等於 1。

SiteWiseS3PublisherConfiguration
accessRoleArn

授與管理您要發佈之 Amazon S3 儲存貯體之 AWS IoT SiteWise 權限的存取角色。

streamToS3ConfigMapping

將串流對應至 Amazon S3 組態的組態陣列。

streamName

要從 Amazon S3 組態讀取和發佈至 Amazon S3 組態的串流。

targetBucketArn

ARN要發佈的目標值區。

publishPolicy

publishFrequency

SiteWise 邊緣閘道發佈到 Amazon S3 儲存貯體的頻率。

localSizeLimitGB

寫入本機磁碟的檔案大小上限。如果違反此臨界值，發行者會將所有緩衝資料發佈至其目的地。

siteWiseImportPolicy

enableSiteWiseStorageImport

將此設定true為可將資料從 Amazon S3 儲存貯體匯入 AWS IoT SiteWise 儲存。

enableDeleteAfterImport

將此設定為可在擷取true至 AWS IoT SiteWise 儲存後刪除 Amazon S3 儲存貯體中的檔案。

範例 發行者組態：

發行者命名空間：iotsitewise:publisher:2

{
    "SiteWisePublisherConfiguration": {                               
        "publishingOrder": "TIME_ORDER",
        "dropPolicy": {
            "cutoffAge": "7d",
            "exportPolicy": {
                "retentionPeriod": "7d",
                "rotationPeriod": "6h",
                "exportSizeLimitGB": 10
            }
        }
    },
    "SiteWiseS3PublisherConfiguration": {
        "accessRoleArn": "arn:aws:iam:123456789012:role/roleName",
        "streamToS3ConfigMapping": [
            {
                "streamName": "S3_OPC-UA_Data_Collector",
                "targetBucketArn": "arn:aws:s3:::amzn-s3-demo-bucket/dataCollector",
                "publishPolicy": {
                    "publishFrequency": "10m",
                    "localSizeLimitGB": 10
                },
                "siteWiseImportPolicy": {
                    "enableSiteWiseStorageImport": true,
                    "enableDeleteAfterImport": true
                }
            }
        ]
    }
}