Instalacja - Next.js

2 Min. Lesezeit Aktualisiert: 03.09.2026

Przed rozpoczęciem utwórz projekt w DockRay, skopiuj jego token i wygeneruj prywatny klucz API. Token identyfikuje projekt, natomiast klucz uwierzytelnia instalację. Jeżeli projekt nie został jeszcze utworzony, rozpocznij od artykułu Zakładanie konta i pierwszego projektu.

Wymagania

Obsługiwane środowisko: Next.js 13.4+ z App Routerem, środowisko Node.js.

Integracja korzysta bezpośrednio z REST API DockRay i nie wymaga instalowania dodatkowej paczki.

Instalacja i pierwsze uruchomienie

# .env.production — wartości skopiuj z panelu DockRay
DOCKRAY_TOKEN=TWOJ_TOKEN_PROJEKTU
DOCKRAY_PRIVATE_KEY=TWOJ_KLUCZ_PRYWATNY

// lib/dockray.ts — plik używany wyłącznie po stronie serwera
export async function reportToDockRay(error: unknown, request?: Request) {
  const value = error instanceof Error ? error.message : String(error);

  await fetch(
    `https://dockray.io/api/v1/${process.env.DOCKRAY_TOKEN}/project`,
    {
      method: 'POST',
      headers: {
        Authorization: `Bearer ${process.env.DOCKRAY_PRIVATE_KEY}`,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        exception: { values: [{ type: 'Error', value }] },
        request: request ? { url: request.url, method: request.method } : {},
        sdk: { name: 'dockray.nextjs', version: '1.0' },
      }),
    },
  );
}

Po zakończeniu instalacji

Zweryfikuj, że token i klucz pochodzą z tego samego projektu, a sekret nie został zapisany w repozytorium ani publicznym kodzie aplikacji. Następnie przejdź do konfiguracji integracji, określ środowisko i wyślij kontrolne zdarzenie przed włączeniem raportowania dla pełnego ruchu produkcyjnego.