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-grafanaapigee-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 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 步。