Pular para o conteúdo principal
🗓 Esta documentação foi revisada em novembro 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. Em Jira admin settings, selecione Jira apps. Em versões mais antigas do Jira, esse item de menu se chama Products.
O menu de configurações do Jira aberto pela engrenagem, com Jira apps destacado em Jira admin settings

Selecione Jira apps em Jira admin settings.

Em Integrations, na navegação lateral, selecione Application links, depois selecione Create link.
A página Application links do Jira em Integrations, listando os links existentes, com o botão Create link no canto superior direito

A página Application links, com o botão 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:
  1. 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.
  2. Em External application details, digite https://www.appsignal.com no campo Application URL.
  3. Selecione Continue.
A caixa de diálogo Create an application link do Jira com Direct application link selecionado e https://www.appsignal.com no campo Application URL

Selecione Direct application link e digite a URL do AppSignal.

Em seguida, o Jira pode mostrar Configure Application URL, com o aviso “No response was received from the URL you entered”. Você pode ignorar esse aviso. Mantenha https://www.appsignal.com no campo New URL e selecione Continue.
A caixa de diálogo Configure Application URL do Jira avisando que nenhuma resposta foi recebida, com https://www.appsignal.com no campo New URL e um botão Continue

Ignore o aviso e selecione Continue.

Depois, o Jira mostra a caixa de diálogo Review link. Digite AppSignal como Application Name, confirme que o Application Type é Generic Application e selecione Continue. Você só precisa preencher o nome da aplicação.
A caixa de diálogo Review link do Jira com AppSignal como Application Name e Generic Application como Application Type

Nomeie a aplicação como AppSignal.

Configuração do OAuth

Agora configure o Incoming Authentication para o AppSignal. Na página Application links, abra o menu … ao lado de AppSignal e selecione Edit.
A página Application links do Jira listando o AppSignal como Generic Application com um link Direct, com o menu aberto mostrando Edit, Go to remote e Delete

Abra o menu ao lado de AppSignal e selecione Edit.

O Jira abre a caixa de diálogo Configure AppSignal. Selecione Incoming Authentication no menu à esquerda.
A caixa de diálogo Configure AppSignal do Jira em Incoming Authentication, com a aba OAuth mostrando os campos Consumer Key e Consumer Name

Configure o OAuth em Incoming Authentication.

Na aba OAuth, configure o OAuth com os seguintes valores. A página da integração com o Jira no AppSignal também os mostra, em OAuth credentials.
  • Consumer Key: ce2jejafmni3qmnzrfergg9fLpzxmppl
  • Consumer Name: AppSignal
  • Public Key:
Text
Selecione 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. A integração com o Jira é pessoal: cada pessoa que quiser enviar incidentes ao Jira segue estes passos.
  1. Abra seu app no AppSignal e vá para App settings → Integrations.
  2. Em Personal issue tracker integrations, selecione Configure ao lado de Jira. Você também pode seguir este link.
A página Integrations nas configurações do app no AppSignal, com o Jira listado como Inactive em Personal issue tracker integrations e o link Configure destacado

Selecione Configure ao lado de Jira.

  1. Em Jira installation location, digite a URL completa do seu site Jira em Full path to the site. Por exemplo: https://your-project-name.atlassian.net. Acima desse formulário, o AppSignal mostra a Consumer Key, o Consumer Name e a Public Key que você digitou no Jira na configuração do OAuth. Eles já estão preenchidos, então você não precisa digitá-los novamente.
  2. Selecione Link AppSignal to Jira.
A página da integração com o Jira no AppSignal com o final da chave pública e o formulário Jira installation location, com a URL de um site Jira no campo Full path to the site e o botão Link AppSignal to Jira

Digite a URL do seu site Jira e vincule o AppSignal ao Jira.

  1. O Jira pede que você permita ao AppSignal acesso de leitura e escrita ao seu site Jira. Selecione Allow.
A página Welcome to JIRA do Jira pedindo para permitir acesso de leitura e escrita ao AppSignal, com os botões Allow e Deny

Permita que o AppSignal acesse seu site Jira.

O AppSignal então leva você de volta à página da integração com o Jira. Se você já vinculou o AppSignal ao Jira, por exemplo para outro app, Configure leva você direto para lá.
  1. De volta ao AppSignal, em Your integration details > Select your project and issue type, selecione o projeto do Jira e o tipo de issue para as issues que o AppSignal cria.
  2. Selecione Create integration.
A página da integração com o Jira no AppSignal com um projeto e um tipo de issue selecionados em Select your project and issue type, e o botão Create integration

Escolha o projeto e o tipo de issue, depois crie a integração.

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:
  1. Vá para Errors → Issue list e selecione o incidente.
  2. No painel Actions, selecione Send to Jira.
A aba Summary de um incidente de erro no AppSignal, com Send to Jira listado em Actions, abaixo de Time detective

Selecione Send to Jira no painel Actions do incidente.

Acompanhar issues do Jira vinculadas a partir do incidente

