# CloudWatch 에이전트 시작
<a name="start-CloudWatch-Agent-on-premise-SSM-onprem"></a>

Systems Manager Run Command 또는 명령줄을 사용하여 CloudWatch 에이전트를 시작할 수 있습니다.

보안이 강화된 Linux(SELinux)가 활성화된 시스템에서 에이전트를 설정하는 방법에 대한 내용은 [보안이 강화된 Linux(SELinux)로 CloudWatch 에이전트 설정](CloudWatch-Agent-SELinux.md) 섹션을 참조하세요.

## Amazon EC2에서 명령줄을 사용하여 CloudWatch 에이전트 시작
<a name="start-CloudWatch-Agent-EC2-commands-fleet"></a>

다음 단계에 따라 Amazon EC2에서 명령줄을 사용하여 CloudWatch 에이전트를 시작합니다.

보안이 강화된 Linux(SELinux)가 활성화된 시스템에서 에이전트를 설정하는 방법에 대한 내용은 [보안이 강화된 Linux(SELinux)로 CloudWatch 에이전트 설정](CloudWatch-Agent-SELinux.md) 섹션을 참조하세요.

**Amazon EC2에서 명령줄을 사용하여 CloudWatch 에이전트를 시작하는 방법**

1. 사용하려는 에이전트 구성 파일을 에이전트를 실행할 서버에 복사합니다. 해당 파일을 복사할 경로 이름을 기록해 둡니다.

1. 이 명령에서 `-a fetch-config`는 에이전트가 최신 버전의 CloudWatch 에이전트 구성 파일을 로드하도록 하며 `-s`는 에이전트를 시작합니다.

   다음 명령 중 하나를 입력합니다. {{configuration-file-path}}를 에이전트 구성 파일의 경로로 바꿉니다. 이 파일을 마법사로 생성한 경우 `config.json`이라고 하며 수동으로 생성한 경우 `amazon-cloudwatch-agent.json`이라고 할 수 있습니다.

   Linux가 실행되는 EC2 인스턴스의 경우 다음 명령을 입력합니다.

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

   Linux가 실행되는 온프레미스 서버의 경우 다음을 입력합니다.

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

   Windows Server가 실행되는 EC2 인스턴스의 경우 PowerShell 콘솔에서 다음을 입력합니다.

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

   Windows Server가 실행되는 온프레미스 서버의 경우 PowerShell 콘솔에서 다음을 입력합니다.

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

## 온프레미스 서버에서 CloudWatch 에이전트 시작
<a name="start-CloudWatch-Agent-on-premises"></a>

다음 단계에 따라 온프레미스 서버에서 CloudWatch 에이전트를 시작합니다.

**SSM Agent를 사용하여 온프레미스 서버에서 CloudWatch 에이전트를 시작하려면**

1. [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)에서 Systems Manager 콘솔을 엽니다.

1. 탐색 창에서 **명령 실행**을 선택합니다.

   -또는-

   AWS Systems Manager 홈페이지가 열리면 아래로 스크롤하여 [**Run Command 탐색(Explore Run Command)**]을 선택합니다.

1. **명령 실행**을 선택합니다.

1. **명령 문서** 목록에서 **AmazonCloudWatch-ManageAgent** 옆의 버튼을 선택합니다.

1. **대상** 영역에서 에이전트를 설치한 인스턴스를 선택합니다.

1. **작업** 목록에서 **구성**을 선택합니다.

1. **모드** 목록에서 **onPremise**를 선택합니다.

1. [**구성 위치(선택 사항)(Optional Configuration Location)**] 상자에 마법사로 생성하여 파라미터 스토어에 저장한 에이전트 구성 파일의 이름을 입력합니다.

1. **실행**을 선택합니다.

   구성 파일에 지정한 구성을 사용하여 에이전트가 시작됩니다.

**명령줄을 사용하여 온프레미스 서버에서 CloudWatch 에이전트를 시작하려면**
+ 이 명령에서 `-a fetch-config`는 에이전트가 최신 버전의 CloudWatch 에이전트 구성 파일을 로드하도록 하며 `-s`는 에이전트를 시작합니다.

  Linux: Systems Manager 파라미터 스토어에 구성 파일을 저장한 경우 다음을 입력합니다.

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

  Linux: 구성 파일을 로컬 컴퓨터에 저장한 경우 다음 명령을 입력합니다. {{configuration-file-path}}를 에이전트 구성 파일의 경로로 바꿉니다. 이 파일을 마법사로 생성한 경우 `config.json`이라고 하며 수동으로 생성한 경우 `amazon-cloudwatch-agent.json`이라고 할 수 있습니다.

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

  Windows Server: Systems Manager 파라미터 스토어에 에이전트 구성 파일을 저장한 경우 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: 에이전트 구성 파일을 로컬 컴퓨터에 저장한 경우 PowerShell 콘솔에서 다음을 입력합니다. {{configuration-file-path}}를 에이전트 구성 파일의 경로로 바꿉니다. 이 파일을 마법사로 생성한 경우 `config.json`이라고 하며 수동으로 생성한 경우 `amazon-cloudwatch-agent.json`이라고 할 수 있습니다.

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