Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

export-profile (Junos Telemetry Interface)

Syntax

Hierarchy Level

Description

Configure the parameters of the export process for data generated through Junos Telemetry sensors. You can create one or more export profiles. Each profile can be associated with one or more sensors that define the system resource to monitor and stream data. You can associate only one export profile with a specific sensor configuration.

The IP layer delivers the exported data to the remote server. The export profile configuration allows you to specify the rate which the system generates data, the local source port and IP address that are used to define the transport headers in the exported packets, and the type of dial-out connection.

To enable Junos Telemetry , you must also configure a sensor that defines the parameters of the system resource to monitor and stream data, and a server to collect the data. To configure a sensor, include the sensor sensor-name statement at the [edit services analytics] hierarchy level. To configure the server that functions as a data collector, include streaming-server server-name statement at the [edit services analytics] hierarchy level.

Note:

Junos Telemetry Interface was introduced in Junos OS Release 15.1F3 on MX Series routers with interfaces configured on MPC1 through MPC6E and on PTX Series routers with interfaces configured on FPC3. Starting in Junos OS Release 15.1F5, Junos Telemetry Interface is also supported on MPC7E, MPC8E, and MPC9E on MX Series routers.

Starting with Junos OS Release 16.1R3, FPC1 and FPC2 on PTX Series routers are also supported.

Starting with Junos OS Release 17.2R1, QFX10000 switches and PTX1000 routers are also supported.

Options

name

Name of export profile.

Note:

To associate this export profile with a configured sensor, include the name you configure for the export-profile statement at the [edit services analytics sensor sensor-name export-name] hierarchy level.

dscp value

Specify the DSCP value for the exported packets.

  • Range: 0 through 63.

  • Default: 0

    Note:

    Any interface-level DSCP rewrite rules you have configured override the DSCP value you specify for the export profile. You need to specify a DSCP value for the export profile only if you do not configure DSCP rewrite rules on the outgoing interface. For more information, see Configuring Rewrite Rules.

forwarding-class (assured-forwarding | best-effort | expedited-forwarding | network-control)

(Packet Forwarding Engine sensors only) Specify the forwarding class for exported packets.

  • Default: best-effort

loss-priority (high | low | medium-high | medium-low) (MX Series only)

Specify the loss priority for exported packets. Loss priority settings help determine which packets are dropped from the network during periods of congestion.

local-address ip-address

Specify the source address of exported packets.

local-port number

Specify the source port for the exported packets.

payload-size bytes (Optional)

Specify the maximum size of exported packets.

Note:

The payload-size option is supported only on the following sensors:

  • /junos/system/linecard/interface/

  • /junos/system/linecard/interface/logical/usage/

  • /junos/system/linecard/firewall/

  • Default: 5000 bytes.

  • Range: For the QFX5100 line of switches, 3000 through 9192 bytes. For Packet Forwarding Engine-related statistics (logical and physical interface and firewall statistics) on all platforms, 2000 through 9192. This is a platform limitation. For all other supported platforms, 1400 through 9192 bytes.

    Note:

    Junos Telemetry Interface does not export packets larger than 9192 bytes.

reporting-rate seconds

Specifies the interval, in seconds, at which the Junos Telemetry Interface (JTI) sensor exports data to the collector.

  • At the end of each configured interval, the sensor gathers the most recent sample and forwards it to the designated data collection server.

  • Valid range: For releases prior to 23.4 R2, 1 to 86400 seconds (24 hours).

Note:

Starting with Junos OS and Junos Evolved 23.4R2, the minimum supported value for reporting-rate is "2" seconds for Packet Forwarding Engine (PFE) sensors. If a configuration specifies a value below "2" seconds and a software upgrade is performed, the configuration will be dropped, and telemetry will not be operational until the value is corrected.

dialout-type (native-udp-gpb | native-udp-compact | native-grpc-gpb) Specify the type of dial-out connection.
  • native-udp-gpb: Select this option for dial-out over UDP (Protobuf Structured Format) connections. The message format is protobuf messages with structured self-describing key-value pairs and the transport protocol is UDP.

  • native-udp-compact: Select this option for dial-out over UDP (Protobuf Compact Format, Juniper Proprietary) connections. The message format is .gpb and the transport protocol is UDP.

  • native-grpc-gpb: Select this option for dial-out over TCP (Protobuf Structured Format) connections. The message format is gpb-gnmi (protobuf messages in structured universal key/value format) and the transport protocol is TCP.

Note: The format and transport options are deprecated.
routing-instance rounting-instance-name Specify the routing instance to be used for grpc transport.

The routing-instance configuration is for grpc dialout connections only. Configuring routing-instance is not mandatory. If it is not configured, the default routing instance is applied. If you specify a routing-instance which is not configured, commit fails and an error message is displayed. If routing-instance configuration is specified for UDP transport protocol, commit fails and an error message is displayed.

Required Privilege Level

interface—To view this statement in the configuration.

interface-control—To add this statement to the configuration.

Release Information

Statement introduced in Junos OS Release 15.1F3.

payload-size bytes option introduced in Junos OS Release 16.1R3.

loss-priority option introduced in Junos OS Release 17.3R1 for MX Series routers only.

Statement introduced in Junos OS Release 17.4R1 for virtual MX Series (vMX) routers.

dialout-type option introduced in Junos OS Release 25.4R1.

Options deprecated in Junos OS Release 25.4R1 are format and transport.