Documentação em beta. Alguns textos e imagens serão retrabalhados à medida que o aplicativo se adapta à versão 1.0. Se uma seção estiver obsoleta, sinalize-a através do formulário de comentários.

Diagnóstico

A página Diagnóstico é para quando algo está errado e você quer saber o quê. Ele mostra as métricas do tempo de execução e um log de eventos contínuos e exporta o artefato único — o pacote de suporte — que solicitaremos se você abrir um ticket.

Diagnostics page. Metrics grid at the top, session event log below, support-bundle export in the header bar.
Figure 1. Diagnostics page. Metrics grid at the top, session event log below, support-bundle export in the header bar.

Grade de métricas

Quatro cartões compactos resumem o quanto o tempo de execução está funcionando. Os valores são ativos, atualizados duas vezes por segundo.

  • Taxa de malha de controle — alvo 50 Hz; se chegar aos 40, algo está roubando a CPU ou o sim está pausado. A barra lateral do cartão mostra os últimos 60 segundos como um minigráfico.
  • Latência do pipeline — tempo desde a chegada do SimSnapshot até forçar o envio, em microssegundos. Valor típico: 100–800 µs.
  • Efeitos ativos — quantos dos catorze efeitos estão actualmente a contribuir com resultados diferentes de zero.
  • Reafirmações — quantas vezes o despachante teve que reenviar parâmetros de efeito para o dispositivo. No MSFS no Proton, o kernel às vezes perde efeitos após aproximadamente 20 s; o loop de reafirmação cobre isso e você verá esse contador aumentar durante o vôo.
Metrics grid close-up. Each card has a headline value, a 60 s sparkline, and a short caption.
Figure 2. Metrics grid close-up. Each card has a headline value, a 60 s sparkline, and a short caption.

Log de eventos da sessão

A maior parte da página é um log de eventos contínuo. Os níveis são codificados por cores:

  • INF / DBG - texto normal.
  • WRN – âmbar. Geralmente benigno, mas vale a pena conhecer.
  • ERRO / FTL - vermelho. Algo falhou.

O log é apoiado por um buffer de anel na memória (cerca de 2.000 linhas). Role para cima para ver eventos mais antigos; a linha mais recente permanece fixada na parte inferior, a menos que você role manualmente.

Event log strip. Warnings in amber, errors in red. The Copy-all button dumps the current visible window to the clipboard as plain text.
Figure 3. Event log strip. Warnings in amber, errors in red. The Copy-all button dumps the current visible window to the clipboard as plain text.

Filtragem

The filter bar at the top of the log takes a plain text match. Type WRN to only see warnings and errors; simconnect to see SimConnect-related chatter; any substring at all. Clear the filter to see everything again.

Exportação de pacote de suporte

O Exportar pacote de suporte O botão - canto superior direito do cabeçalho Diagnóstico - produz um único ZIP contendo tudo o que nos permite reproduzir seu problema sem acesso à sua máquina. O que há nele:

  • sysinfo.txt — OS, kernel, distro, CPU model, RAM, .NET runtime version, locale.
  • session.log — the current session's complete event log (not just what's on screen).
  • crashes/ — the last crash dump plus the stack trace, if there is one.
  • doctor.json — the most recent Doctor-page scan results in machine-readable form.
  • tunables.yaml — the active profile's values at the moment of export.
  • simconnect-config.xml — the XML the bridge last read from MSFS, with any passwords removed. Not included for X-Plane sessions.

O pacote configurável é gravado em um caminho temporário e, em seguida, a página Diagnóstico mostra um link clicável e um Revelar no gerenciador de arquivos botão. Anexe o ZIP a um relatório de comentários e iremos buscá-lo quando fizermos a triagem.

After export, a small banner shows the bundle filename, size, and a button to open the feedback form. The support bundle never leaves your machine automatically — you choose to send it.
Figure 4. After export, a small banner shows the bundle filename, size, and a button to open the feedback form. The support bundle never leaves your machine automatically — you choose to send it.
O que NÃO contém

Sem identificadores pessoais, sem credenciais de nuvem, sem captura de tráfego de rede. A lista completa de nomes de arquivos permitidos que o pacote pode incluir vidas na fonte; qualquer coisa fora dessa lista é omitida. Veja Pacotes de suporte para a lista completa.

Exportação da área de transferência

Se você quiser apenas citar uma única linha de log (“bridge diz X, isso é normal?”), clique com o botão direito na linha e escolha Copiar. For longer quotes, Copiar tudo na parte superior do log despeja a janela visível como texto UTF-8 simples.