Isomo rigufi · Kinyarwanda

Uko wabona kandi ugakosora amakosa ku rubuga rwawe ruri ku murongo

Subiramo igikorwa cy'umushyitsi cyangiritse watanzwe, usabe umufasha gukosora ku ngingo imwe, wemeze igikorwa kimwe nyuma y'impinduka.

Tangira isomo rikorwamo imyitozoSoma inyandiko z’isomo

Ibi bigenewe nde?

Abashaka kubona no gukosora ibibazo abashyitsi bahura na byo. Uzakoresha urupapuro rw’ikibazo watanzwe; umufasha ashobora guhindura kode mu gihe usobanura ikibazo ukanasubiramo igikorwa cy’umushyitsi.

Mbere yo gutangira

Urubuga rutandukanye rw'umwitozo watanzwe n'umufasha wo kwandika kode. Umushinga wa Sentry w'umwitozo ni ubushake ku gice cy'ikurikirana; ohereza gusa amakosa y'impimbano watanzwe kandi ntukoreshe amakuru y'ibanga y'abashyitsi.

Igihe kigereranyijwe: 19–31 min

Igihe kigereranyijwe ukoresheje dosiye zo gutangiriraho zatanzwe, konti n’ibikoresho bikenewe byamaze gutegurwa. Gutegura, gutegereza gushyira urubuga kuri interineti, imeli cyangwa DNS bishobora gufata ikindi gihe. Gutegura serivisi y'igenzura no gutegereza kwakirwa byiyongera ku gihe. Umuhamagaro wa capture kuri mudasobwa si ikimenyetso cy'uko alert yakiriwe.

Ibyo uziga

  • Subiramo igikorwa nyacyo cyangiritse aho kugenzura gupakira urupapuro gusa.
  • Sangiza ibisobanuro bitekanye bihagije kugira ngo umufasha akosore ku ngingo imwe.
  • Emeza igikorwa cyakosowe n'uko ikurikirana ribireba rihagaze.

Dosiye z'imyitozo

Intambwe 1

Gerageza igikorwa cy'umushyitsi

Urupapuro rushobora gufunguka igikorwa cyarwo gifasha cyangiritse.

Saba umufasha gukorera public watanzwe kuri HTTP afungure urupapuro. Koresha “Find contact section”. Verisiyo practice-R1 watanzwe ishaka nkana ahantu hatariho, bityo imimerere ikavuga ko igikorwa cya Contact cyananiwe.

Bwira umufasha buto nyirizina, aho wari utegereje kugera n’ibyo wabonye. Contact ishobora kuba iri ku rupapuro ariko buto ntigereyo; urupapuro rwa mbere rwapakiwe gusa ntirwerekana iki kibazo.

Urugero rufatika

Kuvuga ikimenyetso mu buryo bufite akamaro ni: “Nakanze Find contact section muri practice-R1. Nari ntegereje ko Contact ifunguka, ariko imimerere yavuze Contact action failed.”

Koresha urugero watanzwe rw'igikorwa cyo kuvugana cyangiritse ku rubuga rutandukanye rw'umwitozo. Subiramo kunanirwa kwa buto, umenye impamvu yihariye uhindure ibikenewe gusa. Mfasha gusubiramo igikorwa kimwe no kugereranya mbere na nyuma. Niba ikurikirana rifunguye, koresha amakosa y'impimbano gusa n'umushinga wanjye bwite w'umwitozo; ntukohereze amakuru y'ibanga y'urupapuro cyangwa y'ifishi. Ntuvuge ko ikibazo cyakosowe kubera gusa ko cyashyizweho ikimenyetso cy'icyakemuwe.

Dosiye z'iyi ntambwe

Start hereDosiye z'imyitozo

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Shaka kandi ukosore ikosa ry'urubuga ruri ku murongo

Tangirira ku gikorwa cy'usura cyananiwe, hanyuma ukoreshe raporo ushake impamvu.

Gukurikirana bigira akamaro igihe bihuza ikimenyetso nyacyo na kode ushobora gusuzuma. Uru rupapuro rw'imyitozo rushakisha ku bushake igice cyo kukwandikira kitariho, bityo igikorwa cyo kukwandikira kikananirwa.

Twohereza gusa ikosa ridahinduka ry'igihimbano ku mushinga wawe wa Sentry. Raporo irimo release, ikimenyetso kiranga kopi ya kode yasohowe, n'aho ikosa ryabereye muri stack, hagaragaza dosiye n'umurongo wa kode bireba. Inyandiko y'ikibazo ihuza ibyo bimenyetso n'ibyo usura yageragezaga gukora.

