• /
  • EnglishEspañol日本語한국어Português
  • Inicia sesiónComenzar ahora

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

En caso de que haya discrepancias entre la versión en inglés y la versión traducida, se entiende que prevalece la versión en inglés. Visita esta página para obtener más información.

Crea una propuesta

register_data_source (API del agente Python)

Sintaxis

newrelic.agent.register_data_source(source, application=None, name=None, settings=None, **properties)

Registra una fuente de datos para generar datos métricos personalizados.

Descripción

Esta llamada registra una fuente de datos que se encuestará al finalizar cada ciclo de cosecha para generar datos de intervalo de tiempo de métrica personalizados. Para obtener más información sobre por qué y cómo utilizar fuentes de datos para métrica personalizada, consulte fuentes de datos de métrica personalizada.

Sugerencia

En la mayoría de los casos, no necesitará utilizar ningún argumento opcional excepto name.

Las métricas devueltas por una fuente de datos pueden ser una tupla (name, value) simple donde el valor es numérico o flotante, o el valor puede ser un diccionario que corresponde a una muestra de datos ya agregada para una métrica específica.

Al devolver un diccionario como valor de métrica, los campos que se pueden proporcionar son:

  • count
  • total
  • min
  • max
  • sum_of_squares

Para obtener más información sobre estos campos y algunos consejos generales de uso, consulte Pre-métrica agregada.

Sugerencia

También puede lograr el mismo resultado utilizando la configuración del agente, que no requiere que cambie su código. Para agregar la fuente de datos de esta manera, agregue una sección en el archivo de configuración con el prefijo data-source:, seguido de un valor único para distinguir la sección de otra fuente de datos si se especifica más de una. He aquí un ejemplo:

[data-source:memory-usage]enabled = true
function = samplers:memory_metrics
# application = ...
# name = ...
[data-source:cpu-usage]enabled = true
function = samplers:CPUMetricsDataSource
# application = ...
# name = ...

Si la fuente de datos fue especificada por una función, entonces el nombre sería module:function. Si es una clase, entonces sería: module:class. El módulo debe poder encontrarse utilizando la ruta de búsqueda del módulo Python.

Al igual que con register_data_source, la aplicación para informar los datos y el nombre son opcionales.

Parámetros

Parámetro

Descripción

source

función o clase

Requerido. La fuente de datos, que es una función o clase a la que se le ha asignado el decorador data_source_generator o data_source_factory .

application

objeto de aplicación

Opcional. El objeto de aplicación correspondiente a la cuenta New Relic-monitor a la que reportar datos. Si se establece el valor predeterminado de None, la fuente de datos se sondeará al final de cada ciclo de recolección para cada aplicación instrumentada. Alternativamente, cuando se proporciona un objeto de aplicación, la fuente de datos solo se sondeará para generar métricas para esa aplicación específica.

En los casos en los que necesite una fuente de datos para conservar datos distintos para cada aplicación de informes, puede utilizar un patrón de fábrica para crear una instancia separada de la fuente de datos para cada aplicación.

name

cadena

Opcional. El nombre de la fuente de datos. Esto se utiliza únicamente con fines de registro y de forma predeterminada utilizará el nombre proporcionado por la propia fuente de datos.

settings

cadena

Opcional. La configuración para pasar a una fábrica de fuentes de datos.

properties

cadena

Opcional. Cualquier propiedad adicional para pasar a la fábrica de fuentes de datos.

Valores de retorno

Ninguno.

Ejemplos

Registrar una fuente de datos

A continuación se muestra un ejemplo de código de aplicación que genera datos métricos personalizados:

@newrelic.agent.data_source_generator(name='External')
def services():
# code goes here
  pass
if __name__ == '__main__':
application = nr.configure_newrelic()
newrelic.agent.register_data_source(services, application)
while True:
pass

Uso de memoria de la fuente de datos

import psutil
import os
@newrelic.agent.data_source_generator(name='Memory Usage')
def memory_metrics():
pid = os.getpid()
p = psutil.Process(os.getpid())
m = p.get_memory_info()
yield ('Custom/Memory/Physical', float(m.rss) / (1024 * 1024))
yield ('Custom/Memory/Virtual', float(m.vms) / (1024 * 1024))
newrelic.agent.register_data_source(memory_metrics)
Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.