沒記錄下來的東西，你就沒辦法除錯。 Polylane 找到你的盲點，並把它們補上。
加入候補名單 Observability improvements for #218 polylane +22 −2
Requests do not produce one context-rich event
3 affected routes · found after the last sync
server/api/checkout.post.ts mirrors your existing OpenTelemetry setup; no new dependencies
export default defineEventHandler(async (event) => {
const body = await readBody(event);
- const order = await createOrder(body);
- return { orderId: order.id };
+ return tracer.startActiveSpan("checkout", async (span) => {
+ const canonical: Record<string, unknown> = {
+ route: "checkout",
+ requestId: event.context.requestId,
+ cartId: body.cartId,
+ traceId: span.spanContext().traceId,
+ };
+ try {
+ const order = await createOrder(body);
+ span.setAttributes({ "order.id": order.id, "order.amount_cents": order.amountCents });
+ Object.assign(canonical, { orderId: order.id, amountCents: order.amountCents, outcome: "ok" });
+ return { orderId: order.id };
+ } catch (err) {
+ span.recordException(err);
+ span.setStatus({ code: SpanStatusCode.ERROR });
+ canonical.outcome = "error";
+ throw err;
+ } finally {
+ span.end();
+ emitCanonicalLogLine(canonical);
+ }
+ });
});
Opened against the pull request's own branch, so it can merge before the branch does.
你總是在事件中途才發現少了那行日誌。 Polylane 先找到它。
-
它讀你的路由
哪些有記錄日誌、哪些有追蹤、哪些吞掉了錯誤。缺口變成發現，每一項都附有證據與修復。
-
用你的技術棧，不是新的
你的 logger、你的 OpenTelemetry 設定、你的慣例。不加新依賴，絕不記錄機密。
-
修復以 pull request 送達
第一個在你連接時送達。之後的會隨程式碼審查一起出現，針對你的分支。
-
它知道什麼時候該停
已經夠完善了？它會直說，然後停下。