# Monitorar métricas do S3 Storage Lens no CloudWatch É possível publicar métricas da Lente de Armazenamento do S3 no Amazon CloudWatch para criar uma visão unificada de sua integridade operacional nos [painéis do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html). Também é possível usar os recursos do CloudWatch, como alarmes e ações acionadas, matemática métrica e detecção de anomalias, para monitorar e realizar ações sobre as métricas da Lente de Armazenamento do S3. Além disso, as operações de API do CloudWatch permitem que aplicações, inclusive provedores de terceiros, acessem as métricas da Lente de Armazenamento do S3. Para ter mais informações sobre os recursos do CloudWatch, consulte o [Guia do usuário do Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html). Você pode habilitar a opção de publicação no CloudWatch para configurações de painéis novos ou existentes usando o console do Amazon S3, a API REST do Amazon S3, a AWS CLI e os AWS SDKs. Painéis atualizados para métricas e recomendações avançadas do S3 Storage Lens podem usar a opção de publicação no CloudWatch. Para saber mais sobre o preço das métricas e recomendações avançadas da Lente de Armazenamento do S3, consulte [Definição de preço do Amazon S3](https://aws.amazon.com/s3/pricing/). Não são aplicadas cobranças adicionais para publicação de métricas no CloudWatch, mas outras cobranças do CloudWatch, como painéis, alarmes e chamadas de API, são aplicáveis. Para saber mais, consulte [Preço do Amazon CloudWatch](https://aws.amazon.com/cloudwatch/pricing/). As métricas do S3 Storage Lens são publicadas no CloudWatch na conta proprietária da configuração do S3 Storage Lens. Após a habilitação da opção de publicação do CloudWatch em métricas avançadas, é possível acessar as métricas em nível de conta e em nível de bucket por ID de configuração, conta, bucket (somente para métricas em nível de bucket), região e classe de armazenamento no CloudWatch. As métricas de nível prefixo não estão disponíveis no CloudWatch. **nota** As métricas do S3 Storage Lens são métricas diárias e são publicadas no CloudWatch uma vez por dia. Quando você consulta métricas do S3 Storage Lens no CloudWatch, o período para a consulta deve ser de 1 dia (86.400 segundos). Depois que as métricas diárias do S3 Storage Lens são exibidas no painel do S3 Storage Lens no console do Amazon S3, essas mesmas métricas podem demorar algumas horas para serem exibidas no CloudWatch. Quando você habilita a opção de publicação do CloudWatch para métricas do S3 Storage Lens pela primeira vez, as métricas podem levar até 24 horas para serem publicadas no CloudWatch. Depois de habilitar a opção de publicação do CloudWatch, você pode usar os seguintes recursos do CloudWatch para monitorar e analisar os dados do S3 Storage Lens: + [Painéis](storage-lens-cloudwatch-monitoring-cloudwatch.md#storage-lens-cloudwatch-monitoring-cloudwatch-dashboards): use os painéis do CloudWatch para criar painéis personalizados do S3 Storage Lens. Compartilhe seu painel do CloudWatch com pessoas que não têm acesso direto à sua Conta da AWS, com equipes, com partes interessadas e com pessoas externas às suas organizações. + [Alarmes e ações acionadas](storage-lens-cloudwatch-monitoring-cloudwatch.md#storage-lens-cloudwatch-monitoring-cloudwatch-alarms): configure alarmes que monitoram métricas e realizam ações quando um limite é violado. Por exemplo, é possível configurar um alarme que envia uma notificação do Amazon SNS quando a métrica **Incomplete Multipart Upload Bytes** (Bytes de multipart uploads incompletos) exceder 1 GB por três dias consecutivos. + [Detecção de anomalias](storage-lens-cloudwatch-monitoring-cloudwatch.md#storage-lens-cloudwatch-monitoring-cloudwatch-alarms): habilite a detecção de anomalias para analisar continuamente métricas, determinar linhas de base normais e anomalias. Você pode criar um alarme de detecção de anomalias com base no valor esperado de uma métrica. Por exemplo, é possível monitorar anomalias na métrica **Object Lock Enabled Bytes** (Bytes de Bloqueio de Objeto ativado) para detectar a remoção não autorizada das configurações de Bloqueio de Objeto. + [Matemática métrica:](storage-lens-cloudwatch-monitoring-cloudwatch.md#storage-lens-cloudwatch-monitoring-cloudwatch-metric-math) você também pode usar a matemática métrica para consultar várias métricas do S3 Storage Lens e usar expressões matemáticas para criar novas séries temporais de acordo com essas métricas. Por exemplo, você pode criar uma métrica para obter o tamanho médio de objetos dividindo `StorageBytes` por `ObjectCount`. Para obter mais informações sobre a opção de publicação no CloudWatch para métricas do S3 Storage Lens, consulte os tópicos a seguir. **Topics** + [ # Métricas e dimensões do S3 Storage Lens ](storage-lens-cloudwatch-metrics-dimensions.md) + [ # Habilitar publicação no CloudWatch para o S3 Storage Lens ](storage-lens-cloudwatch-enable-publish-option.md) + [ # Trabalhar com métricas do S3 Storage Lens no CloudWatch ](storage-lens-cloudwatch-monitoring-cloudwatch.md) # Métricas e dimensões do S3 Storage Lens Para enviar métricas da Lente de Armazenamento do S3 ao CloudWatch, você deve habilitar a opção de publicação do CloudWatch nas métricas avançadas da Lente de Armazenamento do S3. Com as métricas avançadas habilitadas, é possível usar os [painéis do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html) para monitorar as métricas da Lente de Armazenamento do S3 juntamente com métricas de outras aplicações e criar uma visão unificada de sua integridade operacional. Você pode usar dimensões para filtrar as métricas do S3 Storage Lens no CloudWatch por organização, conta, bucket, classe de armazenamento, região e ID de configuração de métricas. As métricas do S3 Storage Lens são publicadas no CloudWatch na conta proprietária da configuração do S3 Storage Lens. Após a habilitação da opção de publicação do CloudWatch em métricas avançadas, é possível acessar as métricas em nível de conta e em nível de bucket por ID de configuração, conta, bucket (somente para métricas em nível de bucket), região e classe de armazenamento no CloudWatch. As métricas de nível prefixo não estão disponíveis no CloudWatch. **nota** As métricas do S3 Storage Lens são métricas diárias e são publicadas no CloudWatch uma vez por dia. Quando você consulta métricas do S3 Storage Lens no CloudWatch, o período para a consulta deve ser de 1 dia (86.400 segundos). Depois que as métricas diárias do S3 Storage Lens são exibidas no painel do S3 Storage Lens no console do Amazon S3, essas mesmas métricas podem demorar algumas horas para serem exibidas no CloudWatch. Quando você habilita a opção de publicação do CloudWatch para métricas do S3 Storage Lens pela primeira vez, as métricas podem levar até 24 horas para serem publicadas no CloudWatch. Para obter mais informações sobre métricas e dimensões do S3 Storage Lens no CloudWatch, consulte os tópicos a seguir. **Topics** + [ ## Métricas ](#storage-lens-cloudwatch-metrics) + [ ## Dimensões ](#storage-lens-cloudwatch-dimensions) ## Métricas As métricas da Lente de Armazenamento do S3 estão disponíveis como métricas no CloudWatch. As métricas do S3 Storage Lens são publicadas no namespace `AWS/S3/Storage-Lens` do CloudWatch. Este namespace serve apenas para métricas do S3 Storage Lens. As métricas de bucket, solicitação e replicação do Amazon S3 são publicadas no namespace `AWS/S3`. As métricas do S3 Storage Lens são publicadas no CloudWatch na conta proprietária da configuração do S3 Storage Lens. Após a habilitação da opção de publicação do CloudWatch em métricas avançadas, é possível acessar as métricas em nível de conta e em nível de bucket por ID de configuração, conta, bucket (somente para métricas em nível de bucket), região e classe de armazenamento no CloudWatch. As métricas de nível prefixo não estão disponíveis no CloudWatch. No S3 Storage Lens, as métricas são agregadas e armazenadas somente na região inicial designada. As métricas do S3 Storage Lens também são publicadas no CloudWatch na região inicial especificada na configuração do S3 Storage Lens. Para obter uma lista completa das métricas do S3 Storage Lens, inclusive uma lista dessas métricas disponíveis no CloudWatch, consulte [Glossário de métricas de lente de armazenamento do Amazon S3](storage_lens_metrics_glossary.md). **nota** A estatística válida para métricas do S3 Storage Lens no CloudWatch é Average. Para obter mais informações sobre estatísticas no CloudWatch, consulte [Definições de estatísticas do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Statistics-definitions.html) no *Guia do usuário do Amazon CloudWatch*. ### Detalhamento das métricas do S3 Storage Lens no CloudWatch O S3 Storage Lens oferece métricas com detalhamento de organização, conta, bucket e prefixo. O S3 Storage Lens publica métricas do S3 Storage Lens em nível de organização, conta e bucket no CloudWatch. As métricas de nível prefixo do S3 Storage não estão disponíveis no CloudWatch. Para obter mais informações sobre o detalhamento das métricas do S3 Storage Lens disponíveis no CloudWatch, consulte a lista a seguir: + **Organização**: métricas agregadas entre as contas dos membros de sua organização. O S3 Storage Lens publica métricas de contas de membros no CloudWatch na conta de gerenciamento. + **Organização e conta**: métricas de contas de membros de sua organização. + **Organização e bucket**: métricas de buckets do Amazon S3 de contas de membros de sua organização. + **Conta** (nível não organizacional): métricas agregadas entre os buckets de sua conta. + **Bucket** (nível não organizacional): métricas de um bucket específico. No CloudWatch, o S3 Storage Lens publica essas métricas na Conta da AWS que criou a configuração do S3 Storage Lens. O S3 Storage Lens publica essas métricas somente de configurações não organizacionais. ## Dimensões Quando a Lente de Armazenamento do S3 envia dados para o CloudWatch, dimensões são anexadas a cada métrica. As dimensões são categorias que descrevem as características das métricas. Você pode usar dimensões para filtrar os resultados que o CloudWatch retorna. Por exemplo, todas as métricas do S3 Storage Lens no CloudWatch têm a dimensão `configuration_id`. É possível usar essa dimensão para diferenciar as métricas associadas a uma configuração específica do S3 Storage Lens. O `organization_id` identifica métricas no nível da organização. Para obter mais informações sobre dimensões no CloudWatch, consulte [Dimensões](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Dimension) no *Guia do usuário do CloudWatch*. Há diferentes dimensões disponíveis para métricas da Lente de Armazenamento do S3, conforme o detalhamento das métricas. Por exemplo, você pode usar a dimensão `organization_id` para filtrar métricas no nível da organização pelo ID do AWS Organizations. No entanto, não é possível usar essa dimensão para métricas de bucket e conta. Para obter mais informações, consulte [Filtrar métricas usando dimensões](storage-lens-cloudwatch-monitoring-cloudwatch.md#storage-lens-cloudwatch-monitoring-cloudwatch-dimensions). Para ver quais dimensões estão disponíveis para sua configuração do S3 Storage Lens, consulte a tabela a seguir. | **Dimensão** | **Descrição** | **Bucket** | **Conta da** | **Organização** | **Organização e bucket** | **Organização e conta** | | --- | --- | --- | --- | --- | --- | --- | | configuration\$1id | O nome do painel para a configuração da Lente de Armazenamento do S3 relatada nas métricas | ![\[Yes\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/icon-yes.png) | ![\[Yes\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/icon-yes.png) | ![\[Yes\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/icon-yes.png) | ![\[Yes\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/icon-yes.png) | ![\[Yes\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/icon-yes.png) | | metrics\$1version | A versão das métricas da Lente de Armazenamento do S3. A versão das métricas tem um valor fixo de `1.0`. | ![\[Yes\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/icon-yes.png) | ![\[Yes\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/icon-yes.png) | ![\[Yes\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/icon-yes.png) | ![\[Yes\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/icon-yes.png) | ![\[Yes\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/icon-yes.png) | | organization\$1id | O ID do AWS Organizations das métricas | ![\[No\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/icon-no.png) | ![\[No\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/icon-no.png) | ![\[Yes\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/icon-yes.png) | ![\[Yes\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/icon-yes.png) | ![\[Yes\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/icon-yes.png) | | aws\$1account\$1number | A Conta da AWS associada às métricas. | ![\[Yes\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/icon-yes.png) | ![\[Yes\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/icon-yes.png) | ![\[No\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/icon-no.png) | ![\[Yes\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/icon-yes.png) | ![\[Yes\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/icon-yes.png) | | aws\$1region | A Região da AWS das métricas | ![\[Yes\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/icon-yes.png) | ![\[Yes\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/icon-yes.png) | ![\[Yes\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/icon-yes.png) | ![\[Yes\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/icon-yes.png) | ![\[Yes\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/icon-yes.png) | | bucket\$1name | O nome do bucket do S3 relatado nas métricas | ![\[Yes\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/icon-yes.png) | ![\[No\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/icon-no.png) | ![\[No\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/icon-no.png) | ![\[Yes\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/icon-yes.png) | ![\[No\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/icon-no.png) | | storage\$1class | A classe de armazenamento do bucket relatado nas métricas | ![\[Yes\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/icon-yes.png) | ![\[Yes\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/icon-yes.png) | ![\[Yes\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/icon-yes.png) | ![\[Yes\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/icon-yes.png) | ![\[Yes\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/icon-yes.png) | | record\$1type | O detalhamento das métricas: ORGANIZATION, ACCOUNT, BUCKET | ![\[Yes\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/icon-yes.png) BUCKET | ![\[Yes\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/icon-yes.png) ACCOUNT | ![\[Yes\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/icon-yes.png) BUCKET | ![\[Yes\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/icon-yes.png) ACCOUNT | ![\[Yes\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/images/icon-yes.png) ORGANIZATION | # Habilitar publicação no CloudWatch para o S3 Storage Lens É possível publicar métricas da Lente de Armazenamento do S3 no Amazon CloudWatch para criar uma visão unificada de sua integridade operacional nos [painéis do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html). Também é possível usar os recursos do CloudWatch, como alarmes e ações acionadas, matemática métrica e detecção de anomalias, para monitorar e realizar ações sobre as métricas da Lente de Armazenamento do S3. Além disso, as operações de API do CloudWatch permitem que aplicações, inclusive provedores de terceiros, acessem as métricas da Lente de Armazenamento do S3. Para ter mais informações sobre os recursos do CloudWatch, consulte o [Guia do usuário do Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html). As métricas do S3 Storage Lens são publicadas no CloudWatch na conta proprietária da configuração do S3 Storage Lens. Após a habilitação da opção de publicação do CloudWatch em métricas avançadas, é possível acessar as métricas em nível de conta e em nível de bucket por ID de configuração, conta, bucket (somente para métricas em nível de bucket), região e classe de armazenamento no CloudWatch. As métricas de nível prefixo não estão disponíveis no CloudWatch. Você pode habilitar o suporte do CloudWatch a configurações de painéis novos ou existentes usando o console do S3, as APIs REST do Amazon S3, a AWS CLI e os AWS SDKs. A opção de publicação no CloudWatch está disponível para painéis com upgrade para métricas e recomendações avançadas da Lente de Armazenamento do S3. Para saber mais sobre o preço das métricas e recomendações avançadas da Lente de Armazenamento do S3, consulte [Definição de preço do Amazon S3](https://aws.amazon.com/s3/pricing/). Não são aplicadas cobranças adicionais para publicação de métricas no CloudWatch, mas outras cobranças do CloudWatch, como painéis, alarmes e chamadas de API, são aplicáveis. Para habilitar a opção de publicação de métricas do S3 Storage Lens no CloudWatch, consulte os tópicos a seguir. **nota** As métricas do S3 Storage Lens são métricas diárias e são publicadas no CloudWatch uma vez por dia. Quando você consulta métricas do S3 Storage Lens no CloudWatch, o período para a consulta deve ser de 1 dia (86.400 segundos). Depois que as métricas diárias do S3 Storage Lens são exibidas no painel do S3 Storage Lens no console do Amazon S3, essas mesmas métricas podem demorar algumas horas para serem exibidas no CloudWatch. Quando você habilita a opção de publicação do CloudWatch para métricas do S3 Storage Lens pela primeira vez, as métricas podem levar até 24 horas para serem publicadas no CloudWatch. No momento, as métricas da Lente de Armazenamento do S3 não podem ser consumidas por fluxos do CloudWatch. ## Usar o console do S3 Ao atualizar um painel da Lente de Armazenamento do S3, não é possível alterar o nome do painel nem a região inicial. Também não é possível alterar o escopo do painel padrão, que está definido como o armazenamento de toda a sua conta. **Como atualizar um painel da Lente de Armazenamento do S3 para habilitar a publicação no CloudWatch** 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 esquerdo, escolha **S3 Storage Lens** (Lente de Armazenamento do S3) e **Dashboards** (Painéis). 1. Escolha o painel que você deseja editar e escolha **Edit** (Editar). 1. Em **Metrics selection** (Seleção de métricas), escolha **Advanced metrics and recommendations** (Métricas e recomendações avançadas). As métricas e recomendações avançadas estão disponíveis mediante cobranças adicionais. As métricas e recomendações avançadas incluem um período de 15 meses para consultas de dados, métricas de uso agregadas por prefixo, métricas de atividade agregadas por bucket, opção de publicação no CloudWatch e recomendações contextuais que ajudam a otimizar os custos de armazenamento e aplicar as práticas recomendadas de proteção de dados. Para obter mais informações, consulte [Preço do Amazon S3](https://aws.amazon.com/s3/pricing/). 1. Em **Select Advanced metrics and recommendations features**, (Selecionar recursos de métricas e recomendações avançadas), escolha **CloudWatch publishing** (Publicação no CloudWatch). **Importante** Se a configuração permitir a agregação de prefixos para métricas de uso, as métricas de nível de prefixo não serão publicadas no CloudWatch. Somente métricas em nível de organização, conta e bucket do S3 Storage Lens são publicadas no CloudWatch. 1. Escolha **Salvar alterações**. **Para criar um novo painel do S3 Storage Lens que habilite o suporte ao CloudWatch** 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 esquerdo, escolha **Storage Lens** (Lente de Armazenamento) e **Dashboards** (Painéis). 1. Escolha **Create dashboard (Criar painel)**. 1. Em **General** (Geral), defina as seguintes opções de configuração: 1. Em **Dashboard name** (Nome do painel), insira o nome do painel. Os nomes do painel devem ter menos de 65 caracteres e não devem conter caracteres ou espaços especiais. Não é possível alterar o nome do painel depois que o painel é criado. 1. Escolha a **Home Region** (Região inicial) do painel. As métricas de todas as regiões incluídas neste escopo do painel são armazenadas centralmente nesta região inicial designada. No CloudWatch, as métricas do S3 Storage Lens também estão disponíveis na região inicial. Não é possível alterar a região inicial depois que o painel é criado. 1. (Opcional) Para adicionar etiquetas, escolha **Add tag** (Adicionar etiqueta) e insira a **Key** (Chave) e o **Value** (Valor) da etiqueta. **nota** Você pode adicionar até 50 tags à configuração do painel. 1. Defina o escopo de sua configuração: 1. Se você estiver criando uma configuração no nível da organização, escolha as contas a serem incluídas na configuração: **Include all accounts in your configuration** (Incluir todas as contas na configuração) ou **Limit the scope to your signed-in account** (Limitar o escopo à sua conta conectada). **nota** Ao criar uma configuração no nível da organização que inclui todas as contas, não será possível incluir ou excluir buckets, apenas regiões. 1. Escolha as regiões e os buckets que deseja que a Lente de Armazenamento do S3 inclua na configuração do painel fazendo o seguinte: + Para incluir todas as regiões, selecione **Include Regions and buckets** (Incluir regiões e buckets). + Para incluir regiões específicas, desmarque a opção **Include all Regions** (Incluir todas as regiões). Em **Choose Regions to include** (Escolher regiões a serem incluídas), escolha as regiões que deseja que o S3 Storage Lens inclua no painel. + Para incluir bucket específicos, desmarque a opção **Include all buckets** (Incluir todos os buckets). Em **Choose buckets to include** (Escolher buckets a serem incluídos), escolha os buckets que deseja que o S3 Storage Lens inclua no painel. **nota** Você pode escolher até 50 buckets. 1. Em **Metrics selection** (Seleção de métricas), escolha **Advanced metrics and recommendations** (Métricas e recomendações avançadas). Para obter mais informações sobre o preço das métricas e recomendações avançadas, consulte [Preços do Amazon S3](https://aws.amazon.com/s3/pricing/). 1. Em **Advanced metrics and recommendations features** (Recursos de métricas e recomendações avançadas), selecione as opções que deseja habilitar: + **Advanced metrics (Métricas avançadas** + **Publicação no CloudWatch** **Importante** Se você habilitar a agregação de prefixos na configuração do S3 Storage Lens, as métricas de nível de prefixo não serão publicadas no CloudWatch. Somente métricas em nível de organização, conta e bucket do S3 Storage Lens são publicadas no CloudWatch. + **Agregação de prefixo** **nota** Para obter mais informações sobre os recursos de métricas e recomendações avançadas, consulte [Seleção de métricas](storage_lens_basics_metrics_recommendations.md#storage_lens_basics_metrics_selection). 1. Se você ativou **Advanced metrics** (Métricas avançadas), selecione as **Advanced metrics categories** (Categorias de métricas avançadas) que deseja exibir no painel da Lente de Armazenamento do S3: + **Métricas de atividade** + **Detailed status code metrics (Métricas detalhadas do código de status** + **Advanced cost optimization metrics (Métricas avançadas de otimização de custos** + **Advanced data protection metrics (Métricas avançadas de proteção de dados** Para obter mais informações sobre categorias de métricas, consulte [Categorias de métricas](storage_lens_basics_metrics_recommendations.md#storage_lens_basics_metrics_types). Para obter uma lista completa de métricas, consulte [Glossário de métricas de lente de armazenamento do Amazon S3](storage_lens_metrics_glossary.md). 1. (Opcional) Configure a exportação de métricas. Para obter mais informações sobre como configurar a exportação de métricas, consulte [Usar o console do S3](storage_lens_creating_dashboard.md#storage_lens_console_creating). 1. Escolha **Create dashboard (Criar painel)**. ## Como usar o AWS CLI O seguinte exemplo da AWS CLI habilita a opção de publicação no CloudWatch usando uma configuração de métricas e recomendações avançadas em nível de organização da Lente de Armazenamento do S3. Para usar esse exemplo, substitua os `user input placeholders` por suas próprias informações. ``` aws s3control put-storage-lens-configuration --account-id=555555555555 --config-id=your-configuration-id --region=us-east-1 --storage-lens-configuration=file://./config.json config.json { "Id": "SampleS3StorageLensConfiguration", "AwsOrg": { "Arn": "arn:aws:organizations::123456789012:organization/o-abcdefgh" }, "AccountLevel": { "ActivityMetrics": { "IsEnabled":true }, "AdvancedCostOptimizationMetrics": { "IsEnabled":true }, "AdvancedDataProtectionMetrics": { "IsEnabled":true }, "DetailedStatusCodesMetrics": { "IsEnabled":true }, "BucketLevel": { "ActivityMetrics": { "IsEnabled":true }, "AdvancedCostOptimizationMetrics": { "IsEnabled":true }, "DetailedStatusCodesMetrics": { "IsEnabled":true }, "PrefixLevel":{ "StorageMetrics":{ "IsEnabled":true, "SelectionCriteria":{ "MaxDepth":5, "MinStorageBytesPercentage":1.25, "Delimiter":"/" } } } } }, "Exclude": { "Regions": [ "eu-west-1" ], "Buckets": [ "arn:aws:s3:::amzn-s3-demo-source-bucket " ] }, "IsEnabled": true, "DataExport": { "S3BucketDestination": { "OutputSchemaVersion": "V_1", "Format": "CSV", "AccountId": "111122223333", "Arn": "arn:aws:s3:::amzn-s3-demo-destination-bucket", "Prefix": "prefix-for-your-export-destination", "Encryption": { "SSES3": {} } }, "CloudWatchMetrics": { "IsEnabled": true } } } ``` ## Usar o AWS SDK for Java ``` package aws.example.s3control; import com.amazonaws.AmazonServiceException; import com.amazonaws.SdkClientException; import com.amazonaws.auth.profile.ProfileCredentialsProvider; import com.amazonaws.services.s3control.AWSS3Control; import com.amazonaws.services.s3control.AWSS3ControlClient; import com.amazonaws.services.s3control.model.AccountLevel; import com.amazonaws.services.s3control.model.ActivityMetrics; import com.amazonaws.services.s3control.model.BucketLevel; import com.amazonaws.services.s3control.model.CloudWatchMetrics; import com.amazonaws.services.s3control.model.Format; import com.amazonaws.services.s3control.model.Include; import com.amazonaws.services.s3control.model.OutputSchemaVersion; import com.amazonaws.services.s3control.model.PrefixLevel; import com.amazonaws.services.s3control.model.PrefixLevelStorageMetrics; import com.amazonaws.services.s3control.model.PutStorageLensConfigurationRequest; import com.amazonaws.services.s3control.model.S3BucketDestination; import com.amazonaws.services.s3control.model.SSES3; import com.amazonaws.services.s3control.model.SelectionCriteria; import com.amazonaws.services.s3control.model.StorageLensAwsOrg; import com.amazonaws.services.s3control.model.StorageLensConfiguration; import com.amazonaws.services.s3control.model.StorageLensDataExport; import com.amazonaws.services.s3control.model.StorageLensDataExportEncryption; import com.amazonaws.services.s3control.model.StorageLensTag; import java.util.Arrays; import java.util.List; import static com.amazonaws.regions.Regions.US_WEST_2; public class CreateAndUpdateDashboard { public static void main(String[] args) { String configurationId = "ConfigurationId"; String sourceAccountId = "Source Account ID"; String exportAccountId = "Destination Account ID"; String exportBucketArn = "arn:aws:s3:::amzn-s3-demo-destination-bucket"; // The destination bucket for your metrics export must be in the same Region as your S3 Storage Lens configuration. String awsOrgARN = "arn:aws:organizations::123456789012:organization/o-abcdefgh"; Format exportFormat = Format.CSV; try { SelectionCriteria selectionCriteria = new SelectionCriteria() .withDelimiter("/") .withMaxDepth(5) .withMinStorageBytesPercentage(10.0); PrefixLevelStorageMetrics prefixStorageMetrics = new PrefixLevelStorageMetrics() .withIsEnabled(true) .withSelectionCriteria(selectionCriteria); BucketLevel bucketLevel = new BucketLevel() .withActivityMetrics(new ActivityMetrics().withIsEnabled(true)) .withAdvancedCostOptimizationMetrics(new AdvancedCostOptimizationMetrics().withIsEnabled(true)) .withAdvancedDataProtectionMetrics(new AdvancedDataProtectionMetrics().withIsEnabled(true)) .withDetailedStatusCodesMetrics(new DetailedStatusCodesMetrics().withIsEnabled(true)) .withPrefixLevel(new PrefixLevel().withStorageMetrics(prefixStorageMetrics)); AccountLevel accountLevel = new AccountLevel() .withActivityMetrics(new ActivityMetrics().withIsEnabled(true)) .withAdvancedCostOptimizationMetrics(new AdvancedCostOptimizationMetrics().withIsEnabled(true)) .withAdvancedDataProtectionMetrics(new AdvancedDataProtectionMetrics().withIsEnabled(true)) .withDetailedStatusCodesMetrics(new DetailedStatusCodesMetrics().withIsEnabled(true)) .withBucketLevel(bucketLevel); Include include = new Include() .withBuckets(Arrays.asList("arn:aws:s3:::amzn-s3-demo-bucket")) .withRegions(Arrays.asList("us-west-2")); StorageLensDataExportEncryption exportEncryption = new StorageLensDataExportEncryption() .withSSES3(new SSES3()); S3BucketDestination s3BucketDestination = new S3BucketDestination() .withAccountId(exportAccountId) .withArn(exportBucketArn) .withEncryption(exportEncryption) .withFormat(exportFormat) .withOutputSchemaVersion(OutputSchemaVersion.V_1) .withPrefix("Prefix"); CloudWatchMetrics cloudWatchMetrics = new CloudWatchMetrics() .withIsEnabled(true); StorageLensDataExport dataExport = new StorageLensDataExport() .withCloudWatchMetrics(cloudWatchMetrics) .withS3BucketDestination(s3BucketDestination); StorageLensAwsOrg awsOrg = new StorageLensAwsOrg() .withArn(awsOrgARN); StorageLensConfiguration configuration = new StorageLensConfiguration() .withId(configurationId) .withAccountLevel(accountLevel) .withInclude(include) .withDataExport(dataExport) .withAwsOrg(awsOrg) .withIsEnabled(true); List tags = Arrays.asList( new StorageLensTag().withKey("key-1").withValue("value-1"), new StorageLensTag().withKey("key-2").withValue("value-2") ); AWSS3Control s3ControlClient = AWSS3ControlClient.builder() .withCredentials(new ProfileCredentialsProvider()) .withRegion(US_WEST_2) .build(); s3ControlClient.putStorageLensConfiguration(new PutStorageLensConfigurationRequest() .withAccountId(sourceAccountId) .withConfigId(configurationId) .withStorageLensConfiguration(configuration) .withTags(tags) ); } catch (AmazonServiceException e) { // The call was transmitted successfully, but Amazon S3 couldn't process // it and returned an error response. e.printStackTrace(); } catch (SdkClientException e) { // Amazon S3 couldn't be contacted for a response, or the client // couldn't parse the response from Amazon S3. e.printStackTrace(); } } } ``` ## Uso da API REST Para habilitar a opção de publicação no CloudWatch usando a API REST do Amazon S3, use [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutStorageLensConfiguration.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_PutStorageLensConfiguration.html). **Próximas etapas** Depois de habilitar a opção de publicação no CloudWatch, você poderá acessar as métricas do S3 Storage Lens no CloudWatch. Você também pode utilizar os recursos do CloudWatch para monitorar e analisar os dados do S3 Storage Lens no CloudWatch. Para saber mais, consulte os seguintes tópicos: + [Métricas e dimensões do S3 Storage Lens](storage-lens-cloudwatch-metrics-dimensions.md) + [Trabalhar com métricas do S3 Storage Lens no CloudWatch](storage-lens-cloudwatch-monitoring-cloudwatch.md) # Trabalhar com métricas do S3 Storage Lens no CloudWatch É possível publicar métricas da Lente de Armazenamento do S3 no Amazon CloudWatch para criar uma visão unificada de sua integridade operacional nos [painéis do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html). Também é possível usar os recursos do CloudWatch, como alarmes e ações acionadas, matemática métrica e detecção de anomalias, para monitorar e realizar ações sobre as métricas da Lente de Armazenamento do S3. Além disso, as operações de API do CloudWatch permitem que aplicações, inclusive provedores de terceiros, acessem as métricas da Lente de Armazenamento do S3. Para ter mais informações sobre os recursos do CloudWatch, consulte o [Guia do usuário do Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html). Você pode habilitar a opção de publicação no CloudWatch para configurações de painéis novos ou existentes usando o console do Amazon S3, as APIs REST do Amazon S3, a AWS CLI e os AWS SDKs. A opção de publicação no CloudWatch está disponível para painéis com upgrade para métricas e recomendações avançadas da Lente de Armazenamento do S3. Para saber mais sobre o preço das métricas e recomendações avançadas da Lente de Armazenamento do S3, consulte [Definição de preço do Amazon S3](https://aws.amazon.com/s3/pricing/). Não são aplicadas cobranças adicionais para publicação de métricas no CloudWatch, mas outras cobranças do CloudWatch, como painéis, alarmes e chamadas de API, são aplicáveis. Para saber mais, consulte [Preço do Amazon CloudWatch](https://aws.amazon.com/cloudwatch/pricing/). As métricas do S3 Storage Lens são publicadas no CloudWatch na conta proprietária da configuração do S3 Storage Lens. Após a habilitação da opção de publicação do CloudWatch em métricas avançadas, é possível acessar as métricas em nível de conta e em nível de bucket por ID de configuração, conta, bucket (somente para métricas em nível de bucket), região e classe de armazenamento no CloudWatch. As métricas de nível prefixo não estão disponíveis no CloudWatch. **nota** As métricas do S3 Storage Lens são métricas diárias e são publicadas no CloudWatch uma vez por dia. Quando você consulta métricas do S3 Storage Lens no CloudWatch, o período para a consulta deve ser de 1 dia (86.400 segundos). Depois que as métricas diárias do S3 Storage Lens são exibidas no painel do S3 Storage Lens no console do Amazon S3, essas mesmas métricas podem demorar algumas horas para serem exibidas no CloudWatch. Quando você habilita a opção de publicação do CloudWatch para métricas do S3 Storage Lens pela primeira vez, as métricas podem levar até 24 horas para serem publicadas no CloudWatch. No momento, as métricas da Lente de Armazenamento do S3 não podem ser consumidas por fluxos do CloudWatch. Para obter mais informações sobre como trabalhar com métricas do S3 Storage Lens no CloudWatch, consulte os tópicos a seguir. **Topics** + [ ## Trabalhar com painéis do CloudWatch ](#storage-lens-cloudwatch-monitoring-cloudwatch-dashboards) + [ ## Definir alarmes, acionar ações e usar detecção de anomalias ](#storage-lens-cloudwatch-monitoring-cloudwatch-alarms) + [ ## Filtrar métricas usando dimensões ](#storage-lens-cloudwatch-monitoring-cloudwatch-dimensions) + [ ## Calcular novas métricas com matemática métrica ](#storage-lens-cloudwatch-monitoring-cloudwatch-metric-math) + [ ## Usar expressões de pesquisa em gráficos ](#storage-lens-cloudwatch-monitoring-cloudwatch-search-expressions) ## Trabalhar com painéis do CloudWatch É possível usar os painéis do CloudWatch para monitorar as métricas do S3 Storage Lens juntamente com métricas de outras aplicações e criar uma visão unificada de sua integridade operacional. Os painéis são páginas iniciais personalizáveis no console do CloudWatch que você pode usar para monitorar seus recursos em uma única visualização. O CloudWatch tem amplo controle de permissões que não oferece suporte ao limite de acesso a um conjunto específico de métricas ou dimensões. Os usuários de sua conta ou organização que têm acesso ao CloudWatch terão acesso a métricas para todas as configurações do S3 Storage Lens em que a opção de suporte do CloudWatch estiver habilitada. Não é possível gerenciar permissões para painéis específicos, como pode ser feito no S3 Storage Lens. Para obter mais informações sobre permissões do CloudWatch, consulte [Gerenciamento de permissões de acesso a seus recursos do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/iam-access-control-overview-cw.html) no *Guia do usuário do Amazon CloudWatch*. Para obter mais informações sobre como usar painéis do CloudWatch e configurar permissões, consulte [Usar painéis do Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html) e [Compartilhar painéis do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch-dashboard-sharing.html) no *Guia do usuário do Amazon CloudWatch*. ## Definir alarmes, acionar ações e usar detecção de anomalias Você pode configurar alarmes do CloudWatch que monitoram as métricas do S3 Storage Lens no CloudWatch e realizam ações quando um limite é violado. Por exemplo, é possível configurar um alarme que envia uma notificação do Amazon SNS quando a métrica **Incomplete Multipart Upload Bytes** (Bytes de multipart uploads incompletos) exceder 1 GB por três dias consecutivos. Também é possível habilitar a detecção de anomalias para analisar continuamente as métricas do S3 Storage Lens, determinar linhas de base normais e apontar anomalias. Você pode criar um alarme de detecção de anomalias com base no valor esperado de uma métrica. Por exemplo, é possível monitorar anomalias na métrica **Object Lock Enabled Bytes** (Bytes de Bloqueio de Objeto ativado) para detectar a remoção não autorizada das configurações de Bloqueio de Objeto. Para obter mais informações e exemplos, consulte [Usar alarmes do Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html) e [Criar um alarme da métrica em um grafo](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create_alarm_metric_graph.html) no *Guia do usuário do Amazon CloudWatch*. ## Filtrar métricas usando dimensões Use dimensões para filtrar métricas do S3 Storage Lens no console do CloudWatch. Por exemplo, é possível filtrar por `configuration_id`, `aws_account_number`, `aws_region`, `bucket_name` e muito mais. O S3 Storage Lens oferece suporte a várias configurações de painel por conta. Isso significa que configurações diferentes podem incluir o mesmo bucket. Quando essas métricas forem publicadas no CloudWatch, o bucket terá métricas duplicadas no CloudWatch. Para exibir métricas somente para uma configuração específica do S3 Storage Lens no CloudWatch, você pode usar a dimensão `configuration_id`. Ao filtrar por `configuration_id`, você visualiza apenas métricas associadas à configuração que você identificou. Para obter mais informações sobre filtragem por ID de configuração, consulte [Procurar as métricas disponíveis](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/finding_metrics_with_cloudwatch.html) no *Guia do usuário do Amazon CloudWatch*. ## Calcular novas métricas com matemática métrica Você pode usar a matemática métrica para consultar várias métricas do S3 Storage Lens e usar expressões matemáticas para criar novas séries temporais de acordo com essas métricas. Por exemplo, é possível criar uma nova métrica para objetos não criptografados subtraindo os objetos criptografados da contagem de objetos. Também é possível criar uma métrica para obter o tamanho médio de objetos dividindo `StorageBytes` por `ObjectCount`, ou o número de bytes acessados em um dia dividindo `BytesDownloaded` por `StorageBytes`. Para obter mais informações, consulte [Usar matemática métrica](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html) no *Guia do usuário do Amazon CloudWatch*. ## Usar expressões de pesquisa em gráficos Com as métricas da Lente de Armazenamento do S3, é possível criar uma expressão de pesquisa. Por exemplo, é possível criar uma expressão de pesquisa para todas as métricas chamadas **IncompleteMultipartUploadStorageBytes** e adicionar `SUM` à expressão. Com essa expressão de pesquisa, é possível visualizar o total de bytes de multipart uploads incompletos em todas as dimensões do armazenamento em uma única métrica. Este exemplo mostra a sintaxe que você usaria para criar uma expressão de pesquisa para todas as métricas chamadas **IncompleteMultipartUploadStorageBytes**. ``` SUM(SEARCH('{AWS/S3/Storage-Lens,aws_account_number,aws_region,configuration_id,metrics_version,record_type,storage_class} MetricName="IncompleteMultipartUploadStorageBytes"', 'Average',86400)) ``` Para obter mais informações sobre essa sintaxe, consulte [Sintaxe de expressão de pesquisa do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/search-expression-syntax.html) no *Guia do usuário do Amazon CloudWatch*. Para criar um grafo do CloudWatch com uma expressão de pesquisa, consulte [Criar um grafo do CloudWatch com uma expressão de pesquisa](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create-search-expression.html) no *Guia do usuário do Amazon CloudWatch*.