Una forma para que el usuario acceda a su Nerdlet es creando un iniciador. El iniciador abre un Nerdlet desde la página de Apps en New Relic. También puedes proporcionar acceso a tu Nerdlet desde una entidad en tu cuenta.
En esta guía, aprenderá cómo conectar su Nerdlet a su entidad.
Antes de que empieces
Si aún no lo has hecho:
- Regístrese para obtener una cuenta New Relic
- Instalar y configurar la CLI de New Relic One
Crea un Nerdpack
Actualice su CLI:
$nr1 update
Crea un Nerdpack con la CLI:
$nr1 create --type nerdpack --name entity-nerdlet
Esto da como resultado un Nerdpack, llamado entity-nerdlet
, que consta de un pícher, llamado entity-nerdlet-launcher
, y un Nerdlet, llamado entity-nerdlet-nerdlet
.
Sirve a tu Nerdpack:
$cd entity-nerdlet$nr1 nerdpack:serve
Vaya a https://one.newrelic.com/?nerdpacks=local y navegue hasta Apps.
?nerdpacks=local
es necesario para permitir que sus Nerdpacks servidos localmente se carguen en New Relic.
En Your apps, haz clic en tu iniciador para ver tu aplicación New Relic.
Adjunta tu Nerdlet a entidad
Viste cómo puedes acceder a tu Nerdlet desde un pícher. Ahora, accede a tu Nerdlet desde tu entidad.
Desde dentro del directorio raíz de tu Nerdpack, abre nerdlets/entity-nerdlet-nerdlet/nr1.json
. Este es el archivo de metadatos de tu Nerdlet. Emplearás este archivo para anexar tu Nerdlet a entidad.
Agregue un objeto context
con una matriz entities
:
{ "schemaType": "NERDLET", "id": "entity-nerdlet-nerdlet", "displayName": "EntityNerdletNerdlet", "description": "", "context": { "entities": [] }}
Esto le dice New Relic que quieres que tu Nerdlet aparezca en una matriz de contextos de entidad.
Agregue un contexto de entidad:
{ "schemaType": "NERDLET", "id": "entity-nerdlet-nerdlet", "displayName": "EntityNerdletNerdlet", "description": "", "context": { "entities": [ { "domain": "APM", "type": "APPLICATION" } ] }}
Aquí, anexaste tu Nerdlet a todas las entidades de aplicación en el dominio APM .
Ir a APM.
Debido a que estás sirviendo tu Nerdpack localmente, recuerda que aún debes especificar la cadena de consulta ?nerdpacks=local
.
Elija cualquiera de sus aplicaciones.
Desplázate hacia abajo para ver tu Nerdlet adjunto a la aplicación.
Haga clic en esta opción de menú y vea su Nerdlet de la misma manera que lo hizo con el iniciador.
Configura tu entities
La clave context.entities
en el archivo nr1.json
de tu Nerdlet especifica a qué entidad debe anexar tu Nerdlet.
Especificar una entidad domain
Anexe su Nerdlet a un determinado dominio de entidad especificando domain
como uno de los siguientes valores:
APM
: Monitoreo del rendimiento de aplicaciones (APM)BROWSER
: BrowserINFRA
: Monitoreo de infraestructuraMOBILE
: Monitoreo de celularesSYNTH
: Monitoreo sintético
Por ejemplo, anexa tu Nerdlet a todas las entidades en el dominio APM
:
{ "context": { "entities": [{ "domain": "APM" }] }}
Adjunta tu Nerdlet a todas las entidades excepto aquellas en un dominio:
{ "context": { "entities": [{ "domain": "!APM" }] }}
Adjunta tu Nerdlet a todas las entidades en múltiples dominios:
{ "context": { "entities": [{ "domain": "APM" }, { "domain": "BROWSER" }] }}
Especificar una entidad type
Anexe su Nerdlet a un determinado tipo de entidad especificando type
como uno de los siguientes valores:
APPLICATION
HOST
MONITOR
Por ejemplo, anexa tu Nerdlet a todas las entidades del tipo APPLICATION
:
{ "context": { "entities": [{ "type": "APPLICATION" }] }}
Adjunta tu Nerdlet a todas las entidades excepto aquellas de un tipo específico:
{ "context": { "entities": [{ "type": "!APPLICATION" }] }}
Anexe su Nerdlet a cada entidad cuyo tipo coincida con uno de una matriz de tipos:
{ "context": { "entities": [{ "type": "APPLICATION" }, { "type": "MONITOR" }] }}
Especificar una entidad tags
Adjunta tu Nerdlet a entidades que tengan una etiqueta determinada.
Por ejemplo, anexe su Nerdlet a la entidad que tiene un GUID particular:
{ "context": { "entities": [ { "tags": [ { "key": "guid", "values": ["<SOME ENTITY GUID>"] } ] } ] }}
Anexe su Nerdlet a cada entidad que tenga accountId
individuo y use el lenguaje de programación Python:
{ "context": { "entities": [ { "tags": [ { "key": "accountId", "values": ["<SOME ACCOUNT ID>"] }, { "key": "language", "values": ["python"] } ] } ] }}
Combinar filtros
Cuando filtras la entidad a la que se agregará tu Nerdlet, puedes combinar domain
, type
y tags
:
{ "context": { "entities": [ { "domain": "APM", "type": "APPLICATION", "tags": [ { "key": "language", "values": ["python"] } ] }, { "domain": "SYNTH", "type": "MONITOR" }, { "domain": "BROWSER" } ] }}
En este ejemplo, anexaste tu Nerdlet a:
- Todas las aplicaciones APM cuya etiqueta de metadatos especifica el idioma
python
- Y todos los monitores Sintético
- Y todas las entidades Browser