View a markdown version of this page

IDT 用量指標 - AWS IoT Greengrass
設定您的 AWS 登入資料提供 AWS 登入資料給 IDT

支援終止通知：2026 年 10 月 7 日 AWS 將停止 的支援 AWS IoT Greengrass Version 1。2026 年 10 月 7 日之後，您將無法再存取 AWS IoT Greengrass V1 資源。如需詳細資訊，請造訪從 遷移 AWS IoT Greengrass Version 1。

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

IDT 用量指標

如果您提供具有必要許可的 AWS 登入資料， AWS IoT Device Tester 會收集用量指標並將其提交至 AWS。這是選擇加入功能，用於改善 IDT 功能。IDT 會收集下列資訊：

  • 用來執行 IDT 的 AWS 帳戶 ID

  • 用於執行測試的 IDT CLI 命令

  • 執行的測試套件

  • <device-tester-extract-location> 資料夾的測試套件

  • 在裝置集區中設定的裝置數量

  • 測試案例名稱和執行時間

  • 測試結果資訊，例如測試是否通過、失敗、發生錯誤或被略過

  • 測試的產品功能

  • IDT 結束行為，例如非預期或提早結束

IDT 傳送的所有資訊也會記錄到 <device-tester-extract-location>/results/<execution-id>/ 資料夾中metrics.log的檔案。您可以檢視日誌檔案，以查看在測試執行期間收集的資訊。只有在您選擇收集用量指標時，才會產生此檔案。

若要停用指標集合，您不需要採取其他動作。只要不要存放您的 AWS 登入資料，而且如果您有存放的 AWS 登入資料，請勿設定 config.json 檔案來存取它們。

設定您的 AWS 登入資料

如果您還沒有 AWS 帳戶，則必須建立一個。如果您已經有 AWS 帳戶，您只需要為您的帳戶設定必要的許可，以允許 IDT AWS 代表您將用量指標傳送至 。

步驟 2：設定 IDT 的許可

在此步驟中，設定 IDT 用來執行測試和收集 IDT 用量資料的許可。您可以使用 AWS 管理主控台 或 AWS Command Line Interface (AWS CLI) 來建立 IAM 政策和 IDT 的使用者，然後將政策連接到使用者。

設定 IDT (主控台) 的許可

請依照下列步驟使用主控台來設定 IDT for AWS IoT Greengrass的許可。

  1. 登入 IAM 主控台。

  2. 建立客戶受管政策，該政策授與建立具有特定許可之角色的許可。

    1. 在導覽窗格中，選擇政策，然後選擇建立政策。

    2. 在 JSON 標籤上，用以下政策取代預留位置內容。

      JSON
      {
    "Version":"2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "iot-device-tester:SendMetrics"
            ],
            "Resource": "*"
        }
    ]
}

    3. 選擇下一步：標籤。

    4. 選擇下一步：檢閱。

    5. 對於名稱，輸入 IDTUsageMetricsIAMPermissions。在 Summary (摘要) 下，檢閱您的政策所授與的許可。

    6. 選擇建立政策。

  3. 建立 IAM 使用者並將許可連接到使用者。

    1. 建立 IAM 使用者。請遵循《IAM 使用者指南》中建立 IAM 使用者 （主控台） 的步驟 1 到 5。如果您已建立 IAM 使用者，請跳至下一個步驟。

    2. 將許可連接至您的 IAM 使用者：

      1. 在設定許可頁面上，選擇直接連接現有政策。

      2. 搜尋您在上一個步驟中建立的 IDTUsageMetricsIAMPermissions 政策。選取核取方塊。

    3. 選擇下一步：標籤。

    4. 選擇 Next: Review (下一步：檢閱) 以檢視選擇的摘要。

    5. 選擇 Create user (建立使用者)。

    6. 若要檢視使用者的存取金鑰 (存取金鑰 ID 和私密存取金鑰)，請選擇密碼和存取金鑰旁的 Show (顯示)。若要儲存存取金鑰，請選擇 Download.csv，並將檔案儲存到安全的位置。您稍後會使用此資訊來設定您的 AWS 登入資料檔案。

 

步驟 2：設定 IDT (AWS CLI) 的許可

請依照下列步驟使用 AWS CLI 來設定 IDT for 的許可 AWS IoT Greengrass。如果您已在主控台中設定許可，請跳至設定您的裝置以執行 IDT 測試或選用：設定 IDT for 的 Docker 容器 AWS IoT Greengrass。

  1. 如果尚未安裝 ，請在電腦上安裝和設定 AWS CLI 。請遵循AWS Command Line Interface 《 使用者指南》中的安裝 AWS CLI 中的步驟。

    注意

    AWS CLI 是開放原始碼工具，可用來與命令列 Shell 中的 AWS 服務互動。

  2. 建立下列客戶受管政策，授予管理 IDT 和 AWS IoT Greengrass 角色的許可。

    Linux, macOS, or Unix
    aws iam create-policy --policy-name IDTUsageMetricsIAMPermissions --policy-document '{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "iot-device-tester:SendMetrics"
            ],
            "Resource": "*"
        }
    ]
}'
    Windows command prompt
    aws iam create-policy --policy-name IDTUsageMetricsIAMPermissions --policy-document
                                        '{\"Version\": \"2012-10-17\", \"Statement\": [{\"Effect\": \"Allow\", \"Action\": [\"iot-device-tester:SendMetrics\"], \"Resource": \"*\"}]}'
    注意

    此步驟包含 Windows 命令提示字元範例，因為它使用的 JSON 語法與 Linux、macOS 或 Unix 終端機命令不同。

  3. 建立 IAM 使用者並連接 IDT for 所需的許可 AWS IoT Greengrass。

    1. 建立 IAM 使用者。

      aws iam create-user --user-name user-name

    2. 將您建立IDTUsageMetricsIAMPermissions的政策連接至 IAM 使用者。將 user-name 取代為您的 IAM 使用者名稱，並將 命令中的 <account-id> 取代為您的 ID AWS 帳戶。

      aws iam attach-user-policy --user-name user-name --policy-arn arn:aws:iam::<account-id>:policy/IDTGreengrassIAMPermissions

  4. 為使用者建立私密存取金鑰。

    aws iam create-access-key --user-name user-name

    將輸出儲存在安全的位置。您稍後會使用此資訊來設定您的 AWS 登入資料檔案。

提供 AWS 登入資料給 IDT

若要允許 IDT 存取您的 AWS 登入資料並提交指標 AWS，請執行下列動作：

  1. 將 IAM 使用者的 AWS 登入資料儲存為環境變數或儲存在登入資料檔案中：

    1. 若要使用環境變數，請執行下列命令：

      AWS_ACCESS_KEY_ID=access-key
AWS_SECRET_ACCESS_KEY=secret-access-key

    2. 若要使用登入資料檔案，請將下列資訊新增至 .aws/credentials file:

      [profile-name]
aws_access_key_id=access-key
aws_secret_access_key=secret-access-key

  2. 設定 config.json 檔案的 auth區段。如需詳細資訊，請參閱（選用） 設定 config.json。