監控 Beta 版資訊主頁安裝情形

Private Cloud v. 4.17.05 專用 Edge

系統需求

您必須在所有 Edge 節點上安裝 apigee-telegraf，才能實現下列目標： 收集資訊主頁資料因此，apigee-telegraf 的系統需求與 Edge 相同 安裝該容器的節點。

您可以安裝 apigee-grafana 或重複使用其中一個現有的 Edge 節點，例如 Management Server 或 Edge UI 節點

至於 apigee-influxdb，您可以 安裝在現有的 Edge 節點，例如 Management Server 節點或 Edge UI 節點 系統需求維持不變

如果您決定在自有節點上安裝 apigee-influxdb 那麼節點應符合下列條件：

  • 2 個核心 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

用於登入資訊主頁 UI 的 Grafana 使用者名稱。

GRAFANA_PASSWORD

登入資訊主頁 UI 的 Grafana 密碼。

安裝操作說明

請按照下列操作說明，依序安裝資訊主頁元件：

  • apigee-influxdb (位於 中央節點)
  • apigee-telegraf (每個 節點)
  • apigee-grafana (在 中央伺服器)
，瞭解如何調查及移除這項存取權。

安裝 單一 Edge 節點或獨立節點上的 apigee-influxdb

在獨立節點或執行 Management Server 或 Edge UI 的 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 設定
  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 設定 -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 UI 節點)：

  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. 確保下列 TCP 通訊埠已在 apigee-influxdb 資料節點開啟：8086 和 8183。
    2. 使用下列網址在瀏覽器中開啟 Influxdb UI：
      http://influxdb_IP_or_DNS:8183
      1. 在「Query」(查詢) 欄位中輸入「show database」(顯示資料庫)。
        確認已建立以下資料庫：系統、應用程式、事件、 _internal。
      2. 在「Query」(查詢) 欄位中輸入「show server」(顯示伺服器)。
        確認畫面顯示 apigee-influxdb 節點： 。
  3. 查看資料來源至資訊主頁：
    1. 在主選單中，選取「資料來源」。您應該會看到三個圖示 顯示了不同資料來源
    2. 請為每個資料來源選取相應的圖示。
    3. 在資料來源的詳細資料頁面中，選取「儲存並」測試 按鈕。
    4. 如果資料來源設定正確，您應該會看到以下格式的訊息：
      成功
      資料來源正常運作

更新 Beta 版監控資訊主頁

請依據您要升級的 Edge 版本，使用以下其中一個程序：

  • 4.16.09 和 4.17.01 使用相同的程序
  • 4.16.05 更新時，您必須解除安裝 apigee-collectd。

從版本更新 4.16.09 或 4.17.01

如果您安裝的是 Beta 版 Apigee Monitoring 資訊主頁 4.16.09 或 4.17.01， 請更新至 Beta 版 4.17.05

如要更新 Beta 版監控資訊主頁，請按照下列步驟操作：

  1. 按照更新所述將 Edge 更新至 4.17.05 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： Management Server 節點：
    > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile

    其中 configFile 是用於安裝的設定檔 apigee-influx：

    如果您也在管理項目中安裝了 apigee-grafana 伺服器節點，這個步驟就會更新 apigee-grafana。否則，請更新 apigee-granfana，如 。
  3. 如果您並未在 管理伺服器節點，請在所在的節點上更新 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 更新
    >/opt/apigee/apigee-service/bin/apigee-service apigee-telegraf 設定 -f configFile
    > /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. 按照更新所述將 Edge 更新至 4.17.05 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： Management Server 節點：
    > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile

    其中 configFile 是用於安裝的設定檔 apigee-influx：

    如果您也在管理項目中安裝了 apigee-grafana 伺服器節點，這個步驟就會更新 apigee-grafana。否則，請更新 apigee-granfana，如 。
  3. 如果您並未在 管理伺服器節點，請在所在的節點上更新 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 設定 -f configFile
    >/opt/apigee/apigee-service/bin/apigee-service apigee-telegraf 重新啟動
    > /opt/apigee-service/bin/apigee-service apigee-collectd 解除安裝
  5. 針對每個節點重複執行步驟 4。