빠른 시작: Windows Server 2012 및 Windows Server 2008을 실행하는 Amazon EC2 인스턴스가 CloudWatch Logs로 로그를 전송하도록 설정

CloudWatch Logs로 로그 데이터를 보내기 위해 설정을 구성하려면

1. JSON 파일에서 CloudWatchLogs 섹션을 찾습니다.

   {
       "Id": "CloudWatchLogs",
       "FullName": "AWS.EC2.Windows.CloudWatch.CloudWatchLogsOutput,AWS.EC2.Windows.CloudWatch",
       "Parameters": {
           "AccessKey": "",
           "SecretKey": "",
           "Region": "us-east-1",
           "LogGroup": "Default-Log-Group",
           "LogStream": "{instance_id}"
       }
   },

2. AccessKey 및 SecretKey 필드는 비워둡니다. IAM 역할을 사용하여 자격 증명을 구성합니다.

3. Region에 로그 데이터를 보내려는 리전을 입력합니다(예: us-east-2).

4. LogGroup에 로그 그룹의 이름을 입력합니다. 이 이름은 CloudWatch 콘솔에서 로그 그룹 화면에 나타납니다.

5. LogStream에 대상 로그 스트림을 입력합니다. 이 이름은 CloudWatch 콘솔에서 로그 그룹 > 스트림 화면에 나타납니다.

   {instance_id}를 사용하는 경우 기본적으로 로그 스트림 이름은 이 인스턴스의 인스턴스 ID입니다.

   아직 존재하지 않는 로그 스트림 이름을 지정하면 CloudWatch Logs에서 이 이름을 자동으로 생성합니다. 리터럴 문자열, 미리 정의된 변수 {instance_id}, {hostname} 및 {ip_address}, 또는 이들의 조합을 사용하여 로그 스트림 이름을 정의할 수 있습니다.

CloudWatch Logs로 Windows 애플리케이션 이벤트 로그 데이터를 보내려면

1. JSON 파일에서 ApplicationEventLog 섹션을 찾습니다.

   {
       "Id": "ApplicationEventLog",
       "FullName": "AWS.EC2.Windows.CloudWatch.EventLog.EventLogInputComponent,AWS.EC2.Windows.CloudWatch",
       "Parameters": {
           "LogName": "Application",
           "Levels": "1"
       }
   },

2. Levels에서 업로드할 메시지의 유형을 지정합니다. 다음 값 중 하나를 지정할 수 있습니다.

   • 1 - 오류 메시지만 업로드됩니다.

   • 2 - 경고 메시지만 업로드됩니다.

   • 4 - 정보 메시지만 업로드됩니다.

   값을 적절히 조합하여 두 가지 이상의 메시지 유형을 포함할 수 있습니다. 예를 들어 값 3을 지정하면 오류 메시지(1)와 경고 메시지(2)가 업로드됩니다. 값 7을 지정하면 오류 메시지(1), 경고 메시지(2) 및 정보 메시지(4)가 업로드됩니다.

CloudWatch Logs로 보안 로그 데이터를 보내려면

1. JSON 파일에서 SecurityEventLog 섹션을 찾습니다.

   {
       "Id": "SecurityEventLog",
       "FullName": "AWS.EC2.Windows.CloudWatch.EventLog.EventLogInputComponent,AWS.EC2.Windows.CloudWatch",
       "Parameters": {
           "LogName": "Security",
           "Levels": "7"
       }
   },

2. 모든 메시지를 업로드하려면 Levels에 7을 입력합니다.

CloudWatch Logs에 시스템 이벤트 로그 데이터를 보내려면

1. JSON 파일에서 SystemEventLog 섹션을 찾습니다.

   {
       "Id": "SystemEventLog",
       "FullName": "AWS.EC2.Windows.CloudWatch.EventLog.EventLogInputComponent,AWS.EC2.Windows.CloudWatch",
       "Parameters": {
           "LogName": "System",
           "Levels": "7"
       }
   },

