翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # Amazon Managed Service for Prometheus ワークスペースを管理する ワークスペース**は、Prometheus メトリクスの保存とクエリに使用される専用の論理スペースです。ワークスペースでは、更新、一覧表示、記述、削除、メトリクスの取り込みとクエリなど、管理操作を認可するためのきめ細かいアクセスコントロールがサポートされます。アカウント内のリージョンごとに 1 つ以上のワークスペースを持つことができます。 Amazon Managed Service for Prometheus ワークスペースを作成して管理するには、このセクションの手順を使用します。 **Topics** + [Amazon Managed Service for Prometheus ワークスペースを作成する](AMP-create-workspace.md) + [ワークスペースの設定](AMP-workspace-configuration.md) + [ワークスペースエイリアスを編集する](AMP-edit-workspace.md) + [Amazon Managed Service for Prometheus ワークスペースの詳細 (ARN を含む) を確認する](AMP-find-workspace-details.md) + [Amazon Managed Service for Prometheus ワークスペースを削除する](AMP-delete-workspace.md) # Amazon Managed Service for Prometheus ワークスペースを作成する Amazon Managed Service for Prometheus ワークスペースを作成するには、以下の手順に従います。 AWS CLI と Amazon Managed Service for Prometheus コンソールのどちらを使用するかを選択できます。 **注記** Amazon EKS クラスターを実行している場合は、[AWS Controllers for Kubernetes](integrating-ack.md) を使用して新しいワークスペースを作成することもできます。 **を使用してワークスペースを作成するには AWS CLI** 1. 以下のコマンドを入力して、ワークスペースを作成します。この例では `my-first-workspace` という名前のワークスペースを作成しますが、必要に応じて別のエイリアスを使用することもできます。ワークスペースエイリアスは、ワークスペースの識別に役立つわかりやすい名前です。これは一意でなくても構いません。2 つのワークスペースに同じエイリアスを付けることもできます。ただし、すべてのワークスペースには Amazon Managed Service for Prometheus によって生成された一意のワークスペース ID が割り当てられます。 (オプション) 独自の KMS キーを使用してワークスペースに保存されているデータを暗号化するには、使用する AWS KMS キーに `kmsKeyArn`パラメータを含めることができます。Amazon Managed Service for Prometheus はカスタマーマネージドキーの使用に対して課金しませんが、キーに関連するコストが発生する場合があります AWS Key Management Service。Amazon Managed Service for Prometheus によるワークスペース内のデータの暗号化、または独自のカスタマーマネージドキーの作成、管理、使用方法の詳細については、「[保管中の暗号化](encryption-at-rest-Amazon-Service-Prometheus.md)」を参照してください。 括弧 (`[]`) 内のパラメータはオプションであり、コマンドには括弧を含めないでください。 ``` aws amp create-workspace [--alias my-first-workspace] [--kmsKeyArn arn:aws:aps:us-west-2:111122223333:workspace/ws-sample-1234-abcd-56ef-7890abcd12ef] [--tags Status=Secret,Team=My-Team] ``` このコマンドは次のデータを返します。 + `workspaceId` は、このワークスペースの一意の ID です。この ID を書き留めてください。 + `arn` は、このワークスペースの ARN です。 + `status` は、ワークスペースの現在のステータスです。ワークスペースの作成直後は `CREATING` になる可能性があります。 + `kmsKeyArn` は、ワークスペースデータの暗号化に使用されるカスタマーマネージドキーです (指定されている場合)。 **注記** カスタマーマネージドキーで作成されたワークスペースは、取り込み用に[AWS マネージドコレクターを使用することはできません](AMP-collector.md)。 カスタマーマネージドキーと AWS 所有キーのどちらを慎重に使用するかを選択します。カスタマーマネージドキーで作成されたワークスペースは、後で (またはその逆で) AWS 所有キーを使用するように変換することはできません。 + `tags` は、ワークスペースのタグ (ある場合) のリストを示します。 1. `create-workspace` コマンドが `CREATING` ステータスを返した場合は、後で次のコマンドを入力することで、ワークスペースの準備が整ったかどうかを確認できます。*my-workspace-id* は、`create-workspace` コマンドから返された `workspaceId` の値に置き換えます。 ``` aws amp describe-workspace --workspace-id my-workspace-id ``` `describe-workspace` コマンドから `status` として `ACTIVE` が返されたら、ワークスペースを使用する準備ができています。 **Amazon Managed Service for Prometheus コンソールを使用してワークスペースを作成するには** 1. Amazon Managed Service for Prometheus コンソール ([https://console.aws.amazon.com/prometheus/](https://console.aws.amazon.com/prometheus/home)) を開きます。 1. **[作成]** を選択します。 1. **[WorkSpace エイリアス]** に、新しいワークスペースのエイリアスを入力します。 ワークスペースエイリアスは、ワークスペースの識別に役立つわかりやすい名前です。これは一意でなくても構いません。2 つのワークスペースに同じエイリアスを付けることもできます。ただし、すべてのワークスペースには Amazon Managed Service for Prometheus によって生成された一意のワークスペース ID が割り当てられます。 1. (オプション) 独自の KMS キーを使用してワークスペースに保存されているデータを暗号化するには、**暗号化設定をカスタマイズ**を選択し、使用する AWS KMS キーを選択します (または新しいキーを作成します）。ドロップダウンリストからアカウントのキーを選択するか、アクセスできる任意のキーの ARN を入力できます。Amazon Managed Service for Prometheus はカスタマーマネージドキーの使用に対して課金しませんが、キーに関連するコストが発生する可能性があります AWS Key Management Service。 Amazon Managed Service for Prometheus によるワークスペース内のデータの暗号化や、お客様独自のカスタマーマネージドキーの作成、管理、使用方法の詳細については、「[保管中の暗号化](encryption-at-rest-Amazon-Service-Prometheus.md)」を参照してください。 **注記** カスタマーマネージドキーで作成されたワークスペースは、取り込み用に[AWS マネージドコレクターを使用することはできません](AMP-collector.md)。 カスタマーマネージドキーと AWS 所有キーのどちらを慎重に使用するかを選択します。カスタマーマネージドキーで作成されたワークスペースは、後で (またはその逆で) AWS 所有キーを使用するように変換することはできません。 1. (オプション) ワークスペースに 1 つ以上のタグを追加するには、**[新しいタグを追加]** を選択します。**[キー]** にタグの名前を入力します。**[値]** では、任意でタグに値を追加できます。 別のタグを追加するには、**[新しいタグを追加]** を再度選択します。 1. **[ワークスペースを作成する]** を選択します。 ワークスペースの詳細ページが表示されます。ここには、このワークスペースのステータス、ARN、ワークスペース ID、リモート書き込み用とクエリ用のエンドポイント URL などの情報が表示されます。 ワークスペースの準備が整うまで、ステータスは **[作成中]** に戻ります。ステータスが **[アクティブ]** になるまで待ってから、メトリクスの取り込みの設定に進んでください。 **[エンドポイント - リモート書き込み URL]** と **[エンドポイント - クエリ URL]** に表示された URL を書き留めます。これらの URL は、このワークスペースにメトリクスをリモートで書き込むように Prometheus サーバーを構成するときと、それらのメトリクスにクエリを実行するときに必要になります。 ワークスペースにメトリクスを取り込む方法については、「[ワークスペースへの Prometheus メトリクスの取り込み](AMP-onboard-ingest-metrics.md)」を参照してください。 # ワークスペースの設定 ワークスペースは以下に対して設定できます。 + *ラベルセット*を定義し、定義したラベルセットに一致するアクティブ時系列の制限を定義します。ラベルセットは、時系列メトリクスにコンテキストを与えるのに役立つ名前と値のペアである 1 つ以上の*ラベル*のセットです。 ラベルセットを定義し、アクティブ時系列制限を設定することにより、1 つのテナントまたはソースのスパイクを制限して、そのテナントまたはソースのみに影響を与えることができます。例えば、ラベルセット `team=A env=prod` にアクティブ時系列制限を 1,000,000 に設定した場合、そのラベルセットに一致する取り込まれた時系列の数が制限を超えると、ラベルセットに一致する時系列のみがスロットリングされます。これにより、他のテナントやメトリクスソースは影響を受けません。 Prometheus のラベルの詳細については、「[データモデル](https://prometheus.io/docs/concepts/data_model/#data-model)」を参照してください。 + ワークスペースに保持するデータの日数を定義する保持期間を設定します。 **ワークスペースを設定するには** 1. Amazon Managed Service for Prometheus コンソール ([https://console.aws.amazon.com/prometheus/](https://console.aws.amazon.com/prometheus/home)) を開きます。 1. ページの左上隅にあるメニューアイコンを選択し、**[すべての WorkSpaces]** を選択します。 1. ワークスペースの**ワークスペース ID** を選択します。 1. **[ワークスペース構成]** タブを選択します。 1. ワークスペースの保持期間を設定するには、**[保持期間]** セクションで **[編集]** を選択します。次に、新しい保持期間を日数で指定します。最大は 1095 日 (3 年) です。 1. ラベルセットとそのアクティブシリーズ制限を追加または変更するには、**[ラベルセット]** セクションの **[編集]** を選択します。次に、以下の操作を実行します。 1. (オプション) **[デフォルトのバケット制限]** に値を入力し、定義されたラベルセットと一致しない時系列のみをカウントして、ワークスペースに取り込むことができるアクティブな時系列の最大数に制限を設定します。 1. ラベルセットを定義するには、**[アクティブシリーズ上限]** の下に新しいラベルセットの非アクティブ時系列の上限を入力します。 次に、ラベルセットで使用される 1 つのラベルにラベルと値を入力し、**[ラベルを追加]** を選択します。 1. (オプション) 別のラベルセットを定義するには、**[別のラベルセットを追加]** を選択し、前のステップを繰り返します。 1. 完了したら、**[変更を保存]** を選択します。 # ワークスペースエイリアスを編集する ワークスペースを編集してエイリアスを変更できます。 AWS CLIを使用してワークスペースエイリアスを変更するには、次のコマンドを入力します。 ``` aws amp update-workspace-alias --workspace-id my-workspace-id --alias "new-alias" ``` **Amazon Managed Service for Prometheus コンソールを使用してワークスペースを編集するには** 1. Amazon Managed Service for Prometheus コンソール ([https://console.aws.amazon.com/prometheus/](https://console.aws.amazon.com/prometheus/home)) を開きます。 1. ページの左上隅にあるメニューアイコンを選択し、**[すべての WorkSpaces]** を選択します。 1. 編集するワークスペースのワークスペース ID を選択し、**[編集]** を選択します。 1. ワークスペースの新しいエイリアスを入力し、**[保存]** を選択します。 # Amazon Managed Service for Prometheus ワークスペースの詳細 (ARN を含む) を確認する Amazon Managed Service for Prometheus ワークスペースの詳細は、 AWS コンソールまたは AWS CLIを使用して確認できます。 ------ #### [ Console ] **Amazon Managed Service for Prometheus コンソールを使用してワークスペースの詳細を確認するには** 1. Amazon Managed Service for Prometheus コンソール ([https://console.aws.amazon.com/prometheus/](https://console.aws.amazon.com/prometheus/home)) を開きます。 1. ページの左上隅にあるメニューアイコンを選択し、**[すべての WorkSpaces]** を選択します。 1. ワークスペースの**ワークスペース ID** を選択します。これにより、以下のような、ワークスペースの詳細が表示されます。 + **現在のステータス** – ワークスペースのステータス (**[アクティブ]** など) が、**[ステータス]** の下に表示されます。 + **ARN** - ワークスペースの ARN が **[ARN]** の下に表示されます。 + **ID** – ワークスペースの ID が **[ワークスペース ID]** の下に表示されます。 + **URL** – ワークスペースに対する書き込みやデータのクエリのための URL など、ワークスペースの複数の URL がコンソールに表示されます。 **注記** デフォルトの場合、返される URL は IPv4 URL です。デュアルスタック (IPv4 および IPv6 をサポート) URLを使用することもできます。これらは同じですが、ドメインはデフォルトの `amazonaws.com` ではなく、`api.aws` になります。例えば、以下 (IPv4 URL) が表示された場合: ``` https://aps-workspaces.us-east-1.amazonaws.com/workspaces/ws-abcd1234-ef56-7890-ab12-example/api/v1/remote_write ``` 次のようにデュアルスタック (IPv6 のサポートを含む) URL を作成できます。 ``` https://aps-workspaces.us-east-1.api.aws/workspaces/ws-abcd1234-ef56-7890-ab12-example/api/v1/remote_write ``` このセクションの下には、ルール、アラートマネージャー、ログ、設定、タグに関する情報を含むタブがあります。 ------ #### [ AWS CLI ] **を使用してワークスペースの詳細を検索するには AWS CLI** 次のコマンドは、ワークスペースの詳細を返します。*my-workspace-id* は、詳細を確認する対象のワークスペースのワークスペース ID に置き換える必要があります。 ``` aws amp describe-workspace --workspace-id my-workspace-id ``` これにより、以下のような、ワークスペースの詳細が返されます。 + **現在のステータス** – ワークスペースのステータス (`ACTIVE` など) が `statusCode` プロパティで返されます。 + **ARN** – ワークスペース ARN が `arn` プロパティで返されます。 + **URLs** は、 `prometheusEndpoint`プロパティ内のワークスペースの基本 URL AWS CLI を返します。 **注記** デフォルトの場合、返される URL は IPv4 URL です。デュアルスタック (IPv4 および IPv6 をサポート) URL を、デフォルトの `amazonaws.com` ではなく、ドメイン `api.aws` で使用することもできます。例えば、以下 (IPv4 URL) が表示された場合: ``` https://aps-workspaces.us-east-1.amazonaws.com/workspaces/ws-abcd1234-ef56-7890-ab12-example/ ``` 次のようにデュアルスタック (IPv6 のサポートを含む) URL を作成できます。 ``` https://aps-workspaces.us-east-1.api.aws/workspaces/ws-abcd1234-ef56-7890-ab12-example/ ``` ワークスペースのリモート書き込み URL およびクエリ URL を作成することもできます。この場合、`/api/v1/remote_write` または `/api/v1/query` をそれぞれ追加します。 ------ # Amazon Managed Service for Prometheus ワークスペースを削除する ワークスペースを削除すると、ワークスペースに取り込んだデータも削除されます。 **注記** Amazon Managed Service for Prometheus ワークスペースを削除しても、メトリクスをスクレイピングしてワークスペースに送信している AWS マネージドコレクターは自動的に削除されません。詳細については、「[スクレイパーの検出と削除](AMP-collector-how-to.md#AMP-collector-list-delete)」を参照してください。 **を使用してワークスペースを削除するには AWS CLI** 以下のコマンドを使用します。 ``` aws amp delete-workspace --workspace-id my-workspace-id ``` **Amazon Managed Service for Prometheus コンソールを使用してワークスペースを削除するには** 1. Amazon Managed Service for Prometheus コンソール ([https://console.aws.amazon.com/prometheus/](https://console.aws.amazon.com/prometheus/home)) を開きます。 1. ページの左上隅にあるメニューアイコンを選択し、**[すべての WorkSpaces]** を選択します。 1. 削除するワークスペースのワークスペース ID を選択し、**[削除]** を選択します。 1. 確認ボックスに **delete** と入力し、**[削除]** を選択します。