Edge for Private Cloud v. 4.17.05
系统要求
您必须在所有 Edge 节点上安装 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 的文本文件中设置这些信息:
属性 |
说明 |
---|---|
INFLUXDB_URL |
指定 apigee-influxdb 节点的网址,包括端口 8086。 例如: http://192.168.0.1:8086 |
apigee-grafana 的配置参数
在传递给 apigee-grafana setup 命令的文本文件中设置这些属性。例如,在名为 sa_grafana.txt 的文本文件中设置它们:
属性 |
说明 |
---|---|
INFLUXDB_HOST |
指定 InfluxDB 节点的 IP 地址或 DNS 名称。 例如: 192.168.0.1 |
INFLUXDB_PORT |
Grafana 数据源使用的 InfluxDB API 端口。请指定 8086。 |
GRAFANA_USERNAME |
用于登录信息中心界面的 Grafana 用户名。 |
GRAFANA_PASSWORD |
用于登录信息中心界面的 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 设置,具有幂等性,检查是否存在错误、是否缺少依赖项并予以解决。
- 重启 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。 - 在“Query”(查询)字段中,输入“show server”(显示服务器)。
确保已列出 apigee-influxdb 节点。
- 在“查询”字段中,输入“显示数据库”。
- 检查信息中心的数据源:
- 在主菜单中选择数据源。您应该会看到三个数据源的图标。
- 对于每个数据源,请选择相应图标。
- 在数据源的详情页面中,选择保存和测试按钮。
- 如果数据源配置正确,您应该会看到如下消息:
成功
数据源工作正常
更新 Beta 版监控信息中心
请根据您要升级的 Edge 版本,执行以下两个步骤之一:
- 4.16.09 和 4.17.01 使用相同的过程
- 4.16.05 要求在更新过程中卸载 apigee-collectd。
从版本 4.16.09 或 4.17.01 更新
如果您在 4.16.09 或 4.17.01 中安装了 Beta 版 Apigee Monitoring 信息中心,可将其更新到 4.17.05 的 Beta 版。
如需更新 Beta 版监控信息中心,请执行以下操作:
- 按照将 Apigee Edge 4.17.01 更新为 4.17.05、将 Apigee Edge 4.16.09 更新为 4.17.05 以及将 Apigee Edge 4.16.01/4.16.05 更新为 4.17.05 中所述的,将 Edge 更新为 4.17.05。
- 在管理服务器节点上更新 apigee-influxdb:
> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
其中 configFile 是用于安装 apigee-influx 的配置文件。
如果您还在管理服务器节点上安装了 apigee-grafana,则此步骤还会更新 apigee-grafana。否则,请更新 apigee-granfana,如以下步骤所示。 - 如果未在管理服务器节点上安装 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/apigeeelef - 对每个节点重复第 4 步。
从版本 4.16.05 更新
4.16.05 版本的信息中心使用 apigee-collectd,而不是 apigee-telegraf。在更新到 4.17.05 时,您要卸载 apigee-collectd 并安装 apigee-telegraf。
如需更新 Beta 版监控信息中心,请执行以下操作:
- 按照将 Apigee Edge 4.17.01 更新为 4.17.05、将 Apigee Edge 4.16.09 更新为 4.17.05 以及将 Apigee Edge 4.16.01/4.16.05 更新为 4.17.05 中所述的,将 Edge 更新为 4.17.05。
- 在管理服务器节点上更新 apigee-influxdb:
> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
其中 configFile 是用于安装 apigee-influx 的配置文件。
如果您还在管理服务器节点上安装了 apigee-grafana,则此步骤还会更新 apigee-grafana。否则,请更新 apigee-granfana,如以下步骤所示。 - 如果未在管理服务器节点上安装 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 - 对每个节点重复第 4 步。