Visualizar relatórios de estatísticas de cache do CloudFront

O relatório de estatísticas de cache do Amazon CloudFront inclui as seguintes informações:

• Total Requests (Total de solicitações) - mostra o número total de solicitações de todos os códigos de status do HTTP (por exemplo, 200 ou 404) e de todos os métodos (por exemplo, GET, HEAD ou POST).

• Percentage of viewer requests by result type (Porcentagem de solicitações do visualizador por tipo de resultado) - mostra o número de solicitações atendidas e não atendidas, e erros como uma porcentagem do total de solicitações do visualizador para a distribuição do CloudFront selecionada.

• Bytes transferred to viewers (Bytes transferidos aos visualizadores) - mostra o total de bytes e os bytes de solicitações não atendidas.

• HTTP status codes (Códigos de status HTTP) - mostra as solicitações do visualizador por código de status do HTTP.

• Percentage of GET requests that didn't finish downloading (Porcentagem de solicitações GET cujo download não foi concluído) - mostra as solicitações GET do visualizador com download do objeto solicitado não concluído como porcentagem do total de solicitações.

Os dados dessas estatísticas são obtidos da mesma origem que os logs de acesso do CloudFront, mas não é necessário habilitar o log de acesso para visualizar as estatísticas de cache.

Você pode exibir gráficos para um intervalo de datas nos últimos 60 dias, com pontos de dados por hora ou dia. Normalmente, é possível visualizar os dados das solicitações recebidas pelo CloudFront há uma hora, mas eles podem atrasar até 24 horas.

Visualizar relatórios de estatísticas de cache do CloudFront no console

É possível visualizar o relatório de estatísticas de cache do CloudFront no console.

Como visualizar estatísticas de cache do CloudFront

1. Faça login no AWS Management Console e abra o console do CloudFront em https://console.aws.amazon.com/cloudfront/v4/home.

2. No painel de navegação, selecione Estatísticas do cache.

3. No painel CloudFront Cache Statistics Reports (Relatórios de estatísticas de cache do CloudFront), em Start Date (Data de início) e End Date (Data de término), selecione o intervalo de datas para o qual você deseja exibir gráficos de estatísticas do cache. Os intervalos disponíveis dependem do valor selecionado para Granularity:

   • Daily (Diariamente): para exibir gráficos com um ponto de dados por dia, selecione qualquer intervalo de datas nos últimos 60 dias.

   • Hourly (Por hora): para exibir gráficos com um ponto de dados por hora, selecione qualquer intervalo de datas de até 14 dias nos últimos 60 dias.

   As datas e horas estão em Tempo Universal Coordenado (UTC).

4. Em Granularity, especifique se você deseja exibir um ponto de dados por dia ou por hora nos gráficos. Se você especificar um intervalo de datas maior que 14 dias, a opção para especificar um ponto de dados por hora não estará disponível.

5. Em Viewer Location, escolha o continente de origem das solicitações do visualizador ou escolha All Locations. Os gráficos de estatísticas do cache incluem dados de solicitações recebidas pelo CloudFront do local especificado.

6. Na lista Distribution, selecione as distribuições para as quais você deseja exibir os dados nos gráficos de uso:

   • An individual distribution (uma distribuição individual): os gráficos exibem os dados da distribuição selecionada do CloudFront. A lista Distribution exibe o ID e os nomes de domínio alternativos (CNAMEs) da distribuição, se houver. Se uma distribuição não tiver nomes de domínio alternativos, a lista incluirá os nomes de domínio de origem dela.

   • All distributions (Todas as distribuições): os gráficos exibem a soma dos dados de todas as distribuições que estão associadas à conta atual da AWS, com exceção das distribuições que você excluiu.

7. Selecione Atualizar.

Para visualizar dados de um ponto de dados por dia ou por hora em um gráfico, passe o ponteiro do mouse sobre o ponto de dados.