Urugero rusobanuye

Urupapuro rw'ibanze ubwarwo rurafunguka neza. Gukanda «Find contact section», bisaba gushaka igice cyo kukwandikira, birananirwa kuko script isaba #contact-missing mu gihe HTML nyayo ifite id=contact.

Extra implementation exercise

Kuki kugenzura ko urupapuro rw'ibanze rusubiza HTTP 200 bitabona iri kosa?

Erekana igisubizo gisobanuye

HTML ishobora gufunguka neza mu gihe igikorwa cya JavaScript cyo nyuma kinanirwa. Subiramo igikorwa cyo kukwandikira, si icyifuzo cy'urupapuro gusa.

  • Igikorwa cyagizeho ingaruka kigeragezwa nyuma yo gufungura urupapuro.
  • Kuboneka bitandukanywa n'uko imikorere iba ari yo.

Intambwe 2

Kusanya gusa ibisobanuro bitekanye bifasha

Ha umufasha gihamya idafite amakuru y'ibanga y'abashyitsi.

Ha umufasha dosiye z’umwitozo, verisiyo y’urupapuro n’ikimenyetso cyo mu ntambwe ibanza. Birahagije gutangira gusuzuma uru rugero rwa hafi utohereje ubutumwa bw’ifishi cyangwa amakuru ya konti y’umushyitsi nyakuri.

Nukoresha umushinga wa Sentry w’inyongera, tegura agaciro kawo ka loader rusange gusa ufungure practice monitoring mbere yo kongera gutera ikosa ugenzura. Suzuma event ihuye n’igerageza n’amakuru yayo. Event igaragara muri Sentry itandukanye n’imenyesha rigeze mu gasanduku.

Urugero rufatika

Ikosa ryemewe watanzwe ni “Practice: missing contact target”. Event ifite akamaro ishobora kugira verisiyo y’umwitozo n’aho kode iri idafite ubutumwa nyakuri bw’umukoresha, aderesi ya imeri cyangwa token ya konti.

Sentry: loader ya mushakisha no gutangiza mu buryo bwihariye

Dosiye z'iyi ntambwe

Start hereDosiye z'imyitozo

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Ohereza raporo yo gusuzuma ifite imbibi

Kusanya ibihagije byo gusuzuma utarohereje inyandiko z'abakoresha uko zakabaye.

Tegura public project loader URL nk'uko bisobanuwe muri START-HERE.txt. Script ishyiraho callback yayo yo gutangiza mbere yo gufungura SDK, ikazimya tracing/replay kandi igakoresha beforeSend allowlist kuri iri kosa ridahinduka ryo kwitoza.

Event yo gusuzuma isubizwa ntirimo amakuru y'icyifuzo, ay'ukoresha, amakuru y'inyongera ashobora komekwaho (extras) cyangwa amateka y'ibikorwa na events byabanje (breadcrumbs). Amazina ya dosiye yo muri stack akurwamo query/hash. Ku rubuga nyarwo, suzuma buri nkomoko y'amakuru yo gusuzuma y'ibanga; sendDefaultPii=false yonyine si isezerano ko inyandiko yigenga cyangwa URL bitarimo amakuru bwite.

Akayunguruzo ka beforeSend karakaze ku bushake: hoherezwa gusa ubutumwa bw'igihimbano nyabwo 'Practice: missing contact target'. Ubundi butumwa burarekwa. Niba uhinduye amagambo y'ikosa ryo kwitoza, hindura allowlist ubigambiriye cyangwa kuba event ibuze bibe ibisanzwe. Ntukureho akayunguruzo gusa kugira ngo dashboard yuzure; suzuma amakuru ya event yemewe urebe ibitateganyijwe.

Niba nta event igeze, banza usuzume inyandiko y'ubutumwa idahinduka na beforeSend allowlist muri app.js. Event idahuye noneho yerekana ubutumwa kuri mudasobwa ko yashunguwe; ntibarwa nk'iyoherejwe. Igikoresho gisesengura URL gikoresha location.origin nk'ishingiro ryo kubona aderesi yuzuye y'amazina cyangwa inzira za dosiye zitanditsemo URL yuzuye. Izina ridashobora gusesengurwa kirisimbuza redacted aho kohereza umwimerere ushobora kuba ufite ibanga.

