# Iniciar o atendente do CloudWatch
<a name="start-CloudWatch-Agent-on-premise-SSM-onprem"></a>

Você também pode iniciar o atendente do CloudWatch usando o Systems Manager Run Command ou a linha de comando.

Para obter informações sobre como configurar o agente em um sistema que tenha o Linux com segurança aprimorada (SELinux) habilitado, consulte [Configure o agente do CloudWatch com o Linux com segurança aprimorada (SELinux)](CloudWatch-Agent-SELinux.md).

## Inicialização do agente do CloudWatch usando a linha de comando no Amazon EC2
<a name="start-CloudWatch-Agent-EC2-commands-fleet"></a>

Siga estas etapas para usar a linha de comando com a finalidade de iniciar o agente do CloudWatch no Amazon EC2.

Para obter informações sobre como configurar o agente em um sistema que tenha o Linux com segurança aprimorada (SELinux) habilitado, consulte [Configure o agente do CloudWatch com o Linux com segurança aprimorada (SELinux)](CloudWatch-Agent-SELinux.md).

**Como usar a linha de comando para iniciar o agente do CloudWatch no Amazon EC2**

1. Copie o arquivo de configuração do atendente que você deseja usar no servidor onde você irá executar o atendente. Anote o nome do caminho onde você o copiar.

1. Nesse comando, `-a fetch-config` faz com que o atendente carregue a última versão do arquivo de configuração do atendente do CloudWatch e o `-s` inicia o atendente.

   Insira um dos seguintes comandos: Substitua {{configuration-file-path}} pelo caminho para o arquivo de configuração do atendente. Este arquivo é chamado `config.json`, se você o criou com o assistente, e pode ser chamado `amazon-cloudwatch-agent.json`, se você o criou manualmente.

   Em uma instância do EC2 que execute o Linux, insira o comando a seguir. 

   ```
   sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a fetch-config -m ec2 -s -c file:{{configuration-file-path}}
   ```

   Em um servidor on-premises que executa o Linux, digite o seguinte:

   ```
   sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a fetch-config -m onPremise -s -c file:{{configuration-file-path}}
   ```

   Em uma instância do EC2 que execute o Windows Server, digite o seguinte no console do PowerShell:

   ```
   & "C:\Program Files\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1" -a fetch-config -m ec2 -s -c file:{{configuration-file-path}}
   ```

   Em um servidor on-premises que executa o Windows Server, digite o seguinte no console do PowerShell:

   ```
   & "C:\Program Files\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1" -a fetch-config -m onPremise -s -c file:{{configuration-file-path}}
   ```

## Inicialização do agente do CloudWatch em um servidor on-premises
<a name="start-CloudWatch-Agent-on-premises"></a>

Siga estas etapas para usar a linha de comando com a finalidade de iniciar o agente do CloudWatch em um servidor on-premises.

**Para usar o SSM Agent para iniciar o atendente do CloudWatch em um servidor on-premises**

1. Abra o console do Systems Manager em [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. No painel de navegação, selecione **Executar comando**.

   - ou -

   Se a página inicial do AWS Systems Manager for exibida, role para baixo e escolha **Explore Run Command**.

1. Selecione **Run command**.

1. Na lista **Documento do comando**, selecione o botão ao lado de **AmazonCloudWatch-ManageAgent**.

1. Na área **Destinos**, selecione a instância onde você instalou o atendente.

1. Na lista **Ação**, escolha **configurar**.

1. Na lista **Modo**, escolha **No local**.

1. Na caixa **Optional Configuration Location** (Local de configuração opcional), insira o nome do arquivo de configuração do atendente que você criou com o assistente e armazenou no Parameter Store.

1. Escolha **Executar**.

   O atendente começa com a configuração especificada no arquivo de configuração.

**Para usar a linha de comando para iniciar o atendente do CloudWatch em um servidor on-premises**
+ Nesse comando, `-a fetch-config` faz com que o atendente carregue a última versão do arquivo de configuração do atendente do CloudWatch e o `-s` inicia o atendente.

  Linux: se você salvou o arquivo de configuração no Systems Manager Parameter Store, insira o seguinte:

  ```
  sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a fetch-config -m onPremise -s -c ssm:{{configuration-parameter-store-name}}
  ```

  Linux: se você salvou o arquivo de configuração no computador local, insira o comando a seguir. Substitua {{configuration-file-path}} pelo caminho para o arquivo de configuração do atendente. Este arquivo é chamado `config.json`, se você o criou com o assistente, e pode ser chamado `amazon-cloudwatch-agent.json`, se você o criou manualmente.

  ```
  sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a fetch-config -m onPremise -s -c file:{{configuration-file-path}}
  ```

  Windows Server: se você salvou o arquivo de configuração do atendente no Systems Manager Parameter Store, insira o seguinte no console do PowerShell:

  ```
  & "C:\Program Files\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1" -a fetch-config -m onPremise -s -c ssm:{{configuration-parameter-store-name}}
  ```

  Windows Server: se você salvou o arquivo de configuração do atendente no computador local, digite o comando a seguir no console do PowerShell. Substitua {{configuration-file-path}} pelo caminho para o arquivo de configuração do atendente. Este arquivo é chamado `config.json`, se você o criou com o assistente, e pode ser chamado `amazon-cloudwatch-agent.json`, se você o criou manualmente.

  ```
  & "C:\Program Files\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1" -a fetch-config -m onPremise -s -c file:{{configuration-file-path}}
  ```