ChannelType 복합 형식

공급자가 이벤트를 기록할 수 있는 채널을 정의 합니다.

<xs:complexType name="ChannelType"
    mixed="true"
>
    <xs:sequence>
        <xs:element name="logging"
            type="ChannelLoggingType"
            minOccurs="0"
         />
        <xs:element name="publishing"
            type="ChannelPublishingType"
            minOccurs="0"
         />
    </xs:sequence>
    <xs:attribute name="name"
        type="anyURI"
        use="required"
     />
    <xs:attribute name="chid"
        type="token"
        use="optional"
     />
    <xs:attribute name="type"
        type="string"
        use="required"
     />
    <xs:attribute name="symbol"
        type="CSymbolType"
        use="optional"
     />
    <xs:attribute name="access"
        type="string"
        use="optional"
     />
    <xs:attribute name="isolation"
        type="string"
        use="optional"
     />
    <xs:attribute name="enabled"
        type="boolean"
        default="false"
        use="optional"
     />
    <xs:attribute name="value"
        type="UInt8Type"
        use="optional"
     />
    <xs:attribute name="message"
        type="string"
        use="optional"
     />
</xs:complexType>

자식 요소

요소 유형 설명
기록이 ChannelLoggingType 채널을 백업 하는 로그 파일의 용량, 로그 파일의 순차적 또는 순환 여부 등의 속성을 정의 합니다.
블로그 ChannelPublishingType 채널에서 사용 하는 세션에 대 한 로깅 속성을 정의 합니다. 사용자 지정 격리를 사용 하는 디버그 및 분석 채널과 채널의 경우에는 해당 세션에 대 한 로깅 속성을 지정할 수 있습니다.

특성

Name 유형 설명
access 문자열 채널을 백업 하는 로그 파일에 대 한 액세스를 제어 하는 SDDL ( Security Descriptor Definition Language ) 액세스 설명자입니다. 격리 특성이 응용 프로그램 또는 시스템으로 설정 된 경우 액세스 설명자는 파일에 대 한 읽기 액세스를 제어 합니다 (쓰기 권한은 무시 됨). 격리 특성이 Custom으로 설정 된 경우 액세스 설명자는 채널에 대 한 쓰기 액세스와 파일에 대 한 읽기 액세스를 제어 합니다.
자식 token 공급자가 정의 하거나 가져오는 채널 목록에서 채널을 고유 하 게 식별 하는 식별자입니다. 이벤트에서 채널을 참조할 때이 값을 사용 합니다. 채널 식별자를 지정 하지 않으면 채널 이름을 사용 하 여 이벤트 정의에서이 채널을 참조 합니다.
사용 boolean 채널을 사용할 수 있는지 여부를 확인 합니다. 채널에 대 한 로깅을 허용 하려면 true 로 설정 합니다. 그렇지 않으면 false입니다. 기본값은 false (로깅 사용 안 함)입니다.
디버그 및 분석 채널 형식은 고용량 채널 이므로 해당 채널에 기록 하는 구성 요소의 문제를 조사할 때만 채널을 사용 하도록 설정 해야 합니다. 그렇지 않으면 채널을 사용 하지 않도록 설정 된 상태로 유지 해야 합니다.
디버그 및 분석 채널을 사용 하도록 설정할 때마다 서비스는 채널에서 이벤트를 지웁니다.
격리 문자열 격리 값은 채널에 대 한 기본 액세스 권한을 정의 합니다. 다음 값 중 하나를 지정할 수 있습니다.
  • 애플리케이션
  • System
  • 사용자 지정
기본 격리는 응용 프로그램입니다. 응용 프로그램 에 대 한 기본 권한은 (SDDL을 사용 하 여 표시 됨):
텍스트
            L"O:BAG:SYD:"
            L"(A;;0xf0007;;;SY)"                // local system               (read, write, clear)
            L"(A;;0x7;;;BA)"                    // built-in admins            (read, write, clear)
            L"(A;;0x7;;;SO)"                    // server operators           (read, write, clear)
            L"(A;;0x3;;;IU)"                    // INTERACTIVE LOGON          (read, write)
            L"(A;;0x3;;;SU)"                    // SERVICES LOGON             (read, write)
            L"(A;;0x3;;;S-1-5-3)"               // BATCH LOGON                (read, write)
            L"(A;;0x3;;;S-1-5-33)"              // write restricted service   (read, write)
            L"(A;;0x1;;;S-1-5-32-573)";         // event log readers          (read) 

시스템 에 대 한 기본 권한은 (SDDL을 사용 하 여 표시 됨):

텍스트
            L"O:BAG:SYD:"
            L"(A;;0xf0007;;;SY)"                // local system             (read, write, clear)
            L"(A;;0x7;;;BA)"                    // built-in admins          (read, write, clear)
            L"(A;;0x3;;;BO)"                    // backup operators         (read, write)
            L"(A;;0x5;;;SO)"                    // server operators         (read, clear) 
            L"(A;;0x1;;;IU)"                    // INTERACTIVE LOGON        (read)
            L"(A;;0x3;;;SU)"                    // SERVICES LOGON           (read, write)
            L"(A;;0x1;;;S-1-5-3)"               // BATCH LOGON              (read)
            L"(A;;0x2;;;S-1-5-33)"              // write restricted service (write)
            L"(A;;0x1;;;S-1-5-32-573)";         // event log readers        (read)

