Tianji – All‑in‑One Insight Hub

Tianji is a lightweight, self‑hosted platform that unifies the core monitoring and analytics needs of modern web services. Instead of juggling separate tools for traffic analysis, uptime checks, server health, and telemetry, Tianji consolidates these functions into a single, cohesive dashboard. This design reduces operational overhead and provides developers with a unified view of their site’s performance, reliability, and user engagement.

Solving the “Multiple‑Tool” Problem

In typical deployments, teams rely on a mix of services: Google Analytics or Umami for page‑view metrics, Uptime Kuma for availability monitoring, Prometheus for server health, and custom telemetry scripts to gather deployment data. Each tool has its own UI, API, and configuration, leading to fragmented workflows and duplicated effort. Tianji addresses this pain point by offering a unified API surface that exposes website analytics, uptime status, server metrics, and telemetry collection under one roof. Developers can query a single endpoint for all insights, simplifying integration with AI assistants and automated dashboards.

Core Capabilities

• Website Analytics – Collects page‑view, unique visitor, and referrer data with a lightweight tracking script. Supports both server‑side rendering and single‑page applications.
• Uptime & Network Monitoring – Passive reception of monitoring results allows external probes to report availability, latency, and SSL health. The dashboard visualizes uptime trends and alerts on outages.
• Server Status & Prometheus Integration – Exposes server metrics (CPU, memory, disk usage) via a Prometheus‑compatible endpoint. This enables continuous health checks and alerting through familiar tooling.
• Telemetry & Deployment Insight – Gathers minimal deployment metadata (e.g., platform, region) to help operators understand how their instances are used without compromising privacy.
• OpenAPI & Hooks – Provides a formal API contract and webhook support, making it straightforward for AI assistants or CI/CD pipelines to interact programmatically.
• Team Collaboration & Survey – Built‑in mechanisms for inviting team members, collecting feedback, and managing waitlists or surveys directly within the platform.

Real‑World Use Cases

• AI Assistant Integration – An AI assistant can query Tianji’s OpenAPI to fetch real‑time traffic stats, uptime reports, or server health data, enabling context‑aware responses such as “Your site has 3 % downtime this week” or “Page X received the highest traffic last month.”
• Continuous Delivery Pipelines – CI systems can post telemetry data to Tianji, triggering alerts if a new deployment introduces latency spikes or increases error rates.
• Operational Dashboards – Ops teams can embed Tianji widgets in existing dashboards (Grafana, Kibana) to provide a single pane of glass for all performance indicators.
• Lightweight Hosting – Small teams or hobby projects can deploy Tianji via Helm, Sealos, or Render with a single command, eliminating the need to maintain multiple monitoring services.

Integration Flow

1. Deployment – Install Tianji using Helm, Docker, or cloud‑specific one‑click deployers.
2. Instrumentation – Add the tracking script to web pages; configure probes for uptime checks and Prometheus exporters.
3. API Consumption – AI assistants or custom applications query the OpenAPI endpoints to retrieve analytics, health, and telemetry data.
4. Automation – Use webhooks or hooks to trigger actions (e.g., send Slack alerts when uptime falls below 99.9%).

Unique Advantages

• Unified API – A single, well‑documented endpoint surface replaces multiple disparate services.
• Lightweight Footprint – Designed for quick deployment and low resource consumption, making it ideal for small teams or edge environments.
• Open Source & Extensible – Apache 2.0 licensed with clear hooks for extending functionality (e.g., custom UTM tracking, survey pages).
• Community‑Driven Roadmap – Features such as Helm support, waitlist management, and telemetry are already in production, with a transparent roadmap for future enhancements.

Tianji empowers developers to monitor and analyze their web presence without the complexity of managing multiple tools, enabling smarter AI integrations and more efficient operational workflows.