We will not respond to PRs or issues that have not been discussed on Discord. Also, Discord is only available in Japanese.

Please read https://github.com/shiguredo/oss/blob/master/README.en.md before use.

利用前に https://github.com/shiguredo/oss をお読みください。

WebRTC Stats Analyzer Kohaku は時雨堂が開発/販売している WebRTC SFU Sora の出力するログを利用して、 WebRTC 統計情報を収集、可視化するソリューションです。

複数のオープンソースやサービスを組み合わせることで実現しています。

• Sora が出力するログを Grafana で可視化することができます
• Docker Compose で簡単に構築できます
• Sora のログを S3 または S3 互換オブジェクトストレージ(以降オブジェクトストレージ)に Fluent Bit で転送します
• ログの保存先をオブジェクトストレージにすることでスケールさせやすい構成になっています
• オブジェクトストレージと DuckDB を利用するだけのため、コストを抑えることができます
• オンプレミスでもクラウドでも利用できます

新しい Kohaku はレガシー版の Kohaku とは互換性がありません。

レガシー版の Kohaku は Sora の統計エクスポーター機能を利用して、 WebRTC 統計情報を収集し、TimescaleDB に保存するゲートウェイでした。

新しい Kohaku は Sora のログを Fluent Bit でオブジェクトストレージに転送し、 それを DuckDB で解析し、Grafana を利用して可視化するソリューションです。

• Fluent Bit
  • Sora のログをオブジェクトストレージに転送します
• RustFS
  • Fluent Bit から転送されてきたログを保存する S3 互換オブジェクトストレージ
• Grafana
  • DuckDB で処理したデータを可視化します
• Grafana DuckDB Data Source Plugin
  • DuckDB で取得したデータを Grafana に渡します
• DuckDB
  • オブジェクトストレージに保存されたログを処理します

• Amazon | S3
• Google Cloud | Cloud Storage
• Cloudflare R2
• Akamai Cloud | Object Storage
• DigitalOcean | Spaces
• Vultr | Object Storage

• WebRTC SFU Sora 2024.2 以降

優先実装とは Sora のライセンスを契約頂いているお客様限定で Kohaku の実装予定機能を有償にて前倒しで実装することです。

詳細は Discord やメールなどでお気軽にお問い合わせください

• 追加の Grafana ダッシュボード

• サポートしません
• アドバイスします
• フィードバック歓迎します

最新の状況などは Discord で共有しています。質問や相談も Discord でのみ受け付けています。

https://discord.gg/shiguredo

Discord へお願いします。

Apache License 2.0

Copyright 2025-2025, Hiroshi Yoshida (Original Author)
Copyright 2025-2025, Shiguredo Inc.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.