分布式追踪示例
以下部分提供 了一个示例，说明如何使用分布式追踪来加速网络中的故障排除。
此示例展示了如何配置初始遥测设置，然后为订单管理系统中的两种类型的流量启用和禁用追踪。
开始之前
在开始此示例之前，您必须具备：
- 已部署的接收器，如 Solace Open Telemetry 接收器所述
- 已配置的消息 VPN（在本示例中命名为
myVpn）
第1步：配置初始遥测设置
在此示例中，第一步是配置事件代理，以便接收器客户端可以绑定到遥测数据队列。
要配置初始遥测设置：
- 为消息 VPN 创建遥测配置文件。
solace> enable
solace# configure
solace(configure)# message-vpn myVpn
solace(configure/message-vpn)# create telemetry-profile default
solace(configure/message-vpn/telemetry-profile)# end
- 创建客户端用户名。
solace# configure
solace(configure)# create client-username telemetry-receiver message-vpn myVpn
- 将客户端用户名绑定到遥测配置文件的客户端配置文件和 ACL 配置文件对象，这样才能绑定到遥测配置文件的数据队列并进行消费。
solace(configure/client-username)# acl-profile #telemetry-default
solace(configure/client-username)# client-profile #telemetry-default
- 如果客户端用户名将使用基本认证，请分配密码，然后启用客户端用户名。
solace(configure/client-username)# password *******
solace(configure/client-username)# no shutdown
第2步：配置追踪
接下来，我们将启用追踪，并设置追踪过滤器以识别应被追踪的消息。
在此示例中，我们希望追踪两种类型的流量：
- 订单管理系统的消息，所有消息在通过事件网格时都应被追踪。通常，我们希望始终追踪这些消息。
- 一些与日志相关的消息，追踪这些消息的主要用例是用于调试（当消息未到达其目标目的地时）。我们不希望这些消息始终启用追踪，而是仅在进行调试活动时启用追踪。
要配置追踪：
- 启用追踪。这不会立即生效，因为没有启用的追踪过滤器，但它允许在创建和启用追踪过滤器时开始追踪。
solace> enable
solace# configure
solace(configure)# message-vpn myVpn
solace(configure/message-vpn)# telemetry-profile default
solace(configure/message-vpn/telemetry-profile)# trace
solace(configure/message-vpn/telemetry-profile/trace)# no shutdown
- 创建
OrderMgmtSystem追踪过滤器，追踪所有使用第一个主题级别为oms的消息，除非第四个主题级别为pii。
solace(configure/message-vpn/telemetry-profile/trace)# create filter OrderMgmtSystem
solace(configure/message-vpn/telemetry-profile/trace/filter)# create subscription oms/>
solace(configure/message-vpn/telemetry-profile/trace/filter/subscription)# exit
solace(configure/message-vpn/telemetry-profile/trace/filter)# create subscription !oms/*/*/pii/>
solace(configure/message-vpn/telemetry-profile/trace/filter/subscription)# exit
- 启用
OrderMgmtSystem追踪过滤器，以开始追踪这些消息。
solace(configure/message-vpn/telemetry-profile/trace/filter)# no shutdown
solace(configure/message-vpn/telemetry-profile/trace/filter)# exit
- 创建
LogFilter追踪过滤器，但暂时不要启用它。
solace(configure/message-vpn/telemetry-profile/trace)# create filter LogFilter
solace(configure/message-vpn/telemetry-profile/trace/filter)# create subscription log/>
solace(configure/message-vpn/telemetry-profile/trace/filter/subscription)# exit
solace(configure/message-vpn/telemetry-profile/trace/filter)# create subscription !log/*/*/pii/>
第3步：启用调试活动
在上述配置完成后，假设我们希望开始使用与日志相关的消息进行调试活动。
要开始追踪这些与日志相关的消息，请启用 LogFilter 追踪过滤器：
solace> enable
solace# configure
solace(configure)# message-vpn myVpn
solace(configure/message-vpn)# telemetry-profile default
solace(configure/message-vpn/telemetry-profile)# trace filter LogFilter
solace(configure/message-vpn/telemetry-profile/trace/filter)# no shutdown
第4步：禁用追踪
系统可能因追踪量过大而变得不堪重负，这对其他流量产生了不利影响。与其花时间选择性地启用和禁用单个追踪过滤器，我们希望现在停止追踪。
要禁用追踪，请输入以下命令：
solace> enable
solace# configure
solace(configure)# message-vpn myVpn
solace(configure/message-vpn)# telemetry-profile default
solace(configure/message-vpn/telemetry-profile)# trace shutdown