Neo4j 可观测性最佳实践

2025-04-22
上海
本文字数：1461 字
阅读完需：约 5 分钟

Neo4j 介绍

Neo4j 是一款领先的图数据库管理系统，采用图数据模型来表示和存储数据。它以节点、关系和属性的形式组织数据，节点代表实体，关系表示节点间的连接，属性则为节点和关系附加信息。Neo4j 使用 Cypher 查询语言，提供高效的图数据存储、检索和操作能力，尤其擅长处理复杂的关系查询和路径查找，广泛应用于社交网络、推荐系统、知识图谱等领域。

观测云

观测云是一款专为 IT 工程师打造的全链路可观测产品，它集成了基础设施监控、应用程序性能监控和日志管理，为整个技术栈提供实时可观察性。这款产品能够帮助工程师全面了解端到端的用户体验追踪，了解应用内函数的每一次调用，以及全面监控云时代的基础设施。此外，观测云还具备快速发现系统安全风险的能力，为数字化时代提供安全保障。

前置条件

安装 Neo4j 服务：参见官方安装文档。
验证是否正确安装：在浏览器访问网址 <ip>:7474 可以进入 Neo4j 管理界面。
打开 Neo4j Prometheus 端口，找到并编辑 Neo4j 启动配置文件，通常是在 /etc/neo4j/neo4j.conf，尾部追加，参见官方配置文档。

# Enable the Prometheus endpoint. Default is false.server.metrics.prometheus.enabled=true# The hostname and port to use as Prometheus endpoint.# A socket address is in the format <hostname>, <hostname>:<port>, or :<port>.# If missing, the port or hostname is acquired from server.default_listen_address.# The default is localhost:2004.server.metrics.prometheus.endpoint=0.0.0.0:2004

复制代码

重启 Neo4j 服务

采集器配置

主机安装

1、安装 DataKit

2、配置采集器

进入 DataKit 安装目录下的 conf.d/neo4j 目录，复制 neo4j.conf.sample 并命名为 neo4j.conf。示例如下：

[[inputs.neo4j]]  ## Exporter URLs.  urls = ["http://127.0.0.1:2004/metrics"]
  ## TLS configuration.  tls_open = false  # tls_ca = "/tmp/ca.crt"  # tls_cert = "/tmp/peer.crt"  # tls_key = "/tmp/peer.key"
  ## Set to 'true' to enable election.  election = true
  ## disable setting host tag for this input  disable_host_tag = false
  ## disable setting instance tag for this input  disable_instance_tag = false
  ## Customize tags.  # [inputs.neo4j.tags]    # some_tag = "some_value"    # more_tag = "some_other_value"
  ## (Optional) Collect interval: (defaults to "30s").  # interval = "30s