Private Cloud v. 4.17.01 版
系統需求
您必須在所有 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 節點上:
- 安裝 apigee-influxdb:
> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb install - 設定 apigee-influxdb 資料庫:
> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb 設定 - 啟動 apigee-influxdb:
> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb start
在以下位置安裝 apigee-telegraf 每個 Edge 節點
在 Edge 安裝的每個節點上:
- 在第一個 Edge 節點中安裝 apigee-telegraf:
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install - 建立 apigee-telegraf 的設定檔。通常,您需要儲存
將檔案設為可透過「apigee」存取的目錄使用者,例如 /opt/apigee/customer/application、
並由「apigee」擁有內容。
在檔案中設定下列屬性,以指定 apigee-influxdb 節點的網址, 包括通訊埠 8086:
INFLUXDB_URL=http://influx_IP:8086 - 將擁有者變更為「apigee」:
>Chown apigee:apigee /opt/apigee/customer/application/sa_telegraf.txt - 設定 apigee-telegraf:
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf 設定 -f /opt/apigee/customer/application/sa_telegraf.txt - 重新啟動 apigee-telegraf:
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf 重新啟動 - 對所有 Edge 節點重複此程序。
在以下位置安裝 apigee-grafana 一個邊緣節點
在 Edge 安裝作業的單一節點上 (例如 Edge UI 節點):
- 在第一個 Edge 節點中安裝 apigee-grafana:
> /opt/apigee/apigee-service/bin/apigee-service apigee-grafana install - 建立 apigee-grafana 的設定檔。通常,您需要儲存
位於「apigee」可存取的目錄中使用者,例如 /opt/apigee/customer/application、
並由「apigee」擁有內容。
在檔案中設定下列屬性。上述屬性說明如下:
INFLUXDB_HOST=192.168.56.101
INFLUXDB_PORT=8086
GRAFANA_USERNAME=admin
GRAFANA_PASSWORD=admin - 將擁有者變更為「apigee」:
>Chown apigee:apigee /opt/apigee/customer/application/sa_grafana.txt - 設定 apigee-grafana
使用設定檔:
> /opt/apigee/apigee-service/bin/apigee-service apigee-grafana setup -f /opt/apigee/customer/application/sa_grafana.txt - 重新啟動 apigee-grafana:
> /opt/apigee/apigee-service/bin/apigee-service apigee-grafana restart
如要存取資訊主頁,請在瀏覽器中開啟以下網址:
http://grafana_IP_or_DNS:3000
使用您在 apigee-grafana 的設定檔中指定的憑證登入。在上述範例中 使用者名稱/密碼為「admin」/「admin」。
排解安裝問題
如果資訊主頁沒有顯示資料,請按照下列程序進行疑難排解 安裝:
- 確保 apigee-telegraf
正在收集資料
- 執行 apigee-service apigee-telegraf 設定,此為冪等、檢查錯誤、缺少依附元件 並解決這些問題
- 重新啟動 apigee-telegraf 並查看 /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log 任何錯誤
- 確保 apigee-influxdb
正在接收資料:
- 確保下列 TCP 通訊埠已在 apigee-influxdb 資料節點開啟:8086 和 8183。
- 使用下列網址在瀏覽器中開啟 Influxdb UI:
http://influxdb_IP_or_DNS:8183- 在「Query」(查詢) 欄位中輸入「show database」(顯示資料庫)。
確認已建立以下資料庫:系統、應用程式、事件、 _internal。 - 在「Query」(查詢) 欄位中輸入「show server」(顯示伺服器)。
確認畫面顯示 apigee-influxdb 節點: 。
- 在「Query」(查詢) 欄位中輸入「show database」(顯示資料庫)。
- 查看資料來源至資訊主頁:
- 在主選單中,選取「資料來源」。您應該會看到三個圖示 顯示了不同資料來源
- 請為每個資料來源選取相應的圖示。
- 在資料來源的詳細資料頁面中,選取「儲存並」測試 按鈕。
- 如果資料來源設定正確,您應該會看到以下格式的訊息:
成功
資料來源正常運作
更新 Beta 版監控資訊主頁
如果您安裝的是 4.16.09 版 Apigee Monitoring 資訊主頁 Beta 版,則 請更新至 Beta 版 4.17.01
您必須按照下列順序更新資訊主頁元件:
- apigee-influxdb
- 每個項目均搭載 apigee-telegraf 節點
- apigee-grafana
如要更新 Beta 版監控資訊主頁,請按照下列步驟操作:
- 按照將 Apigee Edge 4.16.01/4.16.05 更新至 4.17.01 的說明將 Edge 更新至 4.17.01 並將 Apigee Edge 4.16.09 更新至 4.17.01。
- 更新 apigee-influxdb:
> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb update
>/opt/apigee/apigee-service/bin/apigee-service apigee-influxdb 設定
>/opt/apigee/apigee-service/bin/apigee-service apigee-influxdb restart - 更新以下項目的 apigee-telegraf:
節點 1:
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf 更新
>/opt/apigee/apigee-service/bin/apigee-service apigee-telegraf 設定 -f /opt/apigee/customer/application/sa_telegraf.txt
> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf 重新啟動 - 針對每個節點重複步驟 3。
- 更新 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