Comience con la CLI de New Relic

Instale la CLI New Relic

Descargue la CLI de New Relic para su sistema operativo, como se describe a continuación. También puede descargar binarios prediseñados para todas las plataformas, incluidos .deb y .rpm. paquetes y nuestro Windows x64 .msi instalador.

Linux

Usando Snapcraft, ejecuta:

$
sudo snap install newrelic-cli

macOS

Usando Homebrew, ejecute:

$
brew install newrelic-cli

Windows

Usando Scoop, ejecuta:

$
scoop bucket add newrelic-cli https://github.com/newrelic/newrelic-cli.git
$
scoop install newrelic-cli

Cree su perfil CLI de New Relic

Después de instalar la CLI de New Relic, es hora de crear su primer perfil. Los perfiles contienen credenciales y configuraciones que puede aplicar a cualquier comando CLI, lo cual resulta útil al cambiar entre cuentas.

Ejecute el comando profiles add :

$
# Create the tutorial account for the US region
$
newrelic profiles add --profile tutorial --apiKey YOUR_NEW_RELIC_USER_KEY -r YOUR_REGION
$
# Set the profile as defaults
$
newrelic profiles default --profile tutorial

Obtenga los detalles de su aplicación

Ahora, agregue la etiqueta a la aplicación que ha instrumentado con New Relic. etiqueta son pares de valores principales que pueden ayudarte a organizar y filtrar tu entidad. Una entidad (por ejemplo, una aplicación) puede tener un máximo de 100 pares de valores principales vinculados.

Antes de buscar su aplicación usando la CLI de New Relic, escriba o copie su ID de cuenta y el nombre de su aplicación en New Relic ; necesita ambos para encontrar aplicaciones en la plataforma New Relic.

Recupere los detalles de su aplicación como un objeto JSON

Para buscar su aplicación APM, utilice el comando apm application search :

$
newrelic apm application search --accountId YOUR_ACCOUNT_ID --name NAME_OF_YOUR_APP

Encuentra el valor guid

Si el ID de la cuenta es válido y el nombre de la aplicación existe en su cuenta, apm application search genera datos similares a este ejemplo:

[
  {
    "accountId": YOUR_ACCOUNT_ID,
    "applicationId": YOUR_APP_ID,
    "domain": "APM",
    "entityType": "APM_APPLICATION_ENTITY",
    "guid": "A_LONG_GUID",
    "name": "NAME_OF_YOUR_APP",
    "permalink": "https://one.newrelic.com/redirect/entity/A_LONG_GUID",
    "reporting": true,
    "type": "APPLICATION"
  }
]

Cuando haya buscado correctamente su aplicación, busque el valor guid . Es un identificador único para su aplicación. Deberías copiarlo o escribirlo.

Agregue una etiqueta simple a su aplicación

Ahora que tiene el GUID, puede apuntar la CLI de New Relic directamente a su aplicación. Agregar una etiqueta es la forma más sencilla de probar las capacidades de la CLI (no se preocupe, las etiquetas se pueden eliminar usando entity tags delete).

Aquí, agrega una etiqueta de entorno a su aplicación. Agregue la etiqueta dev:testing ⁠ (o cualquier otro par principal de valor) a su aplicación usando el comando entities tags create :

$
newrelic entity tags create --guid YOUR_APP_GUID --tag devkit:testing

Agregar conjuntos de etiquetas

¿Qué pasa si quieres agregar varias etiquetas? ¡Juegos de etiquetas al rescate! Mientras que las etiquetas son pares de valores principales separados por dos puntos, los conjuntos de etiquetas son listas de etiquetas separadas por comas. Por ejemplo:

tag1:value1,tag2:value2

Para agregar varias etiquetas a su aplicación a la vez, modifique y ejecute este fragmento:

$
newrelic entity tags create --guid YOUR_APP_GUID --tag tag1:test,tag2:test

Recupera la etiqueta de tu aplicación

Ha creado y agregado algunas etiquetas a su aplicación, pero para probar que funcionan, necesita recuperarlas.

Ejecute el comando entity tags get :

$
newrelic entity tags get --guid YOUR_APP_GUID

Todas las etiquetas asociadas con su aplicación se recuperan como una matriz JSON:

[
  {
    "Key": "tag1",
    "Values": ["true"]
  },
  {
    "Key": "tag2",
    "Values": ["test"]
  },
  {
    "Key": "tag3",
    "Values": ["testing"]
  }
  // ...
]

Paso adicional: crea un marcador de despliegue

El despliegue de la aplicación suele salir mal. Los marcadores de despliegue son etiquetas que, cuando se adjuntan a los datos de su aplicación, le ayudan a realizar un seguimiento del despliegue y solucionar problemas de lo sucedido.

Para crear un marcador de despliegue, ejecute el comando apm deployment create usando el mismo ID de la aplicación de su búsqueda anterior:

$
newrelic apm deployment create --applicationId YOUR_APP_ID --revision $(git describe --tags --always)

Verifique la respuesta JSON para la revisión y timestamp del despliegue.

Puede crear este flujo de trabajo en un sistema de integración continua o despliegue continuo (CI/CD) para indicar cambios en el comportamiento de su aplicación después del despliegue.

He aquí un ejemplo:

{
  "id": 37075986,
  "links": {
    "application": 204261368
  },
  "revision": "v1.2.4",
  "timestamp": "2020-03-04T15:11:44-08:00",
  "user": "Developer Toolkit Test Account"
}