---
title: "JVM GC 监控启用配置"
date: 2026-02-22
lastmod: 2026-02-22
description: "控制 JVM GC 监控启用的配置说明"
tags: ["监控", "JVM", "垃圾回收"]
summary: "配置项作用 #  monitor.jvm.gc.enabled 配置项控制是否启用 JVM 垃圾回收 (GC) 的监控和统计信息收集。
是否可选 #  是
默认值 #  true (启用 GC 监控) 配置项类型 #  动态配置 - 可以在运行时修改
配置格式 #  # 启用 GC 监控（默认） monitor.jvm.gc.enabled: true # 禁用 GC 监控 monitor.jvm.gc.enabled: false 功能说明 #  启用后收集以下 GC 统计信息：
 GC 次数和耗时 GC 前后堆内存变化 年轻代和老年代 GC 信息 GC 开销百分比  推荐设置 #     环境 推荐值 说明     默认配置 true 适用于大多数场景   性能敏感 false 减少监控开销   生产环境 true 便于问题诊断   开发调试 true 完整监控信息    配置验证 #  # 查看当前配置 GET /_cluster/settings?"
---


## 配置项作用

`monitor.jvm.gc.enabled` 配置项控制是否启用 JVM 垃圾回收 (GC) 的监控和统计信息收集。

## 是否可选

是

## 默认值

```
true (启用 GC 监控)
```

## 配置项类型

**动态配置** - 可以在运行时修改

## 配置格式

```yaml
# 启用 GC 监控（默认）
monitor.jvm.gc.enabled: true

# 禁用 GC 监控
monitor.jvm.gc.enabled: false
```

## 功能说明

启用后收集以下 GC 统计信息：
- GC 次数和耗时
- GC 前后堆内存变化
- 年轻代和老年代 GC 信息
- GC 开销百分比

## 推荐设置

| 环境 | 推荐值 | 说明 |
|------|--------|------|
| 默认配置 | true | 适用于大多数场景 |
| 性能敏感 | false | 减少监控开销 |
| 生产环境 | true | 便于问题诊断 |
| 开发调试 | true | 完整监控信息 |

## 配置验证

```bash
# 查看当前配置
GET /_cluster/settings?filter_path=*.monitor.jvm.gc.enabled

# 查看 JVM 统计
GET /_nodes/stats/jvm?filter_path=nodes.*.jvm.gc
```

## 注意事项

1. **动态配置**：可以在运行时修改
2. **性能开销**：启用会有轻微性能开销
3. **监控建议**：生产环境建议启用
4. **问题诊断**：GC 监控对问题诊断很重要

## 相关配置项

| 配置项 | 默认值 | 说明 |
|-------|-------|------|
| `monitor.jvm.gc.refresh_interval` | 1s | GC 统计刷新间隔 |
| `monitor.jvm.gc.overhead.warn` | 50 | GC 开销警告阈值 |

## 完整配置示例

```yaml
# easysearch.yml

# 启用 GC 监控
monitor.jvm.gc.enabled: true
monitor.jvm.gc.refresh_interval: 1s
monitor.jvm.gc.overhead.warn: 50
```