JVM Heap vs System Memory Ratio Check

Task ID: jvm_heap_memory_ratio
Category: configuration

Description

Verifies that JVM heap memory does not exceed 25% of total system RAM to ensure sufficient memory for OS page cache

How to Run

Execute this specific analysis task on your Kafka cluster snapshot:

# Run the task
kcpilot task test jvm_heap_memory_ratio <snapshot-path>

# Example
kcpilot task test jvm_heap_memory_ratio ./kafka-scan-2024-01-15

# With debug logging
RUST_LOG=kcpilot=debug kcpilot task test jvm_heap_memory_ratio <snapshot-path>

Data Requirements

This task analyzes the following types of data from your cluster snapshot:

Severity Levels

This task can identify issues at the following severity levels:

  • CRITICAL: Severe issues requiring immediate attention
  • WARNING: Problems that should be addressed soon
  • INFO: Recommendations and optimizations

The severity is determined based on specific patterns and thresholds identified in the cluster data.

Integration with Full Analysis

This task is automatically included when running a complete cluster analysis:

kcpilot analyze <snapshot-path> --report terminal,markdown

Task Configuration

The task is defined in the YAML file at:

analysis_tasks/configuration/general/jvm_heap_memory_ratio.yaml

See also these related JVM configuration tasks: