nxos_telemetry – Telemetry Monitoring Service (TMS) configuration — Ansible Documentation

- AnsibleFest
- Products
- Community
- Webinars & Training
- Blog

Documentation

# 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 | Choices: 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 | Choices: GPB JSON | Destination group encoding.
|  |  | ip string |  | Destination group IP address.
|  |  | port integer |  | Destination group port number.
|  |  | protocol string | Choices: 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 | Choices: 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 | Choices: 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.