Depurar y solucionar problemas de proxies de Node.js

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

Te recomendamos que te asegures de que el 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 proxies que incluyen aplicaciones de Node.js después de su implementación.

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 por completo el grupo de conexiones. Para obtener más información y un código de ejemplo, consulta Sugerencias de rendimiento de Node.js: agrupación de sockets en la comunidad de Apigee.

Visualiza registros de Node.js

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

  1. En la página principal de 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 Logs, puedes seleccionar un período de registros para verlos, como se muestra a continuación. Los registros graban las llamadas de método HTTP, el éxito o el fracaso de las llamadas, los mensajes de 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 de seguimiento

La herramienta de seguimiento es útil para realizar depuraciones generales de proxy. Para obtener información detallada sobre el uso de la herramienta de seguimiento, consulta Cómo usar la herramienta de seguimiento.

Salida de la consola de impresión

Puedes incorporar instrucciones console.log en tu código de Node.js y ver el resultado en la herramienta de seguimiento. Por ejemplo, la siguiente declaració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 de seguimiento, llama a tu API en la herramienta de seguimiento y haz clic en Resultado de todas las transacciones para abrir el panel de resultados:

Supongamos que 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 la 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;

Según el tiempo que tarde el servidor en responder, puedes determinar las 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 la configuración de tiempo de espera del objetivo de Apigee

También puedes configurar los valores de tiempo de espera predeterminados de Apigee en el elemento HttpTargetConnection en 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 la Referencia de propiedades de extremos.

Más información

Para obtener más información sobre la depuración, consulta los siguientes recursos:

Próximos pasos

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