Magento
Moduł dla Magento 2.4 i Adobe Commerce
Oficjalny moduł DockRay dla Magento 2 integruje sklep z platformą monitoringu błędów i automatycznie raportuje wyjątki PHP oraz błędy zapisywane przez Magento w logach. Zgłoszenia z kontrolerów, API REST i GraphQL, integracji płatności i dostaw oraz zadań cron trafiają bezpośrednio do panelu DockRay, ułatwiając diagnozowanie problemów w Magento Open Source i Adobe Commerce.
Monitoring błędów i wyjątków PHP
DockRay zbiera informacje o błędach występujących podczas działania sklepu, w tym o wyjątkach obsługiwanych przez mechanizmy błędów Magento oraz zdarzeniach zapisywanych w logach jako błędy. Dzięki temu możesz szybciej wykrywać problemy z działaniem aplikacji, integracjami zewnętrznymi i procesami wykonywanymi w tle.
Monitorowanie wydajności i błędów JavaScript
Opcjonalny monitoring czasu odpowiedzi tras Magento pomaga identyfikować wolno działające fragmenty aplikacji. Pomiary są przypisywane do nazw tras, a nie do konkretnych adresów produktów, co ułatwia analizę wydajności bez rozbijania wyników na wiele podobnych adresów URL.
Moduł może również zbierać błędy JavaScript występujące w witrynie sklepu. Mechanizm działa także przy włączonym cache stron, dzięki czemu możesz monitorować problemy po stronie przeglądarki bez rezygnowania z optymalizacji wydajności sklepu.
Wykrywanie znanych podatności w Magento
DockRay analizuje informacje o oprogramowaniu sklepu, w tym wersję Magento, pakiety Composera oraz rozszerzenia znajdujące się w katalogu app/code, pod kątem znanych podatności. Wyniki są dostępne w panelu DockRay i pomagają zidentyfikować komponenty, które mogą wymagać aktualizacji lub dodatkowej weryfikacji bezpieczeństwa.
Prosta konfiguracja i bezpieczne przechowywanie kluczy
Połączenie skonfigurujesz w sekcji Sklepy → Konfiguracja → DockRay → Monitoring, podając token projektu i klucz prywatny. Aby ograniczyć przechowywanie danych dostępowych w bazie danych Magento, możesz umieścić klucz prywatny w pliku app/etc/env.php lub przekazać go przez zmienną środowiskową.
DockRay dla Magento pomaga monitorować błędy aplikacji, analizować wydajność tras i wykrywać znane podatności rozszerzeń z jednego panelu, bez konieczności ręcznego przeglądania wszystkich logów sklepu.
Instalacja
Wymagania
Moduł DockRay jest przeznaczony dla Magento Open Source i Adobe Commerce w wersji 2.4.4 lub nowszej, a także Mage-OS. Wymaga PHP w wersji 8.1 lub nowszej.
Instalacja przez Composer
Zainstaluj moduł DockRay w katalogu głównym projektu Magento, korzystając z Composera:
composer require dockcodes/dock-ray-magento
bin/magento module:enable DockCodes_DockRay
bin/magento setup:upgrade
# W trybie produkcyjnym dodatkowo:
bin/magento setup:di:compile
bin/magento setup:static-content:deployKonfiguracja połączenia z DockRay
W panelu administracyjnym Magento przejdź do Sklepy → Konfiguracja → DockRay → Monitoring. Wprowadź token projektu oraz klucz prywatny dostępne w panelu DockRay i zapisz konfigurację.
Jeśli nie chcesz przechowywać klucza prywatnego w bazie danych Magento, możesz zdefiniować dane dostępowe za pomocą poleceń CLI:
bin/magento config:set --lock-env dockray/connection/token TWOJ_TOKEN_PROJEKTU
bin/magento config:set --lock-env dockray/connection/private_key TWOJ_KLUCZ_PRYWATNY
Opcja --lock-env zapisuje konfigurację w zakresie środowiska. Wartości ustawione w ten sposób są zablokowane w panelu administracyjnym i pochodzą z konfiguracji środowiska.
Przechowywanie klucza prywatnego poza bazą danych
Możesz przechowywać klucz prywatny w pliku app/etc/env.php lub przekazać go za pomocą zmiennej środowiskowej:
'dockray' => [
'connection' => [
'private_key' => 'TWOJ_KLUCZ_PRYWATNY',
],
],
Alternatywnie użyj zmiennej środowiskowej CONFIG__DEFAULT__DOCKRAY__CONNECTION__PRIVATE_KEY. Ograniczenie przechowywania sekretów w bazie danych pomaga lepiej kontrolować dostęp do danych uwierzytelniających.
Weryfikacja instalacji
Po zapisaniu konfiguracji wyślij testowe zdarzenie, aby sprawdzić połączenie z projektem DockRay. Test możesz uruchomić z poziomu terminala:
bin/magento dockray:testNastępnie otwórz projekt DockRay i sprawdź, czy otrzymał nowe zdarzenie. Raporty dotyczące znanych podatności są wysyłane cyklicznie przez cron Magento, a ich wysyłkę możesz również uruchomić ręcznie:
bin/magento dockray:inventory:send