Node.js– tag –
-
DevOps
「遅い」の次は「どこが」 — 分散トレーシング入門
メトリクスで「遅い」に気づき、ログで「何が起きたか」を読み、それでも「どこで時間を使ったか」だけが分かりませんでした。パフォーマンスの回で手で仕込んだ console.time を、全部の処理に自動で入れるのが分散トレーシングです。OpenTelemetry が「規格」であって道具ではないという整理から始めて、Node.js に自動計装を入れ、Jaeger を立てて、実際に遅いリクエストを1本開いて内訳を見ます。サンプリングと、1台なら要らないという線も書きます。 -
データベース
スキーマは消えずにアプリへ移る — NoSQLとMongoDB
「NoSQL」は1つのソフトの名前ではなく、少なくとも4種類の別物の総称です。すでに使っている Redis もその1つ。Compose で MongoDB を立て、同じタスク一覧をドキュメントとして入れ直し、SQLとの対応を1行ずつ突き合わせます。そのうえで「スキーマがないから楽」が誤解である理由、結合が多いデータに向かない理由、トランザクションが標準では使えない理由まで。最後は「迷ったらリレーショナル」の根拠を書きます。 -
DevOps
待っている時間に課金されない — サーバーレスとLambda
サーバーは「ポートを掴んで待ち続けるプログラム」と定義しました。サーバーレスは、その「待ち続ける」をやめます。サーバーが無いのではなく、待っている時間に課金されないだけです。Lambdaで関数を1つ作って関数URLで叩き、初回が遅いのを自分の目で見て、状態を持てないことと向いていない用途を確かめ、最後に必ず消します。 -
バックエンド
LLMは検索ではない — 埋め込みとRAGを手で書く
「自分のドキュメントについて答えさせたい」は誰もが最初に思うことですが、素のLLMにはできません。理由は「次の1語を確率で選んでいる」ことと「文脈ウィンドウに全部は入らない」ことの2つです。そこから出てくるのがRAGです。この記事の山場は、埋め込み(ベクトル)を自分で扱うところ。コサイン類似度をライブラリ無しで10行書き、全文検索の回で見た「値段」と「価格」が別物になる問題を、数字で確かめます。APIキーが要る部分は全部「任意」にしてあり、キーが無くても最後まで手が動きます。従量課金の防ぎ方、チャンクの切り方で答えが変わること、そして「検索で足りるならRAGは要らない」まで。 -
システム設計
落ちても全部は止めない — サーキットブレーカと縮退
Redis を止めただけでページが真っ白になるのを、まず自分の手で再現します。次に、タイムアウトを書いていない外部呼び出しを1本足すだけで、DBの接続が10本とも埋まり、関係ないAPIまで巻き添えで死ぬところ(カスケード障害)を実演します。そこから、一番効くタイムアウトの1行、事故を大きくする素直なリトライと指数バックオフ+ジッター、ライブラリを使わず30行で書くサーキットブレーカ(閉・開・半開)、Redis が落ちても遅いDBから返す縮退、同時実行数を区切るバルクヘッドまでを順に入れます。最後に「1台のうちはタイムアウトだけで十分」という線も正直に引きます。 -
プログラム
gitは差分を保存していない — コミットを自作する
毎日打っている git commit が、ディスクの上で何を作っているのか。先に本物の .git の中を開いて、blob・tree・commit の3種類しか無いことを確かめます。そのうえで同じものを Node.js で114行書き、自作した mygit が作ったオブジェクトを本物の git cat-file と git log に読ませます。ブランチが41バイトのテキストであること、Gitが差分ではなく毎回まるごと保存していることまで、実物で確認します。 -
プログラム
HTTPはただのテキストだった — サーバー自作
http.createServer の1行が、代わりに何をやっているのか。net モジュール(TCP)だけでサーバーを書き、生のバイト列を自分で読み、リクエスト行とヘッダを自分で分解します。改行が \r\n であること、データは1回で全部来ないこと、Content-Length を間違えるとブラウザが待ち続けること。全部わざと起こして目で確かめます。 -
データベース
9時間ずれるのは全部同じ理由 — 日付と時刻の扱い
「1日ずれる」「9時間ずれる」は、ほぼ全部タイムゾーンの話です。この記事では、時刻がOS・データベース・アプリ・ブラウザの4つの層でそれぞれ変換されていることを実際のコマンドで確認し、MySQLのTIMESTAMPとDATETIMEに同じ値を入れてセッションのタイムゾーンだけを変えて読むことで、わざと9時間ずらします。そのうえで「保存はUTC、表示はローカル」という1つの原則に絞り、ISO 8601での受け渡し、DATE型と誕生日、サマータイムで存在しない時刻、うるう秒、そして「今」を直接呼ばない設計まで扱います。 -
バックエンド
APIの正体はJSONを返すHTTP — Node.jsで作る
前回の15行のサーバーを、そのままAPIに育てる。生のNodeでPOSTの本文を受け取り、第3段階で「フロントでは直せない」と書いたCORSを今度はサーバー側から解除する。最後にExpressで書き直して、ライブラリが何を肩代わりしていたのかを確かめる。 -
バックエンド
サーバーとは待ち続けるプログラム — 手で書いて確かめる
python3 -m http.server と打つたびに何が起きていたのか。netcatで人間が手でサーバーになり、次に15行のNode.jsで置き換え、最後にsystemdで常駐させる。「サーバー=すごい機械」という誤解を、ここで捨てます。