Obter métricas usando a CloudWatch API

Você pode usar a CloudWatch API ou a CLI da Amazon para obter as CloudFront métricas nos programas ou aplicativos 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.

Para obter as CloudFront métricas da CloudWatch API, você deve usar 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 CloudFront métricas

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

Namespace

O valor para Namespace é sempre AWS/CloudFront.

Dimensões

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

DistributionId

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

FunctionName

O nome da função (em CloudFront Funções) para a qual você deseja obter métricas.

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

Region

O valor Region é sempreGlobal, porque CloudFront é um serviço global.

nota

Para obter as CloudFront métricas da CloudWatch API, você deve usar a região Leste dos EUA (Norte da Virgínia) (us-east-1).

Valores para métricas CloudFront de distribuição

Use as informações da lista a seguir para obter detalhes sobre métricas de CloudFront distribuição específicas da CloudWatch API. 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 do qual 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 que CloudFront serviram 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, desde o momento em que CloudFront recebe uma solicitação até o momento em que ela começa a fornecer uma resposta à rede (não ao visualizador), para solicitações atendidas a partir da origem, não do CloudFront cache. Isso também é conhecido como latência de primeiro byte, ou. time-to-first-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 Percentile estatística da CloudWatch API, use o ExtendedStatistics parâmetro, nãoStatistics. Para obter mais informações, consulte GetMetricStatisticsa Amazon CloudWatch API Reference ou a documentação de referência dos AWSSDKs.

Solicitações

O número total de solicitações do visualizador recebidas por 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 CloudFront função

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

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