Application Real-Time Monitoring Service:Integre o Jira usando credenciais de conta

Configure a integração com o Jira no ARMS

1. Faça login no console do ARMS. No painel de navegação à esquerda, escolha Alert Management > Integrations.

2. Na página Integrations, clique em Notification Integration e, em seguida, clique em JIRA.

3. No assistente Add Integration, conclua as etapas a seguir:

   1. Na página Basic Information, insira um nome para a integração e a URL da instância do Jira. Defina o Verification method como Log on with Jira account e insira o nome de usuário e a senha do Jira. Opcionalmente, adicione uma descrição e clique em Test Connectivity.

   2. Após o aparecimento da mensagem Connection Succeeded, clique em Next.

      Nota

      Se a conexão falhar, sua URL do Jira, nome de usuário ou senha podem estar incorretos. Corrija as configurações e clique em Test Connectivity novamente.

   3. Na página Alert Source Configuration, configure as definições de sincronização de alertas conforme descrito na tabela a seguir e clique em Save.

      Parâmetro	Descrição	Exemplo
      Project	O projeto do Jira onde as issues são criadas quando um alerta é acionado.	Projeto integrado de monitoramento, gerenciamento e controle
      Type	O tipo de issue do Jira para o alerta. Task Subtask Improvement New feature Bug Epic Story	Bug
      Issue closed status	O status que marca uma issue do Jira como fechada. Quando uma issue atinge esse status, as operações subsequentes de alerta não são mais sincronizadas com ela. Status disponíveis: To Do In Progress In Review Done Nota Recomendamos selecionar Done. Se você escolher outro status, as operações de alerta continuarão sendo sincronizadas com a issue correspondente no Jira mesmo após o status dela mudar para Done.	Done
      Priority	Mapeia os níveis de severidade do alerta para as prioridades das issues no Jira. Importante Caso nenhum mapeamento seja configurado para um nível de severidade, os alertas desse nível não serão sincronizados com o Jira. O nível de severidade do alerta é sincronizado com base neste mapeamento apenas no momento do primeiro envio ao Jira. Alterações posteriores na severidade do alerta no Gerenciamento de Alertas do ARMS não são refletidas na issue do Jira.	P1: Hightest P2: High P3: Medium P4: Low P5: Lowest

   Após salvar a configuração, visualize a nova integração com o Jira na aba Notification Integration. A lista exibe informações como Name, Integration key, Type e Creation time. Gerencie a integração pela coluna Actions.

Envie alertas para o Jira

Após configurar a integração com o Jira, envie alertas para o sistema de três maneiras:

Método 1

Configure uma política de notificação para criar automaticamente uma issue no Jira quando um alerta for acionado.

1. No painel de navegação à esquerda, escolha Alert Management > Notification Policies.

2. Na página Notification Policies, clique em Create Notification Policy ou edite uma política de notificação existente.

3. Na seção When an alert is triggered,, especifique os Contacts. Selecione pelo menos um contato ou grupo de contatos.

   Importante

   • O Jira atribui a issue a um usuário cujo endereço de e-mail ou nome de usuário corresponda ao do primeiro contato na política de notificação.

   • Se o primeiro contato da política de notificação não tiver um usuário correspondente no Jira, o alerta não será sincronizado.

4. Para Ticket system, selecione a integração com o Jira que você criou. Configure outros parâmetros conforme necessário. Para obter mais informações, consulte Políticas de notificação.

5. Clique em Save.

   Após concluir a configuração, os alertas que corresponderem a essa política de notificação serão enviados para o Jira.

Método 2

Na página Alert Sending History, envie manualmente um alerta existente para o Jira a fim de criar uma issue.

1. No painel de navegação à esquerda, escolha Alert Management > Alert Sending History.

2. Na página Alert Sending History, selecione um operador no canto superior direito para atuar como responsável pela issue no Jira e clique em Alert Sending History.

   Importante

   • O Jira atribui a issue a um usuário cujo endereço de e-mail ou nome de usuário corresponda ao do operador selecionado.

   • Caso o operador não tenha um usuário correspondente no Jira, não será possível sincronizar o alerta.

3. Na página de detalhes do alerta, clique em no canto superior direito e, em seguida, clique em Push Alerts.

4. Na caixa de diálogo exibida, em Ticket system, selecione a integração com o Jira criada e clique em Confirm.

   Após o envio bem-sucedido do alerta, um link para a issue correspondente no Jira, como AL-6, aparecerá na página de detalhes do alerta.

Método 3

Ao receber um cartão de alerta em um grupo do DingTalk, envie o alerta correspondente diretamente para o Jira a partir do cartão.

• No cartão de alerta recebido no grupo do DingTalk, clique em Push Alerts e selecione a integração com o Jira que você criou.

• No cartão de alerta, clique em Settings, clique em Push ticket e selecione a integração com o Jira que você criou.

Após o envio bem-sucedido do alerta, um link para a issue correspondente no Jira aparecerá na página de detalhes do alerta.

Supported alert operations for synchronization

Após a configuração, as seguintes operações de alerta no Gerenciamento de Alertas do ARMS são sincronizadas com o sistema de tickets do Jira.

Operações na página Alert Sending History:

• Assumir alerta: Atualiza o responsável pela issue no Jira.

  Nota

  O usuário que assume o alerta deve ter uma conta de usuário correspondente no Jira.

• Comentar no alerta: Adiciona o comentário à issue no Jira.

• Resolver alerta: Adiciona a resolução como um comentário na issue do Jira.

Operações no cartão de alerta em um grupo do DingTalk:

Assumir alerta: Atualiza o responsável pela issue no Jira.

Sincronize ações do Jira de volta para o ARMS

1. No Gerenciamento de Alertas do ARMS, acesse a página Integrations, clique em Notification Integration e copie a chave de integração da sua integração com o Jira.

2. Faça login no seu sistema de tickets do Jira. No canto superior direito da página do Jira, clique em OsType.

3. Insira sua senha de administrador e clique em Confirm para acessar a página de configuração do sistema.

4. No painel de navegação à esquerda da página OsType, escolha Alerts > Webhook.

5. Na página Webhooks, clique em + Create a webhook.

6. Na página Create a webhook, defina a URL como http://alerts.aliyuncs.com/api/jira/receiver/{token}/${project.key}/${issue.key}. Substitua {token} pela chave de integração do Jira obtida na Etapa 1.

   Defina Name como ARMS Alert Management e altere o Status para Enabled. Na seção Issue related events, selecione All issues. Na coluna Issue, selecione created, updated e deleted. Na coluna Comment, selecione created, updated e deleted.

7. Configure outros parâmetros conforme necessário. Para obter mais informações, consulte a documentação oficial do Jira. Em seguida, clique em Create.

   Após concluir estas etapas, as seguintes operações de issue do Jira serão sincronizadas com o Gerenciamento de Alertas do ARMS.

   • Alteração do responsável pela issue: O responsável pelo alerta correspondente é atualizado.

   • Adição de comentário a uma issue: Um comentário é adicionado ao alerta correspondente.