選取您的 Cookie 偏好設定

我們使用提供自身網站和服務所需的基本 Cookie 和類似工具。我們使用效能 Cookie 收集匿名統計資料，以便了解客戶如何使用我們的網站並進行改進。基本 Cookie 無法停用，但可以按一下「自訂」或「拒絕」以拒絕效能 Cookie。

如果您同意，AWS 與經核准的第三方也會使用 Cookie 提供實用的網站功能、記住您的偏好設定，並顯示相關內容，包括相關廣告。若要接受或拒絕所有非必要 Cookie，請按一下「接受」或「拒絕」。若要進行更詳細的選擇，請按一下「自訂」。

偏好設定
聯絡我們
意見回饋
AWS Documentation
建立 AWS 帳戶

IoT SiteWise 發佈者

PDF
RSS
焦點模式
IoT SiteWise 發佈者 - AWS IoT Greengrass
版本Type作業系統要求相依性組態輸入資料本機日誌檔案故障診斷和偵錯授權變更記錄另請參閱

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

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

IoT SiteWise 發佈者元件 (aws.iot.SiteWiseEdgePublisher) 可讓 AWS IoT SiteWise 閘道將資料從邊緣匯出至 AWS 雲端。

如需 AWS IoT SiteWise 閘道的詳細資訊，請參閱AWS IoT SiteWise 《 使用者指南》中的AWS IoT SiteWise 在邊緣使用 。

版本

此元件具有下列版本：

  • 4.0.x

  • 3.2.x

  • 3.1.x 版本

  • 3.0.x

  • 2.4.x 版本

  • 2.3.x 版本

  • 2.2.x 版本

  • 2.1.x

  • 2.0.x

Type

此元件是一般元件 (aws.greengrass.generic)。Greengrass 核會執行元件的生命週期指令碼。

如需詳細資訊，請參閱元件類型。

作業系統

此元件可以安裝在執行下列作業系統的核心裝置上：

  • Linux

  • Windows

要求

此元件有下列需求：

  • Greengrass 核心裝置必須在下列其中一個平台上執行：

    • os：Ubuntu 18.04 或更新版本

      架構：x86_64 (AMD64) 或 ARMv8 (Aarch64)

    • os：Red Hat Enterprise Linux (RHEL) 8

      架構：x86_64 (AMD64) 或 ARMv8 (Aarch64)

    • os：Amazon Linux 2

      架構：x86_64 (AMD64) 或 ARMv8 (Aarch64)

    • os：Debian 11

      架構：x86_64 (AMD64) 或 ARMv8 (Aarch64)

    • os：Windows Server 2019 或更新版本

      架構：x86_64 (AMD64)

  • Greengrass 核心裝置必須連線至網際網路。

  • Greengrass 核心裝置必須獲得授權才能執行 iotsitewise:BatchPutAssetPropertyValue動作。如需詳細資訊，請參閱授權核心裝置與 AWS 服務互動。

    範例 許可政策
    {
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "iotsitewise:BatchPutAssetPropertyValue",
            "Resource": "*"
        }
    ]
}

端點和連接埠

除了基本操作所需的端點和連接埠之外，此元件還必須能夠對下列端點和連接埠執行傳出請求。如需詳細資訊，請參閱允許透過代理或防火牆的裝置流量。

端點 連線埠 必要 描述

data.iotsitewise.region.amazonaws.com

 443 是

將資料發佈至 AWS IoT SiteWise。

相依性

當您部署元件時， AWS IoT Greengrass 也會部署其相依性的相容版本。這表示您必須符合元件及其所有相依性的要求，才能成功部署元件。本節列出此元件發行版本的相依性，以及為每個相依性定義元件版本的語意版本限制。您也可以在 AWS IoT Greengrass 主控台中檢視每個版本元件的相依性。在元件詳細資訊頁面上，尋找相依性清單。

下表列出此元件 2.0.x 至 2.2.x 版的相依性。

相依性 相容版本 相依性類型
Greengrass 核 >=2.3.0<3.0.0 硬式
串流管理員 >=2.0.10<3.0.0 硬式

如需元件相依性的詳細資訊，請參閱元件配方參考。

組態

此元件沒有任何組態參數。

您可以使用 AWS IoT SiteWise 主控台或 API 來設定 IoT SiteWise 發佈者元件。如需詳細資訊，請參閱AWS IoT SiteWise 《 使用者指南》中的步驟 3：設定發佈者 - 選用。

輸入資料

此元件會從 AWS IoT Greengrass 串流管理員讀取PutAssetPropertyValueEntry訊息。如需詳細資訊，請參閱《 AWS IoT SiteWise API 參考》中的 PutAssetPropertyValueEntry。

本機日誌檔案

