Personalización del Recopilador de datos de Node.js para aplicaciones locales

Modificando los archivos del paquete de recopilador de datos, puede establecer las variables de entorno para personalizar la supervisión de la aplicación Node.js.

Puede establecer las variables personalizando las variables de entorno o editando el archivo config.properties. Encontrará el archivo config.properties en la carpeta ibmapm/etc en la que está instalado el recopilador de datos Node.js.

Tabla 1. Variables soportadas
Nombre de variable Importancia Valor Descripción
KNJ_SAMPLING Opcional Recuento de solicitudes de muestreo El número de solicitudes en función del cual se toma una muestra.

El valor predeterminado es 10, lo que significa que se supervisa una de cada 10 solicitudes.

Si no establece esta variable, se utiliza el valor predeterminado 10.

KNJ_MIN_CLOCK_TRACE Opcional Umbral de tiempo de respuesta para la recopilación de rastreo de método, en milisegundos Si el tiempo de respuesta de una instancia de solicitud supera el valor de esta variable, el recopilador de datos recopila su rastreo de método.

El valor predeterminado es 0.

Si no establece esta variable, se utilizará el valor predeterminado 0.

KNJ_MIN_CLOCK_STACK Opcional Umbral de tiempo de respuesta para recopilar el rastreo de pila, en milisegundos Si el tiempo de respuesta de una instancia de solicitud excede el valor de esta variable, el recopilador de datos recopila su seguimiento de la pila.

El valor predeterminado es 0.

Si no establece esta variable, se utilizará el valor predeterminado 0.

KNJ_ENABLE_METHODTRACE Opcional
  • True
  • False
Habilita o inhabilita el rastreo de método.
  • Si establece esta variable en true, el rastreo de método para solicitudes se inhabilita.
  • Si establece este valor en false, el rastreo de método para las peticiones se habilita. Éste es el valor predeterminado.

Si no establece esta variable, se utiliza el valor predeterminado False y rastreo de método para las solicitudes se habilita.

KNJ_ENABLE_DEEPDIVE Opcional
  • True
  • False
Si establece esta variable en true, los datos de diagnósticos se envían al servidor. De forma predeterminada, este valor se establece en false, lo que significa que los datos de diagnósticos no se envían al servidor.
KNJ_ENABLE_TT Opcional
  • verdadero
  • falso
Habilita o inhabilita el rastreo de transacciones de AAR.
  • Si establece esta variable en true, el rastreo de AAR está habilitado.
  • Si establece esta variable en false, el rastreo de transacciones de AAR está inhabilitado.

De forma predeterminada, este valor no está establecido, lo que significa que el rastreo de transacciones está inhabilitado.

KNJ_AAR_BATCH_FREQ Opcional Intervalo al que se envían los datos de AAR, en segundos Especifica el intervalo de creación y envío de lotes de datos de AAR al servidor, en segundos.

El valor predeterminado es 60, lo que significa que cada minuto se crean y se envían lotes de datos de AAR al servidor.

Nota: Esta variable funciona con KNJ_AAR_BATCH_COUNT para determinar cuándo se crean y se envían lotes de datos de AAR al servidor. Cuando se cumple la condición establecida por una de las dos variables, se crean y se envían los lotes de datos de AAR. Cuando las solicitudes que los datos de AAR contienen alcanzan el número máximo, por ejemplo 100, en un intervalo inferior al establecido, se siguen creando y enviando lotes de datos inmediatamente.
KNJ_AAR_BATCH_COUNT Opcional Número máximo de solicitudes que un lote de datos de AAR contiene Especifica el número máximo de solicitudes que un lote de datos de AAR puede contener antes de que se envíe al servidor.

El valor predeterminado es 100, lo que significa que cuando el número de solicitudes que un lote de datos de AAR contiene alcanza 100, este lote de datos de AAR se envía al servidor.

KNJ_LOG_LEVEL Opcional Nivel de información que se imprime en el registro Controla el nivel de información que se imprime en el registro. Se proporcionan los niveles siguientes:
off
Los registros no se imprimen.
error
Solo se registra información si se da una condición de error.
info
Se registra información cuando el recopilador de datos del agente de Node.js se ejecuta normalmente. También se registran los datos de supervisión en bruto enviados al agente.
debug
Se anota información de depuración, información y error útil en el registro, por ejemplo, datos recopilados, datos que se envían al servidor y la respuesta del servidor.
all
Se anota toda la información en el registro.

De forma predeterminada, el nivel de registro es info, lo que significa que la información de resumen sobre las acciones del recopilador de datos se imprime en el registro. Los registros se imprimen en la salida estándar.

SECURITY_OFF Opcional
  • verdadero
  • falso
Habilita o inhabilita la recopilación de información confidencial de usuario, como por ejemplo las cookies, el contexto de solicitud HTTP y el contexto de solicitud de base de datos.
  • Si establece esta variable en true, se recopila información confidencial.
  • Si establece esta variable en false, no se recopila información confidencial. Éste es el valor predeterminado.

Si no especifica esta variable, se utiliza el valor predeterminado false y no se recopila información confidencial de usuario.