ChannelPublishingType 복합 형식

  • 아티클

채널에서 사용하는 세션에 대한 로깅 속성을 정의합니다.

<xs:complexType name="ChannelPublishingType">
    <xs:sequence
        minOccurs="0"
    >
        <xs:element name="level"
            type="UInt8Type"
            default="0"
            minOccurs="0"
         />
        <xs:element name="keywords"
            type="UInt64Type"
            default="0"
            minOccurs="0"
         />
        <xs:element name="controlGuid"
            type="GUIDType"
            minOccurs="0"
         />
        <xs:element name="bufferSize"
            type="UInt32Type"
            minOccurs="0"
         />
        <xs:element name="minBuffers"
            type="UInt32Type"
            minOccurs="0"
         />
        <xs:element name="fileMax"
            type="UInt32Type"
            minOccurs="0"
         />
        <xs:element name="maxBuffers"
            type="UInt32Type"
            minOccurs="0"
         />
        <xs:element name="latency"
            type="UInt32Type"
            minOccurs="0"
         />
        <xs:element name="clockType"
            default="SystemTime"
            minOccurs="0"
        >
            <xs:simpleType>
                <xs:restriction
                    base="xs:string"
                >
                    <xs:enumeration
                        value="SystemTime"
                     />
                    <xs:enumeration
                        value="QPC"
                     />
                </xs:restriction>
            </xs:simpleType>
        </xs:element>
        <xs:element name="sidType"
            minOccurs="0"
        >
            <xs:simpleType>
                <xs:restriction
                    base="xs:string"
                >
                    <xs:enumeration
                        value="None"
                     />
                    <xs:enumeration
                        value="Publishing"
                     />
                </xs:restriction>
            </xs:simpleType>
        </xs:element>
        <xs:any
            processContents="lax"
            minOccurs="0"
            maxOccurs="unbounded"
            namespace="##other"
         />
    </xs:sequence>
    <xs:anyAttribute
        processContents="lax"
        namespace="##other"
     />
</xs:complexType>

자식 요소

