メインコンテンツへスキップ

レシピの作成と編集

このページでは、レシピを作成・編集する際のオプションについて説明します。既存のレシピを複製し、コピーをカスタマイズして新しいレシピとして保存することもできます。

ヒント

Composer を初めて利用する場合は、レシピの概要またはチュートリアル: はじめてのレシピから始めてください。既存のレシピを複製する方が、白紙のキャンバスから作成するよりも早いことがよくあります。

作成の開始

レシピを最初から作成するには、次のようにしてください。

  1. Composer ダッシュボードに移動します。

  2. Create recipe を選択して、空のキャンバスを持つ レシピビルダー を開きます。

    Composer - recipe builder: blank.

ステップ 1: 基本情報を入力する

  1. Recipe builder のサイドパネルで、Details タブ上にあるレシピの基本情報を設定します。

    • Title: レシピの名前です。条件や不足しているコントロールを表す、リソースを先頭にしたパターンを推奨します。例えば、EBS volumes with no attached instanceEC2 instances with CPU utilization below 5% for 14 daysRoot user without MFA enabled などです。Remove unused EBS volumes のような「アクション」ではなく、このような表現を使用してください。複数のリスクが 1 つのチェックを共有する場合は、リソース名と問題の種類を要約して記述してください (例: EC2 instances with multiple critical security misconfigurations)。

    • (任意) Description: 説明情報です。高度な書式設定のために Markdown 構文をサポートします。

    • Provider: サービスプロバイダです。このフィールドはデフォルトで General に設定されています。

    • Severity: このレシピによって生成されるインサイトの重大度レベルです。指定可能な値: CriticalHighMediumLow

    • Pillars: このレシピによって生成されるインサイトのカテゴリです。複数選択できます。指定可能な値: CostOperationsPerformanceSecurity。各 Pillar を使用するタイミングについては、Pillars を参照してください。

    • Group results by fields: キャンバスにリソースを追加した後、クエリーが一致したときにどのリソースに対してインサイトを発行するかを選択します。意図的な場合を除き、関連する補助リソースではなく、検出内容を表すキャンバス上のリソース (例えば EBS ボリューム) を選択してください。

    • (任意) Cost function: このフィールドを使用するには、まず Pillars フィールドで Cost を選択してください。意図した是正措置に合致するコスト関数を選択することで、コスト削減が正しく分類されます。同じリソースに一致する Cost レシピが重複していると、コスト削減の合計が過大に計上される可能性があります。指定可能な値:

      • N/A: 特定のコスト削減機能を対象にしないレシピの場合に選択します。

      • Resource deletion: 未使用または不要なリソースの削除によってコスト削減が行われる場合に使用します。

      • Extended support: リソースをより新しいバージョンにアップグレードするなど、プロバイダの拡張サポート料金を回避することでコスト削減が行われる場合に使用します。このコスト関数は、次のリソースタイプにのみ適用されます。

        • AWS: EKS Cluster、RDS Instance、ElastiCache Cluster、DocumentDB Instance、OpenSearch Domain
        • Google Cloud: GKE Cluster、Cloud SQL Instance
        • Azure: AKS Cluster、Azure Database for MySQL flexible server、Azure Database for PostgreSQL flexible server
      • Resource rightsizing: リソースのサイズ、キャパシティ、または設定を変更することでコスト削減が行われる場合に使用します。

      • Resource migration: リソースやワークロードを別のリソースタイプ、サービス、またはアーキテクチャに移行することでコスト削減が行われる場合に使用します。

    • (任意) Compliance standards: ドロップダウンから 1 つ以上の規格を選択します。例: SOC2、HIPAA、GDPR。

    • Check and run continuously: レシピを継続的に実行したい場合は、このチェックボックスを選択してください。

      以下は、サンプルレシピの基本的な設定例です。

      Composer - recipe builder: add details.

ステップ 2: リソースを追加する

  1. Resources サイドパネルで対象のリソースを検索し、レシピビルダーのキャンバスにドラッグします。

    次のサンプルスクリーンショットは、AWS EBS ボリュームリソースを追加したキャンバスを示しています。

    Composer - recipe builder: add resource.

  2. (任意) 関連リソースを追加するには、リソースカード上の追加アイコン (+) を選択し、追加するリレーションタイプを選択します。

    Composer - recipe builder: add related resource.

ステップ 3: クエリーを作成する

  1. Recipe builder のサイドパネルで、Query タブを選択します。

    Composer - recipe builder: Query.

  2. Add rule を選択して、単一のルールを追加します。

    1 つのグループ内に複数のルールが必要な場合は、Add group を選択してから、そのグループ内で Add rule を選択してください。

  3. フィルターダイアログで、追加するルールを検索します。PropertiesEventsCostMetricsTagsGroup byIAMAll からオプションを選択して範囲を絞り込むことができます。

    Composer - recipe builder: Add rule.

  4. Done を選択します。新しいルールが、対応するリソースの下にサイドパネルへ追加されます。各コンポーネントのドロップダウンを使ってルールを調整できます。

    Composer - recipe builder: Add rule.

  5. Run Query を選択して、新しいレシピをテストします。Run query はレシピを公開しません。詳しくは Draft and published を参照してください。

ステップ 4: 是正内容を追加する (任意)

  1. Recipe builder のサイドパネルで Remediate タブを選択し、レシピが検出した問題の解決方法を記録するための是正フィールドを入力します。すべて任意項目です。空のままのフィールドは、レシピ保存時に省略されます。

    Composer - recipe builder: Add remediate tab fields

    • Remediation steps: 問題を手動で解決するための手順です。1 行につき 1 ステップを入力してください。

    • Impact: 是正手順を適用した結果として想定されるビジネスへの影響や副作用の説明です。

    • Complexity: 問題を修正するために必要なおおよその工数です。指定可能な値: SimpleIntermediateComplex

    • References: 追加のコンテキストのための外部ドキュメントや関連リソースへの URL です。

    • Fix time: 問題を解決するまでのおおよその時間です。数値を入力し、Hours または Days を選択します。デフォルトは Hours です。

レシピが公開されると、これらのフィールドは該当するインサイトの詳細ページ内の是正内容セクションに表示されます。

すべてクリア

新しい状態からレシピを作成し直す必要がある場合は、上部バーのケバブメニュー () から Clear all を選択してください。

Clear all オプションは、ページを離れることなくキャンバスをクリアし、レシピの詳細をすべてリセットします。新しいレシピ用にキャンバスをクリアする前に、現在のレシピを保存するには、先に Save and publish を選択することもできます。

レシピを公開する

レシピの準備ができたら、Composer ダッシュボードで同じリソースと条件を対象とする既存のレシピを検索します。特に Cost レシピでは、重複する一致によりコスト削減の合計が過大に計上される可能性があるため、ほぼ同じチェックを新規公開するよりも、既存レシピの編集または複製を優先してください。詳しくは Draft and published を参照してください。

  1. Save and publish を選択します。ダッシュボード上のレシピのステータスが Published に変更されます。未公開のレシピは、公開するまで Draft のままです。詳細については、Recipe lifecycle を参照してください。

  2. Close を選択して、レシピビルダーを終了します。