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

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

贡献者 netapp-alavoie dgracenetapp netapp-mjryan
PDF

Data Infrastructure Insights用途"电讯报"作为其收集集成数据的代理。Telegraf 是一个插件驱动的服务器代理，可用于收集和报告指标、事件和日志。输入插件用于通过直接访问系统/操作系统、调用第三方 API 或监听配置的流（即 Kafka、statsD 等）将所需信息收集到代理中。输出插件用于将代理收集的指标、事件和日志发送到Data Infrastructure Insights。

有关在 Kubernetes 上安装的信息，请参阅"NetApp Kubernetes 监控操作员"页。

备注 为了准确的审计和数据报告，强烈建议使用*网络时间协议 (NTP)* 或*简单网络时间协议 (SNTP)* 同步代理机器上的时间。
备注 如果您想在安装代理之前验证安装文件，请参阅下面的部分验证 Telegraf 包校验和。

安装代理

如果您正在安装服务数据收集器但尚未配置代理，系统将提示您首先为适当的操作系统安装代理。本主题提供在以下操作系统上安装 Telegraf 代理的说明：

要安装代理，无论您使用什么平台，都必须首先执行以下操作：

  1. 登录您将用于代理的主机。

  2. 登录到您的Data Infrastructure Insights环境并导航到*可观察性>收集器*。

  3. 单击*+数据收集器*并选择要安装的数据收集器。

  4. 为您的主机选择合适的平台（Windows、Linux）

  5. 按照每个平台的剩余步骤进行操作。

备注 一旦在主机上安装了代理，就不需要在该主机上再次安装代理。
提示 一旦您在服务器/虚拟机上安装了代理，Data Infrastructure Insights除了从您配置的任何数据收集器收集指标外，还会从该系统收集指标。这些指标被收集为"“节点”指标"。
备注 如果您使用代理，请在安装 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

  • 如果您使用代理，则必须按照“配置 Windows 代理支持”部分中的说明进行操作。

配置 Windows 的代理支持

备注 如果您的环境使用代理，请在安装之前阅读本节。
备注 以下步骤概述了设置 http_proxy/https_proxy 环境变量所需的操作。对于某些代理环境，用户可能还需要设置_no_proxy 环境_变量。

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

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

安装代理

Windows 代理安装

在 Windows 上安装代理的步骤：

  1. 选择代理访问密钥。

  2. 从代理安装对话框中复制命令块。您可以单击剪贴板图标快速将命令复制到剪贴板。

  3. 打开 PowerShell 窗口

  4. 将命令粘贴到 PowerShell 窗口并按 Enter。

  5. 该命令将下载适当的代理安装程序，安装它，并设置默认配置。完成后，它将重新启动代理服务。该命令具有唯一密钥，有效期为 24 小时。

  6. 单击“完成”或“继续”

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

Start-Service telegraf
Stop-Service telegraf

卸载代理

要在 Windows 上卸载代理，请在 PowerShell 窗口中执行以下操作：

  1. 停止并删除 Telegraf 服务：

    Stop-Service telegraf
sc.exe delete telegraf

  2. 从信任机构中删除证书：

    cd Cert:\CurrentUser\Root
//rm E5FB7B68C08B1CA902708584C274F8EFC7BE8ABC
rm 1A918038E8E127BB5C87A202DF173B97A05B4996

  3. 删除 C:\Program Files\telegraf 文件夹以删除二进制文件、日志和配置文件

  4. 从注册表中删除 SYSTEM\CurrentControlSet\Services\EventLog\Application\telegraf 键

升级代理

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

  1. 停止并删除 telegraf 服务：

    Stop-Service telegraf
sc.exe delete telegraf

  2. 从注册表中删除 SYSTEM\CurrentControlSet\Services\EventLog\Application\telegraf 键

  3. 删除_C:\Program Files\telegraf\telegraf.conf_

  4. 删除_C:\Program Files\telegraf\telegraf.exe_

  5. "安装新代理" 。

RHEL 和 CentOS

