集中式 OpenTelemetry 收集器管理

Instana 通过使用开放代理管理协议( OpAMP ),为 OpenTelemetry 收集器提供集中管理。 直接通过 Instana 用户界面查看和管理所有收集器。

概述

集中管理让您能够在一个地方全面掌握并控制所有 OpenTelemetry 收集器。 您可通过 Instana 用户界面查看所有收集器、访问其仪表板并进行远程管理,而无需登录到各个主机。

可以执行的操作

通过集中式收集器管理,您可以:

  • 查看所有收集器及其健康状态。
  • 监控全面的内部指标和销售渠道绩效。
  • 远程查看和更新配置。
  • 在没有主机访问权限的情况下重启收集器。
  • 动态调整日志级别。
  • 查看实时日志。

先决条件

在通过 Instana 管理 OpenTelemetry 收集器之前,请确保满足以下要求:

收集器

请使用 OpenTelemetry Collector( IDOT )的 Instana 发行版,版本号为 1.305 或更高版本。 为获得最佳性能,建议使用 1.310 或更高版本。

如需升级到最新版本,请参阅 IDOT 上的文档。

Instana

要求因您的 Instana 部署类型而异:

  • Instana SaaS :集中式收集器管理默认可用且随时可用。
  • 自托管的 Instana :必须启用 OpAMP 支持,才能远程管理收集器。

为自托管的 Instana 启用 OpAMP

对于新的自托管 Instana 安装,请在设置过程中包含 OpAMP 功能标志:

./stanctl --install-type demo \
          --core-feature-flags "feature.opamp.enabled=true" \
          --sales-key $YOUR_SALES_KEY \
          --download-key $YOUR_DOWNLOAD_KEY \
          --unit-initial-admin-password $YOUR_ADMIN_PASSWORD \
  up

若您已拥有自托管的 Instana 安装环境,请执行以下代码启用 OpAMP :

stanctl backend apply --core-feature-flags 'feature.opamp.enabled=true'

访问收集器管理

要访问收集器管理:

  1. 在 Instana 用户界面的导航菜单中,点击 “代理与收集器 ”。
  2. 选择 OpenTelemetry 收集器选项卡。
  3. 查看您所在环境中的所有收集器列表。
  4. 点击收集器以打开其仪表板并进行管理。

管理功能

集中式收集器管理通过 Instana 用户界面直接提供以下功能:

查看所有收集器及其健康状态

列表视图以表格形式显示所有收集器,展示每个收集器的收集器ID、版本、日志级别和当前状态。 使用表格筛选器按名称筛选收集器。
图 1. OpenTelemetry 收藏家名单
OpenTelemetry 收藏家名单

监控内部指标和管道性能

收集器仪表板提供详细的指标和管道性能数据,以帮助理解收集器操作。
图 2. 收藏家仪表盘
收藏家仪表盘

在没有主机访问权限的情况下重启收集器

仪表板右上角的重启按钮可远程重启收集器。
图 3. 重新启动收集器
重新启动收集器

远程更新配置

点击编辑配置按钮以打开配置对话框。
图 4. 编辑收集器配置按钮
编辑收集器配置按钮
配置对话框允许查看和修改收集器配置文件。 当您更新配置时,系统会自动对其进行验证。 有效的配置将立即生效,而无效的配置则会显示错误信息并被拒绝。
图5. 配置对话框
配置对话框

动态调整日志级别

收集器选项下拉菜单中选择“更改日志级别 ”以打开日志级别对话框。
图6. 收藏家选项下拉菜单
收藏家选项下拉菜单
您可以将日志级别设置为 DEBUG, INFO, WARN, 或 ERROR
图7. 更改日志级别对话框
更改日志级别对话框

查看实时日志

您可以在收集器仪表板底部查看实时日志输出,用于排查问题并实时监控收集器活动。
图8. 实时日志
实时日志

主管要求

“管理功能”部分所述的管理功能需要启用 IDOT 管理程序。 该监视器通过 OpAMP 协议,使收集器与 Instana 后端之间能够进行通信。

没有主管:

  • 收集器及其内部指标仍可见于页面。
  • 远程管理操作(重启、查看和更新配置、更改日志级别)不可用。
  • 实时日志记录不可用。

有关启用监督程序的配置详细信息,请参阅 IDOT 文档

OpAMP 端点
  • SaaSwss://opamp-<region>-saas.instana.io:443/v1/opamp
  • 自主托管wss://opamp-acceptor.<your-instana-base-domain>:443/v1/opamp
支持的平台
  • Linux