翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Device Advisor の詳細コンソールワークフロー
このチュートリアルでは、カスタムテストスイートを作成し、コンソールでテストするデバイスに対してテストを実行します。テストが完了したら、テスト結果と詳細ログを表示できます。
**Topics**
+ [前提条件](#da-detailed-prereqs)
+ [テストスイート定義を作成する](#device-advisor-console-create-suite)
+ [テストスイートの実行を開始する](#device-advisor-console-run-test-suite)
+ [テストスイートの実行を停止する (オプション)](#device-advisor-stop-test-run)
+ [テストスイートの実行の詳細とログを表示する](#device-advisor-console-view-logs)
+ [AWS IoT 認定レポートをダウンロードする](#device-advisor-console-qualification-report)
## 前提条件
このチュートリアルを完了するには、[モノや証明書を作成する](https://docs.aws.amazon.com/iot/latest/developerguide/device-advisor-setting-up.html#da-create-thing-certificate)必要があります。
## テストスイート定義を作成する
テストスイートスイートを作成して、デバイス用に実行して検証を実行できるようにします。
1. [AWS IoT コンソール](https://console.aws.amazon.com//iot)のナビゲーションペインで、[**Test**] (テスト)、[**Device Advisor**] の順に展開し、[**Test suites**] (テストスイート) を選択します。
![\[Device Advisor インターフェイスには、対象デバイス、長時間テストの実行、カスタムテストスイート用のテストスイートを作成するオプションがあります。\]](http://docs.aws.amazon.com/ja_jp/iot/latest/developerguide/images/da-testsuite.png)
**[Create test suite]** (テストスイートの作成) を選択します。
1. [`Use the AWS Qualification test suite`] または [`Create a new test suite`] のいずれかを選択します。
プロトコルについては、**[MQTT 3.1.1]** または **[MQTT 5]** のいずれかを選択します。
![\[テストスイートタイプ (AWS IoT Core 認定、長期、またはカスタム) とプロトコル (MQTT 3.1.1 または MQTT 5) を選択するオプションを含む「テストスイートの作成」。\]](http://docs.aws.amazon.com/ja_jp/iot/latest/developerguide/images/da-create-test-suite.png)
`Use the AWS Qualification test suite` を選択してデバイスを認定し、 AWS Partner Device Catalog に一覧表示します。このオプションを選択すると、 AWS IoT Core 認定プログラムへのデバイスの認定に必要なテストケースが事前に選択されます。テストグループおよびテストケースを追加または削除することはできません。テストスイートのプロパティを設定する必要があります。
`Create a new test suite` を選択して、カスタムテストスイートを作成および設定します。最初のテストとトラブルシューティングを行う場合は、このオプションから始めることをお勧めします。カスタムテストスイートには少なくとも 1 つのテストグループがなければならず、各テストグループには少なくとも 1 つのテストケースが必要です。このチュートリアルでは、このオプションを選択し、[**Next**] (次へ) を選択します。
![\[IoT デバイスをテストするためのテストグループとケースを含むテストスイートを作成する手順を示すテストスイートページを設定します。\]](http://docs.aws.amazon.com/ja_jp/iot/latest/developerguide/images/da-configure-test-suite.png)
1. [**Test suite properties**] (テストスイートのプロパティ) を選択します。テストスイートを作成するときに、テストスイートのプロパティを作成する必要があります。
![\[IoT デバイス機能をテストするためのテストグループを作成し、テストケースを追加するオプションを示す「テストスイートの設定」インターフェイス。\]](http://docs.aws.amazon.com/ja_jp/iot/latest/developerguide/images/da-test-suite-properties.png)
**[Test suite properties]** (テストスイートのプロパティ) で、次の情報を入力します。
+ **テストスイートの名前**: カスタム名を使用してスイートを作成できます。
+ **タイムアウト** (オプション): 現在のテストスイートの各テストケースの秒単位でのタイムアウト 。タイムアウト値を指定しない場合、デフォルト値を使用します。
+ **[Tags]** (タグ) (オプション): テストスイートにタグを追加します。
![\[Device Advisor デモスイートのテストスイート名、タイムアウト、カスタムタグを指定するフィールドを示す「テストスイートプロパティ」というタイトルのウィンドウ。\]](http://docs.aws.amazon.com/ja_jp/iot/latest/developerguide/images/da-test-suite-properties-1.png)
完了したら、[**Update properties**] (プロパティの更新) を選択します。
1. グループレベルの設定を変更するには、`Test group 1` で [**Edit**] (編集) を選択します。その後、**名前**を入力して、グループにカスタム名を付けます。
オプションで、選択したテストグループの下に秒単位で [**Timeout**] (タイムアウト) 値を入力することもできます。タイムアウト値を指定しない場合、デフォルト値を使用します。
![\[IoT デバイス機能を検証するためのテストグループとケースを作成するための「テストスイートの設定」インターフェイス。\]](http://docs.aws.amazon.com/ja_jp/iot/latest/developerguide/images/da-edit-test-group.png)
[**Done**] を選択します。
1. 使用可能ないずれかのテストケースを [**Test cases**] (テストケース) からテストグループにドラッグします。
![\[Device Advisor でテストスイートを作成するための設定インターフェイス。IoT デバイスをテストするためのテストグループとテストケースを追加するオプションがあります。\]](http://docs.aws.amazon.com/ja_jp/iot/latest/developerguide/images/da-configure-test-suite-step5.png)
1. テストグループに追加したテストケースのテストケースレベルの設定を変更するには、**[Edit]** (編集) を選択します。その後、**名前**を入力して、グループにカスタム名を付けます。
オプションで、選択したテストグループの下に秒単位で [**Timeout**] (タイムアウト) 値を入力することもできます。タイムアウト値を指定しない場合、デフォルト値を使用します。
![\[テストスイート実行のテストグループ、テストケース、タイムアウト設定、開始ポイントを設定するオプションを備えたテストスイート設定インターフェイス。\]](http://docs.aws.amazon.com/ja_jp/iot/latest/developerguide/images/da-edit-test-case.png)
[**Done**] を選択します。
**注記**
テストスイートにさらにテストグループを追加するには、[**Add test group**] (テストグループの追加) を選択します。前の手順に従って、さらにテストグループを作成して設定するか、1 つ以上のテストグループにテストケースを追加します。テストケースを選択し、目的の位置にドラッグすることによって、テストグループとテストケースを並べ替えることができます。Device Advisor は、テストグループとテストケースを定義する順序でテストを実行します。
1. [**次へ**] を選択します。
1. **ステップ 3 **で、Device Advisor がテストデバイスに代わって AWS IoT MQTT アクションを実行するために使用するデバイスロールを設定します。
**ステップ 2** で **MQTT Connect** テストケースのみを選択した場合、**[Connect]** (接続) アクションが自動的にチェックされます。このテストスイートを実行するために、デバイスロールに対してそのアクセス許可が必要になるためです。他のテストケースを選択した場合、対応する必須アクションがチェックされます。各アクションのリソース値が提供されていることを確認します。例えば、**[Connect]** (接続) アクションでは、デバイスと Device Advisor エンドポイントの接続に使用するクライアント ID を指定します。カンマを使用して値を区切ることで、複数の値を指定できます。また、ワイルドカード (\$1) 文字を使用して、プレフィックス値を指定することもできます。例えば、`MyTopic` で始まる任意のトピックで発行するためのアクセス許可を付与する場合は、リソース値として「`MyTopic*`」を指定できます。
![\[Device Advisor でテストスイートを作成するための「デバイスロールの選択」ステップ。新しいロールを作成するか、既存のロールを選択するオプションと、ロール名、アクセス許可、リソースの詳細を指定するフィールドがあります。\]](http://docs.aws.amazon.com/ja_jp/iot/latest/developerguide/images/da-connect-role.png)
以前にデバイスロールを作成していて、そのロールを使用する場合は、**[Select an existing role]** (既存のロールを選択) を選択し、**[Select role]** (ロールを選択) でデバイスロールを選択します。
![\[Device Advisor テスト用のデバイスロールを選択するページ。新しいロールを作成するか、既存のロールを選択するオプションがあります。\]](http://docs.aws.amazon.com/ja_jp/iot/latest/developerguide/images/da-existing-role.png)
提供されている 2 つのオプションのいずれかを使用してデバイスロールを設定し、**[Next]** (次へ) をクリックします。
1. **ステップ 4** では、各ステップで指定した設定が正確であることを確認します。特定のステップの指定した設定を編集するには、対応するステップの **[Edit]** (編集) を選択します。
設定を確認したら、**[Create Test Suite]** (テストスイートの作成) を選択します。
テストスイートが正常に作成され、作成されたすべてのテストスイートを表示できる [**Test suites**] (テストスイート) ページにリダイレクトされます。
テストスイートの作成に失敗した場合は、テストスイート、テストグループ、テストケース、およびデバイスロールが、前述の指示に従って設定されていることを確認します。
## テストスイートの実行を開始する
1. [AWS IoT コンソール](https://console.aws.amazon.com//iot)のナビゲーションペインで、[**Test**] (テスト)、[**Device Advisor**] の順に展開し、[**Test suites**] (テストスイート) を選択します。
1. テストスイートの詳細を表示するテストスイートを選択します。
![\[2021 年 5 月 11 日に作成された「デバイスアドバイザーデモスイート」という名前の単一のテストスイートを示すコンソール。\]](http://docs.aws.amazon.com/ja_jp/iot/latest/developerguide/images/da-test-suites.png)
テストスイートの詳細ページには、テストスイートに関連するすべての情報が表示されます。
1. [**Actions**] (アクション)、[**Run test suite**] (テストスイートの実行) の順に選択します。
![\[[テストスイートを実行する] ボタンと、以前のテストスイートの実行がないことを示す空のアクティビティログを含むデモスイートページ。\]](http://docs.aws.amazon.com/ja_jp/iot/latest/developerguide/images/da-run-test-suites.png)
1. **実行設定**で、Device Advisor を使用してテストする AWS IoT モノまたは証明書を選択する必要があります。既存のモノや証明書がない場合は、まず[AWS IoT Core リソースを作成します](device-advisor-setting-up.md)。
**[Test endpoint]** (テストエンドポイント) セクションで、ケースに最適なエンドポイントを選択します。将来、同じ AWS アカウントを使用して複数のテストスイートを同時に実行する予定がある場合は、**デバイスレベルのエンドポイント**を選択します。別の方法として、一度に 1 つのテストスイートのみを実行する場合は、**[Account-level endpoint]** (アカウントレベルのエンドポイント) を選択します。
選択した Device Advisor のテストエンドポイントでテストデバイスを設定します。
モノまたは証明書を選択し、Device Advisor エンドポイントを選択したら、**[Run test]** (テストの実行) を選択します。
![\[でテストスイートを実行するための設定。テストデバイス (モノまたは証明書) の選択 AWS IoT Core、テストエンドポイント (アカウントレベルまたはデバイスレベル) の選択、オプションでタグの追加ができます。\]](http://docs.aws.amazon.com/ja_jp/iot/latest/developerguide/images/da-choose-thing-certificate.png)
1. テスト実行の詳細を表示するには、上部にあるバナーの [**Go to results**] (結果に移動) を選択します。
![\[ステータスが「保留中」で進行中の「デバイスアドバイザーデモスイート」というタイトルのカスタムテストスイートの詳細。\]](http://docs.aws.amazon.com/ja_jp/iot/latest/developerguide/images/da-test-run-results.png)
## テストスイートの実行を停止する (オプション)
1. [AWS IoT コンソール](https://console.aws.amazon.com//iot)のナビゲーションペインで、[**Test**] (テスト)、[**Device Advisor**] の順に展開し、[**Test runs and results**] (テストの実行と結果) を選択します。
1. 停止する進行中のテストスイートを選択します。
![\[Device Advisor コンソールでのテスト実行の結果。\]](http://docs.aws.amazon.com/ja_jp/iot/latest/developerguide/images/da-test-suite-to-stop.PNG)
1. [**Actions**] (アクション)、[**Stop test suite**] (テストスイートを停止) の順に選択します。
![\[Device Advisor コンソールでのテスト実行の結果。\]](http://docs.aws.amazon.com/ja_jp/iot/latest/developerguide/images/da-stop-test-suite.PNG)
1. このクリーンアップ処理は完了までに数分かかります。クリーンアップ処理の実行中、テストの実行ステータスは `STOPPING` になります。クリーンアップ処理が完了し、テストスイートのステータスが `STOPPED` ステータスに変わった後に、新しいスイートの実行を開始します。
![\[Device Advisor コンソールでのテスト実行の停止結果。\]](http://docs.aws.amazon.com/ja_jp/iot/latest/developerguide/images/da-stopped-test-suite.PNG)
## テストスイートの実行の詳細とログを表示する
1. [AWS IoT コンソール](https://console.aws.amazon.com//iot)のナビゲーションペインで、[**Test**] (テスト)、[**Device Advisor**] の順に展開し、[**Test runs and results**.] (テストの実行と結果) を選択します。
このページが表示されます。
+ IoT モノの数
+ IoT 証明書の数
+ 現在実行中のテストスイートの数
+ 作成されたすべてのテストスイートの実行
1. 実行の詳細とログを表示するテストスイートを選択します。
![\[テスト実行と結果セクションには、現在進行中の「Device Advisor でもスイート」という名前のテストスイートの詳細が表示されます。\]](http://docs.aws.amazon.com/ja_jp/iot/latest/developerguide/images/da-test-suite-run.png)
実行の概要のページには、現在のテストスイート実行のステータスが表示されます。このページは 10 秒ごとに自動更新されます。1～2 分間、デバイスが 5 秒ごとにテストエンドポイントへの接続を試行するメカニズムを構築することをお勧めします。その後、自動化された方法で順番に複数のテストケースを実行できます。
![\[システムメッセージが表示されずに MQTT Connect テストが成功したことを示すテストケースログ。\]](http://docs.aws.amazon.com/ja_jp/iot/latest/developerguide/images/da-run-summary.png)
1. テストスイート実行の CloudWatch ログにアクセスするには、[**Test suite log**] (テストスイートログ) を選択します。
テストケースの CloudWatch ログにアクセスするには、[**Test case log**] (テストケースログ) を選択します。
1. テスト結果に基づいて、すべてのテストに合格するまでデバイスの[トラブルシューティング](https://docs.aws.amazon.com/iot/latest/developerguide/iot_troubleshooting.html#device-advisor-troubleshooting)を行います。
## AWS IoT 認定レポートをダウンロードする
テスト**スイートの作成時に AWS IoT 認定テストスイートの使用**オプションを選択し、認定テストスイートを実行できた場合は、テスト実行の概要ページで認定レポート**のダウンロードを選択して認定レポートを**ダウンロードできます。
![\[MQTT、TLS、およびその他のコンポーネントのテストに合格したことを示す認定プログラムテスト結果。\]](http://docs.aws.amazon.com/ja_jp/iot/latest/developerguide/images/da-qualification-report.png)