요소 Type Description
bufferSize UInt32Type 각 버퍼에 할당할 메모리 양(킬로바이트)입니다. 이벤트 속도가 상대적으로 낮은 경우 버퍼 크기를 메모리 페이지 크기로 설정해야 합니다. 이벤트 속도가 상대적으로 높을 것으로 예상되는 경우 더 큰 버퍼 크기를 지정하고 최대 버퍼 수를 늘려야 합니다.
버퍼 크기는 버퍼가 채워지고 플러시되어야 하는 속도에 영향을 줍니다. 작은 버퍼 크기에는 더 적은 메모리가 필요하지만 버퍼를 플러시해야 하는 속도가 증가합니다.
분석 및 디버그 채널의 기본 버퍼 크기는 4KB이고 관리 및 운영의 경우 64KB입니다.
clockType 각 이벤트에 대한 타임스탬프를 로깅할 때 사용할 클록 해상도입니다. SystemTime 또는 QPC를 지정할 수 있습니다. SystemTime은 저해상도(10밀리초) 타임스탬프를 제공하지만 검색 비용이 비교적 저렴합니다. 기본값은 SystemTime입니다.
QPC(쿼리 성능 카운터)는 고해상도(100나노초) 타임스탬프를 제공하지만 검색하는 데 비교적 비용이 많이 듭니다. 이벤트 속도가 높거나 소비자가 다른 버퍼의 이벤트를 병합하는 경우 QPC를 사용해야 합니다.
controlGuid GUIDType WPP 이벤트가 포함된 ETW 세션의 세션 GUID를 식별합니다. 이 설정은 디버그 형식의 채널에만 허용됩니다. 이러한 채널은 키워드를 0(0x0000000000000000)으로 설정하여 완전히 사용하도록 설정할 수 없습니다. 키워드를 0xffffffffffffffff 설정하여 사용하도록 설정해야 합니다.
fileMax UInt32Type 채널이 활성화될 때 서비스에서 새 로그 파일을 만들려는 최대 횟수입니다(컴퓨터가 다시 시작될 때 포함). 값이 0 또는 1이면 채널이 활성화되고 이전 이벤트가 손실될 때마다 서비스에서 로그 파일을 덮어씁니다. 값이 1보다 큰 경우 서비스는 이벤트를 유지하기 위해 채널이 활성화될 때마다 새 로그 파일을 만듭니다. 기본값은 1이고 지정할 수 있는 최대값은 16입니다.
서비스는 각 파일 이름에 0과 fileMax 1 사이의 3자리 소수 자릿수를 추가합니다. 예를 들어 filename.etl.xxx 여기서 xxx는 3자리 10진수입니다. 파일은 %windir%\System32\winevt\Logs에 있습니다.
키워드 UInt64Type 채널에 기록되는 이벤트의 범주를 결정하는 비트 마스크입니다. 키워드 특성 값이 0이면 공급자가 작성하는 모든 이벤트가 채널에 기록됩니다. 그렇지 않으면 키워드 비트 마스크에 포함된 키워드(keyword) 정의한 이벤트만 채널에 기록됩니다. 기본값은 0입니다.
controlGuid 특성이 설정된 디버그 채널은 키워드 특성을 0xFFFFFFFFFFFFFFFF 설정해야 합니다.
세션은 공급자를 사용하도록 설정할 때 키워드 값을 공급자에게 전달합니다.
대기 시간이 UInt32Type 버퍼를 플러시하기 전에 대기하는 시간(밀리초)입니다. 0이면 ETW는 버퍼가 가득 차자마자 버퍼를 플러시합니다. 0이 아닌 경우 ETW는 버퍼가 가득 차 있지 않더라도 값을 기반으로 이벤트를 포함하는 모든 버퍼를 플러시합니다. 일반적으로 버퍼가 가득 찬 경우에만 버퍼를 플러시하려고 합니다. 버퍼를 강제로 플러시하면 채워지지 않은 버퍼 공간이 있는 로그 파일의 파일 크기를 늘릴 수 있습니다. 기본값은 관리 및 운영 로그의 경우 1초, 분석 및 디버그 로그의 경우 5초입니다.
수준 UInt8Type 채널에 쓸 이벤트의 심각도 수준입니다. 서비스는 지정된 값보다 작거나 같은 수준 값이 있는 채널에 이벤트를 씁니다. 기본값은 0입니다. 즉, 모든 수준 값으로 이벤트를 기록합니다.
세션은 공급자를 사용하도록 설정할 때 수준 값을 공급자에게 전달합니다.
maxBuffers UInt32Type 세션에 할당할 최대 버퍼 수입니다. 일반적으로 이 값은 최소 버퍼 수와 20개입니다. 이 값은 minBuffers에 지정된 값보다 크거나 같아야 합니다.
분석 및 디버그 채널의 기본 최대 버퍼 수는 10KB이고 관리 및 운영의 경우 64KB입니다.
minBuffers UInt32Type 세션에 할당할 최소 버퍼 수입니다. 기본값은 0입니다.
sidType 채널에 기록된 각 이벤트에 보안 주체의 SID(보안 식별자)를 포함할지 여부를 결정합니다. SID를 이벤트에 포함하려면 이 특성을 "게시"로 설정합니다. SID는 이벤트가 기록되는 시점에 스레드 ID를 기반으로 설정됩니다. SID를 이벤트에 포함하지 않으려면 이 특성을 "None"으로 설정합니다. 기본값은 "게시"입니다.

설명

분석 및 디버그 채널 유형 또는 사용자 지정 격리를 지정하는 채널에 대해 이 게시 정보를 지정할 수 있습니다.

수준 및 키워드를 지정할 수 있지만 이러한 이벤트가 해당 채널에 대한 공급자로부터 수신되는 유일한 이벤트라는 점을 고려해야 합니다.

버퍼가 가득 차면 ETW는 버퍼를 로그 파일로 플러시합니다. 버퍼가 플러시할 수 있는 것보다 빠르게 채워지면 새 버퍼가 할당되고 세션의 버퍼 풀에 지정된 최대 수까지 추가됩니다. 이 제한을 초과하면 세션은 버퍼를 사용할 수 있게 될 때까지 들어오는 이벤트를 삭제합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버
 Windows Server 2008 [데스크톱 앱만 해당]