

# Monitoramento do Synthetics (canários)
<a name="CloudWatch_Synthetics_Canaries"></a>

É possível usar o Amazon CloudWatch Synthetics para criar *canaries*, scripts configuráveis que são executados de acordo com uma programação, para monitorar os endpoints e as APIs. Os canaries seguem as mesmas rotas e executam as mesmas ações que um cliente, o que possibilita verificar continuamente a experiência do cliente, mesmo quando você não tem nenhum tráfego de cliente em seus aplicativos. Ao usar canaries, é possível descobrir problemas antes que seus clientes o façam.

Os canários consistem em scripts desenvolvidos em Node.js, Python ou Java. Eles criam funções do Lambda em sua conta que usam Node.js, Python ou Java como runtime. Os canaries trabalham por meio de protocolos HTTP e HTTPS. Os canários usam camadas do Lambda que contêm a biblioteca CloudWatch Synthetics. A biblioteca oferece implementações do CloudWatch Synthetics compatíveis com NodeJS, Python e Java.

Os canários nos runtimes Node.js e Python oferecem acesso programático a navegadores sem interface gráfica por meio do Playwright, Puppeteer ou Selenium Webdriver. Vários navegadores são compatíveis, incluindo um navegador Google Chrome sem interface gráfica e o Mozilla Firefox. Para obter mais informações sobre o Playwright, consulte [Playwright](https://playwright.dev/). Para obter mais informações sobre o Puppeteer, consulte [Puppeteer](https://developer.chrome.com/docs/puppeteer/). Para obter mais informações sobre o Selenium, consulte [Selenium](https://www.selenium.dev/). Os canários no Selenium são compatíveis apenas com o navegador Chrome. Os canários em Java são projetados para oferecer flexibilidade no monitoramento de qualquer tipo de serviço ou aplicação, e não incluem suporte para navegador ou frameworks.

Os canaries verificam a disponibilidade e a latência dos endpoints e podem armazenar dados de tempo de carregamento e capturas de tela da interface do usuário. Eles monitoram as APIs REST, os URLs e o conteúdo do site e podem verificar se há alterações não autorizadas de phishing, injeção de código e scripts entre sites.

 O CloudWatch Synthetics é integrado ao [Application Signals](CloudWatch-Application-Monitoring-Sections.md), que pode descobrir e monitorar serviços de aplicações, clientes, canários do Synthetics e dependências de serviços. Use o Application Signals para ver uma lista ou um mapa visual dos seus serviços, visualizar métricas de integridade com base nos seus objetivos de nível de serviço (SLOs) e fazer uma busca profunda para ver rastreamentos do X-Ray correlacionados para uma solução de problemas mais detalhada. Para ver seus canários no Application Signals, [ative o rastreamento ativo do X-Ray](CloudWatch_Synthetics_Canaries_tracing.md). Os canários são exibidos no [Mapa da aplicação](ServiceMap.md) conectado aos serviços e na página [Detalhes do serviço](ServiceDetail.md) dos serviços que eles chamam. 

Para obter uma demonstração dos canaries em vídeo, veja o seguinte:
+  [Introdução ao Amazon CloudWatch Synthetics](https://www.youtube.com/watch?v=MItluIsvfTo) 
+  [Demonstração do Amazon CloudWatch Synthetics](https://www.youtube.com/watch?v=hF3NM9j-u7I) 
+  [Criar canaries usando o Amazon CloudWatch Synthetics](https://www.youtube.com/watch?v=DSx65wW7lr0) 
+  [Monitoramento visual com o Amazon CloudWatch Synthetics](https://www.youtube.com/watch?v=_PCs-ucZz7E) 



É possível executar um canário uma vez ou em uma programação regular. Os canaries podem ser executados a cada minuto. É possível usar expressões cron e rate para agendar canaries.

Para obter informações sobre problemas de segurança a serem considerados antes de criar e executar canaries, consulte [Considerações de segurança para canaries do Synthetics](servicelens_canaries_security.md). 

Por padrão, os canaries criam várias métricas do CloudWatch no namespace `CloudWatchSynthetics`. Essas métricas têm `CanaryName` como uma dimensão. Os canaries que usam a função `executeStep()` ou `executeHttpStep()` da biblioteca de funções também têm `StepName` como dimensão. Para obter mais informações sobre a biblioteca de funções de canaries, consulte [Funções da biblioteca disponíveis para scripts o canário](CloudWatch_Synthetics_Canaries_Function_Library.md).

O CloudWatch Synthetics se integra bem ao mapa de rastreamento do X-Ray, que usa o CloudWatch com o AWS X-Ray para fornecer uma visualização completa dos serviços e ajudar a localizar gargalos de performance e a identificar com mais eficiência usuários afetados. Os canários criados com o CloudWatch Synthetics aparecem no mapa de rastreamento. Para obter mais informações, consulte [X-Ray Trace Map](https://docs.aws.amazon.com/xray/latest/devguide/xray-console-servicemap.html). 

Atualmente, o CloudWatch Synthetics está disponível em todas as regiões comerciais da AWS e regiões do GovCloud.

**nota**  
Na Ásia-Pacífico (Osaka), não há suporte para AWS PrivateLink. Na região Ásia-Pacífico (Jakarta), AWS PrivateLink e X-Ray não têm suporte.

**Topics**
+ [Funções e permissões obrigatórias para canaries do CloudWatch](CloudWatch_Synthetics_Canaries_Roles.md)
+ [Criar um canário](CloudWatch_Synthetics_Canaries_Create.md)
+ [Grupos](CloudWatch_Synthetics_Groups.md)
+ [Como testar um canário localmente](CloudWatch_Synthetics_Debug_Locally.md)
+ [Solucionar problemas de um canário](CloudWatch_Synthetics_Canaries_Troubleshoot.md)
+ [Código de exemplo para scripts do canário](CloudWatch_Synthetics_Canaries_Samples.md)
+ [Canaries e rastreamento do X-Ray](CloudWatch_Synthetics_Canaries_tracing.md)
+ [Execução de um canário em uma VPC](CloudWatch_Synthetics_Canaries_VPC.md)
+ [Criptografar artefatos do canário](CloudWatch_Synthetics_artifact_encryption.md)
+ [Visualizar estatísticas e detalhes de canaries](CloudWatch_Synthetics_Canaries_Details.md)
+ [Métricas do CloudWatch publicadas por canaries](CloudWatch_Synthetics_Canaries_metrics.md)
+ [Editar ou excluir um canário](synthetics_canaries_deletion.md)
+ [Iniciar, interromper, excluir ou atualizar o runtime de vários canários](synthetics_canaries_multi-action.md)
+ [Monitorar eventos do canário com o Amazon EventBridge](monitoring-events-eventbridge.md)
+ [Execução de atualizações seguras para o canário](performing-safe-canary-upgrades.md)