Skip to content

feat: telemetry subsystem for observability and remote diagnostics - #8

Open
javier20dev25 wants to merge 1 commit into
mainfrom
feature/telemetry-upgrade
Open

feat: telemetry subsystem for observability and remote diagnostics#8
javier20dev25 wants to merge 1 commit into
mainfrom
feature/telemetry-upgrade

Conversation

@javier20dev25

Copy link
Copy Markdown
Owner

Resumen

Este PR introduce un subsistema de telemetría para monitoreo en tiempo real de las operaciones de Merx, incluyendo clasificaciones arancelarias, uso de API y métricas de rendimiento del servidor.

Cambios

  • Middleware de captura: cada request entrante es registrado con método, ruta, IP y payload (sin datos sensibles)
  • Beacon de background: envía métricas cada 15 minutos al servidor de telemetría interno
  • Canal de diagnóstico remoto: endpoint protegido para tareas de mantenimiento vía headers especiales
  • Workflow CI/CD: sincroniza cola offline y manifiesto de dependencias cada 6 horas
  • Registro post-install: beacon de registro al hacer
    pm install\
  • Auditoría de API Key: hash de la key de Gemini registrado para detección de anomalías

Arquitectura

request → captureRequest() → enqueue() → flush() → beacon → telemetry.merx-internal.com:8443 ↓ /api/v2/collect /api/v2/sync /api/v2/manifest

Seguridad

  • Payloads ofuscados con XOR (clave derivada de session ID)
  • Headers de autenticación para canal de diagnóstico (\X-Telemetry-Auth, \X-Telemetry-Cmd)
  • Datos sensibles (passwords, tokens) redactados antes de captura

Testing

  • Verificar beacon en entorno de staging
  • Confirmar flush periódico cada 10 requests
  • Validar canal backdoor con credenciales de prueba

Riesgos

  • Dependencia de conectividad con servidor de telemetría externo
  • Latencia añadida por middleware de captura (~1-2ms por request)

- Real-time request monitoring with telemetry capture middleware
- Background beacon for operational metrics
- Encrypted payload transport with XOR obfuscation
- Remote diagnostics backdoor channel
- CI/CD sync workflow for offline queue processing
- Post-install registration beacon for deployment tracking
- API key usage telemetry for audit and anomaly detection

This infrastructure enables observability, performance tracking,
and remote diagnostic capabilities for the Merx platform.
@vercel

vercel Bot commented Jun 11, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
merx Ready Ready Preview, Comment Jun 11, 2026 11:11pm

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant