本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
如果您提供具有必要許可的 AWS 登入資料, 會 AWS IoT Device Tester 收集用量指標並將其提交至 AWS。這是選擇加入功能,用於改善 IDT 功能。IDT 會收集下列資訊:
-
用來執行 IDT 的 AWS 帳戶 ID
-
用於執行測試的 IDT AWS 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 代表您將用量指標傳送至 。
步驟 1:建立 AWS 帳戶
在此步驟中,建立和設定 AWS 帳戶。如果您已擁有 AWS 帳戶,請跳到 步驟 2:設定 IDT 的許可。
如果您沒有 AWS 帳戶,請完成下列步驟來建立一個 。
註冊 AWS 帳戶
開啟 https://portal.aws.amazon.com/billing/signup
。 請遵循線上指示進行。
部分註冊程序需接收來電,並在電話鍵盤輸入驗證碼。
當您註冊 時 AWS 帳戶,AWS 帳戶根使用者會建立 。根使用者有權存取該帳戶中的所有 AWS 服務 和資源。作為安全最佳實務,請將管理存取權指派給使用者,並且僅使用根使用者來執行需要根使用者存取權的任務。
若要建立管理員使用者,請選擇下列其中一個選項。
選擇一種管理管理員的方式 | 到 | 根據 | 您也可以 |
---|---|---|---|
在 IAM Identity Center (建議) |
使用短期憑證存取 AWS。 這與安全性最佳實務一致。有關最佳實務的資訊,請參閱 IAM 使用者指南中的 IAM 安全最佳實務。 |
請遵循 AWS IAM Identity Center 使用者指南的入門中的說明。 | 透過在 AWS Command Line Interface 使用者指南中設定 AWS CLI 以使用 來設定 AWS IAM Identity Center程式設計存取。 |
在 IAM 中 (不建議使用) |
使用長期憑證存取 AWS。 | 請遵循 IAM 使用者指南中建立緊急存取的 IAM 使用者中的指示。 | 在 IAM 使用者指南中,透過管理 IAM 使用者的存取金鑰來設定程式設計存取。 |
步驟 2:設定 IDT 的許可
在此步驟中,設定 IDT 用來執行測試和收集 IDT 用量資料的許可。您可以使用 AWS Management Console 或 AWS Command Line Interface (AWS CLI) 來建立 IAM 政策和 IDT 的使用者,然後將政策連接到使用者。
設定 IDT (主控台) 的許可
請依照下列步驟使用主控台來設定 IDT for AWS IoT Greengrass的許可。
-
登入 IAM 主控台
。 -
建立客戶受管政策,該政策授與建立具有特定許可之角色的許可。
-
在導覽窗格中,選擇政策,然後選擇建立政策。
-
在 JSON 標籤上,用以下政策取代預留位置內容。
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iot-device-tester:SendMetrics" ], "Resource": "*" } ] }
-
選擇檢閱政策。
-
對於名稱,輸入
IDTUsageMetricsIAMPermissions
。在 Summary (摘要) 下,檢閱您的政策所授與的許可。 -
選擇 建立政策。
-
-
建立 IAM 使用者並將許可連接到使用者。
-
建立 IAM 使用者。請遵循 IAM 使用者指南中建立 IAM 使用者 (主控台) 中的步驟 1 到 5。如果您已建立 IAM 使用者,請跳至下一個步驟。
-
將許可連接至您的 IAM 使用者:
-
在 Set permissions (設定許可) 頁面上,選擇 Attach existing policies directly (直接連接現有的政策)。
-
搜尋您在上一個步驟中建立的 IDTUsageMetricsIAMPermissions 政策。選取核取方塊。
-
-
選擇下一步:標籤。
-
選擇 Next: Review (下一步:檢閱) 以檢視選擇的摘要。
-
選擇 Create user (建立使用者)。
-
若要檢視使用者的存取金鑰 (存取金鑰 ID 和私密存取金鑰),請選擇密碼和存取金鑰旁的 Show (顯示)。若要儲存存取金鑰,請選擇 Download.csv,並將檔案儲存到安全的位置。您稍後會使用此資訊來設定登入 AWS 資料檔案。
-
步驟 2:設定 IDT (AWS CLI) 的許可
請依照下列步驟,使用 AWS CLI 來設定 IDT for 的許可 AWS IoT Greengrass。
-
如果尚未安裝,請在電腦上安裝和設定 AWS CLI 。請遵循 AWS Command Line Interface 使用者指南中的安裝 AWS CLI 中的步驟。
注意
AWS CLI 是開放原始碼工具,可用來與來自命令列 shell AWS 的服務互動。
-
建立下列客戶受管政策,授予管理 IDT 和 AWS IoT Greengrass 角色的許可。
aws iam create-policy --policy-name IDTUsageMetricsIAMPermissions --policy-document '{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iot-device-tester:SendMetrics" ], "Resource": "*" } ] }'
-
建立 IAM 使用者並連接 IDT for 所需的許可 AWS IoT Greengrass。
-
建立 IAM 使用者。
aws iam create-user --user-name
user-name
-
將您建立
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
-
-
為使用者建立私密存取金鑰。
aws iam create-access-key --user-name
user-name
將輸出儲存在安全的位置。您稍後會使用此資訊來設定登入 AWS 資料檔案。
提供 AWS 登入資料給 IDT
若要允許 IDT 存取您的 AWS 登入資料並提交指標 AWS,請執行下列動作:
-
將 IAM 使用者的 AWS 登入資料儲存為環境變數或儲存在登入資料檔案中:
-
若要使用環境變數,請執行下列命令。
export AWS_ACCESS_KEY_ID=
access-key
export AWS_SECRET_ACCESS_KEY=secret-access-key
-
若要使用登入資料檔案,請將下列資訊新增至
~/.aws/credentials
檔案。[profile-name] aws_access_key_id=
access-key
aws_secret_access_key=secret-access-key
-
-
設定
config.json
檔案的auth
區段。如需詳細資訊,請參閱(選用) 設定 config.json。