Depois de registrar uma implantação para uma entidade de aplicativo APM, você poderá manter sua equipe informada sobre essas alterações por meio do uso de um webhook. Eles estão disponíveis se você registrar sua implantação usando o recurso Monitoramento de Alterações ou a API REST mais antiga.
Permissões necessárias
As configurações de notificação do Monitoramento de Alterações requerem permissões específicas:
- Para
create
o webhook:Modify
permissões paraApplied intelligence > Destinations
eApplied intelligence > Channels
. - Para
view
etest
o webhook:View
permissões paraApplied intelligence > Destinations
eApplied intelligence > Channels
. - Para
modify
o webhook:View
permissões paraApplied intelligence > Destinations
eApplied intelligence > Channels
eModify
emApplied intelligence > Destinations
. - Para
delete
o webhook:Delete
permissões paraApplied intelligence > Destinations
eApplied intelligence > Channels
.
Obtenha o URL de destino do seu webhook
Você pode enviar dados de implantação para vários destinos de webhook. Siga as instruções da ferramenta que você está usando para obter o URL do webhook. Assim que tiver o URL, conclua as etapas da próxima seção para configurar a notificação do webhook.
Se você estiver usando o Slack, siga estas instruções para configurar o aplicativo legado New Relic :
Login em sua conta do Slack como administrador e vá para
Apps
.
Procure por
New Relic Alerts
e clique nesse bloco.
Na listagem
New Relic Alerts
, clique no botão
Configuration
abaixo do ícone New Relic.
Clique na guia
Configuration
abaixo do título
New Relic Alerts
.
Na guia
Configuration
, clique no ícone de lápis.
Role para baixo até a seção
Webhook URL
e clique em
Copy URL
.
Configurar notificação de webhook para alterações rastreadas
Insira o URL do webhook na interface do New Relic:
Acesse a tela de configuração da notificação de implantação:
one.newrelic.com > (user menu) > Administration > Integrations > Deploy notifications
.
Cole o URL do seu webhook no campo
Webhook URL
e clique em
Save
.
Clique em
Send a test request
para enviar um exemplo de carga útil com dados artificiais para o URL do seu webhook.
Em
Toggle this webhook
, você pode desativar ou reativar a notificação do webhook deslizando o botão de alternância.
Para excluir permanentemente a configuração de notificação do webhook, clique em
Delete this webhook
.
Estrutura de carga útil de notificação
Quando sua notificação de implantação estiver ativada e você começar a rastrear uma alteração, seu webhook receberá uma solicitação POST
com uma carga útil do tipo application/x-www-form-urlencoded
. As chaves e os valores são codificados em tuplas de valor principal separadas por um &
, com um símbolo =
entre a chave e o valor. Caracteres não alfanuméricos em chaves e valores serão codificados por URL.
Serão enviadas as seguintes chaves e valores, com base no atributo da implantação e da entidade aplicação APM que foi implantada.
Chave | Valor |
---|---|
| O timestamp da implantação no formato ISO 8601 |
| O nome da entidade do aplicativo APM |
| O nome da conta que possui a entidade do aplicativo APM |
| Uma lista de alterações incluídas na implantação |
| Uma descrição da implantação |
| A versão do software implantar |
| Um link para a interface de implantação da entidade solicitante do APM |
| O usuário que implanta a aplicação |