Installeren per platform
Next.js en React
Installeren npm install @blipit/nextjs
@blipit/nextjs geeft je browserfouten, web vitals, session replay en de knop Bug melden vanuit één component in je layout, en fouten uit server components, route handlers en server actions met één regel in instrumentation.ts. Gewone React-apps gebruiken @blipit/browser.
1Installeren
npm install @blipit/nextjs2Haal je sleutels op
Log in op app.blipit.io en open API-sleutels in de zijbalk, en dan je project. Elk project heeft twee sleutels. De publieke sleutel begint met blipit_pk_: hij gaat in browser- en appcode, kan alleen events insturen en mag door iedereen gezien worden. De geheime sleutel begint met blipit_sk_: hij blijft op je server of in Odoo, nooit in een browser, omdat hij ook issues kan lezen en wijzigen. De geheime sleutel wordt maar één keer getoond, direct na het aanmaken, dus kopieer hem dan; raak je hem kwijt, druk dan op Nieuwe geheime sleutel aanmaken, en de oude werkt meteen niet meer. Sommige SDK's hebben ook het project-id nodig, dat op dezelfde pagina staat.
3Zet de sleutels in .env.local
Maak .env.local aan in de projectroot met de publieke sleutel voor de browser en, als je de serverkant hieronder gebruikt, de geheime sleutel voor de server. Alleen namen die met NEXT_PUBLIC_ beginnen bereiken de browser, dus geef de geheime sleutel nooit dat voorvoegsel. Herstart npm run dev nadat je het bestand hebt opgeslagen. Voeg voor productie dezelfde variabelen toe bij je host (op Vercel: Project, Settings, Environment Variables, voor Production en Preview) en deploy opnieuw: NEXT_PUBLIC_-waarden worden in de build geschreven, dus een deployment van vóór het toevoegen heeft een lege sleutel.
NEXT_PUBLIC_BLIPIT_KEY=blipit_pk_your_public_key
BLIPIT_SECRET_KEY=blipit_sk_your_secret_key4Browserkant
Voeg de component één keer toe in de root layout. Hij leest de publieke sleutel uit NEXT_PUBLIC_BLIPIT_KEY. Is de variabele leeg, dan start hij niets en meldt dat in de browserconsole.
import { Blipit } from "@blipit/nextjs";
export default function RootLayout({ children }: { children: React.ReactNode }) {
return (
<html lang="en">
<body>
<Blipit
publicKey={process.env.NEXT_PUBLIC_BLIPIT_KEY!}
environment={process.env.NEXT_PUBLIC_VERCEL_ENV ?? "development"}
release={process.env.NEXT_PUBLIC_VERCEL_GIT_COMMIT_SHA}
replay={{ onErrorSampleRate: 1 }}
/>
{children}
</body>
</html>
);
}5Serverkant
Next.js 15 en later roepen onRequestError aan bij fouten in server components, route handlers en server actions. Eén regel in instrumentation.ts koppelt het aan Blipit. Vanaf @blipit/nextjs 0.2.1 werkt dezelfde regel ook in apps met een middleware.ts en in Edge-routes (runtime = "edge"): de app bouwt, en fouten uit middleware en Edge worden ook gemeld. Next.js 14 heeft geen onRequestError; wikkel daar elke route handler en server action in withBlipit, zoals in het tweede voorbeeld: het meldt de fout, gooit hem opnieuw en slaat redirects en notFound() over. Zet BLIPIT_SECRET_KEY in de serveromgeving, nooit als NEXT_PUBLIC_.
export { captureRequestError as onRequestError } from "@blipit/nextjs/server";import { withBlipit } from "@blipit/nextjs/server";
export const GET = withBlipit(async (request: Request) => {
return Response.json(await loadOrders());
});6Afhankelijkheden en servergezondheid
Vanaf @blipit/nextjs 0.3 exporteer je ook register, zodat Blipit start wanneer de server opstart. Dan verschijnen database- en externe aanroepen op de pagina Afhankelijkheden en de CPU, het geheugen en de event loop van de server op Servergezondheid. In de Edge-runtime doet het niets. Op Vercel ziet register het binnenkomende verzoek misschien niet: wikkel vanaf @blipit/nextjs 0.4 route handlers en server actions in withBlipit, dan wordt elk een verzoek op de pagina Pulse met zijn database- en externe aanroepen, verstuurd na het antwoord zonder het te vertragen.
export { captureRequestError as onRequestError, register } from "@blipit/nextjs/server";import { withBlipit } from "@blipit/nextjs/server";
export const GET = withBlipit(async (request: Request) => Response.json(await loadOrders()));7Fouten opgevangen door error.tsx
Fouten die een error.tsx- of global-error.tsx-boundary opvangt, bereiken nooit de error handler van de browser, dus meld ze vanuit de boundary. Beide bestanden zijn client components.
"use client";
import { useEffect } from "react";
import { captureException } from "@blipit/nextjs";
export default function Error({ error, reset }: { error: Error & { digest?: string }; reset: () => void }) {
useEffect(() => {
captureException(error);
}, [error]);
return (
<div>
<p>Something went wrong.</p>
<button onClick={() => reset()}>Try again</button>
</div>
);
}"use client";
import { useEffect } from "react";
import { captureException } from "@blipit/nextjs";
export default function GlobalError({ error }: { error: Error & { digest?: string } }) {
useEffect(() => {
captureException(error);
}, [error]);
return (
<html>
<body>
<p>Something went wrong.</p>
</body>
</html>
);
}8Houd sleutels buiten git
Bewaar sleutels in omgevingsvariabelen of in de geheime instellingen van je host, nooit in code die je commit, en zet je .env-bestanden in .gitignore. Een publieke sleutel in een webpagina is normaal. Belandt een geheime sleutel ooit in git, op een openbare pagina, in een screenshot of in een chat, open dan API-sleutels, druk op Nieuwe geheime sleutel aanmaken en plak de nieuwe sleutel overal waar de oude werd gebruikt: de oude sleutel werkt meteen niet meer.
.env
.env.local
.env.*.local9Content Security Policy
Als je site een Content Security Policy stuurt, sta dan script-src https://blipit.io toe (de scripttag, en de editor van de melding en de replay-add-on, die bij het eerste gebruik van blipit.io/sdk/<version>/ laden), connect-src https://in.blipit.io (events, screenshots en schermopnames gaan allemaal naar in.blipit.io), img-src data: (de screenshot wordt getekend vanuit een afbeelding van de pagina) en media-src blob: (opnames worden in de melding afgespeeld). De screenshot laadt de afbeeldingen en lettertypen van de pagina opnieuw, dus hun hosts horen ook in connect-src, anders blijven ze leeg. Een wijziging in style-src is niet nodig. Roep bij de scripttag Blipit.init aan vanuit je eigen .js-bestand of geef het inline script een nonce, want een strikte policy blokkeert inline scripts. Voor geluid in schermopnames moet de Permissions-Policy-header van je site microphone=(self) toestaan, en display-capture=(self) voor schermopname; met microphone=() werken opnames zonder geluid.
10Source maps (optioneel)
Om stack traces je broncode te laten tonen in plaats van de geminificeerde bundel, upload je de maps voor elke release vanuit je build-stap.
BLIPIT_KEY=<secret key> npx @blipit/cli sourcemaps upload .next/static --release "$VERCEL_GIT_COMMIT_SHA"14Het meldformulier vooraf invullen en context toevoegen
Roep setUser aan na het inloggen: naam en e-mail van de melder worden ingevuld, en ze krijgen een e-mail als je antwoordt of de status wijzigt. setReportMetadata voegt je eigen velden, zoals het abonnement of de grootte van de winkelwagen, aan elke melding toe; het draait op het moment dat een melding wordt verstuurd, dus de waarden zijn actueel.
"use client";
import { useEffect } from "react";
import { setReportMetadata, setUser } from "@blipit/nextjs";
export function BlipitUser({ user }: { user: { id: string; name: string; email: string; plan: string } }) {
useEffect(() => {
setUser({ id: user.id, username: user.name, email: user.email });
setReportMetadata(() => ({ plan: user.plan }));
}, [user]);
return null;
}15Check of het werkt
Herlaad de app. De knop Bug melden verschijnt rechtsonder, en binnen een minuut staat de paginaweergave onder Web vitals in app.blipit.io. Voeg dan een knop toe die captureMessage aanroept, of een die een fout gooit, en klik erop: het event staat binnen een paar seconden onder Issues.
"use client";
import { captureMessage } from "@blipit/nextjs";
export function TestBlipit() {
return <button onClick={() => captureMessage("Hello from Next.js")}>Send a test event</button>;
}Goed om te weten
- Gewone React zonder Next.js: npm install @blipit/browser en roep Blipit.init aan vóór het renderen; zie Elke website.
- Omgeving en release vallen op de server terug op VERCEL_ENV en VERCEL_GIT_COMMIT_SHA als je ze weglaat.
- Blipit up-to-date houden: de gids Blipit up-to-date houden (docs.blipit.io/updates) legt de updatebanner uit, de e-mails voor belangrijke releases, de melding in je ontwikkelconsole en het updatecommando voor dit platform.
- Eén project per app en platform: elk project kiest bij het aanmaken zijn platform (Android, iOS, React Native, Flutter, Web, Backend of Odoo), en Blipit weigert gegevens van elk ander platform met een duidelijke foutmelding. Een iOS-app en een Android-app hebben dus twee projecten met twee sleutels nodig. Releases, versies, crashpercentages en store-builds verschillen per platform, en door ze in één project te mengen klopt geen van die cijfers meer. Een Web-project neemt ook de serverkant van dezelfde web-app aan (de Next.js-server of Node), en een React Native- of Flutter-project ook zijn eigen native Android- en iOS-crashrapporten.
Kom je er niet uit? Mail support@blipit.io. Sleutels en het project-id van elk project staan onder API-sleutels in app.blipit.io.