Este recurso está em beta, como parte do AppSignal Labs. Peça ao suporte para ativá-lo na sua organização.
Depois que você envia um incidente ao Jira, o painel Actions mostra um botão para a issue, com o rótulo da sua chave, como View #WEB-142 in Jira. O botão mostra o status da issue como um badge, com o nome usado no seu projeto Jira, como In Review. O AppSignal atualiza o badge quando a issue muda no Jira. As mudanças de status também aparecem no logbook do incidente. Por exemplo: Changed the status of #WEB-142 on Jira from In Progress → In Review. A entrada mostra quem fez a mudança no Jira.
Um incidente no AppSignal com uma entrada no logbook que mudou o status de #KAN-5 no Jira de In Progress para In Review, e uma ação View #KAN-5 in Jira com um badge In Review

Uma issue do Jira vinculada mostra seu status no painel Actions, e as mudanças de status aparecem no logbook.

Algumas limitações que vale a pena conhecer:
  • Uma nova issue recebe seu badge pouco depois de você enviá-la ao Jira, assim que o Jira informa o AppSignal sobre ela.
  • Issues enviadas ao Jira antes de você ativar as atualizações de status não mostram badge até a próxima mudança delas no Jira.
  • O logbook não mostra o primeiro status de uma issue, porque não há um status anterior para comparar.

Ativar as atualizações de status

O Jira envia as mudanças das issues ao AppSignal por meio de um webhook no seu site Jira. O AppSignal o adiciona quando você salva a integração:
  1. Vá para App settings → Integrations e selecione Configure ao lado de Jira.
  2. Selecione Update integration. Se a integração for nova, selecione Create integration.
Você precisa da permissão global Jira Administrators no Jira. Sem ela, a integração ainda é salva, mas o AppSignal mostra: “Two-way sync is off: AppSignal couldn’t add a webhook to Jira. That needs the Jira Administrators global permission. Save the integration again to retry.” Peça a um administrador do Jira para salvar a integração, ou obtenha a permissão e salve-a novamente. Às vezes o bug já está no Jira: um colega o registrou depois do relato de um cliente, antes de o erro chegar ao AppSignal. Cole o link da issue em uma nota, e o AppSignal a vincula ao incidente. Abra a aba Summary do incidente. Escreva uma nota com a URL da issue do Jira na caixa Logbook e selecione Post note. O AppSignal vincula todas as URLs de issues do Jira na nota, como https://your-site.atlassian.net/browse/WEB-142. O logbook registra que você vinculou a issue, e a issue aparece no painel Actions. O badge de status aparece assim que a issue mudar novamente no Jira. O servidor MCP do AppSignal vincula issues da mesma forma quando um agente de IA escreve uma nota em um incidente. O AppSignal só vincula uma issue quando todas as condições a seguir são verdadeiras. Caso contrário, ele ignora a URL, e a nota é publicada mesmo assim.
  • O suporte ativou esses recursos para sua organização, como parte do AppSignal Labs.
  • A integração com o Jira do app está Active em App settings → Integrations. Depois que o suporte ativou esses recursos, alguém com a permissão global Jira Administrators salvou a integração.
  • Você mesmo vinculou o AppSignal ao Jira, com a mesma URL de site Jira da integração do app, como https://your-site.atlassian.net. O AppSignal busca a issue com a sua conta do Jira.
  • A issue está no projeto Jira que a integração do app usa, e sua conta do Jira consegue abri-la.
  • A nota contém a URL /browse/ da issue, como https://your-site.atlassian.net/browse/WEB-142. Uma chave de issue sozinha, como WEB-142, não é vinculada.
  • A issue ainda não está vinculada ao incidente. Isso inclui uma issue que você criou com Send to Jira. O AppSignal não a vincula duas vezes, e o logbook não registra nada. Editar a nota também não cria duplicatas.

Trocar de projeto ou remover a integração

  • Trocar para outro projeto Jira: salve a integração com o novo projeto. O AppSignal move o webhook para o novo projeto.
  • Remover a integração no AppSignal: vá para App settings → Integrations, selecione Configure ao lado de Jira e selecione Remove integration. O AppSignal remove o webhook do Jira. Se o Jira não permitir, o AppSignal avisa, e um administrador do Jira pode excluir o webhook no Jira em System → WebHooks.
Para remover também o AppSignal do Jira, exclua o link de aplicação dele:
  1. No Jira, selecione a engrenagem de configurações (⚙️). Em Jira admin settings, selecione Jira apps.
  2. Em Integrations, na navegação lateral, selecione Application links.
  3. Abra o menu … ao lado de AppSignal e selecione Delete.
A página Application links do Jira listando o AppSignal como Generic Application com um link Direct, com o menu aberto e Delete destacado

Exclua o link de aplicação do AppSignal no 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. Erro de Integração do AppSignal Jira Você precisará adicionar os campos às telas do Jira indo para a aba “Issues” no menu “Settings”: Jira Setting Issues Depois navegue até “Screens” no painel de navegação esquerdo e clique em “Configure” para a tela relevante: Jira Screen Options 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. Jira Screen Config 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