Monitoring 資訊主頁安裝 (Beta 版)

Private Cloud v4.18.01 專用 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 的文字檔中設定：

http://192.168.0.1:8086

apigee-grafana 的設定參數

在您傳遞至 apigee-grafana setup 的文字檔案中設定這些屬性 指令例如，請在名為 sa_grafana.txt 的文字檔中設定：

192.168.0.1

安裝操作說明

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

• 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 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 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 setup，它是等冪的，請檢查 缺少並解決依附元件
   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」(顯示資料庫)。確認下列資料庫 已建立：system, application, events, _internal。
      2. 在「Query」(查詢) 欄位中輸入「show server」(顯示伺服器)。請務必看到 已列出 apigee-influxdb 個節點。
3. 查看資料來源至資訊主頁：
   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 安裝 Apigee Monitoring 資訊主頁的 Beta 版， 請更新至 Beta 版 4.18.01

如要更新 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」： 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 管理伺服器節點，請在您所在的節點上更新 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」： 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 管理伺服器節點，請在您所在的節點上更新 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。