Analisar desempenho do plug-in
Publicado: janeiro de 2017
Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
O Plug-in Profiler é uma ferramenta que cria perfis para a execução de plug-ins e atividades de fluxo de trabalho personalizadas para uma experiência aprimorada de depuração no Microsoft Visual Studio. Essa ferramenta, que pode ser executada da janela de prompt de comando ou da ferramenta Plug-in Registration, facilita e agiliza o desenvolvimento do código personalizado de acordo com o Microsoft Dynamics 365 (online e local). Além disso, os usuários podem criar perfis para a execução de código falho e enviar os resultados ao desenvolvedor do código ou ao fornecedor de software independente (ISV) para análise. O desenvolvedor pode reproduzir a execução do plug-in ou da atividade de fluxo de trabalho personalizada e depurar o código remotamente, mesmo se estiver desconectado do servidor do Microsoft Dynamics 365.
A ferramenta pode ser usada na depuração ou no modo de reprodução. Cada um desses modos é descrito nas seções a seguir.
Neste tópico
Depurar um plug-in por meio do criador de perfil de plug-in
Reproduzir a execução de plug-in
Execute o criador de perfil independente de plug-in
Depurar um plug-in por meio do criador de perfil de plug-in
Executar a ferramenta Plug-in Registration. É possível localizar o arquivo executável da ferramenta na pasta Tools\PluginRegistration do SDK. Baixe o pacote do SDK do Microsoft Dynamics CRM.
Clique em CRIAR NOVA CONEXÃO para conectar-se a um servidor e organização do Microsoft Dynamics 365. Para obter mais informações sobre conectar-se a um servidor e organização, consulte o tópico do SDK: Passo a passo: Registrar um plug-in usando a ferramenta de registro de plug-in.
Registre um plug-in e uma etapa no servidor do Microsoft Dynamics 365. Mantenha uma cópia do assembly compilado de depuração do plug-in no computador em que a ferramenta está sendo executada.
Na barra de ferramentas da organização de destino, selecione Instalar criador de perfil. Agora você verá um nó de criador de perfil de plug-in na lista.
Selecione uma etapa de plug-in e clique em Iniciar criação de perfis na barra de ferramentas, para começar a criar perfis. Você pode escolher o modo como o criador de perfil executará na caixa de diálogo Configurações do criador de perfil exibida.
Execute a operação no Microsoft Dynamics 365 que faz plug-in executar. Por exemplo, se a etapa estiver configurada para a atualização de uma conta, será necessário atualizar uma conta.
Se tiver selecionado a opção de Exceção na caixa de diálogo Configurações de criador de perfil, depois que o plug-in acionar uma exceção e a caixa de diálogo Erro de processos de negócios for exibida, clique em Baixar arquivo de log e salve este arquivo. Se preferir, caso o plug-in não acione uma exceção, clique em Parar criação de perfis.
Na ferramenta Plug-in Registration, clique em Depurar.
Na caixa de diálogo Depurar um plug-in existente, forneça as informações solicitadas na guia Instalação. Acesse o local do arquivo de log salvo anteriormente no campo Perfil. Acesse ou selecione o local do assembly de plug-in e o nome da classe do plug-in que foi executado.
Inicialize Microsoft Visual Studio e anexe o depurador ao processo do PluginRegistration.exe.
Defina um ponto de interrupção no código de plug-in.
Clique em Iniciar execução na caixa de diálogo Depurar um plug-in existente.
Depois de um pequeno atraso, o plug-in executará por meio do mesmo contexto de execução que lhe foi passado pelo servidor do Microsoft Dynamics 365, e o depurador interromperá a execução no ponto de interrupção previamente definido.
Continue a depuração do plug-in como você faria normalmente. Todos os rastreamentos resultantes do plug-in são mostrados na caixa de diálogo Depurar um plug-in existente.
Neste momento, é possível alterar o código de plug-in, criá-lo, reanexar o depurador ao processo PluginRegistration.exe e clicar em Iniciar execução para continuar com a sessão de depuração. Durante a execução dessas operações, não é necessário fechar o formulário Depurar um plug-in existente.
Você não precisa reimplantar o plug-in no servidor de Microsoft Dynamics 365 enquanto não tiver solucionado o problema no código. Este cenário de depuração funciona mesmo quando você tiver uma versão otimizada do plug-in no servidor e uma versão de depuração do plug-in no computador em que estiver fazendo a depuração.
Reproduzir a execução de plug-in
Reproduzir a execução do plug-in não requer uma conexão com um servidor e organização de Microsoft Dynamics 365. A vantagem deste método é que você pode obter o perfil de execução do plug-in de um cliente e depurar o plug-in de maneira remota. Uma limitação do recurso de reprodução consiste em não poder alterar a sequência de chamadas que o código do seu plug-in faz no depurador durante a depuração.
O recurso de reprodução fornece ao plug-in um instantâneo dos dados de execução e do contexto da execução do evento, a partir do servidor do Microsoft Dynamics 365. Você está obtendo os mesmos eventos, GUIDs etc de chamadas para o serviço da organização, mas nenhum dado está sendo alterado no servidor enquanto você depura o plug-in. Durante o procedimento de depuração da seção anterior, o plug-in se conecta ao servidor e faz chamadas em tempo real.
Reproduzir a execução de plug-in
Inicialize Microsoft Visual Studio e anexe o depurador ao processo do PluginRegistration.exe.
Clique em REPRODUZIR EXECUÇÃO DO PLUG-IN.
Acesse os locais do assembly do log e plug-in na caixa de diálogo.
Clique em Iniciar execução.
Depure o plug-in como você faria normalmente.
Execute o criador de perfil independente de plug-in
O criador de perfil pode ser executado a partir de uma janela de prompt de comando independente da ferramenta Plug-in Registration. Isso é útil para obter o log do perfil de plug-in do servidor do Microsoft Dynamics 365 de um cliente, para depurar um plug-in falho. Um desenvolvedor pode usar esse log para reproduzir a execução do plug-in na ferramenta Plug-in Registration e depurar o plug-in por meio doMicrosoft Visual Studio.
Execute o criador de perfil do plug-in a partir de um prompt de comando
Abra uma janela de prompt de comando e defina o diretório de trabalho para a pasta Tools\PluginRegistration, no download do SDK.
Digite o comando: PluginProfiler.Debugger.exe /?.
Revise a lista de parâmetros suportados e reexecute o programa PluginProfiler.Debugger.exe com os parâmetros apropriados.
Confira Também
Ferramentas do desenvolvedor
Ferramentas da solução para desenvolvimento da equipe
Desenvolvimento de plug-in
Registrar e implantar plug-ins
Depurar um plug-in
Microsoft Dynamics 365
© 2017 Microsoft. Todos os direitos reservados. Direitos autorais