Tianji

What is Tianji about?

Tianji combines website traffic analysis, uptime checks, and server health reporting into an all‑in‑one insight hub for lightweight monitoring needs.

How to use Tianji?

• Docker: Pull the image moonrailgun/tianji and run the container, exposing the desired ports.
• Helm: Add the public Helm chart and install with helm install tianji <chart-repo>.
• One‑click cloud deployments: Use the provided buttons for Sealos, Render, RepoCloud, or ClawCloud.
• Local development: Clone the repo, install dependencies with pnpm install, then start the client/server with the scripts defined in package.json.

Key Features

• Real‑time website analytics (page views, unique visitors, referrers)
• Passive result reception for uptime monitors
• Server status dashboard with customizable health checks
• Notification hooks for alerts and problem reporting
• Telemetry collection for deployment insights
• OpenAPI for extensibility
• Team collaboration tools, waitlist, surveys, and Lighthouse reports
• Multi‑language UI with easy translation workflow
• Helm chart and Docker image for simple deployment

Use Cases

• Small SaaS products needing quick insight without multiple services
• Self‑hosted blogs or portfolios that want basic traffic stats and uptime alerts
• Internal tools for monitoring micro‑service health in a lightweight stack
• Open‑source projects wanting telemetry on deployments
• Teams that require a shared dashboard for site performance and server reliability

FAQ

• Do I need a separate analytics service? No, Tianji provides built‑in analytics alongside monitoring.
• Can I integrate existing Prometheus exporters? Yes, server status can be extended via custom health endpoints.
• Is there a free tier for cloud deployments? The one‑click deployment options use the hosting provider’s free tier where available.
• How is data stored? By default Tianji uses SQLite; you can switch to PostgreSQL via environment configuration.
• Can I customize alert channels? Yes, webhook, email, and Slack integrations are supported through the hooks feature.

Tianji

All-in-One Insight Hub

Website analytics + Uptime Monitor + Server Status = Tianji

All in one project!

Motivation

During our observations of the website. We often need to use multiple applications together. For example, we need analysis tools such as GA/umami to check pv/uv and the number of visits to each page, we need an uptime monitor to check the network quality and connectivity of the server, and we need to use prometheus to obtain the status reported by the server to check the quality of the server. In addition, if we develop an application that allows open source deployment, we often need a telemetry system to help us collect the simplest information about other people's deployment situations.

I think these tools should serve the same purpose, so is there an application that can integrate these common needs in a lightweight way? After all, most of the time we don't need very professional and in-depth functions. But in order to achieve comprehensive monitoring, I need to install so many services.

It's good to specialize in one thing, if we are experts in related abilities we need such specialized tools. But for most users who only have lightweight needs, an All-in-One application will be more convenient and easier to use.

Roadmap

• website analysis
• monitor
  • support passive reception of results
• server status
• problem notification
• telemetry
• openapi
• website
• team collaboration
• utm track
• waitlist
• survey
  • survey page
• lighthouse report
• hooks
• helm install support
  • allow install from public
• improve monitor reporter usage
  • uninstall guide
  • download from server
  • custom params guide

Preview

Translation

Add a new translation

modify those file:

• src/client/i18next-toolkit.config.cjs in this file, edit country code
• src/client/utils/i18n.ts in this file, add for display

Then, run below code to auto generate

cd src/client
pnpm install
pnpm run translation:extract
pnpm run translation:translate # this will call chatgpt to run auto translation, so you need set env `OPENAPI_KEY` to make sure run correct

Then manual check translation file in src/client/public/locales

Improve translation

Direct update src/client/public/locales

Open Source

Tianji is open source with Apache 2.0 license.

And its inspired by umami license which under MIT and uptime-kuma which under MIT license too

One-Click Deployment