# telescope

> Telescope is a self-hosted, open-source web app for exploring logs from ClickHouse, StarRocks, Docker, and Kubernetes with RBAC and SQL querying.

- **Category:** Log Management
- **Licence:** MIT
- **Latest version:** v0.0.27
- **Open source:** oss
- **Languages:** Python, Vue
- **Platforms:** Docker
- **Tags:** Analytics, Clickhouse, Visualization, OAuth, SQL, Spa, Logging, Observability, Rbac, Kubernetes, Docker, Web, Django, Vue.js, Self Hosted, Logs, Log Viewer, O11y, GitHub, K8s, Telescope, Starrocks, Okta

## Description

Telescope is a web-based log viewer UI that provides a unified interface for exploring log data stored in ClickHouse, StarRocks, Docker, and Kubernetes. It supports multiple data source connections with configurable field mappings, autocompletion, and role-based access control per source. Users can filter and search logs using structured filters or raw SQL WHERE clauses, visualize data with interactive charts grouped by any field including nested JSON, and save filter presets as shared views. Authentication supports local username/password, GitHub OAuth with organization restrictions, and Okta OAuth with PKCE. The application runs as a Docker container (ghcr.io/iamtelescope/telescope) on port 9898 with a SQLite database for its own metadata, while log data lives in the external sources. It is currently in beta (version 0.0.27) with breaking changes between releases requiring database migrations.

## Links

- [Homepage](https://github.com/iamtelescope/telescope)
- [Website](https://iamtelescope.net)
- [Docker](ghcr.io/iamtelescope/telescope)
- [Documentation](https://docs.iamtelescope.net/)
- [Telegram](https://t.me/+CGnCz48GF8xmY2Yy)
- [YouTube](https://www.youtube.com/watch?v=5IItMOXwugY)
- [GitHub](https://github.com/iamtelescope/telescope)
- [Changelog](https://docs.iamtelescope.net/changelog/)

---
Source: https://selfhost.directory/project/telescope