• AWS Systems Manager CloudWatch ダッシュボードは、2026 年 4 月 30 日以降は利用できなくなります。お客様は、これまでと同様に Amazon CloudWatch コンソールを使用して、Amazon CloudWatch ダッシュボードの表示、作成、管理を継続できます。詳細については、「[Amazon CloudWatch ダッシュボードのドキュメント](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)」を参照してください。
# AWS Systems Manager Distributor のトラブルシューティング
次の情報は、AWS Systems Manager のツールである Distributor を使用するときに発生する可能性のある問題の、トラブルシューティングに役立ちます。
**Topics**
+ [同じ名前の間違ったパッケージがインストールされている](#distributor-tshoot-1)
+ [エラー: マニフェストの取得に失敗しました: 最新バージョンのパッケージが見つかりませんでした](#distributor-tshoot-2)
+ [エラー: マニフェストの取得に失敗しました: 検証例外](#distributor-tshoot-3)
+ [パッケージはサポートされていません (パッケージのインストールアクションがありません)](#distributor-tshoot-4)
+ [エラー: マニフェストのダウンロードに失敗しました: その名前のドキュメントは存在しません](#distributor-tshoot-5)
+ [アップロード失敗](#distributor-tshoot-6)
+ [エラー: プラットフォームが見つかりませんでした: プラットフォームのマニフェストが見つかりません: oracle、バージョン 8.9、アーキテクチャ x86\_64](#distributor-tshoot-7)
## 同じ名前の間違ったパッケージがインストールされている
**問題:** パッケージをインストールしましたが、Distributor は別のパッケージをインストールしました。
**原因**: Systems Manager が、インストール中に、結果としてユーザー定義の外部パッケージよりも先に AWS 公開パッケージを検索します。ユーザー定義のパッケージ名が AWS で公開されたパッケージ名と同じ場合、パッケージの代わりに AWS パッケージがインストールされます。
**解決策**: この問題を回避するには、パッケージに AWS で公開されたパッケージの名前とは異なる名前を付けます。
## エラー: マニフェストの取得に失敗しました: 最新バージョンのパッケージが見つかりませんでした
**問題:** 次のようなエラーが発生しました。
```
Failed to retrieve manifest: ResourceNotFoundException: Could not find the latest version of package
arn:aws:ssm:::package/{{package-name}} status code: 400, request id: {{guid}}
```
**原因:** バージョン 2.3.274.0 より前の Distributor で SSM Agent のバージョンを使用しています。
**解決策:** SSM Agent バージョンを 2.3.274.0 以降のバージョンに更新します。詳細については、「[Run Command を使用して SSM Agent を更新する](run-command-tutorial-update-software.md#rc-console-agentexample)」または「[チュートリアル: AWS CLI で SSM Agent を自動的に更新する](state-manager-update-ssm-agent-cli.md)」を参照してください。
## エラー: マニフェストの取得に失敗しました: 検証例外
**問題:** 次のようなエラーが発生しました。
```
Failed to retrieve manifest: ValidationException: 1 validation error detected: Value 'documentArn'
at 'packageName' failed to satisfy constraint: Member must satisfy regular expression pattern:
arn:aws:ssm:{{region-id}}:{{account-id}}:package/{{package-name}}
```
**原因:** バージョン 2.3.274.0 より前の Distributor で SSM Agent のバージョンを使用しています。
**解決策:** SSM Agent バージョンを 2.3.274.0 以降のバージョンに更新します。詳細については、「[Run Command を使用して SSM Agent を更新する](run-command-tutorial-update-software.md#rc-console-agentexample)」または「[チュートリアル: AWS CLI で SSM Agent を自動的に更新する](state-manager-update-ssm-agent-cli.md)」を参照してください。
## パッケージはサポートされていません (パッケージのインストールアクションがありません)
**問題:** 次のようなエラーが発生しました。
```
Package is not supported (package is missing install action)
```
**原因:** パッケージディレクトリ構造が正しくありません。
**解決方法:** ソフトウェアと必要なスクリプトを含む親ディレクトリを zip 圧縮しないでください。代わりに、必要なすべてのコンテンツの `.zip` ファイルを絶対パスに直接作成します。`.zip` ファイルが正しく作成されたことを検証するには、ターゲットプラットフォームディレクトリを解凍し、ディレクトリ構造を確認します。例えば、インストールスクリプトの絶対パスは `/{{ExamplePackage_targetPlatform}}/install.sh` である必要があります。
## エラー: マニフェストのダウンロードに失敗しました: その名前のドキュメントは存在しません
**問題:** 次のようなエラーが発生しました。
```
Failed to download manifest - failed to retrieve package document description: InvalidDocument: Document with name {{filename}} does not exist.
```
**原因 1:** Distributor は別のアカウントからの Distributor パッケージを共有する場合、パッケージ名でパッケージを見つけることはできません。
**解決策 1**: 別のアカウントからパッケージを共有する場合は、パッケージの名前だけでなく、完全な Amazon リソースネーム (ARN) を使用します。
**原因 2:** VPC を使用するとき、ターゲットとする AWS リージョンのドキュメント `AWS-ConfigureAWSPackage` を含む AWS マネージド S3 バケットへのアクセス権を、IAM インスタンスプロファイルに付与しませんでした。
**解決策 2:** 「[SSM Agent と AWS マネージド S3 バケットとの通信](ssm-agent-technical-details.md#ssm-agent-minimum-s3-permissions)」で説明されているように、IAM インスタンスプロファイルが、ターゲットとする AWS リージョンのドキュメント `AWS-ConfigureAWSPackage` 含む AWS マネージド S3 バケットへのアクセス権を、SSM Agent に付与していることを確認します。
## アップロード失敗
**問題:** 次のようなエラーが発生しました。
```
Upload failed. At least one of your files was not successfully uploaded to your S3 bucket.
```
**原因:** ソフトウェアパッケージの名前にスペースが含まれています。例えば、`Hello World.msi` はアップロードに失敗するでしょう。
## エラー: プラットフォームが見つかりませんでした: プラットフォームのマニフェストが見つかりません: oracle、バージョン 8.9、アーキテクチャ x86\_64
**問題:** 次のようなエラーが発生しました。
```
Failed to find platform: no manifest found for platform: oracle, version 8.9, architecture x86_64
```
**原因:** エラーは、JSON パッケージマニフェストに、この場合は Oracle Linux というプラットフォームの定義がないことを意味します。
**解決策:** [Trend Micro Deep Security ソフトウェア](https://help.deepsecurity.trendmicro.com/software.html)サイトから配布するパッケージをダウンロードします。[シンプルワークフローを使用してパッケージを作成する](distributor-working-with-packages-create.md#distributor-working-with-packages-create-simple) を使用して `.rpm` ソフトウェアパッケージを作成します。パッケージに次の値を設定し、Distributor を使用してソフトウェアパッケージのアップロードを完了します。
```
Platform version: _any
Target platform: oracle
Architecture: x86_64
```