View a markdown version of this page

アプリケーションコンテキストの更新 - AWS Well-Architected
コンソールCLI

AWS Well-Architected Agent はプレビューリリースにあり、変更される可能性があります。

アプリケーションコンテキストの更新

アプリケーションコンテキストは、アプリケーションの説明、実行する処理、および実行されるインフラストラクチャを AWS WA Agent に伝えます。AWS WA Agent はこの情報を使用して、各アプリケーションに属するリソースに推奨事項の範囲を限定し、アーキテクチャ、重要度、および制約に基づいてガイダンスをパーソナライズします。

より多くのコンテキストを指定するほど、推奨事項はより的を絞ったものとなります。アプリケーションの概要、アーキテクチャの説明、重要度レベル、およびリソースタグをプロファイルに含めると、汎用的な推奨事項ではなく、特定の環境と優先順位を考慮した推奨事項が生成されます。

重要

スケジュールされた推奨事項を生成するには、プロファイルごとに少なくとも 1 つのアプリケーションコンテキストを定義する必要があります。

アプリケーションコンテキストを定義するときは、次のガイドラインに従ってください。

  • リソースやチームごとではなく、論理アプリケーションごとに 1 つのコンテキストエントリを作成します。例えば、複数のサービスにまたがる注文処理システムがある場合は、単一のアプリケーションコンテキストとして定義します。

  • 重要度レベルを設定します。これは推奨事項の優先順位付けに直接影響します。ミッションクリティカルなアプリケーションは、テストまたは開発ワークロードよりも優先順位の高い検出結果を受け取ります。

  • リソースタグを使用してアプリケーションの範囲を限定します。複数のアプリケーションが同じアカウントを共有する場合、タグにより、AWS WA Agent はどのリソースがどのアプリケーションに属しているかを区別できます。

コンソール

アプリケーションコンテキストを追加するには

  1. 左側のナビゲーションで [エージェントプロファイル] を選択します。次に、アプリケーションコンテキストを追加するプロファイルで、[プロファイルの詳細] を選択します。

  2. [アプリケーションコンテキスト] タブを選択します。次に、[アプリケーションコンテキストの追加] を選択します。

  3. アプリケーションの詳細を入力します。追加のカスタマイズを行うには、[その他の詳細] ドロップダウンを展開します。

    アプリケーションコンテキストには、次のフィールドが含まれます。

    • アプリケーション名: アプリケーションの名前。

    • アプリケーションの概要: アプリケーションによる処理の概要。

    • このアプリケーションのアカウント: このアプリケーションに含まれるか、このアプリケーションで使用される AWS アカウント。

    • リージョン: このアプリケーションが存在または動作する AWS リージョン。

    • タグ: このアプリケーションに含まれるキーと値のペア。タグには、選択に応じて 2 つの異なるフィルタリング動作があります。

      • タグのみを選択: 選択した AWS アカウントまたは AWS リージョン内でそのタグ (および任意のタイプのタグ) を持つすべてのリソースが含まれます。

      • タグと共にサービスまたはリソースタイプを選択: タグと、サービスまたはリソースの両方の条件を満たすもの表示します。フィルタで返されるすべてのリソースには、選択したタグがあり、選択したいずれかのサービスまたはリソースタイプの一部である必要があります。

    • その他の詳細:

      • サービス: アプリケーションが使用するサービス。サービスを選択すると、すべての関連リソースが自動的に選択されます。

        注記

        アプリケーションコンテキストでサービスを追加または更新する場合は、CloudFormation の正規サービス名を使用してください。例えば、AWS::DynamoDB::Table CloudFormation の場合、サービス名は DynamoDB です。

      • リソース: サービスのドロップダウンに自動的に含まれているリソースの外部でアプリケーションが使用する、追加のリソース。一部のリソースタイプはサポートされていません。詳細については、「サポートされていないリソースタイプ」を参照してください。

      • 業界: アプリケーションの対象となる業界。

      • タイプ: アプリケーションのタイプ。

      • 重要度: 組織におけるこのアプリケーションの重要度。

      • アーキテクチャの概要: プレーンテキストで書かれたアーキテクチャの概要。

      • 追加のコンテキスト: AWS WA Agent がレビューと推奨事項で考慮する追加のコンテキスト。

  4. コンテキストを入力したら、[アプリケーションを追加] を選択します。[すべてのアプリケーション] リストに新しいアプリケーションのコンテキストが表示されます。

  5. アプリケーションコンテキストを追加した後、この新しいコンテキストに基づいてスケジュールされた推奨事項が生成されるまでに、最大 24 時間かかる場合があります。

CLI

アプリケーションコンテキストを追加するには:

aws wellarchitected create-agent-context \
    --profile-arn "profile-arn" \
    --title "My application" \
    --context-type APPLICATION \
    --content '{"applicationOverview":"Description","criticality":"MISSION_CRITICAL"}'
注記

アプリケーションコンテキストでサービスを追加または更新する場合は、CloudFormation の正規サービス名を使用してください。例えば、AWS::DynamoDB::Table CloudFormation の場合、サービス名は DynamoDB です。

既存のアプリケーションコンテキストを更新するには:

aws wellarchitected update-agent-context \
    --profile-arn "profile-arn" \
    --context-id "context-id" \
    --title "Updated application name" \
    --content '{"applicationOverview":"Updated description"}'

アプリケーションコンテキストを削除するには:

aws wellarchitected delete-agent-context \
    --profile-arn "profile-arn" \
    --context-id "context-id"