Ihitamo ryanditse rya loader rya data-lazy="no" rishyirwaho na script.dataset.lazy="no"; risaba ko SDK yuzuye ifungurwa hakiri kare. Amazina ya dosiye yo muri stack agumana gusa HTTP(S) origin/path nyuma yo gukuraho query/hash. Schemes zitari iz'urubuga zivanwamo amakuru y'ibanga aho koherezwa uko ziri.

Urugero rusobanuye

Ubutumwa bw'ikosa budahinduka nka «Practice: missing contact target», bivuga ko aho kukwandikira hagenewe habuze, burahagije kuri uyu mwitozo. Kohereza object yose ya fomu byongera ibyago bidafashije kumenya aho DOM igana habuze.

Sentry: loader ya mushakisha no gutangiza mu buryo bwihariye

Extra implementation exercise

Kuzimya PII isanzwe byahita bituma ubutumwa bw'amakosa ubwo ari bwo bwose butekana koherezwa?

Erekana igisubizo gisobanuye

Oya. Suzuma amakuru nyayo ya event kandi ugabanye ibyo kode yawe yohereza. Amakuru bwite ashobora kuba mu butumwa, URL, breadcrumbs na extras nubwo gukusanya PII isanzwe byazimijwe.

  • Hamenyekana ko inyandiko za porogaramu/URL bishobora gukomeza kugira amakuru y'ibanga.
  • Hakoreshwa gukuramo amakuru y'ibanga/allowlist mu buryo bweruye.

Intambwe 3

Kora ugukosora kumwe kwibanda ku kibazo

Subiramo igikorwa nyirizina cyanze nyuma y'impinduka.

Saba umufasha kugereranya aho buto idakora igana na Contact ihari. worked-solution/app.js watanzwe irimo ikosora rito ry’aho kujya; musabe kurikoresha yandike verisiyo y’umwitozo yakosowe nka practice-R2.

Fungura urupapuro practice-R2 rwavuguruwe wongere ukoreshe ya buto imwe. Igomba kugera kuri Contact ikerekana “Contact section opened.” Guhindura izina rya verisiyo gusa cyangwa kwandika muri Sentry ko ikibazo cyakemutse ntibihindura imikorere ya buto.

Urugero rufatika

Script ifite ikibazo ishaka #contact-missing ariko HTML ikagena Contact kuri #contact. Umufasha ashobora gukosora uko bihura; wemeza ibyavuyemo ukoresheje buto nanone.

Dosiye z'iyi ntambwe

Start hereDosiye z'imyitozo

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Huza raporo, ukosore impamvu kandi wongere ugerageze

Gushyira ku kibazo ikimenyetso ko cyakemutse ntibikosora kode.

Fungura igenzura, utere ikosa ry'igihimbano kandi ushake event nyayo muri konti yawe. Gereranya release na frame byayo na kode yatanzwe. Niba nta event igeze, suzuma gufunguka, ibibuza, igenamiterere ry'umushinga no kugezwa ku rusobe mbere yo kwibwira ko nta kosa ryabaye.

Simbuza script na worked-solution/app.js, uvugurure izina rya release kandi usubiremo igikorwa cyo kukwandikira. Igice gikwiye kigomba kunyerezwa kikagaragara. Gushyira ikibazo kuri resolved muri dashboard ntibisimbura iri genzura ry'imikorere.

Gusimbuza dosiye ni uburyo buto bw'umwitozo bwo kwerekana ikosora ry'inkomoko. Ku rubuga rwo kwitoza rucumbikiwe, kora commit ya app.js yahinduwe n'izina rya release, usuzume/usohore iyo revision, hanyuma wongere ugerageze URL yayo ya rusange. Kuvugurura gusa imimerere y'ikibazo cyangwa izina rya release ntibishyira ikosora rya selector mu bikorwa.

Urugero rusobanuye

R1 inanirwa kuri #contact-missing; R2 ikoresha #contact. Ikimenyetso gifatika cyo kugarura ni uko igikorwa cyo kukwandikira noneho gikora kuri revision yakosowe.

Extra implementation exercise

Ikibazo cyashyizwe kuri resolved ariko script yasohowe iracyashakisha #contact-missing. Ikibazo cyakosowe?

Erekana igisubizo gisobanuye

Oya. Imimerere ya dashboard ntishobora guhindura script. Sohora ikosora unyuze mu isuzuma kandi ugenzure igikorwa kuri iyo revision.

  • Hasuzumwa inkomoko/revision nyayo yasohowe.
  • Igikorwa cyananirwaga mbere kirongera kugeragezwa.

