メインコンテンツへスキップ

FiveMのログ肥大化を防ぐ、保存期間の決め方と安全な分割削除

    100人規模のFiveMサーバーを運営していると、プレイヤーのデータより先に、ログや履歴のテーブルが大きくなります。私は最初に「あとで見返すかもしれないから」と全部残す設計にしました。この記事では、困りやすい点、保存期間の決め方、安全に消す方法をまとめます。手元の数字は記録していないので、件数や秒数は載せず、自分のサーバーで同じ確認をするためのSQLを載せます。

    症状:バックアップが長くなり、ログ検索が遅くなる

    • バックアップ(ダンプ)の時間が、少しずつ延びていた

    • 「このプレイヤーの直近のログ」を探す調査クエリが、以前より遅くなった

    毎日少しずつ増えるので、気づくのが遅れました。

    原因:増える一方のテーブルに、消す仕組みがなかった

    INSERTされるだけで誰も消さない作りでした。その結果、次のことが起こり得ます。

    • バックアップ時間と容量:所要時間は行のサイズ、インデックス、ストレージ性能、ダンプ方式にも左右されます。それでも保存データ量が増えると、一般に長くなりやすくなります。復旧時間にも響きます。

    • クエリの遅さ:WHERE に合うインデックスが無いと、行数が増えるほど全件走査が重くなります。

    • インデックスの肥大:メモリやI/O、索引構成などの条件によっては、書き込みが重くなる可能性があります。

    まず、どのテーブルが大きいかを確認します。

    SELECT table_name,
           ROUND((data_length + index_length) / 1024 / 1024, 1) AS size_mb
    FROM information_schema.tables
    WHERE table_schema = DATABASE()
    ORDER BY (data_length + index_length) DESC
    LIMIT 10;
    

    直し方1:何日分残すかの決め方

    「何日が正解」という数字はありません。私は、そのログを何のために見るかで決めています。

    | 種類 | 見る目的 | 残す期間の考え方 | |---|---|---| | 接続・切断ログ | 不具合調査、問い合わせ対応 | 問い合わせが来る期間。数週間〜数か月 | | アイテム・お金の移動ログ | 巻き戻し、不正の確認 | 長め。古いものは集計だけ残す | | 管理者操作の履歴 | 運営内の説明責任 | 長めに残す | | デバッグ用ログ | 開発中の確認 | 数日〜1週間 |

    1. 過去に、そのログを何日前まで遡って見たかを思い出します。実際に見た最長日数が下限の目安です。

    2. 問い合わせの受付期間より短くしません。

    3. 残す理由が説明できないものは、短くします。

    個人に結びつく情報を必要以上に長く持たないことも、期間を決める理由になります。

    直し方2:消すか、アーカイブするか

    • 消す:デバッグ用や、期限が過ぎれば見ないログ。

    • アーカイブ:将来見る可能性があるログ。別テーブルやCSVなどのファイルに移します。

    • 集計して残す:お金の流れなど、傾向だけ見たいもの。日ごとの合計だけ別テーブルに残します。

    アーカイブは「移してから消す」手順です。まず小さい範囲で試し、行数が合うか確認してから消します。なお、アーカイブを同じDBに置くと、全体ダンプの容量は減らない可能性があります。減らしたいなら、別DBやファイルへ移すことも考えます。

    直し方3:一度に大量削除せず、分割して消す

    DELETE FROM server_logs WHERE created_at < NOW() - INTERVAL 90 DAY; を溜め込んだテーブルに一度に実行すると、同じテーブルへのINSERTや参照が待たされる可能性があります。そこで件数を区切って消します。

    MariaDBの公式ドキュメントでは、単一テーブルの DELETE に ORDER BY と LIMIT を付けられ、その順で削除されると説明されています。並びは created_at, id にします。

    先に索引を確認する

    まず既存の索引を確認します。索引の追加にも負荷がかかるため、足りているなら追加しません。

    SHOW INDEX FROM server_logs;
    
    EXPLAIN SELECT id FROM server_logs
    WHERE created_at < '2025-01-01 00:00:00'
    ORDER BY created_at, id LIMIT 5000;
    

    server_logs は例の名前です。key に created_at の索引が出るか、Extra に Using filesort が出ていないかを見ます。足りなければ (created_at, id) の索引追加を、負荷の少ない時間帯に検討します。この時点で、調査クエリも同じ条件で実行し、削除前の所要時間を記録しておきます。

    Luaで繰り返す

    次の例は、サーバー側のスクリプトで動かします。server_logs に id と created_at 列が必要で、fxmanifest.lua で server_script '@oxmysql/lib/MySQL.lua' を読み込む前提です。MySQL.update.await は影響した行数を返します(公式ドキュメントで確認しました)。

    local BATCH, KEEP_DAYS, running = 5000, 90, false
    
    local function purge()
        if running then return end
        running = true
        local cutoff = MySQL.scalar.await(
            "SELECT DATE_FORMAT(NOW() - INTERVAL ? DAY, '%Y-%m-%d %H:%i:%s')", { KEEP_DAYS })
        local total = 0
        repeat
            local n = MySQL.update.await(
                'DELETE FROM server_logs WHERE created_at < ? ORDER BY created_at, id LIMIT ?',
                { cutoff, BATCH }) or 0
            total = total + n
            Wait(1000)
        until n < BATCH
        running = false
        print(('[purge] cutoff=%s deleted=%d'):format(cutoff, total))
    end
    
    CreateThread(function()
        Wait(60 * 1000)
        purge()
    end)
    
    • 期限 cutoff は開始時に一度だけ固定します。稼働中に行が増えても、削除の範囲が動きません。

    • n < BATCH で止め、Wait(1000) で他の処理に譲ります。

    • この例は起動時に一度だけ実行します。保存期間を保つには、スレッドを while true do purge() Wait(24 * 60 * 60 * 1000) end の形にするか、OSのスケジューラで実行します。

    • 重複起動は running で防ぎます。同じDBを複数のサーバーで使うなら、実行するサーバーを1台に決めます。

    • LIMIT にプレースホルダを使えるかは、バージョンで試してください。動かなければ、コード内の定数だけを埋め込みます。

    注意:削除してもファイルは小さくならない

    InnoDBでは、行を消してもディスク上のファイルサイズは通常縮まず、空いた領域はそのテーブルが再利用します。縮めたい場合は OPTIMIZE TABLE などがありますが、テーブルの再構築で負荷がかかるため、メンテナンス時間帯にバックアップを取ってから行います。容量が減らないのは失敗ではなく、通常の動きです。

    確かめ方

    1. 最古の日時:SELECT MIN(created_at) FROM server_logs; が想定の期間内か。

    2. 件数:削除前後の COUNT(*) の差とスクリプトの合計を照合するには、書き込みを止めるなどして、他のINSERTやDELETEが無い状態にする必要があります。稼働中は一致するとは限りません。その場合は、出力された cutoff を使って SELECT COUNT(*) FROM server_logs WHERE created_at < '期限日時'; を実行し、0件か確認します。

    3. クエリの速さ:削除前に記録した調査クエリを同じ条件で再実行し、所要時間を比べます。EXPLAIN で索引が使われているかも見ます。

    4. バックアップ:論理ダンプ(mysqldumpなど)は、削除後の行数に応じて出力容量が減り得ます。物理バックアップ(データファイルのコピー)は、InnoDBのファイル容量がDELETEだけでは通常縮まないため、容量は変わりにくいです。どちらも所要時間は、削除前の記録と比べます。

    5. 稼働中の影響:初回はプレイヤーの少ない時間帯に行い、操作の重さが出ていないか確認します。

    最初の削除は、必ずバックアップを取ってから実行してください。

    まとめ

    • ログ系テーブルは、消す仕組みを最初に作らないと増え続けます。

    • 保存期間は、実際にいつまで遡って見たかと問い合わせの受付期間で決めます。

    • 消す前に、アーカイブや集計で残すものを分けます。

    • 削除は、固定した期限で LIMIT で区切り、既存の索引を確認してから、間を空けて繰り返します。定期実行する場合は重複起動を防ぎます。

    • ファイルサイズは、削除してもすぐには減りません。

    最初は一番大きいテーブル1つで構いません。上のSQLで大きさを確認し、まず1つ試してみてください。

    参考

    あなたへのおすすめ