iamtelescope/telescope: Web-based log viewer UI. Explore logs data stored in ClickHouse

A handy tool that manages to make close what once was far

Telescope is a web application designed to provide an intuitive interface for exploring log data. It is built to work with any type of logs, as long as they are stored in ClickHouse. Users can easily configure connections to their ClickHouse databases and run queries to filter, search, and analyze logs efficiently. While ClickHouse is the primary supported storage backend, future versions of Telescope may introduce support for additional data sources.

🖼️ More Screenshots

📘 Read the Documentation

💬 Discord

🐳 Run locally using Docker

An live instance is available at https://telescope.humanuser.net.
You can log in via GitHub to explore the core features of the system from an end-user perspective.

• Create and manage multiple connections to different ClickHouse clusters.
• Choose which fields of a table to use and configure which should be suggested, hidden, or support autocompletion.
• Configure which users and groups have access to a source and define their permissions.

• Gain insights into your logs with dynamic visualizations and interactive graphs.
• Customize your view by selecting relevant columns, adjusting data presentation, and applying filters to focus on what matters most.
• Use a time and date selector with support for relative time ranges to refine your log queries effortlessly.
• Enjoy a clean, minimalist design that keeps the focus on your log data, ensuring a seamless and distraction-free analysis experience.

• Authenticate with GitHub, with the ability to enforce organization membership requirements for access control.
• Define and manage user and group permissions to control access to specific sources based on their roles.

Patches are welcome! Feel free to open a pull request.
If you encounter any issues, please create an issue.

Features planned for future implementation:

• Ability to store fields and query presets for easier log searches.
• Grant expert users the ability to write raw SQL WHERE statements.
• Support custom GROUP BY columns for graphs.
• Display records in context.
• Snapshot storage for long-term retention of log records, preventing data loss due to rotation.
• Live log trailing.
• Server-side modifiers (e.g., utilizing ClickHouse functions).
• Time zone support for the datetime selector.
• Helm chart.
• SAML and other authentication methods support.
• Audit log for any changes inside system.

Keep your files stored safely and securely with the SanDisk 2TB Extreme Portable SSD. With over 69,505 ratings and an impressive 4.6 out of 5 stars, this product has been purchased over 8K+ times in the past month. At only $129.99, this Amazon’s Choice product is a must-have for secure file storage.

Help keep private content private with the included password protection featuring 256-bit AES hardware encryption. Order now for just $129.99 on Amazon!

Help Power Techcratic’s Future – Scan To Support

If Techcratic’s content and insights have helped you, consider giving back by supporting the platform with crypto. Every contribution makes a difference, whether it’s for high-quality content, server maintenance, or future updates. Techcratic is constantly evolving, and your support helps drive that progress.

As a solo operator who wears all the hats, creating content, managing the tech, and running the site, your support allows me to stay focused on delivering valuable resources. Your support keeps everything running smoothly and enables me to continue creating the content you love. I’m deeply grateful for your support, it truly means the world to me! Thank you!