Laboratóriumi üzemeltetés és hibaelhárítás

Ezt az útmutatót a különálló helyi laboratóriumhoz használd, nem az éles postafiók-helyreállításhoz. Olvasd el először a konfigurációt és az előfeltételeket.

Kezdeti ellenőrzések

Ellenőrizd a 5090 portot és a Diagnostics (diagnosztika) konfigurációját és tanúsítványállapotát. Ellenőrizd a nyilvános HTTPS-callbacket, a távoli előfizetés állapotát és a végrehajtás állapotát (SUCCEEDED, EXPIRED vagy FAILED). Ha egy eredmény hibásnak tűnik, hasonlítsd össze a nyers választ a normalizált eseményekkel.

Nincsenek webhook-érkezések

Ha az előfizetés létrehozása sikeres, de a hívásszám nem változik, ellenőrizd a nyilvános callbacket és az alagút útválasztását. Nézd meg az előfizetés részleteit és lejáratát. Javítsd a callbacket, majd hozz létre megfelelő cserélő előfizetést. A privát localhost-útvonal nem fogadhat Graph-callbacket.

Lejárt delta-végrehajtás

Ha a Continue vagy a Replay lejárt szolgáltatói tokenre hivatkozik, használd a New root (új gyökér) műveletet. Ezt a végrehajtást új kiinduló ágként kezeld. Ne értelmezd a lejárt állapot folytatásaként.

Korlátozás vagy lassú olvasások

429/503 válasz vagy lassú teljes postafiók-művelet esetén szűkítsd a hatókört egy mappára. Kerüld az egyidejű, széles futásokat. Tartsd tiszteletben az újrapróbálási útmutatást, és várj a jelzett késleltetésig. A kéréskezelő segédfüggvény korlátozza a soron belüli újrapróbálásokat, ezért egy hosszú szolgáltatói késleltetés későbbi műveletet igényelhet.

Váratlan különbségek

Ellenőrizd a kiválasztott szülő-végrehajtást, a részleges patch egyesítését és a duplikáció-eltávolítás számát. A differ az ágállapotokat hasonlítja össze, nem az egész élő postafiók állapotát. Használd az adatmodell-útmutatót.

Érzékeny adatok

A műszerfal hitelesítése ki van kapcsolva. Tartsd a felületet megbízható fejlesztői környezetben. A reveal endpoint teljes folytatási URL-eket adhat vissza, amelyek tokenanyagot tartalmaznak. Ezeket az értékeket ne tedd képernyőképekbe, megosztott jelentésekbe vagy nyilvános naplókba.

A laboratóriumi adatbázis nyers kéréseket és üzenettartalmat tartalmazhat. Korlátozd a hozzáférését a nyilvános webhook-útvonaltól külön.

Helyi ellenőrzések

A laboratóriumi könyvtárból ezek a szkriptek kódot ellenőriznek vagy adatbázis-vizsgálót nyitnak meg:

pnpm check
pnpm test
pnpm db:studio

A pnpm test a tárolóhoz tartozó, adatbázis-előkészítést igénylő folyamatot futtatja. Futtatás előtt ellenőrizd a célkörnyezetet. A sikeres kódellenőrzés nem bizonyítja a nyilvános callback elérhetőségét vagy a sikeres postafiók-szinkronizálást.

Rutinszerű vizsgálathoz olvasd a Diagnostics részt, ellenőrizd az előfizetés állapotát, futtass egy célzott következő delta-végrehajtást, és hasonlítsd össze a differet. Váratlan eredménynél a visszajátszás és a nyers válaszok segítenek a kivizsgálásban.