Changelog

2025.11.07

Version: 0.0.23

Danger

This release contains a bug in datetime range picker, see https://github.com/iamtelescope/telescope/issues/68

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

Configuration breaking change

The force_github_auth configuration option has been removed and replaced with force_auth_provider to support multiple OAuth providers.

Migration required: if you are using force_github_auth: true, you must update your configuration to force_auth_provider: "github".

Related documentation:

• Authentication & Authorization
• Configuration Options

2025.11.06

Version: 0.0.22

Danger

This release contains a bug in datetime range picker, see https://github.com/iamtelescope/telescope/issues/68

Changes:

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

Related issues:

• ISSUE-29

2025.11.04

Version: 0.0.21

Danger

This release contains a bug in datetime range picker, see https://github.com/iamtelescope/telescope/issues/68

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

Caution

This release requires database migrations to be run.

2025.07.04

Version: 0.0.20

Changes:

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

Caution

This release requires database migrations to be run.

2025.06.26

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 colons. Example: jsonfield:'my:key:with:colon':path = 123.

Notes:

Caution

After this update, all ClickHouse sources must use HTTP(S) ports.
Telescope no longer supports the native ClickHouse protocol.
All existing sources must be manually reconfigured to use an HTTP(S) endpoint (typically port 8123 for HTTP and 8443 for HTTPS).
Failure to do so will result in connection errors.

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.

2025.05.18

Version: 0.0.18 Changes:

• Implemented saved views
• Small bugfixes & improvements

Related issues:

• ISSUE-3

Notes:

Caution

This release requires database migrations to be run.

2025.04.20

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:

Caution

This release requires database migrations to be run.

2025.04.08

Version: 0.0.16 Changes:

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

Notes:

Caution

This release requires database migrations to be run.

2025.04.01

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:

Caution

This release requires database migrations to be run.

2025.03.19

Version: 0.0.14

Changes:

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

Related issues:

• ISSUE-13

2025.03.15

Version: 0.0.13

Changes:

• Added config option to force github authentication on login page

2025.03.11

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

2025.03.10 +

Version: 0.0.11 Changes:

• Added support for raw SQL WHERE statements

Related issues:

• ISSUE-5

2025.03.10

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:

Caution

This release requires database migrations to be run.

2025.02.27

Version: 0.0.9

Changes:

• Make the source severity field optional.

Related issues:

• ISSUE-6

2025.02.24

Version: 0.0.8

Changes:

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

2025.02.19

Version: 0.0.7

Changes:

• Cosmetic login screen update.

2025.02.18

Version: 0.0.6

Changes:

• Fixed monaco editor static files.

2025.02.17

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.

2025.02.13

Version: 0.0.4

Changes:

• Fixed default JSON renderer to handle unserializable objects properly.

2025.02.13

Version: 0.0.3

Changes:

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

2025.02.12

Version: 0.0.2

Changes:

• Initial release