Beta 版 Monitoring 信息中心安装

适用于私有云的 Edge v. 4.17.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 的文本文件：

属性

说明

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

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

  1. 安装 apigee-influxdb：
    > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb 安装
  2. 配置 apigee-influxdb 数据库：
    > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb 设置”
  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 安装”
  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 设置 -f /opt/apigee/customer/application/sa_telegraf.txt
  5. 重启 apigee-telegraf：
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf 重启
  6. 在所有 Edge 节点上重复此过程。

安装 apigee-grafana 单个 Edge 节点

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

  1. 在您的第一个 Edge 节点上，安装 apigee-grafana：
    > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana 安装”
  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 设置 -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 设置，具有幂等性，可检查是否存在错误、缺少依赖项 并解决这些问题。
    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. 在“查询”字段中，输入“显示数据库”。
        确保已创建以下数据库：系统、应用、事件、 _internal。
      2. 在“查询”字段中，输入“show servers”。
        确保看到 apigee-influxdb 节点 。
  3. 检查信息中心的数据源： <ph type="x-smartling-placeholder">
      </ph>
    1. 在主菜单中选择数据源。您应该会看到三个代表 数据源。
    2. 选择每个数据源对应的图标。
    3. 在数据源的详情页面中，选择保存并测试 按钮。
    4. 如果数据源配置正确，您应该会看到以下形式的消息：
      成功
      数据源正常运行

更新 Beta 版监控信息中心

如果您在 4.16.09 中安装了 Beta 版 Apigee Monitoring 信息中心，则可以 请将其更新到 4.17.01 的 Beta 版。

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

  • apigee-influxdb
  • apigee-Telegraf 节点
  • apigee-grafana

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

  1. 按照将 Apigee Edge 4.16.01/4.16.05 更新到 4.17.01 中所述，将 Edge 更新至 4.17.01。 和将 Apigee Edge 4.16.09 更新为 4.17.01。
  2. 更新 apigee-influxdb：
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb 更新
    &gt;/opt/apigee/apigee-service/bin/apigee-service apigee-influxdb 设置
    &gt;/opt/apigee/apigee-service/bin/apigee-service apigee-influxdb restart”
  3. 更新 apigee-telegraf： 节点 1：
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-Telegraf 更新
    &gt;/opt/apigee/apigee-service/bin/apigee-service apigee-Telegraf 设置 -f /opt/apigee/customer/application/sa_telegraf.txt
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf 重启
  4. 对每个节点重复第 3 步。
  5. 更新 apigee-grafana：
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-grafana 更新
    &gt;/opt/apigee/apigee-service/bin/apigee-service apigee-grafana 设置 -f /opt/apigee/customer/application/sa_grafana.txt
    &gt;/opt/apigee/apigee-service/bin/apigee-service apigee-grafana restart”