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.

Página de diagnóstico. Grade de métricas na parte superior, log de eventos da sessão abaixo, exportação de pacote de suporte na barra de cabeçalho.
Figure 1. Página de diagnóstico. Grade de métricas na parte superior, log de eventos da sessão abaixo, exportação de pacote de suporte na barra de cabeçalho.

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.
Close da grade de métricas. Cada cartão tem um valor de título, um minigráfico de 60 segundos e uma legenda curta.
Figure 2. Close da grade de métricas. Cada cartão tem um valor de título, um minigráfico de 60 segundos e uma legenda curta.

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.

Faixa de log de eventos. Avisos em âmbar, erros em vermelho. O botão Copiar tudo despeja a janela visível atual na área de transferência como texto simples.
Figure 3. Faixa de log de eventos. Avisos em âmbar, erros em vermelho. O botão Copiar tudo despeja a janela visível atual na área de transferência como texto simples.

Filtragem

A barra de filtro na parte superior do log corresponde a um texto simples. Tipo WRN ver apenas avisos e erros; simconnect para ver conversas relacionadas ao SimConnect; qualquer substring. Limpe o filtro para ver tudo novamente.

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 — SO, kernel, distribuição, modelo de CPU, RAM, versão de tempo de execução do .NET, localidade.
  • session.log — o log de eventos completo da sessão atual (não apenas o que está na tela).
  • crashes/ — o último despejo de memória mais o rastreamento de pilha, se houver.
  • doctor.json - os resultados mais recentes da verificação da página médica em formato legível por máquina.
  • tunables.yaml — os valores do perfil ativo no momento da exportação.
  • simconnect-config.xml — o XML da última leitura da ponte no MSFS, com todas as senhas removidas. Não incluído nas sessões do X-Plane.

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.

Após a exportação, um pequeno banner mostra o nome do arquivo do pacote, o tamanho e um botão para abrir o formulário de feedback. O pacote de suporte nunca sai da sua máquina automaticamente – você escolhe enviá-lo.
Figure 4. Após a exportação, um pequeno banner mostra o nome do arquivo do pacote, o tamanho e um botão para abrir o formulário de feedback. O pacote de suporte nunca sai da sua máquina automaticamente – você escolhe enviá-lo.
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.