SaaS Diary個人開発SaaSを作って育てる開発日記

ホーム › 技術ログ

技術ログ

記事20本が、ずっと計測されていなかった — 「入れた」ではなく「返ってくるか」で確認する

トップページで動いているのを確認して、サイト全体を測れているつもりになっていた

公開 著者 GRAMSHIFT約5分で読めます

目次
  1. なぜ抜けたのか — テンプレートが1つではなかった
  2. 直す前に、直せる場所かを確かめる
  3. やったこと
  4. 二重計測を作らないための2つの約束
  5. 全部に入れるのが正解ではない
  6. 同じ穴が他のサイトにもあった
  7. 持ち帰れる形にすると
  8. よくある質問

アクセス解析は「入れたかどうか」で管理してしまいがちです。私もそうでした。トップページを開いて計測タグが動いているのを確認し、それでサイト全体が測れていると思い込んでいました。

今日、サイトマップに載っている29ページを1つずつ取得して、計測ID が本文に含まれるかをただ数えました。結果はこうです。

計測タグあり : 5ページ(トップ + 法務4ページ)
計測タグなし : 24ページ(記事20本 + 一覧・多言語ページ4枚)

集客のために書いたページが、1ページも測れていませんでした。 何か月ものあいだ「記事は読まれているのか」を判断できる材料が存在しなかったことになります。しかも困ったことに、この状態は何のエラーも出しません。解析画面にはトップページのセッションが並び、数字は毎日ちゃんと増えているからです。

なぜ抜けたのか — テンプレートが1つではなかった

原因は単純でした。トップと法務ページはサーバー側のテンプレートから描画していて、記事ページは静的HTMLとして別経路で生成していました。計測タグを入れた当時、私はテンプレート側にだけ入れたのです。

「サイトに計測を入れた」という記憶は残り、「どの生成経路に入れたか」は残らない。生成経路が2本以上あるサイトでは、これが標準的な事故の形だと思います。

直す前に、直せる場所かを確かめる

24ページに一括で差し込む処理を書きました。ここで1つ、事前に決めていたことがあります。差し込んだあと、本番のURLを実際に取得して、タグが返ってくることまで確認する。ファイルを書き換えた事実と、公開ページが変わった事実は別物だからです。

これが効きました。24ページのうち1ページだけ、書き換えたのに公開ページが1バイトも変わらないものがあったのです。検査が赤を出したので、その場で全ファイルを元に戻しました。

調べると、そのパスだけリバースプロキシが別のポートの、まったく別のサービスへ振っていました。私が編集していたファイルは、確かにその場所に存在していましたが、誰にも配信されていなかった。ディレクトリを見ただけでは絶対に気づけない種類のズレです。

