🗓 Esta documentação foi revisada em agosto de 2026 para refletir as mudanças
na interface do Jira. Se, no momento da leitura, você perceber que nossas instruções
não estão mais atualizadas, por favor nos avise!
O AppSignal se conecta ao Jira usando OAuth 1.0. O Jira agora também é compatível
com OAuth 2.0, mas o AppSignal ainda não o utiliza, então a configuração abaixo usa um
link de aplicação OAuth 1.0.
O Jira é uma ferramenta usada para gerenciamento de projetos. Ela é centrada em um sistema de tickets, no qual features, chores e bugs podem ser registrados, rastreados e atribuídos.
O AppSignal pode ser integrado ao Jira para que você crie um ticket a partir da tela de detalhes de um incidente de erro. O AppSignal nunca cria tickets no Jira automaticamente, para evitar uma sobrecarga de tickets.
Esta documentação irá guiar você pelos passos necessários para integrar o AppSignal ao seu projeto no Jira.
Configurar o Jira
Antes de podermos vincular o AppSignal ao Jira, precisamos configurar o Jira para aceitar nossa requisição OAuth.
Para isso, selecione a engrenagem de configurações (⚙️) na barra de navegação e, em seguida, selecione Apps no menu de configurações. Em versões mais antigas do Jira, esse item de menu se chama Products.
Em Integrations, na navegação lateral, selecione “Application links”, depois selecione “Create link”.
O Jira abre a caixa de diálogo “Create an application link”, que pede um tipo de conexão e a URL da aplicação:
- Em Application link type, selecione “Direct application link”, a última das quatro opções, que usa OAuth 1.0. As duas primeiras opções usam OAuth 2.0, e “Tunneled application link” precisa de um túnel de aplicação já existente.
- Em External application details, digite
https://www.appsignal.com no campo Application URL.
O Jira pode mostrar o erro: “No response was received from the URL you entered”. Você pode ignorar esse erro e prosseguir selecionando “Continue”.
Em seguida, será apresentada uma tela Review Link. Você só precisa fornecer um Application name antes de continuar. Nomeie a aplicação: AppSignal, e continue.
Configuração do OAuth
Agora é hora de configurar o “Incoming Authentication” do AppSignal. Para isso, navegue até “Edit” na tela “Application links”:
Um pop-up “Configure AppSignal” será aberto. Navegue até “Incoming Authentication” no menu à esquerda.
Na aba “Incoming OAuth”, configure o OAuth com os seguintes valores:
- Consumer Key:
ce2jejafmni3qmnzrfergg9fLpzxmppl
- Consumer Name:
AppSignal
- Public Key:
Clique em “Save”.
Configurando o AppSignal
Para concluir o processo de vinculação do seu projeto Jira ao AppSignal, o AppSignal deve ser configurado para se comunicar com seu projeto Jira.
Para isso, abra sua aplicação no AppSignal. Clique em “App settings” na parte inferior do painel de navegação esquerdo e depois clique em “Integrations”:
Navegue até “Personal issue tracker integrations” e clique em “Manage” para o Jira. Como alternativa, siga este link.
Role até “Jira installation location” e digite a URL do seu projeto Jira, ex.: project-name.appsignal.net, depois clique em “link AppSignal to Jira.
Você será apresentado à seguinte tela de autenticação. Clique em: “Allow”.
Você retornará ao AppSignal. Aqui você precisa selecionar qual projeto e tipo de issue você quer usar para as issues do AppSignal. Para prosseguir, clique em: “create integration”
Se este passo produzir uma mensagem de erro, por favor leia a seção errors para mais orientação.
Criar tickets no Jira para incidentes
Depois que o Jira estiver conectado, você pode criar um ticket no Jira para um incidente de erro:
- Abra a tela de detalhes do incidente de erro.
- No painel Actions, selecione Send to Jira.
Erros
O AppSignal exige que quatro campos estejam presentes no Jira:
- Labels
- Environment
- Summary
- Description
O AppSignal mostrará uma mensagem de erro ao concluir a configuração se algum campo estiver faltando e especificará quais precisam ser adicionados no Jira.
Você precisará adicionar os campos às telas do Jira indo para a aba “Issues” no menu “Settings”:
Depois navegue até “Screens” no painel de navegação esquerdo e clique em “Configure” para a tela relevante:
Nesta página “Configure”, o Jira mostrará uma lista de campos já configurados. Role até o final da página e adicione os campos obrigatórios que estão faltando.
Depois que todos os campos forem criados, você poderá retomar e concluir a configuração da sua integração do Jira a partir do app do AppSignal.
Precisa de ajuda?
Se você seguiu os passos desta página e ainda está com dificuldade, sinta-se à vontade para entrar em contato em support@appsignal.com.
Lista de integrações