Beta 版 Monitoring 信息中心安装

适用于私有云的 Edge v. 4.17.05

系统要求

您必须在所有 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-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

在独立节点或运行管理服务器或边缘界面的 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 创建一个名为 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 设置 -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 创建一个名为 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 设置 -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 版监控信息中心

根据您升级前使用的 Edge 版本,执行以下两项操作之一:

  • 4.16.09 和 4.17.01 使用相同的流程
  • 4.16.05 要求您在更新过程中卸载 apigee-collectd

从版本更新 4.16.09 或 4.17.01

如果您在 4.16.09 或 4.17.01 中安装了 Beta 版 Apigee Monitoring 信息中心, 您可以更新到 4.17.05 的测试版

如需更新 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
  2. 更新 apigee-influxdb 管理服务器节点:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile

    其中,configFile 是您用来 apigee-influx

    如果还在 Management API 中安装了 apigee-grafana 服务器节点,那么此步骤还会更新 apigee-grafana。否则,请更新 apigee-granfana,如 。
  3. 如果您没有在 API 中安装 apigee-grafana, 管理服务器节点,请在需要更新的节点上更新 apigee-grafana 安装了它:
    &gt;/opt/apigee/apigee-setup/bin/update.sh -c pp -f 配置文件
  4. 更新 apigee-telegraf: 节点 1:
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-Telegraf 更新
    &gt;/opt/apigee/apigee-service/bin/apigee-service apigee-Telegraf 设置 -f configFile
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf 重启
  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
  2. 更新 apigee-influxdb 管理服务器节点:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile

    其中,configFile 是您用来 apigee-influx

    如果还在 Management API 中安装了 apigee-grafana 服务器节点,那么此步骤还会更新 apigee-grafana。否则,请更新 apigee-granfana,如 。
  3. 如果您没有在 API 中安装 apigee-grafana, 管理服务器节点,请在需要更新的节点上更新 apigee-grafana 安装了它:
    &gt;/opt/apigee/apigee-setup/bin/update.sh -c pp -f 配置文件
  4. 在节点 1
    上安装 apigee-telegraf &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-collectd 停止
    &gt;/opt/apigee/apigee-service/bin/apigee-service apigee-Telegraf 安装
    &gt;/opt/apigee/apigee-service/bin/apigee-service apigee-Telegraf 设置 -f configFile
    &gt;/opt/apigee/apigee-service/bin/apigee-service apigee-Telegraf 重启
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-collectd 卸载
  5. 对每个节点重复执行第 4 步。