Beta 版 Monitoring 信息中心安装

Edge for Private Cloud 4.17.01 版

系统要求

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

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

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

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

  • 双核 CPU
  • 4 GB RAM
  • 250GB 磁盘可用空间（监控数据会在 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 的文本文件中设置这些变量：

属性

说明

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

在独立节点或运行 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 创建配置文件。通常，您会将此文件存储在“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 创建配置文件。通常，您会将此文件存储在“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 版监控信息中心

如果您在 4.16.09 中安装了 Apigee Monitoring Dashboard 的 Beta 版，则可以将其更新为 4.17.01 的 Beta 版。

您必须按以下顺序更新信息中心组件：

  • apigee-influxdb
  • 每个节点上的 apigee-telegraf
  • apigee-grafana

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

  1. 按照将 Apigee Edge 4.16.01/4.16.05 更新到 4.17.01 和将 Apigee Edge 4.16.09 更新到 4.17.01 中的说明，将 Edge 更新到 4.17.01。
  2. 更新 apigee-influxdb：
    > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb update
    > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb setup
    > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb restart
  3. 在节点 1 上更新 apigee-telegraf：
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf update
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f /opt/apigee/customer/application/sa_telegraf.txt
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
  4. 对每个节点重复执行第 3 步。
  5. 更新 apigee-grafana：
    > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana update
    > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana setup -f /opt/apigee/customer/application/sa_grafana.txt
    > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana restart