Quais arquivos incluir ao relatar falhas?

Sintomas

Você experimentou uma falha no programa, ou o programa trava com frequência.

Causa

A maneira mais confiável de relatar uma falha é fornecer um cenário repetível. Isso significa que um procedimento passo a passo é fornecido junto com um contexto inicial bem definido. Isso pode exigir algum esforço para acertar, mas tem, de longe, as maiores chances de sucesso.

Em geral, para tornar um cenário repetível, é melhor reduzir o ambiente para ser o mais padrão possível. Este é um processo de simplificação e eliminação. Se possível, um cenário deve começar com um perfil de usuário BricsCAD® predefinido, um novo desenho, sem plug-ins de terceiros ou personalização do usuário, e um arquivo CUI predefinido.

Se não for possível fornecer um cenário repetitivo, então em alguns casos se pode deduzir informações suficientes de arquivos de diagnóstico adicionais.

Solução

Envie uma solicitação de suporte incluindo os seguintes detalhes:

  • Verifique se o problema é reproduzível no Modo de Segurança. Para executar o BricsCAD® no Modo de Segurança, siga as etapas descritas em Como iniciar o BricsCAD® no Modo de Segurança, sem nenhuma aplicação? (artigo).

    Se o problema desaparecer durante a execução no Modo Seguro, pode ser útil voltar ao Modo Normal e desativar ou desinstalar plug-ins e personalizações, para restringir a possível causa.

  • crash_report.txt
    Nota:
    • O arquivo crash_report.txt é criado no Windows e, a partir do BricsCAD® V24.2.02, também no Linux.
    • No macOS, há o arquivo bricscad-YYYY-MM-DD-xxxxxxxx.ips gerado pelo sistema operacional.
    O relatório de falha é salvo na pasta de inicialização do BricsCAD®. A localização dessa pasta depende de como você inicia o BricsCAD®:
    • Pasta HOMEPATH (no Windows, normalmente é C:\Users\%username%\)
    • Pasta do desenho
    • Program folder (C:\Program Files\Bricsys\BricsCAD V25 pt_BR)
  • Arquivo Crash dump (.dmp)

    Na maioria dos casos, uma falha do programa resulta em um arquivo de despejo de memória (.dmp), que é gerado na mesma pasta que o crash_report.txt.

    A criação de um arquivo de despejo de falhas pode ser ativada ou desativada dependendo do bit 2048 do QAFLAGS.

  • Perfil do Usuário

    As configurações atuais do perfil do usuário podem ser exportadas para um arquivo usando o Gerenciador do Perfil.

  • Arquivo de desenho

    Se uma falha for específica para um desenho, então esse desenho será útil.

  • Forneça uma descrição detalhada do fluxo de trabalho, incluindo quaisquer comandos ou ações específicos que possam estar causando o problema.
  • Anexe o retorno completo do comando _REDSDKINFO da linha de Comando do BricsCAD®.

    Este imprime um relatório na janela de comando contendo informações sobre os recursos gráficos do seu computador. Pressione F2 para abrir a janela de Histórico de Avisos.

  • Arquivo log

    Use o comando _LOGFILEON para gravar todas as solicitações do programa e todas as entradas do teclado. O arquivo está localizado na pasta especificada pela variável de sistema _LOGFILEPATH.

Nota:

A palavra crash (falha) é muitas vezes mal utilizada para outros problemas, então o analista pode fazer perguntas para definir exatamente o que acontece. Um travamento ou congelamento não é uma falha (crash), e uma operação extremamente lenta não é um travamento. Uma operação que falha com um erro, mas não fecha o BricsCAD®, também não é uma falha (crash).

Um relatório de falha (crash) é gravado no arquivo crash_report.txt cada vez que o BricsCAD® sofrer um bloqueio. O relatório de falha é salvo na pasta de inicialização do BricsCAD®. A localização desta pasta depende de como você inicia o BricsCAD®, portanto, esteja ciente de que vários arquivos podem existir em seu sistema, em pastas diferentes. Se o programa não tiver permissão para criar o arquivo na pasta de inicialização, o arquivo será criado na pasta %HOMEPATH% (em Windows, normalmente é c:\Users\[username]\). Algumas vezes o relatório de falha é gerado sem o programa ser fechado. Algumas vezes ocorre uma falha, e não é emitido um relatório de falha.

(Específico do Windows) Na maioria dos casos, uma falha de programa resulta em um arquivo crash dump (.dmp) (despejo), que é gerado na mesma pasta que o crash_report.txt. A criação de um arquivo de despejo de falhas pode ser ativada ou desativada dependendo do bit 2048 do QAFLAGS. Antes da V18.2, o despejo (dump) de travamento era criado apenas se o bit 2048 QAFLAGS estivesse definido. Em versões mais recentes, o significado do sinalizador foi invertido, e o arquivo de despejo de memória agora é criado por predefinição.

O BricsCAD® pode registrar cada comando executado em um arquivo de log texto. A geração desse arquivo 'log' é controlada pela variável de sistema LOGFILEMODE. Se LOGFILEMODE = 1, um arquivo de log é criado toda vez que um desenho é aberto. O formato do nome do arquivo é NomeDesenho_ano-mês-dia_hora-min-seg.log.

Arquivos de log do BricsCAD® são salvos na pasta especificada pela variável de sistema LOGFILEPATH. Por predefinição, esta é a pasta apontada pela variável de sistema LOCALROOTPREFIX.