Guía de Troubleshooting GeneXus

Autor Profesional

Marcelo Rosas

Analista Programador (A/P) de Sistemas — Univ. ORT Uruguay

GeneXus (v17/18), .NET Framework, IIS 10, SQL Server

Fecha: 13 de Enero, 2026

Nota de Distribución: Este manual técnico se comparte con la comunidad Genexiana para facilitar el diagnóstico en entornos de producción. Se autoriza su libre uso y difusión.

1. Visualización Detallada de Errores (Debug Mode)

Para identificar el fallo real detrás de un error genérico (HTTP 500), se debe habilitar el rastreo detallado modificando el web.config en el directorio raíz:

Desactivar Errores Personalizados:

<configuration>
   <system.web>
      <!-- Cambiar de RemoteOnly o On a Off -->
      <customErrors mode="Off" />
   </system.web>
</configuration>

Habilitar Detalles en el Pipeline de IIS:

<configuration>
   <system.webServer>
      <httpErrors errorMode="Detailed" />
      <asp scriptErrorSentToBrowser="true"/>
   </system.webServer>
</configuration>

2. Gestión de Logs de GeneXus

Si el error es de lógica interna o base de datos, active el log detallado dentro de la sección <appSettings> del mismo web.config:

<appSettings>
    <!-- Define el nivel de detalle (Debug registra sentencias SQL y variables) -->
    <add key="GX_LOG_LEVEL" value="Debug" />
    <!-- Define la salida (RollingFile genera archivos rotativos) -->
    <add key="GX_LOG_OUTPUT" value="RollingFile" />
</appSettings>

Ubicación y Revisión del Log:

Por defecto, GeneXus genera los archivos de log con extensión .log en la carpeta bin o en la raíz de la aplicación web en el servidor. Puede buscar archivos llamados client.log o similares. Si necesita una ruta específica, puede usar la clave GX_LOG_FILENAME.

Importancia de la Desactivación:

Una vez resuelto el problema, es vital establecer GX_LOG_LEVEL en "None". Mantener el log en modo "Debug" degrada significativamente el rendimiento debido a la escritura constante en disco y puede agotar el almacenamiento en entornos de producción.

3. Conectividad y Data Stores

Verifique la cadena de conexión en la sección connectionStrings del web.config:

<connectionStrings>
    <add name="Default" 
         connectionString="Data Source=SERVER;Initial Catalog=DB;User ID=UID;Password=PWD;" />
</connectionStrings>

Protocolos: Asegure que TCP/IP esté habilitado en el SQL Server Configuration Manager.
Firewall: El puerto (1433 por defecto) debe estar abierto para la IP del servidor web.
Application Pool: La identidad del pool debe tener permisos de lectura/escritura en carpetas temporales y acceso a la BD.

Medidas de Seguridad Post-Diagnóstico

Es obligatorio revertir los cambios para evitar exponer vulnerabilidades:

1. Cambiar customErrors mode="On".
2. Establecer errorMode="Custom" en httpErrors.
3. Volver GX_LOG_LEVEL a "None".

¿Consultas Técnicas?

Esta guía es parte del compromiso de FocusOn con la excelencia técnica.

Contactar a Marcelo Rosas