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

私有雲的邊緣 4.17.05 版

系統需求

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

為每個 Edge 節點安裝 apigee-telegraf

在 Edge 安裝的每個節點上：

  1. 在第一個 Edge 節點中安裝 apigee-telegraf：
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install
  2. 為名稱為 sa_telegraf.txt 的 apigee-telegraf 建立設定檔。通常，您會將這個檔案儲存在由「apigee」使用者存取的目錄中，例如 /opt/apigee/customer/application，並使其為「apigee」使用者擁有。

    在檔案中設定下列屬性，指定 apigee-influxdb 節點的網址，包括通訊埠 8086：
    INFLUXDB_URL=http://influx_IP:8086
  3. 將擁有者變更為「apigee」：
    > chown apigee: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 restart
  6. 對所有邊緣節點重複執行這項程序。

在單一 Edge 節點上安裝 apigee-grafana

在 Edge 安裝的單一節點上，例如 Edge UI 節點：

  1. 在第一個 Edge 節點中安裝 apigee-grafana：
    > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana install
  2. 為名稱為 sa_grafana.txt 的 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: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. 確認 apigee-influxdb 資料節點開啟下列 TCP 通訊埠：8086 和 8183。
    2. 使用下列網址在瀏覽器中開啟 fluxdb 使用者介面：
      http://influxdb_IP_or_DNS:8183
      1. 在「查詢」欄位中輸入「顯示資料庫」。
        確保已建立下列資料庫：system、app、Events、_internal。
      2. 在「查詢」欄位中輸入「顯示伺服器」。
        請務必看到 apigee-influxdb 節點。
  3. 查看資訊主頁的資料來源：
    1. 在主選單中選取「資料來源」。畫面上應該會顯示三個資料來源的圖示。
    2. 為每個資料來源選取圖示。
    3. 在資料來源的詳細資料頁面中，選取「Save & Test」按鈕。
    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 中安裝 Apigee Monitoring 資訊主頁的 Beta 版，則可以在 4.17.05 中將該版本更新至 Beta 版。

如要更新 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 的說明，將 Edge 更新至 4.17.05。
  2. 更新管理伺服器節點中的 apigee-influxdb：
    > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile


    其中，configFile 是您用來安裝 apigee-influx 的設定檔。

    如果您也在管理伺服器節點中安裝了 apigee-grafana，這個步驟也會更新 apigee-grafana。否則，請更新 apigee-granfana，如下列步驟所示。
  3. 如果您未在管理伺服器節點中安裝 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-telegraf update
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f configFile
  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 的說明，將 Edge 更新至 4.17.05。
  2. 更新管理伺服器節點中的 apigee-influxdb：
    > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile


    其中，configFile 是您用來安裝 apigee-influx 的設定檔。

    如果您也在管理伺服器節點中安裝了 apigee-grafana，這個步驟也會更新 apigee-grafana。否則，請更新 apigee-granfana，如下列步驟所示。
  3. 如果您未在管理伺服器節點中安裝 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/apigee/apigee/apigee/apigee/apigee/狀況
    > 報名。
  5. 對每個節點重複執行步驟 4。