Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

inputs (Analytics)

Syntax

Hierarchy Level

Description

Configure parameters for a Network Telemetry Framework (NTF) service agent input plug-in. For each service agent instance, you can configure more than one input plug-in to push data to the output plug-in.

Note:

When you modify the input plug-in configuration of a service agent instance, the associated service agent daemon is restarted.

Options

analytics parameters

Configure parameters to collect data from Junos Telemetry Interface (JTI) sensors.

generate-tags value

(Optional) Enable tag generation.

  • Default: Enabled

sample-frequency value

Specify the frequency interval (in seconds) at which the JTI sensor generates data to export to the data collector. Range is from 0 to 24 hours.

  • Default: 5 seconds

sensors file-path

Specify the resource string associated with the JTI sensor for collecting JTI data from a specific resource. The format is a file path and must be entered exactly. For a list of available JTI resource string options, see the sensor configuration statement and Guidelines for gRPC and gNMI Sensors (Junos Telemetry Interface) documentation.

input-ipfix parameters

Configure parameters for the IPFIX mediation service agent to gather and consolidate IPFIX records from downstream devices.

Note:

Any change you make to an existing input-ipfix plug-in configuration restarts the IPFIX service agent daemon to apply the changes.

Note:

Although each of the parameters has a default value, you must configure at least one of the parameters to enable the plug-in. If you configure only one parameter and want to use the default value, you must specify that value.

maximum-connections number

(Optional) Maximum number of TCP connections that the IPFIX mediator can support.

  • Range: 1 through 500

  • Default: 100

tcp-port port-number

(Optional) TCP port on the IPFIX mediator that receives TCP packets; the listening port.

  • Default: 4739

vrf-name name

(Optional) Name of the VRF (routing instance) in which IPFIX packets are accepted.

  • Default: default

input-jti-ipfix parameters

Configure parameters for the IPFIX mediation service agent to collect and report local sensor data from the BNG configured as an IPFIX mediator. For each group of records, the plug-in subscribes to the specific sensor data sets associated with each record.

When you remove a record group from the configuration, the sensor sets for the member records are unsubscribed. The template IDs for the associated IPFIX records are returned to the pool for re-use.

record ipfix-record-name

One of the following individual IPFIX records associated with a nonconfigurable set of local sensor data. See Telemetry Data Collection on the IPFIX Mediator for Export to an IPFIX Collector for the sensors collected by each record.

address-pool-utilization

port-statistics

chassis-inventory

resource-utilization

chassis-power

subscriber-statistics

dhcpv4-server-stats

thermal

interface-metadata

uptime

interface-queue-statistics

Best Practice:

We recommend that you configure the interface-metadata record whenever you configure the interface-queue-statistics record. The metadata information is essential for understanding details about the subscriber whose queue statistics are being collected.

record-group group-name

Name of a group of IPFIX records that subscribes to the sensor data sets associated with the individual records that comprise the record group. You can configure a maximum of 10 record groups.

reporting-interval seconds

(Optional) Interval in seconds between reports for the subscribed sensor data. The interval applies to all records (and all sensor sets) in the record group.

  • Range: 60 through 86,400 seconds

  • Default: 900 seconds

Required Privilege Level

system

Release Information

Statement introduced in Junos OS Release 18.3R1.

input-jti-ipfix option added in Junos OS Release 18.4R1 on MX Series routers.

analytics option added in Junos OS Release 18.4R1 on MX Series and PTX Series routers.