# 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.