Conozca NerdGraph: nuestra API GraphQL

NerdGraph es nuestra API en formato GraphQL que le permite consultar datos de New Relic y configurar algunas características de New Relic. Después de registrarse para obtener una cuenta gratuita de New Relic e instalar cualquiera de nuestros servicios de monitoreo, puede comenzar con NerdGraph.

¿Qué es NerdGraph?

NerdGraph es una de varias API de New Relic. NerdGraph es la API que recomendamos para consultar datos de New Relic y realizar alguna configuración específica (obtenga más información sobre la característica). NerdGraph proporciona una única interfaz API para devolver datos de las diversas API y microservicios de New Relic. Con el tiempo, se agregarán otras capacidades de configuración a NerdGraph.

Importante

NerdGraph no se utiliza para la ingesta de datos. Para eso, usarías nuestras API de ingesta de datos.

NerdGraph se creó utilizando GraphQL, que es un formato API de código abierto que le permite solicitar exactamente los datos necesarios, sin exceso ni falta de captura.

Requisitos

Antes de comenzar:

Necesita una cuenta New Relic y con esa cuenta puede acceder a su API
que debe incluir con consultas y mutaciones.
El tipo de usuario y los roles asignados pueden afectar sus permisos de NerdGraph. Para obtener más detalles, consulte Factores que afectan el acceso.

Extremo

Los extremos de API que utilice dependen de la región de su centro de datos:

Extremo principal: https://api.newrelic.com/graphql
Extremo para cuentas que utilizan el centro de datos de la UE: https://api.eu.newrelic.com/graphql

Para acceder al extremo, puede realizar llamadas desde su código, usar el explorador de API NerdGraph o crear un comando curl similar a este:

bash

$curl -X POST https://api.newrelic.com/graphql \
>     -H 'Content-Type: application/json' \
>     -H 'API-Key: YOUR_NEW_RELIC_USER_KEY' \
>     -d '{ "query":  "{ requestContext { userId apiKey } }" }'

Utilice el explorador de API NerdGraph

Una forma sencilla de experimentar con la API NerdGraph es utilizar el explorador de API NerdGraph. Para obtener ayuda para comenzar a usar esta herramienta, consulte el tutorial del explorador de API NerdGraph.

Funcionalidad NerdGraph

La funcionalidad de NerdGraph se puede dividir en dos categorías principales:

Querying data.
Puede recuperar datos para diversos fines, incluido su uso en un flujo de trabajo programático o la creación de una aplicación New Relic para visualizaciones de datos personalizadas.
Configuring features.
Hay una variedad de configuraciones disponibles y se agregarán más con el tiempo. Puedes hacer cosas como agregar etiquetas, configurar carga de trabajo o personalizar las "métricas doradas".

Puede utilizar NerdGraph para devolver y configurar una amplia gama de datos. Una forma de ver lo que puede hacer NerdGraph es comenzar a crear consultas y explorar el esquema utilizando el explorador NerdGraph.

Estas son algunas de las características de NerdGraph más utilizadas:

Obtén datos sobre tu monitor entidad
Consulta tus datos usando NRQL (nuestro lenguaje de consulta)
Crear panel

Aquí están todos nuestros documentos NerdGraph disponibles:

Tema	Tutoriales
Administración de cuentas	Cuentas de administración Administrar usuario Administrar grupos de usuarios Crear y administrar clave de API (claves de ingesta de datos y claves de usuario)
Alerta	Para alerta New Relic: vea todos los tutoriales relacionados con alerta Para inteligencia aplicada: configuración de topología para correlación de incidentes
agentes	Configuración del agente APM
	Instalar agente del navegador y configurar la monitorización Instrumentado múltiples aplicaciones usando el paquete npm
Seguimiento de cambios	Seguimiento de cambios utilizando NerdGraph Seguimiento de cambios mediante la CLI
Panel	Crear y administrar panel Panel de control: gráficos y widget. Exportar panel a otras cuentas Exportar panel como archivos Administrar el panel compartido externamente
Integración en la nube (AWS, Azure, GCP)	Configurar la integración en la nube
Gestión de datos	Convertir datos de eventos a datos métricos Retención de datos Exportación de streaming de datos Soltar datos
rastreo distribuido	Consulta rastreo datos distribuidos Configurar el seguimiento infinito
Entidad	Obtener datos sobre monitor entidad Comprender las relaciones entre entidades y la dependencia (utilizadas para crear mapas de servicios) consultar y configurar "golden metrics" (entidad métrica importante)
Administración de logs	Administrar particiones de datos log Administrar reglas de análisis de registros Manejar la expresión de ofuscación y las reglas.
Monitoreo de moviles	Crear una nueva aplicación móvil Recuperar un token de aplicación Ejemplos de configuración
New Relic	Crea una aplicación New Relic
Socios y revendedores	Administrar suscripción (solo para socios que utilizan el modelo de precios original)
Consultas y gráficos	Ejecute la consulta NRQL de sus datos Ejecutar consulta en varias cuentas Asincrónico, consulta de mayor duración
Nivel de servicio	Configurar y gestionar el nivel de servicio.
Monitoreo sintetico	Administra tu monitor
Etiqueta	Agregar y administrar etiqueta
Carga de trabajo	Ver y configurar carga de trabajo

Terminología de NerdGraph

Los siguientes son términos que se originan en GraphQL, el formato API que utiliza NerdGraph.

Término	Definición
Consulta y mutaciones	Hay dos clases de operaciones GraphQL: consulta son solicitudes básicas que se utilizan únicamente para obtener datos. Estas consultas no son estáticas, es decir que puedes pedir más o menos datos, dependiendo de tus necesidades. Para cada consulta, puede especificar exactamente qué datos desea recuperar, siempre que sean compatibles con el esquema. Las mutaciones son solicitudes que realizan una acción, como crear un recurso o cambiar la configuración. Las mutaciones requieren la palabra clave `mutation`, así como el `name` de la mutación.
Tipo	Los datos en GraphQL están organizados en tipos. Los tipos pueden ser escalares (como cadenas, números o booleanos) o tipos de objetos. Un tipo de objeto es un tipo personalizado formado por una colección de campos. Por ejemplo, un tipo de objeto llamado `User` puede representar a un usuario en un sistema.
Campo	Un campo representa una información sobre un tipo de objeto que se puede consultar. Los campos pueden ser escalares, listas u objetos. Por ejemplo, un tipo de objeto `User` podría tener un campo de cadena llamado `name`.
Interfaz	Una interfaz es un tipo abstracto que representa una colección de campos comunes que otros tipos de objetos pueden `implement`.

Te ofrecemos esta traducción automática para facilitar la lectura.