사용자 지정 격리에 대 한 기본 권한은 응용 프로그램과 동일 합니다.

응용 프로그램 격리를 지정 하는 채널은 동일한 ETW 세션을 사용 합니다. 시스템 격리의 경우에도 마찬가지입니다. 그러나 사용자 지정 격리를 지정 하는 경우 서비스는 채널에 대 한 별도의 ETW 세션을 만듭니다. 사용자 지정 격리를 사용 하면 채널 및 백업 파일에 대 한 액세스 권한을 제어할 수 있습니다. 64 ETW 세션만 사용할 수 있으므로 사용자 지정 격리 사용을 제한 해야 합니다.

message 문자열

채널의 지역화 된 표시 이름입니다. 메시지 문자열은 매니페스트의 Stringtable 섹션에서 지역화 된 문자열을 참조 합니다.

name anyURI

채널 이름입니다. 이 이름은 공급자가 사용 하는 채널 목록 내에서 고유 해야 합니다. 채널 이름을 지정 하는 규칙은 공급자의 이름에 채널 형식을 추가 하는 것입니다. 예를 들어 모바일 서비스는 스크립트 실행 간에 상태를 유지하지 않으므로 스크립트 실행 간에 지속되어야 하는 모든 데이터를 테이블에 저장해야 합니다. 공급자 이름이 회사 제품 구성 요소이 고 운영 채널을 정의 하는 경우에는 이름이 회사 제품-구성 요소/작동입니다.

채널 이름은 255 자이 하 여야 하며 다음 문자를 포함할 수 없습니다. ' > ', '<', '&', '"', '|', '\', ':', '`', '?', '*', or characters with codes less than 31.

기호 C기호 형식

응용 프로그램에서 채널을 참조 하는 데 사용 하는 기호입니다. 메시지 컴파일러 (MC.exe) 는 기호를 사용 하 여 컴파일러가 생성 하는 헤더 파일의 채널에 대 한 상수를 만듭니다. 기호를 지정 하지 않으면 컴파일러에서 이름이 생성 됩니다.

형식 문자열

채널의 형식을 식별 합니다. 다음 형식 중 하나를 지정할 수 있습니다.

  • 관리자
  • 작동
  • Analytic
  • 디버그

관리 유형 채널은 최종 사용자, 관리자 및 지원 담당자를 대상으로 하는 이벤트를 지원 합니다. 관리자 채널에 기록 된 이벤트에는 관리자가 작업할 수 있는 잘 정의 된 솔루션이 있어야 합니다. 관리 이벤트의 예로는 응용 프로그램이 프린터에 연결 하지 못할 때 발생 하는 이벤트가 있습니다. 이러한 이벤트는 문제를 해결 하기 위해 수행 해야 하는 작업에 대 한 정보를 직접 설명 하는 정보를 제공 하는 것이 좋습니다.

작업 유형 채널은 문제 또는 발생을 분석 하 고 진단 하는 데 사용 되는 이벤트를 지원 합니다. 이러한 이벤트를 사용하여 문제 또는 항목에 따라 도구 또는 작업을 트리거할 수 있습니다. 운영 이벤트의 예로는 시스템에서 프린터가 추가되거나 제거될 때 발생하는 이벤트가 있습니다.

분석 유형 채널은 대량으로 게시 된 이벤트를 지원 합니다. 이러한 이벤트는 프로그램 작업을 설명하고, 사용자가 개입하여 처리할 수 없는 문제를 나타냅니다.

디버그 형식 채널은 개발자만 디버깅 문제를 진단 하는 데 사용 하는 이벤트를 지원 합니다.

분석 및 디버그 채널은 기본적으로 사용 하지 않도록 설정 되어 있으므로 문제의 원인을 확인 하는 데만 사용 해야 합니다. 예를 들어 채널을 사용 하도록 설정 하 고, 문제를 일으키는 시나리오를 실행 하 고, 채널을 사용 하지 않도록 설정한 다음 이벤트를 쿼리 합니다. 채널을 사용 하도록 설정 하면 기존 이벤트의 채널이 지워집니다. 분석 및 디버그 채널에서 순환 지원 파일을 사용 하는 경우 해당 이벤트를 쿼리하려면 채널을 사용 하지 않도록 설정 해야 합니다.

모든 관리 채널은 동일한 ETW 세션을 사용 합니다. 운영 채널의 경우에도 마찬가지입니다. 그러나 각 분석 및 디버그 채널은 별도의 ETW 세션을 사용 합니다 .이는 필요한 경우에만 이러한 채널 유형을 사용 하도록 설정 하는 것입니다 (사용 가능한 ETW 세션 수는 제한 됨).

UInt8Type

공급자가 정의 하는 채널 목록 내에서 채널을 고유 하 게 식별 하는 숫자 식별자입니다. 지정 하지 않으면 메시지 컴파일러에서 값을 할당 합니다.

설명

채널 이름이 채널 명명 규칙을 따르는 경우 Windows 이벤트 뷰어는 백슬래시 뒤에 오는 문자열을 사용 하 여 채널을 나열 합니다. 예를 들어 채널 이름이 회사 제품-구성 요소/작동 인 경우 이벤트 뷰어는 회사 제품 구성 요소 공급자에서 작동 하는 채널을 나열 합니다. 그렇지 않으면 전체 채널 이름이 공급자 아래에 표시 됩니다. 제공 된 경우 지역화 된 표시 이름이 사용 됩니다.

요구 사항

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

`