适用于私有云的 Edge v4.18.01
系统要求
您必须在所有 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
的文本文件中进行设置:
属性 |
说明 |
---|---|
|
指定 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
在独立节点或运行管理服务器或边缘界面的 Edge 节点上:
- 安装
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
安装 apigee-Telegraf 每个 Edge 节点
在安装 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 节点上重复此过程。
安装 apigee-grafana 单个 Edge 节点
在 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
正在收集数据 <ph type="x-smartling-placeholder">- </ph>
- 运行
apigee-service apigee-telegraf setup
,它具有幂等性,请检查是否有 错误、缺少依赖项并予以解决。 - 重启
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
- 在“查询”字段中,输入“显示数据库”。确保以下数据库
已创建:
system, application, events, _internal
。 - 在“查询”字段中,输入“显示服务器”。确保您可以看到
已列出
apigee-influxdb
个节点。
- 在“查询”字段中,输入“显示数据库”。确保以下数据库
已创建:
- 确保在
- 检查信息中心的数据源:
<ph type="x-smartling-placeholder">
- </ph>
- 在主菜单中选择数据源。您应该会看到三个代表 数据源。
- 选择每个数据源对应的图标。
- 在数据源的详情页面中,选择保存并测试 按钮。
- 如果数据源配置正确,您应该会看到以下形式的消息:
成功
数据源正常运行
更新 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 中所述,将 Edge 更新至 4.18.01 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。
- 更新
apigee-influxdb
的时间 管理服务器节点:> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
其中,configFile 是您用于安装
apigee-influx
。如果您还在 Management API 中安装了
apigee-grafana
, 服务器节点,则此步骤还会更新apigee-grafana
。否则,请更新apigee-granfana
,如以下步骤所示。 - 如果您没有在 Google Cloud 控制台中安装
apigee-grafana
, 管理服务器节点,apigee-grafana
在您 安装了它:> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
- 更新
apigee-telegraf
的时间 节点 1:> /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 版监控信息中心,请执行以下操作:
- 如以下部分所述,将 Edge 更新为 4.18.01 更新 Apigee Edge 4.16.01/4.16.05 至 4.17.01 和 将 Apigee Edge 4.16.09 更新为 4.17.01.
- 更新
apigee-influxdb
的时间 管理服务器节点:> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
其中,configFile 是您用于安装
apigee-influx
。如果您还在 Management API 中安装了
apigee-grafana
, 服务器节点,则此步骤还会更新apigee-grafana
。否则,请更新apigee-granfana
,如以下步骤所示。 - 如果您没有在 Google Cloud 控制台中安装
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 步。