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

Edge for Private Cloud 4.17.01 版

系統需求

您必須在所有 Edge 節點上安裝 apigee-telegraf，才能收集資訊主頁資料。因此，apigee-telegraf 的系統需求與您安裝的 Edge 節點相同。

您可以在個別節點上安裝 apigee-grafana，或重複使用現有的 Edge 節點，例如管理伺服器或 Edge UI 節點。

如果是 apigee-influxdb，您可以將其安裝在現有的 Edge 節點上，例如管理伺服器節點或 Edge UI 節點，而不會變更系統需求。

如果基於效能考量，決定在自己的節點上安裝 apigee-influxdb，則節點應符合下列需求：

  • 2 核心 CPU
  • 4 GB RAM
  • 250 GB 磁碟空間 (監控資料會在 1 個月後清除)
  • 1,000 IOPS 以上

詳情請參閱 InfluxData 文件。

apigee-influxdb 的通訊埠需求

apigee-influxdb 資料節點必須開啟通訊埠 8086 和 8183，才能由執行 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

在獨立節點或執行管理伺服器或 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 setup
  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. 為 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 setup -f /opt/apigee/customer/application/sa_telegraf.txt
  5. > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
    重新啟動 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 的設定檔。一般來說，您會將這個檔案儲存在「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 setup，這是冪等指令，請檢查是否有錯誤、缺少依附元件，並加以解決。
    2. 重新啟動 apigee-telegraf，並檢查 /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log 是否有任何錯誤
  2. 如要確認 apigee-influxdb 是否正在接收資料，請按照下列步驟操作：
    1. 確認 apigee-influxdb 資料節點上已開啟下列 TCP 通訊埠：8086 和 8183。
    2. 使用下列網址在瀏覽器中開啟 influxdb UI：
      http://influxdb_IP_or_DNS:8183
      1. 在「查詢」欄位中輸入「show databases」，
        確認已建立下列資料庫：system、application、events、_internal。
      2. 在「Query」(查詢) 欄位中輸入「show servers」。
        確認畫面上列出 apigee-influxdb 節點。
  3. 查看資訊主頁的資料來源：
    1. 在主選單中選取「Data Sources」。畫面上應該會顯示三個資料來源的圖示。
    2. 選取每個資料來源的圖示。
    3. 在資料來源的詳細資料頁面中，選取「Save & Test」按鈕。
    4. 如果資料來源設定正確，您應該會看到以下格式的訊息：
      成功
      資料來源運作正常

更新 Beta 版監控資訊主頁

如果您在 4.16.09 中安裝了 Apigee Monitoring Dashboard 的 Beta 版，可以將其更新至 4.17.01 的 Beta 版。

請務必按照下列順序更新資訊主頁元件：

  • apigee-influxdb
  • 每個節點上的 apigee-telegraf
  • apigee-grafana

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

  1. 按照「將 Apigee Edge 4.16.01/4.16.05 更新至 4.17.01」和「將 Apigee Edge 4.16.09 更新至 4.17.01」一文所述，將 Edge 更新至 4.17.01。
  2. 更新 apigee-influxdb：
    > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb update
    > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb setup
    > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb restart
  3. 在節點 1 上更新 apigee-telegraf：
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf update
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f /opt/apigee/customer/application/sa_telegraf.txt
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
  4. 對每個節點重複執行步驟 3。
  5. 更新 apigee-grafana：
    > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana update
    > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana setup -f /opt/apigee/customer/application/sa_grafana.txt
    > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana restart