2. Levels에서 업로드할 메시지의 유형을 지정합니다. 다음 값 중 하나를 지정할 수 있습니다.

   • 1 - 오류 메시지만 업로드됩니다.

   • 2 - 경고 메시지만 업로드됩니다.

   • 4 - 정보 메시지만 업로드됩니다.

   값을 적절히 조합하여 두 가지 이상의 메시지 유형을 포함할 수 있습니다. 예를 들어 값 3을 지정하면 오류 메시지(1)와 경고 메시지(2)가 업로드됩니다. 값 7을 지정하면 오류 메시지(1), 경고 메시지(2) 및 정보 메시지(4)가 업로드됩니다.

CloudWatch Logs로 다른 유형의 이벤트 로그 데이터를 보내려면

1. JSON 파일에서 새 섹션을 추가합니다. 각 섹션에는 고유한 Id가 있어야 합니다.

   {
       "Id": "Id-name",
       "FullName": "AWS.EC2.Windows.CloudWatch.EventLog.EventLogInputComponent,AWS.EC2.Windows.CloudWatch",
       "Parameters": {
           "LogName": "Log-name",
           "Levels": "7"
       }
   },

2. Id에 업로드할 로그의 이름을 입력합니다(예: WindowsBackup).

3. LogName에 업로드할 로그의 이름을 입력합니다. 로그 이름은 다음과 같이 확인할 수 있습니다.

   1. 이벤트 뷰어를 엽니다.

   2. 탐색 창에서 Applications and Services Logs(응용 프로그램 및 서비스 로그)를 선택합니다.

   3. 로그로 이동한 다음 작업, 속성을 선택합니다.

4. Levels에서 업로드할 메시지의 유형을 지정합니다. 다음 값 중 하나를 지정할 수 있습니다.

   • 1 - 오류 메시지만 업로드됩니다.

   • 2 - 경고 메시지만 업로드됩니다.

   • 4 - 정보 메시지만 업로드됩니다.

   값을 적절히 조합하여 두 가지 이상의 메시지 유형을 포함할 수 있습니다. 예를 들어 값 3을 지정하면 오류 메시지(1)와 경고 메시지(2)가 업로드됩니다. 값 7을 지정하면 오류 메시지(1), 경고 메시지(2) 및 정보 메시지(4)가 업로드됩니다.

CloudWatch Logs로 Windows용 이벤트 추적 데이터를 보내려면

ETW(Windows용 이벤트 추적)는 애플리케이션이 로그를 기록할 수 있는 효율적이고 세부적인 로깅 메커니즘을 제공합니다. 로깅 세션을 시작하고 중지할 수 있는 세션 관리자가 각 ETW를 제어합니다. 각 세션에는 한 공급자와 하나 또는 그 이상의 소비자가 있습니다.

1. JSON 파일에서 ETW 섹션을 찾습니다.

   {
       "Id": "ETW",
       "FullName": "AWS.EC2.Windows.CloudWatch.EventLog.EventLogInputComponent,AWS.EC2.Windows.CloudWatch",
       "Parameters": {
           "LogName": "Microsoft-Windows-WinINet/Analytic",
           "Levels": "7"
       }
   },

2. LogName에 업로드할 로그의 이름을 입력합니다.

3. Levels에서 업로드할 메시지의 유형을 지정합니다. 다음 값 중 하나를 지정할 수 있습니다.

   • 1 - 오류 메시지만 업로드됩니다.

   • 2 - 경고 메시지만 업로드됩니다.

   • 4 - 정보 메시지만 업로드됩니다.

   값을 적절히 조합하여 두 가지 이상의 메시지 유형을 포함할 수 있습니다. 예를 들어 값 3을 지정하면 오류 메시지(1)와 경고 메시지(2)가 업로드됩니다. 값 7을 지정하면 오류 메시지(1), 경고 메시지(2) 및 정보 메시지(4)가 업로드됩니다.

CloudWatch Logs로 사용자 지정 로그(텍스트 기반 로그 파일)를 보내려면

