ongridio/ongrid

An ops AI Agent that understands your infrastructure, finds the root cause, and fixes it — right from Slack, Telegram, Lark or DingTalk.

📌 Ongrid とは?

Ongrid は、インフラストラクチャ内に常駐するオープンソースの AI 搭載オペレーションアシスタント です。Slack、Telegram(およびその他のメッセンジャー)に接続し、質問したりアラートに反応したりできます。舞台裏では、一連の コーディネーターエージェントとスペシャリストエージェント が大規模言語モデルを使用して、以下を実行します。

  • ホスト、コンテナ、ネットワークデバイスのトポロジーを発見する、
  • メトリクス、ログ、トレースを関連付けてインシデントの根本原因を特定する、
  • 具体的な修復手順を提案する、そして
  • 承認ゲートを通過した後、安全で監査済みのコマンド(例:リバーストンネル SSH シェル)をオプションで実行する。

このプラットフォームは、バックエンドに Go、UI に TypeScript/React を使用して構築されており、完全な可観測性スタック(Prometheus、Loki、Tempo、Grafana)が同梱されています。Anthropic、OpenAI、Gemini、DeepSeek など、API を提供する任意の LLM をプラグインできます。


🚀 コア機能(README に記載されているもの)

機能 説明
コーディネーター + スペシャリストエージェント 中央ディスパッチャーがリクエストをドメイン固有のサブエージェント(SRE、ネットワーキング、データベースなど)にルーティングします。
アラート時の自動調査 アラートが発生すると、調査エージェントが自動的に根本原因分析(RCA)を開始し、結果をチャットに投稿します。
根本原因 RCA 発見されたトポロジーをトラバースし、メトリクス/ログ/トレースを関連付け、問題の原因となった正確なコード行または設定を指し示します。
インバウンドポートゼロ エッジエージェントはアウトバウンド接続のみを開始します。ホストで SSH/HTTP ポートを開く必要はありません。
ブラウザ SSH 完全に監査され、Web UI からアクセスできる、リバーストンネル、キーレスシェルを提供します。
ワンコマンドセルフホスト install.sh がスタック全体(バックエンド、UI、可観測性)をワンステップでプロビジョニングします。
組み込みの可観測性 Prometheus、Loki、Tempo、Grafana が事前配線されています。エージェントはメトリクス、ログ、トレース用の独自クエリを作成します。
モデル持ち込み Anthropic、OpenAI、GLM、DeepSeek、Gemini、Kimi をサポートし、プロバイダー間のホットルーティングを備えています。
双方向 IM チャネル Slack、Telegram、Larksuite、DingTalk、WeCom、および汎用 Webhook により、エージェントへのコマンド送信とエージェントからの結果受信の両方が可能です。
読み取り専用ホストツール 26 以上の検査ユーティリティを備えたサンドボックス化された Bash 環境。すべての呼び出しは監査可能性のためにログに記録されます。
Kubernetes ライフサイクル クラスターの登録、ワークロード/イベントの検査、アップグレードの管理、Kubernetes リソースのトポロジーグラフへのマッピング。
ネットワークデバイス管理 Edge ホストを介して隣接デバイスを発見し、SNMP で検証し、インターフェイスをポーリングし、ホストをネットワーク機器にリンクします。

🛠️ クイックインストール(README より)

# サーバーの CPU アーキテクチャに一致するバイナリを選択してください
wget https://github.com/ongridio/ongrid/releases/download/v0.18.2/ongrid-v0.18.2-linux-amd64.tar.xz
# または ARM64 バリアント
# wget https://github.com/ongridio/ongrid/releases/download/v0.18.2/ongrid-v0.18.2-linux-arm64.tar.xz

tar -xf ongrid-v0.18.2-linux-*.tar.xz && cd ongrid-v0.18.2-linux-*
sudo ./install.sh   # フルスタック(バックエンド、UI、可観測性)を実行します

中国本土のユーザー向けに、CDN ミラー(https://ongrid.cloud/dl/...)が提供されています。


🎯 典型的なユースケース

  1. アラート駆動の自動調査 – Prometheus からのアラートがインシデント調査エージェントをトリガーし、トポロジーを収集し、ランブックに対して RAG 検索を実行し、発信元の Slack チャネルに簡潔な RCA を投稿します。
  2. オンデマンドのトラブルシューティング – オペレーターがボットに「サービス X のレイテンシーが高いのはなぜですか?」と尋ねます。コーディネーターはクエリを SRE スペシャリストにルーティングし、スペシャリストはメトリクス、ログ、トレースを取得し、ステップバイステップの説明を返します。
  3. 制御された修復 – RCA の後、ボットは修正(例:ポッドの再起動)を提案できます。提案は 承認/書き込みゲート UI を通過し、人間がレビューして変更を承認してから、エージェントが実行します。
  4. Kubernetes ライフサイクル管理 – Edge コンポーネントを介して新しいクラスターを登録し、ワークロードを表示し、アップグレードをスケジュールし、クラスターをグローバルトポロジービューに自動的にマッピングします。
  5. ネットワークトポロジーマッピング – Edge エージェントがネットワークネイバーを発見し、SNMP で検証し、影響分析のためにホストとデバイス間のリンクを視覚化します。

📚 ドキュメントとコミュニティ

  • 完全なドキュメント: https://ongrid.cloud/docs
  • Telegram または Slack でコミュニティに参加してください(README にバッジがあります)。
  • 貢献は歓迎します – CONTRIBUTING.md を参照してください。

📄 ライセンス

コードは AGPL-3.0 の下でリリースされています。ブランド資産には別の商標ライセンス(TRADEMARK.md)があります。


TL;DR

Ongrid は、セルフホスト型の AI 駆動型 SRE プラットフォームであり、大規模言語モデルを搭載したエージェントにインシデントの調査、可観測性データの参照、安全な修復の実行を依頼できます。これらはすべて、使い慣れたチャットツールから行えます。必要なインフラストラクチャ(Go バックエンド、React UI、Prometheus/Loki/Tempo/Grafana)をバンドルし、任意の LLM プロバイダーと統合します。

関連

  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト