Edge for Private Cloud v4.18.01
系统要求
您必须在所有边缘节点上安装 apigee-telegraf
才能收集信息中心数据。因此,apigee-telegraf
的系统要求与安装它的 Edge 节点相同。
您可以在单独的节点上安装 apigee-grafana
,或重复使用其中一个现有的边缘节点,例如管理服务器或边缘界面节点。
对于 apigee-influxdb
,您可以将其安装在现有边缘节点(例如管理服务器节点或边缘界面节点)上,而无需更改系统要求。
如果出于性能原因决定在自己的节点上安装 apigee-influxdb
,则节点应满足以下要求:
- 双核 CPU
- 4 GB RAM
- 250GB 磁盘空间(监控数据在 1 个月后被完全清除)
- 1000 或更多 IOPS
如需了解详情,请参阅 InfluxData 文档。
apigee-influxdb 的端口要求
端口 8086 和 8183 必须在 apigee-influxdb
数据节点上打开,以供运行 apigee-grafana
和 apigee-telegraf
的节点访问。
用于安装信息中心组件的配置文件
如需安装 apigee-telegraf
和 apigee-grafana
组件,请将配置文件传递给 apigee-service
实用程序。将这些文件存储在“apigee”用户可访问的目录中(例如 /opt/apigee/customer/application
),并使其归“apigee”用户拥有。
apigee-telegraf 的配置参数
在您传递给 apigee-telegraf setup
命令的文本文件中设置这些属性。例如,在名为 sa_telegraf.txt
的文本文件中设置它们:
属性 |
说明 |
---|---|
|
指定 apigee-influxdb 节点的网址,包括端口 8086。例如: http://192.168.0.1:8086 |
apigee-grafana 的配置参数
在您传递给 apigee-grafana setup
命令的文本文件中设置这些属性。例如,在名为 sa_grafana.txt
的文本文件中设置它们:
属性 |
说明 |
---|---|
|
指定 InfluxDB 节点的 IP 地址或 DNS 名称。例如: 192.168.0.1 |
|
Grafana 数据源使用的 InfluxDB API 端口。请指定 8086。 |
|
用于登录信息中心界面的 Grafana 用户名。 |
|
用于登录信息中心界面的 Grafana 密码。 |
安装说明
请按照以下说明,按如下顺序安装信息中心组件:
apigee-influxdb
(在中央节点上)apigee-telegraf
(在每个节点上)apigee-grafana
(在中央服务器上)
在单个 Edge 节点或独立节点上安装 apigee-influxdb
在独立节点或者运行管理服务器或边缘界面的边缘节点上:
- 安装
apigee-influxdb
:> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb install
- 配置
apigee-influxdb
数据库:> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb setup
- 启动
apigee-influxdb
:> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb start
在每个 Edge 节点上安装 apigee-telegraf
在 Edge 安装的每个节点上:
- 在第一个 Edge 节点上,安装
apigee-telegraf
:> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install
- 为
apigee-telegraf
创建一个名为sa_telegraf.txt
的配置文件。通常,将此文件存储在“apigee”用户可访问的目录中(例如/opt/apigee/customer/application
),并使其归“apigee”用户拥有。在文件中设置以下属性,以指定 apigee-influxdb 节点的网址,包括端口 8086:
INFLUXDB_URL=http://influx_IP:8086
- 将所有者更改为“apigee”:
> chown apigee:apigee /opt/apigee/customer/application/sa_telegraf.txt
- 配置
apigee-telegraf
:> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f /opt/apigee/customer/application/sa_telegraf.txt
- 重启
apigee-telegraf
:> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
- 在所有 Edge 节点上重复此过程。
在单个 Edge 节点上安装 apigee-grafana
在 Edge 安装的单个节点(例如 Edge 界面节点)上:
- 在第一个 Edge 节点上,安装
apigee-grafana
:> /opt/apigee/apigee-service/bin/apigee-service apigee-grafana install
- 为
apigee-grafana
创建一个名为sa_grafana.txt
的配置文件。通常,将此文件存储在“apigee”用户可访问的目录中(例如/opt/apigee/customer/application
),并使其归“apigee”用户拥有。在文件中设置以下属性。这些属性如上文所述:
INFLUXDB_HOST=192.168.56.101 INFLUXDB_PORT=8086 GRAFANA_USERNAME=admin GRAFANA_PASSWORD=admin
- 将所有者更改为“apigee”:
> chown apigee:apigee /opt/apigee/customer/application/sa_grafana.txt
- 使用配置文件配置
apigee-grafana
:> /opt/apigee/apigee-service/bin/apigee-service apigee-grafana setup -f /opt/apigee/customer/application/sa_grafana.txt
- 重启
apigee-grafana
:> /opt/apigee/apigee-service/bin/apigee-service apigee-grafana restart
如需访问信息中心,请在浏览器中打开以下网址:
http://grafana_IP_or_DNS:3000
使用您在 apigee-grafana
的配置文件中指定的凭据登录。在上述示例中,用户名/密码为 admin/admin。
排查安装问题
如果信息中心内未显示数据,请按照以下步骤排查安装问题:
- 为了确保
apigee-telegraf
正在收集数据- 运行
apigee-service apigee-telegraf setup
,它遵循幂等原则,可检查是否存在错误、缺少依赖项,然后予以解决。 - 重启
apigee-telegraf
并检查/opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log
是否出现任何错误
- 运行
- 为确保
apigee-influxdb
正在接收数据,请执行以下操作:- 请确保在
apigee-influxdb
数据节点上打开以下 TCP 端口:8086 和 8183。 - 使用以下网址在浏览器中打开 influxdb 界面:
http://influxdb_IP_or_DNS:8183
- 在“查询”字段中,输入“显示数据库”。确保已创建以下数据库:
system, application, events, _internal
。 - 在“查询”字段中,输入“显示服务器”。确保您看到已列出
apigee-influxdb
节点。
- 在“查询”字段中,输入“显示数据库”。确保已创建以下数据库:
- 请确保在
- 检查信息中心的数据源:
- 在主菜单中选择数据源。您应该会看到三个数据源的图标。
- 对于每个数据源,请选择相应图标。
- 在数据源的详情页面中,选择保存和测试按钮。
- 如果数据源配置正确,您应该会看到如下消息:
成功
数据源工作正常
更新 Beta 版监控信息中心
请根据您要升级的 Edge 版本,执行以下两个步骤之一:
- 4.16.09 和 4.17.0x 使用相同的过程
- 4.16.05 要求在更新过程中卸载
apigee-collectd
。
从版本 4.16.09 或 4.17.0x 更新
如果您在 4.16.09 或 4.17.0x 中安装了 Beta 版 Apigee Monitoring 信息中心,可将其更新到 4.18.01 的 Beta 版。
如需更新 Beta 版监控信息中心,请执行以下操作:
- 按照将 Apigee Edge 4.17.01/4.17.05 更新为 4.17.09、将 Apigee Edge 4.16.09 更新为 4.17.09 以及将 Apigee Edge 4.16.01/4.16.05 更新为 4.17.09 中所述的步骤,将 Edge 更新为 4.18.01。
- 在 Management Server 节点上更新
apigee-influxdb
:> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
其中,configFile 是您用于安装
apigee-influx
的配置文件。如果您还在管理服务器节点上安装了
apigee-grafana
,则此步骤也会更新apigee-grafana
。否则,请按以下步骤更新apigee-granfana
。 - 如果未在 Management Server 节点上安装
apigee-grafana
,请在安装它的节点上更新apigee-grafana
:> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
- 更新节点 1 上的
apigee-telegraf
:> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf update > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f configFile > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
- 对每个节点重复第 4 步。
从版本 4.16.05 更新
4.16.05 版本的信息中心使用 apigee-collectd
而不是 apigee-telegraf
。在更新到 4.18.01 的过程中,您卸载了 apigee-collectd
并安装 apigee-telegraf
。
如需更新 Beta 版监控信息中心,请执行以下操作:
- 按照将 Apigee Edge 4.16.01/4.16.05 更新为 4.17.01 和将 Apigee Edge 4.16.09 更新为 4.17.01 中的说明,将 Edge 更新为 4.18.01。
- 在 Management Server 节点上更新
apigee-influxdb
:> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
其中,configFile 是您用于安装
apigee-influx
的配置文件。如果您还在管理服务器节点上安装了
apigee-grafana
,则此步骤也会更新apigee-grafana
。否则,请按以下步骤更新apigee-granfana
。 - 如果未在 Management Server 节点上安装
apigee-grafana
,请在安装它的节点上更新apigee-grafana
:> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
- 在节点 1 上安装
apigee-telegraf
:> /opt/apigee/apigee-service/bin/apigee-service apigee-collectd stop > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f configFile > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart > /opt/apigee/apigee-service/bin/apigee-service apigee-collectd uninstall
- 对每个节点重复第 4 步。