Napraw awarię serwera multimediów BigBlueButton Kurento pod obciążeniem

Proces Kurento Media Server (KMS), który kończy działanie podczas intensywnych spotkań BigBlueButton, może przerwać nagrywanie lub, w starszych instalacjach, transmisję dźwięku i obrazu na żywo. Pierwszym, użytecznym rezultatem nie jest po prostu ponowne uruchomienie usługi: chodzi o informację, który stos multimediów obsługuje daną funkcję, jaki zasób lub awaria poprzedza zakończenie działania oraz czy poprawka utrzymuje stabilność kolejnego porównywalnego spotkania.

Zacznij od potwierdzenia wydania BigBlueButton i roli Kurento na tym serwerze. BigBlueButton 2.5 i nowsze wersje domyślnie używają mediasoup do transmisji multimediów WebRTC na żywo; Kurento może być nadal obecne do nagrywania lub ponieważ administrator zachował starszą/niestandardową konfigurację. Zatem komunikat o awarii Kurento sam w sobie nie dowodzi, że KMS obsługuje przeciążone kamery internetowe. Zapoznaj się z oficjalnym przewodnikiem rozwiązywania problemów BigBlueButton , aby dowiedzieć się, jaka jest różnica między wersjami. Szczegółowe rozwiązania problemów z KMS poniżej pochodzą z podręcznika dostosowywania serwera BigBlueButton 2.7 ; przed ich zastosowaniem sprawdź dokumentację odpowiadającą zainstalowanej wersji.

Najpierw potwierdź, co się nie powiodło

Zbierz dowody przed wielokrotnym restartowaniem usług. Zapisz, kiedy użytkownicy po raz pierwszy zauważyli problem, na jakim spotkaniu wystąpił problem, czy wystąpił błąd audio, kamery internetowej, udostępniania ekranu lub nagrywania, a także czy cały serwer, czy tylko jedna funkcja multimedialna uległa pogorszeniu. Restart usługi może tymczasowo przywrócić proces, jednocześnie usuwając wskazówki czasowe, które pozwalają odróżnić awarię od problemu sieciowego lub klienta.

Na hoście BigBlueButton zacznij od sprawdzeń tylko do odczytu:

sudo bbb-conf --check
sudo systemctl status kurento-media-server --no-pager
sudo journalctl -u kurento-media-server --since "1 hour ago" --no-pager
sudo ls -lt /var/log/kurento-media-server/ | head

Użyj odpowiedniej nazwy jednostki dla wydania i wdrożenia. Jeśli usługa jest podzielona na wiele jednostek KMS, sprawdź jednostkę i log pod kątem procesu, który się nie powiódł. Porównaj znacznik czasu dziennika systemd z najnowszym logiem KMS. Poszukaj wyraźnego wyjścia, pętli restartu, nieudanego potoku multimediów lub komunikatu związanego z zasobem; jeden wiersz „ostrzeżenia” bez odpowiadającego mu błędu nie wystarczy do zidentyfikowania przyczyny.

Sprawdź, czy użytkownicy faktycznie używają Kurento do obsługi niedziałającego ruchu. W przeglądarce Firefox about:webrtcmożna ujawnić szczegóły połączenia peer-to-peer; Chrome oferuje [brakuje informacji] chrome://webrtc-internals. Dokumentacja rozwiązywania problemów BigBlueButton opisuje sprawdzanie szczegółów wynegocjowanej sesji dla MediaSoup. Sprawdź również skonfigurowane usługi multimedialne i przepływ pracy nagrywania. Jeśli media na żywo są dostępne w MediaSoup, a nagrywanie zatrzymuje się tylko po zamknięciu KMS, dostosuj ścieżkę nagrywania/Kurento, zamiast bezmyślnie zmieniać ustawienia kamery internetowej na żywo.

Znajdź ciśnienie, które pojawia się przed wyjściem

„Pod obciążeniem” może oznaczać kilka różnych wąskich gardeł. Pobierz próbkę gospodarza, gdy trwa spotkanie reprezentatywne, i porównaj próbkę z czasem wydarzenia. Przydatne kontrole obejmują:

• free -horaz vmstat 1dostępnej pamięci, wymiany i obciążenia kolejki uruchomieniowej;
• mpstat -P ALL 1do pomiaru nasycenia rdzenia procesora, jeśli sysstatnarzędzia są zainstalowane;
• df -horaz iostat -xz 1dla pełnego systemu plików lub opóźnienia pamięci masowej, jeśli jest ono dostępne;
• journalctl -k --since "1 hour ago"dla komunikatów jądra, w tym komunikatu o braku pamięci;
• status systemd i logi KMS dotyczące powtarzających się wyjść, awarii potoku oraz tego, która operacja multimedialna była aktywna.

