Changelog

Version: 0.0.26

Changes:

• StarRocks source support: Added support for querying logs from StarRocks databases, including TLS connections, external catalogs, and query hints. Thanks to plangdale-roblox!
• Bugfix: Fixed base_url handling — removed absolute fetch calls to allow relative fetches from custom base URLs. Thanks to Toocky!
• Bugfix: Fixed FlyQL to_sql call using legacy fields instead of columns for ClickHouse sources

Related issues:

• ISSUE-92

Notes:

Version: 0.0.25

Changes:

• Bugfix: Fixed FlyQL filtering for ClickHouse sources
• Bugfix: Fixed base_url handling (#92)

Version: 0.0.24

Changes:

• Kubernetes log source support: Added support for querying logs for pods and containers directly from Kubernetes API. Thanks to Toocky for initial implementation!
• FlyQL syntax update: Dot notation for JSON paths, in/not in operators, truthy/falsy checks - see Query Input documentation for details
• Bugfix: Fixed datetime range picker bug - see https://github.com/iamtelescope/telescope/issues/68

Notes:

Motivation for changing JSON path syntax

• Dot notation (.) is the standard path separator in most query languages and JSON path specifications (JSONPath, jq, etc.), making FlyQL more intuitive for users familiar with these tools.
• Colon notation (:) was non-standard and could be confused with other syntax elements like namespacing or key-value pairs in Kubernetes contexts.
• The change aligns FlyQL with common conventions, reducing the learning curve and improving readability of complex queries.

Related issues:

• ISSUE-73
• ISSUE-71

Related documentation:

• Kubernetes log source setup guide
• Query Input - FlyQL changes

Version: 0.0.23

Changes:

• Okta authentication support: Added OAuth 2.0 integration with Okta
  • Support for PKCE (Proof Key for Code Exchange) for enhanced security
  • Configurable OAuth scopes
  • Automatic user group assignment upon first login
  • Configurable Okta base URL for different Okta tenants
• Emergency local login: Added local_login_secret_path for backdoor local authentication when forced SSO is enabled (e.g., /login/emergency-abc123)
• UI improvements:
  • Username truncation in sidebar with tooltip for long usernames/emails (>20 characters)
  • Added logout button to user profile page
  • Display authentication provider (local/github/okta) under username in sidebar
• Configuration enhancements:
  • Explicit SECURE_PROXY_SSL_HEADER configuration support for HTTPS detection behind proxies

Related documentation:

• Authentication & Authorization
• Configuration Options

Version: 0.0.22

Changes:

• Added support for setting base_url to put telescope behind reverse proxy with custom URL prefixes. Thanks to Toocky!

Related issues:

• ISSUE-29

Version: 0.0.21

Changes:

• Connection Separation: Connections are now independent, reusable entities separate from Sources
  • Connections can be shared across multiple sources
  • Database and table specifications moved from Connection to Source configuration (ClickHouse only)
  • Independent RBAC permission models for Connections and Sources
  • Connection roles: Owner, Editor, Viewer, User
  • Connections cannot be deleted while in use by sources
• Layout Redesign: Replaced two-pane layout with collapsible left sidebar navigation
• Datetime picker now supports timezone selection. Thanks to patridu!

Related issues:

• ISSUE-33

Version: 0.0.20

Changes:

• Bugfix: ca_certs missing parameter for clickhouse-connect (#50)

Version: 0.0.19

Changes:

• Telescope has migrated to clickhouse-connect and now communicates with ClickHouse server exclusively over the HTTP(S) interface.
• Support for the native protocol (clickhouse-driver) has been removed.
• JSON ClickHouse data type is now supported
• FlyQL now supports whitespace around operators. Expressions like key = value are valid now (previously only key=value was allowed).
• FlyQL now supports typed keys, such as jsonfield.user-agent = 'firefox'.
• FlyQL now supports quoted JSON paths to handle special characters like dots. Example: jsonfield.'my.key.with.dots'.path = 123.

Notes:

Motivation for dropping native protocol support

• clickhouse-connect is the officially supported driver by ClickHouse Inc., ensuring long-term support and faster access to new ClickHouse features.
• In Telescope’s workload profile — primarily log browsing and filtering — the performance difference for SELECT queries is negligible, as result sets are typically small (≤10,000 rows).
• Simplifies deployment by eliminating native dependencies and improves compatibility with managed environments and cloud infrastructure.

Version: 0.0.18 Changes:

• Implemented saved views
• Small bugfixes & improvements

Related issues:

• ISSUE-3

Notes:

Version: 0.0.17 Changes:

• Implemented token-based authentication (API tokens) as a foundation for future API access
• Bugfixed data section border misalignment in the Explorer. Thanks to meirdev!

Related issues:

• ISSUE-24

Notes:

Version: 0.0.16 Changes:

• Added various options for SSL-based ClickHouse connections
• Added the ability to disable authentication via the config file

Notes:

Version: 0.0.15 Changes:

• Added Docker as a new source kind
• Redesigned source list
• Added toggle to show/hide filters on the explorer page
• Fixed bug in date range selector when using the graph
• Fixed bug where the show/hide graph option wasn’t preserved on reload

Notes:

Version: 0.0.14

Changes:

• The source time field now supports UInt64, Int64, and timestamp ClickHouse types. Thanks to Zerg1996!

Related issues:

• ISSUE-13

Version: 0.0.13

Changes:

• Added config option to force github authentication on login page

Version: 0.0.12 Changes:

• Explorer UI update: query settings and chart settings have been moved into separate dropdown menus to improve usability and reduce interface clutter.
• Added a placeholder for the raw query editor and made various style adjustments

Version: 0.0.11 Changes:

• Added support for raw SQL WHERE statements

Related issues:

• ISSUE-5

Version: 0.0.10 Changes:

• Added support for custom fields in the “Group By” option on graphs.
• Changed data loading behavior: now, when making a new request, the old data remains on the screen until the new data is fully loaded.
• Bugfix for a mismatch between time values in graphs and data tables (caused by differences between UTC and non-UTC timestamps).

Related issues:

• ISSUE-4

Notes:

Version: 0.0.9

Changes:

• Make the source severity field optional.

Related issues:

• ISSUE-6

Version: 0.0.8

Changes:

• Bugfix for non-UTC time fields in ClickHouse
• Bugfix for specifying time with histogram range selection

Version: 0.0.7

Changes:

• Cosmetic login screen update.

Version: 0.0.6

Changes:

• Fixed monaco editor static files.

Version: 0.0.5

Changes:

• Fixed a bug inside fields parser.
• Updated modifiers docs.
• Added naive support for Map & Array ClickHouse types.
• Added new modifiers:
  • href, for dynamically creating HTML links.
  • format, for pretty formatting of SQL or JSON data.
  • highlight, for syntax highlighting of SQL or JSON data.

Version: 0.0.4

Changes:

• Fixed default JSON renderer to handle unserializable objects properly.

Version: 0.0.3

Changes:

• Added placeholders for fields and query inputs based on source fields.

Version: 0.0.2

Changes:

• Initial release