.jpg)
En este artículo aprenderás cómo instalar SigNoz localmente con Docker, instrumentar una aplicación Node.js con OpenTelemetry y visualizar métricas y trazas dentro de SigNoz, todo explicado paso a paso y adaptado para equipos que desarrollan aplicaciones a medida y soluciones de observabilidad.
Requisitos previos: tener Node.js instalado versión 14 o superior recomendada, Docker y Docker Compose instalados y conocimientos básicos sobre ejecución de aplicaciones Node.js.
Paso 1 : configurar SigNoz localmente. SigNoz ofrece un despliegue rápido basado en Docker. En tu terminal ejecuta los siguientes comandos: git clone https://github.com/SigNoz/signoz.git, cd signoz/deploy/docker, ./install.sh. Una vez completada la instalación abre tu navegador en https://localhost:3301 y verás el panel de SigNoz en funcionamiento.
Paso 2 : crear una aplicación Node.js sencilla. Crea una carpeta para el proyecto y monta una pequeña app Express con estos comandos: mkdir node-signoz-demo, cd node-signoz-demo, npm init -y, npm install express. Crea un archivo app.js con un contenido similar al siguiente: const express = require(`express`); const app = express(); app.get(`/`, (req, res) => { res.send(`¡Hola desde Node.js!`); }); app.listen(3000, () => { console.log(`Servidor ejecutándose en https://localhost:3000`); }); Ejecuta la aplicación con node app.js y visita https://localhost:3000.
Paso 3 : añadir OpenTelemetry para enviar datos a SigNoz. Instalamos los paquetes de OpenTelemetry con npm install @opentelemetry/api @opentelemetry/sdk-node @opentelemetry/auto-instrumentations-node. A continuación crea un archivo tracing.js con este contenido: const { NodeSDK } = require(`@opentelemetry/sdk-node`); const { getNodeAutoInstrumentations } = require(`@opentelemetry/auto-instrumentations-node`); const sdk = new NodeSDK({ instrumentations: [getNodeAutoInstrumentations()] }); sdk.start(); Finalmente, actualiza app.js para inicializar la telemetría antes que nada añadiendo require(`./tracing`); al inicio del archivo y cambia el mensaje de respuesta si lo deseas. Reinicia la app con node app.js.
Paso 4 : ver métricas y trazas en SigNoz. Vuelve al panel de SigNoz en https://localhost:3301 y deberías comenzar a ver trazas generadas por tu aplicación Node.js, solicitudes por segundo RPS, latencias y tasas de error. Desde el panel puedes explorar servicios, examinar spans y profundizar en solicitudes lentas.
Paso 5 : generar carga para probar (opcional). Para simular tráfico envía varias peticiones a tu servicio con: for i in {1..50}; do curl https://localhost:3000; done. Refresca el panel de SigNoz y verás los datos llenándose en tiempo real.
Conclusión: has configurado SigNoz usando Docker, creado una aplicación Node.js básica, añadido instrumentación con OpenTelemetry y visualizado métricas y trazas en tiempo real. La observabilidad es clave para mejorar la fiabilidad y el rendimiento de aplicaciones a medida y de arquitecturas de microservicios.
Sobre Q2BSTUDIO: somos una empresa de desarrollo de software especializada en aplicaciones a medida y software a medida, con experiencia en inteligencia artificial, ciberseguridad, servicios cloud aws y azure, servicios inteligencia de negocio y automatización. Si buscas potenciar tu producto o incorporar capacidades de observabilidad y monitorización en soluciones hechas a medida consulta nuestras opciones de desarrollo en software a medida y aplicaciones a medida y descubre cómo la inteligencia artificial puede integrarse en tus procesos visitando inteligencia artificial para empresas. También trabajamos con agentes IA, soluciones de Power BI y servicios de ciberseguridad y pentesting para asegurar la integridad y el rendimiento de tus sistemas.
Siguientes pasos recomendados: instrumenta una API real o microservicio, explora alertas y dashboards en SigNoz y combina la observabilidad con servicios cloud y análisis de negocio para obtener una visión completa. Si necesitas ayuda profesional para integrar observabilidad, migrar a la nube o desarrollar software a medida, en Q2BSTUDIO podemos acompañarte en todo el proceso.