Nos gráficos que mostram os dados transferidos, é possível alterar a escala vertical para gigabytes, megabytes ou kilobytes em cada um deles.

Baixar dados no formato CSV

Você pode baixar o relatório de estatísticas do cache no formato CSV. Esta seção explica como fazer download do relatório e descreve os valores dele.

Para baixar o relatório de estatísticas do cache no formato CSV

1. No relatório de estatísticas de cache, selecione CSV.

2. Na caixa de diálogo Opening file name, opte por abrir ou salvar o arquivo.

Informações sobre o relatório

As primeiras linhas do relatório incluem as seguintes informações:

Versão

A versão do formato desse arquivo CSV.

Relatório

O nome do relatório.

DistributionID

O ID da distribuição para a qual o relatório foi gerado ou ALL se o relatório tiver sido gerado para todas as distribuições.

StartDateUTC

O início do intervalo de datas para o qual você executou o relatório, no Tempo Universal Coordenado (UTC).

EndDateUTC

O término do intervalo de datas para o qual você executou o relatório, no Tempo Universal Coordenado (UTC).

GeneratedTimeUTC

A data e a hora nas quais você executou o relatório, no Tempo Universal Coordenado (UTC).

Granularity

Se cada linha do relatório representa uma hora ou um dia.

ViewerLocation

O continente de origem das solicitações do visualizador ou ALL se você optar por fazer download do relatório para todos os locais.

Dados do relatório de estatísticas do cache

O relatório inclui os seguintes valores:

DistributionID

O ID da distribuição para a qual o relatório foi gerado ou ALL se o relatório tiver sido gerado para todas as distribuições.

FriendlyName

Um nome de domínio alternativo (CNAME), se houver, para a distribuição. Se uma distribuição não tiver nomes de domínio alternativos, a lista incluirá um nome de domínio de origem dela.

ViewerLocation

O continente de origem das solicitações do visualizador ou ALL se você optar por fazer download do relatório para todos os locais.

TimeBucket

A hora ou o dia ao qual os dados se aplicam, no Tempo Universal Coordenado (UTC).

RequestCount

O número total de solicitações de todos os códigos de status do HTTP (por exemplo, 200 ou 404) e de todos os métodos (por exemplo, GET, HEAD ou POST).

HitCount

O número de solicitações do visualizador atendidas pelo objeto de um ponto de presença de caches do CloudFront.

MissCount

O número de solicitações do visualizador para as quais o objeto não está em um ponto de presença de caches, de modo que o CloudFront precise obter o objeto de sua origem.

ErrorCount

O número de solicitações do visualizador que resultaram em erro, fazendo com que o CloudFront não fornecesse o objeto.

IncompleteDownloadCount

O número de solicitações para as quais o visualizador começou, mas não terminou de fazer download do objeto.

HTTP2xx

O número de solicitações do visualizador para as quais o código de status do HTTP é um valor 2xx (realizado).

HTTP3xx

O número de solicitações do visualizador para as quais o código de status do HTTP é um valor 3xx (ação adicional necessária).

HTTP4xx

O número de solicitações do visualizador para as quais o código de status do HTTP é um valor 4xx (erro do cliente).

HTTP5xx

O número de solicitações do visualizador para as quais o código de status do HTTP é um valor 5xx (erro do servidor).

TotalBytes

O número total de bytes enviados para os visualizadores pelo CloudFront em resposta a todas as solicitações de todos os métodos HTTP.

BytesFromMisses

O número de bytes enviados aos visualizadores para objetos que não estavam no ponto de presença de caches no momento da solicitação. Esse valor é uma boa aproximação dos bytes transferidos da origem aos pontos de presença de caches do CloudFront. No entanto, ele não inclui solicitações de objetos que já estão no ponto de presença de cache, mas expiraram.

Como os gráficos de estatísticas do cache estão relacionados aos dados nos logs padrão (logs de acesso) do CloudFront

