Monitoring 資訊主頁安裝 (Beta 版)

私有雲 v4.18.01 的邊緣

系統需求

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

您可以在其他節點上安裝「apigee-grafana」，或重複使用現有的任一邊緣節點，例如 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

為每個 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 /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. 為名為 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 /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. 在「查詢」欄位中輸入「顯示資料庫」。確保已建立下列資料庫：system, application, events, _internal。
      2. 在「查詢」欄位中輸入「顯示伺服器」。確認畫面上列出 apigee-influxdb 節點。
3. 查看資訊主頁的資料來源：
   1. 在主選單中選取「資料來源」。畫面上應該會顯示三個資料來源的圖示。
   2. 為每個資料來源選取圖示。
   3. 在資料來源的詳細資料頁面中，選取「Save & Test」按鈕。
   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.0 倍安裝 Apigee Monitoring 資訊主頁 Beta 版，則可以將其更新至 Beta 版 4.18.01。

如要更新 Beta 版監控資訊主頁：

1. 按照更新 Apigee Edge 4.17.01/4.17.05 至 4.17.09、將 Apigee Edge 4.16.09 更新至 4.17.09 和將 Apigee Edge 4.16.01/4.16.050 4.16.050.09.17 所述所述，將 Edge 更新至 4.18.01。
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
   > /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. 按照將 Apigee Edge 4.16.01/4.16.05 至 4.17.01 及將 Apigee Edge 4.16.09 更新至 4.17.01 的說明，將 Edge 更新至 4.18.01。
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/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。