CloudFront relatórios de estatísticas de cache

Você pode usar o CloudFront console da Amazon para exibir uma representação gráfica das estatísticas relacionadas aos pontos CloudFront de presença. Os dados dessas estatísticas são extraídos da mesma fonte dos registros de CloudFront acesso. Você pode exibir gráficos para um intervalo de datas nos últimos 60 dias, com pontos de dados por hora ou dia. Normalmente, você pode visualizar dados sobre solicitações CloudFront recebidas há apenas uma hora, mas ocasionalmente os dados podem ser atrasados em até 24 horas.

nota

Não é necessário permitir que o registro de acesso visualize as estatísticas do cache.

Para exibir estatísticas de CloudFront cache

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

2. No painel de navegação, clique em Cache Statistics.

3. No painel CloudFront Cache Statistics Reports, em Start Date e End Date, 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 de cache incluem dados de solicitações CloudFront recebidas do local especificado.

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

   • Uma distribuição individual — Os gráficos exibem dados da CloudFront distribuição selecionada. 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. Clique em Update.

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

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

Fazer download de 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 do cache, clique em 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 para as quais o objeto é atendido a partir de um cache de CloudFront borda.

MissCount

O número de solicitações do visualizador para as quais o objeto não está atualmente em um cache de borda, portanto, CloudFront deve obter o objeto de sua origem.

ErrorCount

O número de solicitações do visualizador que resultaram em um erro e, portanto, CloudFront não serviram ao 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 fornecidos aos visualizadores 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 de cache estão relacionados aos dados nos registros CloudFront padrão (registros de acesso)

A tabela a seguir mostra como os gráficos de estatísticas de cache no CloudFront console correspondem aos valores nos registros de CloudFront acesso. Para obter mais informações sobre registros de CloudFront acesso, consulteConfigurar 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 acertos, erros e erros como uma porcentagem do total de solicitações de visualizadores para a CloudFront distribuição selecionada:

• Hit — Uma solicitação do visualizador para a qual o objeto é servido a partir de um cache de CloudFront borda. Nos logs de acesso, o valor de x-edge-response-result-type dessas solicitações é Hit.

• Miss — Uma solicitação do visualizador para a qual o objeto não está atualmente em um cache de borda, portanto, CloudFront deve obter o objeto de sua origem. Nos logs de acesso, o valor de x-edge-response-result-type dessas solicitações é Miss.

• Erro — Uma solicitação do visualizador que resultou em um erro e, portanto, CloudFront não atendeu ao 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 de bytes — O número total de bytes fornecidos aos visualizadores CloudFront em resposta a todas as solicitações de todos os métodos HTTP. Nos registros de CloudFront acesso, o total de bytes é a soma dos valores na sc-bytes coluna para 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 registros de CloudFront acesso, bytes de erros são a soma dos valores na sc-bytes coluna 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 registros de CloudFront acesso, os códigos de status aparecem na sc-status coluna:

• 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 registros de CloudFront acesso, essas solicitações têm um valor de 200 na sc-status coluna e um valor de Error na x-edge-result-type coluna.