Introducción a la API métrica

La API métrica de New Relic se puede utilizar para enviar datos métricos a New Relic desde una variedad de fuentes. Esta API es la forma en que algunos de nuestros integradores y exportadores ingresan a New Relic.

¿Quieres probar nuestra API métrica? ¡ Crea una cuenta New Relic gratis! No se requiere tarjeta de crédito.

¿Qué es la métrica API?

La API métrica es una forma de obtener datos métricos en New Relic. La API funciona enviando una solicitud POST a nuestro extremo HTTP con una carga útil JSON que contiene los datos métricos.

La API métrica es la forma en que se incorporan las métricas de algunas de nuestras integraciones, incluidos nuestros exportadores de código abierto (como DropWizard y Prometheus). La API métrica también es utilizada por nuestros SDK de telemetría, que son herramientas específicas del lenguaje que facilitan el uso de nuestras API de ingesta de datos.

La API métrica se puede utilizar para:

• Reportar datos métricos a New Relic sin un agente de New Relic.
• Integre datos métricos desde una herramienta, biblioteca o framework de código abierto o desarrollado internamente.
• Controla totalmente los datos métricos que envías, incluida la resolución y dimensiones asociadas.
• Aproveche el poder de NRQL, el lenguaje de consulta de New Relic, para consultar sus datos métricos.
• Configura alerta para tus datos métricos.

Requisitos

Asegúrese de que la conectividad saliente en el puerto TCP 443 esté permitida en el rango CIDR que coincida con su región. El método de configuración preferido es utilizar el nombre DNS metric-api.newrelic.com o metric-api.eu.newrelic.com.

Necesitará una New Relic clave de licenciapara la cuenta New Relic a la que desea enviar datos. Para obtener información sobre límites y atributos restringidos, consulte Límites y requisitos de API métrica.

Empezar

Si no contamos con una integración o un inicio rápido que satisfaga sus necesidades de informes métricos, tiene dos opciones:

• Utilice nuestros SDK de telemetría, que son herramientas específicas del idioma que le ayudan a enviarnos datos métricos y de otro tipo.
• Utilice la API métrica directamente.

Encuentra y utiliza tus datos

Puede encontrar datos enviados a través de la API de métrica (incluidas las de integración que utilizan esta API) en estas ubicaciones:

• Desde one.newrelic.com, selecciona Explorer y busca tu servicio.

• Consultando el tipo de datos Metric . Por ejemplo, puedes usar NRQL para ejecutar:

  SELECT * FROM Metric

  Copia

  Para obtener más información sobre consultas, consulte ejemplos de consulta métrica. Para obtener información sobre consultas en general, consulte datos de consulta.

Alerta sobre datos métricos

Para alertar sobre métricas creadas con la API de métrica, use NRQL condición de alerta: seleccione la categoría NRQL al definir su condición, luego use la sintaxis de consulta FROM Metric ... NRQL para expresarla. Cuando crea estas condiciones de alerta, alertasutiliza automáticamente los datos de granularidad más finos disponibles (los puntos de datos métricos sin procesar) para evaluar las alertas.

Retención de datos

Todos los puntos de datos métricos sin procesar se conservarán durante 30 días. Todos los datos agregados adicionales derivados de los puntos de datos métricos sin procesar (por ejemplo, resúmenes de un minuto) se conservarán durante 13 meses. Cualquier cambio en el período de retención más allá de dichos períodos puede generar un cargo para usted.

Resolución de problemas

Consulte Solucionar problemas de un evento NrIntegrationError .