프로필
문제 범주 및 수집기 요소의 컬렉션을 나타냅니다.
요소 계층 구조
-
<
WindowsPerformanceRecorder>
-
<
Profiles>
- < Profile>
-
<
Profiles>
구문
<Profile Id = IdType
Name = string
Description = string
Base = string
LoggingMode = "File" | "Memory"
DetailLevel = "Verbose" | "Light"
Strict = boolean
Internal = boolean
Default = boolean>
<!-- Child elements -->
ProblemCategories,
Collectors
</Profile>
특성 및 요소
특성
attribute | Description | 데이터 형식 | 필수 | 기본값 |
---|---|---|---|---|
ID | 프로필을 고유하게 식별합니다. | 하나 이상의 문자를 포함해야 하며 콜론이나 공백을 포함할 수 없는 문자열입니다. | Yes | |
이름 | 프로필 이름을 나타냅니다. | 문자열 | 예 | |
설명 | 프로필에 대한 설명을 나타냅니다. | 문자열 | Yes | |
Base | 프로필의 기본을 나타냅니다. | 문자열 | 예 | |
LoggingMode | WPR이 메모리에 쓸지 아니면 순차 파일에 쓸지 여부를 나타냅니다. | 이 특성 값은 다음 중 하나일 수 있습니다.
|
예 | 파일 |
DetailLevel | 프로필 정의를 타이밍 추적(Light )에 사용할지 아니면 분석 추적(Verbose )에 사용할지 여부를 지정합니다. |
이 특성 값은 다음 중 하나일 수 있습니다.
|
Yes | 자세히 |
Strict | 공급자 또는 수집기의 오류로 인해 시작 작업이 실패하는지 여부를 나타냅니다. 이 특성을 false 로 설정하면 일부 수집기 또는 공급자가 실패하더라도 시작 작업이 성공합니다. 작업을 계속하려면 하나 이상의 수집기 및 하나의 공급자가 성공해야 합니다. 이 특성을 true 로 설정하면 시작하지 못한 공급자 또는 수집기에 대한 정보가 오류 대신 경고로 제공됩니다. |
boolean | 예 | false |
내부 | 프로필이 내부인지 여부를 나타냅니다. | boolean | 예 | false |
기본값 | 프로필이 기본값 프로필인지 여부를 나타냅니다. | boolean | 예 | false |
자식 요소
요소 | Description | 요구 사항 |
---|---|---|
ProblemCategories | 문제 범주의 컬렉션을 나타냅니다. | 필수, 정확히 1입니다. |
수집기 | 프로필에 대한 수집기 컬렉션을 나타냅니다. | 필수, 정확히 1입니다. |
TraceMergeProperties | 추적 병합 속성의 컬렉션을 나타냅니다. | 선택 사항, 정확히 1입니다. |
부모 요소
요소 | Description |
---|---|
프로필 | 수집기, 공급자 및 프로필의 컬렉션을 나타냅니다. |
설명
각 .wprp 파일에는 일반적으로 각 로깅 모드에 대해 하나씩 두 개 이상의 프로필 정의가 포함되어 있습니다. 단, 켜기/끄기 전환 프로필을 파일에만 기록할 수 있으므로 해당 프로필의 .wprp 파일에는 프로필 정의가 하나만 포함될 수 있습니다. 각 .wprp 파일에는 로깅 모드와 세부 정보 수준의 각 조합에 대해 하나씩 최대 4개의 프로필이 포함될 수 있습니다. 단일 .wprp 파일의 모든 프로필에는 Name 특성에 대해 동일한 값이 있어야 합니다.
다음 예제와 같이 Name, DetailLevel 및 LoggingMode 특성 값을 마침표로 구분하여 Id특성 값을 생성합니다.
파생 프로필에는 기본적으로 기본 프로필의 모든 특성이 있습니다. 이러한 특성은 파생 프로필에 명시적으로 지정하여 재정의할 수 있습니다. 자세한 내용은 상속을 참조하세요.
예제
다음 코드 예제는 프로필 정의를 보여 줍니다.
<Profile
Id="Example.Light.File"
Name="Example"
DetailLevel="Light"
LoggingMode="File"
Description="Example profile">
<ProblemCategories>
<ProblemCategory
Value="First Level Triage"/>
</ProblemCategories>
<Collectors>
<SystemCollectorId
Value="WPRSystemCollector">
<SystemProviderId
Value="system-provider"/>
</SystemCollectorId>
<EventCollectorId
Value="WPREventCollector">
<EventProviders>
<EventProviderId
Value="Win32K-provider"/>
<EventProviderId
Value="Search-Core-provider"/>
</EventProviders>
</EventCollectorId>
</Collectors>
</Profile>
수집기 및 공급자는 프로필 정의 내에 정의할 수도 있습니다.