适用于私有云的 Edge v. 4.17.09
系统要求
您必须在所有 Edge 节点上安装 apigee-telegraf, 收集信息中心数据。因此,apigee-telegraf 的系统要求与 Edge 的系统要求相同 来安装它
您可以安装 apigee-grafana 或重复使用某个现有的 Edge 节点,例如管理服务器或 Edge 界面节点。
对于 apigee-influxdb,您可以执行以下操作: 将其安装在现有的 Edge 节点(例如管理服务器节点或 Edge 界面节点), 系统要求没有变化
如果您决定在自己的节点上安装 apigee-influxdb, 那么节点应满足以下要求:
- 双核 CPU
- 4 GB RAM
- 250 GB 磁盘空间(监控数据在 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
在独立节点或运行管理服务器或边缘界面的 Edge 节点上:
- 安装 apigee-influxdb:
> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb 安装 - 配置 apigee-influxdb 数据库:
> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb 设置” - 启动 apigee-influxdb:
> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb start
安装 apigee-Telegraf 每个 Edge 节点
在安装 Edge 的每个节点上:
- 在您的第一个 Edge 节点上,安装 apigee-telegraf:
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf 安装” - 为 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 设置 -f /opt/apigee/customer/application/sa_telegraf.txt - 重启 apigee-telegraf:
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf 重启 - 在所有 Edge 节点上重复此过程。
安装 apigee-grafana 单个 Edge 节点
在 Edge 安装的单个节点(例如 Edge 界面节点)上:
- 在您的第一个 Edge 节点上,安装 apigee-grafana:
> /opt/apigee/apigee-service/bin/apigee-service apigee-grafana 安装” - 为 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 设置 -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
正在收集数据
<ph type="x-smartling-placeholder">
- </ph>
- 运行 apigee-service apigee-telegraf 设置,具有幂等性,可检查是否存在错误、缺少依赖项 并解决这些问题。
- 重启 apigee-telegraf 并查看 /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log 出现任何错误
- 为了确保 apigee-influxdb
正在接收数据:
<ph type="x-smartling-placeholder">
- </ph>
- 确保在 apigee-influxdb 数据节点上打开以下 TCP 端口:8086 和 8183。
- 使用以下网址在浏览器中打开 Influxdb 界面:
http://influxdb_IP_or_DNS:8183- 在“查询”字段中,输入“显示数据库”。
确保已创建以下数据库:系统、应用、事件、 _internal。 - 在“查询”字段中,输入“show servers”。
确保看到 apigee-influxdb 节点 。
- 在“查询”字段中,输入“显示数据库”。
- 检查信息中心的数据源:
<ph type="x-smartling-placeholder">
- </ph>
- 在主菜单中选择数据源。您应该会看到三个代表 数据源。
- 选择每个数据源对应的图标。
- 在数据源的详情页面中,选择保存并测试 按钮。
- 如果数据源配置正确,您应该会看到以下形式的消息:
成功
数据源正常运行
更新 Beta 版监控信息中心
根据您升级前使用的 Edge 版本,执行以下两项操作之一:
- 4.16.09、4.17.01 和 4.17.05 使用相同的流程
- 4.16.05 要求您在更新过程中卸载 apigee-collectd。
更新来源 版本 4.16.09、4.17.01 或 4.17.05
如果您在 4.16.09、4.17.01 或 您可以更新到 4.17.09 的测试版。
如需更新 Beta 版监控信息中心,请执行以下操作:
- 按照将 Apigee Edge 4.17.01/4.17.05 更新到 4.17.09 中所述,将 Edge 更新至 4.17.09。 将 Apigee Edge 4.16.09 更新为 4.17.09,以及 将 Apigee Edge 4.16.01/4.16.05 更新为 4.17.09.
- 更新 apigee-influxdb
管理服务器节点:
> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
其中,configFile 是您用来 apigee-influx。
如果还在 Management API 中安装了 apigee-grafana 服务器节点,那么此步骤还会更新 apigee-grafana。否则,请更新 apigee-granfana,如 。 - 如果您没有在 API 中安装 apigee-grafana,
管理服务器节点,请在需要更新的节点上更新 apigee-grafana
安装了它:
>/opt/apigee/apigee-setup/bin/update.sh -c pp -f 配置文件 - 更新 apigee-telegraf:
节点 1:
> /opt/apigee/apigee-service/bin/apigee-service apigee-Telegraf 更新
>/opt/apigee/apigee-service/bin/apigee-service apigee-Telegraf 设置 -f configFile
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf 重启 - 对每个节点重复执行第 4 步。
从版本更新 4.16.05
4.16.05 版信息中心使用的是 apigee-collectd,而不是 apigee-telegraf。在更新到 4.17.09,您卸载了 apigee-collectd,并安装了 apigee-telegraf。
如需更新 Beta 版监控信息中心,请执行以下操作:
- 按照将 Apigee Edge 4.17.01/4.17.05 更新到 4.17.09 中所述,将 Edge 更新至 4.17.09。 将 Apigee Edge 4.16.09 更新为 4.17.09,以及 将 Apigee Edge 4.16.01/4.16.05 更新为 4.17.09.
- 更新 apigee-influxdb
管理服务器节点:
> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
其中,configFile 是您用来 apigee-influx。
如果还在 Management API 中安装了 apigee-grafana 服务器节点,那么此步骤还会更新 apigee-grafana。否则,请更新 apigee-granfana,如 。 - 如果您没有在 API 中安装 apigee-grafana,
管理服务器节点,请在需要更新的节点上更新 apigee-grafana
安装了它:
>/opt/apigee/apigee-setup/bin/update.sh -c pp -f 配置文件 - 在节点 1
上安装 apigee-telegraf > /opt/apigee/apigee-service/bin/apigee-service apigee-collectd 停止
>/opt/apigee/apigee-service/bin/apigee-service apigee-Telegraf 安装
>/opt/apigee/apigee-service/bin/apigee-service apigee-Telegraf 设置 -f configFile
>/opt/apigee/apigee-service/bin/apigee-service apigee-Telegraf 重启
> /opt/apigee/apigee-service/bin/apigee-service apigee-collectd 卸载 - 对每个节点重复执行第 4 步。