Nie należy polegać wyłącznie na średniej mocy obliczeniowej procesora serwera. Proces multimedialny może być ograniczony przez jeden zajęty rdzeń, podczas gdy inne rdzenie wydają się bezczynne, a obciążenie pamięci może spowodować wyłączenie bez długotrwałego, wysokiego obciążenia procesora. Z drugiej strony, użytkownik może zgłosić „zawieszenie kamery”, gdy KMS pozostaje sprawny, ponieważ protokół UDP jest zablokowany lub przeglądarka nie może nawiązać ścieżki WebRTC. BigBlueButton opisuje TURN jako rozwiązanie dla sieci o ograniczonych możliwościach; TURN może poprawić łączność, ale nie zwiększa mocy obliczeniowej KMS. Jeśli usługa pozostaje aktywna, a logi nie wykazują żadnych zdarzeń związanych z zasobami, przed zwiększeniem limitów multimediów należy sprawdzić ICE, zaporę sieciową i łączność klienta.

Pojemność zależy od rzeczywistego zestawienia strumieni i przetwarzania, a nie tylko od liczby uczestników spotkania. Liczba opublikowanych i odebranych kamer internetowych, udostępnień ekranu, sesji audio, nagrań, uzgodnionej jakości i układu spotkania – to wszystko ma znaczenie. Dlatego zrównoważony limit powinien być mierzony na podstawie własnego schematu spotkań w organizacji, a nie kopiowany z niezależnego serwera.

Wybierz środek leczniczy zgodny z dowodami

W przypadku wdrożenia starszej wersji usługi KMS należy oddzielić obciążenia multimedialne

W podręczniku personalizacji BigBlueButton 2.7 opisano uruchomienie trzech procesów KMS, po jednym dla obsługi dźwięku tylko do słuchania, kamery internetowej i udostępniania ekranu. Deklarowaną zaletą jest rozłożenie zadań związanych z uruchamianiem/zatrzymywaniem multimediów na oddzielne procesy i ograniczenie wpływu awarii jednego z procesów KMS. Konfiguracja w podręczniku wykorzystuje enableMultipleKurentosustawienia skryptu konfiguracyjnego BigBlueButton, a następnie restartuje BigBlueButton. Postępuj zgodnie z instrukcjami dla konkretnej wersji i sprawdź wygenerowane jednostki serwisowe oraz logi po restarcie.

To rozdzielenie jest środkiem ograniczającym i dystrybuującym, a nie substytutem wystarczającej ilości zasobów procesora, pamięci ani pamięci masowej. Może również zwiększyć bazowe wykorzystanie zasobów, ponieważ uruchamiane są dodatkowe procesy. Zaplanuj okno konserwacyjne: sudo bbb-conf --restartprzerywa aktywne sesje. Nie edytuj ręcznie wygenerowanych plików usług ani nie zakładaj, że polecenie udokumentowane dla wersji 2.7 ma zastosowanie bez zmian do nowszej lub zmodyfikowanej przez dostawcę instalacji.

Ustaw progi multimediów, gdy serwer wymaga limitu dostępu

W wersjach opartych na KMS, które obsługują udokumentowaną opcję, BigBlueButton dopuszcza mediaThresholdswartości global, perRoomi perUser. W podręczniku 2.7 są one pokazane w /etc/bigbluebutton/bbb-webrtc-sfu/production.ymlpliku nadrzędnym, który ma na celu zapewnienie przetrwania aktualizacji pakietów. W udokumentowanym przykładzie zero oznacza brak limitu. Osiągnięcie skonfigurowanego progu może spowodować błąd „Zasoby multimedialne niedostępne (2002)”, gdy uczestnik próbuje udostępnić kamerę internetową.

Wybierz wartości ze zmierzonej pojemności i wymaganej jakości usług; nie wklejaj przykładu ilustrującego z dokumentacji jako uniwersalnego bezpiecznego limitu. Próg zwiększa przewidywalność przeciążenia poprzez odrzucenie dodatkowych nośników, ale nie naprawia awarii spowodowanej błędem, wyciekiem pamięci lub niezwiązanym z tym limitem systemu operacyjnego. Sprawdź nazwy ustawień i ich zachowanie w dokumentacji swojej wersji przed jej wdrożeniem.

Zmniejsz zapotrzebowanie na media przed podniesieniem założeń dotyczących pojemności

