Monitoring 資訊主頁安裝 (Beta 版)

Edge for Private Cloud 4.18.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 的文字檔中設定這些變數：

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

在獨立節點或執行管理伺服器或 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 建立名為 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. 請確認 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 版監控資訊主頁

請根據您要升級的 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 Dashboard 的 Beta 版，可以更新至 4.18.01 的 Beta 版。

如要更新 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.05 更新至 4.17.09」一文所述，將 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。