先决条件：

  • 必须提供以下命令：curl、sudo、ping、sha256sum、openssl 和 dmidecode

  • 如果您使用代理，则必须按照*配置 RHEL/CentOS 的代理支持*部分中的说明进行操作。

为 RHEL/CentOS 配置代理支持

备注 如果您的环境使用代理，请在安装之前阅读本节。
备注 以下步骤概述了设置 http_proxy/https_proxy 环境变量所需的操作。对于某些代理环境，用户可能还需要设置_no_proxy 环境_变量。

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

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

     export https_proxy=<proxy_server>:<proxy_port>
. 创建 _/etc/default/telegraf_，并插入 _https_proxy_ 和/或 _http_proxy_ 变量的定义：
    https_proxy=<proxy_server>:<proxy_port>

安装代理

Rhel/CentOS 代理安装

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

  1. 选择代理访问密钥。

  2. 从代理安装对话框中复制命令块。您可以单击剪贴板图标快速将命令复制到剪贴板。

  3. 打开 Bash 窗口

  4. 将命令粘贴到 Bash 窗口并按 Enter。

  5. 该命令将下载适当的代理安装程序，安装它，并设置默认配置。完成后，它将重新启动代理服务。该命令具有唯一密钥，有效期为 24 小时。

  6. 单击“完成”或“继续”

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

如果您的操作系统使用 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 终端中执行以下操作：

  1. 停止 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)

  2. 删除 Telegraf 代理：

     yum remove telegraf
. 删除可能遗留的任何配置或日志文件：
    rm -rf /etc/telegraf*
rm -rf /var/log/telegraf*

升级代理

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

  1. 停止电报服务：

    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)

  2. 删除之前的 telegraf 代理：

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

Ubuntu 和 Debian

先决条件：

  • 必须提供以下命令：curl、sudo、ping、sha256sum、openssl 和 dmidecode

  • 如果您使用代理，则必须按照*配置 Ubuntu/Debian 的代理支持*部分中的说明进行操作。

为 Ubuntu/Debian 配置代理支持

备注 如果您的环境使用代理，请在安装之前阅读本节。
备注 以下步骤概述了设置 http_proxy/https_proxy 环境变量所需的操作。对于某些代理环境，用户可能还需要设置_no_proxy 环境_变量。

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

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

     export https_proxy=<proxy_server>:<proxy_port>
. 创建 /etc/default/telegraf，并插入 _https_proxy_ 和/或 _http_proxy_ 变量的定义：
    https_proxy=<proxy_server>:<proxy_port>

安装代理

Ubuntu/Debian 代理安装

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

  1. 选择代理访问密钥。

  2. 从代理安装对话框中复制命令块。您可以单击剪贴板图标快速将命令复制到剪贴板。

  3. 打开 Bash 窗口

  4. 将命令粘贴到 Bash 窗口并按 Enter。

  5. 该命令将下载适当的代理安装程序，安装它，并设置默认配置。完成后，它将重新启动代理服务。该命令具有唯一密钥，有效期为 24 小时。

  6. 单击“完成”或“继续”

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

如果您的操作系统使用 systemd：

sudo systemctl start telegraf
sudo systemctl stop telegraf

如果您的操作系统未使用 systemd：

sudo service telegraf start
sudo service telegraf stop

卸载代理

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

  1. 停止 Telegraf 服务：

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

  2. 删除 Telegraf 代理：

     dpkg -r telegraf
. 删除可能遗留的任何配置或日志文件：
    rm -rf /etc/telegraf*
rm -rf /var/log/telegraf*

升级代理

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

  1. 停止电报服务：

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

  2. 删除之前的 telegraf 代理：

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

验证 Telegraf 包校验和

Data Infrastructure Insights代理安装程序执行完整性检查，但某些用户可能希望在安装下载的 Telegraf 二进制文件之前执行自己的验证。这可以通过下载安装程序并为下载的包生成校验和，然后将校验和与安装说明中显示的值进行比较来完成。

下载安装包，无需安装

