Beta 版 Monitoring 信息中心安装

Edge for Private Cloud v. 4.17.09

系统要求

您必须在所有 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-grafanaapigee-telegraf 的节点访问。

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

如需安装 apigee-telegrafapigee-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

在独立节点或者运行管理服务器或边缘界面的边缘节点上:

  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 设置,具有幂等性,检查是否存在错误、是否缺少依赖项并予以解决。
    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. 在“查询”字段中,输入“显示数据库”。
        确保已创建以下数据库:system、application、events、_internal
      2. 在“Query”(查询)字段中,输入“show server”(显示服务器)。
        确保已列出 apigee-influxdb 节点。
  3. 检查信息中心的数据源:
    1. 在主菜单中选择数据源。您应该会看到三个数据源的图标。
    2. 对于每个数据源,请选择相应图标。
    3. 在数据源的详情页面中,选择保存和测试按钮。
    4. 如果数据源配置正确,您应该会看到如下消息:
      成功
      数据源工作正常

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

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

  1. 按照将 Apigee Edge 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.16.05 中所述的方法,将 Edge 更新为 4.17.09。
  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/apigeeelef
  5. 对每个节点重复第 4 步。

从版本 4.16.05 更新

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

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

  1. 按照将 Apigee Edge 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.16.05 中所述的方法,将 Edge 更新为 4.17.09。
  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
  5. 对每个节点重复第 4 步。