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 seguir o mais possível o padrão. 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, nenhum plug-in 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 BricsCAD no Modo Seguro, siga os passos descritos em Como iniciar BricsCAD em Modo Seguro, sem nenhuma aplicação instalada? (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 daí BricsCAD V24.2.02, 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. O local desta 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 V26 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 a partir da linha de Comando de 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 está acontecendo. 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 encerra BricsCAD também não é uma falha.

Um relatório de falha é escrito no arquivo crash_report.txt a cada vez que BricsCAD falhar. O relatório de falha é salvo na pasta de inicialização do BricsCAD. O local 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 sem que seja criado 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.

BricsCAD pode registrar cada comando executado em um arquivo de log de 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 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.