JavaScript Full-stackSentry chuqur: release, sampling, PII tozalash va GlitchTip
JavaScript Full-stack · 34-qism. CI/CD, monitoring, bulut

Sentry chuqur: release, sampling, PII tozalash va GlitchTip

23 daqiqa15/30-dars

Qisqacha: Log xatoni yozadi, xato kuzatish tizimi esa uni issue ga aylantiradi: bir xil xatolar guruhlanadi, har birida stack, reliz va muhit ko'rinadi, yangi xato chiqsa xabar keladi. Ilova xatoni DSN manziliga yuboradi. Uch sozlama majburiy: release (qaysi image'da), environment (qaysi muhitda) va beforeSend — yuborishdan oldin shaxsiy ma'lumotni tozalash. Sentry o'rniga o'z serveringizda GlitchTip turishi mumkin: u Sentry API'si bilan mos, ilova kodi o'zgarmaydi — faqat DSN boshqa.

Bu darsda

  • Hodisa, issue va guruhlash farqini tushuntirasiz.
  • DSN tarkibini, release va environment vazifasini aytasiz.
  • Xatolar uchun sampleRate va trace'lardan namuna olish farqini ko'rasiz.
  • beforeSend bilan cookie, so'rov tanasi va email'ni tozalaydigan funksiya yozasiz.
  • Source map'siz stack nega dist faylga ishora qilishini o'z ko'zingiz bilan ko'rasiz.
  • GlitchTip'ni lokal ko'tarishda kanon tushgan tuzoqni bilib olasiz.

Oldin bilishingiz kerak: Observability: metrikalar, trace va xatolarni kuzatish, Xatolarni kuzatish: Sentry frontendda, Log agregatsiya: Loki, Grafana va Alloy, Stack trace va JavaScript xato turlari.

1. Nega bu kerak?

Log agregatsiya darsida vazifalar-api loglarini Loki'ga yig'dik. Endi har xato qatori bitta joyda turibdi. Lekin uni kim, qachon o'qiydi?

Tasavvur qiling: tunda yangi reliz chiqdi. Bitta funksiya ba'zi foydalanuvchilarda 500 qaytara boshladi. Loki'da yuzlab qator bor — hammasi bir xil xato. Ertalab hech kim bilmaydi: bu xato yangimi yoki oy boshidan beri bormi? Qaysi relizda boshlangan? Nechta foydalanuvchiga tegdi?

Log bu savollarga javob bermaydi, chunki u — oddiy yozuvlar oqimi. Bir xil xatoning ming nusxasi — ming qator. Xato kuzatish tizimi (error tracking) boshqacha ishlaydi. U har xatoni hodisa sifatida qabul qiladi, o'xshashlarini bitta issue ga birlashtiradi va har issue haqida xulosa beradi: birinchi va oxirgi ko'rinishi, soni, reliz, muhit, stack. Yangi issue paydo bo'lsa — xabar yuboradi.

31-qismda Sentry'ni faqat hujjat bo'yicha ko'rgan edik. Endi xato kuzatuvi loyihaga kiradi: Sentry'ning bulut xizmati o'rniga kanon Sentry bilan mos, o'z serverda turadigan GlitchTip'ni ko'tardi.

Hayotiy o'xshatish: poliklinika. Log — navbatchi hamshiraning daftari, unda har bemor qatorma-qator yozilgan. Xato kuzatuvi — bosh shifokorning jadvali: "bu hafta grippning 40 holati, birinchisi dushanba kuni, hammasi 3-mahalladan".

2. Xato kuzatish qanday ishlaydi

2.1 Hodisa, issue va guruhlash

Uchta so'zni ajratamiz:

Atama Nima Misol
hodisa (event) bitta xato, bitta paytda 05:30:01 dagi TypeError
issue bir xil hodisalar guruhi "TypeError @ vazifa.js:7", 40 marta
fingerprint guruhlash kaliti xato turi + stack'ning yuqori qatorlari

Tizim har hodisadan fingerprint (barmoq izi) hisoblaydi. Odatda bu xato turi va stack'ning muhim qatorlaridan tuziladi. Fingerprint bir xil bo'lsa — hodisa mavjud issue'ga qo'shiladi, yangi bo'lsa — yangi issue ochiladi va xabar ketadi.

Shuning uchun xato xabari ichidagi o'zgaruvchan qism (id, email) guruhlashni buzmasligi kerak. Sentry hujjatiga ko'ra, guruhlash avval qo'lda berilgan fingerprint'ga, keyin stack'ga, keyin xato turiga va eng oxiri xabar matniga qaraydi (tekshirildi, 2026-11). Mashqlarda guruhlashni awk bilan o'zimiz modellaymiz.

2.2 DSN — xato qayerga ketadi

DSN (Data Source Name) — loyihangizning xato qabul qiluvchi manzili. Ko'rinishi URL'ga o'xshaydi:

text
https://<ochiq-kalit>@<server>/<loyiha-id>

Unda uch qism bor: protokol va server (qayerga yuborish), ochiq kalit (qaysi loyiha nomidan) va loyiha raqami. Kalit "ochiq" deb ataladi: Sentry hujjatiga ko'ra, u faqat hodisa yuborishga ruxsat beradi, o'qishga emas (tekshirildi, 2026-11). Frontend'da DSN brauzerga baribir ko'rinadi — buni Sentry frontendda darsida ko'rgansiz. Shunday bo'lsa-da, backend'da DSN'ni .env da saqlaymiz: kimdir uni bilib, loyihangizni soxta hodisalar bilan to'ldirib yubormasin.