1. JSON 파일에서 CustomLogs 섹션을 찾습니다.

   {
       "Id": "CustomLogs",
       "FullName": "AWS.EC2.Windows.CloudWatch.CustomLog.CustomLogInputComponent,AWS.EC2.Windows.CloudWatch",
       "Parameters": {
           "LogDirectoryPath": "C:\\CustomLogs\\",
           "TimestampFormat": "MM/dd/yyyy HH:mm:ss",
           "Encoding": "UTF-8",
           "Filter": "",
           "CultureName": "en-US",
           "TimeZoneKind": "Local",
           "LineCount": "5"
       }
   },

2. LogDirectoryPath에서 인스턴스에 로그가 저장된 경로를 입력합니다.

3. TimestampFormat에 사용할 타임스탬프 형식을 입력합니다. 지원되는 값에 대한 자세한 내용은 MSDN의 사용자 지정 날짜 및 시간 형식 문자열 주제를 참조하세요.

   중요

   원본 로그 파일에는 각 로그 줄의 시작 부분에 타임스탬프가 있어야 하고 타임스탬프 뒤에는 공백이 있어야 합니다.

4. Encoding에 사용할 파일 인코딩을 입력합니다(예: UTF-8). 지원되는 값에 대한 자세한 내용은 MSDN의 인코딩 클래스 주제를 참조하세요.

   참고

   표시 이름이 아니라 인코딩 이름을 사용하세요.

5. (선택 사항) Filter에 로그 이름의 접두사를 입력합니다. 모든 파일을 모니터링하려면 이 파라미터를 공백으로 둡니다. 지원되는 값에 대한 자세한 내용은 MSDN의 FileSystemWatcherFilter 속성 주제를 참조하세요.

6. (선택 사항) CultureName에 타임스탬프가 기록되는 로캘을 입력합니다. CultureName이 공백이면 기본적으로 Windows 인스턴스에서 현재 사용 중인 것과 같은 로캘로 설정됩니다. 지원되는 값에 대한 자세한 내용은 MSDN에서 제품 동작 주제의 표에 있는 Language tag 열을 참조하세요.

   참고

   div, div-MV, hu 및 hu-HU 값은 지원되지 않습니다.

7. (선택 사항) TimeZoneKind에 Local 또는 UTC를 입력합니다. 로그의 타임스탬프에 표준 시간대 정보가 포함되어 있지 않을 때 이렇게 설정하여 표준 시간대 정보를 제공할 수 있습니다. 이 파라미터가 공백으로 남겨져 있고 타임스탬프에 시간대 정보가 포함되어 있지 않으면 CloudWatch Logs가 기본적으로 현지 표준 시간대로 설정됩니다. 타임스탬프에 표준 시간대 정보가 이미 포함된 경우 이 파라미터는 무시됩니다.

8. (선택 사항) LineCount에 로그 파일을 식별할 헤더의 줄 수를 입력합니다. 예를 들어 IIS 로그 파일에 있는 헤더들은 사실상 동일합니다. 5를 입력하면 로그 파일 헤더에서 처음 나오는 세 줄을 읽어 식별하는 식입니다. IIS 로그 파일에서 처음 나오는 세 줄은 날짜와 타임스탬프이지만, 로그 파일 간에 타임스탬프가 반드시 다르지는 않습니다. 이러한 이유로, 로그 파일에 고유한 지문을 남기기 위해 실제 로그 데이터를 한 줄 이상 포함하는 것이 좋습니다.

CloudWatch Logs로 IIS 로그 데이터를 보내려면

1. JSON 파일에서 IISLog 섹션을 찾습니다.

   {
       "Id": "IISLogs",
       "FullName": "AWS.EC2.Windows.CloudWatch.CustomLog.CustomLogInputComponent,AWS.EC2.Windows.CloudWatch",
       "Parameters": {
           "LogDirectoryPath": "C:\\inetpub\\logs\\LogFiles\\W3SVC1",
           "TimestampFormat": "yyyy-MM-dd HH:mm:ss",
           "Encoding": "UTF-8",
           "Filter": "",
           "CultureName": "en-US",
           "TimeZoneKind": "UTC",
           "LineCount": "5"
       }
   },

2. LogDirectoryPath에 개별 사이트에 대해 IIS 로그를 저장할 폴더를 입력합니다(예: C:\inetpub\logs\LogFiles\W3SVCn).

   참고

   W3C 로그 형식만 지원됩니다. IIS, NCSA 및 사용자 지정 형식은 지원되지 않습니다.

