S SISL docs
⌕ /
EN
docs  ›  SISL Optima Connector  ›  Diagnostyka i błędy

Diagnostyka i błędy

Pierwsze miejsce gdy coś nie działa: SISL Optima → Diagnostyka w lewej kolumnie Magento admin.

Diagnostyka — 14 kontroli

Check OK WARN FAIL → fix
Licencja wazna grace offline klucz nie ustawiony / revoked → wpisz lub kup nowy
Modul aktywny enabled=Yes — enabled=No → włącz w Stores → Configuration
URL mikrouslugi http://x:5000 — puste / zły schemat
HMAC secret 64 znaki <32 znaki brak → wygeneruj openssl rand -hex 32
Polaczenie HTTP mikrousluga odpowiada DB disconnected timeout, refused → sprawdź firewall, czy service chodzi
Backend mikrouslugi optima mock (dev) unknown
RTT do mikrouslugi <100ms >5000ms nie mozna zmierzyc
Magento var/log/ zapisywalny — chown -R www-data var/log
Magento generated/ zapisywalny — jw. dla generated
Magento DB OK — sprawdź env.php
Atrybut wykluczen zainstalowany — bin/magento setup:upgrade
Sync produktow <24h >24h cron nie chodzi
Sync stanow <24h >24h jw.
Bledy ostatniej sync brak są bledy sprawdź var/log/system.log
Cron Magento N zadan/h brak bin/magento cron:run w systemowym crontab

Częste problemy

"license is bound to X" przy aktywacji

Klucz jest już zaaktywowany dla innego URL-a. Wejdź w /konto na sisl.pl → wybierz licencję → Odłącz od hosta → następny sync zaaktywuje na nowym URL.

connect() failed (111: Connection refused) w nginx error log

Magento nie może dojść do PHP-FPM przez Unix socket. Sprawdź: - czy kontener app (PHP-FPM) chodzi - czy /sock/docker.sock jest w shared volume między nginx a app - czy w nginx config jest fastcgi_pass unix:/sock/docker.sock;

Stany w Magento dalej 0 mimo PZ w Optimie

Twoja PZ-tka nie jest zatwierdzona (status bufor/do zatwierdzenia). Zatwierdź dokument (ikonka kłódki / Z w Optimie) — wtedy zapis do CDN.TwrZasoby z TwZ_TrSIdDost > 0 zostanie wykonany i nasz sync go zobaczy.

HTTP 402 Payment Required z /v1/products

Mikrousługa zwraca to gdy lokalna weryfikacja licencji failuje: 1. Sprawdź appsettings.Local.json → License.Key i License.ServerUrl 2. Sprawdź czy serwer ma outbound do license.sisl.pl: Invoke-WebRequest https://license.sisl.pl/check -Method Post 3. Sprawdź log: Get-Content C:\Sisl\logs\license-trace.log -Tail 5

signature mismatch (possible attack) w logu mikrousługi

Klucz publiczny Ed25519 embedded w binarce nie pasuje do prywatnego serwera SISL. Przyczyny: - ściągnąłeś plugin ze starszej wersji niż serwer zna - ktoś sfałszował response (poważnie — sprawdź outbound HTTPS proxy)

Rozwiązanie: re-pobierz najnowszy Sisl.Sync.Service.zip z /konto na sisl.pl.

Ten email jest już zarejestrowany. Zaloguj się. przy rejestracji

Konto istnieje już ale niepotwierdzone. Spróbuj się zalogować — dostaniesz info "Email niepotwierdzony" i ponowny mail z linkiem.

Cron Magento: brak ostatnich zadan (WARN w Diagnostyce)

Cron Magento nie chodzi. Najczęstsza przyczyna w Docker setup:

# dorzuć do docker-compose.yml
cron:
  image: <ten sam image co app>
  command: >
    sh -c "while true; do
             php /var/www/html/bin/magento cron:run --group=default >> /var/www/html/var/log/cron.log 2>&1;
             sleep 60;
           done"
  volumes: [...]  # te same co app

Lub w czystym systemie:

* * * * * /var/www/html/bin/magento cron:run --group=default >> /var/log/magento-cron.log 2>&1

Synchronizacja powolna

Logi

Magento

tail -f /var/www/html/var/log/system.log | grep Sisl_Optima
tail -f /var/www/html/var/log/exception.log
tail -f /var/www/html/var/log/cron.log

Mikrousługa Windows

# Windows Service stdout/stderr
Get-WinEvent -FilterHashtable @{LogName='Application'; ProviderName='SislSyncService'} -MaxEvents 20

# License trace (Ed25519 verify diag)
Get-Content C:\Sisl\logs\license-trace.log -Tail 30

# .NET runtime crashes
Get-WinEvent -FilterHashtable @{LogName='Application'; ProviderName='.NET Runtime'} -MaxEvents 5

Support

Następny krok: Changelog →