# Configurações de métricas do CloudWatch Com as métricas de solicitação do Amazon CloudWatch para o Amazon S3, você pode receber métricas do CloudWatch de 1 minuto, definir alarmes do CloudWatch e acessar painéis do CloudWatch para visualizar operações quase em tempo real e performance do armazenamento do Amazon S3. Para aplicativos que dependem do armazenamento em nuvem, essas métricas permitem que você identifique rapidamente os problemas operacionais e aja em relação a eles. Quando ativadas, essas métricas de 1 minuto estão disponíveis por padrão no nível do bucket do Amazon S3. Se quiser obter as métricas de solicitações do CloudWatch para objetos em um bucket, será necessário criar uma configuração de métricas para o bucket. Para obter mais informações, consulte [Criar uma configuração de métricas do CloudWatch para todos os objetos em seu bucket](configure-request-metrics-bucket.md). Você também pode usar um prefixo compartilhado, etiquetas do objeto ou um ponto de acesso para definir um filtro para as métricas coletadas. Esse método de definir um filtro permite que você alinhe filtros de métricas para aplicações de negócios, fluxos de trabalho ou organizações internas específicas. 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). Para obter mais informações sobre as métricas do CloudWatch que estão disponíveis e as diferenças entre métricas de armazenamento e métricas de solicitação, consulte [Monitoramento de métricas com o Amazon CloudWatch](cloudwatch-monitoring.md). Tenha o seguinte em mente ao usar as configurações de métricas: + Você pode ter um máximo de 1.000 configurações de métricas por bucket. + Você pode escolher que objetos em um bucket serão incluídos nas configurações de métricas, utilizando filtros. Você pode filtrar em um prefixo compartilhado, etiqueta de objeto ou ponto de acesso para alinhar filtros de métricas para aplicações de negócios, fluxos de trabalho ou organizações internas específicas. Para métricas de solicitação para todo o bucket, crie uma configuração de métricas sem um filtro. + As configurações de métricas são necessárias apenas para permitir métricas de solicitação. As métricas diárias de armazenamento ao nível do bucket- estão sempre ativadas e são fornecidas sem nenhum custo adicional. Atualmente, não é possível obter métricas diárias de armazenamento para um subconjunto filtrado de objetos. + Cada configuração de métricas permite o conjunto completo de [métricas de solicitações disponíveis](metrics-dimensions.md#s3-request-cloudwatch-metrics). As métricas específicas de operações (como `PostRequests`) serão relatadas somente se houver solicitações daquele tipo para o bucket ou filtro. + As métricas de solicitações são relatadas para todas as operações no nível de objeto. Elas também são relatadas para operações que listam o conteúdo do bucket, como [GET Bucket (Listar objetos)](https://docs.aws.amazon.com/AmazonS3/latest/API/v2-RESTBucketGET.html), [GET versões de objetos do bucket](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketGETVersion.html) e [Listar multipart uploads](https://docs.aws.amazon.com/AmazonS3/latest/API/mpUploadListMPUpload.html), mas não são relatadas para outras operações em buckets. + As métricas de solicitações oferecem suporte à filtragem por prefixo, etiquetas do objeto ou ponto de acesso, mas as métricas de armazenamento não. **Entrega de métricas do CloudWatch com o melhor esforço** As métricas do CloudWatch são entregues com base em melhor esforço. A maioria de solicitações para um objeto do Amazon S3 que tenha métricas de solicitações resulta no envio de um ponto de dados ao CloudWatch. A integridade e pontualidade das métricas não são garantidas. O ponto de dados para uma solicitação específica pode ser retornado com um timestamp posterior à solicitação processada. O ponto de dados de um minuto pode ser atrasado antes de ser disponibilizado pelo CloudWatch ou pode nem ser entregue. As métricas de solicitação do CloudWatch lhe dão uma ideia da natureza do tráfego em seu bucket em tempo quase real. Não se trata de uma contabilidade completa de todas as solicitações. Devido à natureza de melhor esforço deste recurso, os relatórios disponíveis no [Painel de faturamento e de gerenciamento de custo](https://console.aws.amazon.com/billing/home?#/) podem incluir uma ou mais solicitações de acesso que não aparecem nas métricas do bucket. Para obter mais informações sobre como trabalhar com métricas do CloudWatch no Amazon S3, consulte os tópicos a seguir. **Topics** + [Criar uma configuração de métricas do CloudWatch para todos os objetos em seu bucket](configure-request-metrics-bucket.md) + [Criação de uma configuração de métricas que filtre por prefixo, etiqueta de objeto ou ponto de acesso](metrics-configurations-filter.md) + [Excluir um filtro de métricas](delete-request-metrics-filter.md) # Criar uma configuração de métricas do CloudWatch para todos os objetos em seu bucket 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 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 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 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"}' ``` # Criação de uma configuração de métricas que filtre por prefixo, etiqueta de objeto ou ponto de acesso 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). Ao configurar métricas do CloudWatch, você pode criar um filtro para todos os objetos em seu bucket ou filtrar a configuração em grupos de objetos relacionados em um único bucket. Você pode filtrar objetos em um bucket para inclusão em uma configuração de métricas baseada em um ou mais dos seguintes tipos de filtros: + **Prefixo de nome de chave de objeto**: embora o modelo de dados do Amazon S3 seja uma estrutura plana, você pode inferir a hierarquia usando um prefixo. O console do Amazon S3 oferece suporte a esses prefixos com o conceito de pastas. Se você filtrar por prefixo, os objetos com mesmo prefixo serão incluídos na configuração de métricas. Para obter mais informações sobre prefixos, consulte [Organizar objetos usando prefixos](using-prefixes.md). + **Etiqueta**: você pode adicionar etiquetas que são pares de nome chave-valor, aos objetos. As tags ajudam a encontrar e organizar objetos com facilidade. Você também pode usar etiquetas como filtros para configurações de métricas. Para obter mais informações sobre etiquetas de objeto, consulte [Categorizar objetos usando tags](object-tagging.md). + **Ponto de acesso**: os pontos de acesso são nomeados endpoints de rede que estão conectados a buckets e simplificam o gerenciamento do acesso a dados em escala para conjuntos de dados compartilhados no S3. Quando você cria um filtro de ponto de acesso, o Amazon S3 inclui solicitações ao ponto de acesso que você especifica na configuração de métricas. Para obter mais informações, consulte [Monitorar e registrar de pontos de acesso](access-points-monitoring-logging.md). **nota** Ao criar uma configuração de métricas que filtra por ponto de acesso, você deve usar o ponto de acesso Nome de recurso da Amazon (ARN), não o alias do ponto de acesso. Certifique-se de usar o ARN para o próprio ponto de acesso, não o ARN para um objeto específico. Para obter mais informações sobre ARNs de ponto de acesso, consulte [Usar o recurso Pontos de Acesso Amazon S3 para buckets de uso geral](using-access-points.md). Se você especificar um filtro, somente solicitações que operem em objetos únicos podem corresponder ao filtro e serem incluídas nas métricas relatadas. Algumas solicitações, como [https://docs.aws.amazon.com/AmazonS3/latest/API/multiobjectdeleteapi.html](https://docs.aws.amazon.com/AmazonS3/latest/API/multiobjectdeleteapi.html) e `ListObjects`, não exibem nenhuma métrica para configurações com filtros. Para solicitar uma filtragem mais complexa, escolha dois ou mais elementos. Somente os objetos que têm todos esses elementos são incluídos na configuração de métricas. Se você não definir filtros, todos os objetos no bucket estão incluídos na configuração de métricas. ## Uso do console do S3 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. 1. Em **Filter scope** (Escopo do filtro), escolha **Limit the scope of this filter using a prefix, object tags, and an S3 Access Point, or a combination of all three** (Limitar o escopo desse filtro usando um prefixo, etiquetas de objeto e um ponto de acesso do S3 ou uma combinação de todos os três). 1. Em **Filter type** (Tipo de filtro), escolha pelo menos um tipo de filtro: **Prefix** (Prefixo), **Object tags** (Etiquetas do objeto) ou **Access Point** (Ponto de acesso). 1. Para definir um filtro de prefixo e limitar o escopo do filtro a um único caminho, na caixa **Prefix** (Prefixo), insira um prefixo. 1. Para definir um filtro de etiquetas do objeto, em **Object tags** (Etiquetas do objeto), selecione **Add tag** (Adicionar etiqueta) e, em seguida, insira uma **Key** (Chave) e **Value** (Valor) da etiqueta. 1. Para definir um filtro de ponto de acesso, no campo **S3 Access Point** (Ponto de acesso do S3), informe o ARN do ponto de acesso ou escolha **Browse S3** (Navegar no S3) para navegar até o ponto de acesso. **Importante** Não é possível inserir um alias de ponto de acesso. Você deve inserir o ARN para o próprio ponto de acesso, não o ARN de um objeto específico. 1. Escolha **Salvar alterações**. O Amazon S3 cria um filtro que usa o prefixo, as etiquetas ou o ponto de acesso especificado. 1. Na guia **Request metrics (métricas de solicitação)**, em **Filters (Filtros)**, escolha o filtro que você acabou de criar. Agora você criou um filtro que limita o escopo de métricas de solicitação por prefixo, etiquetas de objeto ou ponto de acesso. Cerca de 15 minutos após o CloudWatch começar a rastrear essas métricas de solicitação, você pode ver gráficos para as métricas nos consoles do Amazon S3 e 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/). Você também pode configurar métricas de solicitação no nível de bucket. Para mais informações, consulte [Criar uma configuração de métricas do CloudWatch para todos os objetos em seu bucket](configure-request-metrics-bucket.md). ## Como usar o AWS CLI 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-install.html) no *Guia do usuário da AWS Command Line Interface*. 1. Abra um terminal. 1. Para adicionar uma configuração de métricas, execute um dos seguintes comandos: **Example : para filtrar por prefixo** ``` aws s3api put-bucket-metrics-configuration --bucket amzn-s3-demo-bucket --id metrics-config-id --metrics-configuration '{"Id":"metrics-config-id", "Filter":{"Prefix":"prefix1"}} ' ``` **Example : para filtrar por etiquetas** ``` aws s3api put-bucket-metrics-configuration --bucket amzn-s3-demo-bucket --id metrics-config-id --metrics-configuration '{"Id":"metrics-config-id", "Filter":{"Tag": {"Key": "string", "Value": "string"}} ' ``` **Example : para filtrar por ponto de acesso** ``` aws s3api put-bucket-metrics-configuration --bucket amzn-s3-demo-bucket --id metrics-config-id --metrics-configuration '{"Id":"metrics-config-id", "Filter":{"AccessPointArn":"arn:aws:s3:Region:account-id:accesspoint/access-point-name"}} ' ``` **Example : para filtrar por prefixo, etiquetas e ponto de acesso** ``` aws s3api put-bucket-metrics-configuration --endpoint https://s3.Region.amazonaws.com --bucket amzn-s3-demo-bucket --id metrics-config-id --metrics-configuration ' { "Id": "metrics-config-id", "Filter": { "And": { "Prefix": "string", "Tags": [ { "Key": "string", "Value": "string" } ], "AccessPointArn": "arn:aws:s3:Region:account-id:accesspoint/access-point-name" } } }' ``` ## Uso da API REST 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) # Excluir um filtro de métricas Você pode excluir um filtro de métricas de solicitação do Amazon CloudWatch se não precisar mais dele. Ao excluir um filtro, você não será mais cobrado pelas métricas de solicitação que usam esse *filtro específico*. No entanto, você continuará a ser cobrado por qualquer outra configuração de filtro existente. Ao excluir um filtro, você não poderá mais usar o filtro para métricas de solicitação. A exclusão de um filtro não pode ser desfeita. Para obter informações sobre como criar um filtro de métricas de solicitação, consulte os seguintes tópicos: + [Criar uma configuração de métricas do CloudWatch para todos os objetos em seu bucket](configure-request-metrics-bucket.md) + [Criação de uma configuração de métricas que filtre por prefixo, etiqueta de objeto ou ponto de acesso](metrics-configurations-filter.md) ## Uso do console do S3 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 para o qual você deseja excluir um filtro de solicitação de 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 **Manage filters (Gerenciar filtros)**. 1. Escolha o seu filtro. **Importante** A exclusão de um filtro não pode ser desfeita. 1. Escolha **Delete**. O Amazon S3 exclui seu filtro. ## Uso dos REST API 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)