Integração com painéis do Azure

Concluído

A funcionalidade de integração de itens de trabalho permite criar facilmente itens de trabalho no Azure DevOps com dados relevantes do Application Insights incorporados neles.

Configurar essa associação e criar itens de trabalho é simples (esse processo deve levar apenas um ou dois minutos).

Configurando a integração de itens de trabalho

Para configurar a integração de item de trabalho para um recurso do Application Insights, navegue até a folha de configurações desse recurso.

Você notará que um novo item na seção "Configurar" da folha de configurações diz: "Itens de trabalho".

Screenshot of the configure work items in Azure.

Clique nele e a folha de configuração para itens de trabalho será aberta.

Tudo o que você precisa fazer é preencher as informações sobre o sistema Azure DevOps ao qual você deseja se conectar, juntamente com o projeto onde deseja escrever seus itens de trabalho:

Screenshot of the configuration blade in Azure.

Depois que essas informações estiverem em vigor, você poderá clicar no botão Autorização, para onde será redirecionado para autorizar o acesso em seu sistema de DevOps do Azure selecionado para que os itens de trabalho possam ser gravados lá:

Screenshot of the authorize application.

Depois de concluir o processo de autorização, você pode definir padrões para "caminho da área" e "atribuído a".

Apenas um caminho de área é necessário (se você não configurou caminhos de área específicos em seu projeto, tudo bem. Use o nome do projeto, pois é o caminho da área de nível superior.

Clique em OK e supondo que você inseriu tudo corretamente; você verá uma mensagem informando "Validação bem-sucedida" e a folha será fechada. Agora você está pronto para começar a criar itens de trabalho!

Criando itens de trabalho

Criar itens de trabalho a partir do Application Insights é fácil.

Atualmente, há dois locais onde você pode criar itens de trabalho: deteção proativa e instâncias individuais de atividade (ou seja, exceções, falhas, solicitações e assim por diante.). Vou mostrar-lhe um exemplo simples, mas a funcionalidade é idêntica.

Neste exemplo, estamos examinando um aplicativo Web de teste que publicamos no Azure. Começamos a detalhar a atividade para este aplicativo olhando para a folha Falhas (mas também poderíamos chegar a essas mesmas informações através do botão Pesquisar ou do Metrics Explorer):

Screenshot of the failures blade in Azure.

Podemos ver que tenho várias exceções que dispararam quando o usuário clicou na guia Home/About neste aplicativo web. Se eu detalhar esse grupo de exceções, posso ver a lista e, em seguida, escolher uma exceção individual:

Screenshot of the drill into exceptions.

Olhando para a folha detalhada para essa exceção, vemos que agora há dois botões na parte superior que leem "Novo Item de Trabalho" e "Exibir Itens de Trabalho".

Para criar um item de trabalho, clico no primeiro desses botões e ele abre a folha do novo item de trabalho:

Screenshot of the detail blade in Azure.

Como você pode ver, quase tudo o que você precisa em seu cenário médio foi preenchido para você.

Os valores padrão para "caminho da área" e "atribuído a" que você escolheu na configuração inicial são definidos, e todas as informações detalhadas que temos disponíveis para essa exceção foram adicionadas ao campo de detalhes.

Você pode substituir o título e o caminho da área e atribuí-los aos campos nesta folha ou adicioná-los aos detalhes capturados.

Quando estiver pronto para criar seu item de trabalho, clique no botão "OK" e seu item de trabalho será gravado no Azure DevOps.

Exibindo itens de trabalho

Depois de criar mais itens de trabalho no Application Insights, você pode visualizá-los rapidamente no Azure DevOps.

A folha detalhada para o evento associado ao(s) item(ns) de trabalho habilitará o botão "Exibir Itens de Trabalho" se você estiver no portal do Azure. Para ver a lista, clique no botão:

Screenshot of the view work items in Azure.

Se você clicar no link para o item de trabalho que deseja exibir, ele será aberto no Azure DevOps:

Screenshot of the work item in Azure DevOps.

Configuração Avançada

Alguns de vocês devem ter notado que há um interruptor na folha de configuração que está rotulado como "Configuração Avançada".

Fornecemos outra funcionalidade para ajudá-lo a configurar sua capacidade de gravar no Azure DevOps em cenários em que você alterou ou estendeu algumas configurações prontas para uso.

Um excelente exemplo disso é a escolha de campos mais obrigatórios. Não há como lidar com esse outro mapeamento necessário na configuração padrão, mas você pode manipulá-lo no modo avançado.

Se você clicar no interruptor, os controles na parte inferior da lâmina mudarão para ter esta aparência:

Screenshot of the advanced configuration.

Agora você pode ver que agora recebe uma caixa de edição baseada em JSON onde pode especificar todas as configurações/mapeamentos necessários para modificar seu projeto do Azure DevOps.

Próximos passos

Achamos que é um excelente começo para integrar a funcionalidade do item de trabalho com o Application Insights.

Mas lembre-se que é essencialmente a versão 1.0 deste conjunto de recursos.

Temos muito trabalho planeado e vamos ver uma evolução significativa neste espaço ao longo dos próximos meses.

Apenas para começar, deixe-me descrever algumas das coisas que já planejamos ou estamos investigando:

  • Suporte para todos os tipos de item de trabalho – Você provavelmente notou que o conjunto de recursos atual bloqueia o tipo de item de trabalho para apenas "bug". Os bugs de registro foram nosso principal pedido para este espaço, então foi onde começamos, mas certamente não achamos que é onde as coisas devem acabar. Uma das alterações mais de curto prazo que você verá é lidar com todos os tipos de item de trabalho para todos os processos com suporte no Azure DevOps.
  • Links de volta para o Application Insights – É ótimo criar um item de trabalho com dados do App Insights, mas o que acontece quando você está em seu sistema ALM/DevOps e olhando para esse item e deseja navegar rapidamente de volta para a origem do item de trabalho no App Insights? Planejamos adicionar rapidamente links aos itens de trabalho para tornar isso o mais rápido e fácil possível.
  • Configuração mais flexível – Nossa configuração padrão lida apenas com cenários em que os usuários não modificaram/estenderam seu projeto no Azure DevOps. Hoje, se você tiver feito essas alterações, deverá alternar para o modo de configuração avançada. No futuro, queremos lidar com coisas do dia a dia que as pessoas podem mudar (por exemplo, tornar mais campos necessários ou adicionar novos campos) na configuração padrão sempre que possível. Ele requer algumas atualizações de nossos amigos na equipe de DevOps do Azure, mas eles já estão trabalhando em algumas delas para nós. Assim que estiverem disponíveis, tornaremos a configuração padrão mais flexível. Enquanto isso (e no futuro), você sempre pode usar a configuração avançada para superar limitações.
  • Vários perfis – Configurar uma única configuração significa que, em lojas onde há várias maneiras pelas quais os usuários normalmente criam itens de trabalho, as pessoas que criam itens de trabalho do Application Insights teriam que substituir valores com frequência. Planejamos permitir que os usuários configurem perfis 1:n, com valores comuns especificados para cada um, para que, quando você quiser criar um item de trabalho com esse perfil, possa escolhê-lo em uma lista suspensa.
  • Mais fontes de criação para itens de trabalho – Continuaremos a investigar (e receber feedback sobre) outros locais no Application Insights onde faz sentido criar itens de trabalho.
  • Criação automática de itens de trabalho – Podemos imaginar cenários em que podemos querer que um item de trabalho seja criado para nós com base em critérios. Está no radar, mas estamos gastando algum tempo de design para limitar as possibilidades de criação de itens de trabalho superbarulhentos ou descontrolados. Acreditamos que este é um recurso poderoso e conveniente, mas queremos reduzir ao máximo o potencial de spam do sistema ALM/DevOps.
  • Suporte para outros sistemas ALM/DevOps – Achamos que o Azure DevOps é um excelente produto, mas reconhecemos que muitos de nossos usuários podem usar algum outro produto para seu ALM/DevOps, e queremos conhecer as pessoas onde elas estão. Por isso, estamos trabalhando em diferentes integrações de primeiro nível de produtos populares de ALM/DevOps. Também planejamos fornecer uma opção de configuração personalizada pura (como configuração avançada para Azure DevOps) para que os usuários finais conectem o Application Insights a praticamente qualquer sistema ALM/DevOps.