2.3 SDK'lar: bitta g'oya, har xil paket

Sentry'ning har platforma uchun SDK'si bor. Kursda ularning uchtasi bilan uchrashdingiz yoki uchrashasiz:

Qayerda Paket Qaysi darsda
React @sentry/react Sentry frontendda
Next.js @sentry/nextjs Xatolar, loglar va instrumentation
Node / NestJS @sentry/node shu dars

G'oya hamma joyda bitta: ilova boshida Sentry.init({ dsn, release, environment, … }), keyin ushlanmagan xatolar avtomatik, ushlanganlari — captureException(xato) bilan yuboriladi. Frontend'da yana ikki narsa muhim edi: iz (breadcrumbs — xatodan oldingi bosishlar, so'rovlar, konsol yozuvlari) va source map. Backend'da ham iz to'planadi: Node SDK hujjatiga ko'ra, sukut bo'yicha konsol va HTTP so'rovlari (sinalmagan, 2026-11). Source map'ga «Source map» bo'limida qaytamiz.

Hodisaning yo'li — ilovadan issue'gacha:

sequenceDiagram
  participant F as Problem filtri
  participant S as Sentry SDK
  participant B as beforeSend
  participant G as GlitchTip
  F->>S: captureException(xato)
  S->>S: sampleRate bo'yicha tanlash
  S->>B: hodisa (stack, release, muhit)
  B-->>S: tozalangan hodisa
  S->>G: DSN manziliga HTTP
  G->>G: fingerprint va issue

Diagrammaga qarang: tozalash tarmoqqa chiqishdan oldin, ilova ichida bo'ladi. Shaxsiy ma'lumot serverga umuman yetib bormaydi.

3. Loyiha uchun sozlash

3.1 Preload: ilovadan oldin yuklanadigan modul

Kanon @sentry/node 10.78.0 ni tanladi va uni ilovaning o'zidan oldin yuklanadigan alohida modulga qo'ydi — src/kuzatuv/boshlash.ts. Ishga tushirish:

bash
node --import=./dist/kuzatuv/boshlash.js dist/main.js

--import bayrog'i ko'rsatilgan modulni asosiy fayldan oldin bajaradi. Nega bu muhim? Xato kuzatuvi va trace kutubxonalari http, express, pg kabi modullarni "o'rab" oladi — ular import qilinishidan oldin. Kech ulansa, birinchi so'rovlar kuzatuvsiz o'tadi. Shu modulning ikkinchi yarmi — OpenTelemetry — Distributed tracing darsida. Bu modulni ulashda kanon jiddiy xatoga yo'l qo'ydi, uni ham o'sha darsda ko'ramiz.

Modulning Sentry qismi (izohlar qisqartirildi, uzun qatorlar telefon uchun bo'lindi, mazmuni kanon bilan aynan):

ts
import * as Sentry from "@sentry/node";
import { maxfiyTozala } from "./maxfiy.ts";

const reliz = process.env["APP_RELEASE"] ?? "lokal";

if ((process.env["SENTRY_DSN"] ?? "") !== "") {
  Sentry.init({
    dsn: process.env["SENTRY_DSN"],
    release: reliz,
    environment:
      process.env["APP_MUHIT"] ??
      process.env["NODE_ENV"] ??
      "development",
    sampleRate: Number(process.env["SENTRY_SAMPLE_RATE"] ?? "1"),
    // trace'lar — o'z OpenTelemetry SDK'imizda (yuqorida); Sentry o'z
    // OTel'ini qurmasin (ikki TracerProvider to'qnashadi).
    // tracesSampleRate berilmaydi — Sentry tracing o'chiq
    skipOpenTelemetrySetup: true,
    sendDefaultPii: false,
    beforeSend: (hodisa) => maxfiyTozala(hodisa),
  });
}

Har sozlama nima qiladi:

  • if (SENTRY_DSN …) — DSN berilmasa SDK umuman ishga tushmaydi. Testlar va lokal dasturlash o'zgarmaydi, tarmoqqa hech narsa ketmaydi.
  • release — reliz nomi. Kanonda bu image tegi (APP_RELEASE), ya'ni CD qo'ygan sha-<40 hex> (CI/CD tushunchasi).
  • environment — muhit: production, staging, lokal. Bitta loyihada staging xatolari production issue'larini aralashtirmasin.
  • sampleRate — xatolarning qancha ulushi yuboriladi («Sampling» bo'limida).
  • skipOpenTelemetrySetup: true — 10-versiyada Sentry'ning Node SDK'si trace uchun o'z ichida OpenTelemetry'ni quradi. Kanonda trace'lar o'z OTel SDK'imizda — ikkitasi to'qnashmasin.
  • sendDefaultPii: false — SDK o'zi IP manzil, cookie kabi ma'lumotlarni qo'shmasin.
  • beforeSend — har hodisa yuborilishidan oldin chaqiriladigan funksiya («PII tozalash» bo'limida).

Diqqat: 2026-11 holatiga @sentry/node ning 11-versiyasi chiqqan. Migratsiya qo'llanmasiga ko'ra (tekshirildi, 2026-11): sendDefaultPii o'rniga dataCollection keldi va u berilmasa SDK hamma ma'lumotni yig'adi; skipOpenTelemetrySetup o'rniga enableOpenTelemetrySetup (sukut bo'yicha o'chiq). Kanon 10.78.0 da qoladi. 11 ga o'tsangiz, dataCollection ni aniq yozing — beforeSend baribir tozalaydi, lekin birinchi himoya qatlami yo'qolmasin.

3.2 Faqat kutilmagan xatolar

Hamma xatoni yuborish kerakmi? Yo'q. vazifalar-api da barcha xato bitta joydan o'tadi — global exception filter (Exception filter'lar, ProblemDetailsFilter). U xatoni turiga qarab ajratadi: IlovaXatosi (401, 404, 409, 422 …) — mijozga tushunarli javob; kutilmagan xato (dasturchi xatosi, DB uzilishi) — 500. Kanon captureException ni faqat ikkinchi yo'lga qo'ydi:

ts
private logla(xato: unknown): void {
  joriyLog(this.log).error({ err: xato }, "kutilmagan xato");
  // xato kuzatuvi (Sentry/GlitchTip) — faqat KUTILMAGAN xatolar
  // (4xx — mijoz xatosi, yuborilmaydi). SENTRY_DSN yo'q — no-op
  captureException(xato);
}

Nega 4xx yuborilmaydi? Noto'g'ri parol, eskirgan sessiya, mavjud bo'lmagan manzil — bular dastur xatosi emas, foydalanuvchining kutilgan xatti-harakati. Ularni yuborsangiz, minglab "issue" haqiqiy xatoni ko'mib yuboradi. Kanon o'lchovida bir daqiqalik yukda 401 so'rovlari soniyasiga 11.6 ta edi (Metrikalar darsi). Ularning har biri issue'ga tushsa nima bo'lishini tasavvur qiling.

captureException SDK ishga tushmagan bo'lsa hech narsa qilmaydi (no-op). Shuning uchun filtr kodida if kerak emas.

Tekshirib ko'ring: Jamoadosh taklif qildi: "ProblemDetailsFilter ning boshida, catch() ning birinchi qatorida captureException(xato) chaqiraylik — hech narsa qochib ketmasin". Nima bo'ladi?

Javob

Har 401, 404, 409, 422 ham xato kuzatuviga ketadi. Issue'lar ro'yxati mijoz xatolari bilan to'lib qoladi va haqiqiy 500 ko'rinmay qoladi. Bulut xizmatida esa hodisa kvotasi tez tugaydi. To'g'ri joy — faqat kutilmagan xato shoxobchasi.

3.3 release va environment: "qachon boshlandi?"

Xato kuzatuvining eng kuchli savoli — qaysi relizda paydo bo'ldi. Har hodisa release bilan keladi. Shuning uchun tizim har issue uchun "birinchi ko'ringan reliz"ni biladi. Agar sha-5955f74… relizidan keyin yangi issue ochilgan bo'lsa, gumon doirasi bitta deploy'ga qisqaradi.

Kanondagi GlitchTip bazasida aynan shunday maydonlar bor: first_release (birinchi reliz) va resolved_in_release (qaysi relizda tuzatildi) — «Natija: xato issue'ga aylandi» bo'limida ko'rasiz.

resolved_in_release ikkinchi muhim ishni qiladi. Issue'ni "keyingi relizda tuzatildi" deb yopasiz, xato esa o'sha relizdan keyin yana chiqsa, tizim uni regressiya deb qayta ochadi.

Bu ishlashi uchun reliz nomi bitta manbadan kelishi kerak. Kanonda zanjir shunday: CD image'ga sha-… teg qo'yadi, server shu teg bilan konteynerni ko'taradi, Compose esa tegni APP_RELEASE ga beradi. Trace'dagi xizmat versiyasi ham, GlitchTip'dagi reliz ham shu yerdan olinadi. Qo'lda yozilgan "v2-final" kabi nomlar bu zanjirni uzadi.

3.4 Sampling: hammasinimi yoki bir qisminimi

Namuna olish (sampling) — hodisalarning faqat bir ulushini yuborish. Sentry'da ikki xil sozlama bor va ularni adashtirmaslik kerak:

Sozlama Nimaga Kanonda
sampleRate xato hodisalari SENTRY_SAMPLE_RATE (Compose'da SENTRY_NAMUNA), sukut 1.0 — hammasi
tracesSampleRate trace (unumdorlik) berilmagan — trace'lar OTel'da

Xatolar odatda to'liq yuboriladi (Sentry hujjatida ham sampleRate sukuti 1.0, tekshirildi, 2026-11). Kam uchraydigan xato aynan eng qiziq bo'ladi — uni tashlab yuborish yaramaydi. Xatolardan namuna olish faqat bitta holatda o'rinli: xato bo'roni paytida kvota yoki serverni himoya qilish. Trace esa har so'rovda yoziladi, shuning uchun undan deyarli har doim namuna olinadi — buni Distributed tracing darsida ko'ramiz.

Namuna olish qanday ishlashini modellaymiz. Kodda Math.random o'rniga hodisa id'sidan olingan xesh ishlatildi — shunda natija har safar bir xil chiqadi:

js
function ulush(id) {
  let h = 0x811c9dc5;
  for (const belgi of id) {
    h ^= belgi.charCodeAt(0);
    h = Math.imul(h, 0x01000193) >>> 0;
  }
  return h / 0x100000000;
}

function namuna(hodisalar, stavka) {
  return hodisalar.filter((id) => ulush(id) < stavka).length;
}

const hodisalar = Array.from({ length: 10000 }, (_, i) => `x-${i}`);
for (const stavka of [1, 0.5, 0.1]) {
  const soni = namuna(hodisalar, stavka);
  console.log(`sampleRate ${stavka}: ${soni} ta`);
}
console.log(ulush("x-42") === ulush("x-42"));

Konsolda:

text
sampleRate 1: 10000 ta
sampleRate 0.5: 4987 ta
sampleRate 0.1: 1107 ta
true

Ikki narsaga qarang. Birinchidan, 0.1 aniq 1 000 ni emas, 1 107 ni berdi — namuna olish ehtimollik, kafolat emas. Ikkinchidan, oxirgi qator: bir xil id doim bir xil qarorga keladi. Trace'da bu juda muhim: bitta so'rovning hamma xizmatlari "yozamiz" yoki "yozmaymiz" degan bir xil qarorga kelishi kerak. Math.imul — 32 bitli butun ko'paytirish, >>> 0 — natijani ishorasiz songa aylantirish (Bitwise operatorlar).

Maslahat: hodisalar massivini 100 taga qisqartirib, 0.1 stavkada necha hodisa qolishini ko'ring. Kichik hajmda ulush 10 % dan qanchalik uzoqlashadi?

4. PII tozalash

4.1 Nima oqib chiqishi mumkin

PII (shaxsga doir ma'lumot) — email, telefon, IP, ism, parol, sessiya tokeni. sendDefaultPii: false SDK'ning o'zi qo'shadigan narsalarni o'chiradi. Lekin hodisaga baribir tushishi mumkin bo'lganlar ham bor:

  • so'rov sarlavhalari — Cookie (sessiya), Authorization (API kaliti);
  • so'rov tanasi — parol, vazifa matni;
  • URL'dagi query — ?email=aziz@example.com;
  • foydalanuvchi obyekti — email, IP;
  • xato xabarining o'zi — "aziz@example.com uchun eksport yiqildi".

Oxirgisi eng ayyori: xabarni dasturchi o'zi yozadi va unga nima tushishini oldindan bilmaydi. Xato kuzatuv tizimi esa — boshqa server, ko'pincha boshqa davlatda, boshqa odamlar kirish huquqi bilan. Shaxsga doir ma'lumotni chet elda saqlash qonuniy savol ham tug'diradi — O'zbekistonda hosting va to'lov voqeligi darsida.

4.2 maxfiy.ts

Kanon tozalashni alohida faylga chiqardi va unga test yozdi. Fayl (izohlar qisqartirildi, qatorlar bo'lindi, mazmuni aynan):

ts
import type { ErrorEvent } from "@sentry/node";

const MAXFIY_SARLAVHALAR = new Set([
  "cookie", "authorization", "x-api-key", "x-imzo", "set-cookie",
]);
const EMAIL = /[\w.+-]+@[\w-]+\.[\w.-]+/g;

/** hodisani joyida tozalaydi va qaytaradi */
export function maxfiyTozala(hodisa: ErrorEvent): ErrorEvent {
  const so = hodisa.request;
  if (so !== undefined) {
    delete so.cookies;
    delete so.data; // so'rov tanasi (parol, matn) — hech qachon
    if (so.headers !== undefined) {
      for (const k of Object.keys(so.headers)) {
        if (MAXFIY_SARLAVHALAR.has(k.toLowerCase())) {
          so.headers[k] = "[olib tashlandi]";
        }
      }
    }
    if (typeof so.query_string === "string") {
      so.query_string = so.query_string.replace(EMAIL, "[email]");
    }
  }
  if (hodisa.user !== undefined) {
    // foydalanuvchidan faqat id
    hodisa.user =
      hodisa.user.id === undefined ? {} : { id: hodisa.user.id };
  }
  for (const x of hodisa.exception?.values ?? []) {
    if (typeof x.value === "string") {
      x.value = x.value.replace(EMAIL, "[email]");
    }
  }
  return hodisa;
}

Uch qaror e'tiborga loyiq:

  1. Sarlavha nomi kichik harfga o'giriladi. HTTP sarlavhalari katta-kichik harfni farqlamaydi: Cookie, cookie, COOKIE — bitta sarlavha.
  2. Sarlavha o'chirilmaydi, qiymati almashtiriladi. Issue'da "Cookie bor edi" degan fakt tashxisga yordam beradi, qiymati esa kerak emas.
  3. Foydalanuvchidan faqat id. Kim zarar ko'rganini bilish uchun id yetarli — email kerak bo'lsa, uni o'z bazangizdan topasiz.

Sentry hujjatiga ko'ra, beforeSend null qaytarsa hodisa umuman yuborilmaydi (tekshirildi, 2026-11). Kanon funksiyasi doim tozalangan hodisani qaytaradi.

Test (test/maxfiy.test.ts) hamma holatni bitta hodisada tekshiradi. Asosiy tasdiqlar:

ts
assert.equal(t.request.cookies, undefined);
assert.equal(t.request.data, undefined);
assert.deepEqual(t.request.headers, {
  Cookie: "[olib tashlandi]",
  Authorization: "[olib tashlandi]",
  "User-Agent": "k6",
});
assert.equal(t.request.query_string, "q=[email]");
assert.deepEqual(t.user, { id: "7" });
assert.equal(t.exception?.values?.[0]?.value, "[email] uchun xato");

Kirishda User-Agent ham bor edi — u PII emas va o'z joyida qoldi. Test faqat "o'chirildimi"ni emas, "keragi qoldimi"ni ham tekshiradi. Biz bu testni qatorlari bo'lingan maxfiy.ts bilan qayta yurgizdik — o'tdi.

Tekshirib ko'ring: Ertaga API'ga X-Telegram-Token sarlavhasi qo'shiladi. maxfiyTozala uni tozalaydimi? Buni qanday kafolatlash mumkin?

Javob

Yo'q — ro'yxat aniq nomlardan iborat ("ruxsat bermaslik ro'yxati"). Yangi sir qo'shilsa, uni ro'yxatga qo'shishni unutish oson. Ishonchliroq yo'l — teskari ro'yxat: faqat zararsiz sarlavhalarni (User-Agent, Accept, Content-Type) qoldirib, qolganini olib tashlash. Har ikki holda ham testga yangi sarlavhani qo'shing.

4.3 Ikkinchi qatlam: log ham tozalanadi

Xato bir vaqtda ikki joyga ketadi: logga (Loki) va xato kuzatuviga (GlitchTip). Log tomonida tozalash 25-qismdan beri bor — Pino'ning redact ro'yxati: authorization, cookie, x-api-key, *.parol, *.token qiymatlari [yashirildi] bo'ladi (Pino chuqur). Ikki ro'yxat ikki faylda yashaydi — biri yangilanib, ikkinchisi unutilishi mumkin. Bu — kanonning ochiq qolgan nuqtasi.

5. Source map: stack qaysi faylga ishora qiladi

Production'da TypeScript emas, kompilyatsiya qilingan JavaScript ishlaydi — dist/ papkasi. Xato stack'i ham dist dagi qator va ustunni ko'rsatadi. Buni kichik misolda ko'ramiz (biz ishga tushirdik, Node 24.21.0, TypeScript 6.0.3; vaqtinchalik papka yo'li …/ ga qisqartirildi):

ts
interface Foydalanuvchi { ism: string; manzil?: { shahar: string } }

function shahar(f: Foydalanuvchi): string {
  return f.manzil!.shahar.toUpperCase();
}

console.log(shahar({ ism: "Aziz", manzil: { shahar: "Toshkent" } }));
console.log(shahar({ ism: "Olim" }));

tsc --sourceMap bilan kompilyatsiya qildik va ikki xil ishga tushirdik:

text
$ node dist/hisob.js
TOSHKENT
…/dist/hisob.js:4
    return f.manzil.shahar.toUpperCase();
                    ^

TypeError: Cannot read properties of undefined (reading 'shahar')
    at shahar (…/dist/hisob.js:4:21)
$ node --enable-source-maps dist/hisob.js
TOSHKENT
…/hisob.ts:4
  return f.manzil!.shahar.toUpperCase();
                   ^

TypeError: Cannot read properties of undefined (reading 'shahar')
    at shahar (…/hisob.ts:4:20)

Tarjimasi: "aniqlanmagan qiymatning shahar xususiyatini o'qib bo'lmaydi". Birinchi ishga tushirishda stack JS faylga ishora qiladi va unda ! belgisi yo'q — TypeScript'ning tip izohlari o'chib ketgan. Ikkinchisida Node .map faylini o'qib, xatoni asl .ts faylning 4-qatoriga qaytardi.

Source map (manba xaritasi) — kompilyatsiya qilingan kodning har joyi asl kodning qaysi joyiga mos kelishini yozgan fayl. Katta loyihada bitta dist qatorida o'nlab ifoda turadi: keyinroq production xatosining stack'i vazifa.js:7:124 ga — 124-ustunga ishora qiladi.

vazifalar-api da tsconfig.build.json allaqachon sourceMap: true, Dockerfile esa butun dist/ ni image'ga ko'chiradi — .map fayllari image'da bor, lekin ishlatilmayapti. Ikki yo'l bor:

Yo'l Qanday Narxi
node --enable-source-maps stack ilova ichida tiklanadi Error.stack o'qilganda kechikish (Node hujjati); kanonda sinalmagan
xaritani xato kuzatuviga yuklash sentry-cli, reliz nomi bilan CI'ga qadam; kanonda sinalmagan

Ikkinchi yo'lda xaritalar serverga chiqmaydi va stack xato kuzatuv tizimining o'zida tiklanadi — frontend uchun aynan shu yo'l (Sentry frontendda, hidden source map). Backend kodi o'zingizning serveringizda turadi, shuning uchun birinchi yo'l soddaroq.

6. GlitchTip: o'z serveringizda

6.1 Nima va nega

GlitchTip — ochiq manbali xato kuzatuv tizimi. U Sentry'ning hodisa qabul qilish API'si bilan mos, shuning uchun ilova o'sha @sentry/node SDK'sini ishlatadi — faqat DSN GlitchTip serveriga ishora qiladi. Sentry'ning o'zini ham o'z serverga qo'yish mumkin, lekin hujjatdagi minimumi — 4 yadro va 16 GB RAM (+16 GB swap). GlitchTip hujjati esa bitta konteynerli o'rnatish uchun 256 MB RAM ni minimum deydi (ikkalasi tekshirildi, 2026-11).

Sentry (bulut) GlitchTip (o'z serveringiz)
O'rnatish hisob ochish Docker: ilova + Postgres + Redis
Ma'lumot qayerda provayder serverida o'zingizda
Imkoniyatlar keng: profiling, replay va boshqalar asosiy: issue, reliz, alert
Kanonda sinalmagan sinaldi, lokal

6.2 Kanon tajribasi: ko'tarish

Kanon GlitchTip 6.2.6 ni ilova stack'ining ichki tarmog'ida, uchta konteyner bilan ko'tardi. Buyruqlar (konteyner nomlari qisqartirildi, parol o'zgaruvchidan; kurs tajribasida u tasodifiy 32 bayt edi):

bash
docker run -d --name gt-redis --network vazifalar_ichki \
  --memory 64m redis:8.8.4
docker run -d --name gt-db --network vazifalar_ichki \
  -e POSTGRES_PASSWORD="$SIR" -e POSTGRES_DB=glitchtip \
  --memory 256m postgres:18
docker run -d --name gt --network vazifalar_ichki \
  --network-alias glitchtip -p 127.0.0.1:4985:8000 --memory 768m \
  -e SERVER_ROLE=all_in_one \
  -e DATABASE_URL="postgres://postgres:$SIR@gt-db:5432/glitchtip" \
  -e SECRET_KEY="$SIR" -e PORT=8000 \
  -e REDIS_URL=redis://gt-redis:6379/0 \
  -e GLITCHTIP_DOMAIN=http://glitchtip:8000 \
  -e DEFAULT_FROM_EMAIL=gt@vazifalar.example \
  -e EMAIL_URL=consolemail:// -e ENABLE_USER_REGISTRATION=false \
  glitchtip/glitchtip:6.2.6

Muhim joylar:

  • SERVER_ROLE=all_in_one — veb-server va fon ishchisi bitta konteynerda. Kichik loyiha uchun qulay; katta hajmda ularni ajratish mumkin.
  • --network-alias glitchtip — ilova DSN'da http://glitchtip:8000/… manzilini ishlatadi. Bu konteyner faqat ichki tarmoqda ko'rinadigan nom.
  • -p 127.0.0.1:4985:8000 — veb-interfeys faqat shu kompyuterdan ochiladi (Docker tarmoqlari darsidagi qoida).
  • ENABLE_USER_REGISTRATION=false — begona odam o'zi hisob ochib, xatolaringizni o'qimasin (sukut — true).
  • EMAIL_URL=consolemail:// — xatlar haqiqiy pochtaga emas, konsolga. Lokal sinov uchun.

Bitta kamchilik: kanonda baza paroli va SECRET_KEY — bir xil qiymat. Sinovga yetarli, production'da esa ular alohida sir bo'lsin.

Tashkilot, loyiha va DSN kanonda veb-interfeys orqali emas, GlitchTip ichidagi Django shell bilan yaratildi — skript takrorlanadigan bo'lsin deb. Odatda bu ishlar veb-interfeysda bir necha bosishda bajariladi.

6.3 Biz shunday xato qildik: begona Redis

Birinchi urinishda REDIS_URL berilmagan edi. GlitchTip sukut bo'yicha redis:6379 manziliga ulanadi. Bizning ichki tarmoqda esa redis nomli xizmat allaqachon bor edi — vazifalar ilovasining parolli Redis'i. GlitchTip unga ulandi va parolsiz murojaat qildi. Natija — NOAUTH (autentifikatsiya talab qilinadi) xatosi.

Parol bo'lmaganida GlitchTip ilovaning Redis'iga indamay yozib ketardi — navbat va kesh kalitlari aralashardi. Parol bizni shundan saqladi. Saboq: bitta Docker tarmog'idagi xizmat nomlari — umumiy nomlar maydoni. Begona ilovani tarmoqqa qo'shsangiz, uning sukut manzillarini aniq bering. Kanon GlitchTip'ga alohida gt-redis berdi. GlitchTip'ning hozirgi hujjatida bu o'zgaruvchi VALKEY_URL deb atalgan, eski REDIS_* nomlari ham ishlaydi (tekshirildi, 2026-11).

6.4 Natija: xato issue'ga aylandi

Keyingi darslarda loyihaga ataylab xato kiritamiz va uni topamiz (Production xatolarini tekshirish). O'sha xato GlitchTip'ga shunday tushdi (kanon chiqishi, qatorlar uzun):

text
issue: TypeError: Cannot read properties of undefined (reading 'toString') | short_id: 1 | hodisalar: 1
release: 4.2.0-k11 | muhit: lokal | request: {}
user: None | exception value: Cannot read properties of undefined (reading 'toString')

Nimani tekshiramiz:

  • release: 4.2.0-k11 — hodisa qaysi image'dan kelganini aniq aytadi;
  • muhit: lokal — APP_MUHIT ishladi;
  • user: None va request: {} — foydalanuvchi ma'lumoti ham, so'rov ma'lumoti ham yo'q.

Oxirgi qatorni halol o'qiylik. request: {} — so'rov umuman hodisaga tushmagan, demak maxfiyTozala bu yerda tozalaydigan narsa topmagan. Buning sababi SDK sozlamasida bo'lishi mumkin (o'z OTel'imiz, skipOpenTelemetrySetup). Kanon buni tekshirmadi. Shuning uchun tozalashning isboti — GlitchTip chiqishi emas, «maxfiy.ts» bo'limidagi test. Ertaga SDK yangilanib, so'rovni qo'sha boshlasa, test himoya qiladi.

Yana bir kichik topilma. Kanonning birinchi so'rov skripti issue'larni Sentry'dagidek last_seen bo'yicha saralamoqchi bo'ldi va Django xatosini oldi. Xato matni maydonlar ro'yxatini ham chiqardi — first_release va resolved_in_release ni shunda ko'rdik (qisqartirildi):

text
django.core.exceptions.FieldError: Cannot resolve keyword 'last_seen' into field. Choices are: … first_release, first_release_id, first_seen, … resolved_in_release, resolved_in_release_id, short_id, title, type, userreport

GlitchTip SDK darajasida Sentry bilan mos, lekin ichki tuzilmasi boshqa. Uning ichiga kirib ishlasangiz, Sentry hujjatiga tayanmang.

7. Narxi

Nima Kanonda
bog'liqlik @sentry/node va uning paketlari; OTel bilan birga prod bog'liqliklar 43 → 53
xavf xato ma'lumoti tashqariga chiqadi — beforeSend va test majburiy
o'z server 3 konteyner; xotira chegaralari 768 + 256 + 64 MB berildi, iste'mol o'lchanmadi
bulut hodisa kvotasi, narx — kanonda sinalmagan

Xatoni yuborish ilova uchun arzon: SDK hodisani javobni kutmasdan, fonda yuboradi (o'lchanmadi). Asl narx — kimdir issue'larni ko'rib chiqishi kerak. Hech kim qaramaydigan xato kuzatuvi — ikkinchi log daftari, xolos. Yangi issue'lar uchun bildirishnoma va navbatchilik — Uptime monitoring va alerting va SLI/SLO, incident va postmortem darslarida.

8. Loyiha qadami

O'z vazifalar-api ingizga qo'shing:

  1. Paket: npm i --save-exact @sentry/node@10.78.0.
  2. src/kuzatuv/maxfiy.ts va test/maxfiy.test.ts — «maxfiy.ts» bo'limidagidek.
  3. src/kuzatuv/boshlash.ts — «Preload» bo'limidagi Sentry qismi. OpenTelemetry qismi Distributed tracing darsida qo'shiladi.
  4. src/umumiy/problem.filter.ts — logla() ichida captureException(xato).
  5. GlitchTip'ni lokal ko'taring («Kanon tajribasi: ko'tarish»), DSN'ni .env ga SENTRY_DSN qilib yozing, APP_RELEASE va APP_MUHIT ni bering.

npm run check yashil bo'lishi kerak: DSN bo'lmagan testlarda SDK o'chiq. Hali commit qilmang — kuzatuv qatlami bir necha darsda yig'iladi. To'liq loyiha qadami va commit — Production xatolarini tekshirish va root cause darsida, 4.2.0 versiyasi bilan.

9. Ko'p uchraydigan xatolar

9.1 Har 4xx'ni yuborish

Issue ro'yxati mijoz xatolariga to'ladi, haqiqiy xato ko'rinmaydi. Faqat kutilmagan xato.

9.2 release yoki environment siz

"Qachon boshlandi?" savoliga javob yo'q, staging xatolari production'niki bilan aralashadi. Reliz nomi — image tegi, muhit — har doim.

9.3 Xato xabariga shaxsiy ma'lumot yozish

throw new Error(\${email} topilmadi`)— email to'g'ridan-to'g'ri hodisaga tushadi. Xabarga id yozing, email'ni emas.beforeSend` — oxirgi himoya chizig'i, birinchisi emas.

9.4 DSN'ni kodga yozish

DSN repo'ga tushsa, uni hamma ko'radi va soxta hodisalar bilan to'ldira oladi. .env va secret orqali bering.

10. Mashqlar

Mashqlar kurs/mashqlar/34/15-sentry/ da. 2-mashq Node 24.21.0 da, 3-mashq Git Bash'da tekshirilgan (biz ishga tushirdik).

1-mashq (oson): bo'shliqlarni to'ldiring

  • Bir xil xato hodisalarining guruhi —
  • Xato qabul qiluvchi manzil —
  • Yuborishdan oldin hodisani tozalaydigan sozlama —
  • Kanonda reliz nomi qayerdan olinadi — image
  • Sentry API'si bilan mos, o'z serverda turadigan tizim —
Yechim
  • issue — hodisalar fingerprint bo'yicha guruhlanadi.
  • DSN — protokol, server, ochiq kalit, loyiha raqami.
  • beforeSend — tarmoqqa chiqishdan oldin, ilova ichida.
  • tegi — APP_RELEASE, CD qo'ygan sha-….
  • GlitchTip — SDK o'zgarmaydi, faqat DSN.

2-mashq (o'rta): hodisani tozalash

tozala(hodisa) funksiyasini yozing. U asl obyektni o'zgartirmasin — nusxasini tozalab qaytarsin. Talablar: request.data o'chirilsin; request.headers dagi cookie va authorization (katta-kichik harf farqsiz) qiymati "[olib tashlandi]" bo'lsin; user dan faqat id qolsin (bo'lmasa — bo'sh obyekt); message dagi email'lar "[email]" ga almashsin.

Ishora: chuqur nusxa — structuredClone (Sayoz va chuqur nusxalash).

Yechim
js
const MAXFIY = ["cookie", "authorization"];
const EMAIL = /[\w.+-]+@[\w-]+\.[\w.-]+/g;

function tozala(hodisa) {
  const nusxa = structuredClone(hodisa);
  const so = nusxa.request;
  if (so) {
    delete so.data;
    for (const k of Object.keys(so.headers ?? {})) {
      if (MAXFIY.includes(k.toLowerCase())) {
        so.headers[k] = "[olib tashlandi]";
      }
    }
  }
  if (nusxa.user) {
    const id = nusxa.user.id;
    nusxa.user = id === undefined ? {} : { id };
  }
  if (typeof nusxa.message === "string") {
    nusxa.message = nusxa.message.replace(EMAIL, "[email]");
  }
  return nusxa;
}

const asl = {
  message: "aziz@example.com uchun eksport yiqildi",
  request: {
    headers: { COOKIE: "s=1", "User-Agent": "k6" },
    data: '{"parol":"x"}',
  },
  user: { id: "7", email: "aziz@example.com" },
};
console.log(JSON.stringify(tozala(asl)));
console.log(JSON.stringify(tozala({ message: "xato", user: {} })));
console.log(asl.user.email);

Konsolda:

text
{"message":"[email] uchun eksport yiqildi","request":{"headers":{"COOKIE":"[olib tashlandi]","User-Agent":"k6"}},"user":{"id":"7"}}
{"message":"xato","user":{}}
aziz@example.com

COOKIE katta harfda ham tozalandi, User-Agent qoldi. Oxirgi qator — asl obyektdagi email o'zgarmagan, chunki structuredClone nusxa oldi. Kanon funksiyasi esa hodisani joyida o'zgartiradi — SDK hodisani beforeSend ga aynan shu maqsadda beradi. Ikkala yo'l ham to'g'ri, faqat qaysi birini tanlaganingizni bilib turing.

3-mashq (qiyin): hodisalarni issue'larga guruhlash

Har qatorda bitta hodisa: vaqt, reliz, xato turi, stack'ning yuqori joyi. Bash skript yozing. U avval hodisalar.txt ni yaratsin (7 hodisa), keyin awk bilan fingerprint (tur @ joy) bo'yicha guruhlasin. Har issue uchun: hodisalar soni, birinchi ko'ringan reliz, oxirgi vaqt. Issue'lar birinchi ko'rinish tartibida chiqsin, oxirida — jami issue va hodisa soni.

Ishora: awk'da massiv tartibsiz aylanadi. Tartibni saqlash uchun yangi kalitni alohida tartib[++n] massiviga yozing. Kalit borligini (iz in soni) tekshiradi (Fayl va matn qidirish).

Yechim
bash
cat > hodisalar.txt <<'TXT'
05:30:01 4.2.0 TypeError vazifa.js:7
05:30:09 4.2.0 TypeError vazifa.js:7
05:31:40 4.2.0 RangeError sana.js:12
05:32:02 4.2.1 TypeError vazifa.js:7
05:33:15 4.2.1 TypeError vazifa.js:9
05:34:50 4.2.1 RangeError sana.js:12
05:35:00 4.2.1 TypeError vazifa.js:7
TXT
awk '
{
  iz = $3 " @ " $4
  if (!(iz in soni)) { tartib[++n] = iz; birinchi[iz] = $2 }
  soni[iz]++
  oxirgi[iz] = $1
}
END {
  for (i = 1; i <= n; i++) {
    iz = tartib[i]
    print iz ": " soni[iz] " ta, birinchi reliz " birinchi[iz] \
      ", oxirgi " oxirgi[iz]
  }
  print "issue: " n ", hodisa: " NR
}
' hodisalar.txt

Biz ishga tushirdik:

text
TypeError @ vazifa.js:7: 4 ta, birinchi reliz 4.2.0, oxirgi 05:35:00
RangeError @ sana.js:12: 2 ta, birinchi reliz 4.2.0, oxirgi 05:34:50
TypeError @ vazifa.js:9: 1 ta, birinchi reliz 4.2.1, oxirgi 05:33:15
issue: 3, hodisa: 7

Yetti hodisa uchta issue'ga aylandi. Uchinchisiga qarang: tur bir xil (TypeError), lekin joy boshqa — demak boshqa xato. U 4.2.1 da birinchi marta ko'rindi, ya'ni shu reliz olib kelgan. Haqiqiy tizim shunday qilib "4.2.1 dan keyin yangi issue" xabarini yuboradi. Bizning modelda stack'dan faqat bitta qator olinadi. Haqiqiy fingerprint esa bir nechta qatorga qaraydi va qator raqami o'zgarganda ham guruhni saqlab qolishga harakat qiladi.

11. Real ishda

  • Deyarli har production jamoada xato kuzatuvi bor: yangi issue Slack yoki Telegram kanaliga tushadi, navbatchi uni egasiga biriktiradi.
  • Reliz bilan bog'lash — CD'ning odatiy qadami: deploy'dan keyin reliz nomi va commit'lar ro'yxati xato kuzatuviga yuboriladi.
  • Shaxsiy ma'lumot — audit savollaridan biri: "Xato hisobotlaringizda foydalanuvchi email'lari bormi?" beforeSend va uning testi shu savolga javob.
  • Intervyu savollari: "Log va xato kuzatuvi farqi nima?", "Nega 4xx'ni Sentry'ga yubormaysiz?", "Source map'ni production'da qanday ishlatasiz?"

Xulosa

  • Xato kuzatuvi hodisalarni fingerprint bo'yicha issue'larga guruhlaydi va yangi issue haqida xabar beradi.
  • DSN — yuborish manzili; uni .env da saqlang.
  • release (image tegi) va environment — "qachon va qayerda" savoliga javob, regressiyani ham shular ochadi.
  • Xatolar odatda to'liq yuboriladi (sampleRate 1.0), trace'lardan esa namuna olinadi.
  • beforeSend — cookie, so'rov tanasi, email'ni tarmoqqa chiqishdan oldin tozalaydi; uni test himoya qiladi.
  • Faqat kutilmagan xatolar yuboriladi, 4xx — yo'q.
  • Source map'siz stack dist ga ishora qiladi: --enable-source-maps yoki xaritani yuklash.
  • GlitchTip — Sentry SDK bilan ishlaydigan o'z server varianti; bitta tarmoqdagi xizmat nomlari to'qnashishi mumkin.

Keyingi dars: Uptime monitoring va alerting — sayt butunlay yiqilganini mijozdan oldin bilish va xabarni to'g'ri odamga yetkazish.

Manbalar

34-qism. CI/CD, monitoring, bulut · 15-dars yakunlandi

Sentry chuqur: release, sampling, PII tozalash va GlitchTip

23 daqvaqt
0belgi
Keyingi dars: Uptime monitoring va alerting: sayt yiqilganini mijozdan oldin bilish
Telegram'da
Darsda xato koʻrdingizmi?

Izohlar · 0