简体中文版经机器翻译而成，仅供参考。如与英语版出现任何冲突，应以英语版为准。

配置代理以收集数据（ Windows/Linux/Mac ）

03/06/2023 提供者

Cloud Insights 使用 "Telegraf" 作为收集集成数据的代理。Telegraf 是一种插件驱动的服务器代理，可用于收集和报告指标，事件和日志。输入插件用于通过直接访问系统 /OS ，调用第三方 API 或侦听已配置的流（例如 Kafka ， statsD 等）。输出插件用于将收集的指标，事件和日志从代理发送到 Cloud Insights 。

Cloud Insights 的当前Telegraf版本为*。1.24.0*。

为了准确地进行审核和报告数据，强烈建议使用 * 网络时间协议（ NTP ） * 或 * 简单网络时间协议（ SNTP ） * 同步 Agent 计算机上的时间。

如果要在安装代理之前验证安装文件，请参见以下章节验证校验和。

安装代理

如果您要安装服务数据收集器，但尚未配置代理，则系统会提示您先为相应的操作系统安装代理。本主题介绍如何在以下操作系统上安装 Telegraf 代理：

Windows
RHEL 和 CentOS
Ubuntu 和 Debian
macOS
Kubernetes

要安装代理，无论您使用的是哪个平台，都必须先执行以下操作：

登录到要用于代理的主机。
登录到 Cloud Insights 站点并转到 * 管理员 > 数据收集器 * 。
单击 * + Data Collector* 并选择要安装的数据收集器。
为您的主机选择合适的平台（ Windows ， Linux ， macOS 等）
对每个平台执行其余步骤。

在主机上安装代理后，无需在该主机上重新安装代理。

在服务器 /VM 上安装代理后， Cloud Insights 除了从您配置的任何数据收集器收集数据之外，还会从该系统收集指标。这些指标将作为收集 "" 节点 " 指标"。

如果您使用的是代理，请在安装 Telegraf 代理之前阅读适用于您的平台的代理说明。

Windows

前提条件：

必须安装 PowerShell
如果您使用的是代理、则必须按照*为Windows配置代理支持"一节中的说明进行操作。

为 Windows 配置代理支持

如果您的环境使用代理、请在安装之前阅读本节。

以下步骤概述了设置 http_proxy/https_proxy_environment 变量所需的操作。对于某些代理环境，用户可能还需要设置 _no_proxy environment 变量。

对于驻留在代理后面的系统，请执行以下操作以设置 https_proxy 和 / 或 http_proxy 环境变量 * 先前 * 以安装 Telegraf 代理：

[System.Environment]::SetEnvironmentVariable(“https_proxy”, “<proxy_server>:<proxy_port>”, [System.EnvironmentVariableTarget]::Machine)

安装代理

Windows 代理安装

在 Windows 上安装代理的步骤：

选择代理访问密钥。
从代理安装对话框复制命令块。您可以单击剪贴板图标将命令快速复制到剪贴板。
打开 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\Ceraf 文件夹以删除二进制文件，日志和配置文件
从注册表中删除 system\CurrentControlSet\Services\EventLog\Application\Ceaf 密钥

升级代理

要升级电报代理，请执行以下操作：

停止并删除此电报服务：

Stop-Service telegraf
sc.exe delete telegraf

从注册表中删除 system\CurrentControlSet\Services\EventLog\Application\Ceaf 密钥
删除 _C ： \Program Files\celaf\celeaf.conf
删除 _C ： \Program Files\caraf\caraf.exe
"安装新代理"。

RHEL 和 CentOS

前提条件：

必须提供以下命令： curl ， sudo ， ping ， sha256sum ， openssl ，和 dmidecode
如果您使用的是代理、则必须按照*为RHEL/CentOS*配置代理支持"一节中的说明进行操作。

为 RHEL/CentOS 配置代理支持

如果您的环境使用代理、请在安装之前阅读本节。

以下步骤概述了设置 http_proxy/https_proxy_environment 变量所需的操作。对于某些代理环境，用户可能还需要设置 _no_proxy environment 变量。

对于驻留在代理后面的系统，请执行以下步骤 * 先前 * 以安装 Telegraf 代理：

为当前用户设置 https_proxy 和 / 或 http_proxy 环境变量：

 export https_proxy=<proxy_server>:<proxy_port>
