Назад к Пресс-центр

Как мы придумали удобный способ документировать серверные с помощью Obsidian


Проблема, с которой сталкивается каждый инженер

Если ты когда-нибудь занимался аудитом ИТ-инфраструктуры или принимал серверную после других подрядчиков — ты знаешь этот хаос. Оборудование подключено, что-то работает, что-то мигает, но ни схемы, ни карты, ни понимания, что с чем связано.

Документации нет.
Понимания структуры нет.
Ответственный — ушёл в отпуск.

Именно в такой ситуации оказались и мы. Нужно было:

  • Провести аудит текущего состояния серверной;
  • Зафиксировать все подключения, IP, оборудование;
  • Создать документ, который понятен не только нам, но и заказчику.

Почему мы выбрали Obsidian

Мы перепробовали многое: Excel, Google Docs, Confluence, Notion.
Но у всех был один недостаток — нельзя быстро связать всё со всем и при этом сохранить гибкость.

И тут в игру вошёл Obsidian.

Бесплатный, быстрый, локальный и работающий по принципу «связи, а не папки».

Obsidian оказался идеальным инструментом для создания живой технической документации, которая масштабируется, легко обновляется и не теряется в почте.


Как это устроено у нас внутри

Каждый объект имеет свою структуру:

/ Объект 1
  └── Rack-1
  └── Rack-2
  └── Rack-3

В каждой стойке:

  • Карта серверной (Canvas): вид спереди и сзади (см. скриншот №1),
  • Списки оборудования по категориям: сервера, сети, firewall, KVM, СХД.

📎


Объекты связаны между собой

Каждое устройство кликабельно. Например, на карте ты кликаешь [[Коммутатор Dell N1524]], и открывается отдельный документ:

  • Таблица портов
  • Назначения
  • IP-адреса
  • Ссылки на подключённые устройства

📎

И вот уже не просто “вот тут коммутатор”, а живой интерактивный документ, где по каждому порту ясно, кто куда идёт.


Визуализация и цветовая система

Чтобы не запутаться в оборудовании, мы ввели цветовое кодирование:

  • 🟦 Сервера
  • 🟩 Сетевое оборудование
  • 🟥 Firewall
  • 🟧 KVM
  • 🟨 Питание и кросс
  • 🟪 СХД

Это удобно как для восприятия, так и для презентации перед заказчиком.


Что мы фиксируем для каждого устройства

  • Название устройства и модель
  • Тип и назначение портов
  • IP-адреса
  • Протокол (iDrac, IPMI и т.п.)
  • Ссылки на подключённое оборудование
  • Состояние и дата последнего обновления

И всё это внутри одного Vault’а, доступного инженеру офлайн.

Вывод

Obsidian стал для нас не просто записной книжкой, а системой мышления и визуализации инфраструктуры.

Если ты хочешь, чтобы документация:

  • Была всегда под рукой,
  • Обновлялась без боли,
  • И объясняла всё даже новичку —

Попробуй Obsidian. И, возможно, ты больше не вернёшься к Excel.

Назад к Пресс-центр

Запишитесь на консультацию и

Получите индивидуальное решение
для вашего бизнеса!