Monitoring 信息中心安装（Beta 版）

适用于私有云的 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 的文本文件中进行设置：

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

在独立节点或运行管理服务器或边缘界面的 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

安装 apigee-Telegraf 每个 Edge 节点

在安装 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 节点上重复此过程。

安装 apigee-grafana 单个 Edge 节点

在 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 正在收集数据 <ph type="x-smartling-placeholder">
   </ph>
   1. 运行 apigee-service apigee-telegraf setup，它具有幂等性，请检查是否有 错误、缺少依赖项并予以解决。
   2. 重启 apigee-telegraf 并检查 /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log（如有任何错误）
2. 为确保 apigee-influxdb 正在接收数据，请执行以下操作： <ph type="x-smartling-placeholder">
   </ph>
   1. 确保在 apigee-influxdb 个数据节点上打开以下 TCP 端口： 8086 和 8183。
   2. 使用以下网址在浏览器中打开 Influxdb 界面：

      http://influxdb_IP_or_DNS:8183

      1. 在“查询”字段中，输入“显示数据库”。确保以下数据库 已创建：system, application, events, _internal。
      2. 在“查询”字段中，输入“显示服务器”。确保您可以看到 已列出 apigee-influxdb 个节点。
3. 检查信息中心的数据源： <ph type="x-smartling-placeholder">
   </ph>
   1. 在主菜单中选择数据源。您应该会看到三个代表 数据源。
   2. 选择每个数据源对应的图标。
   3. 在数据源的详情页面中，选择保存并测试 按钮。
   4. 如果数据源配置正确，您应该会看到以下形式的消息：
      成功
      数据源正常运行

更新 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 版监控信息中心，请执行以下操作：

1. 按照更新 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。
2. 更新apigee-influxdb的时间 管理服务器节点：

   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile

   其中，configFile 是您用于安装 apigee-influx。

   如果您还在 Management API 中安装了 apigee-grafana， 服务器节点，则此步骤还会更新 apigee-grafana。否则，请更新 apigee-granfana，如以下步骤所示。

3. 如果您没有在 Google Cloud 控制台中安装 apigee-grafana， 管理服务器节点，apigee-grafana在您 安装了它：

   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile

4. 更新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

5. 对每个节点重复执行第 4 步。

从 4.16.05 版更新

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

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

1. 如以下部分所述，将 Edge 更新为 4.18.01 更新 Apigee Edge 4.16.01/4.16.05 至 4.17.01 和 将 Apigee Edge 4.16.09 更新为 4.17.01.
2. 更新apigee-influxdb的时间 管理服务器节点：

   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile

   其中，configFile 是您用于安装 apigee-influx。

   如果您还在 Management API 中安装了 apigee-grafana， 服务器节点，则此步骤还会更新 apigee-grafana。否则，请更新 apigee-granfana，如以下步骤所示。

3. 如果您没有在 Google Cloud 控制台中安装 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 步。