概要

Telescopeは、開発者や運用担当者向けにシンプルかつ効率的なログ閲覧体験を提供することに特化した新しいオープンソースのログ閲覧ツールです。巨大なエンタープライズログプラットフォームとは異なり、Telescopeのデザイン哲学は「軽量・高速・簡単デプロイ」です。Python + Vue.jsの技術スタックを採用し、シングルページアプリケーションとしてスムーズなログ検索とフィルタリング機能を提供します。

プロジェクト概要

属性内容
GitHubiamtelescope/telescope
Stars653
言語Python(バックエンド)+ Vue.js(フロントエンド)
ライセンスMIT
主な用途ログ閲覧、オブザーバビリティ、トラブルシューティング
最終更新2日前

解決する課題

ログ管理の領域では、開発者はしばしば二つの選択肢の間で悩まされます:

  1. SaaSソリューションは高すぎる —— DatadogやSplunkなどは機能が充実していますが価格が高く、小規模チームには負担が大きい
  2. オープンソースソリューションは重すぎる —— ELKスタックやGrafana Lokiなどは無料ですが、デプロイと運用コストが高い
  3. 自作スクリプトは簡素すぎる —— grep/awkでのログ処理は効率が悪く、複数人での共同作業も困難

Telescopeはこの隙間を埋めることを目指しています:モダンなWebアプリケーションの操作性を保ちつつ、十分にシンプルで迅速にデプロイできるログビューアを提供します。

主な機能

マルチソース対応

Telescopeは現在、3種類のログデータソースをサポートしています:

  • ClickHouse —— 高性能な列指向データベース、大量の構造化ログの保存に適している
  • Kubernetes —— Podログを直接読み取り、追加設定不要
  • Docker —— リアルタイムでコンテナログストリームを閲覧可能

技術的ハイライト

機能説明
セルフホスト完全にオープンソース、データは第三者に送信されない
軽量単一プロセスで実行、リソース消費が極めて低い
リアルタイムストリーミングtail -fのようなリアルタイムログ配信をサポート
フィルタリング検索フィールドフィルタリング、全文検索に対応
時間範囲プリセットの時間範囲のクイック選択またはカスタム範囲指定

プロジェクトアーキテクチャ

┌─────────────────┐
│   Vue.js SPA    │  ← フロントエンド
│  (ユーザー層)    │
└────────┬────────┘
         │ APIリクエスト
┌────────▼────────┐
│   Django API    │  ← バックエンド
│  (Python 3.11+) │
└────────┬────────┘
         │ クエリ
┌────────┴────────┐
│  ClickHouse /   │
│  K8s API /      │  ← データソース
│  Docker Daemon  │
└─────────────────┘

適用シナリオ

Telescopeは特に以下のシナリオに適しています:

  • 中小規模チーム —— シンプルで使いやすいログ閲覧ソリューションが必要で、大きな運用コストをかけたくない場合
  • 開発デバッグ —— ローカルまたはテスト環境でアプリケーションログを迅速に確認したい場合
  • ClickHouseユーザー —— ログをClickHouseに保存しており、軽量なクエリインターフェースが必要な場合
  • エッジデプロイメント —— リソースが制限された環境で、完全なELKスタックを実行できない場合

使用体験

Telescopeのデプロイは非常に簡単で、公式が提供するDocker Composeでワンコマンドで起動できます:

git clone https://github.com/iamtelescope/telescope.git
cd telescope
docker-compose up -d

フロントエンドインターフェースはモダンなダークテーマを採用し、レイアウトも明確です。左側にデータソース切り替えとフィルター、右側にログコンテンツエリアがあります。ログエントリは展開して完全なJSONを表示でき、タイムスタンプは自動的にローカルタイムゾーンに変換されます。

類似ツールとの比較

ツールStarsポジショニング特徴
Telescope653軽量ログビューアシンプル、セルフホスト、ClickHouse対応
Dozzle12k+DockerログビューアDockerに特化、Webインターフェース
GoAccess20k+ログアナライザリアルタイムWeb分析レポート
hl2.9k+コマンドラインログプロセッサRust製、高性能

Telescopeの優位性は、マルチデータソース対応とモダンなオブザーバビリティスタックへの適合性、特にClickHouseのネイティブ統合にあります。

発展の見通し

2024年末に作成された新しいプロジェクトとして、Telescopeは良い発展の勢いを見せています:

  • コードの更新が頻繁で、メンテナンスが活発
  • Issueへの対応が迅速で、コミュニティの雰囲気が良好
  • 技術スタックの選定がモダン(Python 3.11+、Vue 3、Vite)

今後注目すべき方向性には、より多くのデータソース対応(Elasticsearch、Lokiなど)、アラートルールの設定、ログ可視化チャートなどが含まれます。

まとめ

Telescopeは注目に値する新興ツールです。中小規模チームがログ閲覧において直面する課題——SaaSに課金したくないが、複雑なオープンソースソリューションのメンテナンスもしたくない——を的確に捉えています。ClickHouseでログを保存している場合や、軽量なKubernetesログビューアが必要な場合、Telescopeは試す価値があります。


プロジェクトアドレス:https://github.com/iamtelescope/telescope
公式サイト:https://iamtelescope.net