Configuración del recopilador de datos del Agente de Node.js

Puede cambiar el comportamiento de cada recopilador de datos de agente de Node.js cambiando su configuración de tiempo de ejecución en su archivo de configuración.

Archivo de configuración de tiempo de ejecución

El código del recopilador de datos de Node.js está en el directorio siguiente:

KNJ_NPM_LIB_LOCATION/node_modules/ibmapm

donde KNJ_NPM_LIB_LOCATION es el directorio a la carpeta lib del directorio de instalación global del paquete npm. El directorio predeterminado es /usr/local/lib.

También hay un archivo de configuración para cada recopilador de datos de agente en la misma carpeta. El recopilador de datos de agente lee el archivo de configuración cada minuto.

Consejo: el archivo de configuración de tiempo de ejecución se nombra con el formato siguiente:

plugin_número de puerto de aplicación_conf.json

Cuando cambia el contenido del archivo de configuración, cambia el comportamiento del recopilador de datos de agente asociado. En el archivo de configuración puede cambiar dos tipos de información:

Reglas de filtrado de URL
Parámetros de registro del recopilador de datos de agente

Reglas de filtrado de URL

Puede cambiar las reglas de filtrado de URL en el archivo de configuración de tiempo de ejecución. Se utilizan expresiones regulares para correlacionar el nombre de vía de acceso del URL con un nombre de vía de acceso personalizado del usuario. Puede correlacionar el URL con un nombre de vía de acceso personalizado para satisfacer los requisitos siguientes:

Agregar URLs con vías de acceso similares. Por ejemplo, si tiene las siguientes vías de acceso de URL:
```
/demo/poll/1
/demo/poll/2
/demo/poll/3
...
```
En el servidor web, probablemente se da servicio a las solicitudes para estas vías de acceso mediante una rutina común, por lo que puede agregar las vías de acceso a un solo tipo de URL mediante un filtro utilizando el filtro del ejemplo siguiente.
```
"filters":
[
	{
		"pattern": "/demo/poll/.+",
		"to": "/demo/poll/"
	}
```
Este filtro da como resultado que todas las solicitudes de las vías de acceso de URL como "/demo/poll/xxx" se correlacionen con un tipo de vía de acceso de URL de "/demo/poll". A continuación, se hace un promedio del tiempo de respuesta de todas las solicitudes para las vías de acceso de URL de este tipo a un solo valor. La agregación de esta manera puede ayudar a hacer un uso más eficiente de los recursos disponibles.
Ignorar las vías de acceso de URL a archivos estáticos o filtrar determinados tipos de solicitudes. Por ejemplo, si una página web incluye imágenes que generan solicitudes de descarga de servidor individuales, quizá no le interese ver los tiempos de respuesta para estos tipos de solicitudes.
Para filtrar un tipo de solicitud, establezca el valor "to" en vacío como en el formato del ejemplo siguiente:
```
"filters":
[
	{
		"pattern": "GET /css/.+\\.css$",
		"to": ""
	}
```
Este filtro hace que las solicitudes obtengan un archivo .css que debe ignorarse. Como resultado, puede utilizar los recursos disponibles de forma más eficiente en las solicitudes que necesite supervisar.

En el archivo de configuración, las reglas de filtro de URL se especifican en una matriz JSON denominada filters:

"filters":
[
    {
        "pattern": ".+\\.png$",
        "to": ""
    },
    {
        "pattern": ".+\\.jpg$",
        "to": ""
    },
    {
        "pattern": "GET /js/.+\\.js$",
        "to": ""
    },
    {
        "pattern": "GET /css/.+\\.css$",
        "to": ""
    }
]

Cada miembro de la matriz es una regla de filtrado. Cuando el recopilador de datos de agente recibe una solicitud HTTP, extrae el nombre de vía de acceso de URL de la solicitud y lo compara con cada "pattern" (patrón). Si el nombre de vía de acceso no coincide con un "pattern", el nombre de vía de acceso de URL original se mantiene y se utiliza para las mediciones.

Parámetro de registro del recopilador de datos de agente

Puede cambiar los comportamientos de registro modificando el parámetro en el archivo de configuración config.properties del directorio KNJ_NPM_LIB_LOCATION/node_modules/ibmapm/etc. Se proporciona el parámetro de registro siguiente, que puede cambiar:

El nivel de rastreo

La entrada del archivo de configuración del nivel de rastreo es KNJ_LOG_LEVEL=info, lo que significa que la información de resumen sobre las acciones se imprime en el registro. Puede establecer el nivel de registro cambiando el valor de KNJ_LOG_LEVEL. El valor predeterminado es info y el registro se imprime en la salida estándar.

Se da soporte a los cinco valores de nivel de registro 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.