Magento

Moduł dla Magento 2.4 i Adobe Commerce

Dostępna bezpłatnie

Zacznij za darmo Dokumentacja

Skąd wziąć

Zobacz na Packagiście

Packagist

Wymagania Magento Open Source lub Adobe Commerce 2.4.4+, Mage-OS, PHP 8.1+

Nazwa paczki dockcodes/dock-ray-magento

Cennik Za darmo

Do czego to służy

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:

bash

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:deploy

Konfiguracja 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:

bash

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:

php

'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:

bash

bin/magento dockray:test

Nastę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:

bash

bin/magento dockray:inventory:send

Jak tego użyć

Wyjątki integracja raportuje sama. To jest do zgłoszeń, które chcesz wysłać świadomie.

php

<?php

use DockCodes\DockRay\Model\Reporter;

class SyncStock
{
    public function __construct(
        private Reporter $dockray
    ) {}

    public function execute(): void
    {
        try {
            $this->erp->pushStock();
        } catch (\Throwable $e) {
            // Raportuj wyjątek z integracji ERP w DockRay.

            $this->dockray->captureException($e);
        }
    }
}