Tianji | Analytics + Uptime Monitor + Server Status | Docker

Tianji: Plataforma all-in-one de análisis, monitoreo de uptime y estado de servidor

Una solución ligera y completa: Google Analytics alternativa + monitoreo de uptime + estado de servidor. Todo en una sola aplicación autohospedada.

¿Qué es Tianji?

Tianji es una plataforma all-in-one de código abierto que integra tres funcionalidades cruciales: análisis de sitios web (alternativa a Google Analytics), monitoreo de uptime y estado de servidor. Inspirado en Umami (análisis) y Uptime Kuma (monitoreo), Tianji combina lo mejor de ambos en una sola aplicación ligera y auto-hospedada.

La idea central de Tianji es sencilla pero poderosa: la mayoría de usuarios no necesitan herramientas ultra-especializadas. Instalar Umami para analytics, Uptime Kuma para monitoreo, Prometheus para métricas... eso es demasiada complejidad. Tianji ofrece todo lo que necesitas en una sola aplicación elegante, GDPR/CCPA compliant, con API completa y soporte multilingüe.

Filosofía all-in-one ligero: No necesitas 5 servicios para monitorear tu infraestructura. Todo lo que necesita un desarrollador independiente o pequeño equipo, en una sola caja.

Características principales

Análisis de sitios web

Alternativa a Google Analytics. Tracking de páginas, usuarios, conversiones sin Google.

Monitoreo de uptime

Monitorea HTTP, TCP, DNS. Alertas en tiempo real cuando servicios caen.

Estado de servidor

Dashboard de salud del servidor: CPU, RAM, disco, procesos, temperatura.

Scripts personalizados

Monitorea cualquier cosa con JavaScript personalizado para lógica compleja.

Notificaciones multi-canal

Email, Slack, Discord, Telegram, Webhook. Alertas configurables por monitor.

Panel público/privado

Crea páginas de estado públicas para compartir con clientes o equipo.

API REST completa

Acceso programático a todos los datos y funcionalidades.

GDPR/CCPA compliant

Privacidad de datos garantizada. Sin tracking corporativo oculto.

Múltiples idiomas

Interfaz soporta decenas de idiomas incluyendo español.

Insight builder

Crea queries personalizadas y insightsde tus datos de análisis.

ClickHouse soportado

Alternativa a PostgreSQL para analítica de alto volumen.

Open Source

Apache 2.0. Completamente auditable y personalizable.

Requisitos del sistema

Docker y Docker Compose instalados
PostgreSQL 12+ (en contenedor)
2 GB de RAM mínimo (4+ GB recomendado)
10+ GB de espacio en disco según volumen de datos
Puerto 80 o 8080 disponible
Opcional: ClickHouse para analítica de alto volumen

Instalación rápida con Docker Compose

Paso 1: Descargar docker-compose.yml

wget https://raw.githubusercontent.com/msgbyte/tianji/master/docker-compose.yml

Paso 2: Iniciar Tianji

docker compose up -d

Paso 3: Acceder a Tianji

Abre http://localhost:8080 en tu navegador.

Credenciales por defecto:

Usuario: admin
Contraseña: admin

Seguridad: Cambia la contraseña del administrador inmediatamente después del primer acceso.

Docker Compose completo (personalizado)

version: '3.8' services: tianji: image: moonrailgun/tianji:latest container_name: tianji restart: unless-stopped ports: - "8080:8080" environment: - DATABASE_URL=postgresql://postgres:postgres@postgres:5432/tianji - JWT_SECRET=cambiar-esto-a-secreto-aleatorio - TZ=Europe/Madrid depends_on: - postgres volumes: - tianji-data:/app/data postgres: image: postgres:16 container_name: tianji-postgres restart: unless-stopped environment: - POSTGRES_DB=tianji - POSTGRES_USER=postgres - POSTGRES_PASSWORD=postgres volumes: - postgres-data:/var/lib/postgresql/data volumes: tianji-data: postgres-data:

Primeros pasos

1. Cambiar contraseña de admin

Inicia sesión con admin/admin
Ve a Settings → Account
Cambia la contraseña

2. Crear primer monitor HTTP

Ve a Monitor
Haz clic en Add Monitor
Configura:
- Name: Mi sitio
- URL: https://midominio.com
- Type: HTTP
- Interval: 60 segundos
Haz clic en Create

3. Añadir tracking de analytics

Ve a Websites
Añade tu dominio
Copia el código de tracking
Inserta en el <head> de tu sitio

4. Crear página de estado pública

Ve a Status Page
Crea una nueva página
Selecciona monitores a mostrar
Obtén URL pública para compartir

Configurar notificaciones

Integración con servicios

Tianji soporta notificaciones a través de:

Email: SMTP configurable
Slack: Webhook de Slack
Discord: Webhook de Discord
Telegram: Bot Token
Webhook: HTTP POST a URL personalizada

Recomendación: Usa Discord o Slack para alertas de development, Email para notificaciones importantes.

Usar el análisis de sitios web

Incorporar tracking en tu sitio

Tianji genera automáticamente un script. Solo añade esto en tu sitio:

Datos capturados automáticamente

Vistas de página y rutas
Usuarios únicos
Dispositivos (móvil, desktop)
Navegadores y sistemas operativos
Geolocalización
Fuentes de tráfico (referrer)

Eventos personalizados

Trackea conversiones y eventos personalizados:

window.telemetryEvent?.('event-name', { goal: 'compra', value: 99.99 })

Configurar HTTPS con Caddy

tianji.tudominio.com { reverse_proxy localhost:8080 }

Caddy genera automáticamente certificados Let's Encrypt.

Gestión y mantenimiento

Ver logs

docker compose logs -f tianji

Reiniciar Tianji

docker compose restart tianji

Detener todo

docker compose down

Actualizar a la última versión

docker compose pull docker compose up -d

Backup de base de datos

docker compose exec postgres pg_dump -U postgres tianji \ > tianji-backup-$(date +%Y%m%d).sql

Casos de uso

Desarrolladores independientes: Una solución para todo sin complejidad
Agencias digitales: Monitoreo de múltiples sitios de clientes
SaaS: Analytics + uptime + status page para clientes
Startups: Alternativa económica a soluciones corporativas
Empresas privadas: Analytics sin enviar datos a Google
Sitios con GDPR/CCPA: Cumplimiento regulatorio garantizado

Referencias oficiales

Apoya el canal GENBYTE

Suscríbete al canal de YouTube Suscríbete a la newsletter semanal Invítame a un Ko-fi genbyte@proton.me

Cómo instalar Tianji en Docker - Plataforma all-in-one de análisis, monitoreo y estado en Docker