Instalacja - Nuxt

1 min read Updated: 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: Nuxt 3 i Nitro, środowisko Node.js.

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

Instalacja i pierwsze uruchomienie

# .env — wartości skopiuj z panelu DockRay
NUXT_DOCKRAY_TOKEN=TWOJ_TOKEN_PROJEKTU
NUXT_DOCKRAY_PRIVATE_KEY=TWOJ_KLUCZ_PRYWATNY

// nuxt.config.ts — private runtimeConfig nie trafia do przeglądarki
export default defineNuxtConfig({
  runtimeConfig: {
    dockrayToken: '',
    dockrayPrivateKey: '',
  },
});

// server/utils/dockray.ts
export async function reportToDockRay(error: unknown, event?: H3Event) {
  const config = useRuntimeConfig(event);
  const value = error instanceof Error ? error.message : String(error);

  return $fetch(
    `https://dockray.io/api/v1/${config.dockrayToken}/project`,
    {
      method: 'POST',
      headers: { Authorization: `Bearer ${config.dockrayPrivateKey}` },
      body: { exception: { values: [{ type: 'Error', value }] } },
    },
  );
}

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.