Dell EMC SmartFabric OS10 User Guide Release 10.5.0

Configure telemetry

Configuration notes

• The telemetry agent collects data from OS10 applications and switch hardware. When you configure a sampling rate of 0, which is near real-time, telemetry collects data as soon as an event occurs. If you configure a sampling rate, telemetry performs periodic data collection. The recommended minimum sampling intervals are described in Configure a sensor group.
• OS10 telemetry supports:
  • Only one configured destination group, and only one destination address in the group.
  • Only one subscription profile.

Enable telemetry

1. Enter telemetry mode from CONFIGURATION mode.

   OS10(config)# telemetry

2. Enable streaming telemetry in TELEMETRY mode.

   OS10(conf-telemetry)# enable

Configure a sensor group

A sensor group defines the data that is collected and streamed to a destination. Use any of the pre-configured sensor groups to monitor system resources. To display the sensor paths for each group, use the show telemetry sensor-group command.

Configure a destination group

A destination group defines the destination servers to which streaming telemetry data is sent.

1. Enter the destination group name in TELEMETRY mode. A maximum of 32 characters.

   OS10(conf-telemetry)# destination-group group-name

2. Enter the IPv4 or IPv6 address and transport-service port number in DESTINATION-GROUP mode. Only one destination is supported in the 10.4.3.0 release. You can enter a fully qualified domain name (FQDN) for ip-address. The destination domain name resolves to an IP address — see System domain name and list.

   OS10(conf-telemetry-dg-dest)# destination ip-address port-number

3. Return to TELEMETRY mode.

   OS10(conf-telemetry-dg-dest)# exit

Configure a subscription profile

A subscription profile associates destination groups and sensor groups, and specifies the data encoding format and transport protocol.

1. Enter the subscription profile name in TELEMETRY mode. A maximum of 32 characters.

   OS10(conf-telemetry)# subscription-profile profile-name

2. Enter the name of a pre-configured sensor group and sampling interval in SUBSCRIPTION-PROFILE mode. Valid sensor-group names are: bgp, bgp-peer, buffer, device, environment, interface, lag, and system. To view the data contents of a pre-configured sensor group, use the show telemetry sensor-group command. The interface sensor group supports only physical and port-channel interfaces.

   The sampling interval is in milliseconds, from 0 (whenever an event occurs; near real-time) to 4294967295. The default is 15000. Repeat this step to add sensor groups to the subscription profile.

   OS10(conf-telemetry-sp-subscription)# sensor-group group-name sampling-interval

3. Enter the name of a destination group in SUBSCRIPTION-PROFILE mode. Telemetry data is sent to the IP address and port specified in the destination group. Repeat this step to add destination groups to the subscription profile.

   OS10(conf-telemetry-sp-subscription)# destination-group name

4. Enter the source interface in SUBSCRIPTION-PROFILE mode. The system uses the source interface to derive the VRF instance and IP address used to communicate with destination devices. For gRPC transport, source interface configuration is optional.

   OS10(conf-telemetry-sp-subscription)# source-interface interface 

   Where interface is one of the following values:
   • ethernet node/slot/port[:subport] — Enter a physical Ethernet interface.
   • loopback number — Enter a Loopback interface, from 0 to 16383.
   • management 1/1/1 — Enter the management interface.
   • port-channel channel-id — Enter a port-channel ID, from 1 to 28.
   • vlan vlan-id — Enter a VLAN ID, from 1 to 4093.
5. Configure the gpb encoding format in which data is streamed in SUBSCRIPTION-PROFILE mode.

   OS10(conf-telemetry-sp-subscription)# encoding format

6. Configure the gRPC transport protocol used to stream data to a destination in SUBSCRIPTION-PROFILE mode. gRPC with Transport Security Layer (TLS) certificates enabled is the default transport protocol. To disable TLS certificate exchange, use the transport grpc no-tls command.

   OS10(conf-telemetry-sp-subscription)# transport protocol [no-tls]

   After you configure a subscription profile, the telemetry agent starts collecting data and streaming it to destination devices.