Intambwe 4

Soza inyandiko ifasha y'ikibazo

Gumana ikimenyetso cy'ikibazo, ugukosora n'igenzura bihujwe.

Uzuza incident-record.txt n’ikibazo cya buto cya mbere, ikosora rito ry’aho igana n’igisubizo cyo gusubiramo igikorwa ku rupapuro rwavuguruwe. Nutangaza impinduka y’umwitozo, genzura iyo verisiyo nyirizina yatangajwe aho kureba dosiye yo kuri mudasobwa gusa.

Gumana ibyo wabonye muri monitoring y’inyongera ukwabyo: niba event ya mbere yageze kuri Sentry, niba warateguye alert n’uko imenyesha ryageze koko. Inyandiko igomba gusobanura iki gikorwa cyakosowe n’ikibura gisigaye, si kuvuga ko urubuga rwose rutagira amakosa.

Urugero rufatika

Inyandiko ngufi y’ikibazo ihuza Contact yanze muri practice-R1, ikosora ry’aho igana n’igenzura ryatsinze kuri practice-R2. “Issue resolved” byonyine ntibivuga igisubizo cy’umushyitsi.

Dosiye z'iyi ntambwe

Start hereDosiye z'imyitozo

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

Umukoro wawe: andika inyandiko y'ikibazo y'ingirakamaro

Fasha uzasuzuma ubutaha kumva impamvu n'ibimenyetso byombi.

Uzuza inyandiko y'ikibazo ufite aho event iboneka yakuwemo amakuru y'ibanga, igikorwa cyagizeho ingaruka, source frame, impamvu shingiro n'igerageza ryasubiwemo rigatsinda. Niba ugenye alert, genzura ubutumwa bwo kumenyesha nyabwo ukwabwo utandukanye no kwakirwa kwa event.

Ongeraho ikosa rya kabiri ry'igihimbano muri kopi yawe yo kwitoza kandi usubiremo uruziga. Gumisha ubutumwa budahinduka kandi uhindure allowlist ubigambiriye; ntukagure igenzura wohereza amakuru yose y'urupapuro/fomu.

Urugero rusobanuye

«Selector y'aho igana habuze yakosowe iva kuri #contact-missing ijya kuri #contact; igerageza rya R2 ryasubiwemo riratsinda» bitanga igikorwa. «Sentry yari ifite ikosa; ryakemutse» bisiga impamvu n'igenzura bitazwi.

Ubuyobozi bwuzuye bw'urugero buri muri reference/assignment-walkthrough.txt. Gereranya intambwe zabwo n'ibyo wakoze; uzuza inyandiko y'igerageza ukurikije ibyo wabonye mu mushinga wawe.

Extra implementation exercise

Kora inyandiko y'ikibazo kandi wemeze ko igikorwa cy'ukoresha cyakosowe gikora.

Erekana igisubizo gisobanuye

Fungura practice loader yagenwe kandi utere ikosa ry'igihimbano nyine. Niba uhinduye inyandiko y'ikosa, hindura allowlist ikarishye ubigambiriye; ubutumwa butari kuri allowlist bwaretswe ni ibisanzwe. Suzuma event nyayo yakiriwe urebe release/frame yayo n'amakuru utashakaga.

Shyira script yakosowe yatanzwe muri public/app.js kandi uhindure RELEASE ibe practice-R2. Sohora iyo revision yo kwitoza unyuze mu buryo bwasuzumwe, hanyuma usubiremo Find contact section kuri URL nyayo yasohowe. Guhindura gusa izina rya release cyangwa imimerere y'ikibazo ntibishobora gukosora selector.

Andika kwakirwa kw'ikibazo ukwako utandukanye no kugezwa k'ubutumwa bwa alert. Event ishobora kugaragara mbere y'uko alert yagenwe igera; gumisha icyo ari cyo cyose gitegerejwe kugeza kigenzuwe. Inyandiko y'ikibazo y'urugero ihuza kunanirwa, frame, impinduka ya selector n'igerageza ryasubiwemo rigaragarira ukoresha.

  • Ikimenyetso, release n'impamvu muri kode birahuzwa.
  • Imikorere iragenzurwa kandi ibyemezo byo kugezwa kwa event/n'ubutumwa bwo kumenyesha bigumishwa bitandukanye.

Iri somo ryagufashije?

Kanda ko urikunze, cyangwa urisangize uwo ryafasha.

Komeza kwiga

Reba andi masomo