ログに残していないものはデバッグできません。 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は先に見つけます。
-
ルートを読む
どのルートがログを出し、どれがトレースし、どれがエラーを握りつぶすか。空白は、それぞれ証拠と修正を伴う指摘になります。
-
新しいスタックではなく、今のスタックで
使っているロガー、OpenTelemetryの設定、既存の規約のままです。新しい依存関係は追加せず、シークレットをログに出すこともありません。
-
修正はプルリクエストで
最初の1件は接続したときに届きます。以降はコードレビューに合わせて、そのブランチに対して届きます。
-
止まるべきときを知っている
すでに十分なら、そう言って止まります。