Obter métricas usando a API do Amazon CloudWatch - Amazon CloudFront
Valores para todas as métricas do CloudFrontValores para métricas de distribuição do CloudFrontValores para métricas de função do CloudFront

Obter métricas usando a API do Amazon CloudWatch

É possível pode usar a API ou a AWS Command Line Interface (AWS CLI) do CloudWatch para obter as métricas do CloudFront em programas ou aplicações que você cria. É possível usar os dados brutos para criar seus próprios painéis personalizados, suas próprias ferramentas de alarmes e muito mais.

Consulte mais informações em get-metric-data na Referência de comandos da AWS CLI ou na operação de API GetMetricData na Referência de API do Amazon CloudWatch.

nota

Para obter as métricas do CloudFront da API do CloudWatch, use a região Leste dos EUA (Norte da Virgínia) (us-east-1). Você também precisa conhecer alguns valores e tipos para cada métrica.

Valores para todas as métricas do CloudFront

Os valores a seguir se aplicam a todas as métricas do CloudFront:

Namespace

O valor para Namespace é sempre AWS/CloudFront.

Dimensões

Cada métrica do CloudFront tem as duas dimensões a seguir:

DistributionId

O ID da distribuição do CloudFront para o qual você deseja obter métricas.

FunctionName

O nome da função (no CloudFront Functions) para a qual você deseja obter métricas.

Essa dimensão se aplica apenas a funções.

Region

O valor de Region é sempre Global, pois o CloudFront é um serviço global.

Valores para métricas de distribuição do CloudFront

Use as informações da lista a seguir para obter detalhes sobre métricas específicas de distribuição do CloudFront da API do CloudWatch. Algumas dessas métricas ficam disponíveis somente quando você ativa métricas adicionais para a distribuição.

nota

Apenas uma estatística, Average ou Sum, é aplicável para cada métrica. A lista a seguir especifica qual estatística é aplicável a essa métrica.

Taxa de erros 4xx

A porcentagem de todas as solicitações do visualizador para as quais o código de status HTTP da resposta é 4xx.

  • Nome da métrica: 4xxErrorRate

  • Estatística válida: Average

  • Unidade: Percent

Taxa de erro 401

A porcentagem de todas as solicitações do visualizador para as quais o código de status HTTP da resposta é 401. Para obter essa métrica, primeiro é necessário ativar métricas adicionais.

  • Nome da métrica: 401ErrorRate

  • Estatística válida: Average

  • Unidade: Percent

Taxa de erro 403

A porcentagem de todas as solicitações do visualizador para as quais o código de status HTTP da resposta é 403. Para obter essa métrica, primeiro é necessário ativar métricas adicionais.

  • Nome da métrica: 403ErrorRate

  • Estatística válida: Average

  • Unidade: Percent

Taxa de erro 404

A porcentagem de todas as solicitações do visualizador para as quais o código de status HTTP da resposta é 404. Para obter essa métrica, primeiro é necessário ativar métricas adicionais.

  • Nome da métrica: 404ErrorRate

  • Estatística válida: Average

  • Unidade: Percent

Taxa de erros 5xx

A porcentagem de todas as solicitações do visualizador para as quais o código de status HTTP da resposta é 5xx.

  • Nome da métrica: 5xxErrorRate

  • Estatística válida: Average

  • Unidade: Percent

Taxa de erro 502

A porcentagem de todas as solicitações do visualizador para as quais o código de status HTTP da resposta é 502. Para obter essa métrica, primeiro é necessário ativar métricas adicionais.

  • Nome da métrica: 502ErrorRate

  • Estatística válida: Average

  • Unidade: Percent

Taxa de erro 503

A porcentagem de todas as solicitações do visualizador para as quais o código de status HTTP da resposta é 503. Para obter essa métrica, primeiro é necessário ativar métricas adicionais.

  • Nome da métrica: 503ErrorRate

  • Estatística válida: Average

  • Unidade: Percent

Taxa de erro 504

