> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 디버그 추적

> PlayFab Services SDK 디버그 추적을 활성화합니다: 자세한 정도 설정, Visual Studio 디버거로 출력 라우팅, 게임 로그로 전달 또는 추적을 파일에 기록.

이 PlayFab SDK는 확장 가능한 디버그 추적을 지원합니다. 오류가 발생하고 게임이 수행하는 호출과 서버가 반환하는 결과에 대한 전체 그림을 확인하고 싶을 때 디버그 추적을 사용하세요. 추적의 자세한 정도를 제어하고 게임의 자체 디버그 로그와 통합하는 옵션이 있습니다. 또한 Visual Studio의 출력 창으로 출력을 전달할 수도 있습니다.

## 활성화 및 자세한 정도 설정

다음 코드 예제는 디버그 추적을 활성화하고 디버그 오류 수준을 **Verbose**로 설정합니다. 실패한 호출만 추적하려면 디버그 오류 수준을 **Error**로 설정하거나, 추적을 사용하지 않으려면 **Off**로 설정할 수도 있습니다.)

결과 디버그 출력은 Visual Studio에서 프로젝트를 실행할 때 출력 창으로 전송됩니다.

```cpp theme={null}
HCSettingsSetTraceLevel(HCTraceLevel::Verbose);
HCTraceSetTraceToDebugger(true);
```

## 게임 로그에 연결

PlayFab의 추적 디버깅을 게임의 자체 디버그 로그에 연결하려면 **HCTraceSetClientCallback**을 사용하세요. PlayFab 추적 출력을 받아 게임 로그로 전달할 수 있는 콜백을 제공합니다.

```cpp theme={null}
void CALLBACK TraceCallback(
    _In_z_ char const* areaName,
    enum HCTraceLevel level,
    uint64_t threadId,
    uint64_t timestamp,
    _In_z_ char const* message
)
{
    // Log info
}

HCTraceSetClientCallback(TraceCallback);
```

## 추적을 파일에 기록

PlayFab 추적 출력을 디스크의 로그 파일에 기록하려면 추적 파일을 만들 디렉터리와 함께 [**PFTraceEnableTraceToFile**](/services/playfab/api-references/c/pftrace/functions/pftraceenabletracetofile)을 호출하세요. 초기화 후 이 함수를 호출합니다.

```cpp theme={null}
PFTraceEnableTraceToFile("C:\\GameLogs\\PlayFabTraces");
```

이 함수는 위의 HCTrace 함수와 독립적입니다. 디버거 출력 및 클라이언트 콜백과 함께 파일 추적을 사용할 수 있습니다.

## 참조

[PlayFab API 참조 설명서](/services/playfab/api-references/c/pftrace/pftrace_members)
[Trace API 참조 설명서](/reference/live/httpclient/trace/trace_members)


## Related topics

- [PlayFab Unified SDK에서 디버그 추적](/ko/services/playfab/sdks/unified-sdk/debug-trace.md)
- [Game Saves 빠른 시작](/ko/services/playfab/player-progression/game-saves/quickstart.md)
- [빠른 시작 Android](/ko/services/playfab/sdks/c/quickstart-android.md)
- [빠른 시작 GDK](/ko/services/playfab/sdks/c/quickstart-gdk.md)
- [빠른 시작 iOS](/ko/services/playfab/sdks/c/quickstart-ios.md)