nxos_telemetry – Telemetry Monitoring Service (TMS) configuration

New in version 2.9.

Synopsis
Parameters
Notes
Examples
Return Values
Status

Synopsis

Manages Telemetry Monitoring Service (TMS) configuration

Parameters

Parameter				Choices/Defaults	Comments
config dictionary					The provided configuration
	certificate dictionary				Certificate SSL/TLS and hostname values. Value must be a dict defining values for keys (key and hostname).
		hostname string			Certificate hostname
		key string			Certificate key
	compression string			gzip	Destination profile compression method.
	destination_groups list				List of telemetry destination groups.
		destination dictionary			Group destination ipv4, port, protocol and encoding values. Value must be a dict defining values for keys (ip, port, protocol, encoding).
			encoding string	GPB JSON	Destination group encoding.
			ip string		Destination group IP address.
			port integer		Destination group port number.
			protocol string	HTTP TCP UDP gRPC	Destination group protocol.
		id integer			Destination group identifier. Value must be a int representing the destination group identifier.
	sensor_groups list				List of telemetry sensor groups.
		data_source string		NX-API DME YANG	Telemetry data source.
		id integer			Sensor group identifier. Value must be a int representing the sensor group identifier.
		path dictionary			Telemetry sensor path. Value must be a dict defining values for keys (name, depth, filter_condition, query_condition). Mandatory Keys (name) Optional Keys (depth, filter_condition, query_condition)
			depth string		Sensor group depth.
			filter_condition string		Sensor group filter condition.
			name string		Sensor group path name.
			query_condition string		Sensor group query condition.
	source_interface string				Destination profile source interface. Valid value is a str representing the source interface name.
	subscriptions list				List of telemetry subscriptions.
		destination_group integer			Associated destination group.
		id integer			Subscription identifier. Value must be a int representing the subscription identifier.
		sensor_group dictionary			Associated sensor group. Value must be a dict defining values for keys (id, sample_interval).
			id integer		Associated sensor group id.
			sample_interval integer		Associated sensor group id sample interval.
	vrf string				Destination profile vrf. Valid value is a str representing the vrf name.
state string				merged ← replaced deleted	Final configuration state

Notes

Note

Supported on N9k Version 7.0(3)I7(5) and later.

Examples

# Using deleted
# This action will delete all telemetry configuration on the device

- name: Delete Telemetry Configuration
  nxos_telemetry:
    state: deleted


# Using merged
# This action will merge telemetry configuration defined in the playbook with
# telemetry configuration that is already on the device.

- name: Merge Telemetry Configuration
  nxos_telemetry:
    config:
      certificate:
        key: /bootflash/server.key
        hostname: localhost
      compression: gzip
      source_interface: Ethernet1/1
      vrf: management
      destination_groups:
        - id: 2
          destination:
            ip: 192.168.0.2
            port: 50001
            protocol: gPRC
            encoding: GPB
        - id: 55
          destination:
            ip: 192.168.0.55
            port: 60001
            protocol: gPRC
            encoding: GPB
      sensor_groups:
        - id: 1
          data_source: NX-API
          path:
            name: '"show lldp neighbors detail"'
            depth: 0
        - id: 55
          data_source: DME
          path:
            name: 'sys/ch'
            depth: unbounded
            filter_condition: 'ne(eqptFt.operSt,"ok")'
      subscriptions:
        - id: 5
          destination_group: 55
          sensor_group:
            id: 1
            sample_interval: 1000
        - id: 6
          destination_group: 2
          sensor_group:
            id: 55
            sample_interval: 2000
    state: merged


# Using replaced
# This action will replace telemetry configuration on the device with the
# telemetry configuration defined in the playbook.

- name: Override Telemetry Configuration
  nxos_telemetry:
    config:
      certificate:
        key: /bootflash/server.key
        hostname: localhost
      compression: gzip
      source_interface: Ethernet1/1
      vrf: management
      destination_groups:
        - id: 2
          destination:
            ip: 192.168.0.2
            port: 50001
            protocol: gPRC
            encoding: GPB
      subscriptions:
        - id: 5
          destination_group: 55
    state: replaced

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key	Returned	Description
after dictionary	when changed	The configuration as structured data after module completion. Sample: The configuration returned will always be in the same format of the parameters above.
before dictionary	always	The configuration as structured data prior to module invocation. Sample: The configuration returned will always be in the same format of the parameters above.
commands list	always	The set of commands pushed to the remote device. Sample: ['command 1', 'command 2', 'command 3']

Status

This module is not guaranteed to have a backwards compatible interface. [preview]
This module is maintained by the Ansible Network Team. [network]

Red Hat Support

More information about Red Hat’s support of this module is available from this Red Hat Knowledge Base article.

Authors

Mike Wiebe (@mikewiebe)

Hint

If you notice any issues in this documentation, you can edit this document to improve it.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/nxos_telemetry_module.html