Integracja

Node.js

Pakiet dla Express i Fastify

Dostępna bezpłatnie Node.js 18+ @dockcodes/dockray

Skąd wziąć

Zobacz na npm

npm

Zacznij za darmo Dokumentacja

Instalacja

// npm install @dockcodes/dockray

import { DockRayClient } from '@dockcodes/dockray';
import { dockrayRequestHandler, dockrayErrorHandler } from '@dockcodes/dockray/express';

const dockray = new DockRayClient({
  token: process.env.DOCKRAY_TOKEN,
  privateKey: process.env.DOCKRAY_PRIVATE_KEY,
});

app.use(dockrayRequestHandler(dockray));
// ...trasy...

app.use(dockrayErrorHandler(dockray));

Serwerowy pakiet DockRay monitoruje aplikacje Node.js oparte na Express lub Fastify. Middleware rejestruje nieobsłużone wyjątki i transakcje HTTP, natomiast klient umożliwia ręczne raportowanie zdarzeń z zadań, kolejek i procesów działających poza cyklem żądania. Token projektu oraz klucz prywatny są odczytywane po stronie serwera i nie mogą zostać dołączone do kodu przeglądarkowego. Przed zakończeniem procesu klient powinien opróżnić kolejkę wysyłkową, aby ostatnie zdarzenia dotarły do DockRay.

Jak tego użyć

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

// Wyjątki tras łapie middleware błędów. To jest do zgłoszeń świadomych.
thor.captureMessage('Webhook płatności przyszedł bez podpisu');

try {
  await order.settle();
} catch (error) {
  dockray.captureException(error);

  throw error;
}

// Przed zamknięciem procesu daj zdarzeniom wyjść.
await dockray.close();