サポート終了通知: 2026 年 10 月 7 日、 AWS はサポートを終了します AWS IoT Greengrass Version 1。2026 年 10 月 7 日以降、 AWS IoT Greengrass V1 リソースにアクセスできなくなります。詳細については、[「 からの移行 AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html)」を参照してください。 翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # AWS IoT Greengrass トラブルシューティング用の IDT IDT for は、エラーのタイプに基づいてこれらのエラーをさまざまな場所に AWS IoT Greengrass 書き込みます。エラーは、コンソール、ログファイル、およびテストレポートに書き込まれます。 ## エラーコード IDT for AWS IoT Greengrassによって生成されたエラーコードを次の表に示します。 | エラーコード | エラーコード名 | 考えられる根本原因 | トラブルシューティング | | --- | --- | --- | --- | | 101 | InternalError | 内部エラーが発生しました。 | `{{}}/results` ディレクトリの下のログを確認します。問題をデバッグできない場合は、[AWS 開発者サポート](https://aws.amazon.com/premiumsupport/plans/developers/)にお問い合わせください。 | | 102 | TimeoutError | 制限された時間範囲にテストを完了することができません。これは、次の場合に発生する可能性があります。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/greengrass/v1/developerguide/idt-troubleshooting.html) | [See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/greengrass/v1/developerguide/idt-troubleshooting.html) | | 103 | PlatformNotSupportError | `device.json` に誤った OS/アーキテクチャの組み合わせが指定されています。 | サポートされている組み合わせのいずれかに設定を変更してください。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/greengrass/v1/developerguide/idt-troubleshooting.html)
詳細については、「[device.json の設定](set-config.md#device-config)」を参照してください。 | | 104 | VersionNotSupportError | AWS IoT Greengrass Core ソフトウェアバージョンは、使用している IDT のバージョンではサポートされていません。 | **device\_tester\_bin version** コマンドを使用して、サポートされているバージョンの AWS IoT Greengrass Core ソフトウェアを検索します。たとえば、macOS を使用している場合は、**./devicetester\_mac\_x86\_64 version** を使用します。
使用している AWS IoT Greengrass Core ソフトウェアのバージョンを確認するには:[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/greengrass/v1/developerguide/idt-troubleshooting.html)
AWS IoT Greengrass Core ソフトウェアの別のバージョンをテストできます。詳細については、「[の開始方法 AWS IoT Greengrass](gg-gs.md)」を参照してください。 | | 105 | LanguageNotSupportError | IDT は、 AWS IoT Greengrass ライブラリと SDKsのみ Python をサポートしています。 | 次のことを確認してください。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/greengrass/v1/developerguide/idt-troubleshooting.html) | | 106 | ValidationError | `device.json` または `config.json` の一部のフィールドが無効です。 | レポートのエラーコードの右側にあるエラーメッセージを確認します。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/greengrass/v1/developerguide/idt-troubleshooting.html) | | 107 | SSHConnectionFailed | テストマシンが設定されたデバイスに接続できません。 | `device.json` ファイルの以下のフィールドが正しいことを確認します。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/greengrass/v1/developerguide/idt-troubleshooting.html)
詳細については、「[device.json の設定](set-config.md#device-config)」を参照してください。 | | 108 | RunCommandError | テストでテスト対象デバイスでのコマンドを実行できませんでした。 | root アクセスが `device.json` 内の設定済みユーザーに許可されていることを確認します。
root アクセスでコマンドを実行するとき、一部のデバイスではパスワードが必要です。ルートアクセスが、パスワードを使わずに許可されることを確認します。詳細については、デバイスのドキュメントを参照してください。
失敗したコマンドをデバイスで手動で実行して、エラーが発生するかどうかを確認します。 | | 109 | PermissionDeniedError | ルートアクセスがありません。 | デバイス上で設定されたユーザーに root アクセスを設定します。 | | 110 | CreateFileError | ファイルを作成できません。 | デバイスのディスク容量とディレクトリのアクセス許可を確認します。 | | 111 | CreateDirError | ディレクトリを作成できません。 | デバイスのディスク容量とディレクトリのアクセス許可を確認します。 | | 112 | InvalidPathError | AWS IoT Greengrass Core ソフトウェアへのパスが正しくありません。 | エラーメッセージのパスが有効であることを確認します。`devicetester_greengrass_{{}}` ディレクトリのファイルを編集しないでください。 | | 113 | InvalidFileError | ファイル名が無効です。 | エラーメッセージのファイルが有効であることを確認します。 | | 114 | ReadFileError | 指定されたファイルを読み取ることができません。 | 以下について確認します。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/greengrass/v1/developerguide/idt-troubleshooting.html)
macOS でテストしている場合は、開くファイルの制限を増やします。デフォルトの制限は 256 で、テストには十分です。 | | 115 | FileNotFoundError | 必要なファイルが見つかりませんでした。 | 以下について確認します。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/greengrass/v1/developerguide/idt-troubleshooting.html) | | 116 | OpenFileFailed | 指定されたファイルを開くことができません。 | 以下について確認します。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/greengrass/v1/developerguide/idt-troubleshooting.html)
macOS でテストしている場合は、開くファイルの制限を増やします。デフォルトの制限は 256 で、テストには十分です。 | | 117 | WriteFileFailed | ファイルの書き込みに失敗しました (DUT またはテストマシンの可能性があります)。 | エラーメッセージで示されたディレクトリが存在し、書き込みアクセス許可があることを確認します。 | | 118 | FileCleanUpError | テストで、指定されたファイルまたはディレクトリを削除すること、またはリモートデバイス上の指定されたファイルをマウント解除することに失敗しました。 | バイナリファイルがまだ実行されている場合は、ファイルはロックされている可能性があります。プロセスを終了し、指定したファイルを削除します。 | | 119 | InvalidInputError | 設定が無効です。 | `suite.json` ファイルが有効であることを確認します。 | | 120 | InvalidCredentialError | AWS 認証情報が無効です。 | [See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/greengrass/v1/developerguide/idt-troubleshooting.html) | | 121 | AWSSessionError | AWS セッションの作成に失敗しました。 | このエラーは、 AWS 認証情報が無効であるか、インターネット接続が不安定である場合に発生する可能性があります。を使用して AWS API オペレーションを呼び出し AWS CLI ます。 | | 122 | AWSApiCallError | AWS API エラーが発生しました。 | このエラーは、ネットワークの問題が原因と考えられます。テストグループを再試行する前にネットワークを確認してください。 | | 123 | IpNotExistError | IP アドレスは接続情報に含まれていません。 | インターネット接続を確認してください。 AWS IoT Greengrass コンソールを使用して、テストで使用されている AWS IoT Greengrass コアモノの接続情報を確認できます。接続情報に 10 個のエンドポイントが含まれている場合は、その一部または全部を削除してテストを再実行できます。詳細については、「[接続情報](https://docs.aws.amazon.com/cli/latest/reference/greengrass/get-connectivity-info.html)」を参照してください。 | | 124 | OTAJobNotCompleteError | OTA ジョブを完了できませんでした。 | インターネット接続を確認して OTA テストグループを再実行します。 | | 125 | CreateGreengrassServiceRoleError | 以下のいずれかが発生しました。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/greengrass/v1/developerguide/idt-troubleshooting.html) | AWS IoT Greengrass サービスロールを設定します。詳細については、「[Greengrass サービスロール](service-role.md)」を参照してください。 | | 126 | DependenciesNotPresentError | 特定のテストに必要な 1 つ以上の依存関係がデバイスに存在しません。 | テストログ (`{{}}/results/{{}}/logs/{{}}`) を調べて、デバイスに欠落している依存関係を確認します。 | | 127 | InvalidHSMConfiguration | 指定された HSM/PKCS 設定が正しくありません。 | `device.json` ファイルで、PKCS\#11 を使用して HSM とやり取りするために必要な正しい設定を指定します。 | | 128 | OTAJobNotSuccededError | OTA ジョブは成功しませんでした。 | [See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/greengrass/v1/developerguide/idt-troubleshooting.html) | | 129 | NoConnectivityError | ホストエージェントがインターネットに接続できません。 | ネットワーク接続とファイアウォールの設定を確認します。接続の問題が解決したら、テストグループを再試行します。 | | 130 | NoPermissionError | IDT for の実行に使用している IAM ユーザーには、IDT の実行に必要な AWS リソースを作成するアクセス許可 AWS IoT Greengrass がありません。 | IDT for AWS IoT Greengrassの実行に必要な許可を付与するポリシーテンプレートについては、「[アクセス許可ポリシーテンプレート](https://docs.aws.amazon.com/greengrass/latest/developerguide/policy-template.html)」を参照してください。 | | 131 | LeftoverAgentExistError | IDT を開始しようとしたときに、デバイスが AWS IoT Greengrass プロセスを実行しています AWS IoT Greengrass。 | デバイスで実行されている既存の Greengrass デーモンがないことを確認します。[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/greengrass/v1/developerguide/idt-troubleshooting.html) 再起動後に自動的に起動するように AWS IoT Greengrass 設定された の既存のインストールを使用している場合は、再起動後およびテストスイートを実行する前にデーモンを停止する必要があります。 | | 132 | DeviceTimeOffsetError | デバイスの時刻が正しくありません。 | デバイスの時刻を正しく設定します。 | | 133 | InvalidMLConfiguration | 指定された ML 設定が正しくありません。 | `device.json` ファイルに、ML 推論テストの実行に必要な正しい設定を指定します。詳細については、「[オプション: ML 認定のためのデバイスの設定](idt-ml-qualification.md)」を参照してください。 | ## AWS IoT Greengrass エラーの IDT の解決 IDT を使用する場合は、IDT for を実行する前に正しい設定ファイルを用意する必要があります AWS IoT Greengrass。解析エラーや設定エラーが発生する場合は、まず環境に適した設定テンプレートを見つけて使用します。 それでも問題が解決されない場合は、次のデバッグプロセスを参照してください。 **Topics** + [エラーをどこで探せばよいか](#where-to-look) + [解析エラー](#parse-error) + [必須パラメータが見つからないエラー](#param-missing) + [テストを開始できなかったエラー](#could-not-start-test) + [リソースにアクセスする権限がないエラー](#not-authorized-to-access-resource) + [アクセス拒否エラー](#pwd-sudo) + [SSH 接続エラー](#ssh-connect-errors) + [タイムアウトエラー](#test-timeout) + [コマンドが見つからないエラーがテスト中に発生する](#cmd-not-found) + [macOS でのセキュリティ例外](#macos-notarization-exception) ### エラーをどこで探せばよいか 実行中にエラーの概要がコンソールに表示され、テストがすべて完了すると、失敗したテストの概要とエラーが表示されます。`awsiotdevicetester_report.xml` には、テストが失敗する原因となったすべてのエラーの概要が含まれます。テスト実行ごとのログファイルは、テスト実行中にコンソールに表示されたテスト実行用の UUID という名前のディレクトリに保存されます。 テストログのディレクトリは、`{{}}/results/{{}}/logs/` にあります。このディレクトリには、デバッグに役立つ次のファイルが含まれています。 | システム | 説明 | | --- | --- | | test\_manager.log | テスト実行中にコンソールに書き込まれたすべてのログ。結果の概要はこのファイルの最後にあり、失敗したテストのリストが含まれます。
失敗に関する情報は、このファイルの警告ログとエラーログで確認できます。 | | {{}}\_\_{{}}.log | 特定のテストの詳細なログ。 | | {{}}\_ggc\_logs.tar.gz | テスト中に AWS IoT Greengrass コアデーモンが生成したすべてのログの圧縮されたコレクション。詳細については、「[トラブルシューティング AWS IoT Greengrass](https://docs.aws.amazon.com/greengrass/latest/developerguide/gg-troubleshooting.html)」を参照してください。 | | {{}}\_ota\_logs.tar.gz | テスト中に AWS IoT Greengrass OTA エージェントによって生成されたログの圧縮コレクション。OTA テストのみ。 | | {{}}\_basic\_assertion\_publisher\_ggad\_logs.tar.gz | テスト中に AWS IoT 発行者デバイスによって生成されたログの圧縮されたコレクションです。 | | {{}}\_basic\_assertion\_subscriber\_ggad\_logs.tar.gz | テスト中に AWS IoT サブスクライバーデバイスによって生成されたログの圧縮されたコレクションです。 | ### 解析エラー 場合によっては、JSON 設定のタイプミスが解析エラーにつながることがあります。ほとんどの場合、JSON ファイルで括弧やカンマ、引用符を忘れたことが原因です。IDT は、JSON 検証を行い、デバッグ情報を出力します。エラーが発生した行、構文エラーの行番号と列番号が出力されます。この情報だけでエラーの修正が可能なはずですが、それでもエラーを特定できない場合は、IDE、テキストエディタ (Atom、Sublime など)、またはオンラインツール (JSONLint など) を使って手動で検証できます。 ### 必須パラメータが見つからないエラー IDT には新機能が追加されているため、設定ファイルに変更が生じる可能性があります。古い設定ファイルを使用すると、設定が破損する可能性があります。このような場合は、`/results/{{}}/logs` にある `{{}}.log` ファイルに、すべての不足しているパラメータが明確に示されています。また、IDT では、JSON 設定ファイルのスキーマを検証し、最新のサポートされているバージョンが使用されていることを確認します。 ### テストを開始できなかったエラー テスト開始時の障害を示すエラーが発生する場合があります。考えられる原因にはさまざまなものがあるため、以下を実行します。 + 実行コマンドに含めたプール名が実際に存在することを確認します。プール名は、`device.json` ファイルから直接参照されます。 + プール内のデバイスの設定パラメータが正しいことを確認します。 ### リソースにアクセスする権限がないエラー ターミナルの出力または `/results/{{}}/logs` の `test_manager.log` ファイルに ` is not authorized to access this resource` エラーメッセージが表示される場合があります。この問題を解決するには、`AWSIoTDeviceTesterForGreengrassFullAccess` 管理ポリシーをテストユーザーにアタッチします。詳細については、「[の作成と設定 AWS アカウント](dev-tst-prereqs.md#config-aws-account-for-idt)」を参照してください。 ### アクセス拒否エラー IDT は、テスト対象デバイスのさまざまなディレクトリやファイルに対してオペレーションを実行します。一部のオペレーションにはルートアクセスが必要です。これらのオペレーションを自動化するには、パスワードを入力することなく、IDT で sudo を使用してコマンドを実行する必要があります。 パスワードを入力することなく、sudo にアクセスを許可するには、以下の手順を実行します。 **注記** `user` および `username` は、テスト対象デバイスにアクセスするために IDT で使用する SSH ユーザーを指します。 1. SSH ユーザーを sudo グループに追加するには **sudo usermod -aG sudo {{}}** を使用します。 1. サインアウトし、再度サインインして、変更を反映します。 1. `/etc/sudoers` ファイルを開き、ファイルの末尾に次の行を追加します: `{{}} ALL=(ALL) NOPASSWD: ALL` **注記** ベストプラクティスとして、`/etc/sudoers` を編集するときは **sudo visudo** を使用することをお勧めします。 ### SSH 接続エラー IDT からテスト対象デバイスに接続できない場合は、接続エラーのログが `/results/{{}}/logs/{{}}.log` に記録されます。SSH エラーに関するメッセージは、このログファイルの上部に表示されます。テスト対象デバイスへの接続は IDT が実行する最初のオペレーションの 1 つであるためです。 ほとんどの Windows セットアップでは、PuTTy ターミナルアプリケーションを使用して Linux ホストに接続します。このアプリケーションは、標準 PEM プライベートキーファイルを PPK と呼ばれる独自の Windows 形式に変換することを要求します。IDT を `device.json` ファイルで設定する場合は、PEM ファイルのみを使用します。PPK ファイルを使用する場合、IDT は AWS IoT Greengrass デバイスとの SSH 接続を作成できず、テストを実行できません。 ### タイムアウトエラー 各テストのタイムアウトを長くするには、タイムアウト乗数を指定します。この値は、各テストのタイムアウトのデフォルト値に適用されます。このフラグに設定された値はすべて、1.0 以上である必要があります。 タイムアウトの乗数を使用するには、テストの実行時に `--timeout-multiplier` フラグを使用します。例: ``` ./devicetester_linux run-suite --suite-id GGQ_1.0.0 --pool-id DevicePool1 --timeout-multiplier 2.5 ``` 詳細については、`run-suite --help` を実行してください。 ### コマンドが見つからないエラーがテスト中に発生する AWS IoT Greengrass デバイスでテストを実行するには、古いバージョンの OpenSSL ライブラリ (libssl1.0.0) が必要です。通常、現在の Linux ディストリビューションでは、libssl バージョン 1.0.2 以降 (v1.1.0) を使用しています。 たとえば、Raspberry Pi で必要なバージョンの libssl をインストールするには、以下のコマンドを実行します。 1. ``` wget http://ftp.us.debian.org/debian/pool/main/o/openssl/libssl1.0.0_1.0.2l-1~bpo8+1_armhf.deb ``` 1. ``` sudo dpkg -i libssl1.0.0_1.0.2l-1~bpo8+1_armhf.deb ``` ### macOS でのセキュリティ例外 macOS 10.15 を使用するホストマシンで IDT を実行すると、IDT の認証チケットが正しく検出されず、IDT の実行がブロックされます。IDT を実行するには、セキュリティ例外を `devicetester_mac_x86-64` 実行可能ファイルに付与する必要があります。 **セキュリティ例外を IDT 実行可能ファイルに付与するには** 1. [Apple] メニューから **[System Preferences]** (システム環境設定) を選択します。 1. **[Security & Privacy]** (セキュリティとプライバシー) を選択し、**[General]** (一般) タブでロックアイコンをクリックして、セキュリティ設定を変更します。 1. メッセージ `"devicetester_mac_x86-64" was blocked from use because it is not from an identified developer.` を選択して、**[Allow Anyway]** (すべてのアプリケーションを許可) を選択します。 1. セキュリティ警告を受け入れます。 IDT サポートポリシーについてご質問がある場合は、[AWS カスタマーサポート](https://aws.amazon.com/contact-us/)までお問い合わせください。