本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
IDT 使用情况指标
如果你提供Amazon具有所需权限的凭据,Amazon IoT Device Tester收集使用量指标并将其提交到Amazon. 这是一种可选功能,用于改进 IDT 功能。IDT 收集以下信息:
-
这些区域有:Amazon用于运行 IDT 的账户 ID
-
用于运行测试的 IDT CLI 命令
-
正在运行的测试套件
-
中的测试套件
<device-tester-extract-location>
文件夹 -
在设备池中配置的设备数量
-
测试用例名称和运行时间
-
测试结果信息,例如测试是否通过、失败、遇到错误或被跳过
-
测试产品功能
-
IDT 退出行为,例如意外或提前退出
IDT 发送的所有信息也记录到metrics.log
中的文件
folder。您可以查看日志文件以查看在测试运行期间收集的信息。仅当您选择收集使用情况指标时,才会生成此文件。<device-tester-extract-location>
/results/<execution-id>
/
要禁用指标收集,您无需采取其他操作。根本不要存储你的Amazon凭据,如果你确实存储Amazon凭据,请勿配置config.jso
n 个文件来访问它们。
配置 Amazon凭证
如果您还没有Amazon账户,你必须创建一个. 如果您已经有Amazon账户,你只需要配置所需的权限允许 IDT 将使用量指标发送到的账户Amazon代表您。
第 1 步:创建 Amazon 账户
在此步骤中,创建和配置Amazonaccount. 如果您已有 Amazon 账户,请跳到第 2 步:配置 IDT 的权限。
-
打开Amazon主页
,然后选择创建Amazon账户. 注意 如果您最近已登录到 Amazon,则您可能会看到 Sign In to the Console (登录控制台)。
-
按照屏幕上的说明进行操作。注册过程包括注册信用卡、接收短信或电话以及输入 PIN。
有关更多信息,请参阅如何创建并激活新的 Amazon Web Services 账户?
第 2 步:配置 IDT 的权限
在此步骤中,将配置 IDT 用于运行测试和收集 IDT 使用情况数据所需的权限。您可以使用Amazon Web Services Management Console要么Amazon Command Line Interface(Amazon CLI)为 IDT 创建 IAM 策略和用户,然后将策略附加到用户。
为 IDT 配置权限(控制台)
请按照以下步骤使用控制台为适用于 FreeRTOS 的 IDT 配置权限。
-
登录 IAM 控制台
。 -
创建客户托管策略,该策略授权创建具有特定权限的角色。
-
在导航窗格中,选择 Policies (策略),然后选择 Create policy (创建策略)。
-
在 JSON 选项卡中,将占位符内容替换为以下策略。
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iot-device-tester:SendMetrics" ], "Resource": "*" } ] }
-
选择 Review policy (审核策略)。
-
对于 Name (名称),请输入
IDTUsageMetricsIAMPermissions
。在 Summary (摘要) 下,查看策略授予的权限。 -
选择 Create policy(创建策略)。
-
-
创建 IAM 用户并向用户附加权限。
-
创建 IAM 用户。按照中的步骤 1 到 5 操作创建 IAM 用户(控制台)中的IAM 用户指南. 如果您已创建 IAM 用户,请跳到下一步。
-
将权限附加到 IAM 用户:
-
在 Set permissions (设置权限) 页面上,选择 Attach existing policies to user directly (直接附加现有策略到用户)。
-
搜索idtusagemetricsiam 权限您在上一步中创建的策略。选中复选框。
-
-
选择 Next:。标签。
-
选择 Next:。审核以查看您的选择摘要。
-
选择 Create user。
-
要查看用户的访问密钥(访问密钥 ID 和秘密访问密钥),请选择密码和访问密钥旁边的 Show (显示)。要保存访问密钥,请选择Download.csv (下载 .csv),然后将文件保存到安全位置。稍后您可以使用此信息配置Amazon凭证文件。
-
为 IDT 配置权限 (Amazon CLI)
按照以下步骤操作,使用Amazon CLI为 FreeRTOS 配置 IDT 配置权限。
-
在您的计算机上,安装并配置 Amazon CLI(如果尚未安装)。按中的步骤操作。安装Amazon CLI中的Amazon Command Line Interface用户指南.
注意 这些区域有:Amazon CLI是一个开源工具,您可以使用此工具进行交互。Amazon来自命令行 shell 的服务。
-
创建以下客户托管策略,该策略授权管理 IDT 和 FreeRTOS 角色。
-
创建一个 IAM 用户并附加适用于 FreeRTOS 的 IDT 所需的权限。
-
创建 IAM 用户。
aws iam create-user --user-name
user-name
-
附加
IDTUsageMetricsIAMPermissions
您为 IAM 用户创建的策略。Replace用户名称
使用您的 IAM 用户名和<account-id>
在命令中使用您的 IDAmazonaccount.aws iam attach-user-policy --user-name
user-name
--policy-arn arn:aws:iam::<account-id>
:policy/IDTFreeRTOSIAMPermissions
-
-
为用户创建私密访问密钥。
aws iam create-access-key --user-name
user-name
将输出存储在安全位置。稍后您可以使用此信息配置Amazon凭证文件。
提供AmazonIDT 的凭证
允许 IDT 访问您的Amazon凭证并将指标提交到Amazon中,执行以下操作:
-
存储Amazon作为环境变量或证书文件中的 IAM 用户的凭证:
-
要使用环境变量,请运行以下命令:
AWS_ACCESS_KEY_ID=
access-key
AWS_SECRET_ACCESS_KEY=secret-access-key
-
要使用凭证文件,请将以下信息添加到
.aws/credentials file:
[profile-name] aws_access_key_id=
access-key
aws_secret_access_key=secret-access-key
-
-
配置
auth
的 部分config.json
文件。有关更多信息,请参阅(可选)配置 config.json。