Gdy monitorowanie wykaże nasycenie zasobów, należy najpierw zmniejszyć obciążenie szczytowe, które usługa musi wykonać. Poproś moderatorów o selektywne włączanie kamer internetowych, unikaj niepotrzebnego jednoczesnego udostępniania ekranu lub podziel bardzo dużą sesję interaktywną na mniejsze sale, jeśli pasuje to do formatu nauczania. W wersjach, które udostępniają obsługę paginacji kamer internetowych lub limitów strumieniowania, dostosuj je za pomocą udokumentowanego mechanizmu nadpisywania. Mniejsza liczba odbieranych strumieni może zmniejszyć rozproszenie, a obniżenie rozdzielczości kamery lub przepływności może zmniejszyć zapotrzebowanie na moc obliczeniową i przepustowość. Te zmiany kosztem szczegółowości obrazu lub spontaniczności kosztem stabilności; wyjaśnij ten kompromis organizatorom spotkania i sprawdź, czy uzyskane wrażenia są akceptowalne.

Rozważ ulepszenie lub zmianę architektury, gdy limity powrócą

Jeśli zainstalowana wersja jest starsza, przed dalszymi inwestycjami w dostrajanie KMS należy sprawdzić obsługiwaną ścieżkę aktualizacji i architekturę multimediów. Od BigBlueButton 2.5, mediasoup jest domyślnym rozwiązaniem dla multimediów na żywo, natomiast rola Kurento różni się od starszych wersji. Ciągłe awarie KMS na obecnym serwerze mogą zatem wskazywać na nagrywanie, niestandardowy stos multimediów lub określoną integrację. W przypadku starszej wersji, która wielokrotnie osiąga swój zmierzony pułap po przekroczeniu rozsądnych limitów i zmianach obciążenia, aktualizacja lub przeprojektowanie wdrożenia może być bardziej efektywne niż podnoszenie progów. Koszty operacyjne obejmują testowanie zgodności, planowanie migracji i okno konserwacyjne.

Zweryfikuj zmianę na porównywalnym spotkaniu

Zmień jedno ustawienie lub obciążenie pracą na raz, a następnie przetestuj je na kontrolowanym spotkaniu, które przypomina normalne, szczytowe obciążenie. Zwróć uwagę na wydanie BigBlueButton, liczbę uczestników, przybliżoną liczbę aktywnych kamer internetowych, udostępnianie ekranu oraz to, czy nagrywanie jest włączone. To daje przydatne porównanie bez traktowania liczby uczestników jako jedynej zmiennej obciążenia.

• Sprawdź, czy odpowiednia jednostka KMS pozostaje aktywna i nie wchodzi w pętlę ponownego uruchamiania.
• Porównaj procesor na rdzeń, dostępną pamięć i wymianę, aktywność dysku oraz logi przed i w trakcie testu.
• Zweryfikuj osobno dźwięk, kamerę internetową, udostępnianie ekranu i nagrywanie, zależnie od roli, jaką Kurento faktycznie spełnia.
• Sprawdź, czy błędy z 2002 r., nieudana konfiguracja nośnika lub raporty użytkowników uległy zmianie; żadna pojedyncza metryka nie jest w stanie udowodnić, że rozwiązanie zostało naprawione.
• Powtórz czynność w okresie największego natężenia ruchu, zanim uznasz zmianę pojemności za pomyślną.

Jeśli usługa nadal się zawiesza, przechwyć dokładny dziennik KMS i okno dziennika, komunikaty jądra, zainstalowane wersje BigBlueButton/Kurento oraz aktywne nadpisania konfiguracji dla administratora lub zespołu wsparcia. Jeśli usługa działa prawidłowo, ale użytkownicy nadal nie mogą się połączyć, przenieś badanie na kandydatów ICE, reguły zapory sieciowej, dostępność TURN i diagnostykę WebRTC po stronie przeglądarki. Prawidłowym rezultatem jest stabilne obciążenie multimediów ze zrozumiałymi limitami, a nie nieograniczona liczba strumieni ani gwarancja, że ​​jedna konfiguracja będzie pasować do każdego serwera.

Źródła i notatki dotyczące wersji

• BigBlueButton 2.7: Dostosowywanie serwera — wiele procesów Kurento, progi multimediów i powiązana konfiguracja.
• BigBlueButton: Przewodnik rozwiązywania problemów — bieżąca identyfikacja stosu multimediów, ustawienia domyślne mediasoup, notatki Kurento i rozwiązywanie problemów sieciowych.
• BigBlueButton: Pliki konfiguracyjne — wskazówki dotyczące konfiguracji i plików zastępczych.

Dokumentacja sprawdzona 5 października 2026 r. Szczegółowe przykłady obciążeń i progów Kurento powyżej są wyraźnie powiązane z dokumentacją BigBlueButton 2.7; przed zastosowaniem ustawień w innym miejscu należy sprawdzić odpowiednie informacje o wydaniu i podręcznik administratora.