Atualizar um painel da Lente de Armazenamento do Amazon S3 - Amazon Simple Storage Service

Atualizar um painel da Lente de Armazenamento do Amazon S3

O painel padrão da Lente de Armazenamento do Amazon S3 é default-account-dashboard. Esse painel é pré-configurado pelo Amazon S3 para ajudar você a visualizar tendências e insights resumidos para as métricas gratuitas e avançadas agregadas de toda a sua conta no console. Você não pode modificar o escopo de configuração padrão do painel, mas pode atualizar a seleção de métricas das métricas gratuitas para as métricas e recomendações avançadas pagas, configurar a exportação opcional de métricas ou até mesmo desativar o painel padrão. O painel padrão não pode ser excluído, só pode ser desabilitado. Para obter mais informações, consulte Usar o console do S3.

Use as etapas a seguir para atualizar um painel do Amazon S3 Storage Lens no console do Amazon S3.

Etapa 1: atualizar o painel e definir configurações gerais

  1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em https://console.aws.amazon.com/s3/.

  2. No painel de navegação esquerdo, escolha Storage Lens, Dashboards (Lente de Armazenamento, Painéis).

  3. Escolha o painel que você deseja editar.

  4. Selecione Exibir configuração do painel.

  5. Escolha Editar. Agora você pode analisar detalhadamente a configuração do painel. Para fazer alterações em qualquer uma das etapas, clique diretamente na etapa usando a navegação à esquerda. Para ver instruções sobre como atualizar essas etapas:

    nota

    Você não pode alterar o seguinte:

    • O nome do painel

    • A região inicial

  6. Na página Painel, na seção Geral, é possível alterar o seguinte:

    • Escolha Habilitado ou Desabilitado para indicar se você está recebendo métricas diárias em seu painel.

    • (Opcional) Você pode optar por adicionar tags ao seu painel. Você pode usar tags para gerenciar permissões para seu painel e rastrear os custos para o S3 Storage Lens. Para obter mais informações, consulte Controlar o acesso a recursos da AWS usando tags no Guia do usuário do IAM e Usar tags geradas pela AWS no Guia do usuário do AWS Billing.

    nota

    Você pode adicionar até 50 tags à configuração do painel.

  7. Escolha Próximo para salvar as alterações e prosseguir.

Etapa 2: Atualizar o escopo do painel

  1. Na seção Escopo do painel, atualize as regiões e os buckets que deseja que a Lente de Armazenamento do S3 inclua ou exclua do painel.

    nota

    • Você pode incluir ou excluir regiões e buckets. Essa opção é limitada a regiões somente ao criar painéis no nível da organização em contas de membro na sua organização.

    • Você pode escolher até cinquenta buckets para incluir ou excluir.

  2. Escolha os buckets nas regiões selecionadas que deseja que o S3 Storage Lens inclua ou exclua. Você pode incluir ou excluir buckets, mas não ambos. Essa opção não está disponível quando ao criar painéis em nível de organização.

    nota

    • Você pode incluir ou excluir regiões e buckets. Essa opção é limitada a regiões somente ao criar painéis no nível da organização em contas de membro na sua organização.

    • Você pode escolher até cinquenta buckets para incluir ou excluir.

  3. Escolha Próximo para salvar as alterações e prosseguir.

