En esta guía aprenderás a instalar SigNoz localmente con Docker, instrumentar una aplicación Node.js con OpenTelemetry y visualizar métricas y trazas en tiempo real.

Requisitos previos: Node.js v14 o superior, Docker y Docker Compose instalados y conocimientos básicos de Node.js.

Paso 1 Configurar SigNoz localmente Usamos el despliegue Docker oficial. En una terminal ejecuta git clone https://github.com/SigNoz/signoz.git cd signoz/deploy/docker ./install.sh Una vez finalizado abre http://localhost:3301 y verás el panel de SigNoz.

Paso 2 Crear una app Node.js simple Crea una carpeta ejemplo mkdir node-signoz-demo cd node-signoz-demo inicializa npm npm init -y instala express npm install express Crea un archivo app.js con una ruta raíz que responda un mensaje y que escuche en el puerto 3000 Ejecuta node app.js y comprueba http://localhost:3000

Paso 3 Añadir OpenTelemetry para enviar datos a SigNoz Instala las librerías npm install @opentelemetry/api @opentelemetry/sdk-node @opentelemetry/auto-instrumentations-node Crea un archivo tracing.js donde inicialices NodeSDK y agregues getNodeAutoInstrumentations y llames a start Importa ese archivo al inicio de tu app con require antes de cargar express para que la instrumentación se active desde el arranque.

Paso 4 Ver métricas y trazas Abre de nuevo el panel de SigNoz en http://localhost:3301 y verás trazas, peticiones por segundo RPS, latencia y tasas de error Explora servicios y spans y localiza peticiones lentas.

Paso 5 Generar carga opcional Puedes enviar llamadas para probar el llenado de datos por ejemplo for i in {1..50}; do curl http://localhost:3000 ; done y refrescar el panel para ver la telemetría en tiempo real.

Conclusión En este tutorial completaste la instalación de SigNoz con Docker, creaste una app Node.js, añadiste instrumentación con OpenTelemetry y viste métricas y trazas en vivo. En Q2BSTUDIO somos especialistas en desarrollo de software a medida y aplicaciones a medida y podemos ayudarte a llevar esta solución a entornos productivos, integrarla con servicios cloud y optimizar la observabilidad de tus microservicios. Conoce nuestros servicios de software a medida y nuestras soluciones de inteligencia artificial para empresas que incluyen agentes IA y analytics. También ofrecemos ciberseguridad pentesting, servicios cloud aws y azure, integración con Power BI y servicios de inteligencia de negocio para que tus aplicaciones sean seguras, escalables y orientadas a datos.

Próximos pasos Monitoriza una API real, explora alertas y dashboards en SigNoz o solicita a Q2BSTUDIO una consultoría para desplegar observabilidad completa en AWS o Azure y automatizar procesos con IA para empresas y agentes IA que mejoren el rendimiento y la experiencia de usuario.