翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
IDT 使用状況メトリクス
重要
これは、FreeRTOS リリース 202012.00 で使用する FreeRTOS ユーザーガイドのアーカイブ版です。このドキュメントの最新バージョンについては、FreeRTOS ユーザーガイドを参照してください。
必要なアクセス許可を持つ 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.jso
n ファイルを設定しないでください。
AWS 認証情報を設定する
アカウントをまだお持ちでない場合は、 AWS アカウントを作成する必要があります。 AWS アカウントが既にある場合は、IDT が AWS ユーザーに代わって に使用状況メトリクスを送信できるようにするアカウントに必要なアクセス許可を設定するだけです。
にサインアップする AWS アカウント
がない場合は AWS アカウント、次の手順を実行して作成します。
にサインアップするには AWS アカウント
オンラインの手順に従います。
サインアップ手順の一部では、電話またはテキストメッセージを受信し、電話のキーパッドに検証コードを入力します。
にサインアップすると AWS アカウント、 AWS アカウントのルートユーザー が作成されます。ルートユーザーには、アカウントのすべての AWS のサービス とリソースへのアクセス権があります。セキュリティベストプラクティスとして、ユーザーに管理アクセス権を割り当て、ルートユーザーアクセスが必要なタスクの実行にはルートユーザーのみを使用するようにしてください。
AWS サインアッププロセスが完了すると、 から確認メールが送信されます。https://aws.amazon.com/
管理アクセスを持つユーザーを作成する
にサインアップしたら AWS アカウント、日常的なタスクにルートユーザーを使用しないように AWS アカウントのルートユーザー、 を保護し AWS IAM Identity Center、 を有効にして管理ユーザーを作成します。
を保護する AWS アカウントのルートユーザー
-
ルートユーザーを選択し、 AWS アカウント E メールアドレスを入力して、アカウント所有者AWS Management Console
として にサインインします。次のページでパスワードを入力します。 ルートユーザーを使用してサインインする方法については、AWS サインイン ユーザーガイドのルートユーザーとしてサインインするを参照してください。
-
ルートユーザーの多要素認証 (MFA) を有効にします。
手順については、IAM ユーザーガイドの AWS アカウント 「ルートユーザー (コンソール) の仮想 MFA デバイスを有効にする」を参照してください。
管理アクセスを持つユーザーを作成する
-
IAM アイデンティティセンターを有効にします。
手順については、「AWS IAM Identity Center ユーザーガイド」の「AWS IAM Identity Centerの有効化」を参照してください。
-
IAM アイデンティティセンターで、ユーザーに管理アクセスを付与します。
を ID ソース IAM アイデンティティセンターディレクトリ として使用する方法のチュートリアルについては、「 AWS IAM Identity Center ユーザーガイド」の「デフォルトを使用してユーザーアクセスを設定する IAM アイデンティティセンターディレクトリ」を参照してください。
管理アクセス権を持つユーザーとしてサインインする
-
IAM アイデンティティセンターのユーザーとしてサインインするには、IAM アイデンティティセンターのユーザーの作成時に E メールアドレスに送信されたサインイン URL を使用します。
IAM Identity Center ユーザーを使用してサインインする方法については、AWS サインイン 「 ユーザーガイド」の AWS 「 アクセスポータルにサインインする」を参照してください。
追加のユーザーにアクセス権を割り当てる
IDT 用のアクセス許可を設定する
このステップでは、IDT がテストを実行して IDT 使用状況データを収集するために使用するアクセス許可を設定します。 AWS Management Console または AWS Command Line Interface (AWS CLI) を使用して IDT の IAM ポリシーとユーザーを作成し、ユーザーにポリシーをアタッチできます。
IDT 用のアクセス許可を設定するには (コンソール)
コンソールを使用して IDT for FreeRTOS 用のアクセス許可を設定するには、次の手順を実行します。
-
IAM コンソール
にサインインします。 -
特定のアクセス許可を持つロールを作成するためのアクセス許可を付与するカスタマー管理ポリシーを作成します。
-
ナビゲーションペインで ポリシーを選択してから ポリシーの作成を選択します。
-
JSON タブで、プレースホルダーコンテンツを以下のポリシーに置き換えます。
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iot-device-tester:SendMetrics" ], "Resource": "*" } ] }
-
[ポリシーの確認] を選択します。
-
[Name] (名前) に
IDTUsageMetricsIAMPermissions
と入力します。[概要] で、ポリシーによって付与されたアクセス許可を確認します。 -
[Create policy] (ポリシーの作成) を選択します。
-
-
IAM ユーザーを作成し、ユーザーにアクセス許可をアタッチします。
アクセス権限を付与するにはユーザー、グループ、またはロールにアクセス許可を追加します。
-
以下のユーザーとグループ AWS IAM Identity Center:
アクセス許可セットを作成します。「AWS IAM Identity Center ユーザーガイド」の「権限設定を作成する」の手順に従ってください。
-
IAM 内で、ID プロバイダーによって管理されているユーザー:
ID フェデレーションのロールを作成します。詳細については「IAM ユーザーガイド」の「サードパーティー ID プロバイダー (フェデレーション) 用のロールを作成する」を参照してください。
-
IAM ユーザー:
-
ユーザーが担当できるロールを作成します。手順については「IAM ユーザーガイド」の「IAM ユーザーのロールの作成」を参照してください。
-
(お奨めできない方法) ポリシーをユーザーに直接アタッチするか、ユーザーをユーザーグループに追加します。詳細については「IAM ユーザーガイド」の「ユーザー (コンソール) へのアクセス権限の追加」を参照してください。
-
-
IDT 用のアクセス許可を設定するには (AWS CLI)
を使用して IDT for FreeRTOS のアクセス許可を設定するには AWS CLI 、次の手順に従います。
-
コンピュータで、まだインストールされていない場合 AWS CLI は、 をインストールして設定します。AWS Command Line Interface ユーザーガイドの AWS CLIのインストールのステップに従います。
注記
AWS CLI は、コマンドラインシェルから AWS サービスとやり取りするために使用できるオープンソースツールです。
-
IDT と FreeRTOS ロールを管理するためのアクセス許可を付与する、次のカスタマー管理ポリシーを作成します。
-
IAM ユーザーを作成し、IDT for FreeRTOS に必要なアクセス許可をアタッチします。
-
IAM ユーザーを作成します。
aws iam create-user --user-name
user-name
-
作成した
IDTUsageMetricsIAMPermissions
ポリシーを IAM ユーザーにアタッチします。コマンドのuser-name
を IAM ユーザー名に置き換え、<account-id>
を AWS アカウントの ID に置き換えます。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
この出力は安全な場所に保存してください。後でこの情報を使用して、 AWS 認証情報ファイルを設定します。
IDT に AWS 認証情報を提供する
IDT が AWS 認証情報にアクセスしてメトリクスを送信できるようにするには AWS、以下を実行します。
-
IAM ユーザーの AWS 認証情報を環境変数として、または認証情報ファイルに保存します。
-
環境変数を使用するには、次のコマンドを実行します。
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
-
-
config.json
ファイルのauth
セクションを設定します。詳細については、「(オプション) config.json の設定」を参照してください。