Etapa 3: atualizar o nível da Lente de Armazenamento e configurar a seleção de métricas

  1. Na seção Seleção de métricas de Nível da Lente de Armazenamento, atualize o nível de métricas que você deseja agregar para esse painel.

    nota

    • Se você estiver atualizando do nível gratuito para o nível avançado, precisará atualizar suas configurações em Agregação de métricas. Para atualizar suas configurações de agregação de métricas, consulte Etapa 4: atualizar a agregação de métricas.

    • Se você estiver atualizando o nível da Lente de Armazenamento do nível avançado para o nível gratuito, não precisará atualizar nenhuma configuração de agregação de métricas. O recurso de agregação de métricas se aplica somente às categorias de métricas de nível avançado.

  2. Para incluir métricas gratuitas agregadas por bucket e disponíveis para consultas por 14 dias, escolha Nível gratuito.

  3. Para habilitar métricas avançadas, escolha Nível avançado. Essas opções incluem agregação de prefixos, publicação no Amazon CloudWatch e recomendações contextuais. Os dados ficam disponíveis para consultas por 15 meses. As métricas e recomendações avançadas têm um custo adicional. Para obter mais informações, consulte Preço do Amazon S3.

    Para obter mais informações sobre métricas avançadas e métricas gratuitas, consulte Seleção de métricas.

  4. Em Categorias de métricas avançadas, escolha a categoria de métricas que deseja habilitar:

    • Métricas de atividade

    • Detailed status code metrics (Métricas detalhadas do código de status

    • Métricas de otimização de custos

    • Métricas de proteção de dados

    • Métricas de performance

    Para visualizar quais métricas estão incluídas em cada categoria, use o botão de seta suspenso abaixo da lista de caixas de seleção da categoria de métricas. Para obter mais informações sobre categorias de métricas, consulte Categorias de métricas. Para obter uma lista completa de métricas, consulte Glossário de métricas de lente de armazenamento do Amazon S3.

  5. Escolha ou especifique um delimitador de prefixo para distinguir os níveis em cada prefixo. Este valor é usado para identificar cada nível de prefixo. O valor padrão no Amazon S3 é o caractere “/“, mas sua estrutura de armazenamento pode usar outros caracteres delimitadores.

  6. Escolha Próximo para salvar as alterações e prosseguir.

Etapa 4: (opcional) atualizar a agregação de métricas

  1. Em Agregação de métricas adicionais, indique quais métricas você deseja agregar escolhendo uma das seguintes opções:

    • Agregação de prefixo

    • Agregação de grupos da Lente de Armazenamento

  2. Se você habilitou a Agregação de prefixo, especifique o limite de prefixo mínimo para o painel e a profundidade do prefixo. Escolha Próximo para salvar e prosseguir.

  3. Se você habilitou a Agregação de grupos do Storage Lens, escolha uma das seguintes opções:

    • Incluir grupos do Storage Lens

    • Excluir grupos do Storage Lens

  4. Ao incluir grupos da Lente de Armazenamento em sua agregação, é possível incluir todos os grupos da Lente de Armazenamento em sua região de origem ou especificar grupos da Lente de Armazenamento a serem incluídos.

  5. Escolha Próximo para salvar as alterações e prosseguir.

Etapa 5: (opcional) atualizar as configurações de exportação e publicação de métricas

  1. Em Publicação de métricas, escolha Publicação do CloudWatch se quiser acessar as métricas da Lente de Armazenamento no painel do CloudWatch.

    nota

    As métricas em nível de prefixo não estão disponíveis no CloudWatch.

  2. Em Exportação de métricas, escolha quais dados do painel da Lente de Armazenamento você deseja exportar diariamente:

    • Relatório de métricas padrão

    • Relatório ampliado de métricas de prefixos

  3. (Opcional) Se você escolheu Relatório de métricas padrão, nas configurações de Relatório de métricas padrão, escolha o tipo de bucket. É possível exportar o relatório para um bucket de uso geral do S3 ou um bucket de tabela somente leitura do S3. Com base no tipo de bucket selecionado, atualize as Configurações de destino no bucket de uso geral ou as opções de Configurações de destino no bucket de tabelas.

    nota

    • O relatório de métricas padrão inclui apenas prefixos dentro do limite e profundidade definidos nas configurações de agregação de prefixo. Se a agregação de prefixo ainda não estiver configurada, o limite inclui até os cem maiores prefixos por tamanho.

    • Se você optou por especificar uma chave de criptografia, deverá escolher uma chave do AWS KMS (SSE-KMS) ou uma chave gerenciada pelo Amazon S3 (SSE-S3). Se sua política de bucket de destino exigir criptografia, será necessário fornecer uma chave de criptografia para a exportação de métricas. Sem a chave de criptografia, a exportação para o S3 apresenta falha. Para obter mais informações, consulte Usar uma AWS KMS key para criptografar suas exportações de métricas.

  4. Escolha Próximo para salvar as alterações e prosseguir.

  5. (Opcional) Se você escolheu Relatório ampliado de métricas de prefixos nas configurações de Relatório ampliado de métricas de prefixos, escolha o tipo de bucket. É possível exportar o relatório para um bucket de uso geral do S3 ou um bucket de tabela somente leitura do S3. Com base no tipo de bucket selecionado, atualize as Configurações de destino no bucket de uso geral ou as Configurações de destino no bucket de tabelas.

    nota

    • O relatório ampliado de métricas de prefixos inclui prefixos em todos os buckets especificados no escopo do painel.

    • Se você optou por especificar uma chave de criptografia, deverá escolher uma chave do AWS KMS (SSE-KMS) ou uma chave gerenciada pelo Amazon S3 (SSE-S3). Se sua política de bucket de destino exigir criptografia, será necessário fornecer uma chave de criptografia para a exportação de métricas. Sem a chave de criptografia, a exportação para o S3 apresenta falha. Para obter mais informações, consulte Usar uma AWS KMS key para criptografar suas exportações de métricas.

  6. Escolha Próximo para salvar as alterações e prosseguir.

Etapa 6: analisar e atualizar a configuração do painel

  1. Na seção Geral, analise suas configurações. Escolha Editar para fazer quaisquer alterações.

  2. Na seção Escopo do painel, analise suas configurações. Escolha Editar para fazer quaisquer alterações.

  3. Na seção Nível da Lente de Armazenamento, analise suas configurações. Escolha Editar para fazer quaisquer alterações.

  4. Na seção Agregação de métricas, analise suas configurações. Escolha Editar para fazer quaisquer alterações.

  5. Na seção Exportação de métricas, analise suas configurações. Escolha Editar para fazer quaisquer alterações.

  6. Depois de analisar e confirmar todas as configurações do painel, escolha Enviar para atualizar o painel.

Depois que o novo painel da Lente de Armazenamento for atualizado com êxito, será possível visualizar a configuração atualizada na página Painel da Lente de Armazenamento.

exemplo

O exemplo de comando a seguir atualiza uma configuração de painel da Lente de Armazenamento do Amazon S3. Para usar esses exemplos, substitua os user input placeholders por suas próprias informações.

aws s3control put-storage-lens-configuration --account-id=111122223333 --config-id=example-dashboard-configuration-id --region=us-east-1 --storage-lens-configuration=file://./config.json --tags=file://./tags.json
exemplo– Atualizar uma configuração da Lente de Armazenamento do Amazon S3 com métricas e recomendações avançadas

Os exemplos a seguir mostram como atualizar a configuração padrão da Lente de Armazenamento do S3 com métricas e recomendações avançadas no SDK para 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.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 UpdateDefaultConfigWithPaidFeatures {

    public static void main(String[] args) {
        String configurationId = "default-account-dashboard"; // This configuration ID cannot be modified.
        String sourceAccountId = "111122223333";

        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))
                    .withPrefixLevel(new PrefixLevel().withStorageMetrics(prefixStorageMetrics));
            AccountLevel accountLevel = new AccountLevel()
                    .withActivityMetrics(new ActivityMetrics().withIsEnabled(true))
                    .withBucketLevel(bucketLevel);

            StorageLensConfiguration configuration = new StorageLensConfiguration()
                    .withId(configurationId)
                    .withAccountLevel(accountLevel)
                    .withIsEnabled(true);

            AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
                    .withCredentials(new ProfileCredentialsProvider())
                    .withRegion(US_WEST_2)
                    .build();

            s3ControlClient.putStorageLensConfiguration(new PutStorageLensConfigurationRequest()
                    .withAccountId(sourceAccountId)
                    .withConfigId(configurationId)
                    .withStorageLensConfiguration(configuration)
            );

        } 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();
        }
    }
}

Para acessar prefixos expandidos ou grupos da Lente de Armazenamento do S3, é necessário atualizar o painel para usar o nível avançado. Aplicam-se cobranças adicionais. Para ter mais informações sobre métricas do nível gratuito e do avançado, consulte Seleção de métricas. Para obter mais informações sobre grupos de Lente de Armazenamento do S3, consulte Trabalhar com grupos da Lente de Armazenamento do S3 para filtrar e agregar métricas.