Linnix

Найдите процесс, который подрывает ваши SLO — не только тот, кто загружает CPU, но и тот, кто вызывает задержки.

Проблема

top показывает 80% CPU. Prometheus — высокую задержку. Но какой под на самом деле тормозит ваш платёжный сервис?

Linnix использует eBPF + PSI (Pressure Stall Information — информация о давлении и остановках), чтобы ответить на этот вопрос. PSI измеряет фактическое время остановок — не использование, а конкуренцию. Под, использующий 40% CPU с 60% PSI, хуже, чем под с 100% CPU и 5% PSI.

Что обнаруживает Linnix:

Шумные соседи: какой контейнер истощает ресурсы других
Штормы форков: неконтролируемое создание процессов до того, как упадёт узел
Атрибуция остановок: "Под X вызвал остановку в 300 мс у пода Y"
Насыщение PSI: давление на CPU/IO/память, которое не отображается в top

[!IMPORTANT] По умолчанию только мониторинг. Linnix обнаруживает и сообщает — он никогда не предпринимает действий без явной конфигурации.

🔒 Безопасность и конфиденциальность

Политика безопасности: наша модель безопасности, необходимые привилегии и процесс сообщения об уязвимостях
Гарантии безопасности: понимание нашей архитектуры "Сначала мониторинг" и средств контроля безопасности
Обзор архитектуры: системная диаграмма и потоки данных для аудита безопасности

Ключевое обещание: весь анализ выполняется локально. Никакие данные не покидают вашу инфраструктуру, если вы явно не настроите уведомления в Slack. Подробнее о конфиденциальности данных →

Быстрый старт (Kubernetes)

Разверните Linnix как DaemonSet для мониторинга вашего кластера.

# Примените манифесты
kubectl apply -f k8s/

Доступ к API:

kubectl port-forward daemonset/linnix-agent 3000:3000
# API доступен по адресу http://localhost:3000
# Поток событий: curl http://localhost:3000/stream

Быстрый старт (Docker)

Попробуйте на локальной машине за 30 секунд.

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

Как это работает

Сборщик (eBPF): работает в ядре, отслеживает события fork, exec, exit и планировщика с накладными расходами <1%.
Движок анализа: агрегирует сигналы (PSI + CPU + дерево процессов) для выявления шаблонов отказов.
Помощник по триажу: при превышении порога Linnix захватывает состояние системы и объясняет корневую причину.

Поддерживаемые обнаружения

Тип инцидента	Логика обнаружения	Ценность триажа
Автоматический выключатель	Высокий PSI (>40%) + Высокий CPU (>90%)	Определяет конкретное дерево процессов, вызывающее остановку.
Шторм форков	>10 fork/с в течение 2 с	Перехватывает вышедшие из-под контроля скрипты до того, как они обрушат узел.
Утечка памяти	Устойчивый рост RSS	Помечает контейнеры, которые в итоге исчерпают память (OOM).
Кратковременные задачи	Быстрая смена exec/exit	Выявляет неэффективные сборочные скрипты или циклы аварийных перезапусков.

Безопасность и архитектура

Linnix спроектирован для безопасности в продакшене.

Сначала мониторинг: возможности принудительного применения действий необязательны и требуют явной настройки.
Низкие накладные расходы: использует eBPF perf buffers, а не опрос /proc.
Изоляция привилегий: может работать с CAP_BPF и CAP_PERFMON на голом железе. DaemonSet Kubernetes пока использует привилегированный режим для простоты.

Подробную модель безопасности см. в SAFETY.md.

Возможности Kubernetes

Linnix имеет первоклассную поддержку Kubernetes:

Привязка к подам: каждое событие процесса помечено pod_name, namespace, container_id
Осведомлённость о пространствах имён: фильтрация и запросы по namespace
Отслеживание вклада в PSI: видеть, какой под внёс вклад в системное давление PSI
Интеграция с cgroup: сопоставление процессов с их cgroup для агрегации на уровне контейнеров

# Пример: получение процессов, вызывающих остановки в namespace payments
curl "http://localhost:3000/processes?namespace=payments&sort=psi_contribution"

Коммерция / Ончейн-расчёты

Linnix включает доверенную платёжную прослойку (Linnix-Claw), которая проводит расчёты за работу агентов друг с другом на блокчейне через ERC-20 стейблкоины. Когда один агент делегирует задачу другому, результат — подписанная квитанция с доказательством телеметрии — отправляется в смарт-контракт TaskSettlement, который напрямую переводит платеж от плательщика получателю.

Архитектура

Агент A (плательщик)                Агент B (получатель)
   │  createTask(taskId, payeeDID, maxAmount)
   │──────────────────────────────────▶│
   │                                   │ ← выполняет работу, собирает телеметрию eBPF
   │    submitReceipt(taskId, amount, receipt, sig)
   │◀──────────────────────────────────│
   │                                   │
   └──── TaskSettlement.sol ─── ERC-20 перевод ──▶ получатель

Ключевые контракты (тестовая сеть Base Sepolia):

Контракт	Адрес
AgentRegistry	`0x9a6FeBA6d7B97ef91099051eB61F372d1EcD83a3`
TaskSettlement	`0x60eE6872920addF41359625B47A07401496bBD5b`
StakeBond	`0xEE31fC610B9b64982990adB3ba228E9dBbfF6a73`

Конфигурация

Добавьте секцию [chain] в ваш linnix.toml:

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

Ключ подписи определяется в порядке приоритета:

chain.private_key в конфигурации
Переменная окружения LINNIX_CHAIN_PRIVATE_KEY
Ключ secp256k1, полученный через HKDF из Ed25519-идентичности агента (по умолчанию — нулевая конфигурация)

Комплексная демонстрация

# Разверните контракты на локальном узле Hardhat
cd linnix-claw-contracts && npx hardhat node &
npx hardhat run scripts/deploy.js --network localhost

# Запустите демонстрацию коммерции
./scripts/demo_commerce_e2e.sh --local

Подробности реализации см. в исходном коде контрактов и cognitod/src/onchain.rs.

Первые пользователи

Этот проект находится в стадии активной разработки. Если вы его используете или оцениваете, откройте issue или напишите на [email protected].

Лицензия

Агент (cognitod): AGPL-3.0
Сборщик eBPF: GPL-2.0 или MIT (программы eBPF должны быть совместимы с GPL для загрузки в ядро)

Доступна коммерческая лицензия для команд, которые не могут использовать AGPL. Подробнее см. в LICENSE_FAQ.md.

linnix

Популярное