add k8s doc

_sidebar.md

@@ -41,6 +41,9 @@
     - [Использование](modules/alert-pack/guide.md)
   - [Таблица активных оповещений](modules/alert-pack/alert-table-labels.md)
   - [Инфраструктурный мониторинг](modules/infra.md)
+  - [Kubernetes](modules/kubernetes.md)
+    - [Настройка](modules/kubernetes/setup.md)
+    - [Использование](modules/kubernetes/guide.md)
   - [Синтетический мониторинг](modules/synthetics.md)
     - [Настройка](modules/synthetics/setup.md)
     - [Использование](modules/synthetics/guide.md)

modules/infra.md

@@ -16,6 +16,7 @@ GMONIT поддерживает из коробки мониторинг БД Or
 ## Поддерживаемые платформы
 
 - [Мониторинг хоста и Docker-контейнеров](/modules/infra/docker.md)
+- [Мониторинг Kubernetes](/modules/kubernetes.md)
 - [Мониторинг NGINX](/modules/infra/nginx.md)
 - [Мониторинг СУБД](/modules/infra/db.md)
   - [Мониторинг PostgreSQL](/modules/infra/postgres.md)

modules/kubernetes.md

@@ -0,0 +1,39 @@
+# Kubernetes
+
+Мониторинг кластеров Kubernetes: от сводки по всему парку до отдельного контейнера. Ключевая особенность — переход от контейнера к приложению, которое внутри него работает, то есть от «контейнеру не хватает ресурсов» к «пользователям приложения плохо».
+
+## Как это работает
+
+Инфраструктурный агент GMONIT, развёрнутый в кластере, опрашивает API-сервер и kubelet и присылает в коллектор состояние объектов: кластер, узлы, пространства имён, рабочие нагрузки, поды и контейнеры. Отдельной установки для раздела не требуется — как только агент в кластере начал отчитываться, данные появляются в интерфейсе.
+
+Раздел построен одинаково для всех видов объектов: список с показателями, из него — проваливание в карточку конкретного объекта с графиками за выбранный период. Переходы между уровнями связаны: из узла видно его поды, из пода — его контейнеры, из контейнера — узел, на котором он работает.
+
+Связь с APM держится на имени: APM-агент внутри пода отчитывается именем пода как именем хоста, поэтому в карточке пода перечислены приложения, работающие в нём, вместе с Apdex, временем ответа и долей ошибок.
+
+## Возможности
+
+- [Сводка по всему парку кластеров: сколько объектов, что не готово, перезапуски и OOM за период](/modules/kubernetes/guide.md#Оценить-состояние-парка)
+- [Кластеры: версия, состав, утилизация и доля зарезервированных ресурсов](/modules/kubernetes/guide.md#Оценить-состояние-парка)
+- [Узлы: утилизация, занятые слоты подов, заполнение диска и флаги состояния](/modules/kubernetes/guide.md#Найти-перегруженный-узел)
+- [Пространства имён: состав подов и потребление ресурсов в разрезе команды или окружения](/modules/kubernetes/guide.md#Посмотреть-нагрузку-по-пространствам-имён)
+- [Рабочие нагрузки: сколько реплик заказано, готово, недостаёт и недоступно](/modules/kubernetes/guide.md#Проверить-выкат-рабочей-нагрузки)
+- [Поды и контейнеры: состояние, перезапуски, OOM, причина последнего завершения](/modules/kubernetes/guide.md#Найти-перезапускающиеся-поды-и-контейнеры)
+- [Троттлинг CPU и потребление относительно лимитов контейнера](/modules/kubernetes/guide.md#Найти-перезапускающиеся-поды-и-контейнеры)
+- [Переход от пода к приложениям, которые в нём работают](/modules/kubernetes/guide.md#Связать-под-с-приложением-внутри-него)
+- Запросы к тем же данным через AI-агента — раздел доступен по [MCP](/modules/mcp/guide.md#kubernetes)
+
+## Планируемые возможности
+
+- Тома и заявки на хранилище (PV, PVC): заполнение, класс хранилища, привязка
+- Сервисы и эндпоинты, включая сервис без живых эндпоинтов
+- Job и CronJob: успешность и длительность выполнения
+- Ход выката по ревизиям и признак застрявшего выката
+- Потребление относительно request, а не только относительно лимита: лимиты проставлены у меньшинства контейнеров, поэтому сейчас соответствующие колонки у большинства строк пустые
+- Расширенный набор флагов состояния узла
+- События кластера (kube events) рядом с метриками
+- Коробочные оповещения по Kubernetes
+
+## Далее
+
+- [Настройка](/modules/kubernetes/setup.md) — развёртывание агента в кластере и проверка, что данные пошли
+- [Использование](/modules/kubernetes/guide.md) — типовые задачи: от сводки по парку до разбора одного контейнера