NetDoc.pl — monitoring i utrzymanie sieci. Piszemy o sprzęcie, który sami uruchamiamy i mierzymy.

Sieć UniFi

Sieć UniFi czytana
z jednego miejsca

Kontroler wie o całej flocie i odda to w jednej odpowiedzi. Trudność nie leży w zapytaniu, tylko w tym, którym kontem pytasz i gdzie w odpowiedzi czego szukać. Trzy artykuły z pomiarów na działającej instalacji.

Po co czytać kontroler, a nie urządzenia

Sprzęt UniFi jest zarządzany centralnie i to zmienia sposób zbierania danych. Nie odpytujesz każdego switcha osobno — najczęściej nawet nie możesz, bo siedzą na osobnej sieci zarządzającej, a dostęp po SSH do adoptowanych urządzeń bywa wyłączony w kontrolerze.

Za to kontroler wie o nich wszystkich, bo to on nimi zarządza. Jedno zapytanie oddaje stan portów, pobór mocy na żywo i to, co jest wpięte po drugiej stronie kabla.

Wszystkie liczby w tej serii pochodzą z pomiaru 6 września 2026, 09:52–09:55, na działającej instalacji: brama UDM-Pro z UniFi OS 5.1.31 i UniFi Network 10.6.101, switch 24-portowy PoE i switch 5-portowy. Wyłącznie odczyty — niczego nie zmienialiśmy. Gdzie liczba pochodzi z wcześniejszego pomiaru, jest to napisane przy niej.

Trzy rzeczy, które zaskoczyły nas przy pomiarze

Każda z nich wygląda na drobiazg w dokumentacji, a kosztuje godzinę przy pierwszym podejściu.

1. Konto z panelu nie zadziała

Konto Ubiquiti, którym logujesz się przez e-mail, dostaje 403 — mimo poprawnego hasła. Działa dopiero konto lokalne założone w samym kontrolerze. Kod odmowy wygląda przy tym na problem z hasłem, więc szuka się nie tam, gdzie trzeba. → Jak czytać całą flotę jednym zapytaniem

2. Nazwy sąsiada w danych nie ma

Sąsiedzi z LLDP mają w tym wydaniu puste pole nazwy — wszystkie pięć wpisów, które zmierzyliśmy. Dostajesz adres sprzętowy i etykietę portu po drugiej stronie, a nazwę musisz rozwiązać sam. Do tego w tabeli portów jest pole z „lldp" w nazwie, które sąsiadem nie jest. → Gdzie naprawdę siedzi topologia

3. Konto do odczytu nie widzi dziennika zdarzeń

To samo konto, które w zupełności wystarcza do stanu i topologii, dostaje odmowę na dzienniku zdarzeń kontrolera. Czyli akurat to, co czyni kontroler wartościowym w chwili awarii, jest poza jego zasięgiem. → Trzy kody odmowy, które znaczą co innego

Dla kogo to jest

Dla osoby, która ma sieć na UniFi i chce z niej wyciągnąć dane do własnego monitoringu, inwentaryzacji albo mapy połączeń — bez klikania po panelu.

Nie opisujemy tu konfiguracji sieci ani strojenia Wi-Fi. Opisujemy drogę do danych: czym się zalogować, o co zapytać, gdzie w odpowiedzi czego szukać i jak odróżnić odmowę uprawnień od nieistniejącego adresu.

Czego jeszcze nie zmierzyliśmy

Ta lista jest częścią materiału. Zestaw pomiarów wyznacza granicę tego, co wolno twierdzić.

  • Zawartości kategorii critical. Wiemy, że adres odpowiada i oddaje dane. Nie przejrzeliśmy jeszcze samych wpisów, więc nie napiszemy, co tam bywa.
  • Zachowania starszych wydań. Mamy jedno wydanie kontrolera, więc każde zdanie o adresach, które dziś nie odpowiadają, dotyczy tego wydania, a nie UniFi w ogóle.
  • Bazy wewnętrznej kontrolera ani dostępu po SSH do adoptowanych urządzeń.
  • Instalacji z wieloma witrynami. Nasza ma jedną, a to właśnie przy kilku lokalizacjach najłatwiej zapytać nie o tę, o którą się chciało.

Seria będzie rosła razem z pomiarami. Jeśli masz sieć na UniFi i chcesz, żeby ktoś wyciągnął z niej dane i czytał je na bieżąco — napisz do nas. Odpiszemy, co da się zmierzyć u Ciebie i czego się z tego dowiesz.