# Tipos de métricas para o CloudFront
É 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](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/get-metric-data.html) na *Referência de comandos da AWS CLI* ou na operação de API [GetMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricData.html) na *Referência de API do Amazon CloudWatch*.
**Topics**
+ [Valores para todas as métricas do CloudFront](#cloudfront-metrics-global-values)
+ [Valores para métricas de distribuição do CloudFront](#cloudfront-metrics-distribution-values)
+ [Valores para métricas de função do CloudFront](#cloudfront-metrics-function-values)
**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 seguintes dimensões:
**`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](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional).
+ 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](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional).
+ 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](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional).
+ 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](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional).
+ 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](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional).
+ 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](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional).
+ Nome da métrica: `504ErrorRate`
+ Estatística válida: `Average`
+ Unidade: `Percent`
**Bytes baixados**
O número de bytes baixados pelos visualizadores para solicitações `GET` e `HEAD`.
+ Nome da métrica: `BytesDownloaded`
+ Estatística válida: `Sum`
+ Unidade: `None`
**Bytes carregados**
O número total de bytes carregados pelos visualizadores no CloudFront usando as solicitações `OPTIONS`, `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](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional).
+ 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](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional).
+ Nome da métrica: `OriginLatency`
+ Estatística válida: `Percentile`
+ Unidade: `Milliseconds`
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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricStatistics.html) na *Referência da API do Amazon CloudWatch *ou a documentação de referência dos [AWS SDKs](https://docs.aws.amazon.com/#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`