> ## 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.

# Rastreamento de depuração

> Habilite o rastreamento de depuração do SDK do PlayFab Services: defina o nível de detalhamento, direcione a saída para o depurador do Visual Studio, encaminhe-a para os logs do jogo ou grave os rastreamentos em arquivo.

Este SDK do PlayFab dá suporte a rastreamento de depuração extensível. Use o rastreamento de depuração quando encontrar erros e quiser ter uma visão completa das chamadas que o jogo faz e dos resultados que o servidor retorna. Há opções para controlar o nível de detalhamento do rastreamento e integrá-lo aos logs de depuração do próprio jogo. Você também pode direcionar a saída para o painel Output do Visual Studio.

## Habilitar e definir o nível de detalhamento

O exemplo de código a seguir habilita o rastreamento de depuração e define o nível de erro de depuração como **Verbose**. Você também pode definir o nível de erro de depuração como **Error** para rastrear apenas as chamadas com falha, ou como **Off** para desabilitar o rastreamento.

A saída de depuração resultante é enviada ao painel Output ao executar seu projeto no Visual Studio.

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

## Conectar aos logs do jogo

Para conectar o rastreamento de depuração do PlayFab aos logs de depuração do próprio jogo, use **HCTraceSetClientCallback**. Forneça um retorno de chamada que possa receber a saída de rastreamento do PlayFab e direcioná-la aos logs do jogo.

```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);
```

## Gravar os rastreamentos em um arquivo

Para gravar a saída de rastreamento do PlayFab em um arquivo de log no disco, chame [**PFTraceEnableTraceToFile**](/pt-BR/services/playfab/api-references/c/pftrace/functions/pftraceenabletracetofile) com o diretório em que o arquivo de rastreamento deve ser criado. Chame essa função após a inicialização.

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

Essa função é independente das funções HCTrace acima. Você pode usar o rastreamento em arquivo junto com a saída do depurador e os retornos de chamada do cliente.

## Referência

[Documentação de referência da API do PlayFab](/pt-BR/services/playfab/api-references/c/pftrace/pftrace_members)
[Documentação de referência da API Trace](/pt-BR/reference/live/httpclient/trace/trace_members)


## Related topics

- [Rastreamento de depuração no SDK unificado do PlayFab](/pt-BR/services/playfab/sdks/unified-sdk/debug-trace.md)
- [Início rápido do Game Saves](/pt-BR/services/playfab/player-progression/game-saves/quickstart.md)
- [Início rápido Android](/pt-BR/services/playfab/sdks/c/quickstart-android.md)
- [Início rápido GDK](/pt-BR/services/playfab/sdks/c/quickstart-gdk.md)
- [Início rápido iOS](/pt-BR/services/playfab/sdks/c/quickstart-ios.md)