View a markdown version of this page

IDT 使用状況メトリクス - AWS IoT Greengrass
AWS 認証情報を設定するIDT に AWS 認証情報を提供する

サポート終了通知: 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 は次のような情報を収集します。

  • AWS アカウント IDT の実行に使用される 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) を使用して IDT の IAM ポリシーとユーザーを作成し、ユーザーにポリシーをアタッチできます。

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. [Next: Tags (次へ: タグ)] を選択します。

    4. [次へ: レビュー] を選択します。

    5. [名前] にIDTUsageMetricsIAMPermissionsと入力してください。[概要] で、ポリシーによって付与されたアクセス許可を確認します。

    6. [Create policy] (ポリシーの作成) を選択します。

  3. IAM ユーザーを作成し、ユーザーにアクセス許可をアタッチします。

    1. IAM ユーザーを作成します。IAM ユーザーガイドの IAM ユーザーの作成 (コンソール) のステップ 1 ～ 5 に従います。IAM ユーザーを作成済みの場合は、次のステップに進んでください。

    2. アクセス許可を IAM ユーザーにアタッチします。

      1. [Set permissions] (許可を設定) ページで、[Attach existing policies directly] (既存のポリシーを直接アタッチする) を選択します。

      2. 前のステップで作成した IDTGreengrassIAMPermissions ポリシーを検索します。チェックボックスをオンにします。

    3. [Next: Tags] (次へ: タグ) を選択します。

    4. [Next: Review] (次へ: レビュー) を選択して、選択内容の概要を表示します。

    5. [ユーザーの作成] を選択します。

    6. ユーザーのアクセスキー (アクセスキー ID とシークレットアクセスキー) を表示するには、パスワードとアクセスキーの横にある [Show (表示)] を選択します。アクセスキーを保存するには、[Download .csv] を選択し、安全な場所にファイルを保存します。後でこの情報を使用して認証情報 AWS ファイルを設定します。

 

IDT 用のアクセス許可を設定するには (AWS CLI)

を使用して IDT for のアクセス許可を設定するには AWS CLI 、次の手順に従います AWS IoT Greengrass。コンソールでアクセス許可をすでに設定している場合は、「IDT テストを実行するようにデバイスを設定する」または「オプション: IDT for の Docker コンテナの設定 AWS IoT Greengrass」に進みます。

  1. コンピュータで、まだインストール AWS CLI されていない場合は、 をインストールして設定します。AWS Command Line Interface ユーザーガイドの AWS CLIのインストールのステップに従います。

    注記

    AWS CLI は、コマンドラインシェルから 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": \"*\"}]}'
    注記

    このステップには、Linux、macOS、または Unix のターミナルコマンドとは異なる JSON 構文を使用するため、Windows コマンドプロンプトの例が含まれています。

  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> を AWS アカウントの ID に置き換えます。

      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 ファイルを設定します。

IDT に AWS 認証情報を提供する

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 の設定」を参照してください。