PerfGuardian – Lightweight FPS, GC & Memory Profiler for Runtime

PerfGuardian – Runtime Performance Monitor & Spike Detector

PerfGuardian is a lightweight runtime performance monitoring tool for Unity projects. 

It helps developers detect FPS drops, GC spikes and memory issues automatically while the game is running.

Unlike the built-in Unity Profiler, PerfGuardian is designed to work directly inside runtime builds with minimal overhead, making it ideal for production testing and real-device diagnostics.

------------------------------------------------------------

KEY FEATURES

------------------------------------------------------------

• Real-Time FPS Monitoring

Track frame rate and frame time directly in-game.

• Automatic Spike Detection

Automatically detect:

- Low FPS events

- Frame hitches

- GC allocation spikes

• Memory Monitoring

Monitor Mono memory, total allocated memory, and reserved memory usage.

• JSON Event Logging

Export structured performance logs in JSON format for external analysis or debugging.

• Lightweight & Production Safe

Designed to run with minimal runtime overhead.

• Cross-Platform Support

Works in Unity Editor and standalone builds. Logs are saved to persistentDataPath.

• Built-In Stress Test Demo Scene

Includes demo tools to simulate object spawn stress, GC allocation spikes, and UI rebuild spikes for testing.

------------------------------------------------------------

WHY PERF GUARDIAN?

------------------------------------------------------------

When the Unity Profiler is too heavy or impractical for runtime builds, PerfGuardian keeps watch.

It is not a full profiler replacement — it is a lightweight performance watchdog designed to alert you when something goes wrong.

------------------------------------------------------------

IDEAL FOR

------------------------------------------------------------

• Indie developers testing builds on real devices

• Runtime diagnostics in production builds

• Detecting performance regressions

• Monitoring FPS and GC behavior during gameplay

• Lightweight performance validation before release

------------------------------------------------------------

TECHNICAL DETAILS

------------------------------------------------------------

• No third-party dependencies

• Minimal allocations

• Clean namespace structure

• Runtime-safe implementation

• Compatible with Unity 2021+ (or your target version)

------------------------------------------------------------

DOCUMENTATION INCLUDED

------------------------------------------------------------

• Quick start guide

• Setup instructions

• Changelog

• Usage examples

------------------------------------------------------------

VERSION

------------------------------------------------------------

Current Version: 1.0.0