Confluenceが重い？それは「情報の墓場」のサインです。劇的改善のためのチューニング極意
こんにちは。現場を渡り歩く中で、よくこんな嘆きを耳にします。
「Confluenceのページを開くたびにコーヒーを淹れに行けるほど待たされる」
「検索結果が出るまでに1分かかる。もう使いたくない」
これ、実はツールが悪いのではありません。あなたのチームの「ドキュメントの作り方」が、Confluenceのエンジンに過度な負荷をかけているだけなのです。
今日は、Confluenceを「情報の墓場」から「爆速のナレッジエンジン」へ変えるための、現場で培ったチューニング術を伝授します。これをマスターすれば、あなたのチームの生産性は確実に一段階上のステージへ引き上げられます。
—
1. ページが重い原因はどこにある？「真犯人」を特定する
Confluenceが重い時、犯人は大抵この3つのいずれかです。
- インクルードマクロの多用（再帰的地獄）: ページAでページBを読み込み、ページBでページCを読み込む……という連鎖は、サーバーのレンダリングコストを指数関数的に増大させます。
- サードパーティ製アプリの暴走: マクロの処理が重いアプリをページ中に配置すると、そのページを開くたびに外部APIとの通信や複雑な計算が発生します。
- 巨大なテーブルと画像: 数千行のテーブルや、最適化されていない巨大な画像をそのまま貼り付けていませんか？
まずは「診断」から
まずはブラウザの「検証ツール（F12）」を開いてください。「Network」タブを見て、ページのロード時間がどこで止まっているか確認します。特定のスクリプト（`confluence-macro`系）が赤く表示され続けているなら、それがボトルネックです。
—
2. キャッシュ活用と「軽量化」の黄金律
Confluenceのレスポンスを改善する基本は「サーバーに計算させないこと」です。
マクロの最適化： `Excerpt` と `Include` の使い分け
- ダメな例: ページ全体を `Include Page` で丸ごと読み込む。
- 良い例: `Excerpt` マクロで必要な部分だけを定義し、`Excerpt Include` で呼び出す。
- 読み込むデータ量が減れば、レンダリング速度は劇的に向上します。
画像は「Web用」に落とす
高解像度のスクリーンショットをそのまま貼るのは厳禁です。必ずWeb用に圧縮（TinyPNGなどを活用）してからアップロードしましょう。画像の解像度を下げるだけで、ページのロード時間は数秒短縮されます。
—
3. スペース全体での「マクロ使用状況」を監査する
「どのページに重いマクロが紛れ込んでいるか分からない」という悩みには、Atlassian公式の監査ツールや、スペース管理機能の活用が必須です。
現場で役立つチェックリスト:
1. Macro Usage Report: Confluenceの管理画面から、どのマクロが何回使われているかを確認できます。あまりに使われていないマクロは廃止し、標準機能への置き換えを検討しましょう。
2. ページ階層の整理: 1ページに情報を詰め込みすぎないこと。情報の「最大粒度」を決め、一定以上の長さになる場合は子ページへ分割するルールを徹底します。
—
4. 運用ルール：速度を維持し続けるための「ドキュメント・ガバナンス」
ツールは、運用ルールがないとすぐに腐敗します。以下の3つのルールをチームで合意してください。
1. 「階層化の原則」: 1ページは「1つのトピック」のみ。スクロールが長すぎると感じたら、それは分割のサインです。
2. 「マクロの利用禁止リスト」: パフォーマンスを著しく落とすことが判明しているプラグインは、チーム内で使用禁止を共有します。
3. 「定期的なアーカイブ」: 古い情報は「アーカイブ・スペース」へ移動させましょう。検索対象から外すだけで、インデックスの負荷は劇的に軽くなります。
—
【初心者向け】最初のステップ：まずはここから始めよう
もしあなたがConfluenceを使い始めたばかりなら、まずは「標準マクロ」の動作確認から始めてみてください。
動作確認：HelloWorldマクロ
まずは、以下のマクロを組み合わせて「軽量なページ」を作ってみましょう。
1. `Info` マクロ: ページ上部に要約を置く。
2. `Table of Contents` マクロ: ページ内リンクを自動生成。
3. `Children Display` マクロ: 子ページへのポインタを表示。
これらはサーバー負荷が非常に低く、かつ構造化を促す最強のツールです。
設定のポイント:
`Children Display` マクロを使う際は、`excerpt=”true”` を設定してみてください。これだけで、ページの内容を先読みして表示してくれるため、ユーザーはクリックせずに概要を把握でき、結果的にページ遷移の回数が減って全体の負荷が下がります。
—
最後に：ツールに振り回されるな、ツールを飼いならせ
ドキュメントツールは「書くため」にあるのではありません。「情報を素早く共有し、チームのアクションを加速させるため」にあります。
ページが重いということは、チームが「情報を探す時間」を浪費しているというサインです。今日紹介したチューニング術は、単なる技術的な微調整ではなく、チームのベロシティを最大化するための「投資」です。
まずは、最も頻繁に閲覧される「トップページ」や「プロジェクト概要ページ」から、重いマクロを削ぎ落としてみてください。その瞬間のレスポンスの速さが、あなたのチームの「次のスピード」になりますよ。
さあ、今日から「爆速のナレッジ環境」を作っていきましょう！応援しています。