settlemint/eth-net-intelligence-api

网络情报API（ Network Intelligence API）

镜像概述和主要用途

这是一个后端服务，与***节点（如eth、geth或pyethapp）协同运行，用于跟踪网络状态，通过JSON-RPC获取信息，并通过WebSocket连接到https://github.com/cubedro/eth-netstats%E4%BB%A5%E6%8F%90%E4%BE%9B%E6%95%B0%E6%8D%AE%E3%80%82%E5%AE%8C%E6%95%B4%E5%AE%89%E8%A3%85%E8%AF%B4%E6%98%8E%E8%AF%B7%E5%8F%82%E8%80%83https://github.com/***/wiki/wiki/Network-Status%E3%80%82

核心功能和特性

• 跟踪***网络状态
• 通过JSON-RPC接口从***节点获取信息
• 通过WebSocket连接到eth-netstats，实时提供网络数据
• 可配置的日志详细级别，支持不同程度的日志输出

使用场景和适用范围

适用于运行节点（eth、geth或pyethapp）并需要监控网络状态的场景，如节点运营商、开发者或网络维护人员，用于实时跟踪节点在网络中的状态和性能。

前提条件

• ***节点客户端（eth、geth或pyethapp）
• Node.js
• npm

安装方法

在Ubuntu EC2实例上安装

获取并运行构建脚本，该脚本将安装所需的所有组件：最新的***CLI（来自develop分支，可选择eth或geth）、node.js、npm和pm2。

bash
bash <(curl https://raw.githubusercontent.com/cubedro/eth-net-intelligence-api/master/bin/build.sh)

作为Docker容器安装（可选）

仓库根目录中提供了Dockerfile。请阅读该文件头部的说明，了解如何构建、运行和设置。以下配置说明仍然适用。

配置说明

通过修改https://github.com/cubedro/eth-net-intelligence-api/blob/master/processes.json%E9%85%8D%E7%BD%AE%E5%BA%94%E7%94%A8%E3%80%82%E6%B3%A8%E6%84%8F%EF%BC%8C%E9%9C%80%E4%BF%AE%E6%94%B9%E4%BD%8D%E4%BA%8E%60./bin/processes.json%60%E7%9A%84%E5%A4%87%E4%BB%BDprocesses.json%E6%96%87%E4%BB%B6%EF%BC%88%E4%BB%A5%E5%85%81%E8%AE%B8%E8%AE%BE%E7%BD%AE%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%E8%80%8C%E4%B8%8D%E4%BC%9A%E5%9C%A8%E6%9B%B4%E6%96%B0%E6%97%B6%E8%A2%AB%E9%87%8D%E5%86%99%EF%BC%89%E3%80%82

配置参数说明：

json
"env":
	{
		"NODE_ENV"        : "production", // 告知客户端当前为生产环境
		"RPC_HOST"        : "localhost", // 以太坊JSON-RPC主机
		"RPC_PORT"        : "8545", // 以太坊JSON-RPC端口
		"LISTENING_PORT"  : "30303", // 以太坊监听端口（仅用于显示）
		"INSTANCE_NAME"   : "", // 节点名称（可自定义）
		"CONTACT_DETAILS" : "", // 联系信息（可选，如邮箱/Skype）
		"WS_SERVER"       : "wss://rpc.ethstats.net", // eth-netstats WebSocket API服务器路径
		"WS_SECRET"       : "详见http://forum.ethereum.org/discussion/2112/how-to-add-yourself-to-the-stats-dashboard-its-not-automatic", // WebSocket API服务器登录密钥
		"VERBOSITY"       : 2 // 日志详细级别（0=静默，1=错误、警告，2=错误、警告、信息、成功，3=所有日志）
	}

运行方法

使用pm2运行：

bash
cd ~/bin
pm2 start processes.json

更新方法

要更新API客户端，请使用以下命令：

bash
~/bin/www/bin/update.sh

该命令将停止当前的netstats客户端进程，自动检测***实现和版本，更新至最新的develop构建，更新netstats客户端并重新加载进程。