怎样监控neo4j运行状态

监控 Neo4j 的运行状态可以从 内置工具、系统指标、日志、API、第三方监控 等多个层面来做。下面按实用程度给你一个清晰清单。

一、Neo4j 自带监控方式

1. Neo4j Browser（最直观）

• 打开：http://<host>:7474
• 查看：
  • 数据库是否在线
  • 执行 Cypher 是否报错
  • 简单性能查看（:sysinfo）

:sysinfo

可看到：

• Store size
• Page cache
• Transaction stats

2. Neo4j Metrics（推荐）

Neo4j 企业版 / 新版本社区版都支持 Metrics。

开启 Metrics（neo4j.conf）

metrics.enabled=true
metrics.csv.enabled=true
metrics.csv.path=/var/lib/neo4j/metrics

可监控：

• 查询次数
• 事务提交/回滚
• 页面缓存命中率
• 堆内存 / GC

3. JMX 监控（Java 层）

Neo4j 是 JVM 应用，可通过 JMX 监控：

dbms.jvm.additional=-Dcom.sun.management.jmxremote

使用工具：

• JConsole
• VisualVM
• Prometheus + JMX Exporter

二、通过 HTTP / API 监控

1. 健康检查接口

curl http://localhost:7474/

返回 JSON 表示服务存活。

2. 数据库状态（企业版）

CALL dbms.database.state("neo4j")

三、系统级监控（必须做）

1. 系统资源

重点关注：

• CPU 使用率
• 内存（堆 + 页缓存）
• 磁盘 IO
• 网络

推荐工具：

• top / htop
• iostat
• df -h

2. 日志监控

日志路径（默认）：

logs/neo4j.log
logs/debug.log
logs/query.log

重点看：

• OOM
• Deadlock
• Long transaction
• Index 异常

四、生产级监控方案（推荐）

✅ Prometheus + Grafana（最常用）

1. 启用 Neo4j Metrics
2. 用 Prometheus 抓取
3. Grafana 展示

常见看板：

• QPS
• 事务延迟
• 缓存命中率
• JVM GC

✅ 第三方 APM

• Datadog
• New Relic
• Elastic APM

五、常见异常监控点

六、最小可行监控建议

如果是 中小项目，至少做这三件事：

1. ✅ Neo4j Browser 看状态
2. ✅ 磁盘 + 内存监控
3. ✅ 错误日志告警

如果你愿意，我可以：

• 给你一套 Prometheus + Grafana 配置示例
• 或针对 社区版 / 企业版 分别给方案
• 或结合你用的 Docker / K8s 环境来写监控

你现在 Neo4j 是哪种部署？