. 创建 _/etc/default/tengraf_ ，并插入 _https_proxy_and/or _http_proxy_ 变量的定义：

https_proxy=<proxy_server>:<proxy_port>

安装代理

RHEL/CentOS 代理安装

在 RHEL/CentOS 上安装代理的步骤：

选择代理访问密钥。
从代理安装对话框复制命令块。您可以单击剪贴板图标将命令快速复制到剪贴板。
打开 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*

升级代理

要升级电报代理，请执行以下操作：

停止电报服务：

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)

删除先前的电报代理：

 yum remove telegraf
. link:#rhel-and-centos["安装新代理"]。

Ubuntu 和 Debian

前提条件：

必须提供以下命令： curl ， sudo ， ping ， sha256sum ， openssl ，和 dmidecode
如果您使用的是代理、则必须按照*为Ubuntu或Debian配置代理支持*一节中的说明进行操作。

为 Ubuntu 或 Debian 配置代理支持

如果您的环境使用代理、请在安装之前阅读本节。

以下步骤概述了设置 http_proxy/https_proxy_environment 变量所需的操作。对于某些代理环境，用户可能还需要设置 _no_proxy environment 变量。

对于驻留在代理后面的系统，请执行以下步骤 * 先前 * 以安装 Telegraf 代理：

为当前用户设置 https_proxy 和 / 或 http_proxy 环境变量：

 export https_proxy=<proxy_server>:<proxy_port>
. 创建 /etc/default/celaff ，并插入 _https_proxy_and/or _http_proxy_ 变量的定义：

https_proxy=<proxy_server>:<proxy_port>

安装代理

Ubuntu 或 Debian 代理安装

在 Debian 或 Ubuntu 上安装代理的步骤：

选择代理访问密钥。
从代理安装对话框复制命令块。您可以单击剪贴板图标将命令快速复制到剪贴板。
打开 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*

升级代理

要升级电报代理，请执行以下操作：

停止电报服务：

systemctl stop telegraf (If your operating system is using systemd)
/etc/init.d/telegraf stop (for systems without systemd support)

删除先前的电报代理：

 dpkg -r telegraf
. link:#ubuntu-and-debian["安装新代理"]。

macOS

前提条件：

必须提供以下命令： curl ， sudo ， openssl 和 shasum
如果您使用的是代理、则必须按照*为macOS*配置代理支持"一节中的说明进行操作。

为 macOS 配置代理支持

如果您的环境使用代理、请在安装之前阅读本节。

以下步骤概述了设置 http_proxy/https_proxy_environment 变量所需的操作。对于某些代理环境，用户可能还需要设置 _no_proxy environment 变量。

对于驻留在代理后面的系统，请执行以下操作，为当前用户 * 先前 * 设置 https_proxy 和 / 或 http_proxy 环境变量，以安装 Telegraf 代理：

 export https_proxy=<proxy_server>:<proxy_port>
* 安装 Telegraf 代理之后，在 _/Applications/Telegraf.app/Contents/telegraf.plist_: 中添加并设置适当的 _https_proxy_and/or _http_proxy_ 变量

…
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
   <key>EnvironmentVariables</key>
   <dict>
          <key>https_proxy</key>
          <string><proxy_server>:<proxy_port></string>
   </dict>
   <key>Program</key>
   <string>/Applications/telegraf.app/Contents/MacOS/telegraf</string>
   <key>Label</key>
   <string>telegraf</string>
   <key>ProgramArguments</key>
   <array>
     <string>/Applications/telegraf.app/Contents/MacOS/telegraf</string>
     <string>--config</string>
     <string>/usr/local/etc/telegraf.conf</string>
     <string>--config-directory</string>
     <string>/usr/local/etc/telegraf.d</string>
   </array>
   <key>RunAtLoad</key>
   <true/>
</dict>
</plist>
…

然后，加载上述更改后重新启动 Telegraf ：

sudo launchctl stop telegraf
sudo launchctl unload -w /Library/LaunchDaemons/telegraf.plist
sudo launchctl load -w /Library/LaunchDaemons/telegraf.plist
sudo launchctl start telegraf

安装代理

安装 macOS 代理

在 macOS 上安装代理的步骤：