location /xxx/ { proxy_pass http://127.0.0.1:3010; }   ← 別サービス
location /     { proxy_pass http://127.0.0.1:3000; }   ← 本体

もし「ファイルを書き換えた=完了」で終えていたら、私はそのページを直したつもりのまま放置していました。しかも見た目上は成功したので、疑うきっかけすら無かったはずです。

やったこと

  • サイトマップの全URLを取得し、計測IDの有無を数える(人が目視で選ばない。全部数える)
  • 入っていないページだけを対象に、</head> 直前へ1ブロック差し込む
  • 差し込む前に、対象ファイルを配信ディレクトリの外へ退避(ここに置くと退避が公開されます)
  • 反映後、本番URLを再取得して「タグが在る」「それ以外は変わっていない」を機械で確認
  • 1つでも失敗したら全部書き戻す

ついでに、AI からの流入(ChatGPT や Perplexity などが答えの中でサイトを引用して、そこから人が来るパターン)を判別する処理も同じブロックに入れました。参照元のホスト名を見るだけの十数行です。検索経由の流入と混ざったままでは、そもそも来ているのかどうかが分かりません。

二重計測を作らないための2つの約束

一括で差し込む処理は、書き方を1つ間違えると同じページにタグが2つ入ります。こうなるとセッションが二重に数えられ、直したはずが前より悪い状態になります。そこで2つだけ約束を決めました。

  • すでに計測IDが含まれているページは、対象にしない(差し込む前に本文を検査して弾く)
  • 差し込むのは </head> が1つだけのページに限る。壊れたHTMLで </head> が2つあるページに素朴な置換をかけると、変な位置に入ります

どちらも「対象を選ぶ側」の条件です。差し込む処理そのものを賢くするより、入れてよい相手だけを通すほうが事故が少ないと感じています。

全部に入れるのが正解ではない

対象は最初28ページありましたが、実際に入れたのは24ページです。外したのは次のようなものです。

  • アイコンの見た目を確認するためだけの内部ページ(そもそも公開する必要が無いので、配信ディレクトリの外へ移しました)
  • 退役した外部サービス連携の入口(残す必要はあるが、検索に載る必要はないので検索避けだけ入れた)
  • 隠し要素のページ(もともと検索避けしてあり、集客の指標に混ぜたくない)

計測を増やすこと自体が目的になると、見なくていい数字が混ざって平均が濁ります。「この数字が動いたら何を決めるのか」が言えないページは、入れないほうが後で楽です。

同じ穴が他のサイトにもあった

1サイト直して終わりにせず、手元の全サイトで同じ数え方をしました。すると別のサイトで、ビルド済みの成果物には入っているのに、本番には反映されていないという逆パターンが見つかりました。生成して満足し、配っていなかったのです。こちらは本番と成果物を全ページ突き合わせて(25/25 が差分は当該ブロックのみ)から配りました。

持ち帰れる形にすると

  • 計測タグの導入は「入れた」ではなく「全ページで返ってくるか」で完了とする。数えるのは10行のスクリプトで済みます。
  • ページの生成経路が2本以上あるサイトでは、経路ごとに確認する。テンプレートを直した記憶は、静的生成側には届きません。
  • 本番を書き換える処理には、必ず公開URLを取り直す検算を付ける。ファイル操作の成功は配信の成功ではありません。
  • 数字が0のとき、「起きていない」と「測っていない」はまったく違う。まず後者を否定してから考えます。

解析を入れ直したところで、今日から先のデータしか手に入りません。過去は戻ってこない。だからこそ、測れていない期間を1日でも短くすることだけが唯一できることでした。

よくある質問

計測タグが全ページに入っているか、どう確認するのが確実?

サイトマップに載っているURLを1つずつ取得して、計測IDの文字列が本文に含まれるかを数えてください。ブラウザの拡張機能や解析画面のリアルタイム表示は「今開いたページ」しか見ておらず、抜けているページを見つける用途には向きません。数えるだけなら10行程度のスクリプトで済み、以後は定期実行にできます。

ファイルを書き換えたのに公開ページが変わらないのは何が起きている?

配信経路が想定と違う可能性が高いです。リバースプロキシが特定のパスだけ別のサービスへ振っている、別のディレクトリが優先されている、CDNやサーバー側のキャッシュが残っている、などが典型です。まずサーバーの設定でそのパスがどこへ向いているかを確認してください。ファイル操作の成功は、公開の成功を意味しません。

計測が抜けていた期間のデータは後から取れる?

取れません。アクセス解析はタグが動いていた時間しか記録しないので、抜けていた期間は永久に空白です。だからこそ発見した時点での判断は「原因を丁寧に調べる」より「まず全ページに入れて、測れていない時間を1日でも短くする」が優先になります。原因の分析はタグを入れたあとでも同じ精度でできます。

あわせて読みたい

技術ログ毎週「準備OK」と報告していた監視が、一度も出していない申請を緑にしていた準備状況の監視が毎週「良好」を返していました。準備は本当に整っていたので嘘ではありません。ただ、肝心の「出したのか」が項目に無く、申請は一度も出ていませんでした。外から測れる証拠で判定を作り直すまでの記録です。 技術ログサービスを止めたのに、特商法だけ「月額480円」のままだった課金もログインも止めて、トップに告知も出した。それでも特定商取引法に基づく表記には月額480円が残り、案内していた解約導線は404でした。止めるときに直す場所のリストと、消えたこと・残ったことを両方確認する手順の記録です。 技術ログ削除したはずの一文が、まだ公開されていた — バックアップを配信ディレクトリに置くな法務文書から一文を削除した翌朝、配信ディレクトリの走査で .bak が3本 HTTP 200 で見つかりました。中身は削除前の版。原因・被害・直し方と、週1の見張りでは最悪7日気づけなかった監視設計の話です。 技術ログバックアップは毎日成功していた。一度も復元したことがなかったバックアップの完了通知は毎日届いていました。でも「実際に復元したことは何回?」と自問したら答えはゼロ回。実際に緑のまま壊れていた事故が2件あります。毎月バンドルを復号して中身を数える復元訓練を実装し、検査自体もわざと壊して赤くなることを確認した記録です。 技術ログNetlifyの無料枠はどこまで無料か — 300クレジットの中身と、サイトが止まる条件Netlifyの無料プランは月300クレジット。本番デプロイは1回15クレジットなので月20回で上限に達し、1日1回デプロイする運用は月の半ばで止まります。使い切ると自動課金ではなくチームの全サイトが停止し、新規デプロイもできません。公式ドキュメントの単価と、実際に枯渇させた夜の経験をまとめます。 技術ログERR_INVALID_PACKAGE_CONFIG の正体は、3バイトのBOMだったプロジェクトを置いていないホームディレクトリで、nodeが Invalid package config を出し続けました。犯人はBOMだけが入った3バイトのpackage.json。Nodeが親をたどって設定を探す仕組みと合わさって、配下のスクリプトが全部巻き込まれていた話です。
技術ログの記事をもっと見る