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.
Selecione Jira apps em Jira admin settings.

A página Application links, com o botão Create link.
- 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.comno campo Application URL. - Selecione Continue.

Selecione Direct application link e digite a URL do AppSignal.
https://www.appsignal.com no campo New URL e selecione Continue.

Ignore o aviso e selecione Continue.
AppSignal como Application Name, confirme que o Application Type é Generic Application e selecione Continue. Você só precisa preencher o nome da aplicação.

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.
Abra o menu ao lado de AppSignal e selecione Edit.

Configure o OAuth em Incoming Authentication.
- Consumer Key:
ce2jejafmni3qmnzrfergg9fLpzxmppl - Consumer Name:
AppSignal - Public Key:
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.- Abra seu app no AppSignal e vá para App settings → Integrations.
- Em Personal issue tracker integrations, selecione Configure ao lado de Jira. Você também pode seguir este link.

Selecione Configure ao lado de Jira.
-
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. - Selecione Link AppSignal to Jira.

Digite a URL do seu site Jira e vincule o AppSignal ao Jira.
- O Jira pede que você permita ao AppSignal acesso de leitura e escrita ao seu site Jira. Selecione Allow.

Permita que o AppSignal acesse seu site Jira.
- 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.
- Selecione Create integration.

Escolha o projeto e o tipo de issue, depois crie a integraçã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:- Vá para Errors → Issue list e selecione o incidente.
- No painel Actions, selecione Send to Jira.

Selecione Send to Jira no painel Actions do incidente.
Acompanhar issues do Jira vinculadas a partir do incidente

Uma issue do Jira vinculada mostra seu status no painel Actions, e as mudanças de status aparecem no logbook.
- 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:- Vá para App settings → Integrations e selecione Configure ao lado de Jira.
- Selecione Update integration. Se a integração for nova, selecione Create integration.
Vincular uma issue do Jira existente
À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, comohttps://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, comohttps://your-site.atlassian.net/browse/WEB-142. Uma chave de issue sozinha, comoWEB-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.
- No Jira, selecione a engrenagem de configurações (⚙️). Em Jira admin settings, selecione Jira apps.
- Em Integrations, na navegação lateral, selecione Application links.
- Abra o menu … ao lado de AppSignal e selecione Delete.

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



