Depurar y solucionar problemas de proxies de Node.js

Estás viendo la documentación de Apigee Edge.
Ir a la documentación de Apigee X. info

Es una buena práctica asegurarte de que cualquier código de Node.js que agregues a un proxy funcione antes de implementarlo en Edge. En este tema, se analizan las formas de depurar y solucionar problemas de los proxies que incluyen aplicaciones de Node.js después de que se implementan.

Aumenta el tamaño del grupo de conexiones para mejorar el rendimiento

Si notas un rendimiento lento, es posible que puedas resolver el problema aumentando el tamaño predeterminado del grupo de conexiones de Node.js con maxSockets o inhabilitando la agrupación de sockets por completo. Para obtener más información y un ejemplo de código, consulta Node.js Performance Tips: Socket Pooling en la comunidad de Apigee.

Visualiza los registros de Node.js

Para ver la información de registro sobre tu aplicación de Node.js, sigue estos pasos:

  1. En la página principal de los proxies de API, haz clic en el proxy que deseas ver.
  2. En la página de resumen del proxy seleccionado, haz clic en Registros de Node.js en el lado derecho de la barra de herramientas.

En la página Registros, puedes seleccionar un período de registros para verlos, como se muestra a continuación. Los registros registran llamadas a métodos HTTP, el éxito o el fracaso de las llamadas, los mensajes console.log, etcétera. Ingresa una cadena de búsqueda en el campo de búsqueda para mostrar todas las entradas de registro que contengan la cadena.

Usa la herramienta Trace

La herramienta Trace es útil para la depuración general de proxies. Para obtener información detallada sobre el uso de la herramienta Trace, consulta Usa la herramienta Trace.

Imprime el resultado de la consola

Puedes incorporar instrucciones console.log en tu código de Node.js y ver el resultado en la herramienta Trace. Por ejemplo, la siguiente instrucción imprime el valor de la variable config.user:

console.log('Logging in as %s', config.username);

Para ver el resultado de los mensajes console.log en la herramienta Trace, llama a tu API en la herramienta Trace y haz clic en Resultado de todas las transacciones para abrir el panel de resultados:

Si ejecutaste el siguiente código…

var http = require('http');

console.log('node.js application starting...');

var svr = http.createServer(function(req, resp) {
    resp.end('Hello, World!');
});

svr.listen(9000, function() {
    console.log('Node HTTP server is listening');
});

… las instrucciones de la consola aparecen en el panel:

Configura los parámetros de configuración de tiempo de espera de destino de Nginx

Si usas Nginx como proxy y ves errores de "Bad Gateway", intenta aumentar la configuración de tiempo de espera del proxy de Nginx como se explica aquí:

Por ejemplo:

proxy_connect_timeout       60;
proxy_read_timeout          120;

La duración de la respuesta del servidor puede determinar tus configuraciones de tiempo de espera ideales. Por ejemplo, un tiempo de espera de lectura de 45 a 60 segundos podría ser ideal para proporcionar un búfer razonable.

Configura los parámetros de configuración de tiempo de espera de destino de Apigee

También puedes configurar los valores de tiempo de espera predeterminados de Apigee en el elemento HttpTargetConnection en el TargetEndpoint. Los valores predeterminados son los siguientes:

connect.timeout.millis - 60 seconds
io.timeout.millis - 120 seconds
 
<HTTPTargetConnection>
    <Properties>
        <Property name="connect.timeout.millis">5000</Property>
        <Property name="io.timeout.millis">5000</Property>
    </Properties>
    <URL>http://www.google.com</URL>
</HTTPTargetConnection>

Consulta también Referencia de propiedades de extremos.

Más información

Para obtener más información sobre la depuración, consulta lo siguiente:

Próximos pasos

Para obtener información sobre la compatibilidad con módulos de Node.js en Apigee Edge, incluida información sobre la compatibilidad con HTTP/HTTPS, TLS y otros temas avanzados, consulta Comprende la compatibilidad de Edge con los módulos de Node.js.