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.

Pacotes de suporte

Um pacote de suporte é um único ZIP que empacota o estado da ponte no momento em que algo deu errado. É o único artefato que solicitaremos ao fazer a triagem de um ticket. Esta página descreve exatamente o que há em um, para que você saiba o que está enviando.

Como exportar um

  1. Abra o FFB-Bridge e navegue até Diagnóstico.
  2. Clique Exportar pacote de suporte (canto superior direito).
  3. Após um breve atraso, um banner mostra o nome e o tamanho do arquivo, com Revelar e Abrir formulário de feedback botões.
  4. Clique Abrir formulário de feedback — a página de feedback é aberta com seu pacote pré-anexado.
Página FFB-Bridge Diagnostics após exportar um pacote de suporte, mostrando o banner de resultado com ações Revelar e Abrir formulário de feedback
Figure 1. Fluxo de exportação: botão da página de diagnóstico, depois o banner com o nome do arquivo e as ações Revelar/Abrir formulário de feedback.

O que há no pacote

Um pacote é um ZIP simples. Os nomes de arquivos abaixo são a lista completa de permissões - o pacote será nunca contém qualquer coisa fora deste conjunto.

sysinfo.txt

Metadados do sistema. Texto simples, linhas chave:valor. Campos:

  • os — “janelas” ou “linux”.
  • os-version — versão do kernel ou string de compilação do Windows.
  • distro — on Linux, /etc/os-release PRETTY_NAME.
  • cpu-model, cpu-cores — from /proc/cpuinfo ou Win32_Processor.
  • ram-total-mb — from /proc/meminfo ou Win32_ComputerSystem.
  • dotnet-version — versão de tempo de execução do pacote .NET.
  • platform — chave explícita para a ramificação Linux vs Windows.
  • locale — localidade do usuário atual.
  • bridge-version, build-hash — versão bridge e git SHA em tempo de construção.

sessão.log

Log de eventos completo da sessão atual. O mesmo conteúdo da faixa de log da página Diagnóstico, mas incluindo tudo desde o lançamento, não apenas o que está visível. UTF-8.

last-crash.log

Se a inicialização anterior travou, o log de travamento chega aqui. Rastreamento de pilha, dumps de thread, as últimas linhas de log antes da falha. Ausente se a sessão não travou.

médico.json

Digitalização mais recente da página do médico em formato legível por máquina. Cada linha carrega o nome da verificação, o status (aprovado/aviso/falha/n/a) e a sequência de detalhes brutos. Isso nos permite ver o estado do seu médico sem que você precise colar capturas de tela.

sintonizáveis.yaml

Os valores do perfil de ajuste ativo no momento da exportação. Mesmo esquema de um perfil salvo. Usado para reproduzir a configuração exata da força que você estava voando.

simconnect-config.xml

MSFS's SimConnect.xml se a ponte pudesse ler um, com qualquer <Password> entradas removidas. Ausente se você estivesse no X-Plane ou Mock no momento da exportação.

O que NÃO está no pacote

O construtor do pacote de suporte usa uma lista restrita de nomes de arquivos. Não incluirá nada fora dessa lista, mesmo que algo correspondente esteja presente no mesmo diretório. Em particular:

  • Nenhuma senha ou credencial salva. A ponte não armazena nenhum.
  • Nenhum arquivo de perfil além de o ativo.
  • Nenhum registro do sistema, diário ou qualquer coisa fora dos diretórios de dados da própria ponte.
  • Nenhuma captura de pacotes de rede.
  • Sem tokens de nuvem (a ponte não usa nenhum).

Processamento do lado do servidor

Quando você anexa um pacote a um relatório de feedback, o responsável pelo registro do site o analisa para extrair dados indexáveis úteis em nosso banco de dados:

  • Informações do sistema em uma linha de resumo para agrupamento (“quantos relatórios desta distribuição?”).
  • Linhas de aviso e erro do log, com assinaturas de erro estáveis, para que possamos ver rapidamente quantas pessoas encontraram o mesmo bug.
  • Os resultados da verificação médica são detalhados sobre o que está falhando na base de usuários.
  • O texto literal do arquivo de cada entrada na lista de permissões, armazenado para que possamos reler o contexto durante a triagem.

O pacote bruto em si é retido por um curto período (30 dias por padrão) para que possamos analisar novamente se nossa lógica de extração melhorar. Depois disso, os dados analisados ​​são mantidos; a bolha bruta é descartada.

Limites

LimiteValor
Tamanho total do pacote50 MB compactados
Tamanho não compactado por entrada5MB
Máximo de entradas30
Total descompactado20MB
CodificaçãoSomente arquivos de texto UTF-8 (mais o XML)

Na prática, um pacote normal tem menos de um megabyte. Esses limites existem para descartar uploads hostis, não para descartar relatórios reais.

Enviando sem o formulário de feedback

Se você preferir enviar o pacote por e-mail diretamente, escreva para feedback·ffb-bridge.com (substitua · por @) e anexe o ZIP. O analisador do lado do servidor não é executado para e-mail, portanto a triagem é mais lenta, mas o pacote é igualmente utilizável.