Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Administración de espacios de trabajo de Amazon Managed Service para Prometheus
Un *espacio de trabajo* es un espacio lógico dedicado al almacenamiento y la consulta de las métricas de Prometheus. Un espacio de trabajo admite un control de acceso detallado para autorizar su administración, como actualizar, listar, describir y eliminar, así como ingerir y consultar métricas. Puede tener uno o más espacios de trabajo en cada región de su cuenta.
Utilice los procedimientos de esta sección para crear y administrar los espacios de trabajo de Amazon Managed Service para Prometheus.
**Topics**
+ [Creación de un espacio de trabajo de Amazon Managed Service para Prometheus](AMP-create-workspace.md)
+ [Configuración del espacio de trabajo](AMP-workspace-configuration.md)
+ [Edición de un alias de espacio de trabajo](AMP-edit-workspace.md)
+ [Búsqueda del ARN del espacio de trabajo de Amazon Managed Service para Prometheus, incluido el ARN](AMP-find-workspace-details.md)
+ [Eliminación de un espacio de trabajo de Amazon Managed Service para Prometheus](AMP-delete-workspace.md)
# Creación de un espacio de trabajo de Amazon Managed Service para Prometheus
Siga estos pasos para crear un espacio de trabajo de Amazon Managed Service para Prometheus. Puede utilizar la AWS CLI o la consola de Amazon Managed Service para Prometheus.
**nota**
Si ejecuta un clúster de Amazon EKS, también puede crear un nuevo espacio de trabajo con los [controladores de AWS para Kubernetes](integrating-ack.md).
**Para crear un espacio de trabajo mediante la AWS CLI**
1. Introduzca el siguiente comando para crear el flujo de trabajo. En este ejemplo se crea un espacio de trabajo llamado `my-first-workspace`, pero puede utilizar un alias distinto (o ninguno). Los alias de los espacios de trabajo son nombres descriptivos que lo ayudan a identificar los espacios de trabajo. Los nombres no tienen que ser únicos. Dos espacios de trabajo pueden tener el mismo alias, pero todos los espacios de trabajo tienen un espacio de trabajo único IDs, generado por Amazon Managed Service para Prometheus.
(Opcional) Para usar su propia clave de KMS para cifrar los datos almacenados en su espacio de trabajo, puede incluir el `kmsKeyArn` parámetro junto con la clave que vaya a utilizar. AWS KMS Si bien Amazon Managed Service for Prometheus no le cobra por el uso de las claves gestionadas por el cliente, es posible que haya costes asociados a las claves de. AWS Key Management Service Para obtener más información sobre el cifrado de datos de Amazon Managed Service para Prometheus en el espacio de trabajo, o sobre cómo crear, gestionar y utilizar su propia clave administrada por el cliente, consulte [Cifrado en reposo](encryption-at-rest-Amazon-Service-Prometheus.md).
Los parámetros entre corchetes (`[]`) son opcionales, no los incluya en el comando.
```
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]
```
Este comando devuelve los siguientes datos:
+ `workspaceId` es el ID único para este espacio de trabajo. Anote este ID.
+ `arn` es el ARN de este espacio de trabajo.
+ `status` es el estado actual del espacio de trabajo. Inmediatamente después de crear el espacio de trabajo, este será probablemente `CREATING`.
+ `kmsKeyArn` es la clave administrada por el cliente que se utiliza para cifrar los datos del espacio de trabajo, si se proporciona.
**nota**
Los espacios de trabajo creados con claves administradas por el cliente no pueden utilizar [recopiladores administrados por AWS](AMP-collector.md) para la ingesta.
Elija si desea utilizar con cuidado las claves gestionadas por el cliente o las AWS propias. Los espacios de trabajo creados con claves administradas por el cliente no se pueden convertir para usar claves AWS propias más adelante (y viceversa).
+ `tags` muestra las etiquetas del espacio de trabajo, si las hay.
1. Si el comando `create-workspace` devuelve el estado `CREATING`, puede introducir el siguiente comando para determinar cuándo estará listo el espacio de trabajo. *my-workspace-id*Sustitúyalos por el valor que devolvió el `create-workspace` comando. `workspaceId`
```
aws amp describe-workspace --workspace-id my-workspace-id
```
Cuando el comando `describe-workspace` devuelva `ACTIVE` para `status`, el espacio de trabajo estará listo para usarse.
**Para crear un espacio de trabajo mediante la consola de Amazon Managed Service para Prometheus**
1. Abre la consola de Amazon Managed Service for Prometheus en. [https://console.aws.amazon.com/prometheus/](https://console.aws.amazon.com/prometheus/home)
1. Seleccione **Crear**.
1. En **Alias del espacio de trabajo**, introduzca un alias para el nuevo espacio de trabajo.
Los alias de los espacios de trabajo son nombres descriptivos que lo ayudan a identificar los espacios de trabajo. Los nombres no tienen que ser únicos. Dos espacios de trabajo pueden tener el mismo alias, pero todos los espacios de trabajo tienen un espacio de trabajo único IDs, generado por Amazon Managed Service para Prometheus.
1. (Opcional) Para usar tu propia clave de KMS para cifrar los datos almacenados en tu espacio de trabajo, puedes seleccionar **Personalizar la configuración de cifrado** y elegir la AWS KMS clave que quieres usar (o crear una nueva). Puede elegir una clave de su cuenta de la lista desplegable o introducir el ARN de cualquier clave a la que tenga acceso. Si bien Amazon Managed Service for Prometheus no le cobra por el uso de las claves gestionadas por el cliente, es posible que haya costes asociados a las claves de. AWS Key Management Service
Para obtener más información sobre el cifrado de datos de Amazon Managed Service para Prometheus en el espacio de trabajo, o sobre cómo crear, gestionar y utilizar su propia clave administrada por el cliente, consulte [Cifrado en reposo](encryption-at-rest-Amazon-Service-Prometheus.md).
**nota**
Los espacios de trabajo creados con claves administradas por el cliente no pueden utilizar [recopiladores administrados por AWS](AMP-collector.md) para la ingesta.
Elija si desea utilizar con cuidado las claves gestionadas por el cliente o las AWS propias. Los espacios de trabajo creados con claves administradas por el cliente no se pueden convertir para usar claves AWS propias más adelante (y viceversa).
1. (Opcional) Para agregar una o más etiquetas al espacio de trabajo, elija **Agregar nueva etiqueta**. Luego, en **Clave**, introduzca un nombre para la etiqueta. Puede agregar un valor opcional para la etiqueta en **Valor**.
Para agregar otra etiqueta, vuelva a elegir **Add new tag** (Agregar nueva etiqueta).
1. Elija **Crear espacio de trabajo**.
Se abrirá la página de detalles del espacio de trabajo. Muestra información que incluye el estado, el ARN, el ID del espacio de trabajo y el punto final URLs de este espacio de trabajo, tanto para la escritura remota como para las consultas.
El estado vuelve a **CREATING** hasta que el espacio de trabajo esté listo. Espere a que el estado sea **ACTIVE** antes de continuar con la configuración de la ingesta de métricas.
Anote lo URLs que se muestra para el **punto final (URL de escritura remota) y el punto final (URL** **de consulta)**. Las necesitará al configurar el servidor de Prometheus para escribir métricas de forma remota en este espacio de trabajo y al consultar dichas métricas.
Para obtener más información sobre cómo incorporar métricas al espacio de trabajo, consulte [Ingesta de las métricas de Prometheus al espacio de trabajo](AMP-onboard-ingest-metrics.md).
# Configuración del espacio de trabajo
Puede configurar su espacio de trabajo para lo siguiente:
+ Defina *conjuntos de etiquetas* y defina los límites de las series temporales activas que coincidan con los conjuntos de etiquetas definidos. Un conjunto de etiquetas es un conjunto de una o más *etiquetas*, que son name/value pares que ayudan a contextualizar las métricas de series temporales.
Al definir conjuntos de etiquetas y establecer límites de series temporales activas, puede limitar los picos en un inquilino u origen para que solo afecten a ese inquilino u origen. Por ejemplo, si establece un límite de 1 000 000 de series temporales activas en el conjunto de etiquetas `team=A env=prod`, si el número de series temporales incorporadas que coinciden con ese conjunto de etiquetas supera el límite, solo se limitarán las series temporales que coincidan con el conjunto de etiquetas. De esta forma, los demás inquilinos u orígenes de métricas no se ven afectados.
Para obtener más información sobre las etiquetas en Prometheus, consulte [Data Model](https://prometheus.io/docs/concepts/data_model/#data-model).
+ Establezca un período de retención para definir el número de días que se conservarán los datos en el espacio de trabajo.
**Para configurar el espacio de trabajo**
1. Abre la consola de Amazon Managed Service for Prometheus en. [https://console.aws.amazon.com/prometheus/](https://console.aws.amazon.com/prometheus/home)
1. En la esquina superior izquierda de la página, elija el icono de menú y, a continuación, elija **Todos los espacios de trabajo**.
1. Elija el **ID de espacio de trabajo** del espacio de trabajo.
1. Seleccione la pestaña **Configuración del espacio de trabajo**.
1. Para establecer el período de retención del espacio de trabajo, seleccione **Editar** en la sección **Periodo de retención**. A continuación, especifique el nuevo período de retención en días. El máximo es de 1095 días (3 años).
1. Para agregar o modificar conjuntos de etiquetas y sus límites de series activas, seleccione **Editar** en la sección **Conjuntos de etiquetas**. A continuación, proceda del modo siguiente:
1. (Opcional) Introduzca un valor en **Límite de buckets predeterminados** para establecer un límite sobre la cantidad máxima de series temporales activas que se pueden ingerir en el espacio de trabajo, contando solo las series temporales que no coinciden con cualquier conjunto de etiquetas definido.
1. Para definir un conjunto de etiquetas, introduzca un límite de series temporales activas para el nuevo conjunto de etiquetas en **Límite de series activas**.
A continuación, introduzca una etiqueta y un valor para una etiqueta que se utilizará en el conjunto de etiquetas y elija **Agregar etiqueta**.
1. (Opcional) Para definir otro conjunto de etiquetas, elija **Agregar otro conjunto de etiquetas** y repita los pasos anteriores.
1. Cuando haya finalizado, elija **Guardar cambios**.
# Edición de un alias de espacio de trabajo
Puede editar un espacio de trabajo para cambiar su alias. Para cambiar el alias del espacio de trabajo mediante la AWS CLI, introduzca el siguiente comando.
```
aws amp update-workspace-alias --workspace-id my-workspace-id --alias "new-alias"
```
**Para editar un espacio de trabajo mediante la consola de Amazon Managed Service para Prometheus**
1. Abre la consola de Amazon Managed Service for Prometheus en. [https://console.aws.amazon.com/prometheus/](https://console.aws.amazon.com/prometheus/home)
1. En la esquina superior izquierda de la página, elija el icono de menú y, a continuación, elija **Todos los espacios de trabajo**.
1. Elija el ID del espacio de trabajo que desee editar y, a continuación, elija **Editar**.
1. Introduzca un nuevo alias para el espacio de trabajo y, a continuación, elija **Guardar**.
# Búsqueda del ARN del espacio de trabajo de Amazon Managed Service para Prometheus, incluido el ARN
Puede encontrar los detalles del espacio de trabajo de Amazon Managed Service para Prometheus mediante la consola de AWS o la AWS CLI.
------
#### [ Console ]
**Búsqueda de los detalles del espacio de trabajo mediante la consola de Amazon Managed Service para Prometheus**
1. Abre la consola de Amazon Managed Service for Prometheus en. [https://console.aws.amazon.com/prometheus/](https://console.aws.amazon.com/prometheus/home)
1. En la esquina superior izquierda de la página, elija el icono de menú y, a continuación, elija **Todos los espacios de trabajo**.
1. Elija el **ID de espacio de trabajo** del espacio de trabajo. Se mostrarán detalles del espacio de trabajo, entre los que se incluyen los siguientes:
+ **Estado actual**: el estado del espacio de trabajo, por ejemplo **Activo**, se muestra en **Estado**.
+ **ARN**: el ARN del espacio de trabajo se muestra en **ARN**.
+ **ID**: el ID del espacio de trabajo se muestra en **ID de espacio de trabajo**.
+ **URLs**— La consola muestra varias opciones URLs para el espacio de trabajo, incluidas las que URLs permiten escribir o consultar datos del espacio de trabajo.
**nota**
Por defecto, los URLs dados son los IPv4 URLs. También puedes usar dualstack (IPv4 y es IPv6 compatible). URLs Son las mismas, pero están en el dominio `api.aws` y no en el predeterminado `amazonaws.com`. Por ejemplo, si vieras lo siguiente (una IPv4 URL):
```
https://aps-workspaces.us-east-1.amazonaws.com/workspaces/ws-abcd1234-ef56-7890-ab12-example/api/v1/remote_write
```
Puedes crear una URL de doble pila (incluida la compatibilidad con IPv6) de la siguiente manera:
```
https://aps-workspaces.us-east-1.api.aws/workspaces/ws-abcd1234-ef56-7890-ab12-example/api/v1/remote_write
```
Debajo de esta sección hay pestañas con información sobre las reglas, el administrador de alertas, los registros, la configuración y las etiquetas.
------
#### [ AWS CLI ]
**Para encontrar los detalles de tu espacio de trabajo, utiliza la AWS CLI**
El siguiente comando devuelve los detalles del espacio de trabajo. Debes *my-workspace-id* sustituirlo por el ID del espacio de trabajo del que deseas obtener los detalles.
```
aws amp describe-workspace --workspace-id my-workspace-id
```
Se devuelven los detalles del espacio de trabajo, entre los que se incluyen los siguientes:
+ **Estado actual**: el estado del espacio de trabajo, por ejemplo `ACTIVE`, se devuelve en la propiedad `statusCode`.
+ **ARN**: el ARN del espacio de trabajo se devuelve en la propiedad `arn`.
+ **URLs**— AWS CLI Devuelve la URL base del espacio de trabajo de la `prometheusEndpoint` propiedad.
**nota**
De forma predeterminada, la URL devuelta es la IPv4 URL. También puedes usar una URL de doble pila (IPv4 y IPv6 compatible) en el dominio en `api.aws` lugar de la predeterminada. `amazonaws.com` Por ejemplo, si vieras lo siguiente (una IPv4 URL):
```
https://aps-workspaces.us-east-1.amazonaws.com/workspaces/ws-abcd1234-ef56-7890-ab12-example/
```
Puedes crear una URL de doble pila (incluida la compatibilidad con IPv6) de la siguiente manera:
```
https://aps-workspaces.us-east-1.api.aws/workspaces/ws-abcd1234-ef56-7890-ab12-example/
```
También puedes crear la escritura y la consulta remotas URLs para el espacio de trabajo añadiendo `/api/v1/remote_write` o`/api/v1/query`, respectivamente.
------
# Eliminación de un espacio de trabajo de Amazon Managed Service para Prometheus
Al eliminar un espacio de trabajo, se eliminan los datos que se han ingerido en él.
**nota**
Al eliminar un espacio de trabajo de Amazon Managed Service for Prometheus, no se elimina automáticamente AWS ningún recopilador gestionado que esté recopilando estadísticas y enviándolas al espacio de trabajo. Para obtener más información, consulte [Buscar y eliminar raspadores](AMP-collector-how-to.md#AMP-collector-list-delete).
**Para eliminar un espacio de trabajo mediante el AWS CLI**
Utilice el siguiente comando :
```
aws amp delete-workspace --workspace-id my-workspace-id
```
**Para eliminar un espacio de trabajo mediante la consola de Amazon Managed Service para Prometheus**
1. Abre la consola de Amazon Managed Service for Prometheus en. [https://console.aws.amazon.com/prometheus/](https://console.aws.amazon.com/prometheus/home)
1. En la esquina superior izquierda de la página, elija el icono de menú y, a continuación, elija **Todos los espacios de trabajo**.
1. Elija el ID del espacio de trabajo que desea eliminar y, a continuación, elija **Eliminar**.
1. Introduzca **delete** en el cuadro de confirmación y elija **Eliminar**.