Grabar y ver despliegue

Implementar una aplicación puede ser un evento riesgoso: cuando la aplicación falla y la causa suele ser un mal despliegue. New Relic le permite realizar un seguimiento del despliegue para que pueda correlacionarlo con los cambios en el rendimiento de su aplicación. El seguimiento desplegable crea marcadores de despliegue que aparecen en los gráficos y el panel de APM.

Vea cómo funciona el marcador de despliegue en este breve video (4:30 minutos):

Opciones de seguimiento desplegado

Puede utilizar la API REST v2 de New Relic para registrar nuevos despliegues y recuperar una lista de despliegues anteriores. Además, algunos agentes APM tienen métodos específicos del agente para registrar el despliegue automáticamente.

Puede utilizar su integración de Slack con New Relic, o un simple webhook, para notificar a su equipo en tiempo real sobre el despliegue de la aplicación monitor por APM. Slack proporciona una URL de webhook que le permite publicar JSON genérico que aparecerá formateado en un canal de Slack elegido.

Hay algunos lugares donde puedes ver el despliegue en la UI de New Relic después de que se hayan grabado:

• En la fuente de actividad en las páginas Resumen de APM, Resumen de servicio y Resumen de entidad.
• En gráficos de rendimiento de APM como marcadores de gráficos (líneas verticales con cabezas de alfiler).
• En gráficos dashboard como marcadores de gráficos.
• En la página desplegable para ver el resumen del rendimiento.

Registro de implementación con la API REST

Puede utilizar la API REST v2 de New Relic para registrar el despliegue y obtener una lista del despliegue anterior.

• Los ejemplos de este documento utilizan curl como herramienta de línea de comando. Sin embargo, puede utilizar cualquier método para realizar sus solicitudes REST. También puedes crear y ver el despliegue con API Explorer.

• JSON utiliza comillas dobles " para los nombres de elementos y el contenido. El uso de comillas simples ' provocará errores.

• Los ejemplos usan X-Api-Key que se puede usar para una

  clave de usuario

  o una

  clave de API REST

  . Las claves de usuario son ahora la forma preferida de acceder a nuestras API REST y puede utilizar encabezados Api-Key cuando las utilice.

$
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}"
  }
}

Grabar despliegue usando el agente New Relic

Algunos agentes tienen métodos adicionales para grabar el despliegue:

• All agents

  : Utilice la API REST de New Relic v2.

• C

  : No hay métodos específicos del SDK. Utilice la API REST.

• Go

  : No hay métodos específicos del agente. Utilice la API REST.

• Java

  : Llame al agente de Java jar.

• .NET

  : Utilice PowerShell y la API REST.

• Node.js

  : No hay métodos específicos del agente. Utilice la API REST.

• PHP

  : Utilice un script PHP.

• Python

  : utilice el subcomando record-deploy del script newrelic-admin .

• Ruby

  : Utilice una receta de Capistrano.

Ver detalles del despliegue

Después de configurar la información de despliegue, puede ver y profundizar en los detalles en la UI. Para obtener sugerencias, consulte nuestro documento de seguimiento de cambios Cómo ver y analizar sus cambios en New Relic.

Notifique a su equipo sobre el despliegue

Ya sea que esté realizando un seguimiento con la API REST o la API GraphQL más nueva, puede notificar a los miembros de su equipo mediante un webhook. Para obtener más información, consulte las instrucciones del webhook de seguimiento de cambios.