Personalización del Recopilador de datos de Python para aplicaciones IBM Cloud

Puede añadir variables de entorno en la interfaz de usuario (IU) de IBM® Cloudpara personalizar la supervisión de la aplicación IBM Cloud. Utilice la información siguiente para añadir las variables según sus necesidades.

Variables de entorno definidas por el usuario para el Recopilador de datos de Python

Puede utilizar la información de la tabla siguiente para personalizar la supervisión de Python en IBM Cloud.

Tabla 1. Variables de entorno definidas por el usuario soportadas para la supervisión de Python en IBM Cloud
Nombre de variable Importancia Valor Descripción
APM_BM_GATEWAY_URL Opcional
  • https://<ip o nombre de host del servidor>:443
  • http://<ip o nombre de host del servidor>:80
 El URL de pasarela del servidor local de destino.
APM_KEYFILE_PSWD Opcional Contraseña cifrada del archivo de claves La contraseña del archivo de claves cifrada que se empareja con el archivo de claves. Si es usuario de Linux, puede utilizar el mandato echo -n <contraseña de archivo de claves> | base64 para cifrar la contraseña.
Nota: establezca esta variable sólo cuando haya configurado la pasarela para utilizar HTTPS.
APM_KEYFILE_URL Opcional http://<servidor http alojado>:<puerto>/keyfile.p12 El URL utilizado para descargar el archivo de claves.
Nota: establezca esta variable sólo cuando haya configurado la pasarela para utilizar HTTPS.
KPG_ENABLE_DEEPDIVE Opcional
  • False
  • True
 Habilita o inhabilita la recopilación de datos de diagnóstico.
  • True: el valor predeterminado. Si establece esta variable en True, se recopilan datos de diagnóstico.
  • False: si establece esta variable en False, no se recopilan datos de diagnóstico.

Si no establece esta variable, se recopilan datos de diagnóstico.
KPG_DD_CONFIG_FILE Opcional Nombre del archivo de configuración de supervisión de diagnósticos. Nombre del archivo de configuración de supervisión de diagnósticos. El nombre de archivo predeterminado es kpg_dd_config.xml.
Nota: después de personalizar los valores de este archivo, debe colocarlo en el directorio raíz de la aplicación.

Si no establece esta variable, se utilizará el archivo de configuración predeterminado kpg_dd_config.xml del paquete de recopiladores de datos.
KPG_DD_APP_PATH Opcional Vía de acceso a la aplicación Python. La vía de acceso a la aplicación de Python o el módulo para el que el recopilador de datos recopila datos de diagnóstico. Separe las vías de acceso de diferentes aplicaciones Python y módulos que desee supervisar con signos de punto y coma ;.

Si no establece esta variable, el recopilador de datos recopila datos para las solicitudes y módulos utilizados por la aplicación. Los datos de solicitudes de la biblioteca de Python no se recopilan.
KPG_DD_SECURITY_FILTER Opcional
  • True
  • False
  • True: el valor predeterminado. Si establece esta variable en True, los valores (como por ejemplo las contraseñas) estarán enmascarados en las sentencias SQL y los parámetros no se visualizarán en el widget de grupo Contexto de solicitud.
  • Falso: si establece esta variable en False, los valores de las sentencias SQL no estarán enmascarados y los parámetros se visualizarán en el widget de grupo Contexto de solicitud.

Si no establece esta variable, los valores (como la contraseñas) estarán enmascarados en las sentencias SQL y los parámetros no se visualizarán en el widget de grupo Contexto de solicitud.
KPG_GC_STATS Opcional True Todas las funciones de estadísticas de recogida de basura de python están habilitados. Cuando se establece este valor en True, es igual a ejecutar el mandato siguiente: 

gc.set_debug(gc.DEBUG_STATS |
gc.DEBUG_COLLECTABLE |
gc.DEBUG_UNCOLLECTABLE | 
gc.DEBUG_INSTANCES | 
gc.DEBUG_OBJECTS )

Para inhabilitar KPG_GC_STATS, suprima esta variable de entorno. No la establezca en False.

Nota: nunca establezca KPG_SAVE_ALL=True en el entorno de producción habitual. Es sólo para la modalidad de depuración. Asegúrese de que se asigna suficiente memoria a la aplicación.
KPG_LOG_LEVEL Opcional
  • DEBUG
  • ERROR
  • INFO
  • DEBUG: sólo se anota información de depuración útil en el registro, por ejemplo, datos recopilados, datos que se envían al servidor y la respuesta del servidor.
  • ERROR: sólo se anota información sobre excepciones y situaciones inesperadas en el registro.
  • INFO: se anota en el registro la información de resumen sobre el recopilador de datos para que el usuario sepa qué se está haciendo.
KPG_LOG_TOCONSOLE Opcional
  • Y
  • True
  • Cualquier otro valor que no sea False
 El registro se refleja en la consola y el usuario puede verlo ejecutando el mandato cf logs <nombre_aplicación>.
KPG_SAVE_ALL Opcional True Todos los objetos no referenciados se guardan en gc.garbage, y debe borrarse gc.garbage cada minuto (el recopilador de datos lo borra automáticamente). Si el valor se establece en True, es igual a ejecutar el mandato siguiente: 
gc.set_debug(gc.SAVE_ALL)
Para inhabilitar KPG_SAVE_ALL, suprima esta variable de entorno. No la establezca en False.
Nota: nunca establezca KPG_SAVE_ALL=True en el entorno de producción habitual. Es sólo para la modalidad de depuración. Asegúrese de que se asigna suficiente memoria a la aplicación.