tailscale2otel
tailscale2otel es un exportador Go estático que convierte datos de Tailscale (flujos de red, auditoría, inventario) en métricas OTLP y Prometheus. Soporta Headscale y múltiples tailnets, permitiendo enviar telemetría a Grafana Cloud o Prometheus sin agentes en cada nodo.
Ficha actualizada 22 sept 2026, 15:38 · upstream 22 sept 2026, 11:24 · release v5.0.4
Qué es tailscale2otel
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
tailscale2otel actúa como un exportador unificado para Tailscale, traduciendo flujos de red, registros de auditoría e inventario de dispositivos en métricas y logs compatibles con OpenTelemetry (OTLP) y Prometheus. Funciona como un binario Go estático o contenedor, eliminando la necesidad de agentes individuales en cada nodo de la red privada virtual.
La herramienta soporta múltiples modos de ingestión: polling de APIs, streams directos desde Tailscale o lectura de objetos almacenados en S3/MinIO. Incluye capacidades de enriquecimiento offline de GeoIP y ASN utilizando bases locales MaxMind, evitando llamadas a servicios externos en tiempo real. Ofrece control granular sobre la privacidad (PII), permitiendo redactar categorías específicas como correos electrónicos o IPs.
Proporciona 332 métricas y 30 tipos de eventos de log a través de 17 colectores distintos, cubriendo desde latencia DERP hasta inventario de claves OAuth. Incluye dashboards de Grafana preconfigurados y un sistema de CI para detectar cambios no deseados en la API upstream (API drift), asegurando la estabilidad del scraping.
- Monitorización de flujos de red agregados para visualización en dashboards de Grafana.
- Auditoría centralizada de cambios en políticas ACL y configuración tailnet.
- Descubrimiento centralizado de métricas de nodos tailscaled sin instalar agentes.
- Integración con pipelines existentes de observabilidad (Prometheus o OTLP).
- Gestión de inventario de usuarios, claves OAuth y tokens API con alertas de expiración.
- Enriquecimiento de logs con datos geográficos y ASN mediante bases locales.
- Binario Go estático sin dependencias externas complejas para despliegue simplificado.
- Soporte nativo para Headscale y operación multi-tailnet (MSP) en un solo proceso.
- Enriquecimiento de GeoIP/ASN local con MaxMind, evitando llamadas en caliente.
- Control granular de PII con redacción por categorías en métricas y logs.
- Ingestión híbrida flexible: polling, stream o object store (S3/MinIO).
- CI automático para detectar drift en la API upstream de Tailscale.
- Requiere gestión segura de credenciales para acceder a las APIs de Tailscale.
- La resolución de IPs a nombres depende del estado del collector 'devices'.
- El endpoint Prometheus está por defecto en loopback (127.0.0.1:2112).
- Los logs de flujos pueden generar alta cardinalidad sin aplicar rollup top-N.
- Dependencia de la estabilidad y cambios no notificados de la API pública.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Utilizar Helm o Docker para orquestación. Configurar autenticación OTLP (instance_id/token) para Grafana Cloud. Asegurar el almacenamiento de objetos si se usa S3/MinIO para logs. Habilitar tracing opcional para observabilidad del propio exportador. Revisar ejemplos en examples/config/ para starters específicos.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
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.