파이프 선언 - Microsoft Windows용 Amazon Kinesis 에이전트
파이프 구성Windows 메트릭 파이프용 Kinesis 에이전트 구성

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

파이프 선언

사용파이프 선언를 사용하여 소스를 연결합니다 (소스 선언) 를 싱크 (sink 선언) Microsoft Windows에 대한 Amazon Kinesis 에이전트에 로그인합니다. 파이프 선언은 JSON 객체로 표현됩니다. Windows용 Kinesis 에이전트가 시작되면 지정된 파이프에 대한 소스에서 로그, 이벤트 또는 메트릭이 수집됩니다. 그런 다음 해당 파이프와 연결된 싱크를 사용하여 다양한 AWS 서비스로 스트리밍됩니다.

다음은 파이프 선언의 예입니다.

{
   "Id": "MyAppLogToCloudWatchLogs", 
   "SourceRef": "MyAppLog", 
   "SinkRef": "MyCloudWatchLogsSink" 
}

파이프 구성

모든 파이프 선언에는 다음 키-값 페어가 포함될 수 있습니다.

Id

파이프의 이름을 지정합니다 (필수). 구성 파일 내에서 고유해야 합니다.

Type

로그 데이터가 소스에서 싱크로 전송될 때 파이프에 의해 적용되는 변환 유형 (있는 경우) 을 지정합니다. 지원되는 유일한 값은 RegexFilterPipe입니다. 이 값을 사용하면 로그 레코드의 기본 텍스트 표현에 대한 정규 표현식 필터링을 사용할 수 있습니다. 필터링을 사용하면 관련 로그 레코드만 데이터 파이프라인으로 전송하여 전송 및 저장 비용을 줄일 수 있습니다. 이 키-값 페어는 선택 사항입니다. 기본 값은 변환을 제공하지 않는 것입니다.

FilterPattern

에 대한 정규 표현식을 지정합니다RegexFilterPipe싱크로 전송되기 전에 소스에서 수집한 로그 레코드를 필터링하는 데 사용되는 파이프라인 로그 레코드는RegexFilterPipe유형 파이프는 정규 표현식이 레코드의 기본 텍스트 표현과 일치 할 때 사용됩니다. 생성된 구조화된 로그 레코드 (예:ExtractionPattern키-값 페어를 입력합니다.DirectorySource선언을 사용하여 필터링 할 수 있습니다RegexFilterPipe메커니즘에 저장됩니다. 이 메커니즘은 구문 분석하기 전에 원래 텍스트 표현에 대해 작동하기 때문입니다. 이 키 - 값 쌍은 선택 사항이지만 파이프가RegexFilterPipe유형의 값이 포함됩니다.

다음은 예제입니다.RegexFilterPipe파이프 선언:

{
	"Id": "MyAppLog2ToFirehose",
	"Type": "RegexFilterPipe",
	"SourceRef": "MyAppLog2",
	"SinkRef": "MyFirehose",
	"FilterPattern": "^(10|11),.*",
	"IgnoreCase": false,
	"Negate": false
}
SourceRef

이름 (의 값을 지정Id키-값 쌍) 을 통해 파이프에 대한 로그, 이벤트 및 메트릭 데이터를 수집하는 소스를 정의하는 소스 선언을 정의합니다 (필수).

SinkRef

이름 (의 값을 지정Id키 - 값 쌍) 파이프에 대한 로그, 이벤트 및 메트릭 데이터를 수신하는 싱크를 정의하는 싱크 선언의 (필수).

IgnoreCase

선택 사항입니다. 다음 값을 허용합니다.true또는false. 로 설정된 경우true로 설정하면 정규식은 대소 문자를 구분하지 않는 방식으로 레코드와 일치합니다.

Negate

선택 사항입니다. 다음 값을 허용합니다.true또는false. 로 설정된 경우true, 파이프는 레코드를 전달합니다안 함정규식 와 일치해야 합니다.

전체 구성 파일의 예는RegexFilterPipe파이프 유형에 대한 자세한 내용은파이프 사용.

Windows 메트릭 파이프용 Kinesis 에이전트 구성

라는 기본 제공 메트릭 소스가 있습니다._KinesisTapMetricsSource에서 Windows용 Kinesis 에이전트에 대한 메트릭을 생성합니다. 있는 경우CloudWatch와 싱크 선언Id의MyCloudWatchSink의 경우 다음 예제 파이프라인 선언은 Windows용 Kinesis 에이전트가 생성한 메트릭을 해당 싱크로 전송합니다.

{
   "Id": "KinesisAgentMetricsToCloudWatch",
   "SourceRef": "_KinesisTapMetricsSource",
   "SinkRef": "MyCloudWatchSink"
}

Windows용 Kinesis 에이전트 기본 제공 메트릭 소스에 대한 자세한 내용은Windows용 Kinesis 에이전트 기본 제공 메트릭 소스.

구성 파일에서 Windows 성능 카운터 메트릭도 스트리밍하는 경우 Windows용 Kinesis 에이전트 메트릭 및 Windows 성능 카운터 메트릭 모두에 동일한 싱크를 사용하는 대신 별도의 파이프와 싱크를 사용하는 것이 좋습니다.