# Métricas do CloudWatch que você pode coletar com o CloudWatch RUM A tabela nesta seção lista as métricas que você coleta automaticamente com o CloudWatch RUM das aplicações Web, das aplicações móveis ou de ambas. Você também pode ver essas métricas no console do CloudWatch. Para obter mais informações, consulte [Visualizar métricas disponíveis](viewing_metrics_with_cloudwatch.md). Você também tem a opção de enviar as métricas ampliadas para o CloudWatch. Para obter mais informações, consulte [Métricas estendidas](CloudWatch-RUM-custom-and-extended-metrics.md#CloudWatch-RUM-vended-metrics). Essas métricas estão publicadas no namespace da métrica chamado `AWS/RUM`. Todas as métricas a seguir são publicadas com uma dimensão `application_name`. O valor dessa dimensão é o nome do monitor de aplicações. Algumas métricas também são publicadas com dimensões adicionais, conforme listado na tabela. **Métricas de aplicações Web** | Métrica | Unidade | Descrição | | --- | --- | --- | | `HttpStatusCodeCount` | Contagem | A contagem de respostas HTTP na aplicação por seu código de status de resposta. Dimensões adicionais: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonCloudWatch/latest/monitoring/CloudWatch-RUM-metrics.html) | | `Http4xxCount` | Contagem | A contagem de respostas HTTP na aplicação, com o código 4xx de status da resposta. Elas são calculadas com base em eventos `http_event` do RUM que resultam em códigos 4xx. | | `Http4xxCountPerSession` | Contagem | A contagem de respostas HTTP em uma sessão, com o código 4xx de status da resposta. Elas são calculadas com base em eventos `http_event` do RUM que resultam em códigos 4xx. | | `Http4xxCountPerPageView` | Contagem | A contagem de respostas HTTP em uma análise de página, com o código 4xx de status da resposta. Elas são calculadas com base em eventos `http_event` do RUM que resultam em códigos 4xx. | | `Http5xxCount` | Contagem | A contagem de respostas HTTP na aplicação, com o código 5xx de status da resposta. Elas são calculadas com base em eventos `http_event` do RUM que resultam em códigos 5xx. | | `Http5xxCountPerSession` | Contagem | A contagem de respostas HTTP na sessão, com o código 5xx de status da resposta. Elas são calculadas com base em eventos `http_event` do RUM que resultam em códigos 5xx. | | `Http5xxCountPerPageView` | Contagem | A contagem de respostas HTTP em uma análise de página, com o código 5xx de status da resposta. Elas são calculadas com base em eventos `http_event` do RUM que resultam em códigos 5xx. | | `JsErrorCount` | Contagem | A contagem de eventos de erro do JavaScript ingeridos. | | `JsErrorCountPerSession` | Contagem | A contagem de eventos de erro do JavaScript ingeridos em uma sessão. | | `JsErrorCountPerPageView` | Contagem | A contagem de eventos de erro do JavaScript ingeridos em uma análise de página. | | `NavigationFrustratedTransaction` | Contagem | A contagem de eventos de navegação com um `duration` maior que o limite frustrante, que é 8000 ms. A duração dos eventos de navegação é rastreada na métrica `PerformanceNavigationDuration`. | | `NavigationSatisfiedTransaction` | Contagem | A contagem de eventos de navegação com um `duration` menor que o objetivo Apdex, que é 2000 ms. A duração dos eventos de navegação é rastreada na métrica `PerformanceNavigationDuration`. | | `NavigationToleratedTransaction` | Contagem | A contagem de eventos de navegação com um `duration` entre 2000 ms e 8000 ms. A duração dos eventos de navegação é rastreada na métrica `PerformanceNavigationDuration`. | | `PageViewCount` | Contagem | A contagem de eventos de visualização de página ingeridos pelo monitor de aplicações. Esse cálculo é feito contando os eventos `page_view_event` do RUM. | | `PageViewCountPerSession` | Contagem | A contagem de eventos de visualização de página em uma sessão. | | `PerformanceResourceDuration` | Milissegundos | O `duration` de um evento de recurso. Dimensões adicionais: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonCloudWatch/latest/monitoring/CloudWatch-RUM-metrics.html) | | `PerformanceNavigationDuration` | Milissegundos | O `duration` de um evento de navegação. | | `RumEventPayloadSize` | Bytes | O tamanho de cada evento ingerido pelo CloudWatch RUM. Você também pode usar a estatística `SampleCount` para essa métrica para monitorar o número de eventos que um monitor de aplicações está ingerindo. | | `SessionCount` | Contagem | A contagem de eventos de início de sessão ingeridos pelo monitor de aplicações. Em outras palavras, o número de novas sessões iniciadas. | | `SessionDuration` | Milissegundos | A duração de uma sessão. Essas durações são calculadas com base no tempo entre o primeiro e o último evento em uma sessão. | | `TimeOnPage` | Milissegundos | A duração de uma visualização de página. Essas durações são calculadas com base no tempo até a próxima visualização de página, exceto para a última página em uma sessão, na qual é o tempo entre o primeiro e o último evento nessa página. | | `WebVitalsCumulativeLayoutShift` | Nenhum | Rastreia o valor dos eventos de deslocamento de layout cumulativos. | | `WebVitalsFirstInputDelay` | Milissegundos | Rastreia o valor dos primeiros eventos de atraso de entrada. | | `WebVitalsLargestContentfulPaint` | Milissegundos | Acompanha o valor dos maiores eventos de contentful paint. | | `WebVitalsInteractionToNextPaint` | Milissegundos | Rastreia o valor dos eventos de interação relacionados à próxima renderização visual. | Você pode configurar métricas ampliadas na aplicação móvel para fornecer dimensões adicionais para análise. **Métricas de aplicações móveis** | Métrica | Unidade | Descrição | | --- | --- | --- | | `ANRCount` | Contagem | No Android apenas: o número de incidentes de ANR (aplicação irresponsiva), o que ocorre quando a aplicação não responsiva por mais de 5 segundos, resultando em pane da aplicação. | | `AppHangCount` | Contagem | No iOS apenas: o número de vezes que a aplicação ficou irresponsiva por mais de 250 ms no loop principal. | | `ColdAppLaunchFrustratedTransaction` | Contagem | O número de inicializações a frio de aplicações que levaram mais de 8 segundos para serem concluídas, provavelmente causando frustração ao usuário. | | `ColdAppLaunchSatisfiedTransaction` | Contagem | O número de inicializações a frio de aplicações que levaram menos de 2 segundos, proporcionando uma experiência satisfatória ao usuário. | | `ColdAppLaunchToleratedTransaction` | Contagem | O número de inicializações a frio de aplicações que levaram entre 2 e 8 segundos, proporcionando uma experiência de usuário tolerável, mas não ideal. | | `ColdLaunchTime` | Milissegundos | Tempo necessário para iniciar a aplicação a partir de um estado de encerrada. No Android: tempo desde `onCreate` da aplicação até a conclusão da criação da primeira atividade. No iOS: tempo do início da aplicação (determinado pelo comando `sysctl` de início do processo) até `didBecomeActiveNotification`. | | `CrashCount` | Contagem | O número de encerramentos inesperados de aplicações causados por exceções não resolvidas ou encerramento do sistema operacional. No Android: panes devido a exceções não resolvidas ou ao encerramento do sistema. No iOS: panes devido a exceções não resolvidas, erros fatais ou ao encerramento do sistema. Os dados sobre a pane são armazenados localmente e relatados na próxima inicialização da aplicação. | | `DroppedEventsCount` | Contagem | O número de eventos de log que foram descartados porque excederam o limite máximo de 30 KB por evento. | | `DroppedSpansCount` | Contagem | O número de extensões que foram descartadas porque excederam o limite máximo de 30 KB por intervalos. | | `Http4xxCount` | Contagem | Registra o número de erros do cliente HTTP encontrados pela aplicação Web ou móvel durante solicitações HTTP. | | `Http5xxCount` | Contagem | Registra o número de erros do servidor HTTP encontrados pela aplicação Web ou móvel durante solicitações HTTP. | | `LogPayloadSize` | Bytes | O tamanho em bytes dos dados de telemetria do log que estão sendo enviados ao CloudWatch RUM. Você também pode usar a estatística `SampleCount` nessa métrica para monitorar o número de eventos que um monitor de aplicações ingere. | | `NetworkLatency` | Milissegundos | O tempo necessário para as solicitações de rede serem concluídas, medindo o tempo total, do início da solicitação até a conclusão da resposta. | | `ScreenLoadCount` | Contagem | O número total de carregamentos de tela. | | `ScreenLoadToleratedTransaction` | Contagem | O número de carregamentos de tela que levaram entre 2 e 8 segundos, proporcionando uma experiência de usuário tolerável, mas não ideal. | | `SessionCount` | Contagem | O número total de sessões de usuário individuais com a aplicação. Uma sessão começa quando o usuário abre a aplicação e termina após 30 minutos de inatividade ou quando é explicitamente encerrada. | | `SpanPayloadSize` | Bytes | O tamanho em bytes dos dados de telemetria do intervalo que estão sendo enviados ao CloudWatch RUM. Você também pode usar a estatística `SampleCount` nessa métrica para monitorar o número de intervalos que um monitor de aplicações ingere. | | `WarmAppLaunchFrustratedTransaction` | Contagem | O número de inicializações mornas de aplicações que levaram mais de 8 segundos para serem concluídas, provavelmente causando frustração ao usuário. | | `WarmAppLaunchSatisfiedTransaction` | Contagem | O número de inicializações mornas de aplicações que levaram menos de 2 segundos, proporcionando uma experiência satisfatória ao usuário. | | `WarmAppLaunchToleratedTransaction` | Contagem | O número de inicializações mornas de aplicações que levaram entre 2 e 8 segundos, proporcionando uma experiência de usuário tolerável, mas não ideal. | | `WarmLaunchTime` | Milissegundos | Tempo necessário para iniciar a aplicação a partir do estado de segundo plano. No Android: tempo desde `onCreate` da aplicação até a conclusão da criação da primeira atividade. No iOS: Tempo de `UIApplicationWillEnterForegroundNotification` até `didBecomeActiveNotification`. | # Métricas personalizadas e métricas ampliadas que podem ser enviadas para o CloudWatch Por padrão, os monitores de aplicações do RUM enviam métricas para o CloudWatch. Essas métricas e dimensões padrão estão listadas em [Métricas do CloudWatch que você pode coletar com o CloudWatch RUM](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-RUM-metrics.html). Além disso, é possível configurar um monitor de aplicações para exportar métricas. O monitor de aplicações pode enviar métricas estendidas, métricas personalizadas ou ambas. Ele pode enviá-las para o CloudWatch. + **Métricas personalizadas**: métricas personalizadas são as métricas que você define. Com métricas personalizadas, é possível usar qualquer nome e namespace de métrica. Para derivar as métricas, é possível usar quaisquer eventos personalizados, eventos incorporados, atributos personalizados ou atributos padrão. Saiba como enviar métricas para o CloudWatch. + **Métricas ampliadas**: também é possível enviar qualquer métrica padrão do CloudWatch RUM para o CloudWatch com dimensões adicionais. Dessa forma, essas métricas podem oferecer uma visão mais minuciosa. **Topics** + [Métricas personalizadas](#CloudWatch-RUM-custom-metrics) + [Métricas estendidas](#CloudWatch-RUM-vended-metrics) ## Métricas personalizadas Para enviar métricas personalizadas, você deve usar as APIs da AWS ou a AWS CLI em vez do console. Para obter informações sobre como usar as APIs da AWS, consulte [PutRumMetricsDestination](https://docs.aws.amazon.com/cloudwatchrum/latest/APIReference/API_PutRumMetricsDestination.html) e [BatchCreateRumMetricDefinitions](https://docs.aws.amazon.com/cloudwatchrum/latest/APIReference/API_BatchCreateRumMetricDefinitions.html). O número máximo de definições de métricas estendidas e métricas personalizadas que um destino pode conter é 2000. Para cada métrica personalizada ou métrica estendida que você envia a cada destino, cada combinação de nome de dimensão e valor de dimensão conta para esse limite. Não há cobranças por métricas personalizadas derivadas de qualquer tipo de eventos ou atributos do CloudWatch RUM. O exemplo a seguir mostra como criar uma métrica personalizada derivada de um evento personalizado. Aqui está o exemplo de evento personalizado usado: ``` cwr('recordEvent', { type: 'my_custom_event', data: { location: 'IAD', current_url: 'amazonaws.com', user_interaction: { interaction_1 : "click", interaction_2 : "scroll" }, visit_count:10 } }) ``` Com este evento personalizado, é possível criar uma métrica personalizada que contabilize o número de visitas ao URL `amazonaws.com` a partir de navegadores Chrome. A definição a seguir cria uma métrica chamada `AmazonVisitsCount` em sua conta, no namespace `RUM/CustomMetrics/PageVisits`. ``` { "AppMonitorName":"customer-appMonitor-name", "Destination":"CloudWatch", "MetricDefinitions":[ { "Name":"AmazonVisitsCount", "Namespace":"PageVisit", "ValueKey":"event_details.visit_count", "UnitLabel":"Count", "DimensionKeys":{ "event_details.current_url": "URL" }, "EventPattern":"{\"metadata\":{\"browserName\":[\"Chrome\"]},\"event_type\":[\"my_custom_event\"],\"event_details\": {\"current_url\": [\"amazonaws.com\"]}}" } ] } ``` ## Métricas estendidas Se configurar métricas ampliadas, poderá enviar qualquer métrica padrão do CloudWatch RUM para o CloudWatch com dimensões adicionais para que as métricas ofereçam uma visão mais refinada. Para obter mais informações sobre as métricas padrão do CloudWatch RUM, consulte [Métricas do CloudWatch que você pode coletar com o CloudWatch RUM](CloudWatch-RUM-metrics.md). O número máximo de definições de métricas estendidas e métricas personalizadas que um destino pode conter é 2000. Para cada métrica estendida ou métrica personalizada que você envia a cada destino, cada combinação de nome de dimensão e valor de dimensão conta como uma métrica estendida para esse limite. Quando você envia métricas estendidas para o CloudWatch, pode usar o console do CloudWatch RUM para criar alarmes do CloudWatch para essas métricas. Não há cobranças por métricas estendidas criadas para as métricas padrão do CloudWatch RUM. ### Métricas ampliadas de aplicações Web As seguintes dimensões são compatíveis com as métricas ampliadas de aplicação Web: + `BrowserName` Exemplo de valores de dimensão: `Chrome`, `Firefox`, `Chrome Headless` + `CountryCode` O formato ISO-3166, com códigos de duas letras, é usado. Exemplo de valores de dimensão: `US`, `JP`, `DE` + `DeviceType` Exemplo de valores de dimensão: `desktop`, `mobile`, `tablet`, `embedded` + `FileType` Exemplo de valores de dimensão: `Image`, `Stylesheet` + `OSName` Exemplo de valores de dimensão: `Linux`, `Windows`, `iOS`, `Android` + `PageId` ### Métricas ampliadas de aplicações móveis As seguintes dimensões são compatíveis com as métricas ampliadas de aplicação móvel: + `ScreenName` + Valor do atributo de nome de tela: `attributes.screen.name` da aplicação + Exemplos de valores: HomeScreen, SettingsView, ProfilePage + `DeviceModel` + Valor do atributo de modelo do dispositivo: `resource.attributes.device.model.name` + Exemplos de valores: iPhone14,3, SM-G998B + `OSVersion` + Valor do atributo de versão do sistema operacional: `resource.attributes.os.version` + Exemplos de valores: 16.0, 13.0 **nota** Métricas padrão atualmente compatíveis com aplicações móveis: `ScreenLoadTime`, `ScreenLoadCount`, `NetworkLatency`, `Http4xxCount`, `Http5xxCount`, `CrashCount`, `ANRCount`, `AppHangCount`, `ColdLaunchTime`, `WarmLaunchTime`, `SessionCount`, `SpanPayloadSize` e `LogPayloadSize`. ### Configurar métricas estendidas usando o console Para usar o console para enviar métricas estendidas ao CloudWatch, use as etapas a seguir. Para saber mais sobre o uso das APIs da AWS para enviar métricas ampliadas para o CloudWatch, consulte [PutRumMetricsDestination](https://docs.aws.amazon.com/cloudwatchrum/latest/APIReference/API_PutRumMetricsDestination.html) e [BatchCreateRumMetricDefinitions](https://docs.aws.amazon.com/cloudwatchrum/latest/APIReference/API_BatchCreateRumMetricDefinitions.html).. **Para usar o console para configurar um monitor de aplicações e enviar métricas estendidas do RUM para o CloudWatch** 1. Abra o console do CloudWatch, em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/). 1. No painel de navegação, escolha **Application Signals** e, em seguida, **RUM**. 1. Escolha o nome do monitor de aplicações que enviará as métricas. 1. Escolha a guia **Configuration** (Configuração) e escolha **RUM extended metrics** (Métricas estendidas do RUM). 1. Escolha **Send metrics** (Enviar métricas). 1. Selecione um ou mais nomes de métricas para enviar com dimensões adicionais. 1. Selecione um ou mais fatores para usar como dimensões para essas métricas. À medida que você faz suas escolhas, o número de métricas estendidas que são criadas é exibido em **Number of extended metrics** (Número de métricas estendidas). Esse número é calculado multiplicando o número de nomes de métricas escolhidos pelo número de dimensões diferentes que você cria. 1. Para enviar uma métrica com o ID da página como dimensão, escolha **Browse for page ID** (Procurar ID de página) e selecione os IDs de página a serem usados. 1. Para enviar uma métrica com o tipo de dispositivo como dimensão, escolha **Desktop devices** (Dispositivos desktop) ou **Mobile and tablets** (Celulares e tablets). 1. Para enviar uma métrica com o sistema operacional como dimensão, selecione um ou mais sistemas operacionais em **Operating system** (Sistema operacional). 1. Para enviar uma métrica com o tipo de navegador como dimensão, selecione um ou mais navegadores em **Browsers** (Navegadores). 1. Para enviar uma métrica com geolocalização como dimensão, selecione um ou mais locais em **Locations** (Locais). Somente os locais de onde esse monitor de aplicações relatou métricas aparecerão na lista para você escolher. 1. Quando você terminar de fazer suas seleções, escolha **Send metrics** (Enviar métricas). 1. (Opcional) Na lista **Extended metrics** (Métricas estendidas), para criar um alarme que monitore uma das métricas, escolha **Create alarm** (Criar alarme) na linha dessa métrica. Para obter informações gerais sobre alarmes do CloudWatch, consulte [Usar alarmes do Amazon CloudWatch](CloudWatch_Alarms.md). Para ver um tutorial sobre como configurar um alarme em uma métrica estendida do CloudWatch RUM, consulte [Tutorial: criar uma métrica estendida e definir um alarme para ela](#CloudWatch-RUM-extended-metrics-alarmtutorial). **Parar de enviar métricas estendidas** **Para usar o console para parar de enviar métricas estendidas** 1. Abra o console do CloudWatch, em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/). 1. No painel de navegação, escolha **Application Signals** e, em seguida, **RUM**. 1. Escolha o nome do monitor de aplicações que enviará as métricas. 1. Escolha a guia **Configuration** (Configuração) e escolha **RUM extended metrics** (Métricas estendidas do RUM). 1. Selecione uma ou mais combinações de nome de métrica e dimensão da métrica para parar de enviar. Em seguida, escolha **Actions** (Ações), **Delete** (Excluir). ### Tutorial: criar uma métrica estendida e definir um alarme para ela Este tutorial demonstra como configurar uma métrica estendida para ser enviada ao CloudWatch e, em seguida, como definir um alarme para essa métrica. Neste tutorial, você cria uma métrica que rastreia erros de JavaScript no navegador Chrome. **Para configurar essa métrica estendida e definir um alarme para ela** 1. Abra o console do CloudWatch, em [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/). 1. No painel de navegação, escolha **Application Signals** e, em seguida, **RUM**. 1. Escolha o nome do monitor de aplicações que enviará a métrica. 1. Escolha a guia **Configuration** (Configuração) e escolha **RUM extended metrics** (Métricas estendidas do RUM). 1. Escolha **Send metrics** (Enviar métricas). 1. Selecione **JSErrorCount**. 1. Em **Browsers** (Navegadores), selecione **Chrome**. Essa combinação de **JSErrorCount** e **Chrome** enviará uma métrica estendida para o CloudWatch. A métrica conta os erros de JavaScript apenas para as sessões de usuário que usam o navegador Chrome. O nome da métrica será **JSErrorCount** e o nome da dimensão será **Browser** (Navegador). 1. Escolha **Send metrics** (Enviar métricas). 1. Na lista **Extended metrics** (Métricas estendidas), escolha **Create alarm** (Criar alarme) na linha que exibe **JSErrorCount** em **Name** (Nome) e **Chrome** em **BrowserName**. 1. Em **Specify metric and conditions** (Especificar métrica e condições), confirme se os campos **Metric name** (Nome da métrica) e **BrowserName** estão preenchidos com os valores corretos. 1. Em **Statistic** (Estatística), selecione a estatística que você deseja usar para o alarme. **Average** (Média) é uma boa escolha para esse tipo de métrica de contagem. 1. Em **Period (Período)**, selecione **5 minutes (5 minutos)**. 1. Em **Condições**, faça o seguinte: + Escolha **Static** (Estático). + Escolha **Greater** (Maior) para especificar que o alarme entre no estado ALARM (ALARME) quando o número de erros for maior do que o limite que você está prestes a especificar. + Em **than...** (de...), insira o número para o limite do alarme. O alarme entra no estado ALARM (ALARME) quando o número de erros em um período de 5 minutos excede esse número. 1. (Opcional) Por padrão, o alarme entra no estado ALARM (ALARME) assim que o número de erros excede o número limite que você define durante um período de 5 minutos. Opcionalmente, você pode alterar esse valor para que o alarme só entre no estado ALARM (ALARME) se esse número for excedido por um período maior que 5 minutos. Para fazer isso, escolha **Additional configuration**(Configuração adicional) e, em **Datapoints to alarm** (Pontos de dados para alarme), especifique quantos períodos de 5 minutos precisam ter o número de erros acima do limite para disparar o alarme. Por exemplo, você pode selecionar 2 de 2 para que o alarme só seja disparado quando dois períodos consecutivos de 5 minutos ficarem acima do limite, ou 2 de 3 para que o alarme seja disparado se dois dos três períodos consecutivos de 5 minutos ficarem acima do limite. Para obter mais informações sobre esse tipo de avaliação de alarme, consulte [Avaliação de alarme](alarm-evaluation.md). 1. Escolha **Próximo**. 1. Em **Configure actions** (Configurar ações), especifique o que deve acontecer quando o alarme entrar em estado de alarme. Para receber uma notificação com o Amazon SNS, faça o seguinte: + Escolha **Adicionar notificação**. + Escolha **Em alarme**. + Selecione um tópico existente do SNS ou crie um novo. Se você criar um novo, especifique um nome para o tópico e adicione pelo menos um endereço de e-mail a ele. 1. Escolha **Próximo**. 1. Insira um nome e uma descrição opcional para o alarme e escolha **Next** (Avançar). 1. Revise os detalhes e escolha **Create alarm** (Criar alarme).