# Configurar uma aplicação móvel para usar o CloudWatch RUM
<a name="CloudWatch-RUM-web-mobile"></a>

Para monitorar aplicações móveis, crie um monitor de aplicações, configure-o para plataformas móveis e integre o SDK do AWS Distro for OpenTelemetry (ADOT) com a aplicação. O Mobile RUM usa o protocolo OpenTelemetry (OTLP) para enviar dados de telemetria a um endpoint OTLP dedicado. 

## Para criar um monitor de aplicações para uma plataforma móvel
<a name="mobile-platform-app-monitor"></a>

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 **Add app monitor** (Adicionar monitor de aplicações).

1. Em **App monitor name** (Nome do monitor de aplicações), insira um nome a ser usado para identificar esse monitor de aplicações no console do CloudWatch RUM.

1. Selecione **Android** ou **iOS** como plataforma.

1. Em **Armazenamento de dados**, é possível armazenar cópias dos eventos de log e intervalos do RUM OTEL no CloudWatch Logs e configurar a retenção. Por padrão, o grupo de logs do CloudWatch Logs retém os dados por 30 dias. Você pode ajustar seu período de retenção de logs no console de Logs do CloudWatch.

1. (Opcional) Em **Política baseada no recurso**, escolha adicionar uma política baseada em recursos para controlar quem pode enviar solicitações ao monitor de aplicações. Se você escolher **Criar política pública**, uma política de recurso será anexada para permitir que qualquer pessoa envie solicitações ao monitor de aplicações. Para obter mais informações, consulte [Usar políticas baseadas em recursos com o CloudWatch RUM](CloudWatch-RUM-resource-policies.md).

1. Para habilitar o rastreamento do AWS X-Ray das sessões de usuário incluídas na amostragem, escolha **Rastreamento ativo** e selecione **Rastrear o serviço com o AWS**.

   Se selecionado, os intervalos de OTEL gerados durante as sessões de usuário incluídas na amostragem serão rastreados. Você pode visualizar os rastros e intervalos dessas sessões de usuário no painel do RUM, no mapa de rastro e nas páginas de detalhes de rastro do X-Ray. Essas sessões de usuário também aparecerão como páginas de clientes no Application Signals depois que você as tiver habilitado para a aplicação.

1. (Opcional) Você pode adicionar tags ao monitor de aplicações:

   1. Em **Tags**, escolha **Adicionar nova tag**.

   1. Em **Chave**, insira um nome para a tag. É possível adicionar um valor opcional em **Valor**.

   1. Para adicionar outra tag, escolha novamente **Adicionar nova tag**.

   Para saber mais, consulte [Marcar recursos da AWS](https://docs.aws.amazon.com/tagging/latest/userguide/tagging-resources.html) no *Guia do usuário de marcação e do editor de tags da AWS*.

1. Escolha **Add app monitor** (Adicionar monitor de aplicações).

1. Na seção **Exemplo de código**, é possível copiar o trecho de código para adicioná-lo à aplicação. **Usando o SDK do AWS Distro for OpenTelemetry (ADOT), você pode escolher entre **instrumentação manual** para configurar o monitoramento no código da aplicação ou instrumentação de código zero** que requer alterações mínimas na configuração.

   Para aplicações Android e iOS, a instrumentação de código zero é a opção mais simples, pois inicializa automaticamente a coleta de telemetria usando um arquivo de configuração. A instrumentação manual permite maior controle do processo de inicialização e configuração.

1. Escolha **Copy** (Copiar) ou **Download** (Fazer download) e, em seguida, escolha **Done** (Pronto).

### Configuração de aplicação iOS
<a name="CloudWatch-RUM-ios-setup"></a>

Para aplicações iOS, integre o [SDK do AWS Distro for OpenTelemetry (ADOT) para iOS](https://github.com/aws-observability/aws-otel-swift) para habilitar o monitoramento RUM. O SDK é compatível com o iOS 16 e versões posteriores e fornece instrumentação automática para os cenários de performance usuais.

### Configuração de aplicações Android
<a name="CloudWatch-RUM-android-setup"></a>

Para aplicações Android, integre o [SDK do AWS Distro for OpenTelemetry (ADOT) para Android](https://github.com/aws-observability/aws-otel-android) para habilitar o monitoramento RUM. O SDK fornece instrumentação automática e é compatível com modelos de autenticação assinados e não assinados.

## Autenticação e segurança
<a name="CloudWatch-RUM-authentication"></a>

O Mobile RUM é compatível com modelos de autenticação flexíveis, conforme definido em seus SDKs.
+ As aplicações iOS usam o [SDK do AWS Distro for OpenTelemetry (ADOT)](https://github.com/aws-observability/aws-otel-swift) para iOS. 
+ As aplicações Adroid usam o [SDK do AWS Distro for OpenTelemetry (ADOT)](https://github.com/aws-observability/aws-otel-android) para Android.