此元件使用以下日誌檔案。

Linux
/greengrass/v2/logs/aws.iot.SiteWiseEdgePublisher.log
Windows
C:\greengrass\v2\logs\aws.iot.SiteWiseEdgePublisher.log
anchoranchor
/greengrass/v2/logs/aws.iot.SiteWiseEdgePublisher.log
檢視此元件的日誌

  • 在核心裝置上執行下列命令，以即時檢視此元件的日誌檔案。將 /greengrass/v2或 C：\greengrass\v2 取代為 AWS IoT Greengrass 根資料夾的路徑。

    Linux
    sudo tail -f /greengrass/v2/logs/aws.iot.SiteWiseEdgePublisher.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\aws.iot.SiteWiseEdgePublisher.log -Tail 10 -Wait
    anchoranchor
    sudo tail -f /greengrass/v2/logs/aws.iot.SiteWiseEdgePublisher.log

故障診斷和偵錯

此元件包含新的事件日誌，可協助客戶識別和修正問題。日誌檔案與本機日誌檔案分開，位於下列位置。將 /greengrass/v2或 C：\greengrass\v2 取代為 AWS IoT Greengrass 根資料夾的路徑。

Linux
/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/logs/IotSiteWisePublisherEvents.log
Windows
C:\greengrass\v2\work\aws.iot.SiteWiseEdgePublisher\logs\IotSiteWisePublisherEvents.log
anchoranchor
/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/logs/IotSiteWisePublisherEvents.log

此日誌包含詳細資訊和故障診斷指示。故障診斷資訊會與診斷一起提供，並描述如何修正問題，有時還會提供進一步資訊的連結。診斷資訊包括下列項目：

  • 嚴重性等級

  • 時間戳記

  • 其他事件特定資訊

範例日誌
accountBeingThrottled:
  Summary: Data upload speed slowed due to quota limits
  Level: WARN
  Timestamp: '2023-06-09T21:30:24.654Z'
  Description: The IoT SiteWise Publisher is limited to the "Rate of data points ingested"
    quota for a customers account. See the associated documentation and associated
    metric for the number of requests that were limited for more information. Note
    that this may be temporary and not require any change, although if the issue continues
    you may need to request an increase for the mentioned quota.
  FurtherInformation:
  - https://docs.aws.amazon.com/iot-sitewise/latest/userguide/quotas.html
  - https://docs.aws.amazon.com/iot-sitewise/latest/userguide/troubleshooting-gateway.html#gateway-issue-data-streams
  AssociatedMetrics:
  - Name: TotalErrorCount
    Description: The total number of errors of this type that occurred.
    Value: 327724.0
  AssociatedData:
  - Name: AggregatePropertyAliases
    Description: The aggregated property aliases of the throttled data.
    FileLocation: /greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/./logs/data/AggregatePropertyAliases_1686346224654.log

授權

此元件根據 Greengrass 核心軟體授權合約發行。

變更記錄

下表說明每個版本元件的變更。

版本

變更

4.0.1
錯誤修正和改善

  • 修正當您停用最大批次等待時間組態 AWS IoT SiteWise 時，防止資料上傳至 的問題。

  • 修正 IoTSiteWisePublisher.NumberOfSubscriptionsToMqttBroker 指標不正確地報告訂閱 MQTT 代理程式之唯一主題計數的問題。

4.0.0
新功能

除了 Classic 串流、V2 閘道 （先前稱為自我託管 SiteWise Edge 閘道） 之外，還新增對啟用 MQTT 的 V3 閘道的支援。 V2 SiteWise

錯誤修正和改善

  • 修正PublishSuccessCount指標報告負值的問題。

  • 修正發佈者未在 100 秒內啟動並進入 BROKEN 狀態的問題。

  • 修正安全漏洞。

3.2.0
新功能
錯誤修正和改善

  • 修正導致檢查點資料庫檔案損毀的問題。

  • 修正產生重複指標的問題。

3.1.4
警告

3.1.4 版已於 2025 年 2 月 20 日終止。此版本中的改進功能可在此元件的較新版本中使用。

錯誤修正和改善

  • 修正離線後可能導致longer-than-expected的問題。

3.1.3
錯誤修正和改善

  • 修正建立位於 的事件日誌檔案，/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/logs/IoTSiteWisePublisherEvents.log但未記錄任何事件的問題。

  • 新增下列 CloudWatch 指標，以監控與 MQTT 代理程式的連線：

    • IoTSiteWisePublisher.IsConnectedToMqttBroker

    • IoTSiteWisePublisher.NumberOfSubscriptionsToMqttBroker

    • IoTSiteWisePublisher.NumberOfUniqueMqttTopicsReceived

    • IoTSiteWisePublisher.MqttMessageReceivedSuccessCount

    • IoTSiteWisePublisher.MqttReceivedSuccessBytes

    如需這些指標的詳細資訊，請參閱AWS IoT Greengrass Version 2 閘道指標。

  • 修正即使上傳 parquet 檔案至 S3 失敗，仍呼叫 BatchCreateJob API 的問題。

