# Monitorar métricas do CloudFront com o Amazon CloudWatch
O Amazon CloudFront é integrado ao Amazon CloudWatch e publica automaticamente métricas operacionais para distribuições e funções de borda (do [Lambda@Edge e CloudFront Functions](edge-functions.md)). É possível usar essas métricas para solucionar problemas, monitorar e depurar problemas. Muitas dessas métricas são exibidas em um conjunto de grafos no console do CloudFront e também podem ser acessadas usando a CLI ou a API do CloudFront. Todas essas métricas estão disponíveis no [console do CloudWatch](https://console.aws.amazon.com/cloudwatch/home) ou por meio da CLI ou da API do CloudWatch. As métricas do CloudFront não são contabilizadas em relação às [cotas do CloudWatch (anteriormente conhecidas como limites)](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_limits.html) e não geram custo adicional.
Além das métricas padrão para distribuições do CloudFront, é possível ativar outras métricas por um custo adicional. As métricas adicionais se aplicam às distribuições do CloudFront e devem ser ativadas para cada distribuição separadamente. Para obter mais informações sobre o custo, consulte [Estimar o custo para as métricas adicionais do CloudFront](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional-pricing).
Também é possível definir alarmes com base nessas métricas no console do CloudFront ou na API, na CLI ou no console do CloudWatch. Por exemplo, é possível definir um alarme com base na métrica `5xxErrorRate`, que representa a porcentagem de todas as solicitações do visualizador para as quais o código de status HTTP da resposta está no intervalo de `500` a `599`. Quando a taxa de erro atinge determinado valor por certo período, por exemplo, 5% das solicitações por cinco minutos contínuos, o alarme é acionado. Especifique o valor do alarme e a respectiva unidade de tempo ao criar o alarme.
**Observações**
Ao criar um alarme do CloudWatch no console do CloudFront, ele cria um para você na região Leste dos EUA (Norte da Virgínia) (`us-east-1`). Se você criar um alarme no console do CloudWatch, deverá usar a mesma região. Como o CloudFront é um serviço global, as métricas do serviço são enviadas para o Leste dos EUA (Norte da Virgínia).
Ao criar alarmes, aplica-se o [preço padrão do CloudWatch](https://aws.amazon.com/cloudwatch/pricing/).
**Topics**
+ [Visualizar métricas do CloudFront e de funções de borda](viewing-cloudfront-metrics.md)
+ [Criar alarmes do para métricas do](receiving-notifications.md)
+ [Baixar dados de métricas no formato CSV](cloudwatch-csv.md)
+ [Tipos de métricas para o CloudFront](programming-cloudwatch-metrics.md)
# Visualizar métricas do CloudFront e de funções de borda
É possível visualizar métricas operacionais sobre as distribuições do CloudFront e as [funções de borda](https://aws.amazon.com/cloudfront/features/#Edge_Computing) no console do CloudFront.
**Como visualizar métricas do CloudFront e de funções de borda no CloudFront**
1. Faça login no Console de gerenciamento da AWS e abra o console do CloudFront em [https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home).
1. No painel de navegação, escolha **Monitoring (Monitoramento)**.
1. Para visualizar grafos sobre a atividade de uma distribuição do CloudFront ou função de borda específica, selecione uma e, depois, escolha **View distribution metrics** (Visualizar métricas de distribuição) ou **View metrics** (Visualizar métricas).
1. É possível personalizar os gráficos fazendo o seguinte:
1. Para alterar o intervalo de tempo das informações exibidas nos gráficos, escolha 1h (uma hora), 3h (três horas) ou outro intervalo, ou especifique um intervalo personalizado.
1. Para alterar a frequência com que o CloudFront atualiza as informações no gráfico, clique na seta para baixo ao lado do ícone de atualização e escolha uma taxa de atualização. A taxa de atualização padrão é de um minuto, mas é possível escolher outras opções.
1. Para exibir gráficos do CloudFront no console do CloudWatch, escolha **Add to dashboard (Adicionar ao painel)**. É necessário usar a região Leste dos EUA (N. da Virgínia) para visualizar os grafos no console do CloudWatch.
**Topics**
+ [Métricas de distribuição padrão do CloudFront](#monitoring-console.distributions)
+ [Ativar métricas adicionais de distribuição do CloudFront](#monitoring-console.distributions-additional)
+ [Métricas de função padrão do Lambda@Edge](#monitoring-console.lambda-at-edge)
+ [Métricas padrão do CloudFront Functions](#monitoring-console.cloudfront-functions)
## Métricas de distribuição padrão do CloudFront
As seguintes métricas padrão são incluídas para todas as distribuições do CloudFront, sem custo adicional:
**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.
**Bytes baixados**
O número de bytes baixados pelos visualizadores para solicitações `GET` e `HEAD`.
**Bytes carregados**
O número total de bytes carregados pelos visualizadores no CloudFront usando as solicitações `OPTIONS`, `POST` e `PUT`.
**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`.
**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`.
**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`.
Essas métricas são mostradas em grafos para cada distribuição do CloudFront na página **Monitoramento** do console do CloudFront. Em cada gráfico, os totais são exibidos na granularidade de 1 minuto. Além de visualizar os gráficos, também é possível [fazer download de relatórios de métricas como arquivos CSV](cloudwatch-csv.md).
## Ativar métricas adicionais de distribuição do CloudFront
Além das métricas padrão, é possível ativar outras métricas por um custo adicional. Para obter mais informações sobre o custo, consulte [Estimar o custo para as métricas adicionais do CloudFront](#monitoring-console.distributions-additional-pricing).
Essas métricas adicionais devem ser ativadas para cada distribuição separadamente:
**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.
**Latência de origem**
O tempo total gasto 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 atendidas da origem, não do cache do CloudFront. Isso também é conhecido como *latência de primeiro byte* ou *tempo até o primeiro byte*.
**Taxa de erro por código de status**
A porcentagem de todas as solicitações do visualizador para as quais o código de status HTTP da resposta é um código específico no intervalo `4xx` ou `5xx`. Essa métrica está disponível para todos os seguintes códigos de erro: `401`, `403`, `404`, `502`, `503` e `504`.
Você pode ativar métricas adicionais no console do CloudFront com o CloudFormation, com a AWS Command Line Interface (AWS CLI) ou com a API do CloudFront.
------
#### [ Console ]
**Como ativar métricas adicionais**
1. Faça login no Console de gerenciamento da AWS e abra o console do CloudFront em [https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home).
1. No painel de navegação, escolha **Monitoring (Monitoramento)**.
1. Selecione a distribuição para a qual ativar métricas adicionais e selecione **View distribution metrics** (Visualizar métricas de distribuição).
1. Selecione **Manage additional metrics** (Gerenciar métricas adicionais).
1. Na janela **Manage additional metrics** (Gerenciar métricas adicionais), ative **Enabled** (Habilitado). Após a ativação das métricas adicionais, é possível fechar a janela **Manage additional metrics** (Gerenciar métricas adicionais).
Após a ativação das métricas adicionais, elas são mostradas em grafos. Em cada gráfico, os totais são exibidos na granularidade de 1 minuto. Além de visualizar os gráficos, também é possível [fazer download de relatórios de métricas como arquivos CSV](cloudwatch-csv.md).
------
#### [ CloudFormation ]
Para ativar métricas adicionais com o CloudFormation, use o tipo de recurso `AWS::CloudFront::MonitoringSubscription`. O exemplo a seguir mostra a sintaxe do modelo do CloudFormation no formato YAML, para habilitar métricas adicionais.
```
Type: AWS::CloudFront::MonitoringSubscription
Properties:
DistributionId: EDFDVBD6EXAMPLE
MonitoringSubscription:
RealtimeMetricsSubscriptionConfig:
RealtimeMetricsSubscriptionStatus: Enabled
```
------
#### [ CLI ]
Para gerenciar métricas adicionais com a AWS Command Line Interface (AWS CLI), use um dos seguintes comandos:
**Como ativar métricas adicionais para uma distribuição**
+ Use o comando **create-monitoring-subscription** como no exemplo a seguir. Substitua *EDFDVBD6EXAMPLE* pelo ID da distribuição para a qual você está habilitando métricas adicionais.
```
aws cloudfront create-monitoring-subscription --distribution-id EDFDVBD6EXAMPLE --monitoring-subscription RealtimeMetricsSubscriptionConfig={RealtimeMetricsSubscriptionStatus=Enabled}
```
**Como verificar se as métricas adicionais estão ativadas para uma distribuição**
+ Use o comando **get-monitoring-subscription** como no exemplo a seguir. Substitua *EDFDVBD6EXAMPLE* pelo ID da distribuição que você está verificando.
```
aws cloudfront get-monitoring-subscription --distribution-id EDFDVBD6EXAMPLE
```
**Como desativar métricas adicionais para uma distribuição**
+ Use o comando **delete-monitoring-subscription** como no exemplo a seguir. Substitua *EDFDVBD6EXAMPLE* pelo ID da distribuição para a qual você está desativando métricas adicionais.
```
aws cloudfront delete-monitoring-subscription --distribution-id EDFDVBD6EXAMPLE
```
------
#### [ API ]
Para gerenciar métricas adicionais com a API do CloudFront, use uma das seguintes operações de API.
+ Para ativar métricas adicionais para uma distribuição, use [CreateMonitoringSubscription](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_CreateMonitoringSubscription.html).
+ Para ver se as métricas adicionais estão ativadas para uma distribuição, use [GetMonitoringSubscription](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_GetMonitoringSubscription.html).
+ Para desativar métricas adicionais para uma distribuição, use [DeleteMonitoringSubscription](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_DeleteMonitoringSubscription.html).
Consulte mais informações sobre essas operações de API na documentação de referência da API do AWS SDK ou de outro cliente de API.
------
### Estimar o custo para as métricas adicionais do CloudFront
Quando você ativa métricas adicionais para uma distribuição, o CloudFront envia até oito métricas para o CloudWatch na região Leste dos EUA (N. da Virgínia). O CloudWatch cobra uma taxa baixa e fixa para cada métrica. Essa taxa é cobrada apenas uma vez por mês, por métrica (até 8 métricas por distribuição). É uma taxa fixa, portanto, o custo permanece o mesmo, independentemente do número de solicitações ou respostas que a distribuição do CloudFront recebe ou envia. Para obter a taxa por métrica, consulte a [página de definição de preço do Amazon CloudWatch](https://aws.amazon.com/cloudwatch/pricing/) e a [Calculadora de definição de preço do CloudWatch](https://aws.amazon.com/cloudwatch/pricing/#Pricing_calculator). Taxas de API adicionais se aplicam ao recuperar as métricas com a API do CloudWatch.
## Métricas de função padrão do Lambda@Edge
É possível usar métricas do CloudWatch para monitorar, em tempo real, problemas nas funções do Lambda@Edge. Não há cobrança adicional por essas métricas.
Quando você associa uma função do Lambda@Edge a um comportamento de cache em uma distribuição do CloudFront, o Lambda começa a enviar métricas para o CloudWatch automaticamente. As métricas estão disponíveis para todas as regiões do Lambda, mas, para visualizar métricas no console do CloudWatch ou obter os dados de métricas de API do CloudWatch, use a região Leste dos EUA (N. da Virgínia) (`us-east-1`). O nome do grupo de métricas é formatado como: `AWS/CloudFront/distribution-ID`, em que *distribution-ID* é o ID da distribuição do CloudFront à qual a função do Lambda@Edge está associada. Para obter mais informações sobre as métricas do CloudWatch, consulte o [Guia do usuário do Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/).
As seguintes métricas padrão são exibidas em grafos para cada função do Lambda@Edge na página **Monitoramento** do console do CloudFront:
+ `5xx`Taxa de erros do Lambda@Edge
+ Erros de execução do Lambda
+ Respostas inválidas do Lambda
+ Aceleradores do Lambda
Os gráficos incluem o número de invocações, erros, limitações e muito mais. Em cada gráfico, os totais são exibidos na granularidade de 1 minuto, agrupados por região da AWS.
Se você vir um pico nos erros que deseja investigar, será possível escolher uma função e visualizar os arquivos de log por região da AWS, até determinar qual função está causando problemas e em qual região da AWS. Para obter mais informações sobre a resolução de erros do Lambda@Edge, consulte:
+ [Como determinar o tipo de falha](lambda-edge-testing-debugging.md#lambda-edge-testing-debugging-failure-type)
+ [Quatro etapas para depurar sua entrega de conteúdo na AWS](https://aws.amazon.com/blogs/networking-and-content-delivery/four-steps-for-debugging-your-content-delivery-on-aws/)
## Métricas padrão do CloudFront Functions
O CloudFront Functions envia métricas operacionais para o Amazon CloudWatch para que você possa monitorar suas funções. A visualização dessas métricas pode ajudar a solucionar problemas, rastrear e depurar problemas. O CloudFront Functions publica as seguintes métricas no CloudWatch:
+ **Invocations** (Invocações) (`FunctionInvocations`): o número de vezes que a função foi iniciada (invocada) em um determinado período de tempo.
+ **Validation errors** (Erros de validação) (`FunctionValidationErrors`): 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](functions-event-structure.md) inválido).
+ **Execution errors** (Erros de execução) (`FunctionExecutionErrors`): 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.
+ **Compute utilization** (Utilização de computação) `FunctionComputeUtilization`: a quantidade de tempo que a função levou para ser executada como um percentual 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. Esta métrica é um número entre 0 e 100.
Se esse valor atingir ou estiver próximo de 100, a função usou ou está perto de usar o tempo de execução permitido e as solicitações subsequentes poderão ser submetidas a controle de utilização. Se sua função estiver sendo executada com 80% ou mais de utilização, recomendamos que você revise sua função para reduzir o tempo de execução e melhorar a utilização. Por exemplo, talvez você queira registrar somente erros em log, simplificar qualquer expressão regex complexa ou remover a análise desnecessária de objetos JSON complexos.
+ **Limitações**(`FunctionThrottles`): o número de vezes que a função foi limitada em determinado período. As funções podem ser limitadas pelos seguintes motivos:
+ A função excede continuamente o tempo máximo permitido para execução.
+ A função causa erros de compilação.
+ Há um número excepcionalmente alto de solicitações por segundo.
O KeyValueStore do CloudFront também envia as seguintes métricas operacionais para o Amazon CloudWatch:
+ **Read requests (Solicitações de leitura)** (`KvsReadRequests`): o número de vezes que a função foi lida com êxito do armazenamento de chave-valor em determinado período.
+ **Read errors (Erros de leitura)** (`KvsReadErrors`): o número de vezes que a função falhou ao ler o armazenamento de chave-valor em determinado período.
Todas essas métricas são publicadas no CloudWatch na região Leste dos EUA (Norte da Virgínia) (`us-east-1`), no namespace do CloudFront. Você também pode visualizar essas métricas no console do CloudWatch. No console do CloudWatch, você pode visualizar as métricas por função ou por função por distribuição.
Você também pode usar o CloudWatch para definir alarmes com base nessas métricas. Por exemplo, você pode definir um alarme com base na métrica de tempo de execução (`FunctionComputeUtilization`), que representa a porcentagem do tempo disponível que a função levou para executar. Quando o tempo de execução atinge determinado valor por certo período. Por exemplo, se você escolher mais de 70% do tempo disponível por 15 minutos contínuos, o alarme será acionado. Especifique o valor do alarme e a respectiva unidade de tempo ao criar o alarme.
**nota**
O CloudFront Functions envia métricas ao CloudWatch apenas para funções na fase `LIVE` que são executadas em resposta a solicitações e respostas de produção. Quando você [testa uma função](test-function.md), o CloudFront não envia métricas para o CloudWatch. A saída de teste contém informações sobre erros, utilização de computação e logs de funções (instruções `console.log()`), mas essas informações não são enviadas para o CloudWatch.
Para obter informações sobre como obter essas métricas com a API do CloudWatch, consulte [Tipos de métricas para o CloudFront](programming-cloudwatch-metrics.md).
# Criar alarmes do para métricas do
No console do CloudFront, é possível definir alarmes para notificá-lo pelo Amazon Simple Notification Service (Amazon SNS) com base em métricas específicas do CloudFront.
**Como criar alarmes para métricas**
1. Faça login no Console de gerenciamento da AWS e abra o console do CloudFront em [https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home).
1. No painel de navegação, selecione **Alarmes**.
1. Selecione **Create alarm (Criar alarme)**.
1. Em **Detalhes**, especifique o seguinte:
1. **Nome do alarme**: um nome para o alarme.
1. **Distribuição**: a distribuição do CloudFront para a qual você está criando o alarme.
1. Em **Condição**, especifique o seguinte:
1. **Métrica**: a métrica para a qual você está criando o alarme.
1. **“SE” **: o limite de quando o CloudWatch deve acionar um alarme e enviar uma notificação para o tópico do Amazon SNS. Por exemplo, para receber uma notificação quando a taxa de erro `5xx` exceder 1%, especifique o seguinte:
**Taxa de erros 5xx** **> 1**
1. **“POR” períodos consecutivos**: o período em que a condição deve ser atendida antes de acionar um alarme. Ao escolher um valor, vise um equilíbrio adequado entre um valor que não acione o alarme para problemas temporários, mas que acione o alarme para problemas persistentes ou reais.
1. (Opcional) **Notificar**: o tópico do Amazon SNS para o qual enviar a notificação se essa métrica acionar um alarme.
1. Selecione **Criar alarme**.
**Observações**
Ao inserir os valores da condição, use números inteiros sem pontuação. Por exemplo, para especificar mil, insira **1000**.
Para as taxas de erro `4xx`, `5xx` e total, o valor especificado é uma porcentagem.
Para solicitações, bytes obtidos por download e bytes enviados por upload, o valor especificado é em unidades. Por exemplo, 1073742000 bytes.
Consulte mais informações sobre como criar tópicos do Amazon SNS em [Creating an Amazon SNS topic](https://docs.aws.amazon.com/sns/latest/dg/sns-create-topic.html) no *Guia do desenvolvedor do Amazon Simple Notification Service*.
# Baixar dados de métricas no formato CSV
É possível fazer download dos dados de métricas do CloudWatch para uma distribuição do CloudFront no formato CSV.
**Como baixar dados de métricas no formato CSV**
1. Faça login no Console de gerenciamento da AWS e abra o console do CloudFront em [https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home).
1. No painel de navegação, escolha **Monitoring (Monitoramento)**.
1. Selecione a distribuição e escolha **Visualizar métricas de distribuição**.
1. Selecione **Baixar CSV** e escolha o período (por exemplo, **Para o último dia (período de 1 hora)**.
1. Depois que o arquivo for baixado, abra-o para visualizar as informações a seguir.
**Topics**
+ [Informações sobre o relatório](#cloudwatch-csv-header)
+ [Dados no relatório de métricas](#cloudwatch-csv-data)
## Informações sobre o relatório
As primeiras linhas do relatório incluem as seguintes informações:
**Versão**
A versão dos relatórios do CloudFront.
**Relatório**
O nome do relatório.
**DistributionID**
O ID da distribuição para a qual você executou o relatório.
**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**
O período de cada linha do relatório, por exemplo, `ONE_MINUTE`.
## Dados no relatório de métricas
O relatório inclui os seguintes valores:
**DistributionID**
O ID da distribuição para a qual você executou o relatório.
**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.
**TimeBucket**
A hora ou o dia ao qual os dados se aplicam, no Tempo Universal Coordenado (UTC).
**Solicitações**
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`) durante o período.
**BytesDownloaded**
O número de bytes baixados pelos visualizadores para a distribuição especificada durante o período.
**BytesUploaded**
O número de bytes que visualizadores enviaram por upload para a distribuição especificada durante o período.
**TotalErrorRatePct**
A porcentagem de solicitações para as quais o código de status HTTP foi um erro `4xx` ou `5xx` para a distribuição especificada durante o período.
**4xxErrorRatePct**
A porcentagem de solicitações para as quais o código de status HTTP foi um erro `4xx` para a distribuição especificada durante o período.
**5xxErrorRatePct**
A porcentagem de solicitações para as quais o código de status HTTP foi um erro `5xx` para a distribuição especificada durante o período.
Se você tiver [ativado métricas adicionais](viewing-cloudfront-metrics.md#monitoring-console.distributions-additional) para a distribuição, o relatório também incluirá os seguintes valores adicionais:
**401ErrorRatePct**
A porcentagem de solicitações para as quais o código de status HTTP foi um erro `401` para a distribuição especificada durante o período.
**403ErrorRatePct**
A porcentagem de solicitações para as quais o código de status HTTP foi um erro `403` para a distribuição especificada durante o período.
**404ErrorRatePct**
A porcentagem de solicitações para as quais o código de status HTTP foi um erro `404` para a distribuição especificada durante o período.
**502ErrorRatePct**
A porcentagem de solicitações para as quais o código de status HTTP foi um erro `502` para a distribuição especificada durante o período.
**503ErrorRatePct**
A porcentagem de solicitações para as quais o código de status HTTP foi um erro `503` para a distribuição especificada durante o período.
**504ErrorRatePct**
A porcentagem de solicitações para as quais o código de status HTTP foi um erro `504` para a distribuição especificada durante o período.
**OriginLatency**
O tempo total gasto, em milissegundos, desde o momento em que o CloudFront recebeu uma solicitação até o instante em que começou a fornecer uma resposta à rede (não ao visualizador), para solicitações que foram fornecidas da origem, não do cache do CloudFront. Isso também é conhecido como *latência de primeiro byte* ou *tempo até o primeiro byte*.
**CacheHitRate**
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.
# 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`