Cadastre e visualize implantação

Implantar um aplicativo pode ser um evento arriscado – quando seu aplicativo quebra e uma implantação incorreta costuma ser a causa. O New Relic permite que você rastreie a implantação para que você possa correlacionar a implantação com as mudanças no desempenho do seu aplicativo. O rastreamento de implantações cria um marcador de implantação que aparece nos gráficos e no painel do APM.

Veja como funciona o marcador de implantação neste pequeno vídeo (4:30 minutos):

Opções para rastreamento de implantação

Você pode usar a API REST v2 do New Relic para registrar novas implantações e recuperar uma lista de implantações anteriores. Além disso, alguns agentes APM possuem métodos específicos do agente para registrar a implantação automaticamente.

Você pode usar sua integração do Slack com o New Relic, ou um simples webhook, para notificar sua equipe em tempo real da implantação do aplicativo monitor pelo APM. O Slack fornece um URL de webhook que permite postar JSON genérico que aparecerá formatado em um canal escolhido do Slack.

Existem alguns lugares onde você pode visualizar a implantação na interface do New Relic depois de gravada:

• No feed de atividades nas páginas Resumo do APM, Resumo do serviço e Resumo da entidade.
• Em gráficos de desempenho APM como marcadores de gráfico (linhas verticais com cabeças de alfinete).
• Em gráficos dashboard como marcadores de gráfico.
• Na página de implantação para resumo do desempenho.

Registrar implantação com a API REST

Você pode usar a API REST v2 do New Relic para registrar a implantação e obter uma lista de implantações anteriores.

• Os exemplos neste documento usam curl como ferramenta de linha de comando. No entanto, você pode usar qualquer método para fazer suas solicitações REST. Você também pode criar e visualizar implantação com o API Explorer.
• JSON usa aspas duplas " para nomes de elementos e conteúdo. Usar aspas simples ' causará erros.
• Os exemplos usam X-Api-Key que pode ser usado para uma chave de usuário ou uma chave de API REST. As chaves de usuário agora são a maneira preferida de acessar nossas APIs REST, e você pode usar cabeçalhos Api-Key ao utilizá-las.

$
curl -X POST "https://api.newrelic.com/v2/applications/$APP_ID/deployments.json" \
>
     -H "X-Api-Key:$API_KEY" \
>
     -i \
>
     -H "Content-Type: application/json" \
>
     -d \
>
'{
$
    "deployment": {
$
        "revision": "REVISION",
$
        "changelog": "Added: /v2/deployments.rb, Removed: None",
$
        "description": "Added a deployments resource to the v2 API",
$
        "user": "datanerd@example.com",
$
        "timestamp": "2019-10-08T00:15:36Z"
$
    }
$
}'

Invoke-WebRequest -Uri https://api.newrelic.com/v2/applications/YOUR_APP_ID/deployments.json -Method POST -Headers @{'X-Api-Key'='$API_KEY'} -ContentType 'application/json' -Body '{
    "deployment": {
        "revision": "REVISION",
        "changelog": "Added: /v2/deployments.rb, Removed: None",
        "description": "Added a deployments resource to the v2 API",
        "user": "datanerd@example.com",
        "timestamp": "2019-10-08T00:15:36Z"
    }
}'

$encoding = [System.Text.Encoding]::GetEncoding("ASCII")
$data ='{
    "deployment": {
        "revision": "REVISION",
        "changelog": "Added: /v2/deployments.rb, Removed: None",
        "description": "Added a deployments resource to the v2 API",
        "user": "datanerd@example.com",
        "timestamp": "2019-10-08T00:15:36Z"
    }
}'
$postData = $encoding.GetBytes($data)
$request = [System.Net.WebRequest]::Create('https://api.newrelic.com/v2/applications/$APP_ID/deployments.json')
$request.Method = 'POST'
$request.Headers.add('X-Api-Key','$API_KEY')
$request.ContentType='application/json'
$stream = $request.GetRequestStream()
$stream.Write($postData,0,$postData.Length)
$request.GetResponse()

$
curl -X GET "https://api.newrelic.com/v2/applications/$APP_ID/deployments.json" \
>
     -H "X-Api-Key:$API_KEY" \
>
     -i

$
curl -X GET "https://api.newrelic.com/v2/applications/9999999/deployments.json" \
>
     -H "X-Api-Key:ABCDEFGHIJKLMNOPQRSTUVWXabcdefghijklmnopqrstuvwx" \
>
     -i

HTTP/1.1 200 OK
ETag: "ABCDEFGHIJKabcdefghijk0123456789"
Cache-Control: max-age=0, private, must-revalidate
Content-Type: application/json
{
  "deployments": [
    {
      "id": 1234567,
      "revision": "1234123412341234123412341234123412341234",
      "changelog": "Fixed the bugs for real this time",
      "description": "Example description two",
      "user": "Data Nerd",
      "timestamp": "2016-02-24T10:09:27-08:00",
      "links": {
        "application": 9999999
      }
    },
    {
      "id": 2345678,
      "revision": "7890789078907890789078907890789078907890",
      "changelog": "Think I fixed all the bugs",
      "description": null,
      "user": "Dren Atad",
      "timestamp": "2014-10-22T12:23:47-07:00",
      "links": {
        "application": 9999999
      }
    }
  ],
  "links": {
    "deployment.agent": "/v2/applications/{application_id}"
  }
}

Registrar implantação usando o agente New Relic

Alguns agentes possuem métodos adicionais para registrar a implantação:

• All agents: Use a API REST v2 do New Relic.
• C: nenhum método específico do SDK. Utilize a API REST.
• Go: Nenhum método específico do agente. Utilize a API REST.
• Java: Chame o agente Java jar.
• .NET: Use o PowerShell e a API REST.
• Node.js: Nenhum método específico do agente. Utilize a API REST.
• PHP: Use um script PHP.
• Python: use o subcomando record-deploy do script newrelic-admin .
• Ruby: Use uma receita do Capistrano ou o comando newrelic deployments . Mais detalhes aqui.

Ver detalhes da implantação

Depois de configurar as informações de implantação, você poderá visualizar e detalhar os detalhes na interface do usuário. Para dicas, consulte nosso documento Monitoramento de Alterações Como visualizar e analisar suas alterações no New Relic.

Avise sua equipe sobre implantação

Esteja você rastreando a implantação com a API REST ou a API GraphQL mais recente, você pode notificar os membros da sua equipe usando um webhook. Para obter detalhes, consulte as instruções do webhook do Monitoramento de Alterações.