# Configurar métricas de solicitação para buckets de diretório
<a name="metrics-configurations-directory-buckets"></a>

É possível configurar métricas de solicitação para buckets de diretório para monitorar o desempenho operacional do armazenamento S3 Express One Zone. As métricas de solicitação estão disponíveis em intervalos de 1 minuto e ajudam a identificar e agir rapidamente em caso de problemas operacionais.

É possível configurar métricas de solicitação para buckets de diretório usando o console do Amazon S3, a AWS Command Line Interface (AWS CLI) ou a API REST do Amazon S3.

## Usar o console do S3
<a name="metrics-configuration-console-directory-buckets"></a>

Você pode usar o console do Amazon S3 para configurar métricas de solicitação para buckets de diretório.

**Como configurar métricas de solicitação para um bucket de diretório**

1. Faça login e abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. No painel de navegação à esquerda, escolha **Buckets de diretórios**.

1. Na lista de buckets, selecione o nome do bucket de diretório que contém os objetos para os quais você deseja solicitar métricas.

1. Escolha a guia **Metrics**.

1. Em **Bucket metrics (Métricas de bucket)**, escolha **View additional charts (Exibir gráficos adicionais)**.

1. Escolha a guia **Request metrics (Solicitar métricas)** .

1. Escolha **Create Filter (Criar filtro)**.

1. Na caixa **Filter name (Nome do filtro)** insira o nome do filtro.

   Nomes podem conter apenas letras, números, pontos, traços e sublinhados. Recomendamos usar o nome `EntireBucket` para um filtro que se aplica a todos os objetos.

1. Em **Escopo do filtro**, escolha uma das seguintes opções:
   + **Este filtro se aplica a todos os objetos no bucket**: você não especifica um filtro.
   + **Limitar o escopo deste filtro usando diretório ou ponto de acesso**: você especifica um filtro. Para limitar o escopo, você pode filtrar por diretório ou ponto de acesso.

   Também é possível definir um filtro para que as métricas sejam coletadas e relatadas apenas em um subconjunto de objetos no bucket de diretório.

1. Se você optar por limitar o escopo do filtro, especifique os respectivos detalhes:
   + Para filtrar por **diretório**, insira um nome de diretório.
   + Para filtrar por **ponto de acesso**, insira o ARN do ponto de acesso.

1. Escolha **Salvar alterações**.

1. Na guia **Request metrics (métricas de solicitação)**, em **Filters (Filtros)**, escolha o filtro que você acabou de criar.

   Após cerca de 15 minutos, o CloudWatch começa a rastrear essas métricas de solicitação. Você pode vê-las na guia **Request metrics (Métricas de solicitação)** . Você pode ver gráficos para as métricas no console do Amazon S3 ou do CloudWatch. As métricas de solicitação são cobradas na taxa padrão do CloudWatch. Para obter mais informações, consulte [Definição de preços do Amazon CloudWatch](https://aws.amazon.com/cloudwatch/pricing/).

## Como usar o AWS CLI
<a name="metrics-configuration-cli-directory-buckets"></a>

É possível usar a AWS CLI para configurar métricas de solicitação para buckets de diretório.

1. Instalar e configurar a AWS CLI. Para obter instruções, consulte [Instalação, atualização e desinstalação da AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-set-up.html) no *Guia do usuário da AWS Command Line Interface*.

1. Abra um terminal.

1. Execute o comando a seguir para adicionar uma configuração de métricas.

   ```
   aws s3api put-bucket-metrics-configuration --endpoint https://s3express-control.{{region-code}}.amazonaws.com --bucket {{directory-bucket-name}} --id {{metrics-config-id}} --metrics-configuration '{"Id":"{{metrics-config-id}}"}'
   ```

## Uso da API REST
<a name="metrics-configuration-rest-directory-buckets"></a>

É possível usar a API REST do Amazon S3 para configurar métricas de solicitação para buckets de diretório. Ao usar a API REST com buckets de diretório, você deve usar o endpoint da classe S3 Express One Zone com o endpoint de controle regional no formato `https://s3express-control.{{region-code}}.amazonaws.com`.

Para ter mais informações sobre as operações da API REST, consulte os seguintes tópicos na *Referência de API do Amazon S3*:
+ [Métricas de PUT Bucket](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTMetricConfiguration.html)
+ [Métricas de GET Bucket](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketGETMetricConfiguration.html)
+ [Métricas de DELETE Bucket](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketDELETEMetricConfiguration.html)
+ [Métricas de LIST Bucket](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketListMetricConfigurations.html)