Ctrl K
ComunidadGuías…
GITHUB · ANALIZADO

nanotdb

NanoTDB es una base de datos de series temporales en un solo binario con dashboard integrado y CLI offline, optimizada para Raspberry Pi y dispositivos edge.

Ficha actualizada 18 sept 2026, 21:30 · upstream 7 ago 2026, 8:44 · release v1.4.0

Ver códigoProblemas y ayudaRepositorio ↗
00

Qué es nanotdb

Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.

NanoTDB es una base de datos de series temporales (TSDB) monolítica que integra almacenamiento, ingestión, consultas y visualización en un único ejecutable. Diseñada específicamente para entornos con recursos limitados como Raspberry Pi, nodos edge o appliances locales, elimina la necesidad de orquestar múltiples servicios externos.

El sistema incluye un dashboard web nativo con editor integrado para configurar widgets y grupos sin dependencias externas, una vista ad-hoc llamada Explore para consultas rápidas y una línea de comandos (`nanocli`) que permite inspeccionar archivos de datos, exportar a protocolo de línea o reconstruir rollups directamente sobre el directorio de almacenamiento. Los datos se almacenan en archivos `.dat` append-only con un Write-Ahead Log (WAL) para garantizar la recuperación tras fallos de energía.

Destaca por su eficiencia en disco: comprime datos con S2 y particiona automáticamente, logrando menos de 1,3 bytes por punto medido. Incluye un colector opcional llamado `drip` para métricas del propio host (CPU, memoria, temperatura SD). No está diseñado para despliegues distribuidos ni alta cardinalidad multi-tenant.

CASOS DE USO
  • Monitorización local de sensores IoT en Raspberry Pi con dashboard visual sin servidor externo.
  • Almacenamiento histórico de métricas de aplicaciones locales con consultas ad-hoc y exportación offline.
  • Registro de telemetría de hardware (temperatura, carga SD) mediante el colector `drip` integrado.
  • Prototipado rápido de dashboards editables en navegador sin instalar Grafana o Prometheus.
PUNTOS DESTACADOS
  • Single-binary: un ejecutable incluye base de datos, servidor HTTP, dashboard y CLI.
  • Dashboard con editor web nativo para diseñar widgets y grupos sin archivos JSON manuales.
  • Recuperación automática tras caída de energía gracias al WAL y replay en reinicio.
  • Footprint eficiente: ~1 MB/día para 700k puntos comprimidos con S2.
  • CLI `nanocli` permite inspección forense y exportación sin servidor activo.
  • Colector `drip` opcional para métricas del host (CPU, memoria, temperatura).
PRECAUCIONES
  • No soporta despliegues distribuidos ni escalado horizontal.
  • Alta cardinalidad multi-tenant no es el caso de uso previsto.
  • No garantiza orden estricto en escrituras asincrónicas fuera del WAL.
  • Sin soporte nativo para Docker o Kubernetes (requiere binarios directos).
  • Dependencia de Node.js según análisis técnico, aunque README menciona Go.
01

Perfil de infraestructura

Estimación inicial derivada del repositorio y de los servicios detectados.

CPU1 vCPUrecomendación inicial
MEMORIA1 GBRAM estimada
DISCO10 GBalmacenamiento base
COMPLEJIDADlownivel de operación
02

Despliegue detectado

Qué señales reales de instalación hemos encontrado.

Despliegue manual

Descargar binario precompilado para arquitectura objetivo (ej. `nanotdb-linux-arm64`). Iniciar con `./nanotdb --init` y `--config engine.toml`. Escuchar en puerto 8428. Para producción, usar systemd o supervisor. Asegurar permisos de escritura en directorio de datos. Opcional: compilar `drip` para métricas del host.

—Dockerfile
—Compose
—One-click
03

Stack y dependencias

Componentes inferidos a partir de manifests, configuración y documentación.

FRAMEWORKS
Node.js
SERVICIOS
No detectados
BASES DE DATOS
No detectadas
PUERTOS
8428
05

Puede sustituir a

Relaciones detectadas por el análisis del repositorio y su categoría.

06

Experiencia real de la comunidad

Ayuda a contrastar la estimación automática con instalaciones reales.

Todavía no hay datos comunitarios para este proyecto.