3. TimestampFormat에 사용할 타임스탬프 형식을 입력합니다. 지원되는 값에 대한 자세한 내용은 MSDN의 사용자 지정 날짜 및 시간 형식 문자열 주제를 참조하세요.

4. Encoding에 사용할 파일 인코딩을 입력합니다(예: UTF-8). 지원되는 값에 대한 자세한 내용은 MSDN의 인코딩 클래스 주제를 참조하세요.

   참고

   표시 이름이 아니라 인코딩 이름을 사용하세요.

5. (선택 사항) Filter에 로그 이름의 접두사를 입력합니다. 모든 파일을 모니터링하려면 이 파라미터를 공백으로 둡니다. 지원되는 값에 대한 자세한 내용은 MSDN의 FileSystemWatcherFilter 속성 주제를 참조하세요.

6. (선택 사항) CultureName에 타임스탬프가 기록되는 로캘을 입력합니다. CultureName이 공백이면 기본적으로 Windows 인스턴스에서 현재 사용 중인 것과 같은 로캘로 설정됩니다. 지원되는 값에 대한 자세한 내용은 MSDN에서 제품 동작 주제의 표에 있는 Language tag 열을 참조하세요.

   참고

   div, div-MV, hu 및 hu-HU 값은 지원되지 않습니다.

7. (선택 사항) TimeZoneKind에 Local 또는 UTC를 입력합니다. 로그의 타임스탬프에 표준 시간대 정보가 포함되어 있지 않을 때 이렇게 설정하여 표준 시간대 정보를 제공할 수 있습니다. 이 파라미터가 공백으로 남겨져 있고 타임스탬프에 시간대 정보가 포함되어 있지 않으면 CloudWatch Logs가 기본적으로 현지 표준 시간대로 설정됩니다. 타임스탬프에 표준 시간대 정보가 이미 포함된 경우 이 파라미터는 무시됩니다.

8. (선택 사항) LineCount에 로그 파일을 식별할 헤더의 줄 수를 입력합니다. 예를 들어 IIS 로그 파일에 있는 헤더들은 사실상 동일합니다. 5를 입력하면 로그 파일 헤더에서 처음 나오는 다섯 줄을 읽어 식별하는 식입니다. IIS 로그 파일에서 처음 나오는 세 줄은 날짜와 타임스탬프이지만, 로그 파일 간에 타임스탬프가 반드시 다르지는 않습니다. 이러한 이유로, 로그 파일에 고유한 지문을 남기기 위해 실제 로그 데이터를 한 줄 이상 포함하는 것이 좋습니다.

흐름 제어를 구성하는 방법

1. AWS.EC2.Windows.CloudWatch.json 파일에서 Flows 섹션을 찾습니다.

   "Flows": {
       "Flows": [
         "PerformanceCounter,CloudWatch",
         "(PerformanceCounter,PerformanceCounter2), CloudWatch2",
         "(CustomLogs, ETW, SystemEventLog),CloudWatchLogs",
         "CustomLogs, CloudWatchLogs2",
         "ApplicationEventLog,(CloudWatchLogs, CloudWatchLogs2)"
       ]
   }

2. Flows에서 업로드할 각 데이터 형식(예: ApplicationEventLog) 및 대상(예: CloudWatchLogs)을 추가합니다.

EC2Config 4.x를 사용하여 CloudWatch를 구성하려면

1. 이 절차에서 앞서 편집한 AWS.EC2.Windows.CloudWatch.json 파일의 인코딩을 확인합니다. BOM 없는 UTF-8 인코딩만 지원됩니다. Windows Server 2008 - 2012 R2 인스턴스에서 다음 폴더에 파일을 저장합니다. C:\Program Files\Amazon\SSM\Plugins\awsCloudWatch\.

2. Windows Services 제어판을 사용하거나 PowerShell에서 다음 명령을 사용하여 SSM 에이전트(AmazonSSMAgent.exe)를 시작하거나 다시 시작합니다.

   PS C:\> Restart-Service AmazonSSMAgent