A porcentagem de todas as solicitações do visualizador para as quais o código de status HTTP da resposta é 504. Para obter essa métrica, primeiro é necessário ativar métricas adicionais.

  • Nome da métrica: 504ErrorRate

  • Estatística válida: Average

  • Unidade: Percent

Bytes baixados

O número de bytes obtidos por download por visualizadores para solicitações GET, HEAD e OPTIONS.

  • Nome da métrica: BytesDownloaded

  • Estatística válida: Sum

  • Unidade: None

Bytes carregados

O número total de bytes que os visualizadores fizeram upload para a origem com o CloudFront usando POST e PUT.

  • Nome da métrica: BytesUploaded

  • Estatística válida: Sum

  • Unidade: None

Taxa de acertos do cache

A porcentagem de todas as solicitações armazenáveis em cache para as quais o CloudFront forneceu o conteúdo do cache. Solicitações HTTP POST e PUT e erros não são considerados solicitações armazenáveis em cache. Para obter essa métrica, primeiro é necessário ativar métricas adicionais.

  • Nome da métrica: CacheHitRate

  • Estatística válida: Average

  • Unidade: Percent

Latência de origem

O tempo total gasto, em milissegundos, de quando o CloudFront recebe uma solicitação até quando começa a fornecer uma resposta à rede (não ao visualizador), para solicitações que são fornecidas pela origem, não pelo cache do CloudFront. Isso também é conhecido como latência de primeiro byte ou tempo até o primeiro byte. Para obter essa métrica, primeiro é necessário ativar métricas adicionais.

  • Nome da métrica: OriginLatency

  • Estatística válida: Percentile

  • Unidade: Milliseconds

nota

Para obter uma estatística Percentile da API do CloudWatch, use o parâmetro ExtendedStatistics, não Statistics. Para obter mais informações, consulte GetMetricStatistics na Referência da API do Amazon CloudWatch ou a documentação de referência dos AWS SDKs.

Solicitações

O número total de solicitações de visualizador recebidas pelo CloudFront, para todos os métodos HTTP e para solicitações HTTP e HTTPS.

  • Nome da métrica: Requests

  • Estatística válida: Sum

  • Unidade: None

Taxa de erros total

A porcentagem de todas as solicitações do visualizador para as quais o código de status HTTP da resposta é 4xx ou 5xx.

  • Nome da métrica: TotalErrorRate

  • Estatística válida: Average

  • Unidade: Percent

Valores para métricas de função do CloudFront

Use as informações da lista a seguir para obter detalhes sobre métricas específicas de função do CloudFront da API do CloudWatch.

nota

Apenas uma estatística, Average ou Sum, é aplicável para cada métrica. A lista a seguir especifica qual estatística é aplicável a essa métrica.

Invocações

O número de vezes que a função foi iniciada (invocada) em um determinado período de tempo.

  • Nome da métrica: FunctionInvocations

  • Estatística válida: Sum

  • Unidade: None

Erros de validação

O número de erros de validação produzidos pela função em um determinado período de tempo. Os erros de validação ocorrem quando a função é executada com êxito, mas retorna dados inválidos (um objeto de evento inválido).

  • Nome da métrica: FunctionValidationErrors

  • Estatística válida: Sum

  • Unidade: None

Erros de execução

O número de erros de execução que ocorreram em um determinado período de tempo. Erros de execução ocorrem quando a função falha ao concluir com êxito.

  • Nome da métrica: FunctionExecutionErrors

  • Estatística válida: Sum

  • Unidade: None

Utilização de recursos de computação

A quantidade de tempo (0 a 100) que a função levou para ser executada como uma porcentagem do tempo máximo permitido. Por exemplo, um valor de 35 significa que a função foi concluída em 35% do tempo máximo permitido.

  • Nome da métrica: FunctionComputeUtilization

  • Estatística válida: Average

  • Unidade: Percent

Controles de utilização

O número de vezes que a função foi limitada em determinado período.

  • Nome da métrica: FunctionThrottles

  • Estatística válida: Sum

  • Unidade: None