Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Amazon Managed Service für Prometheus-Workspaces verwalten
Ein *Workspace* ist ein logischer Bereich, der der Speicherung und Abfrage von Prometheus-Metriken gewidmet ist. Ein Workspace unterstützt eine differenzierte Zugriffskontrolle für die Autorisierung seiner Verwaltung, z. B. für das Aktualisieren, Auflisten, Beschreiben und Löschen sowie für die Erfassung und Abfrage von Metriken. Sie können über einen oder mehrere Workspaces in jeder Region in Ihrem Konto verfügen.
Verwenden Sie die Verfahren in diesem Abschnitt, um Ihre Workspaces von Amazon Managed Service für Prometheus zu erstellen und zu verwalten.
**Topics**
+ [Erstellen Sie einen Amazon Managed Service für Prometheus Workspace](AMP-create-workspace.md)
+ [Konfiguriere deinen Workspace](AMP-workspace-configuration.md)
+ [Bearbeiten Sie einen Workspace-Alias](AMP-edit-workspace.md)
+ [Finden Sie Ihre Amazon Managed Service for Prometheus Workspace-Details, einschließlich ARN](AMP-find-workspace-details.md)
+ [Löschen Sie einen Amazon Managed Service for Prometheus-Workspace](AMP-delete-workspace.md)
# Erstellen Sie einen Amazon Managed Service für Prometheus Workspace
Gehen Sie wie folgt vor, um einen Workspace in Amazon Managed Service für Prometheus zu erstellen. Sie können wählen, ob Sie die AWS CLI oder die Amazon Managed Service for Prometheus-Konsole verwenden möchten.
**Anmerkung**
Wenn Sie einen Amazon EKS-Cluster ausführen, können Sie mit [AWS Controllers for Kubernetes](integrating-ack.md) auch einen neuen Workspace erstellen.
**Um einen Workspace mit dem zu erstellen AWS CLI**
1. Verwenden Sie den folgenden Befehl, um den Workspace zu erstellen. In diesem Beispiel wird ein Workspace mit dem Namen `my-first-workspace` erstellt, Sie können jedoch einen anderen Alias (oder keinen Alias) verwenden, wenn Sie möchten. Workspace-Aliase sind benutzerfreundliche Namen, anhand derer Sie Ihre Workspaces leichter identifizieren können. Sie müssen nicht einmalig sein. Zwei Workspaces können denselben Alias haben, aber alle Workspaces haben eindeutige Workspaces IDs, die von Amazon Managed Service for Prometheus generiert werden.
(Optional) Um Ihren eigenen KMS-Schlüssel zur Verschlüsselung der in Ihrem Workspace gespeicherten Daten zu verwenden, können Sie den `kmsKeyArn` Parameter zusammen mit dem zu verwendenden Schlüssel angeben. AWS KMS Amazon Managed Service for Prometheus berechnet Ihnen zwar keine Gebühren für die Verwendung von kundenverwalteten Schlüsseln, es können jedoch Kosten im Zusammenhang mit Schlüsseln von anfallen. AWS Key Management Service Weitere Informationen zur Verschlüsselung von Daten im Workspace mit Amazon Managed Service for Prometheus oder zur Erstellung, Verwaltung und Verwendung Ihres eigenen kundenverwalteten Schlüssels finden Sie unter [Verschlüsselung im Ruhezustand](encryption-at-rest-Amazon-Service-Prometheus.md).
Parameter in Klammern (`[]`) sind optional. Schließen Sie die Klammern nicht in Ihrem Befehl ein.
```
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]
```
Dieser Befehl gibt die folgenden Daten zurück:
+ `workspaceId` ist die einmalige ID für diesen Workspace. Notieren Sie sich diese ID.
+ `arn` ist der ARN für diesen Workspace.
+ `status` ist der aktuelle Status des Workspace. Unmittelbar nachdem Sie den Workspace erstellt haben, wird dies wahrscheinlich `CREATING` sein.
+ `kmsKeyArn` ist der vom Kunden verwaltete Schlüssel, der zur Verschlüsselung der Workspace-Daten verwendet wird, falls angegeben.
**Anmerkung**
Workspaces, die mit kundenverwalteten Schlüsseln erstellt wurden, können keine von [AWS verwalteten Sammler](AMP-collector.md) für die Datenerfassung verwenden.
Wählen Sie sorgfältig aus, ob Sie vom Kunden verwaltete Schlüssel oder AWS eigene Schlüssel verwenden möchten. Workspaces, die mit kundenverwalteten Schlüsseln erstellt wurden, können später nicht mehr in die Verwendung AWS eigener Schlüssel umgewandelt werden (und umgekehrt).
+ `tags` listet die Tags des Workspace auf, falls vorhanden.
1. Wenn Ihr `create-workspace` Befehl den Status von `CREATING` zurückgibt, können Sie den folgenden Befehl eingeben, um festzustellen, wann der Workspace bereit ist. *my-workspace-id*Ersetzen Sie es durch den Wert, für `workspaceId` den der `create-workspace` Befehl zurückgegeben hat.
```
aws amp describe-workspace --workspace-id my-workspace-id
```
Wenn der Befehl `describe-workspace` für `status` `ACTIVE` zurückgibt, ist der Workspace einsatzbereit.
**Erstellen eines Workspace mithilfe der Konsole von Amazon Managed Service für Prometheus**
1. Öffnen Sie die Amazon Managed Service for Prometheus-Konsole unter. [https://console.aws.amazon.com/prometheus/](https://console.aws.amazon.com/prometheus/home)
1. Wählen Sie **Erstellen** aus.
1. Geben Sie unter **Workspace-Alias** einen Alias für den neuen Workspace ein.
Workspace-Aliase sind benutzerfreundliche Namen, anhand derer Sie Ihre Workspaces leichter identifizieren können. Sie müssen nicht einmalig sein. Zwei Workspaces können denselben Alias haben, aber alle Workspaces haben eindeutige Workspaces IDs, die von Amazon Managed Service for Prometheus generiert werden.
1. (Optional) Um Ihren eigenen KMS-Schlüssel zur Verschlüsselung der in Ihrem Workspace gespeicherten Daten zu verwenden, können Sie die Option **Verschlüsselungseinstellungen anpassen** auswählen und den zu verwendenden AWS KMS Schlüssel auswählen (oder einen neuen erstellen). Sie können einen Schlüssel in Ihrem Konto aus der Dropdown-Liste auswählen oder den ARN für einen beliebigen Schlüssel eingeben, auf den Sie Zugriff haben. Amazon Managed Service for Prometheus berechnet Ihnen zwar keine Gebühren für die Verwendung von kundenverwalteten Schlüsseln, es können jedoch Kosten im Zusammenhang mit Schlüsseln von anfallen. AWS Key Management Service
Weitere Informationen zur Verschlüsselung von Daten im Workspace mit Amazon Managed Service for Prometheus oder zur Erstellung, Verwaltung und Verwendung Ihres eigenen kundenverwalteten Schlüssels finden Sie unter [Verschlüsselung im Ruhezustand](encryption-at-rest-Amazon-Service-Prometheus.md).
**Anmerkung**
Workspaces, die mit vom Kunden verwalteten Schlüsseln erstellt wurden, können keine von [AWS verwalteten Sammler](AMP-collector.md) für die Datenerfassung verwenden.
Wählen Sie sorgfältig aus, ob Sie vom Kunden verwaltete Schlüssel oder AWS eigene Schlüssel verwenden möchten. Workspaces, die mit vom Kunden verwalteten Schlüsseln erstellt wurden, können später nicht mehr in die Verwendung AWS eigener Schlüssel umgewandelt werden (und umgekehrt).
1. (Optional) Wählen Sie **Neues Tag hinzufügen**, um ein oder mehrere Tags zum Workspace hinzuzufügen. Geben Sie dann für **Schlüssel** einen Namen für das Tag ein. Sie können einen optionalen Wert für das Tag unter **Value** (Wert) hinzufügen.
(Optional) Zum Hinzufügen eines weiteren Tags wählen Sie **Add new tag** (Neues Tag hinzufügen) erneut aus.
1. Wählen Sie **Workspace erstellen**.
Die Detailseite des Workspace wird angezeigt. Dadurch werden Informationen wie Status, ARN, Workspace-ID und Endpunkt URLs für diesen Workspace sowohl für Remote-Schreibvorgänge als auch für Abfragen angezeigt.
Der Status lautet **WIRD ERSTELLT**, bis der Workspace bereit ist. Warten Sie, bis der Status **AKTIV** lautet, bevor Sie mit der Einrichtung Ihrer metrischen Erfassung fortfahren.
Notieren Sie sich die URLs , die für **Endpunkt — Remote-Write-URL** und **Endpoint — Abfrage-URL** angezeigt werden. Sie benötigen sie, wenn Sie Ihren Prometheus-Server für Remote-Write-Metriken in diesem Workspace konfigurieren und wenn Sie diese Metriken abfragen.
Weitere Informationen zum Erfassen von Metriken im Workspace finden Sie unter [Erfassen von Prometheus-Metriken in den Workspace](AMP-onboard-ingest-metrics.md).
# Konfiguriere deinen Workspace
Sie können Ihren Workspace für Folgendes konfigurieren:
+ Definieren Sie *Labelsätze* und definieren Sie Grenzwerte für die aktiven Zeitreihen, die Ihren definierten Labelsätzen entsprechen. Ein Labelsatz besteht aus einem oder mehreren *Labels*, bei denen es sich um name/value Paare handelt, die dazu beitragen, Zeitreihenmetriken einen Kontext zu geben.
Indem Sie Labelsätze definieren und aktive Zeitreihenlimits festlegen, können Sie Spitzenwerte in einem Mandanten oder einer Quelle so begrenzen, dass sie sich nur auf diesen Mandanten oder diese Quelle auswirken. Wenn Sie beispielsweise ein Limit von 1.000.000 aktiven Zeitreihen für den Labelsatz festlegen und die Anzahl der aufgenommenen Zeitreihen`team=A env=prod`, die diesem Labelsatz entsprechen, den Grenzwert überschreitet, werden nur die Zeitreihen gedrosselt, die dem Labelsatz entsprechen. Auf diese Weise sind andere Mandanten oder Metrikquellen nicht betroffen.
Weitere Informationen zu Labels in Prometheus finden Sie unter [Datenmodell](https://prometheus.io/docs/concepts/data_model/#data-model).
+ Legen Sie einen Aufbewahrungszeitraum fest, um die Anzahl der Tage zu definieren, für die die Daten im Workspace aufbewahrt werden sollen.
**Um deinen Workspace zu konfigurieren**
1. Öffnen Sie die Amazon Managed Service for Prometheus-Konsole unter. [https://console.aws.amazon.com/prometheus/](https://console.aws.amazon.com/prometheus/home)
1. Wählen Sie in der oberen linken Ecke der Seite das Menüsymbol und dann **Alle Workspaces**.
1. Wählen Sie die **Workspace-ID** des Workspace aus.
1. Wählen Sie die Registerkarte **Workspace-Konfigurationen**.
1. Um die Aufbewahrungsfrist für den Workspace festzulegen, wählen Sie im Abschnitt **Aufbewahrungszeitraum** die Option **Bearbeiten** aus. Geben Sie dann die neue Aufbewahrungsfrist in Tagen an. Das Maximum beträgt 1095 Tage (drei Jahre).
1. Um Beschriftungssätze und ihre aktiven Serienlimits hinzuzufügen oder zu ändern, wählen Sie im Abschnitt **Beschriftungssätze** die Option **Bearbeiten** aus. Führen Sie dann die folgenden Schritte aus:
1. (Optional) Geben Sie im Feld **Standard-Bucketlimit** einen Wert ein, um ein Limit für die maximale Anzahl aktiver Zeitreihen festzulegen, die in den Workspace aufgenommen werden können. Dabei werden nur Zeitreihen gezählt, die keinem definierten Labelsatz entsprechen.
1. **Um einen Labelsatz zu definieren, geben Sie unter Aktives Serienlimit einen Grenzwert für aktive Zeitreihen für den neuen Labelsatz ein.**
Geben Sie dann ein Label und einen Wert für ein Label ein, das im Labelsatz verwendet werden soll, und wählen Sie **Label hinzufügen**.
1. (Optional) Um einen weiteren Labelsatz zu definieren, wählen Sie „**Weiteren Labelsatz hinzufügen**“ und wiederholen Sie die vorherigen Schritte.
1. Klicken Sie auf **Save changes (Änderungen speichern)**, wenn Sie fertig sind.
# Bearbeiten Sie einen Workspace-Alias
Sie können einen Workspace bearbeiten, um seinen Alias zu ändern. Geben Sie den folgenden Befehl ein, um den Workspace-Alias mithilfe von AWS CLI zu ändern.
```
aws amp update-workspace-alias --workspace-id my-workspace-id --alias "new-alias"
```
**Einen Workspace mithilfe der Konsole von Amazon Managed Service für Prometheus bearbeiten**
1. Öffnen Sie die Amazon Managed Service for Prometheus-Konsole unter. [https://console.aws.amazon.com/prometheus/](https://console.aws.amazon.com/prometheus/home)
1. Wählen Sie in der oberen linken Ecke der Seite das Menüsymbol und dann **Alle Workspaces**.
1. Wählen Sie die Workspace-ID des Workspace aus, den Sie bearbeiten möchten, und wählen Sie dann **Bearbeiten** aus.
1. Geben Sie einen neuen Alias für den Workspace ein und wählen Sie dann **Speichern**.
# Finden Sie Ihre Amazon Managed Service for Prometheus Workspace-Details, einschließlich ARN
Sie finden die Details Ihres Amazon Managed Service for Prometheus-Workspace entweder über die AWS Konsole oder über. AWS CLI
------
#### [ Console ]
**So finden Sie Ihre Workspace-Details mithilfe der Amazon Managed Service for Prometheus-Konsole**
1. Öffnen Sie die Amazon Managed Service for Prometheus-Konsole unter. [https://console.aws.amazon.com/prometheus/](https://console.aws.amazon.com/prometheus/home)
1. Wählen Sie in der oberen linken Ecke der Seite das Menüsymbol und dann **Alle Workspaces**.
1. Wählen Sie die **Workspace-ID** des Workspace aus. Daraufhin werden Details zu deinem Workspace angezeigt, darunter:
+ **Aktueller Status** — Der Status deines Workspace, zum Beispiel **Aktiv**, wird unter **Status** angezeigt.
+ **ARN** — Der Workspace-ARN wird unter **ARN** angezeigt.
+ **ID** — Die Workspace-ID wird unter **Workspace-ID** angezeigt.
+ **URLs**— In der Konsole werden mehrere URLs für den Workspace angezeigt, darunter die URLs für das Schreiben in den Workspace oder das Abfragen von Daten aus dem Workspace.
**Anmerkung**
Standardmäßig sind die URLs angegebenen IPv4 URLs Sie können auch Dualstack (IPv4 und IPv6 unterstützt) verwenden. URLs Diese sind identisch, befinden sich jedoch in der Domäne und nicht in der `api.aws` Standardeinstellung. `amazonaws.com` Wenn Sie beispielsweise Folgendes sehen würden (eine IPv4 URL):
```
https://aps-workspaces.us-east-1.amazonaws.com/workspaces/ws-abcd1234-ef56-7890-ab12-example/api/v1/remote_write
```
Sie könnten eine Dual-Stack-URL (einschließlich Unterstützung für IPv6) wie folgt erstellen:
```
https://aps-workspaces.us-east-1.api.aws/workspaces/ws-abcd1234-ef56-7890-ab12-example/api/v1/remote_write
```
Unter diesem Abschnitt befinden sich Registerkarten mit Informationen zu Regeln, Alert Manager, Protokollen, Konfiguration und Tags.
------
#### [ AWS CLI ]
**Um deine Workspace-Details zu finden, verwende den AWS CLI**
Der folgende Befehl gibt die Details des Workspace zurück. Sie müssen sie *my-workspace-id* durch die Workspace-ID des Workspace ersetzen, für den Sie die Details wünschen.
```
aws amp describe-workspace --workspace-id my-workspace-id
```
Dadurch werden Details zu deinem Workspace zurückgegeben, darunter:
+ **Aktueller Status** — Der Status deines Workspace wird `ACTIVE` beispielsweise in der `statusCode` Unterkunft angezeigt.
+ **ARN** — Der Workspace-ARN wird in der `arn` Eigenschaft zurückgegeben.
+ **URLs**— AWS CLI Gibt die Basis-URL für den Workspace in der `prometheusEndpoint` Eigenschaft zurück.
**Anmerkung**
Standardmäßig ist die zurückgegebene URL die IPv4 URL. Sie können in der Domain auch eine (IPv4 und IPv6 unterstützte) Dual-Stack-URL `api.aws` anstelle der Standard-URL verwenden. `amazonaws.com` Wenn Sie beispielsweise Folgendes sehen würden (eine IPv4 URL):
```
https://aps-workspaces.us-east-1.amazonaws.com/workspaces/ws-abcd1234-ef56-7890-ab12-example/
```
Sie könnten eine Dual-Stack-URL (einschließlich Unterstützung für IPv6) wie folgt erstellen:
```
https://aps-workspaces.us-east-1.api.aws/workspaces/ws-abcd1234-ef56-7890-ab12-example/
```
Sie können auch den Remote-Write und die Remote-Abfrage URLs für den Workspace erstellen, indem Sie jeweils `/api/v1/remote_write` oder `/api/v1/query` hinzufügen.
------
# Löschen Sie einen Amazon Managed Service for Prometheus-Workspace
Beim Löschen eines Workspace werden die Daten gelöscht, die in den Workspace aufgenommen wurden.
**Anmerkung**
Durch das Löschen eines Amazon Managed Service for Prometheus-Workspace werden nicht automatisch alle AWS verwalteten Collectors gelöscht, die Metriken sammeln und an den Workspace senden. Weitere Informationen finden Sie unter [Suchen und Löschen von Scrapern](AMP-collector-how-to.md#AMP-collector-list-delete).
**Um einen Workspace zu löschen, verwenden Sie AWS CLI**
Verwenden Sie den folgenden Befehl:
```
aws amp delete-workspace --workspace-id my-workspace-id
```
**Löschen Sie einen Arbeitsbereich über die Konsole von Amazon Managed Service für Prometheus wie folgt**
1. Öffnen Sie die Amazon Managed Service for Prometheus-Konsole unter. [https://console.aws.amazon.com/prometheus/](https://console.aws.amazon.com/prometheus/home)
1. Wählen Sie in der oberen linken Ecke der Seite das Menüsymbol und dann **Alle Workspaces**.
1. Wählen Sie die Workspace-ID des Workspace aus, den Sie löschen möchten, und wählen Sie dann **Löschen** aus.
1. Geben Sie in das Bestätigungsfeld **delete** ein und wählen Sie dann **Löschen**.