Linnix

どのプロセスがSLOを損なっているかを見つけ出します — CPUを使用しているプロセスだけでなく、ストールを引き起こしているプロセスも特定します。

問題

top は80%のCPU使用率を示す。Prometheus は高レイテンシを示す。しかし、実際にペイメントサービスをストールさせているPodはどれか？

LinnixはeBPF + PSI (Pressure Stall Information) を使用してこれに答えます。PSIは実際のストール時間を測定します — 使用量ではなく、競合です。40%のCPUを使用し60%のPSIを持つPodは、100%のCPUを使用し5%のPSIを持つPodよりも悪いです。

Linnixが検出するもの:

• Noisy Neighbors: 他のコンテナをリソース不足にしているコンテナ
• Fork Storms: ノードがクラッシュする前の暴走プロセス作成
• Stall Attribution: "Pod XがPod Yに300msのストールを引き起こした"
• PSI Saturation: top には表示されないCPU/IO/メモリプレッシャー

[!IMPORTANT] デフォルトではモニターのみ。 Linnixは検出と報告を行います — 明示的な設定なしにアクションを取ることはありません。

🔒 セキュリティとプライバシー

• Security Policy: セキュリティモデル、必要な権限、脆弱性報告プロセスをご覧ください
• Safety Guarantees: "Monitor-First"アーキテクチャと安全制御について理解する
• Architecture Overview: セキュリティレビューのためのシステム図とデータフロー

重要な約束: すべての分析はローカルで行われます。Slack通知を明示的に設定しない限り、データがインフラストラクチャから流出することはありません。データプライバシーの詳細 →

クイックスタート (Kubernetes)

LinnixをDaemonSetとしてデプロイし、クラスターを監視します。

# Apply the manifests
kubectl apply -f k8s/

APIへのアクセス:

kubectl port-forward daemonset/linnix-agent 3000:3000
# API available at http://localhost:3000
# Stream events: curl http://localhost:3000/stream

クイックスタート (Docker)

ローカルマシンで30秒で試せます。

git clone https://github.com/linnix-os/linnix.git && cd linnix
./quickstart.sh

仕組み

1. Collector (eBPF): カーネル内に存在し、fork, exec, exit、スケジューライベントを1%未満のオーバーヘッドで監視します。
2. Reasoning Engine: シグナル（PSI + CPU + プロセスツリー）を集約し、障害パターンを検出します。
3. Triage Assistant: しきい値を超えると、Linnixはシステム状態をキャプチャし、根本原因を説明します。

サポートされている検出

安全性とアーキテクチャ

Linnixは本番環境での安全性を考慮して設計されています。

• Monitor-First: 強制機能はオプトインであり、明示的な設定が必要です。
• 低オーバーヘッド: /proc ポーリングではなく、eBPF perfバッファを使用します。
• 特権分離: ベアメタル上で CAP_BPF と CAP_PERFMON で実行可能。Kubernetes DaemonSetは現在、簡便さのために特権モードを使用しています。

詳細な安全モデルについてはSAFETY.mdを参照してください。

Kubernetes機能

Linnixは最高級のKubernetesサポートを備えています：

• Pod属性: すべてのプロセスイベントに pod_name, namespace, container_id がタグ付けされます
• 名前空間認識: 名前空間によるフィルタリングとクエリ
• PSI寄与追跡: システム全体のPSIプレッシャーにどのPodが寄与したかを確認
• cgroup統合: プロセスをcgroupにマッピングし、コンテナレベルの集約を実現

# Example: Get processes causing stalls in the payments namespace
curl "http://localhost:3000/processes?namespace=payments&sort=psi_contribution"

コマース / オンチェーン決済

Linnixには、ERC-20ステーブルコインを介してエージェント間の作業をオンチェーンで決済するトラストレスな決済レイヤー（Linnix-Claw）が含まれています。あるエージェントが別のエージェントにタスクを委任すると、結果（テレメトリプルーフ付きの署名済みレシート）が TaskSettlement スマートコントラクトに送信され、支払人が受取人に直接支払いを実行します。

アーキテクチャ

Agent A (payer)                    Agent B (payee)
   │  createTask(taskId, payeeDID, maxAmount)
   │──────────────────────────────────▶│
   │                                   │ ← does work, captures eBPF telemetry
   │    submitReceipt(taskId, amount, receipt, sig)
   │◀──────────────────────────────────│
   │                                   │
   └──── TaskSettlement.sol ─── ERC-20 transfer ──▶ payee

主要コントラクト (Base Sepoliaテストネット):

設定

linnix.toml に [chain] セクションを追加します：

[chain]
enabled = true
rpc_url = "https://sepolia.base.org"
chain_id = 84532
settlement_contract = "0x60eE6872920addF41359625B47A07401496bBD5b"
registry_contract = "0x9a6FeBA6d7B97ef91099051eB61F372d1EcD83a3"
token_address = "0x036CbD53842c5426634e7929541eC2318f3dCF7e"  # USDC on Base Sepolia
token_decimals = 6

署名鍵は以下の優先順位で解決されます：

1. 設定内の chain.private_key
2. 環境変数 LINNIX_CHAIN_PRIVATE_KEY
3. エージェントのEd25519 IDからHKDF派生したsecp256k1鍵（デフォルト — 設定不要）

エンドツーエンドデモ

# Deploy contracts to a local Hardhat node
cd linnix-claw-contracts && npx hardhat node &
npx hardhat run scripts/deploy.js --network localhost

# Run the commerce demo
./scripts/demo_commerce_e2e.sh --local

実装の詳細については、コントラクトソース と cognitod/src/onchain.rs を参照してください。

アーリーアダプター

このプロジェクトは活発に開発中です。使用中または評価中の場合は、Issueを開くか、[email protected] までメールしてください。

ライセンス

• Agent (cognitod): AGPL-3.0
• eBPF Collector: GPL-2.0 または MIT (eBPFプログラムはカーネルロードのためにGPL互換である必要があります)

AGPLを使用できないチーム向けに商用ライセンスを提供しています。詳細は LICENSE_FAQ.md をご覧ください。