选择代理访问密钥。
从代理安装对话框复制命令块。您可以单击剪贴板图标将命令快速复制到剪贴板。
打开 Bash 窗口
将命令粘贴到 Bash 窗口中，然后按 Enter 键。
此命令将下载相应的代理安装程序并进行安装，然后设置默认配置。完成后，它将重新启动代理服务。此命令具有唯一的密钥，有效期为 24 小时。
如果您之前使用 Homebrew 安装了 Telegraf 代理，则系统将提示您将其卸载。卸载先前安装的 Telegraf 代理后，重新运行上述步骤 5 中的命令。
单击 * 完成 * 或 * 继续 *

安装代理后，您可以使用以下命令启动 / 停止此服务：

sudo launchctl start telegraf
sudo launchctl stop telegraf

卸载代理

要在 macOS 上卸载代理，请在 Bash 终端中运行以下命令：

停止 Telegraf 服务：

 sudo launchctl stop telegraf
. 卸载此电报代理：

sudo cp /Applications/telegraf.app/scripts/uninstall /tmp
sudo /tmp/uninstall

删除可能遗留的任何配置或日志文件：

sudo rm -rf /usr/local/etc/telegraf*
sudo rm -rf /usr/local/var/log/telegraf.*

升级代理

要升级电报代理，请执行以下操作：

停止电报服务：

 sudo launchctl stop telegraf
. 卸载先前的电报代理：

sudo cp /Applications/telegraf.app/scripts/uninstall /tmp
sudo /tmp/uninstall

"安装新代理"。

｛empty｝｛empty｝｛empty｝｛empty｝｛empty｝｛empty｝

Kubernetes