A tabela a seguir mostra como os gráficos de estatísticas do cache do console do &CloudFront correspondem aos valores dos logs de acesso do CloudFront. Para mais informações sobre os logs de acesso do CloudFront, consulte Configurar e usar logs padrão (logs de acesso).

Total requests

Esse gráfico mostra o número total de solicitações de todos os códigos de status do HTTP (por exemplo, 200 ou 404) e de todos os métodos (por exemplo, GET, HEAD ou POST). O total de solicitações exibido nesse gráfico é igual ao número total de solicitações dos arquivos de log de acesso para o mesmo período.

Percentage of viewer requests by result type

Esse gráfico mostra o número de solicitações atendidas e não atendidas, e os erros como porcentagem do total de solicitações do visualizador para a distribuição selecionada do CloudFront:

• Hit (Atendidas): uma solicitação do visualizador para a qual o objeto é fornecido de um ponto de presença de caches do CloudFront. Nos logs de acesso, o valor de x-edge-response-result-type dessas solicitações é Hit.

• Miss (Não atendidas): uma solicitação do visualizador para a qual o objeto não está em um ponto de presença de caches, de modo que o CloudFront precise obtê-lo de sua origem. Nos logs de acesso, o valor de x-edge-response-result-type dessas solicitações é Miss.

• Error (Erro): uma solicitação do visualizador que resultou em erro, fazendo com que o CloudFront não fornecesse o objeto. Nos logs de acesso, o valor de x-edge-response-result-type dessas solicitações é Error, LimitExceeded ou CapacityExceeded.

O gráfico não inclui solicitações atendidas de atualização (solicitações de objetos que estão no ponto de presença de caches, mas expiraram). Nos logs de acesso, o valor de x-edge-response-result-type dessas solicitações é RefreshHit.

Bytes transferred to viewers

Esse gráfico mostra dois valores:

• Total bytes (Total de bytes) - o número total de bytes enviados para os visualizadores pelo CloudFront em resposta a todas as solicitações de todos os métodos HTTP. Nos logs de acesso do CloudFront, Total Bytes (Total de bytes) é a soma dos valores da coluna sc-bytes de todas as solicitações durante o mesmo período.

• Bytes from misses (Bytes de perdas) - o número de bytes enviados aos visualizadores para objetos que não estavam no ponto de presença de caches no momento da solicitação. Nos logs de acesso do CloudFront, Bytes from misses (Bytes de perdas) é a soma dos valores da coluna sc-bytes das solicitações para as quais o valor de x-edge-result-type é Miss. Esse valor é uma boa aproximação dos bytes transferidos da origem aos pontos de presença de caches do CloudFront. No entanto, ele não inclui solicitações de objetos que já estão no ponto de presença de cache, mas expiraram.

Códigos de status de HTTP

Esse gráfico mostra as solicitações do visualizador por código de status do HTTP. Nos logs de acesso do CloudFront, os códigos de status são exibidos na coluna sc-status:

• 2xx: a solicitação foi bem-sucedida.

• 3xx: ação adicional necessária. Por exemplo, 301 (Movido permanentemente) significa que o objeto solicitado foi movido para um local diferente.

• 4xx: o cliente aparentemente cometeu um erro. Por exemplo, 404 (Não encontrado) significa que o cliente solicitou um objeto não encontrado.

• 5xx: o servidor de origem não atendeu a solicitação. Por exemplo, 503 (Serviço indisponível) significa que o servidor de origem está indisponível no momento.

Percentage of GET requests that didn't finish downloading

Esse gráfico mostra as solicitações GET do visualizador que não concluíram o download do objeto solicitado como uma porcentagem do total de solicitações. Normalmente, o download de um objeto não é concluído pois o visualizador cancelou o download, por exemplo, clicando em um link diferente ou fechando o navegador. Nos logs de acesso do CloudFront, essas solicitações têm valor 200 na coluna sc-status e valor Error na coluna x-edge-result-type.