3.1.2
錯誤修正和改善

  • 修正 3.1.1 版中引入的高 CPU 用量問題。

3.1.1
警告

3.1.1 版已於 2024 年 3 月 12 日終止。此版本中的改進功能可在此元件的較新版本中使用。

錯誤修正和改善

  • 新增額外的記錄，在發生錯誤時識別受影響的資料別名。

  • 在擷取資料的存留期新增對 AWS IoT SiteWise API 限制的本機強制執行。

  • 修正發佈者在有多個 Amazon S3 目的地時混淆 StreamManager 串流檢查點的問題。

  • 修正發佈者如何從 StreamManager 串流讀取效能瓶頸。

3.1.0
新功能

  • 新增支援，將資料發佈為 parquet 檔案到 Amazon S3。

  • 新增 AWS IoT SiteWise 緩衝擷取的支援。

3.0.0
錯誤修正和改善

  • 修正與代理支援相關的問題。

新功能

  • 支援從 MQTT 代理程式擷取資料。

2.4.1
錯誤修正和改善

  • 啟用元件以使用 Java Corretto 11 版本 11.0.20.8.1 和更新版本。元件版本 2.4.0 和 2.3.3 顯示與 Java Corretto 版本 11.0.20.8.1 搭配使用時的"Could not find or load main class"錯誤訊息。

2.4.0
新功能

  • 新增事件日誌，讓您更輕鬆地識別和修復問題。

錯誤修正和改善

  • 改善發佈者檢查點復原。

2.3.3
錯誤修正和改善

  • 改善支援高輸送量的能力。

2.3.2
錯誤修正和改善

  • 修正下載發佈者組態時的 HTTP 代理支援。

2.3.1
新功能

  • 新增在 Linux ARMv8 架構上安裝資料收集套件的支援。

  • Linux ARMv8 的最低需求：

    • 記憶體：4 GB

    • CPU：ARM Cortex-A72 或同等規格

2.2.3
錯誤修正和改善

  • 移除不在可重試例外清單中的一般例外狀況的重試。

2.2.2
錯誤修正和改善

  • 透過 HTTP AWS IoT SiteWise 代理伺服器重新介紹對 的資料上傳支援。

2.2.1
注意

此版本不支援 HTTP 代理組態。2.2.2 版和更新版本重新推出此功能的支援。

新功能

  • 新增此元件的支援，以在上傳資料至 時切換壓縮 AWS IoT SiteWise。

2.2.0
注意

此版本不支援 HTTP 代理組態。2.2.2 版和更新版本重新推出此功能的支援。

新功能

  • 更新此元件以壓縮資料，再將其傳送至 AWS IoT SiteWise 服務。

    • 在大多數情況下，相較於此元件的先前版本，此變更會將頻寬使用量減少 75%。

    • 在大多數情況下，此變更會增加 CPU 用量達 5%。在處理大量資料的閘道上，此變更最多可將 CPU 用量增加 15%。

    • 此變更不會影響 AWS IoT SiteWise 服務費用或服務配額用量。

    • 新增對 Windows Server 2019 或更新版本的支援。

錯誤修正和改善

  • 修正當檢查點檔案損毀時，此元件無法啟動的問題。

2.1.4
錯誤修正和改善

  • 修正與 Java 第 8 版的相容性。

2.1.3
警告

除了美國東部 （俄亥俄）、加拿大 （中部） 和 AWS GovCloud （美國東部） 區域以外，此版本不再提供。此元件版本需要執行 Java 11 版或更新版本。此版本中的改進功能可在此元件的較新版本中使用。

錯誤修正和改善

  • 改善在不支援的裝置上部署此元件時的錯誤訊息。

  • 當資料上傳失敗時，日誌錯誤的更新。

2.1.2
錯誤修正和改善

  • 更新以在資料過期時叫用過期的資料匯出功能。

2.1.1

錯誤修正和改善。

2.1.0
新功能

  • 新增支援，以先將最新資料發佈至雲端。

  • 新增不將過期資料發佈至雲端的支援。

  • 新增在本機存放過期資料的支援。

錯誤修正和改善

  • 減少磁碟 I/O 和對應的延遲。

2.0.2

錯誤修正和改善。

2.0.1

初始版本。

另請參閱

在本頁面

隱私權網站條款Cookie 偏好設定
© 2025, Amazon Web Services, Inc.或其附屬公司。保留所有權利。