As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Gerenciar espaços de trabalho do Amazon Managed Service for Prometheus
Um *espaço de trabalho* é um espaço lógico dedicado ao armazenamento e à consulta das métricas do Prometheus. Um espaço de trabalho oferece suporte a um controle de acesso refinado para autorizar seu gerenciamento, como atualizar, listar, descrever e excluir, além da ingestão e consulta de métricas. É possível ter um ou mais espaços de trabalho em cada região na sua conta.
Use os procedimentos desta seção para criar e gerenciar seus espaços de trabalho do Amazon Managed Service for Prometheus.
**Topics**
+ [Criar um espaço de trabalho do Amazon Managed Service for Prometheus](AMP-create-workspace.md)
+ [Configurar seu espaço de trabalho](AMP-workspace-configuration.md)
+ [Editar um alias de espaço de trabalho](AMP-edit-workspace.md)
+ [Encontrar os detalhes do seu espaço de trabalho do Amazon Managed Service for Prometheus, incluindo o ARN](AMP-find-workspace-details.md)
+ [Excluir um espaço de trabalho do Amazon Managed Service for Prometheus](AMP-delete-workspace.md)
# Criar um espaço de trabalho do Amazon Managed Service for Prometheus
Siga estas etapas para criar um espaço de trabalho do Amazon Managed Service for Prometheus. Você pode escolher usar o AWS CLI ou o console do Amazon Managed Service for Prometheus.
**nota**
Se você estiver executando um cluster do Amazon EKS, também poderá criar um novo espaço de trabalho usando [Controladores da AWS para Kubernetes](integrating-ack.md).
**Para criar um espaço de trabalho usando o AWS CLI**
1. Insira o comando a seguir para criar o espaço de trabalho. Este exemplo cria um espaço de trabalho chamado `my-first-workspace`, mas você pode usar um alias diferente (ou nenhum), se preferir. Os aliases do espaço de trabalho são nomes simplificados, que ajudam a identificar seus espaços de trabalho. Eles não precisam ser exclusivos. Dois espaços de trabalho podem ter o mesmo alias, mas todos os espaços de trabalho têm um espaço de trabalho exclusivo IDs, que é gerado pelo Amazon Managed Service for Prometheus.
(Opcional) Para usar sua própria chave KMS para criptografar dados armazenados em seu espaço de trabalho, você pode incluir o `kmsKeyArn` parâmetro com a AWS KMS chave a ser usada. Embora o Amazon Managed Service for Prometheus não cobre pelo uso de chaves gerenciadas pelo cliente, pode haver custos associados às chaves de. AWS Key Management Service Para obter mais informações sobre a criptografia de dados no espaço de trabalho do Amazon Managed Service for Prometheus ou sobre como criar, gerenciar e usar sua própria chave gerenciada pelo cliente, consulte [Criptografia em repouso](encryption-at-rest-Amazon-Service-Prometheus.md).
Os parâmetros entre colchetes (`[]`) são opcionais. Não inclua os colchetes no 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 retorna os seguintes dados:
+ `workspaceId` é a ID exclusiva desse espaço de trabalho. Anote essa ID.
+ `arn` é o ARN desse espaço de trabalho.
+ `status` é o status atual do espaço de trabalho. Imediatamente depois de criar o espaço de trabalho, ele provavelmente será `CREATING`.
+ `kmsKeyArn` é a chave gerenciada pelo cliente usada para criptografar os dados do espaço de trabalho, se fornecida.
**nota**
Os espaços de trabalho criados com chaves gerenciadas pelo cliente não podem usar [coletores gerenciados pela AWS](AMP-collector.md) para ingestão.
Escolha se deseja usar as chaves gerenciadas pelo cliente ou as chaves AWS próprias com cuidado. Os espaços de trabalho criados com chaves gerenciadas pelo cliente não podem ser convertidos para usar chaves AWS próprias posteriormente (e vice-versa).
+ `tags` lista as tags do espaço de trabalho, se houver.
1. Se seu comando `create-workspace` retornar um status de `CREATING`, você poderá inserir o comando a seguir para determinar quando o espaço de trabalho estará pronto. *my-workspace-id*Substitua pelo valor pelo qual o `create-workspace` comando retornou`workspaceId`.
```
aws amp describe-workspace --workspace-id my-workspace-id
```
Quando o comando `describe-workspace` retornar `ACTIVE` para o `status`, o espaço de trabalho estará pronto para uso.
**Para criar um espaço de trabalho usando o console do Amazon Managed Service for Prometheus**
1. Abra o console do Amazon Managed Service for Prometheus em. [https://console.aws.amazon.com/prometheus/](https://console.aws.amazon.com/prometheus/home)
1. Escolha **Criar**.
1. Em **Alias do espaço de trabalho**, insira um alias para o novo espaço de trabalho.
Os aliases do workspace são nomes simplificados, que ajudam a identificar seus workspaces. Eles não precisam ser exclusivos. Dois espaços de trabalho podem ter o mesmo alias, mas todos os espaços de trabalho têm um espaço de trabalho exclusivo IDs, que é gerado pelo Amazon Managed Service for Prometheus.
1. (Opcional) Para usar sua própria chave KMS para criptografar dados armazenados em seu espaço de trabalho, você pode selecionar **Personalizar configurações de criptografia** e escolher a AWS KMS chave a ser usada (ou criar uma nova). É possível selecionar uma chave na conta a partir da lista suspensa ou inserir o ARN de qualquer chave à qual tenha acesso. Embora o Amazon Managed Service for Prometheus não cobre pelo uso de chaves gerenciadas pelo cliente, pode haver custos associados às chaves de. AWS Key Management Service
Para obter mais informações sobre a criptografia de dados no espaço de trabalho do Amazon Managed Service for Prometheus ou sobre como criar, gerenciar e usar sua própria chave gerenciada pelo cliente, consulte [Criptografia em repouso](encryption-at-rest-Amazon-Service-Prometheus.md).
**nota**
Os espaços de trabalho criados com chaves gerenciadas pelo cliente não podem usar [coletores gerenciados pela AWS](AMP-collector.md) para ingestão.
Escolha se deseja usar as chaves gerenciadas pelo cliente ou as chaves AWS próprias com cuidado. Os espaços de trabalho criados com chaves gerenciadas pelo cliente não podem ser convertidos para usar chaves AWS próprias posteriormente (e vice-versa).
1. (Opcional) Para adicionar uma ou mais tags ao espaço de trabalho, selecione **Adicionar nova tag**. Em seguida, em **Chave**, insira um nome para a tag. É possível adicionar um valor opcional para a tag em **Valor**.
Para adicionar outra tag, escolha novamente **Adicionar nova tag**.
1. Selecione **Criar espaço de trabalho**.
A página de detalhes do espaço de trabalho é exibida. Isso exibe informações, incluindo o status, o ARN, o ID do espaço de trabalho e o endpoint desse espaço de trabalho URLs para gravação e consultas remotas.
O status retorna **CREATING** até que o espaço de trabalho esteja pronto. Espere até que o status esteja como **ATIVO** antes de prosseguir com a configuração da ingestão de métricas.
Anote os URLs que são exibidos para **Endpoint - URL de gravação remota e Endpoint - URL** **de consulta**. Você precisará deles ao configurar seu servidor Prometheus para gravar métricas remotamente nesse espaço de trabalho e ao consultar essas métricas.
Para obter informações sobre como ingerir métricas no espaço de trabalho, consulte [Ingerir métricas do Prometheus no espaço de trabalho](AMP-onboard-ingest-metrics.md).
# Configurar seu espaço de trabalho
Você pode configurar seu espaço de trabalho para o seguinte:
+ Defina *conjuntos de rótulos* e defina limites nas séries temporais ativas que correspondem aos conjuntos de rótulos definidos. Um conjunto de rótulos é um conjunto de um ou mais *rótulos*, que são name/value pares que ajudam a contextualizar as métricas de séries temporais.
Ao definir conjuntos de rótulos e definir limites ativos de séries temporais, você pode limitar os picos em um locatário ou fonte para afetar somente esse locatário ou fonte. Por exemplo, se você definir um limite de 1.000.000 de séries temporais ativas no conjunto de rótulos `team=A env=prod`, se o número de séries temporais ingeridas que correspondem a esse conjunto de rótulos exceder o limite, somente as séries temporais que correspondem ao conjunto de rótulos serão limitadas. Dessa forma, outros inquilinos ou fontes métricas não são afetados.
Para obter mais informações sobre rótulos no Prometheus, consulte [Data Model](https://prometheus.io/docs/concepts/data_model/#data-model).
+ Defina um período de retenção para definir o número de dias para que os dados sejam retidos no espaço de trabalho.
**Como configurar seu espaço de trabalho**
1. Abra o console do Amazon Managed Service for Prometheus em. [https://console.aws.amazon.com/prometheus/](https://console.aws.amazon.com/prometheus/home)
1. No canto superior esquerdo da página, selecione o ícone do menu e escolha **Todos os workspaces**.
1. Selecione o **ID do espaço de trabalho** do espaço de trabalho.
1. Escolha a guia **Configurações do espaço de trabalho**.
1. Para definir o período de retenção do espaço de trabalho, escolha **Editar** na seção **Período de retenção**. Em seguida, especifique o novo período de retenção em dias. O máximo é de 1.095 dias (3 anos).
1. Para adicionar ou modificar conjuntos de rótulos e os limites de série ativos deles, escolha **Editar** na seção **Conjuntos de rótulos**. Faça o seguinte:
1. (Opcional) Insira um valor em **Limite de bucket padrão** para definir um limite para o número máximo de séries temporais ativas que podem ser ingeridas no espaço de trabalho, contando apenas as séries temporais que não correspondem a nenhum conjunto de rótulos definido.
1. Para definir um conjunto de rótulos, insira um limite de série temporal ativo para o novo conjunto de rótulos em **Limite de séries ativas**.
Em seguida, insira um rótulo e um valor para um rótulo que será usado no conjunto de rótulos e escolha **Adicionar rótulo**.
1. (Opcional) Para definir outro conjunto de etiquetas, escolha **Adicionar outro conjunto de rótulos** e repita as etapas anteriores.
1. Ao concluir, escolha **Save changes**.
# Editar um alias de espaço de trabalho
Você pode editar um espaço de trabalho para alterar seu alias. Para alterar o alias do espaço de trabalho usando a AWS CLI, insira o comando a seguir.
```
aws amp update-workspace-alias --workspace-id my-workspace-id --alias "new-alias"
```
**Para editar um espaço de trabalho usando o console do Amazon Managed Service for Prometheus**
1. Abra o console do Amazon Managed Service for Prometheus em. [https://console.aws.amazon.com/prometheus/](https://console.aws.amazon.com/prometheus/home)
1. No canto superior esquerdo da página, selecione o ícone do menu e escolha **Todos os espaços de trabalho**.
1. Escolha o ID do espaço de trabalho que você deseja editar e, em seguida, selecione **Editar**.
1. Insira um novo alias para o espaço de trabalho e selecione **Salvar**.
# Encontrar os detalhes do seu espaço de trabalho do Amazon Managed Service for Prometheus, incluindo o ARN
Você pode encontrar os detalhes do seu espaço de trabalho do Amazon Managed Service for Prometheus usando o console da AWS ou o AWS CLI.
------
#### [ Console ]
**Para encontrar os detalhes do seu espaço de trabalho usando o console do Amazon Managed Service for Prometheus**
1. Abra o console do Amazon Managed Service for Prometheus em. [https://console.aws.amazon.com/prometheus/](https://console.aws.amazon.com/prometheus/home)
1. No canto superior esquerdo da página, selecione o ícone do menu e escolha **Todos os workspaces**.
1. Selecione o **ID do espaço de trabalho** do espaço de trabalho. Isso exibirá detalhes sobre seu espaço de trabalho, incluindo:
+ **Status atual**: o status do seu espaço de trabalho, por exemplo, **Ativo**, é exibido em **Status**.
+ **ARN**: o ARN do espaço de trabalho é exibido **ARN**.
+ **ID**: o ID do espaço de trabalho é exibido em **ID do espaço de trabalho**.
+ **URLs**— O console exibe vários URLs para o espaço de trabalho, incluindo aqueles URLs para gravação ou consulta de dados do espaço de trabalho.
**nota**
Por padrão, os URLs dados são os IPv4 URLs. Você também pode usar o dualstack (IPv4 e IPv6 suportado). URLs Eles são iguais, mas estão no domínio `api.aws` no lugar do `amazonaws.com` padrão. Por exemplo, se você visse o seguinte (um IPv4 URL):
```
https://aps-workspaces.us-east-1.amazonaws.com/workspaces/ws-abcd1234-ef56-7890-ab12-example/api/v1/remote_write
```
Você pode criar uma pilha dupla (incluindo suporte para IPv6), URL da seguinte forma:
```
https://aps-workspaces.us-east-1.api.aws/workspaces/ws-abcd1234-ef56-7890-ab12-example/api/v1/remote_write
```
Abaixo desta seção, há guias com informações sobre regras, gerenciador de alertas, logs, configuração e tags.
------
#### [ AWS CLI ]
**Para encontrar os detalhes do seu espaço de trabalho usando o AWS CLI**
O comando a seguir retorna os detalhes do espaço de trabalho. Você deve *my-workspace-id* substituir pelo ID do espaço de trabalho do qual deseja obter os detalhes.
```
aws amp describe-workspace --workspace-id my-workspace-id
```
Isso retorna detalhes sobre seu espaço de trabalho, incluindo:
+ **Status atual**: o status do seu espaço de trabalho, por exemplo, `ACTIVE`, é retornado na propriedade `statusCode`.
+ **ARN**: o ARN do espaço de trabalho é retornado na propriedade `arn`.
+ **URLs**— AWS CLI Retorna o URL base do espaço de trabalho na `prometheusEndpoint` propriedade.
**nota**
Por padrão, o URL retornado é o IPv4 URL. Você também pode usar um URL de pilha dupla (IPv4 IPv6 compatível) no domínio em `api.aws` vez do padrão. `amazonaws.com` Por exemplo, se você visse o seguinte (um IPv4 URL):
```
https://aps-workspaces.us-east-1.amazonaws.com/workspaces/ws-abcd1234-ef56-7890-ab12-example/
```
Você pode criar uma pilha dupla (incluindo suporte para IPv6), URL da seguinte forma:
```
https://aps-workspaces.us-east-1.api.aws/workspaces/ws-abcd1234-ef56-7890-ab12-example/
```
Você também pode criar a gravação e a consulta remotas URLs para o espaço de trabalho adicionando `/api/v1/remote_write` ou`/api/v1/query`, respectivamente.
------
# Excluir um espaço de trabalho do Amazon Managed Service for Prometheus
A exclusão de um espaço de trabalho exclui os dados que foram ingeridos nele.
**nota**
A exclusão de um espaço de trabalho do Amazon Managed Service for Prometheus não exclui automaticamente AWS nenhum coletor gerenciado que esteja coletando métricas e as enviando para o espaço de trabalho. Para obter mais informações, consulte [Encontrar e excluir extratores](AMP-collector-how-to.md#AMP-collector-list-delete).
**Para excluir um espaço de trabalho usando o AWS CLI**
Use o seguinte comando:
```
aws amp delete-workspace --workspace-id my-workspace-id
```
**Para excluir um espaço de trabalho usando o console do Amazon Managed Service for Prometheus**
1. Abra o console do Amazon Managed Service for Prometheus em. [https://console.aws.amazon.com/prometheus/](https://console.aws.amazon.com/prometheus/home)
1. No canto superior esquerdo da página, selecione o ícone do menu e escolha **Todos os workspaces**.
1. Escolha o ID do espaço de trabalho que você deseja excluir e, em seguida, selecione **Excluir**.
1. Na caixa de confirmação, insira **delete** e selecione **Excluir**.