Tianji
Tianji combines website analytics, an uptime monitor and server status in one application.
- Verified facts
- 8
- Offers
- 1
- Sources
- 4
- Pricing
- Free offer
Overview
Three tools in one
Tianji combines website analytics, an uptime monitor and server status reporting in one application. The README's motivation is practical: instead of running an analytics tool such as Umami, a separate uptime monitor and Prometheus for server status, users with lightweight needs can install one service. It also covers telemetry for open-source projects that want basic information about other people's deployments.
The roadmap marks website analysis, monitoring, server status, problem notifications, telemetry, an OpenAPI, team collaboration, UTM tracking, a waitlist, surveys, Lighthouse reports, hooks and Helm installation as done. A dedicated survey page is still open.
Read the full editorial overview
Who it suits, and setup
The README is frank about its target: specialised tools still make sense for experts, but most users with lightweight needs will find an all-in-one application easier. Teams that need deep analytics or full observability should test it against their own requirements first.
The included Docker Compose stack starts the Tianji application and a PostgreSQL database, and the README links one-click deployment templates for several hosting providers. Running from source needs, at minimum, a PostgreSQL connection string for the server.
Licence and maintenance
Tianji is open source under the Apache 2.0 licence. The msgbyte/tianji repository was not archived when captured on 5 November 2026, and v1.33.14 was released on 4 November 2026. When checked again on 8 November 2026 the repository was still not archived and v1.34.1 had been released that day; the tracker script, API and environment-variable documentation was captured at that release.
No installation, monitoring or analytics accuracy test was carried out. The README describes no hosted plan and lists no server requirements beyond PostgreSQL, so sizing and hosting costs are not established.
Sources
Tianji: tianji-project · Evidence: documentation · Not checked
Plans & prices
Prices as listed by Tianji, before any tax or fee the pricing page does not state.
Scroll the table sideways for every column.
| Plan | Rate period not stated |
|---|---|
| Plan: Self-hosted | FreeTax: Confirm at checkoutUpfront: not established ConditionsDated publisher project README captured on 5 November 2026; supplier description, not a deployment or independent test. Infrastructure, accounts, third-party services and managed offerings have separate costs and terms. Applies to the Apache 2.0 self-hosted software; one-click hosting templates from third-party providers carry their own costs, which were not captured. |
Documented facts
Each fact comes from official documentation and shows when it was verified.
Who it is for
Tianji combines website analytics, an uptime monitor and server status in one application.
Coverage limits
Tianji is positioned for users with lightweight needs; the README says specialised tools still make sense for experts.
Events
Click events are recorded by adding a data-tianji-event attribute to a page element; extra event data can be attached with data-tianji-event-{key} attributes.
Tianji documentation in msgbyte/tianji at release v1.34.1, captured on 8 November 2026 (Tracker Script page). The same page documents automatic page-view tracking (data-auto-track, on by default) and a window.tianji.track() JavaScript API for custom events. Supplier documentation, not a hands-on test.
Retention
Self-hosted Tianji runs an automatic data cleanup by default (DISABLE_AUTO_CLEAR defaults to false) and keeps audit logs for 30 days by default (AUDIT_LOG_RETENTION_DAYS).
Tianji documentation in msgbyte/tianji at release v1.34.1, captured on 8 November 2026 (Environment Variables page). Which data the automatic cleanup removes, and after how long, is not stated there; DISABLE_AUTO_CLEAR=true turns it off. Not a hands-on test.
Privacy
The tracker script's optional data-do-not-track attribute makes it respect the browser's Do Not Track setting and disable tracking when DNT is enabled.
Tianji documentation in msgbyte/tianji at release v1.34.1, captured on 8 November 2026 (Tracker Script page). The attribute is optional and has no listed default, so Do Not Track is honoured only when it is set; the page also documents a localStorage flag (tianji.disabled) that disables tracking. No privacy audit or legal-compliance finding.
Exports
Tianji provides a REST API (JSON over HTTPS, authentication required) for programmatic access to its features, including website analytics data.
Tianji documentation in msgbyte/tianji at release v1.34.1, captured on 8 November 2026 (API Getting Started page). Access uses an API key and the ALLOW_OPENAPI setting. A file export (CSV or JSON download) is not established by this page, and no API call was made.
Sites
Tianji's website list provides the tracker snippet, a script under 2 KB that identifies the site with a data-website-id attribute.
Tianji documentation in msgbyte/tianji at release v1.34.1, captured on 8 November 2026 (Tracker Script page). No limit on the number of websites is stated for the self-hosted software; an optional data-domains attribute restricts tracking to listed domains. Not a hands-on test.
Applies to the facts above: Dated publisher project README captured on 5 November 2026; supplier description, not a deployment or independent test. Infrastructure, accounts, third-party services and managed offerings have separate costs and terms.
Not confirmed in our sources
We have not confirmed these terms for Tianji in the linked documentation. That does not mean Tianji lacks them; confirm them before you rely on them.
- Projects
Sources & methodology
Facts come from the linked documentation. Documentation checks are not hands-on tests, and readable sources can have incomplete coverage.
Discovered an undocumented discrepancy or pricing shift? Submit a correction request.
Submit correctionTianji alternatives
Other analytics tools to weigh. Different billing units do not establish a cost winner, so compare plans side by side.
Plausible Analytics
Analytics
Website analytics with a compact dashboard, goals and custom events. · Evidence needs recheck
Documented price9.00/mo (currency not stated)Price needs recheckPrice terms
Documented price: 9.00/mo (currency not stated) · Plan: Starter · commitment not established
Fathom Analytics
Analytics
Website analytics with pageviews, custom events, campaign tracking and reports. · Evidence needs recheck
Documented price$15/moPrice needs recheckPrice terms
Documented price: $15/mo · Plan: 100,000 monthly pageviews · commitment not established
PostHog
Analytics
Analytics based on events, alongside separately metered replay, feature flags and other products. · Evidence needs recheck
Documented price$50 per 1,000,000 headline analytics events in the 1–2M monthly tier overagePrice needs recheckPrice terms
Documented price: $50 per 1,000,000 headline analytics events in the 1–2M monthly tier overage · Plan: Pay-as-you-go · no minimum commitment
Tianji comparisons
Compare two products in the same category using their documented terms and sources.
- Tianji vs Ackee
- Tianji vs Aptabase
- Tianji vs Cloudflare Web Analytics
- Tianji vs Countly
- Tianji vs Fathom Analytics
- Tianji vs GoAccess
- Tianji vs GoatCounter
- Tianji vs Liwan
- Tianji vs Matomo
- Tianji vs Medama
- Tianji vs Offen Fair Web Analytics
- Tianji vs OpenPanel
- Tianji vs OpenReplay
- Tianji vs Open Web Analytics
- Tianji vs Plausible Analytics
- Tianji vs PostHog
- Tianji vs Rybbit Cloud
- Tianji vs Swetrix
- Tianji vs Pirsch Analytics
- Tianji vs Umami