# Criar uma configuração de métricas do CloudWatch para todos os objetos em seu bucket
<a name="configure-request-metrics-bucket"></a>

Ao configurar métricas de solicitação, você pode criar uma configuração de métricas do CloudWatch para todos os objetos no bucket ou filtrar por prefixo, etiqueta de objeto ou ponto de acesso. Os procedimentos neste tópico mostram como criar uma configuração para todos os objetos em seu bucket. Para criar uma configuração que filtre por etiqueta de objeto ou prefixo ou ponto de acesso, consulte [Criação de uma configuração de métricas que filtre por prefixo, etiqueta de objeto ou ponto de acesso](metrics-configurations-filter.md).

Existem três tipos de métricas do Amazon CloudWatch para o Amazon S3: métricas de armazenamento, métricas de solicitação e métricas de replicação. As métricas de armazenamento são relatadas uma vez por dia e fornecidas para todos os clientes sem qualquer custo adicional. As métricas de solicitação estão disponíveis em intervalos de um minuto após alguma latência para processamento. As métricas de solicitação são cobradas na taxa padrão do CloudWatch. Você deve aceitar métricas de solicitação configurando-as no console ou usando a API do Amazon S3. As [métricas da funcionalidade Replicação do S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/viewing-replication-metrics.html) são métricas detalhadas para as regras de replicação na configuração de replicação. Com as métricas de replicação, você pode monitorar o andamento minuto a minuto rastreando bytes pendentes, operações pendentes, operações com falha na replicação e latência de replicação.

Para obter mais informações sobre métricas do CloudWatch para o Amazon S3, consulte [Monitoramento de métricas com o Amazon CloudWatch](cloudwatch-monitoring.md). 

Você pode adicionar configurações de métricas a um bucket usando o console do Amazon S3, a AWS Command Line Interface (AWS CLI) ou a API REST do Amazon S3.

## Uso do console do S3
<a name="configure-metrics"></a>

1. Faça login no Console de gerenciamento da AWS 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 uso geral**.

1. Na lista de buckets, selecione o nome do bucket 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 **Filter scope** (Escopo do filtro), escolha **This filter applies to all objects in the bucket** (Este filtro se aplica a todos os objetos no bucket).

   Você também pode definir um filtro para que as métricas sejam coletadas e relatadas apenas em um subconjunto de objetos no bucket. Para obter mais informações, consulte [Criação de uma configuração de métricas que filtre por prefixo, etiqueta de objeto ou ponto de acesso](metrics-configurations-filter.md).

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/). 

## Uso dos REST API
<a name="metrics-configuration-api"></a>

Você também pode adicionar configurações de métricas de maneira programática com a API REST do Amazon S3. Para obter mais informações sobre como adicionar e trabalhar com configurações de métricas, consulte os tópicos a seguir na *Referência da API do Amazon Simple Storage Service*:
+ [Configuração de métrica PUT Bucket](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTMetricConfiguration.html)
+ [Configuração de métrica GET Bucket](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketGETMetricConfiguration.html)
+ [Configuração de métrica List Bucket](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTListBucketMetricsConfiguration.html)
+ [Configuração de métrica DELETE Bucket](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTDeleteBucketMetricsConfiguration.html)

## Usar a AWS CLI
<a name="add-metrics-configurations"></a>

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://s3.us-west-2.amazonaws.com --bucket bucket-name --id metrics-config-id --metrics-configuration '{"Id":"metrics-config-id"}'
   ```