要执行仅下载操作（与默认的下载和安装相反），用户可以编辑从 UI 获取的代理安装命令并删除“安装”选项。

按照下面的步骤进行操作：

  1. 按照指示复制代理安装程序片段。

  2. 不要将代码片段粘贴到命令窗口中，而是将其粘贴到文本编辑器中。

  3. 从命令中删除尾随的“--install”（Linux）或“-install”（Windows）。

  4. 从文本编辑器复制整个命令。

  5. 现在将其粘贴到您的命令窗口（在工作目录中）并运行它。

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

  • 下载并安装（默认）：

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

视窗：

  • 下载并安装（默认）：

     !$($installerName=".\cloudinsights-windows.ps1") … -and $(if(((Get-FileHash $installerName).Hash).ToLower() -eq "INSTALLER_CHECKSUM ") { &$installerName -download -verify -install } else { Write-Host "Install script checksum does not match"})"
* 仅下载：
    !$($installerName=".\cloudinsights-windows.ps1") … -and $(if(((Get-FileHash $installerName).Hash).ToLower() -eq "INSTALLER_CHECKSUM ") { &$installerName -download -verify } else { Write-Host "Install script checksum does not match"})"

仅下载命令将从Data Infrastructure Insights下载所有必需的工件到工作目录。这些文物包括但不限于：

  • 安装脚本

  • 环境文件

  • Telegraf 二进制文件

  • Telegraf 二进制文件的签名

  • 用于验证二进制签名的公共证书

从 DII 下载并复制的安装代码片段会自动对安装脚本进行校验，并且安装脚本会验证 telegraf 二进制文件的签名。

验证校验和值

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

  • RHEL/Ubuntu：

     sha256sum <package_name>
* 视窗：
    Get-FileHash telegraf.zip -Algorithm SHA256 | Format-List

安装下载的软件包

一旦所有工件都得到令人满意的验证，就可以通过运行以下命令启动代理安装：

非 Windows：

 sudo -E -H ./<installation_script_name> --install
视窗：
.\cloudinsights-windows.ps1 -install

创建和使用 API 访问令牌

要为 Telegraf 数据提取创建 API 访问令牌，请执行以下操作之一：

通过数据收集器安装页面创建

  1. 导航到您想要使用的平台（Windows、Linux）的数据收集器安装页面。

  2. 使用 + API 访问令牌按钮创建令牌。

  3. 输入名称并单击保存。

  4. 现在应该在下拉菜单中选择令牌名称，并将其用于安装收集器时。

手动创建 API 访问令牌

  1. 导航至管理>API 访问。

  2. 单击 + API 访问令牌。

  3. 输入名称和可选的描述。

  4. 在“此令牌将用于调用哪种类型的 API？”下，仅选择“数据提取”，然后取消选择“采集单元”。

  5. 在“权限”下选择读/写。

  6. 取消选择“自动轮换 Kubernetes 的令牌”。

要使用新创建的 API 访问令牌，请从安装程序页面上的“选择现有 API 访问令牌或创建新的”下拉菜单中选择它。请注意，只能使用具有以下属性的令牌：

  • API 类型：仅限“数据提取”

  • 权限：读/写

  • Kubernetes 自动旋转：关闭

故障排除

如果在设置代理时遇到问题，请尝试以下操作：

问题： 尝试一下：

配置新插件并重新启动 Telegraf 后，Telegraf 无法启动。日志表明出现类似以下错误：“[telegraf] 运行代理时出错：加载配置文件 /etc/telegraf/telegraf.d/cloudinsights-default.conf 时出错：插件输出。http：行 <linenumber>：配置指定了字段 [“use_system_proxy”]，但未使用”

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

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

卸载 telegraf 代理，然后重新运行安装脚本。按照此页面上适合您平台的*升级代理*步骤进行操作。

我已经使用Data Infrastructure Insights安装了代理

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

我已经安装了代理，但没有使用Data Infrastructure Insights安装程序

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

更多信息可从"支持"页面或在"数据收集器支持矩阵"。