Beta 版 Monitoring 信息中心安装

Edge for Private Cloud v. 4.17.05

系统要求

您必须在所有 Edge 节点上安装 apigee-telegraf 才能收集信息中心数据。因此，apigee-telegraf 的系统要求与您安装它的 Edge 节点的系统要求相同。

您可以在单独的节点上安装 apigee-grafana，也可以重复使用现有的 Edge 节点之一，例如 Management Server 或 Edge 界面节点。

对于 apigee-influxdb，您可以将其安装在现有 Edge 节点（例如管理服务器节点或 Edge 界面节点）上，而无需更改系统要求。

如果您出于性能原因决定在自己的节点上安装 apigee-influxdb，则该节点应满足以下要求：

• 双核 CPU
• 4 GB RAM
• 250 GB 磁盘可用空间（监控数据会在 1 个月后完全清除）
• 1,000 IOPS 或更高

如需了解详情，请参阅 InfluxData 文档。

apigee-influxdb 的端口要求

必须在 apigee-influxdb 数据节点上打开端口 8086 和 8183，以便运行 apigee-grafana 和 apigee-telegraf 的节点进行访问。

用于安装信息中心组件的配置文件

如需安装 apigee-telegraf 和 apigee-grafana 组件，请将配置文件传递给 apigee-service 实用程序。将这些文件存储在“apigee”用户可访问的目录中，例如 /opt/apigee/customer/application，并将其归“apigee”用户所有。

apigee-telegraf 的配置参数

在您传递给 apigee-telegraf setup 命令的文本文件中设置这些属性。例如，在名为 sa_telegraf.txt 的文本文件中设置这些变量：

http://192.168.0.1:8086

apigee-grafana 的配置参数

在您传递给 apigee-grafana setup 命令的文本文件中设置这些属性。例如，在名为 sa_grafana.txt 的文本文件中设置这些变量：

192.168.0.1

安装说明

请按照以下说明，按顺序安装信息中心组件：

• apigee-influxdb（在中央节点上）
• apigee-telegraf（在每个节点上）
• apigee-grafana（在中央服务器上）

在单个 Edge 节点或独立节点上安装 apigee-influxdb

在独立节点或运行 Management Server 或 Edge 界面的 Edge 节点上：

1. 安装 apigee-influxdb：
   > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb install
2. 配置 apigee-influxdb 数据库：
   > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb setup
3. 启动 apigee-influxdb：
   > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb start

在每个 Edge 节点上安装 apigee-telegraf

在 Edge 安装的每个节点上：

1. 在第一个 Edge 节点上，安装 apigee-telegraf：
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install
2. 为 apigee-telegraf 创建一个名为 sa_telegraf.txt 的配置文件。通常，您会将此文件存储在“apigee”用户可访问的目录中，例如 /opt/apigee/customer/application，并将其归“apigee”用户所有。
   
   在文件中设置以下属性，以指定 apigee-influxdb 节点的网址（包括端口 8086）：
   INFLUXDB_URL=http://influx_IP:8086
3. 将所有者更改为“apigee”：
   > chown apigee:apigee /opt/apigee/customer/application/sa_telegraf.txt
4. 配置 apigee-telegraf：
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f /opt/apigee/customer/application/sa_telegraf.txt
5. 重启 apigee-telegraf：
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
6. 在所有 Edge 节点上重复此过程。

在单个 Edge 节点上安装 apigee-grafana

在 Edge 安装的单个节点（例如 Edge 界面节点）上：

1. 在第一个 Edge 节点上，安装 apigee-grafana：
   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana install
2. 为 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
3. 将所有者更改为“apigee”：
   > chown apigee:apigee /opt/apigee/customer/application/sa_grafana.txt
4. 使用配置文件配置 apigee-grafana：
   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana setup -f /opt/apigee/customer/application/sa_grafana.txt
5. 重启 apigee-grafana：
   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana restart

如需访问信息中心，请在浏览器中打开以下网址：

http://grafana_IP_or_DNS:3000

使用您在 apigee-grafana 的配置文件中指定的凭据登录。在上面显示的示例中，用户名/密码为 admin/admin。

排查安装问题

如果您没有看到信息中心内显示数据，请使用以下过程排查安装问题：

1. 为确保 apigee-telegraf 正在收集数据，请执行以下操作：
   1. 运行 apigee-service apigee-telegraf setup，它是幂等的，检查是否存在错误、缺少依赖项并解决这些问题。
   2. 重启 apigee-telegraf，并检查 /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log 是否存在任何错误
2. 如需确保 apigee-influxdb 正在接收数据，请执行以下操作：
   1. 确保 apigee-influxdb 数据节点上的以下 TCP 端口处于打开状态：8086 和 8183。
   2. 使用以下网址在浏览器中打开 influxdb 界面：
      http://influxdb_IP_or_DNS:8183
      1. 在“查询”字段中，输入“show databases”。
         确保已创建以下数据库：system、application、events、_internal。
      2. 在“Query”（查询）字段中，输入“show servers”。
         确保您看到 apigee-influxdb 节点已列出。
3. 检查信息中心的数据源：
   1. 在主菜单中选择数据源。您应该会看到三个数据源的图标。
   2. 对于每个数据源，选择相应图标。
   3. 在数据源的详情页面中，选择保存并测试按钮。
   4. 如果数据源配置正确，您应该会看到以下形式的消息：
      成功
      数据源正常运行

更新 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 中安装了 Apigee Monitoring 信息中心的 Beta 版，则可以将其更新为 4.17.05 的 Beta 版。

如需更新 Beta 版监控信息中心，请执行以下操作：

1. 按照将 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。
2. 在管理服务器节点上更新 apigee-influxdb：
   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
   
   其中 configFile 是您用于安装 apigee-influx 的配置文件。
   
   如果您还在管理服务器节点上安装了 apigee-grafana，则此步骤还会更新 apigee-grafana。否则，请按照以下步骤更新 apigee-granfana。
3. 如果您未在管理服务器节点上安装 apigee-grafana，请在安装了 apigee-grafana 的节点上更新它：
   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
4. 在节点 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
5. 对每个节点重复第 4 步。

从 4.16.05 版更新

4.16.05 版本的信息中心使用 apigee-collectd，而不是 apigee-telegraf。在更新到 4.17.05 的过程中，您需要卸载 apigee-collectd 并安装 apigee-telegraf。

如需更新 Beta 版监控信息中心，请执行以下操作：

1. 按照将 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。
2. 在管理服务器节点上更新 apigee-influxdb：
   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
   
   其中 configFile 是您用于安装 apigee-influx 的配置文件。
   
   如果您还在管理服务器节点上安装了 apigee-grafana，则此步骤还会更新 apigee-grafana。否则，请按照以下步骤更新 apigee-granfana。
3. 如果您未在管理服务器节点上安装 apigee-grafana，请在安装了 apigee-grafana 的节点上更新它：
   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
4. 在节点 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
5. 对每个节点重复第 4 步。