Weryfikacja i typowe problemy - Nuxt

Kontrolowane zdarzenie testowe

export default defineEventHandler(() => {
    throw createError({ statusCode: 500, statusMessage: 'Kontrolny błąd DockRay' });
});

Wejdź na tę trasę raz i usuń ją zaraz po udanym teście. Wpis powinien pojawić się w panelu w sekcji Błędy projektu wskazanego przez token.

Typowe problemy

Poświadczenia w złym miejscu konfiguracji

Token i klucz muszą trafić do prywatnej części runtime - przez NUXT_RAY_TOKEN/NUXT_RAY_PRIVATE_KEY albo wprost pod klucz ray w nuxt.config.ts. Wpisane pod runtimeConfig.public.ray trafiają do paczki klienta - to samo ryzyko, co klucz Next.js z przedrostkiem NEXT_PUBLIC_.

Błędy 404 nie trafiają do panelu

Tak ma być. Raportowane są wyłącznie kody 5xx - createError({ statusCode: 404 }) i reszta 4xx to normalny wynik działania aplikacji, a nie awaria.

Błąd komponentu Vue nie pojawia się w panelu

Sprawdź, czy browser.enabled jest włączone i czy strona faktycznie wczytała wtyczkę kliencką - Vue połyka błędy komponentów we własnym handlerze, więc bez wpięcia hooków vue:error/app:error błąd nigdy nie dotrze do window.onerror, a stamtąd do kolektora.

Transakcje nie pojawiają się mimo poprawnej konfiguracji

Dwie niezależne przyczyny: tracesSampleRate równe 0 albo ścieżka pasuje do jednego z ignorePaths (domyślnie /_nuxt, /__nuxt, /health, /metrics) i jest pomijana celowo.

Błędy JavaScriptu z przeglądarki nie docierają

Trasa Nitro powstaje tylko wtedy, gdy browser.enabled było ustawione w chwili builda - włączenie samą zmienną środowiskową w runtime nie wystarczy, moduł musi wiedzieć o tym podczas setup(). Sprawdź też, czy serwer ma ustawione NUXT_RAY_TOKEN i NUXT_RAY_PRIVATE_KEY: trasa i tak odpowie 202, tylko nic nie przekaże dalej.

Wdrożenie na workerze (Cloudflare) nie raportuje

Moduł czyta zdarzenie tą samą ścieżką na Node i na workerach, więc druga ścieżka kodu nie jest potrzebna - jeśli mimo to nic nie dociera, sprawdź, czy zmienne NUXT_RAY_* są w ogóle dostępne w środowisku tego konkretnego wdrożenia, a nie tylko lokalnie.

Ten sam błąd rozbija się na wiele wpisów

Panel grupuje po odcisku sha256(token projektu + typ + komunikat). Identyfikator zamówienia albo użytkownika wklejony w komunikat wyjątku rozbija jeden błąd na tysiąc wierszy.

Panel odpowiada 200, ale zdarzenia nie ma

Odpowiedź 200 {"success": false} znaczy, że konto wyczerpało miesięczny limit błędów. Integracja nie traktuje tego jak awarii - i słusznie. Limit widzisz na pulpicie konta; do końca miesiąca liczy się z zapisanego zużycia, więc nie zresetuje go usunięcie błędów.

Nadal nie działa

Przejdź przez listę kontrolną braku danych w panelu, a jeśli to nie pomoże - napisz do nas. Podaj nazwę projektu, wersję integracji i przybliżoną godzinę testu: to skraca drogę do odpowiedzi.