設定代理程式以收集資料( Windows/Linux )
Data Infrastructure Insights 使用"Telegraf"其代理程式來收集整合資料。Telegraf是外掛程式導向的伺服器代理程式、可用來收集及報告度量、事件及記錄。輸入外掛程式可透過直接存取系統/作業系統、呼叫協力廠商API或聆聽已設定的串流(例如 卡夫卡、塔斯D等)。輸出外掛程式用於將收集的度量、事件和記錄從代理程式傳送至 Data Infrastructure Insights 。
Data Infrastructure Insights 目前的 Telegraf 版本是 1.24.0 。
如需在 Kubernetes 上安裝的相關資訊,請參閱"NetApp Kubernetes監控操作員"頁面。
為確保稽核與資料報告的準確性、強烈建議您使用*網路時間傳輸協定(NTP)*或*簡易網路時間傳輸協定(SNTP)*來同步代理機器上的時間。 |
如果您想在安裝 Agent 之前驗證安裝檔案,請參閱以下的一節驗證Checksum。 |
安裝代理程式
如果您正在安裝服務資料收集器、但尚未設定代理程式、系統會提示您先安裝適當作業系統的代理程式。本主題提供在下列作業系統上安裝Telegraf代理程式的說明:
若要安裝代理程式、無論您使用的平台為何、都必須先執行下列動作:
-
登入您要用於代理程式的主機。
-
登入您的 Data Infrastructure Insights 環境、然後瀏覽至 * 「可服務性」 > 「收集器」 * 。
-
按一下「+資料收集器」、然後選擇要安裝的資料收集器。
-
為您的主機選擇適當的平台( Windows 、 Linux )
-
請針對每個平台執行其餘步驟。
在主機上安裝代理程式之後、您就不需要在該主機上重新安裝代理程式。 |
一旦您在伺服器 / 虛擬機器上安裝代理程式、 Data Infrastructure Insights 除了從您設定的任何資料收集器收集資料外、還會從該系統收集度量。這些指標會收集為"「節點」度量"。 |
如果您使用的是Proxy、請先閱讀平台的Proxy指示、再安裝Telegraf代理程式。 |
記錄位置
Telegraf 記錄訊息會從 STDout 重新導向至下列記錄檔為預設值:
-
RHEL/CentOS : /var/log/telegraf/telegraf.log
-
Ubuntu / Debian : /var/log/telegraf/telegraf.log
-
Windows : C:\Program Files\telegraf\telegraf.log
Windows
先決條件:
-
必須安裝PowerShell
-
如果您使用的是Proxy、則必須遵循*設定Proxy支援for Windows *一節中的指示。
設定適用於Windows的Proxy支援
如果您的環境使用Proxy、請先閱讀本節再安裝。 |
以下步驟概述設定_https_proxy/https_proxy_環境變數所需的動作。在某些Proxy環境中、使用者可能也需要設定_no_proxyEnvironments _變數。 |
對於位於Proxy後的系統、請執行下列步驟、設定安裝Telegraf代理程式之前*的_https_proxy_和/或_https_proxy_環境變數:
[System.Environment]::SetEnvironmentVariable(“https_proxy”, “<proxy_server>:<proxy_port>”, [System.EnvironmentVariableTarget]::Machine)
安裝代理程式
-
選擇代理程式存取金鑰。
-
從代理程式安裝對話方塊複製命令區塊。您可以按一下剪貼簿圖示、將命令快速複製到剪貼簿。
-
開啟PowerShell視窗
-
將命令貼到PowerShell視窗中、然後按Enter鍵。
-
命令會下載適當的代理程式安裝程式、安裝並設定預設組態。完成後、它會重新啟動代理程式服務。此命令具有唯一的金鑰、有效時間為24小時。
-
單擊*完成*或*繼續*
安裝代理程式之後、您可以使用下列命令來啟動/停止服務:
Start-Service telegraf Stop-Service telegraf
解除安裝代理程式
若要在Windows上解除安裝代理程式、請在PowerShell視窗中執行下列動作:
-
停止並刪除Telegraf服務:
Stop-Service telegraf sc.exe delete telegraf
-
從信任來源移除憑證:
cd Cert:\CurrentUser\Root //rm E5FB7B68C08B1CA902708584C274F8EFC7BE8ABC rm 1A918038E8E127BB5C87A202DF173B97A05B4996
-
刪除_C:\Program Files\Telewraf_資料夾、以移除二進位檔、記錄檔和組態檔
-
從登錄中移除_system\CurrentControlSet\Services\EventLog\Application\Telewraf_機碼
升級代理程式
若要升級Telewraf代理程式、請執行下列步驟:
-
停止並刪除Telewraf服務:
Stop-Service telegraf sc.exe delete telegraf
-
從登錄中刪除_system\CurrentControlSet\Services\EventLog\Application\Telewraf_機碼
-
刪除_C:\Program Files\Telewraf\Telewraf.conf
-
刪除_C:\Program Files\Telewraf\Telewraf_exe_
RHEL與CentOS
先決條件:
-
下列命令必須可用:curl、Sudo、ping、shav256sum、openssl、 和dmidecode
-
如果您使用Proxy、則必須遵循*設定RHEL/CentOS* Proxy支援一節中的指示。
設定RHEL/CentOS的Proxy支援
如果您的環境使用Proxy、請先閱讀本節再安裝。 |
以下步驟概述設定_https_proxy/https_proxy_環境變數所需的動作。在某些Proxy環境中、使用者可能也需要設定_no_proxyEnvironments _變數。 |
對於位於Proxy之後的系統、請執行下列步驟*先前*、以安裝Telegraf代理程式:
-
為目前使用者設定_https_proxy_和/或_https_proxy_環境變數:
export https_proxy=<proxy_server>:<proxy_port> . 建立/etc/default/Telegraf_、並插入_https_proxy_和/或_https_proxy_變數的定義:
https_proxy=<proxy_server>:<proxy_port>
安裝代理程式
-
選擇代理程式存取金鑰。
-
從代理程式安裝對話方塊複製命令區塊。您可以按一下剪貼簿圖示、將命令快速複製到剪貼簿。
-
開啟Bash視窗
-
將命令貼到Bash視窗中、然後按Enter鍵。
-
命令會下載適當的代理程式安裝程式、安裝並設定預設組態。完成後、它會重新啟動代理程式服務。此命令具有唯一的金鑰、有效時間為24小時。
-
單擊*完成*或*繼續*
安裝代理程式之後、您可以使用下列命令來啟動/停止服務:
如果您的作業系統使用systemd(CentOS 7+和RHEL 7+):
sudo systemctl start telegraf sudo systemctl stop telegraf
如果您的作業系統未使用systemd(CentOS 7+和RHEL 7+):
sudo service telegraf start sudo service telegraf stop
解除安裝代理程式
若要在RHEL/CentOS上解除安裝代理程式、請在Bash終端機中執行下列動作:
-
停止Telegraf服務:
systemctl stop telegraf (If your operating system is using systemd (CentOS 7+ and RHEL 7+) /etc/init.d/telegraf stop (for systems without systemd support)
-
移除Telegraf代理程式:
yum remove telegraf . 移除可能留下的任何組態或記錄檔:
rm -rf /etc/telegraf* rm -rf /var/log/telegraf*
升級代理程式
若要升級Telewraf代理程式、請執行下列步驟:
-
停止Telewraf服務:
systemctl stop telegraf (If your operating system is using systemd (CentOS 7+ and RHEL 7+) /etc/init.d/telegraf stop (for systems without systemd support)
-
移除先前的Telewraf代理程式:
yum remove telegraf . link:#rhel-and-centos["安裝新代理程式"]。
Ubuntu與DEBIAN
先決條件:
-
下列命令必須可用:curl、Sudo、ping、shav256sum、openssl、 和dmidecode
-
如果您使用的是代理服務器,則必須按照*配置Ubuntu / DEBIAN*代理支持一節中的說明操作。
設定Ubuntu / Debian的Proxy支援
如果您的環境使用Proxy、請先閱讀本節再安裝。 |
以下步驟概述設定_https_proxy/https_proxy_環境變數所需的動作。在某些Proxy環境中、使用者可能也需要設定_no_proxyEnvironments _變數。 |
對於位於Proxy之後的系統、請執行下列步驟*先前*、以安裝Telegraf代理程式:
-
為目前使用者設定_https_proxy_和/或_https_proxy_環境變數:
export https_proxy=<proxy_server>:<proxy_port> . 建立/etc/default/Telegraf、並插入_https_proxy_和/或_https_proxy_變數的定義:
https_proxy=<proxy_server>:<proxy_port>
安裝代理程式
-
選擇代理程式存取金鑰。
-
從代理程式安裝對話方塊複製命令區塊。您可以按一下剪貼簿圖示、將命令快速複製到剪貼簿。
-
開啟Bash視窗
-
將命令貼到Bash視窗中、然後按Enter鍵。
-
命令會下載適當的代理程式安裝程式、安裝並設定預設組態。完成後、它會重新啟動代理程式服務。此命令具有唯一的金鑰、有效時間為24小時。
-
單擊*完成*或*繼續*
安裝代理程式之後、您可以使用下列命令來啟動/停止服務:
如果您的作業系統使用systemd:
sudo systemctl start telegraf sudo systemctl stop telegraf
如果您的作業系統未使用systemd:
sudo service telegraf start sudo service telegraf stop
解除安裝代理程式
若要在Ubuntu / Debian上解除安裝代理程式、請在Bash終端機中執行下列作業:
-
停止Telegraf服務:
systemctl stop telegraf (If your operating system is using systemd) /etc/init.d/telegraf stop (for systems without systemd support)
-
移除Telegraf代理程式:
dpkg -r telegraf . 移除可能留下的任何組態或記錄檔:
rm -rf /etc/telegraf* rm -rf /var/log/telegraf*
升級代理程式
若要升級Telewraf代理程式、請執行下列步驟:
-
停止Telewraf服務:
systemctl stop telegraf (If your operating system is using systemd) /etc/init.d/telegraf stop (for systems without systemd support)
-
移除先前的Telewraf代理程式:
dpkg -r telegraf . link:#ubuntu-and-debian["安裝新代理程式"]。
驗證Checksum
Data Infrastructure Insights 代理程式安裝程式會執行完整性檢查、但有些使用者可能會想要在安裝或套用下載的成品之前執行自己的驗證。您可以下載安裝程式並為下載的套件產生Checksum、然後將Checksum與安裝說明中顯示的值進行比較、以完成此作業。
無需安裝即可下載安裝程式套件
若要執行純下載作業(而非預設的下載與安裝)、使用者可以編輯從UI取得的代理程式安裝命令、並移除後置「install」選項。
請遵循下列步驟:
-
依照指示複製代理程式安裝程式程式片段。
-
不要將程式碼片段貼到命令視窗中、而是貼到文字編輯器中。
-
從命令中刪除結尾的 "--install" ( Linux )或 "-install" ( Windows )。
-
從文字編輯器複製整個命令。
-
現在請將其貼到命令視窗(工作目錄)中、然後執行。
非Windows(這些範例適用於Kubernetes;實際的指令碼名稱可能有所不同):
-
下載並安裝(預設):
installerName=cloudinsights-kubernetes.sh … && sudo -E -H ./$installerName --download –-install * 僅限下載:
installerName=cloudinsights-kubernetes.sh … && sudo -E -H ./$installerName --download
Windows:
-
下載並安裝(預設):
!$($installerName=".\cloudinsights-windows.ps1") … -and $(&$installerName -download -install) * 僅限下載:
!$($installerName=".\cloudinsights-windows.ps1") … -and $(&$installerName -download)
下載專用命令會將 Data Infrastructure Insights 中所有必要的成品下載到工作目錄中。這些成品包括但不限於:
-
安裝指令碼
-
環境檔案
-
Y反 洗錢檔案
-
Checksum 檔案(結尾為 sho256.signed 或 sho256.ps1 )
安裝指令碼、環境檔案及Yaml檔案均可使用目視檢查進行驗證。
產生Checksum值
若要產生Checksum值、請針對您的適當平台執行下列命令:
-
RHEL/Ubuntu:
sha256sum <package_name> * Windows:
Get-FileHash telegraf.zip -Algorithm SHA256 | Format-List
驗證 Checksum
從 Checksum 檔案擷取預期的 Checksum
-
非Windows:
openssl smime -verify -in telegraf*.sha256.signed -CAfile netapp_cert.pem -purpose any -nosigs -noverify * Windows:
(Get-Content telegraf.zip.sha256.ps1 -First 1).toUpper()
安裝下載的套件
一旦所有成品都已通過驗證、即可執行下列步驟來啟動代理程式安裝:
非Windows:
sudo -E -H ./<installation_script_name> --install Windows:
.\cloudinsights-windows.ps1 -install
疑難排解
如果您在設定代理程式時遇到問題、請嘗試下列事項:
問題: | 試用: |
---|---|
設定新的外掛程式並重新啟動Telegraf之後、Telegraf無法啟動。記錄顯示類似下列的錯誤:「[Telegraf]錯誤執行代理程式:載入組態檔/etc/Telegraf/Telegraf.d/cloudss-default.conf時發生錯誤:plugin outs.http:line <linenumber> fes:組態指定欄位["use_system_proxy"、但未使用」 |
安裝的Telegraf版本已過時。請依照本頁的步驟*升級您適當平台的代理程式*。 |
我在舊安裝上執行安裝程式指令碼、現在代理程式並未傳送資料 |
解除安裝Telewraf代理程式、然後重新執行安裝指令碼。請依照本頁上的*升級代理程式*步驟、以取得適當的平台。 |
我已使用 Data Infrastructure Insights 安裝代理程式 |
如果您已在主機/ VM上安裝代理程式、則不需要重新安裝代理程式。在這種情況下、只要在「代理程式安裝」畫面中選擇適當的平台和金鑰、然後按一下*繼續*或*完成*即可。 |
我已安裝代理程式、但未使用 Data Infrastructure Insights 安裝程式 |
移除先前的代理程式並執行 Data Infrastructure Insights Agent 安裝、以確保正確的預設組態檔案設定。完成後、按一下*繼續*或*完成*。 |
您可以在頁面或中找到其他"支援""資料收集器支援對照表"資訊。