{"id":2727,"date":"2026-10-24T09:40:40","date_gmt":"2026-10-24T09:40:40","guid":{"rendered":"https:\/\/wayhope.kro.kr\/?p=2727"},"modified":"2026-10-24T09:40:40","modified_gmt":"2026-10-24T09:40:40","slug":"node-js-%ea%b2%8c%ec%9e%84-%ec%84%9c%eb%b2%84-%eb%a1%9c%ea%b9%85-%ec%84%a4%ea%b3%84-%ea%b5%ac%ec%a1%b0%ed%99%94%eb%90%9c-%eb%a1%9c%ea%b7%b8%ec%99%80-pino","status":"publish","type":"post","link":"https:\/\/wayhope.kro.kr\/?p=2727","title":{"rendered":"Node.js \uac8c\uc784 \uc11c\ubc84 \ub85c\uae45 \uc124\uacc4 #\uad6c\uc870\ud654\ub41c \ub85c\uadf8\uc640 Pino"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">\uac8c\uc784 \uc11c\ubc84\uc5d0\uc11c \ub85c\uae45\uc740 \ub2e8\uc21c\ud788 \ucf58\uc194\uc5d0 \uba54\uc2dc\uc9c0\ub97c \ucd9c\ub825\ud558\ub294 \uae30\ub2a5\uc774 \uc544\ub2c8\ub2e4. \uc6b4\uc601 \ud658\uacbd\uc5d0\uc11c \ubc1c\uc0dd\ud55c \uc624\ub958\ub97c \ucd94\uc801\ud558\uace0, \uc694\uccad \ucc98\ub9ac \uacfc\uc815\uc744 \ubd84\uc11d\ud558\uba70, \uc7a5\uc560\uc758 \uc6d0\uc778\uc744 \ud30c\uc545\ud558\uae30 \uc704\ud55c \ud575\uc2ec \uad00\uce21 \uc2dc\uc2a4\ud15c\uc774\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ud2b9\ud788 \uc2e4\uc2dc\uac04 \uba40\ud2f0\ud50c\ub808\uc774\uc5b4 \uac8c\uc784 \uc11c\ubc84\ub294 \ub2e4\uc218\uc758 \ud074\ub77c\uc774\uc5b8\ud2b8\uac00 \ub3d9\uc2dc\uc5d0 \uc5f0\uacb0\ub418\uace0, API \uc694\uccad\uacfc WebSocket \uc774\ubca4\ud2b8\uac00 \ube44\ub3d9\uae30\uc801\uc73c\ub85c \ucc98\ub9ac\ub41c\ub2e4. \ub85c\uadf8\uac00 \uc77c\uad00\ub41c \ud615\uc2dd\uc73c\ub85c \uae30\ub85d\ub418\uc9c0 \uc54a\uc73c\uba74 \ud2b9\uc815 \uc0ac\uc6a9\uc790\uc758 \uc694\uccad\ubd80\ud130 \ub370\uc774\ud130\ubca0\uc774\uc2a4 \uc624\ub958, \uc11c\ubc84 \uac04 \ud1b5\uc2e0 \ubb38\uc81c\uae4c\uc9c0 \uc5f0\uacb0\ud574\uc11c \ubd84\uc11d\ud558\uae30 \uc5b4\ub835\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ub530\ub77c\uc11c \ub85c\uadf8\ub97c \uc124\uacc4\ud560 \ub54c\ub294 <strong>\uad6c\uc870\ud654\ub41c \ub85c\uadf8, \ub85c\uadf8 \ub808\ubca8, \ub85c\uadf8 \ub85c\ud14c\uc774\uc158, Request ID, Correlation ID<\/strong>\ub97c \ud568\uaed8 \uace0\ub824\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">\uad6c\uc870\ud654\ub41c \ub85c\uadf8<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">\uad6c\uc870\ud654\ub41c \ub85c\uadf8(Structured Logging)\ub294 \ub85c\uadf8\ub97c \uc790\uc720\ub85c\uc6b4 \ubb38\uc790\uc5f4\uc774 \uc544\ub2c8\ub77c \uc77c\uc815\ud55c \ud544\ub4dc\uc640 \uac12\uc73c\ub85c \uad6c\uc131\ub41c \ub370\uc774\ud130\ub85c \uae30\ub85d\ud558\ub294 \ubc29\uc2dd\uc774\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc77c\ubc18\uc801\uc778 \ub85c\uadf8\ub294 \ub2e4\uc74c\uacfc \uac19\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>2026-10-24 18:30:12 ERROR \uacb0\uc81c \ucc98\ub9ac \uc2e4\ud328 userId=abc123<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc0ac\ub78c\uc774 \uc77d\uae30\uc5d0\ub294 \uc5b4\ub835\uc9c0 \uc54a\uc9c0\ub9cc, \ub85c\uadf8 \uc218\uc9d1 \uc2dc\uc2a4\ud15c\uc5d0\uc11c \uc624\ub958 \uc720\ud615\uc774\ub098 \uc0ac\uc6a9\uc790 ID\ub97c \uae30\uc900\uc73c\ub85c \uac80\uc0c9\ud558\ub824\uba74 \ubb38\uc790\uc5f4\uc744 \ubd84\uc11d\ud574\uc57c \ud55c\ub2e4. \uba54\uc2dc\uc9c0 \ud615\uc2dd\uc774 \ubcc0\uacbd\ub418\uba74 \ud30c\uc2f1 \uaddc\uce59\ub3c4 \uc601\ud5a5\uc744 \ubc1b\ub294\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uad6c\uc870\ud654\ub41c \ub85c\uadf8\ub294 \uac19\uc740 \uc815\ubcf4\ub97c JSON\uc73c\ub85c \ud45c\ud604\ud55c\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"level\": \"error\",\n  \"time\": \"2026-10-24T09:30:12.000Z\",\n  \"event\": \"payment.failed\",\n  \"userId\": \"user-abc\",\n  \"requestId\": \"req-xyz\",\n  \"error\": {\n    \"message\": \"Database connection failed\"\n  }\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774\ub807\uac8c \uae30\ub85d\ud558\uba74 \ub85c\uadf8 \uc218\uc9d1 \uc2dc\uc2a4\ud15c\uc5d0\uc11c <code>level<\/code>, <code>event<\/code>, <code>userId<\/code>, <code>requestId<\/code>\ub97c \uac01\uac01 \ub3c5\ub9bd\uc801\uc778 \ud544\ub4dc\ub85c \uac80\uc0c9\ud558\uace0 \uc9d1\uacc4\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\uad6c\uc870\ud654\ub41c \ub85c\uadf8\uc758 \uc124\uacc4 \uc6d0\uce59<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\uc77c\uad00\ub41c \ud544\ub4dc \uc774\ub984<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uac19\uc740 \uc758\ubbf8\uc758 \ub370\uc774\ud130\ub294 \ubaa8\ub4e0 \uc11c\ube44\uc2a4\uc5d0\uc11c \ub3d9\uc77c\ud55c \ud544\ub4dc \uc774\ub984\uc744 \uc0ac\uc6a9\ud55c\ub2e4.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>userId<\/code>: \uc0ac\uc6a9\uc790 \uc2dd\ubcc4\uc790<\/li>\n\n\n\n<li><code>requestId<\/code>: \uac1c\ubcc4 \uc694\uccad \uc2dd\ubcc4\uc790<\/li>\n\n\n\n<li><code>correlationId<\/code>: \uc5ec\ub7ec \uc791\uc5c5\uc744 \uc5f0\uacb0\ud558\ub294 \uc2dd\ubcc4\uc790<\/li>\n\n\n\n<li><code>event<\/code>: \ubc1c\uc0dd\ud55c \uc0ac\uac74\uc758 \uc885\ub958<\/li>\n\n\n\n<li><code>durationMs<\/code>: \ucc98\ub9ac \uc2dc\uac04<\/li>\n\n\n\n<li><code>error<\/code>: \uc624\ub958 \uc815\ubcf4<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uc11c\ube44\uc2a4\ub9c8\ub2e4 <code>user_id<\/code>, <code>userId<\/code>, <code>uid<\/code>\ub97c \ud63c\uc6a9\ud558\uba74 \uac80\uc0c9\uacfc \ub300\uc2dc\ubcf4\ub4dc \uad6c\uc131\uc758 \ubcf5\uc7a1\ub3c4\uac00 \uc99d\uac00\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\uc774\ubca4\ud2b8 \uc911\uc2ec \uc124\uacc4<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ub85c\uadf8 \uba54\uc2dc\uc9c0\ub97c \uc790\uc5f0\uc5b4 \ubb38\uc7a5\uc5d0\ub9cc \uc758\uc874\ud558\uc9c0 \uc54a\uace0, \uc0ac\uac74\uc744 \uc2dd\ubcc4\ud560 \uc218 \uc788\ub294 \uc774\ubca4\ud2b8 \uc774\ub984\uc744 \uc815\uc758\ud55c\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"event\": \"matchmaking.completed\",\n  \"userId\": \"user-abc\",\n  \"roomId\": \"room-def\",\n  \"durationMs\": 245\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774\ubca4\ud2b8 \uc774\ub984\uc774 \uc77c\uad00\ub418\uba74 \ub9e4\uce6d \uc131\uacf5\ub960, \ucc98\ub9ac \uc2dc\uac04, \uc2e4\ud328\uc728 \ub4f1\uc744 \ub85c\uadf8 \uae30\ubc18\uc73c\ub85c \uc9d1\uacc4\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>\ud544\uc694\ud55c \uc815\ubcf4\ub9cc \uae30\ub85d<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ub85c\uadf8\uc5d0 \uc0ac\uc6a9\uc790 \ube44\ubc00\ubc88\ud638, \uc778\uc99d \ud1a0\ud070, \uac1c\uc778\uc815\ubcf4, \uacb0\uc81c \uc778\uc99d \uc815\ubcf4 \ub4f1\uc744 \uae30\ub85d\ud574\uc11c\ub294 \uc548 \ub41c\ub2e4. \uc7a5\uc560 \ubd84\uc11d\uc5d0 \ud544\uc694\ud55c \ucd5c\uc18c\ud55c\uc758 \uc815\ubcf4\ub9cc \ub0a8\uae30\uace0, \uc2dd\ubcc4 \uc815\ubcf4\ub3c4 \uc811\uadfc \uad8c\ud55c\uacfc \ubcf4\uc874 \uc815\ucc45\uc744 \uace0\ub824\ud574 \uad00\ub9ac\ud55c\ub2e4.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Pino<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Pino\ub294 Node.js \ud658\uacbd\uc5d0\uc11c \uc0ac\uc6a9\ud558\ub294 \uace0\uc131\ub2a5 \ub85c\uae45 \ub77c\uc774\ube0c\ub7ec\ub9ac\ub2e4. JSON \uae30\ubc18 \uad6c\uc870\ud654\ub41c \ub85c\uadf8\ub97c \uc9c0\uc6d0\ud558\uba70, \uac8c\uc784 \uc11c\ubc84\uc640 API \uc11c\ubc84\uc5d0\uc11c \uc6b4\uc601 \ub85c\uadf8\ub97c \uae30\ub85d\ud558\ub294 \ub370 \uc801\ud569\ud558\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Express \uae30\ubc18 \uc11c\ubc84\uc5d0\uc11c\ub294 HTTP \uc694\uccad \ub85c\uadf8, \ube44\uc988\ub2c8\uc2a4 \uc774\ubca4\ud2b8, \uc624\ub958 \ub85c\uadf8\ub97c \ub3d9\uc77c\ud55c \ub85c\uac70\ub97c \ud1b5\ud574 \uae30\ub85d\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\uc124\uce58<\/h3>\n\n\n\n<pre class=\"wp-block-code\"><code>npm install pino pino-http<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><code>pino<\/code>\ub294 \ub85c\uadf8\ub97c \uae30\ub85d\ud558\ub294 \ud575\uc2ec \ub77c\uc774\ube0c\ub7ec\ub9ac\uc774\uba70, <code>pino-http<\/code>\ub294 HTTP \uc694\uccad\uacfc \uc751\ub2f5\uc5d0 \ub300\ud55c \ub85c\uae45 \uae30\ub2a5\uc744 \uc81c\uacf5\ud55c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\uae30\ubcf8 \ub85c\uac70 \uad6c\uc131<\/h3>\n\n\n\n<pre class=\"wp-block-code\"><code>\/\/ logger.js\nconst pino = require(\"pino\");\n\nconst logger = pino({\n  level: process.env.LOG_LEVEL || \"info\",\n\n  timestamp: pino.stdTimeFunctions.isoTime,\n\n  redact: {\n    paths: &#91;\n      \"password\",\n      \"token\",\n      \"authorization\",\n      \"req.headers.authorization\"\n    ],\n    censor: \"&#91;REDACTED]\"\n  }\n});\n\nmodule.exports = logger;<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774 \uad6c\uc131\uc740 \ub85c\uadf8 \ub808\ubca8\uc744 \ud658\uacbd\ubcc0\uc218\ub85c \uc81c\uc5b4\ud558\uace0, \uc2dc\uac04\uc744 ISO \ud615\uc2dd\uc73c\ub85c \uae30\ub85d\ud558\uba70, \ubbfc\uac10\ud55c \ud544\ub4dc\ub97c \ub9c8\uc2a4\ud0b9\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ub2e8, <code>redact<\/code>\ub294 \uc2e4\uc81c \ub85c\uadf8 \uac1d\uccb4\uc758 \ud544\ub4dc \uacbd\ub85c\uc640 \uc77c\uce58\ud574\uc57c \ud55c\ub2e4. \uc778\uc99d \uc815\ubcf4\uac00 \ub2e4\ub978 \uacbd\ub85c\uc5d0 \ub4e4\uc5b4 \uc788\ub2e4\uba74 \ud574\ub2f9 \uacbd\ub85c\ub3c4 \ucd94\uac00\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\ube44\uc988\ub2c8\uc2a4 \uc774\ubca4\ud2b8 \uae30\ub85d<\/h3>\n\n\n\n<pre class=\"wp-block-code\"><code>const logger = require(\".\/logger\");\n\nasync function completeMatch(match) {\n  try {\n    await saveMatchResult(match);\n\n    logger.info(\n      {\n        event: \"match.completed\",\n        matchId: match.id,\n        roomId: match.roomId,\n        playerCount: match.players.length\n      },\n      \"Match completed\"\n    );\n  } catch (error) {\n    logger.error(\n      {\n        event: \"match.failed\",\n        matchId: match.id,\n        err: error\n      },\n      \"Failed to complete match\"\n    );\n\n    throw error;\n  }\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Pino\ub294 \uac1d\uccb4\ub97c \uccab \ubc88\uc9f8 \uc778\uc790\ub85c \uc804\ub2ec\ud574 \uad6c\uc870\ud654\ub41c \ud544\ub4dc\ub97c \uae30\ub85d\ud560 \uc218 \uc788\ub2e4. \uc624\ub958 \uac1d\uccb4\ub294 <code>err<\/code>\ucc98\ub7fc \uc624\ub958 \uc804\uc6a9 \ud544\ub4dc\ub85c \uc804\ub2ec\ud558\uba74 \uc2a4\ud0dd \ud2b8\ub808\uc774\uc2a4 \ub4f1 \uc624\ub958 \uc815\ubcf4\ub97c \uc77c\uad00\ub418\uac8c \uae30\ub85d\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc2e4\uc81c \uc6b4\uc601\uc5d0\uc11c\ub294 \uc0ac\uc6a9\uc790 ID\ub098 \ub9e4\uce58 ID\uac00 \ub85c\uadf8\uc5d0 \ud544\uc694\ud55c\uc9c0, \uadf8\ub9ac\uace0 \ud574\ub2f9 \uc2dd\ubcc4 \uc815\ubcf4\uac00 \uac1c\uc778\uc815\ubcf4\ub098 \ubcf4\uc548 \uc815\ucc45\uc5d0 \uc800\ucd09\ub418\uc9c0 \uc54a\ub294\uc9c0 \ud568\uaed8 \uac80\ud1a0\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Express \uc694\uccad \ub85c\uae45<\/h3>\n\n\n\n<pre class=\"wp-block-code\"><code>const express = require(\"express\");\nconst pinoHttp = require(\"pino-http\");\nconst logger = require(\".\/logger\");\n\nconst app = express();\n\napp.use(\n  pinoHttp({\n    logger,\n\n    customLogLevel(req, res, error) {\n      if (error || res.statusCode &gt;= 500) {\n        return \"error\";\n      }\n\n      if (res.statusCode &gt;= 400) {\n        return \"warn\";\n      }\n\n      return \"info\";\n    }\n  })\n);\n\napp.get(\"\/health\", (req, res) =&gt; {\n  res.json({ status: \"ok\" });\n});\n\napp.listen(3000);<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774 \uc124\uc815\uc740 HTTP \uc694\uccad\uacfc \uc751\ub2f5\uc744 \uc790\ub3d9\uc73c\ub85c \uae30\ub85d\ud558\uace0, \uc11c\ubc84 \uc624\ub958\ub098 \ud074\ub77c\uc774\uc5b8\ud2b8 \uc624\ub958\uc5d0 \ub530\ub77c \ub85c\uadf8 \ub808\ubca8\uc744 \uad6c\ubd84\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ub2e8, HTTP \uc694\uccad \ub85c\uadf8\ub9cc\uc73c\ub85c \uac8c\uc784 \uc11c\ubc84\uc758 \ubaa8\ub4e0 \ub3d9\uc791\uc744 \ucd94\uc801\ud560 \uc218 \uc788\ub294 \uac83\uc740 \uc544\ub2c8\ub2e4. WebSocket \uba54\uc2dc\uc9c0, \ub9e4\uce6d, \ub8f8 \uc0dd\uc131, \ubcf4\uc0c1 \uc9c0\uae09 \ub4f1\uc758 \ube44\uc988\ub2c8\uc2a4 \uc774\ubca4\ud2b8\ub294 \ubcc4\ub3c4\ub85c \uae30\ub85d\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ub610\ud55c \uc694\uccad \ub85c\uadf8\ub294 \uc694\uccad\ub7c9\uc5d0 \ube44\ub840\ud574 \uc99d\uac00\ud558\ubbc0\ub85c \ud5ec\uc2a4 \uccb4\ud06c \uc694\uccad\uc744 \uc81c\uc678\ud558\uac70\ub098 \ub85c\uadf8 \uc218\uc9d1 \ub2e8\uacc4\uc5d0\uc11c \ud544\ud130\ub9c1\ud558\ub294 \ubc29\ubc95\ub3c4 \uace0\ub824\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">\ub85c\uadf8 \ub808\ubca8<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">\ub85c\uadf8 \ub808\ubca8\uc740 \uc774\ubca4\ud2b8\uc758 \uc911\uc694\ub3c4\uc640 \uc6b4\uc601\uc0c1 \ub300\uc751 \ud544\uc694\uc131\uc744 \uad6c\ubd84\ud558\ub294 \uae30\uc900\uc774\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc77c\uad00\ub41c \ub85c\uadf8 \ub808\ubca8\uc744 \uc0ac\uc6a9\ud558\uba74 \uc6b4\uc601\uc790\ub294 \uc2ec\uac01\ud55c \uc624\ub958\ub97c \uc6b0\uc120 \ud655\uc778\ud558\uace0, \ubd88\ud544\uc694\ud55c \ub85c\uadf8\ub85c \uc778\ud55c \ube44\uc6a9\uacfc \ub178\uc774\uc988\ub97c \uc904\uc77c \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><tbody><tr><th>\ub808\ubca8<\/th><th>\uc6a9\ub3c4<\/th><th>\uc608\uc2dc<\/th><\/tr><tr><td><code>trace<\/code><\/td><td>\ub9e4\uc6b0 \uc0c1\uc138\ud55c \ub0b4\ubd80 \ud750\ub984<\/td><td>\uc138\ubd80 \ud504\ub85c\ud1a0\ucf5c \ucc98\ub9ac \ub2e8\uacc4<\/td><\/tr><tr><td><code>debug<\/code><\/td><td>\uac1c\ubc1c \ubc0f \ubb38\uc81c \ubd84\uc11d<\/td><td>\ub9e4\uce6d \uc870\uac74 \ud3c9\uac00 \uacb0\uacfc<\/td><\/tr><tr><td><code>info<\/code><\/td><td>\uc815\uc0c1\uc801\uc778 \uc8fc\uc694 \uc774\ubca4\ud2b8<\/td><td>\ub85c\uadf8\uc778 \uc131\uacf5, \ub8f8 \uc0dd\uc131<\/td><\/tr><tr><td><code>warn<\/code><\/td><td>\uc8fc\uc758\uac00 \ud544\uc694\ud55c \uc0c1\ud669<\/td><td>\uc7ac\uc2dc\ub3c4 \ubc1c\uc0dd, \uc694\uccad \uc81c\ud55c \ucd08\uacfc<\/td><\/tr><tr><td><code>error<\/code><\/td><td>\uc791\uc5c5 \uc2e4\ud328 \ubc0f \uc624\ub958<\/td><td>DB \uc800\uc7a5 \uc2e4\ud328, \uc678\ubd80 \uc11c\ube44\uc2a4 \ud638\ucd9c \uc2e4\ud328<\/td><\/tr><tr><td><code>fatal<\/code><\/td><td>\ud504\ub85c\uc138\uc2a4 \uc9c0\uc18d\uc774 \uc5b4\ub824\uc6b4 \uce58\uba85\uc801 \uc624\ub958<\/td><td>\ud544\uc218 \ucd08\uae30\ud654 \uc2e4\ud328\ub85c \uc778\ud55c \uc11c\ubc84 \uc885\ub8cc<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Pino\ub294 \uc774\ub7ec\ud55c \ub808\ubca8\uc744 \uc9c0\uc6d0\ud558\uba70, \ub85c\uadf8 \ub808\ubca8\uc744 \uc124\uc815\ud574 \uc9c0\uc815\ub41c \uc911\uc694\ub3c4 \uc774\uc0c1\uc758 \ub85c\uadf8\ub9cc \ucd9c\ub825\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc608\ub97c \ub4e4\uc5b4 <code>info<\/code>\ub85c \uc124\uc815\ud558\uba74 <code>trace<\/code>\uc640 <code>debug<\/code> \ub85c\uadf8\ub294 \ucd9c\ub825\ub418\uc9c0 \uc54a\uc9c0\ub9cc <code>info<\/code>, <code>warn<\/code>, <code>error<\/code>, <code>fatal<\/code>\uc740 \ucd9c\ub825\ub41c\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>const pino = require(\"pino\");\n\nconst logger = pino({\n  level: process.env.LOG_LEVEL || \"info\"\n});\n\nlogger.debug({ event: \"matchmaking.check\" }, \"Checking matchmaking\");\nlogger.info({ event: \"room.created\", roomId: \"room-abc\" }, \"Room created\");\nlogger.warn({ event: \"database.retry\" }, \"Retrying database operation\");\nlogger.error({ event: \"payment.failed\" }, \"Payment failed\");<\/code><\/pre>\n\n\n\n<h3 class=\"wp-block-heading\">\uc6b4\uc601 \ud658\uacbd\uc758 \ub85c\uadf8 \ub808\ubca8 \uc804\ub7b5<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\uac1c\ubc1c \ud658\uacbd\uc5d0\uc11c\ub294 <code>debug<\/code>\ub97c \uc0ac\uc6a9\ud574 \ub0b4\ubd80 \ub3d9\uc791\uc744 \uc790\uc138\ud788 \ud655\uc778\ud560 \uc218 \uc788\ub2e4. \uc6b4\uc601 \ud658\uacbd\uc5d0\uc11c\ub294 \uc77c\ubc18\uc801\uc73c\ub85c <code>info<\/code>\ub97c \uae30\ubcf8\uac12\uc73c\ub85c \uc0ac\uc6a9\ud558\uace0, \ubb38\uc81c\uac00 \ubc1c\uc0dd\ud55c \uad6c\uac04\uc5d0\uc11c\ub9cc \uc77c\uc2dc\uc801\uc73c\ub85c \uc0c1\uc138 \ub85c\uae45\uc744 \ud65c\uc131\ud654\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ub2e8, \ub85c\uadf8 \ub808\ubca8\uc744 \ub192\uc774\ub294 \uac83\ub9cc\uc73c\ub85c \ubaa8\ub4e0 \ubb38\uc81c\uac00 \ud574\uacb0\ub418\uc9c0\ub294 \uc54a\ub294\ub2e4. \uacb0\uc81c\ub098 \ubcf4\uc0c1 \uc9c0\uae09\uacfc \uac19\uc774 \uc911\uc694\ud55c \ube44\uc988\ub2c8\uc2a4 \uc774\ubca4\ud2b8\ub294 \uc77c\ubc18\uc801\uc778 \ub514\ubc84\uae45 \ub85c\uadf8\uc640 \ubcc4\uac1c\ub85c \ub204\ub77d \uc5c6\uc774 \uae30\ub85d\ub418\ub3c4\ub85d \uc124\uacc4\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ub610\ud55c <code>fatal<\/code> \ub85c\uadf8\uac00 \ucd9c\ub825\ub418\uc5c8\ub2e4\uace0 \ud574\uc11c \ud504\ub85c\uc138\uc2a4\uac00 \uc790\ub3d9\uc73c\ub85c \uc885\ub8cc\ub418\ub294 \uac83\uc740 \uc544\ub2c8\ub2e4. \uc2e4\uc81c \uc885\ub8cc\uc640 \ubcf5\uad6c \ub3d9\uc791\uc740 \uc560\ud50c\ub9ac\ucf00\uc774\uc158\uc758 \uc624\ub958 \ucc98\ub9ac \ubc0f \ud504\ub85c\uc138\uc2a4 \uad00\ub9ac \uc815\ucc45\uc5d0 \ub530\ub77c \uacb0\uc815\ub41c\ub2e4.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">\ub85c\uadf8 \ub85c\ud14c\uc774\uc158<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">\ub85c\uadf8 \ub85c\ud14c\uc774\uc158(Log Rotation)\uc740 \ub85c\uadf8 \ud30c\uc77c\uc774 \ubb34\ud55c\uc815 \uc99d\uac00\ud558\uc9c0 \uc54a\ub3c4\ub85d \uc77c\uc815\ud55c \uae30\uc900\uc5d0 \ub530\ub77c \ud30c\uc77c\uc744 \ubd84\ub9ac\ud558\uace0, \uc624\ub798\ub41c \ub85c\uadf8\ub97c \uc555\ucd95\ud558\uac70\ub098 \uc0ad\uc81c\ud558\ub294 \uad00\ub9ac \ubc29\uc2dd\uc774\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ub85c\uadf8 \ub85c\ud14c\uc774\uc158\uc774 \uc5c6\ub2e4\uba74 \uc7a5\uc2dc\uac04 \uc2e4\ud589\ub418\ub294 \uc11c\ubc84\uc5d0\uc11c \ub85c\uadf8 \ud30c\uc77c\uc774 \ub514\uc2a4\ud06c\ub97c \uac00\ub4dd \ucc44\uc6b8 \uc218 \uc788\ub2e4. \ub514\uc2a4\ud06c \uacf5\uac04 \ubd80\uc871\uc740 \ub2e8\uc21c\ud788 \ub85c\uadf8 \uae30\ub85d \uc2e4\ud328\uc5d0 \uadf8\uce58\uc9c0 \uc54a\uace0 \ub370\uc774\ud130\ubca0\uc774\uc2a4, \uc560\ud50c\ub9ac\ucf00\uc774\uc158, \ucee8\ud14c\uc774\ub108\uc758 \uc815\uc0c1 \ub3d9\uc791\uae4c\uc9c0 \uc704\ud611\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\uc8fc\uc694 \ub85c\ud14c\uc774\uc158 \uae30\uc900<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>\uc2dc\uac04 \uae30\uc900:<\/strong> \ub9e4\uc77c \ub610\ub294 \ub9e4\uc2dc\uac04 \ub85c\uadf8 \ud30c\uc77c \ubd84\ub9ac<\/li>\n\n\n\n<li><strong>\ud06c\uae30 \uae30\uc900:<\/strong> \ud30c\uc77c \ud06c\uae30\uac00 \uc784\uacc4\uac12\uc744 \ub118\uc73c\uba74 \uc0c8 \ud30c\uc77c \uc0dd\uc131<\/li>\n\n\n\n<li><strong>\ubcf4\uc874 \uae30\uac04 \uae30\uc900:<\/strong> \uc77c\uc815 \uae30\uac04\uc774 \uc9c0\ub09c \ub85c\uadf8 \uc0ad\uc81c<\/li>\n\n\n\n<li><strong>\uc555\ucd95:<\/strong> \uc624\ub798\ub41c \ub85c\uadf8\ub97c \uc555\ucd95\ud574 \uc800\uc7a5 \uacf5\uac04 \uc808\uc57d<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uc608\ub97c \ub4e4\uc5b4 \ub9e4\uc77c \ub85c\uadf8\ub97c \ubd84\ub9ac\ud558\uace0 \uc77c\uc815 \uae30\uac04 \ubcf4\uad00\ud55c \ub4a4 \uc624\ub798\ub41c \ud30c\uc77c\uc744 \uc0ad\uc81c\ud558\ub3c4\ub85d \uad6c\uc131\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Pino\uc640 \ub85c\uadf8 \ud30c\uc77c \uad00\ub9ac<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Pino\ub294 \uae30\ubcf8\uc801\uc73c\ub85c \ub85c\uadf8\ub97c \ud45c\uc900 \ucd9c\ub825\uc774\ub098 \uc9c0\uc815\ub41c \uc2a4\ud2b8\ub9bc\uc5d0 \uae30\ub85d\ud558\ub294 \uc5ed\ud560\uc5d0 \uc9d1\uc911\ud55c\ub2e4. \ud30c\uc77c \ud68c\uc804\uacfc \uc7a5\uae30 \ubcf4\uc874\uc740 \ubcc4\ub3c4\uc758 \uc2dc\uc2a4\ud15c\uc5d0 \ub9e1\uae30\ub294 \uac83\uc774 \uc77c\ubc18\uc801\uc774\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc804\ud1b5\uc801\uc778 VM \ud658\uacbd\uc5d0\uc11c\ub294 <code>logrotate<\/code>\uc640 \uac19\uc740 \uc2dc\uc2a4\ud15c \ub3c4\uad6c\ub97c \uc0ac\uc6a9\ud560 \uc218 \uc788\ub2e4. \uc560\ud50c\ub9ac\ucf00\uc774\uc158\uc5d0\uc11c \uc9c1\uc811 \ud30c\uc77c\uc744 \uad00\ub9ac\ud574\uc57c \ud55c\ub2e4\uba74 Pino\uc758 \uc2a4\ud2b8\ub9bc \uad6c\uc131\uc774\ub098 \uad00\ub828 \ub3c4\uad6c\ub97c \uac80\ud1a0\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ucee8\ud14c\uc774\ub108 \ud658\uacbd\uc5d0\uc11c\ub294 \uc560\ud50c\ub9ac\ucf00\uc774\uc158\uc774 \ub85c\uadf8\ub97c \ud45c\uc900 \ucd9c\ub825\uacfc \ud45c\uc900 \uc624\ub958\ub85c \ub0b4\ubcf4\ub0b4\uace0, Docker \ub7f0\ud0c0\uc784\uc774\ub098 \ub85c\uadf8 \uc218\uc9d1 \uc5d0\uc774\uc804\ud2b8\uac00 \ud30c\uc77c \uad00\ub9ac\uc640 \uc218\uc9d1\uc744 \ub2f4\ub2f9\ud558\ub294 \uad6c\uc870\uac00 \uc77c\ubc18\uc801\uc774\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Kubernetes \ud658\uacbd\uc5d0\uc11c\ub3c4 \uc560\ud50c\ub9ac\ucf00\uc774\uc158\uc774 \ucee8\ud14c\uc774\ub108 \ub0b4\ubd80\uc5d0 \ub85c\uadf8 \ud30c\uc77c\uc744 \ubb34\uc81c\ud55c\uc73c\ub85c \uc313\uae30\ubcf4\ub2e4\ub294 \ud45c\uc900 \ucd9c\ub825\uc73c\ub85c \ub85c\uadf8\ub97c \ub0b4\ubcf4\ub0b4\uace0, \ub178\ub4dc\uc758 \ub85c\uadf8 \uad00\ub9ac \uccb4\uacc4\uc640 \uc911\uc559 \ub85c\uadf8 \uc218\uc9d1 \uc2dc\uc2a4\ud15c\uc744 \ud65c\uc6a9\ud558\ub294 \ud3b8\uc774 \uad00\ub9ac\ud558\uae30 \uc27d\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\ub85c\uadf8 \ubcf4\uc874 \uc815\ucc45<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\ub85c\uadf8\ub97c \uc624\ub798 \ubcf4\uad00\ud560\uc218\ub85d \uc7a5\uc560 \ubd84\uc11d\uc5d0 \ud65c\uc6a9\ud560 \uc218 \uc788\ub294 \ubc94\uc704\ub294 \ub113\uc5b4\uc9c0\uc9c0\ub9cc \uc800\uc7a5 \ube44\uc6a9\uacfc \ubcf4\uc548 \uc704\ud5d8\ub3c4 \uc99d\uac00\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ub530\ub77c\uc11c \ub85c\uadf8 \uc720\ud615\ubcc4\ub85c \ubcf4\uc874 \uae30\uac04\uc744 \uad6c\ubd84\ud558\ub294 \uac83\uc774 \ud569\ub9ac\uc801\uc774\ub2e4.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>\uc77c\ubc18\uc801\uc778 \uc694\uccad \ub85c\uadf8\ub294 \uc6b4\uc601 \ubd84\uc11d\uc5d0 \ud544\uc694\ud55c \uae30\uac04\ub9cc \ubcf4\uad00\ud55c\ub2e4.<\/li>\n\n\n\n<li>\uc624\ub958 \ub85c\uadf8\ub294 \uc7a5\uc560 \uc870\uc0ac\uc640 \uc7ac\ubc1c \ubc29\uc9c0\uc5d0 \ud544\uc694\ud55c \uae30\uac04\uc744 \uace0\ub824\ud55c\ub2e4.<\/li>\n\n\n\n<li>\ubcf4\uc548 \uac10\uc0ac \ub85c\uadf8\ub294 \uad00\ub828 \uc815\ucc45\uacfc \ubc95\uc801 \uc694\uad6c\uc0ac\ud56d\uc744 \ub530\ub978\ub2e4.<\/li>\n\n\n\n<li>\ub514\ubc84\uadf8 \ub85c\uadf8\ub294 \ud544\uc694\ud55c \uad6c\uac04\uc5d0\uc11c\ub9cc \ud65c\uc131\ud654\ud558\uace0 \uc7a5\uae30 \ubcf4\uad00\uc744 \uc81c\ud55c\ud55c\ub2e4.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\ub85c\uadf8 \ub85c\ud14c\uc774\uc158\uc740 \ub85c\uadf8 \uc218\uc9d1\uacfc \ubc31\uc5c5\uc744 \ub300\uccb4\ud558\uc9c0 \uc54a\ub294\ub2e4. \ud30c\uc77c\uc774 \ud68c\uc804\ub418\uac70\ub098 \uc0ad\uc81c\ub418\uae30 \uc804\uc5d0 \uc911\uc559 \uc800\uc7a5\uc18c\ub85c \uc804\uc1a1\ub418\uc5b4\uc57c \ud558\ub294 \ub85c\uadf8\ub77c\uba74 \uc218\uc9d1 \uc131\uacf5 \uc5ec\ubd80\uc640 \uc7a5\uc560 \uc2dc \uc7ac\ucc98\ub9ac \uc815\ucc45\ub3c4 \ud568\uaed8 \uc124\uacc4\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Request ID\uc640 Correlation ID<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">\ubd84\uc0b0 \ud658\uacbd\uc5d0\uc11c\ub294 \ud558\ub098\uc758 \uc0ac\uc6a9\uc790 \uc694\uccad\uc774 \uc5ec\ub7ec \uc11c\ubc84\uc640 \uc11c\ube44\uc2a4\uc5d0 \uac78\uccd0 \ucc98\ub9ac\ub420 \uc218 \uc788\ub2e4. \uc774\ub54c \uac01 \ub85c\uadf8\uac00 \uc11c\ub85c \uc5f0\uacb0\ub418\uc9c0 \uc54a\uc73c\uba74 \uc7a5\uc560 \uc6d0\uc778\uc744 \ud30c\uc545\ud558\uae30 \uc5b4\ub835\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Request ID\uc640 Correlation ID\ub294 \ub85c\uadf8\ub97c \uc5f0\uacb0\ud558\uae30 \uc704\ud55c \uc2dd\ubcc4\uc790\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Request ID<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Request ID\ub294 \uac1c\ubcc4 HTTP \uc694\uccad\uc774\ub098 \uba54\uc2dc\uc9c0 \ucc98\ub9ac \ub2e8\uc704\ub97c \uc2dd\ubcc4\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ud074\ub77c\uc774\uc5b8\ud2b8\uac00 \uc694\uccad\uc744 \ubcf4\ub0b4\uba74 \uc11c\ubc84\ub294 \ud574\ub2f9 \uc694\uccad\uc5d0 \uace0\uc720\ud55c ID\ub97c \ubd80\uc5ec\ud558\uace0, \uc694\uccad \ucc98\ub9ac \uc911 \uc0dd\uc131\ub418\ub294 \ub85c\uadf8\uc5d0 \ub3d9\uc77c\ud55c ID\ub97c \ud3ec\ud568\ud55c\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"event\": \"api.request\",\n  \"requestId\": \"req-a12\",\n  \"path\": \"\/matches\",\n  \"method\": \"POST\"\n}<\/code><\/pre>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"event\": \"matchmaking.started\",\n  \"requestId\": \"req-a12\",\n  \"userId\": \"user-abc\"\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\ub450 \ub85c\uadf8\uc5d0 \uac19\uc740 <code>requestId<\/code>\uac00 \ud3ec\ud568\ub418\uc5b4 \uc788\uc73c\ubbc0\ub85c \ud2b9\uc815 \uc694\uccad\uc774 \ub9e4\uce6d \ucc98\ub9ac\ub85c \uc774\uc5b4\uc9c0\ub294 \uacfc\uc815\uc744 \ucd94\uc801\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Correlation ID<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Correlation ID\ub294 \uc11c\ub85c \ub2e4\ub978 \uc694\uccad\uc774\ub098 \uc11c\ube44\uc2a4 \uc791\uc5c5\uc744 \ud558\ub098\uc758 \uc0c1\uc704 \uc791\uc5c5 \ud750\ub984\uc73c\ub85c \uc5f0\uacb0\ud558\uae30 \uc704\ud55c \uc2dd\ubcc4\uc790\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc608\ub97c \ub4e4\uc5b4 \uac8c\uc784 \uacb0\uacfc\ub97c \ucc98\ub9ac\ud558\ub294 \uacfc\uc815\uc5d0\uc11c API \uc11c\ubc84\uac00 \uba54\uc2dc\uc9c0 \ud050\uc5d0 \uc774\ubca4\ud2b8\ub97c \ubc1c\ud589\ud558\uace0, \uc815\uc0b0 \uc11c\ubc84\uac00 \uc774\ub97c \uc18c\ube44\ud55c \ub4a4 \uc54c\ub9bc \uc11c\ubc84\uac00 \uacb0\uacfc\ub97c \uc804\uc1a1\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774 \uacfc\uc815\uc5d0\uc11c \uac01 \uc11c\ube44\uc2a4\uc758 \uc694\uccad ID\ub294 \ub2ec\ub77c\uc9c8 \uc218 \uc788\uc9c0\ub9cc, \uc804\uccb4 \uc791\uc5c5 \ud750\ub984\uc744 \ub098\ud0c0\ub0b4\ub294 Correlation ID\ub294 \ub3d9\uc77c\ud558\uac8c \uc720\uc9c0\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"event\": \"match.result.saved\",\n  \"requestId\": \"req-a12\",\n  \"correlationId\": \"flow-m42\",\n  \"service\": \"game-api\"\n}<\/code><\/pre>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"event\": \"reward.granted\",\n  \"requestId\": \"req-b73\",\n  \"correlationId\": \"flow-m42\",\n  \"service\": \"reward-worker\"\n}<\/code><\/pre>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"event\": \"notification.sent\",\n  \"requestId\": \"req-c91\",\n  \"correlationId\": \"flow-m42\",\n  \"service\": \"notification-worker\"\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uac01 \uc11c\ube44\uc2a4\uc758 <code>requestId<\/code>\ub294 \ub2e4\ub974\uc9c0\ub9cc <code>correlationId<\/code>\uac00 \uac19\uc73c\ubbc0\ub85c \ub9e4\uce58 \uacb0\uacfc \uc800\uc7a5\ubd80\ud130 \ubcf4\uc0c1 \uc9c0\uae09\uacfc \uc54c\ub9bc \uc804\uc1a1\uae4c\uc9c0 \ud558\ub098\uc758 \ud750\ub984\uc73c\ub85c \ubd84\uc11d\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ub450 \uc2dd\ubcc4\uc790\uc758 \uc5ed\ud560\uc740 \ud504\ub85c\uc81d\ud2b8\ub9c8\ub2e4 \ub2ec\ub77c\uc9c8 \uc218 \uc788\ub2e4. \uc911\uc694\ud55c \uac83\uc740 \uac1c\ubcc4 \ucc98\ub9ac \ub2e8\uc704\uc640 \uc804\uccb4 \ube44\uc988\ub2c8\uc2a4 \ud750\ub984\uc744 \uad6c\ubd84\ud558\uace0, \uc2dc\uc2a4\ud15c \uc804\ubc18\uc5d0\uc11c \ub3d9\uc77c\ud55c \uaddc\uce59\uc744 \uc801\uc6a9\ud558\ub294 \uac83\uc774\ub2e4.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Express\uc5d0\uc11c Request ID\uc640 Correlation ID \uc801\uc6a9\ud558\uae30<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">\ubbf8\ub4e4\uc6e8\uc5b4\uc5d0\uc11c \uc694\uccad \uc2dd\ubcc4\uc790\ub97c \uc0dd\uc131\ud558\uace0 \ub85c\uac70\uc5d0 \uc5f0\uacb0\ud558\uba74 \uc694\uccad \ucc98\ub9ac \uc911 \ubc1c\uc0dd\ud558\ub294 \ub85c\uadf8\uc5d0 \uc2dd\ubcc4\uc790\ub97c \uc77c\uad00\ub418\uac8c \ud3ec\ud568\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>const express = require(\"express\");\nconst { randomUUID } = require(\"node:crypto\");\nconst pino = require(\"pino\");\nconst pinoHttp = require(\"pino-http\");\n\nconst app = express();\n\nconst logger = pino({\n  level: process.env.LOG_LEVEL || \"info\"\n});\n\napp.use(\n  pinoHttp({\n    logger,\n\n    genReqId(req, res) {\n      return randomUUID();\n    },\n\n    customProps(req) {\n      return {\n        correlationId: req.correlationId\n      };\n    }\n  })\n);\n\napp.use((req, res, next) =&gt; {\n  \/\/ \uc678\ubd80\uc5d0\uc11c \uc804\ub2ec\ub41c \uac12\uc744 \ubb34\uc870\uac74 \uc2e0\ub8b0\ud558\uc9c0 \uc54a\uace0\n  \/\/ \uc11c\ubc84\uc5d0\uc11c \uac80\uc99d\ud558\uac70\ub098 \uc0c8\ub85c \uc0dd\uc131\ud55c\ub2e4.\n  req.correlationId = randomUUID();\n\n  next();\n});\n\napp.post(\"\/matches\", async (req, res, next) =&gt; {\n  try {\n    req.log.info(\n      {\n        event: \"matchmaking.started\",\n        correlationId: req.correlationId\n      },\n      \"Matchmaking started\"\n    );\n\n    res.json({ status: \"accepted\" });\n  } catch (error) {\n    next(error);\n  }\n});\n\napp.listen(3000);<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774 \uc608\uc2dc\ub294 \uac1c\ub150\uc744 \uc124\uba85\ud558\uae30 \uc704\ud55c \uad6c\uc131\uc774\ub2e4. <code>pino-http<\/code>\uc758 <code>customProps<\/code>\uac00 \uc694\uccad \uc18d\uc131\uc744 \uc77d\ub294 \uc2dc\uc810\uacfc \uc55e\uc120 \ubbf8\ub4e4\uc6e8\uc5b4\uc758 \uc2e4\ud589 \uc21c\uc11c\ub97c \uace0\ub824\ud574\uc57c \ud55c\ub2e4. \uc704 \ucf54\ub4dc\uc5d0\uc11c\ub294 <code>customProps<\/code>\uac00 <code>correlationId<\/code>\ub97c \uc77d\uae30 \uc804\uc5d0 \ud574\ub2f9 \uc18d\uc131\uc774 \uc124\uc815\ub418\uc9c0 \uc54a\uc744 \uc218 \uc788\uc73c\ubbc0\ub85c, \uc2e4\uc81c \uc11c\ube44\uc2a4\uc5d0\uc11c\ub294 \uc2dd\ubcc4\uc790 \ucd08\uae30\ud654 \ubbf8\ub4e4\uc6e8\uc5b4\ub97c <code>pino-http<\/code>\ubcf4\ub2e4 \uba3c\uc800 \ub4f1\ub85d\ud558\uac70\ub098 <code>genReqId<\/code>\uc5d0\uc11c \uc2dd\ubcc4\uc790\ub97c \ud568\uaed8 \ucd08\uae30\ud654\ud558\ub3c4\ub85d \uad6c\uc131\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ub610\ud55c \ud074\ub77c\uc774\uc5b8\ud2b8\uac00 \ubcf4\ub0b8 <code>X-Request-ID<\/code>\ub098 <code>X-Correlation-ID<\/code>\ub97c \uc0ac\uc6a9\ud560 \uacbd\uc6b0 \ud615\uc2dd\uacfc \uae38\uc774\ub97c \uac80\uc99d\ud558\uace0, \uc678\ubd80 \uc785\ub825\uc744 \uadf8\ub300\ub85c \uc2e0\ub8b0\ud558\uc9c0 \uc54a\uc544\uc57c \ud55c\ub2e4. \uc694\uccad ID\ub97c \uc11c\ubc84\uc5d0\uc11c \uc0c8\ub85c \uc0dd\uc131\ud560\uc9c0, \uac80\uc99d\ub41c \uc804\ub2ec \uac12\uc744 \uc218\uc6a9\ud560\uc9c0\ub3c4 \uc11c\ube44\uc2a4 \uacbd\uacc4\uc5d0 \ub530\ub77c \uacb0\uc815\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\uc11c\ube44\uc2a4 \uac04 ID \uc804\ud30c<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">HTTP \uc694\uccad\uc5d0\uc11c \uc0dd\uc131\ud55c Correlation ID\ub97c \ub2e4\ub978 \uc11c\ube44\uc2a4\ub85c \uc804\ub2ec\ud558\ub824\uba74 HTTP \ud5e4\ub354\ub098 \uba54\uc2dc\uc9c0 \ubcf8\ubb38\uc5d0 \ud3ec\ud568\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uba54\uc2dc\uc9c0 \ud050\ub97c \uc0ac\uc6a9\ud558\ub294 \uacbd\uc6b0\uc5d0\ub294 \uc774\ubca4\ud2b8 \uba54\ud0c0\ub370\uc774\ud130\uc5d0 \uc2dd\ubcc4\uc790\ub97c \ud3ec\ud568\ud55c\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>await messageQueue.publish(\"match.completed\", {\n  matchId: match.id,\n  correlationId: req.correlationId\n});<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc18c\ube44\uc790\ub294 \uba54\uc2dc\uc9c0\uc758 Correlation ID\ub97c \uc77d\uc5b4 \ud6c4\uc18d \uc791\uc5c5 \ub85c\uadf8\uc5d0 \uae30\ub85d\ud55c\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>async function handleMatchCompleted(message) {\n  const log = logger.child({\n    correlationId: message.correlationId,\n    matchId: message.matchId\n  });\n\n  log.info(\n    { event: \"reward.processing.started\" },\n    \"Reward processing started\"\n  );\n\n  await grantRewards(message.matchId);\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774\ub807\uac8c \ud558\uba74 \ube44\ub3d9\uae30 \uc791\uc5c5\uc774 \uc6d0\ub798 HTTP \uc694\uccad\uacfc \ub2e4\ub978 \ud504\ub85c\uc138\uc2a4\uc5d0\uc11c \uc2e4\ud589\ub418\ub354\ub77c\ub3c4 \uac19\uc740 \ube44\uc988\ub2c8\uc2a4 \ud750\ub984\uc73c\ub85c \ucd94\uc801\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ub2e8, \uc2dd\ubcc4\uc790\ub97c \ub85c\uadf8\uc5d0 \uae30\ub85d\ud558\ub294 \uac83\uacfc \uc694\uccad\uc758 \uc2e4\ud589 \ub9e5\ub77d\uc744 \uc804\ud30c\ud558\ub294 \uac83\uc740 \ubcc4\uac1c\uc758 \uc791\uc5c5\uc774\ub2e4. \ube44\ub3d9\uae30 \uc791\uc5c5\uc758 \uc7ac\uc2dc\ub3c4\ub098 \uc791\uc5c5 \ubd84\uae30\uc5d0\uc11c\ub3c4 \ub3d9\uc77c\ud55c Correlation ID\ub97c \uc720\uc9c0\ud558\ub3c4\ub85d \uba54\uc2dc\uc9c0 \uacc4\uc57d\uc744 \uc815\uc758\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">\uc2e4\uc2dc\uac04 \uac8c\uc784 \uc11c\ubc84\uc5d0\uc11c\uc758 \ub85c\uae45 \uc804\ub7b5<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">\uc2e4\uc2dc\uac04 \uac8c\uc784 \uc11c\ubc84\uc5d0\uc11c\ub294 HTTP \uc694\uccad\ubfd0 \uc544\ub2c8\ub77c WebSocket \uc5f0\uacb0, \ub8f8 \uc774\ub3d9, \ub9e4\uce6d, \uac8c\uc784 \uc885\ub8cc, \uc11c\ubc84 \uac04 \ud1b5\uc2e0 \ub4f1 \ub2e4\uc591\ud55c \uc774\ubca4\ud2b8\uac00 \ubc1c\uc0dd\ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ubaa8\ub4e0 \ud328\ud0b7\uc744 \ub85c\uadf8\ub85c \ub0a8\uae30\uba74 \ub85c\uadf8 \uc591\uc774 \uae09\uc99d\ud558\uace0 \ub514\uc2a4\ud06c \ubc0f \uc218\uc9d1 \ube44\uc6a9\uc774 \uc99d\uac00\ud560 \uc218 \uc788\ub2e4. \ub530\ub77c\uc11c \uc6b4\uc601\uc5d0 \ud544\uc694\ud55c \uc774\ubca4\ud2b8\uc640 \uc0c1\uc138 \ub514\ubc84\uae45 \uc815\ubcf4\ub97c \uad6c\ubd84\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">WebSocket \uc5f0\uacb0 \ub85c\uadf8<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">\uc5f0\uacb0\uacfc \ud574\uc81c\ub294 \uc811\uc18d \uc7a5\uc560\uc640 \uc138\uc158 \ubb38\uc81c\ub97c \ubd84\uc11d\ud558\ub294 \ub370 \uc720\uc6a9\ud558\ub2e4.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>logger.info({\n  event: \"websocket.connected\",\n  sessionId,\n  userId\n});\n\nlogger.info({\n  event: \"websocket.disconnected\",\n  sessionId,\n  userId,\n  reason: \"client_disconnect\"\n});<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc138\uc158 \uc2dd\ubcc4\uc790\ub294 \uc5f0\uacb0 \ub2e8\uc704\uc758 \uc0c1\ud0dc\ub97c \ucd94\uc801\ud558\ub294 \ub370 \uc0ac\uc6a9\ud558\uace0, \uc0ac\uc6a9\uc790 \uc2dd\ubcc4\uc790\ub294 \uc811\uadfc \uc815\ucc45\uc5d0 \ub530\ub77c \uae30\ub85d\ud55c\ub2e4. \uc778\uc99d \ud1a0\ud070\uc774\ub098 \uc138\uc158 \ube44\ubc00\uac12 \uc790\uccb4\ub97c \uae30\ub85d\ud574\uc11c\ub294 \uc548 \ub41c\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\ub9e4\uce6d \ubc0f \ub8f8 \ub85c\uadf8<\/h3>\n\n\n\n<pre class=\"wp-block-code\"><code>logger.info({\n  event: \"room.created\",\n  roomId,\n  playerCount\n});\n\nlogger.info({\n  event: \"match.completed\",\n  matchId,\n  roomId,\n  durationMs\n});<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc774\ubca4\ud2b8 \ub85c\uadf8\ub97c \uc9d1\uacc4\ud558\uba74 \ub8f8 \uc0dd\uc131 \ube48\ub3c4, \ud3c9\uade0 \uacbd\uae30 \uc2dc\uac04, \ub9e4\uce6d \uc2e4\ud328\uc728 \ub4f1 \uc6b4\uc601 \uc9c0\ud45c\ub97c \ubd84\uc11d\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">\uc624\ub958\uc640 \uc131\ub2a5 \ub85c\uadf8<\/h3>\n\n\n\n<pre class=\"wp-block-code\"><code>logger.warn({\n  event: \"websocket.reconnect\",\n  sessionId,\n  attempt,\n  delayMs\n});\n\nlogger.error({\n  event: \"room.state_sync.failed\",\n  roomId,\n  err: error\n});<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">\uc7ac\uc811\uc18d\uc774\ub098 \uc77c\uc2dc\uc801\uc778 \ud1b5\uc2e0 \ubb38\uc81c\ub294 <code>warn<\/code>\uc73c\ub85c \uae30\ub85d\ud560 \uc218 \uc788\uace0, \uc0c1\ud0dc \ub3d9\uae30\ud654 \uc791\uc5c5\uc758 \uc2e4\ud328\ub294 \uc0c1\ud669\uc5d0 \ub530\ub77c <code>error<\/code>\ub85c \uae30\ub85d\ud560 \uc218 \uc788\ub2e4. \ub2e8\uc21c\ud788 \uc624\ub958\uac00 \ubc1c\uc0dd\ud588\ub2e4\ub294 \uc0ac\uc2e4\ub9cc \ub0a8\uae30\uc9c0 \ub9d0\uace0, \uc7ac\uc2dc\ub3c4 \uc5ec\ubd80\uc640 \ucd5c\uc885 \ucc98\ub9ac \uacb0\uacfc\ub3c4 \uae30\ub85d\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uace0\ube48\ub3c4 \uac8c\uc784 \ud2f1\uc774\ub098 \uac1c\ubcc4 \uc774\ub3d9 \ud328\ud0b7\uc740 \uae30\ubcf8\uc801\uc73c\ub85c \ub9e4\ubc88 \uae30\ub85d\ud558\uae30\ubcf4\ub2e4 \uc0d8\ud50c\ub9c1, \uc9d1\uacc4, \uc774\uc0c1 \uc0c1\ud669 \uc911\uc2ec \ub85c\uae45\uc744 \uc801\uc6a9\ud558\ub294 \uac83\uc774 \ud6a8\uc728\uc801\uc774\ub2e4.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">\ub85c\uadf8 \uc218\uc9d1\uacfc \ubaa8\ub2c8\ud130\ub9c1<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">\uc560\ud50c\ub9ac\ucf00\uc774\uc158\uc5d0\uc11c \ub85c\uadf8\ub97c \uae30\ub85d\ud558\ub294 \uac83\ub9cc\uc73c\ub85c \uc6b4\uc601 \uad00\uce21 \uccb4\uacc4\uac00 \uc644\uc131\ub418\uc9c0\ub294 \uc54a\ub294\ub2e4. \ub85c\uadf8\ub97c \uc218\uc9d1\ud558\uace0 \uac80\uc0c9\ud558\uba70, \uc624\ub958 \ubc1c\uc0dd \uc2dc \ube60\ub974\uac8c \ud655\uc778\ud560 \uc218 \uc788\ub294 \ud658\uacbd\uc774 \ud544\uc694\ud558\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\uc77c\ubc18\uc801\uc778 \uad6c\uc131\uc740 \ub2e4\uc74c\uacfc \uac19\ub2e4.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>\uc560\ud50c\ub9ac\ucf00\uc774\uc158:<\/strong> Pino\ub85c \uad6c\uc870\ud654\ub41c \ub85c\uadf8 \uc0dd\uc131<\/li>\n\n\n\n<li><strong>\ub85c\uadf8 \uc218\uc9d1:<\/strong> Fluent Bit, Grafana Alloy \ub4f1\uc73c\ub85c \ub85c\uadf8 \uc218\uc9d1 \ubc0f \uc804\ub2ec<\/li>\n\n\n\n<li><strong>\ub85c\uadf8 \uc800\uc7a5 \ubc0f \uac80\uc0c9:<\/strong> Loki \ub610\ub294 Elasticsearch \uacc4\uc5f4 \uc2dc\uc2a4\ud15c<\/li>\n\n\n\n<li><strong>\uc2dc\uac01\ud654 \ubc0f \ubd84\uc11d:<\/strong> Grafana \ub4f1\uc758 \ub300\uc2dc\ubcf4\ub4dc<\/li>\n\n\n\n<li><strong>\uc54c\ub9bc:<\/strong> \uc624\ub958\uc728 \uae09\uc99d, \ud2b9\uc815 \uc774\ubca4\ud2b8 \uc99d\uac00, \uc11c\ube44\uc2a4 \uc7a5\uc560\uc5d0 \ub300\ud55c \uacbd\ubcf4<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">\uc6b4\uc601 \ud658\uacbd\uc5d0\uc11c\ub294 \ub85c\uadf8\ubfd0 \uc544\ub2c8\ub77c \uba54\ud2b8\ub9ad\uacfc \ubd84\uc0b0 \ucd94\uc801\ub3c4 \ud568\uaed8 \ud65c\uc6a9\ud558\ub294 \uac83\uc774 \uc88b\ub2e4.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">\ub85c\uadf8\ub294 \uac1c\ubcc4 \uc0ac\uac74\uc758 \uc0c1\uc138 \ub0b4\uc6a9\uc744 \uc124\uba85\ud558\uace0, \uba54\ud2b8\ub9ad\uc740 \uc624\ub958\uc728\uacfc \uc9c0\uc5f0 \uc2dc\uac04\uc758 \ucd94\uc138\ub97c \ubcf4\uc5ec\uc8fc\uba70, \ubd84\uc0b0 \ucd94\uc801\uc740 \uc11c\ube44\uc2a4 \uac04 \uc694\uccad\uc758 \uc2e4\ud589 \uacbd\ub85c\ub97c \ubd84\uc11d\ud55c\ub2e4. Correlation ID\ub294 \ub85c\uadf8\ub97c \uc5f0\uacb0\ud558\ub294 \ub370 \uc720\uc6a9\ud558\uc9c0\ub9cc, \uadf8 \uc790\uccb4\uac00 \uc644\uc804\ud55c \ubd84\uc0b0 \ucd94\uc801 \uc2dc\uc2a4\ud15c\uc744 \ub300\uccb4\ud558\uc9c0\ub294 \uc54a\ub294\ub2e4.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>\uac8c\uc784 \uc11c\ubc84\uc5d0\uc11c \ub85c\uae45\uc740 \ub2e8\uc21c\ud788 \ucf58\uc194\uc5d0 \uba54\uc2dc\uc9c0\ub97c \ucd9c\ub825\ud558\ub294 \uae30\ub2a5\uc774 \uc544\ub2c8\ub2e4. \uc6b4\uc601 \ud658\uacbd\uc5d0\uc11c \ubc1c\uc0dd\ud55c \uc624\ub958\ub97c \ucd94\uc801\ud558\uace0, \uc694\uccad \ucc98\ub9ac \uacfc\uc815\uc744 \ubd84\uc11d\ud558\uba70, \uc7a5\uc560\uc758 \uc6d0\uc778\uc744 \ud30c\uc545\ud558\uae30 \uc704\ud55c \ud575\uc2ec \uad00\uce21 \uc2dc\uc2a4\ud15c\uc774\ub2e4. \ud2b9\ud788 \uc2e4\uc2dc\uac04 \uba40\ud2f0\ud50c\ub808\uc774\uc5b4 \uac8c\uc784 \uc11c\ubc84\ub294 \ub2e4\uc218\uc758 \ud074\ub77c\uc774\uc5b8\ud2b8\uac00 \ub3d9\uc2dc\uc5d0 \uc5f0\uacb0\ub418\uace0, API \uc694\uccad\uacfc WebSocket \uc774\ubca4\ud2b8\uac00 \ube44\ub3d9\uae30\uc801\uc73c\ub85c \ucc98\ub9ac\ub41c\ub2e4. \ub85c\uadf8\uac00 \uc77c\uad00\ub41c \ud615\uc2dd\uc73c\ub85c \uae30\ub85d\ub418\uc9c0 \uc54a\uc73c\uba74 \ud2b9\uc815 \uc0ac\uc6a9\uc790\uc758 \uc694\uccad\ubd80\ud130 \ub370\uc774\ud130\ubca0\uc774\uc2a4 \uc624\ub958, \uc11c\ubc84 \uac04 \ud1b5\uc2e0 \ubb38\uc81c\uae4c\uc9c0 \uc5f0\uacb0\ud574\uc11c [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"class_list":["post-2727","post","type-post","status-publish","format-standard","hentry","category-dev-logs"],"_links":{"self":[{"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=\/wp\/v2\/posts\/2727","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=2727"}],"version-history":[{"count":1,"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=\/wp\/v2\/posts\/2727\/revisions"}],"predecessor-version":[{"id":2728,"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=\/wp\/v2\/posts\/2727\/revisions\/2728"}],"wp:attachment":[{"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=2727"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=2727"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=2727"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}