Criação de uma configuração de métricas que filtre por prefixo, etiqueta de objeto ou ponto de acesso - Amazon Simple Storage Service

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

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.

  • 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 Categorizando seu armazenamento usando tags.

  • 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.

    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 pontos de acesso.

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 DeleteObjects e ListObjects, não retornam 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.

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

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

  3. Escolha a guia Metrics.

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

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

  6. Escolha Create Filter (Criar filtro).

  7. Na caixa Filter name (Nome do filtro), insira o nome do filtro.

    Nomes podem conter apenas letras, números, pontos, traços e sublinhados.

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

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

  10. Para definir um filtro de prefixo e limitar o escopo do filtro a um único caminho, na caixa Prefix (Prefixo), insira um prefixo.

  11. 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.

  12. 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.

  13. Escolha Salvar alterações.

    O Amazon S3 cria um filtro que usa o prefixo, as etiquetas ou o ponto de acesso especificado.

  14. 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.

    Você também pode configurar métricas de solicitação no nível de bucket. Para ter mais informações, consulte Criar uma configuração de métricas do CloudWatch para todos os objetos em seu bucket.

  1. Instalar e configurar a AWS CLI. Para obter instruções, consulte Instalação, atualização e desinstalação da AWS CLI no Guia do usuário da AWS Command Line Interface.

  2. Abra um terminal.

  3. Para adicionar uma configuração de métricas, execute um dos seguintes comandos:

    exemplo : para filtrar por prefixo
    aws s3api put-bucket-metrics-configuration --bucket DOC-EXAMPLE-BUCKET1 --id metrics-config-id --metrics-configuration '{"Id":"metrics-config-id", "Filter":{"Prefix":"prefix1"}} '
    exemplo : para filtrar por etiquetas
    aws s3api put-bucket-metrics-configuration --bucket DOC-EXAMPLE-BUCKET1 --id metrics-config-id --metrics-configuration '{"Id":"metrics-config-id", "Filter":{"Tag": {"Key": "string", "Value": "string"}} '
    exemplo : para filtrar por ponto de acesso
    aws s3api put-bucket-metrics-configuration --bucket DOC-EXAMPLE-BUCKET1 --id metrics-config-id --metrics-configuration '{"Id":"metrics-config-id", "Filter":{"AccessPointArn":"arn:aws:s3:Region:account-id:accesspoint/access-point-name"}} '
    exemplo : para filtrar por prefixo, etiquetas e ponto de acesso
    aws s3api put-bucket-metrics-configuration --endpoint https://s3.Region.amazonaws.com --bucket DOC-EXAMPLE-BUCKET1 --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"
        }
    }
}'

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: