Next.js Ilova Routeridagi Sentry: server va mijoz xatolari, PIIsiz manba xaritalari
Nima bo'lishi kerak
Server komponentida, Route Handler, Server Action yoki brauzerdagi xatolik Sentry-ga o‘qilishi mumkin bo‘lgan stek bilan (fayl nomlari va manba satrlari, kichiklashtirilgan to‘plam emas), chiqish ko‘rsatkichi bilan va voqeada shaxsiy foydalanuvchi ma’lumotlarisiz o‘tadi.
O'rnatish
npx @sentry/wizard@latest -i nextjs
Sehrgar fayllarni yaratadi va next.config ni tahrirlaydi. U nima qilganini aniqlang, keyin siz ularni qo'llab-quvvatlaysiz:
instrumentation-client.ts(SDK ning eski versiyalarida -sentry.client.config.ts) - brauzerda ishga tushirish.sentry.server.config.tsvasentry.edge.config.ts- Node.js va Edge ish vaqti uchun.instrumentation.ts- server ishga tushganda Next.js chaqiradigan kirish nuqtasi.app/global-error.tsx— ildiz tartibi uchun xato chegarasi.
// instrumentation.ts
import * as Sentry from "@sentry/nextjs";
export async function register() {
if (process.env.NEXT_RUNTIME === "nodejs") await import("./sentry.server.config");
if (process.env.NEXT_RUNTIME === "edge") await import("./sentry.edge.config");
}
export const onRequestError = Sentry.captureRequestError;onRequestError - bu Next.js 15 kancasi boʻlib, u marshrutni qayta ishlash va server amallarida xatolarni koʻrsatishda chaqiriladi. Ushbu qatorsiz server xatolari ko'pincha Sentryga etib bormaydi: Next.js ularni o'zi tutib oladi va foydalanuvchiga xato sahifasini ko'rsatadi.
PIIsiz server konfiguratsiyasi
// sentry.server.config.ts
import * as Sentry from "@sentry/nextjs";
Sentry.init({
dsn: process.env.SENTRY_DSN,
environment: process.env.APP_ENV ?? "production",
release: process.env.SENTRY_RELEASE,
sendDefaultPii: false,
tracesSampleRate: 0.1,
beforeSend(event) {
if (event.request) {
delete event.request.cookies;
delete event.request.data;
if (event.request.headers) {
delete event.request.headers.authorization;
delete event.request.headers.cookie;
}
}
return event;
},
});sendDefaultPii: false(bu sukut bo'yicha, lekin aniqroq yaxshiroq) - SDK IP manzilini, cookie fayllarini va foydalanuvchi ma'lumotlari sarlavhalarini biriktirmaydi.beforeSend- oxirgi qator: integratsiya yoki o'z kontekstingiz orqali olishingiz mumkin bo'lgan narsalarni olib tashlaydi. So'rovning asosiy qismi (request.data) ayniqsa xavfli: unda login formasidan parollar va to'lov ma'lumotlari mavjud.- Foydalanuvchini faqat identifikator orqali ko'rsating:
Sentry.setUser({ id: user.id }). Xato hodisalaridagi elektron pochta va nom nosozliklarni tuzatish uchun kerak emas, lekin uchinchi tomon tomonidan saqlanadi. tracesSampleRate: 0.1- samaradorlikni kuzatish bo'yicha so'rovlarning 10%. Ishlab chiqarishda 1,0 qiymati kvotani tezda tugatadi.
Xato matnlarini ham tekshiring. `throw new Error(${email} foydalanuvchisi topilmadi) отправит адрес в Sentry в сообщении, и никакой sendDefaultPii` buni to'xtata olmaydi.
Mijoz va seansni takrorlash
// instrumentation-client.ts
import * as Sentry from "@sentry/nextjs";
Sentry.init({
dsn: process.env.NEXT_PUBLIC_SENTRY_DSN,
tracesSampleRate: 0.1,
replaysSessionSampleRate: 0,
replaysOnErrorSampleRate: 0.2,
integrations: [Sentry.replayIntegration({ maskAllText: true, blockAllMedia: true })],
});Takrorlash sahifaning DOM-ni yozadi. maskAllText va blockAllMedia sukut bo'yicha yoqilgan - sahifalarda shaxsiy ma'lumotlar mavjud emasligiga ishonch hosil qilmasdan ularni o'chirmang. Faqat muvaffaqiyatsiz seanslarni yozib olish (replaysOnErrorSampleRate) foydalanuvchilarni doimiy nazorat qilmasdan disk raskadrovka uchun kontekstni ta'minlaydi.
Brauzerdagi DSN tabiatan ommaviydir: u faqat voqealarni yuborish imkonini beradi. Boshqa odamlarning saytlari loyihangizni to'sib qo'ymasligi uchun Sentry loyihasi sozlamalarida (Ruxsat berilgan domenlar) ruxsat etilgan domenlarni cheklang.
Manba xaritalar
// next.config.ts
import { withSentryConfig } from "@sentry/nextjs";
const nextConfig = { /* ... */ };
export default withSentryConfig(nextConfig, {
org: "my-org",
project: "web",
authToken: process.env.SENTRY_AUTH_TOKEN,
silent: !process.env.CI,
widenClientFileUpload: true,
sourcemaps: { deleteSourcemapsAfterUpload: true },
});next build vaqtida plagin manba xaritalarini Sentryga yuklaydi. deleteSourcemapsAfterUpload yuklangandan soʻng .map fayllarni oʻchirib tashlaydi, shunda manba kodi saytingizdagi hamma bilan baham koʻrilmaydi. O'rnatishdan keyin tekshiring: /_next/static/chunks/ dan istalgan .js.map ga so'rov 404 ni qaytarishi kerak.
SENTRY_AUTH_TOKEN loyihaga yozish ruxsatiga ega boʻlgan sirdir. U NEXT_PUBLIC_ prefiksi bo'lgan o'zgaruvchilarda emas, balki ish vaqtida emas, balki faqat qurish bosqichida CIda kerak bo'ladi.
Diagnostika
- Stekt kichraytirilgan. Manba xaritalari yuklanmagan yoki hodisa relizi yuklab olish versiyasi bilan mos kelmaydi.
sentry-cli sourcemaps explain <event_id>buyrug'i ma'lum bir hodisa nima uchun ramziylashtirilmaganligini tushuntiradi. - Server xatolari kelmaydi.
instrumentation.tsdaonRequestErroryoʻq yoki fayl loyiha ildizida emas (agarsrc/boʻlsa -src/ichida). - Ba'zi foydalanuvchilar uchun brauzer xatolari yuzaga kelmaydi. Reklamani bloklovchilar Sentryga so'rovlarni qisqartiradi.
withSentryConfigichidagitunnelRoute: "/monitoring"opsiyasi domeningiz orqali voqealarni proksi-server qiladi. Agar saytda qat'iy CSP bo'lsa, qabul qiluvchi domenniconnect-srcga qo'shing. - Hech narsa kelmaydi.
Sentry.initdadebug: trueni vaqtincha yoqing va server jurnallari va brauzer konsoliga qarang.
Shovqin va kvotalar
Har bir xato voqeaga arzimaydi. Kutilganlarni filtrlang: bekor qilingan so'rovlar, brauzer kengaytmasi xatolari, botlardan 404. Ma'lum xabarlar uchun ignoreErrors va kengaytma skriptlari uchun denyUrls dan foydalaning. Har kuni minglab bir xil ahamiyatsiz xatolar bo'ladigan loyiha jamoani Sentryga umuman qaramaslikka o'rgatadi.
Sentry ortiqcha bo'lganda
Kichkina ichki xizmat uchun error darajasidagi tuzilgan jurnallar va ularning soni haqida ogohlantirish yetarli bo'lishi mumkin. Sentry mijoz tomonida JavaScript, ko'plab foydalanuvchilar mavjud bo'lganda o'z samarasini beradi va siz xatolarni guruhlashingiz va qaysi nashr ularni keltirganini ko'rishingiz kerak.