feat: Add ACE allocation failure tracing and debug hooks

This commit introduces a comprehensive tracing mechanism for allocation failures within the Adaptive Cache Engine (ACE) component. This feature allows for precise identification of the root cause for Out-Of-Memory (OOM) issues related to ACE allocations.

Key changes include:
- **ACE Tracing Implementation**:
  - Added  environment variable to enable/disable detailed logging of allocation failures.
  - Instrumented , , and  to distinguish between "Threshold" (size class mismatch), "Exhaustion" (pool depletion), and "MapFail" (OS memory allocation failure).
- **Build System Fixes**:
  - Corrected  to ensure  is properly linked into , resolving an  error.
- **LD_PRELOAD Wrapper Adjustments**:
  - Investigated and understood the  wrapper's behavior under , particularly its interaction with  and  checks.
  - Enabled debugging flags for  environment to prevent unintended fallbacks to 's  for non-tiny allocations, allowing comprehensive testing of the  allocator.
- **Debugging & Verification**:
  - Introduced temporary verbose logging to pinpoint execution flow issues within  interception and  routing. These temporary logs have been removed.
  - Created  to facilitate testing of the tracing features.

This feature will significantly aid in diagnosing and resolving allocation-related OOM issues in  by providing clear insights into the failure pathways.
This commit is contained in:
Moe Charm (CI)
2025-12-01 16:37:59 +09:00
parent 2bd8da9267
commit 4ef0171bc0
85 changed files with 5930 additions and 479 deletions

View File

@ -53,6 +53,7 @@ static void apply_minimal_mode(HakemConfig* cfg) {
// Debug
cfg->verbose = 0;
cfg->ace_trace = 0;
}
static void apply_fast_mode(HakemConfig* cfg) {
@ -211,6 +212,11 @@ static void apply_individual_env_overrides(void) {
g_hakem_config.verbose = atoi(verbose_env);
}
const char* ace_trace_env = getenv("HAKMEM_ACE_TRACE");
if (ace_trace_env) {
g_hakem_config.ace_trace = atoi(ace_trace_env);
}
// Individual feature toggles (override mode presets)
const char* disable_bigcache = getenv("HAKMEM_DISABLE_BIGCACHE");
if (disable_bigcache && atoi(disable_bigcache)) {
@ -278,6 +284,7 @@ void hak_config_print(void) {
HAKMEM_LOG(" Logging: %s\n", (g_hakem_config.features.debug & HAKMEM_FEATURE_DEBUG_LOG) ? "ON" : "OFF");
HAKMEM_LOG(" Statistics: %s\n", (g_hakem_config.features.debug & HAKMEM_FEATURE_STATISTICS) ? "ON" : "OFF");
HAKMEM_LOG(" Trace: %s\n", (g_hakem_config.features.debug & HAKMEM_FEATURE_TRACE) ? "ON" : "OFF");
HAKMEM_LOG(" ACE Trace: %s\n", g_hakem_config.ace_trace ? "ON" : "OFF");
HAKMEM_LOG("\n");
HAKMEM_LOG("Policies:\n");