# Documentos do AWS Systems Manager (SSM) usados ​​pelo CloudWatch Application Insights
<a name="appinsights-ssm-documents"></a>

O Application Insights usa os documentos do SSM listados nesta seção para definir as ações que o AWS Systems Manager executa em suas instâncias gerenciadas. Esses documentos utilizam a funcionalidade `Run Command` do Systems Manager para automatizar as tarefas necessárias para a execução das funcionalidades de monitoramento do Application Insights. As programações de execuções para esses documentos são mantidas pelo Application Insights e não podem ser alteradas.

Para obter mais informações sobre os documentos do SSM, consulte [Documentos do AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/documents.html) no *Guia do usuário do AWS Systems Manager*.

## Documentos gerenciados pelo CloudWatch Application Insights
<a name="ssm-documents-appinsights-managed"></a>

A tabela apresentada a seguir lista os documentos do SSM que são gerenciados pelo Application Insights.


| Nome do documento | Descrição | Programação de execução | 
| --- | --- | --- | 
| `AWSEC2-DetectWorkload` | Detecta automaticamente as aplicações em execução no seu ambiente de aplicações que podem ser configuradas para serem monitoradas pelo Application Insights. | Esse documento é executado de hora em hora no ambiente de aplicações para obter detalhes atualizados das aplicações. | 
| `AWSEC2-CheckPerformanceCounterSets` | Verifica se os namespaces do contador de performance estão habilitados nas instâncias do Windows do Amazon EC2. | Esse documento é executado de hora em hora no seu ambiente de aplicações e vai monitorar somente as métricas do contador de performance se os namespaces correspondentes estiverem habilitados. | 
| `AWSEC2-ApplicationInsightsCloudwatchAgentInstallAndConfigure` | Instala e configura o agente do CloudWatch com base na configuração de monitoramento dos componentes da aplicação. | Esse documento é executado a cada 30 minutos para garantir que a configuração do agente do CloudWatch esteja sempre precisa e atualizada. O documento também é executado imediatamente após uma alteração ser realizada na configuração de monitoramento da aplicação, como a adição ou a remoção de métricas ou a atualização das configurações de log.  | 

## Documentos gerenciados pelo AWS Systems Manager
<a name="ssm-documents-aws-managed"></a>

Os documentos apresentados a seguir são usados ​​pelo CloudWatch Application Insights e gerenciados pelo Systems Manager.

**`AWS-ConfigureAWSPackage`**  
O Application Insights usa esse documento para instalar e desinstalar pacotes de distribuidores exportadores do Prometheus, para coletar métricas específicas da workload e para habilitar o monitoramento abrangente de workloads em instâncias do Amazon EC2 do cliente. O CloudWatch Application Insights instalará os pacotes de distribuidores exportadores do Prometheus somente se a workload de destino correlacionada estiver em execução na sua instância. 

A tabela apresentada a seguir lista os pacotes de distribuidores exportadores do Prometheus e as workloads de destino correlacionadas.


| Nome do pacote de distribuidor exportador do Prometheus | Workload de destino | 
| --- | --- | 
| `AWSObservabilityExporter-HAClusterExporterInstallAndConfigure` | SAP HANA HA | 
| `AWSObservabilityExporter-JMXExporterInstallAndConfigure` | Java/JMX | 
| `AWSObservabilityExporter-SAP-HANADBExporterInstallAndConfigure` | SAP HANA | 
| `AWSObservabilityExporter-SAP-SAPHostExporterInstallAndConfigure` | NetWeaver | 
| `AWSObservabilityExporter-SQLExporterInstallAndConfigure` | SQL Server (Windows) e SAP ASE (Linux) | 

**`AmazonCloudWatch-ManageAgent`**  
O Application Insights usa esse documento para gerenciar o status e a configuração do agente do CloudWatch em suas instâncias e para coletar métricas e logs internos no nível do sistema usando as instâncias do Amazon EC2 em sistemas operacionais.