Streaming Telemetry Data Over UDP
This section describes streaming telemetry data over a UDP connection.
UDP-based telemetry streaming uses a dial-out mechanism, where the device sends telemetry data to a configured collector. The sensor paths are configured through CLI and the device sends the data for the configured sensor paths over a UDP connection to the destination address of the collector. The destination address is also configured through the CLI.
Junos Telemetry supports two formats of telemetry data for UDP streaming:
- Dial-out over UDP (Protobuf Compact Format, Juniper Proprietary)
- Dial-out over UDP (Protobuf Structured Format) jnx_gnmi_over_udp.proto file
Both formats differ in structure and decoding requirements.
Dial-out over UDP (Protobuf Compact Format, Juniper Proprietary)
The device streams telemetry data from native sensors to the collector over UDP in the protobuf format. For protobuf format information, see Protobuf Compact Message Format (Juniper Proprietary).
The collector decodes the telemetry data using using Junos-specific utilities and protocol buffers files. See, Decoding Junos Telemetry Data With UNIX Utilities.
Dial-out over UDP (Protobuf Structured Format)
The device streams telemetry data encoded in the UdpTelemetryUpdate
message from the sensors to the collector over UDP. The message format is defined in the
jnx_gnmi_over_udp.proto file. Only STREAM mode with
SAMPLE as subscription mode is supported. The message contains full key
name and value pair information so the collector does not require data models for processing
or consuming the telemetry data.
Sample message containing complete key name and value pair information:
update {
timestamp: 1730130393137318248
prefix: /interfaces/interface[name='et-1/0/13']/state/counters
update {
path {
elem {
name: in-pkts
}
}
val {
uint_val: 0
}
}
update {
path {
elem {
name: in-octets
}
}
val {
uint_val: 0
}
}
} For complete list of resource paths supported, see Junos YANG Data Model Explorer.
Configure Telemetry Data Streaming over UDP
To configure telemetry data streaming over UDP, configure a sensor profile, a streaming server profile, and an export profile, see Establish a Dial-out Telemetry Connection.