NetApp Kubernetes监控操作员(NKMO）是安装适用于Cloud Insights Insights的Kubernetes的首选方法、可以更灵活地配置监控、只需更少的步骤即可完成、同时还可以增加监控K8s集群中运行的其他软件的机会。

请 "* 转到此处 *" 有关NetApp Kubernetes监控操作员的信息和安装说明、请参见。

｛empty｝｛empty｝｛empty｝｛empty｝｛empty｝｛empty｝

验证校验和

Cloud Insights 代理安装程序会执行完整性检查，但某些用户可能希望在安装或应用下载的项目之前执行自己的验证。为此、可以下载安装程序并为下载的软件包生成校验和、然后将校验和与安装说明中显示的值进行比较。

下载安装程序包而不安装

要执行仅下载操作(与默认的下载和安装操作相反)、用户可以编辑从UI获取的代理安装命令并删除尾随的"install"选项。

请按照以下步骤操作：

按照说明复制 Agent 安装程序代码片段。
请将代码片段粘贴到文本编辑器中，而不是将其粘贴到命令窗口中。
从命令中删除尾随的 "-install" （ Linux/Mac ）或 "-install" （ Windows ）。
从文本编辑器复制整个命令。
现在，将其粘贴到命令窗口（在工作目录中）并运行。

非 Windows （这些示例适用于 Kubernetes ；实际脚本名称可能有所不同）：

Download and install （下载并安装）（默认）：

 installerName=cloudinsights-kubernetes.sh … && sudo -E -H ./$installerName --download –-install
* 仅下载：

installerName=cloudinsights-kubernetes.sh … && sudo -E -H ./$installerName --download

Windows

Download and install （下载并安装）（默认）：

 !$($installerName=".\cloudinsights-windows.ps1") … -and $(&$installerName -download -install)
* 仅下载：

!$($installerName=".\cloudinsights-windows.ps1") … -and $(&$installerName -download)

仅下载命令会将所有所需的项目从 Cloud Insights 下载到工作目录。这些项目包括但不限于：

安装脚本
环境文件
YAML 文件
签名校验和文件(以SHA256.signed或SHA256.ps1结尾)
用于签名验证的 PEM 文件（ netapp_cert.pem ）

安装脚本，环境文件和 YAML 文件可以通过目视检查进行验证。

可以通过确认 PEM 文件的指纹为以下内容来验证 PEM 文件：

 1A918038E8E127BB5C87A202DF173B97A05B4996
更具体地说，

非 Windows ：

 openssl x509 -fingerprint -sha1 -noout -inform pem -in netapp_cert.pem
* Windows

Import-Certificate -Filepath .\netapp_cert.pem -CertStoreLocation Cert:\CurrentUser\Root

生成校验和值

要生成校验和值、请对相应平台执行以下命令：

RHEL/Ubuntu：

 sha256sum <package_name>
* macOS：

 shasum -a 256 telegraf.pkg
* Windows

Get-FileHash telegraf.zip -Algorithm SHA256 | Format-List

使用PEM文件验证校验和

可以使用 PEM 文件验证签名校验和文件：

非 Windows ：

 openssl smime -verify -in telegraf*.sha256.signed -CAfile netapp_cert.pem -purpose any
* Windows （通过上述 Import-Certificate 安装证书后）：

Get-AuthenticodeSignature -FilePath .\telegraf.zip.sha256.ps1
$result = Get-AuthenticodeSignature -FilePath .\telegraf.zip.sha256.ps1
$signer = $result.SignerCertificate
Add-Type -Assembly System.Security
[Security.Cryptography.x509Certificates.X509Certificate2UI]::DisplayCertificate($signer)

安装下载的软件包

在对所有项目进行满意的验证后，可以通过运行以下命令启动代理安装：

非 Windows ：

 sudo -E -H ./<installation_script_name> --install
Windows

.\cloudinsights-windows.ps1 -install

故障排除

在设置代理时遇到问题时要尝试的一些操作：

问题：	请尝试以下操作：
配置新插件并重新启动Telegraf后、Telegraf无法启动。这些日志指示出现类似以下内容的错误："[caelaf] Error running agent：error loading config file /etc/caelaf/tengraf.d/cloudinsots-default.conf：plugin outputs.http：line <linenumber> ：configuration specified the fields ["use_system_proxy"]、but they were n’t used"	安装的Telegraf版本已过时。按照此页面上的步骤为您的相应平台升级代理。
我在旧安装上运行了安装程序脚本、现在代理不发送数据	卸载此电报代理、然后重新运行安装脚本。请按照此页面上适用于您的相应平台的升级代理步骤进行操作。
我已使用 Cloud Insights 安装代理	如果您已在主机 /VM 上安装了代理，则无需重新安装该代理。在这种情况下，只需在 Agent 安装屏幕中选择适当的平台和密钥，然后单击 * 继续 * 或 * 完成 * 。
我已安装代理，但未使用 Cloud Insights 安装程序安装代理	删除先前的代理并运行 Cloud Insights 代理安装，以确保正确的默认配置文件设置。完成后，单击 * 继续 * 或 * 完成 * 。

问题：

请尝试以下操作：

配置新插件并重新启动Telegraf后、Telegraf无法启动。这些日志指示出现类似以下内容的错误："[caelaf] Error running agent：error loading config file /etc/caelaf/tengraf.d/cloudinsots-default.conf：plugin outputs.http：line <linenumber> ：configuration specified the fields ["use_system_proxy"]、but they were n’t used"

安装的Telegraf版本已过时。按照此页面上的步骤*为您的相应平台升级代理*。

我在旧安装上运行了安装程序脚本、现在代理不发送数据

卸载此电报代理、然后重新运行安装脚本。请按照此页面上适用于您的相应平台的*升级代理*步骤进行操作。

我已使用 Cloud Insights 安装代理

如果您已在主机 /VM 上安装了代理，则无需重新安装该代理。在这种情况下，只需在 Agent 安装屏幕中选择适当的平台和密钥，然后单击 * 继续 * 或 * 完成 * 。

我已安装代理，但未使用 Cloud Insights 安装程序安装代理

删除先前的代理并运行 Cloud Insights 代理安装，以确保正确的默认配置文件设置。完成后，单击 * 继续 * 或 * 完成 * 。

可以从找到追加信息 "支持" 页面或中的 "数据收集器支持列表"。

Creating your file...

配置代理以收集数据（ Windows/Linux/Mac ）

安装代理

Windows

前提条件：

为 Windows 配置代理支持

安装代理

卸载代理

升级代理

RHEL 和 CentOS

前提条件：

为 RHEL/CentOS 配置代理支持

安装代理

卸载代理

升级代理

Ubuntu 和 Debian

前提条件：

为 Ubuntu 或 Debian 配置代理支持

安装代理

卸载代理

升级代理

macOS

前提条件：

为 macOS 配置代理支持

安装代理

卸载代理

升级代理

Kubernetes

验证校验和

下载安装程序包而不安装

生成校验和值

使用PEM文件验证校验和

安装下载的软件包

故障排除