# Solução de problemas

Diagnosticar e resolver problemas comuns encontrados durante a conversão e implementação. Cada problema segue o padrão de Causa possível / Ação proposta.

* [Assistente e problemas de inicialização](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/troubleshooting/wizard-and-startup-issues.htm) — Resolver falhas de componentes da UI e conflitos de porta.
* [Problemas do QlikView Desktop](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/troubleshooting/qlikview-desktop-issues.htm) — Resolver conflitos de instância do QlikView e tempos limite na geração de PRJ.
* [Problemas de conexão do Qlik Cloud](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/troubleshooting/qlik-cloud-connection-issues.htm) — Resolver falhas de autenticação, problemas de chave de API, configurações incorretas de função e conflitos de contexto.
* [Problemas de compilação e implementação](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/troubleshooting/build-and-deployment-issues.htm) — Resolva erros de compilação da nuvem e falhas de upload de mídia.
* [Problemas de saída da conversão](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/troubleshooting/conversion-output-issues.htm) — Resolva objetos de espaço reservado, falhas em lote, dimensões ou medidas inesperadas e diferenças de fonte.

## Qual log verificar primeiro

QV2QS grava em dois logs separados. O log do sistema em `%LOCALAPPDATA%\QV2QS\qv2qs.log` é sempre gravado, a partir do momento em que o processo é iniciado. O log por execução no diretório de saída só é criado depois que os argumentos de linha de comando são analisados e a pasta de saída é inicializada.

* Se o processo travar ou sair antes de produzir a saída, verifique o log do sistema. O log por execução ainda não existe.
* Se a conversão executa, mas produz resultados inesperados, verifique o log de cada execução na `logs/` subpasta do diretório de saída.
* Se uma execução em lote mostra arquivos com falha sem detalhes de erro, verifique o log do sistema para erros de nível de lote, como falta do QlikView Desktop ou falhas de pré-requisito.

Para um guia completo sobre locais de log, formato e a sobreposição entre os dois logs, consulte [Registro em log e diagnósticos](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/command-line-interface/logging-and-diagnostics.htm).

## Habilitando o registro de diagnóstico

Execute a conversão com `--logLevel DEBUG` para registrar decisões de conversão, chamadas da API da nuvem, etapas de descoberta do mecanismo e detalhes do processamento de objetos. As entradas de nível de depuração aparecem tanto no log do sistema quanto no log por execução (quando disponível).

## Saiba mais

* [Registro e diagnóstico](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/command-line-interface/logging-and-diagnostics.htm)
* [Iniciando](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/getting-started/index.htm)
* [Implantando no Qlik Cloud](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/deploying-to-qlik-cloud/index.htm)
* [Limitações conhecidas](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/known-limitations/index.htm)