Feat(eos_cli_config_gen): Add support for Postcard telemetry

ansible_collections/arista/avd/molecule/eos_cli_config_gen/documentation/devices/monitor-telemetry-postcard.md

@@ -0,0 +1,34 @@
+# monitor-telemetry-postcard
+
+## Table of Contents
+
+- [Management](#management)
+  - [Management Interfaces](#management-interfaces)
+
+## Management
+
+### Management Interfaces
+
+#### Management Interfaces Summary
+
+##### IPv4
+
+| Management Interface | Description | Type | VRF | IP Address | Gateway |
+| -------------------- | ----------- | ---- | --- | ---------- | ------- |
+| Management1 | oob_management | oob | MGMT | 10.73.255.122/24 | 10.73.255.2 |
+
+##### IPv6
+
+| Management Interface | Description | Type | VRF | IPv6 Address | IPv6 Gateway |
+| -------------------- | ----------- | ---- | --- | ------------ | ------------ |
+| Management1 | oob_management | oob | MGMT | - | - |
+
+#### Management Interfaces Device Configuration
+
+```eos
+!
+interface Management1
+   description oob_management
+   vrf MGMT
+   ip address 10.73.255.122/24
+```

ansible_collections/arista/avd/molecule/eos_cli_config_gen/intended/configs/monitor-telemetry-postcard.cfg

@@ -0,0 +1,49 @@
+!RANCID-CONTENT-TYPE: arista
+!
+transceiver qsfp default-mode 4x10G
+!
+hostname monitor-telemetry-postcard
+!
+no enable password
+no aaa root
+!
+interface Management1
+   description oob_management
+   vrf MGMT
+   ip address 10.73.255.122/24
+!
+monitor telemetry postcard policy
+   no disabled
+   ingress collection gre source 10.3.3.3 destination 10.3.3.4 version 2
+   ingress sample rate 16384
+   ingress sample tcp-udp-checksum 2343223
+   profile profile1
+      ingress sample policy ingresspo1
+   profile profile2
+      ingress sample policy ingresspo1
+   sample policy samplepo1
+      match rule rule1 ipv4
+         destination prefix 10.3.3.0/24
+         source prefix 3.4.5.0/24
+         protocol tcp destination port www
+         protocol tcp destination port 78-80
+         protocol tcp destination port 77
+      match rule rule2 ipv6
+         destination prefix 10.3.4.0/24
+         source prefix 3.4.4.0/24
+         protocol udp destination port ssh
+         protocol udp destination port 748-800
+         protocol udp destination port 747
+   sample policy samplepo2
+      match rule rule1 ipv4
+         destination prefix 10.3.3.0/24
+         source prefix 3.4.5.0/24
+         protocol udp source port www
+         protocol udp source port 78-80
+         protocol udp source port 77
+   sample policy samplepo3
+      match ipv4-all-default ipv4
+      !
+      match ipv6-all-default ipv6
+!
+end

ansible_collections/arista/avd/molecule/eos_cli_config_gen/inventory/host_vars/monitor-telemetry-postcard.yml

@@ -0,0 +1,48 @@
+monitor_telemetry_postcard:
+  disabled: false
+  ingress:
+    collection:
+      source: 10.3.3.3
+      destination: 10.3.3.4
+      version: 2
+    sample:
+      rate: 16384
+      tcp_udp_checksum: 2343223
+  profiles:
+    - name: profile1
+      ingress_sample_policy: ingresspo1
+    - name: profile2
+      ingress_sample_policy: ingresspo1
+  sample_policies:
+    - name: samplepo1
+      match_rules:
+        - rule_name: rule1
+          type: ipv4
+          destination_prefix: 10.3.3.0/24
+          source_prefix: 3.4.5.0/24
+          protocol_type: tcp
+          destination_port:
+            - '77'
+            - 78-80
+            - www
+        - rule_name: rule2
+          type: ipv6
+          destination_prefix: 10.3.4.0/24
+          source_prefix: 3.4.4.0/24
+          protocol_type: udp
+          destination_port:
+            - '747'
+            - 748-800
+            - ssh
+    - name: samplepo2
+      match_rules:
+        - rule_name: rule1
+          type: ipv4
+          destination_prefix: 10.3.3.0/24
+          source_prefix: 3.4.5.0/24
+          protocol_type: udp
+          source_port:
+            - '77'
+            - 78-80
+            - www
+    - name: samplepo3

ansible_collections/arista/avd/molecule/eos_cli_config_gen/inventory/hosts.ini

@@ -91,6 +91,7 @@ mlag-configuration
 monitor-layer1
 monitor-connectivity
 monitor-sessions
+monitor-telemetry-postcard
 mpls
 none_configuration
 ntp

ansible_collections/arista/avd/roles/eos_cli_config_gen/docs/tables/monitor-telemetry-postcard.md

@@ -0,0 +1,104 @@
+<!--
+  ~ Copyright (c) 2024 Arista Networks, Inc.
+  ~ Use of this source code is governed by the Apache License 2.0
+  ~ that can be found in the LICENSE file.
+  -->
+=== "Table"
+
+    | Variable | Type | Required | Default | Value Restrictions | Description |
+    | -------- | ---- | -------- | ------- | ------------------ | ----------- |
+    | [<samp>monitor_telemetry_postcard</samp>](## "monitor_telemetry_postcard") | Dictionary |  |  |  |  |
+    | [<samp>&nbsp;&nbsp;disabled</samp>](## "monitor_telemetry_postcard.disabled") | Boolean |  |  |  | Enable or disable the postcard telemetry feature. |
+    | [<samp>&nbsp;&nbsp;ingress</samp>](## "monitor_telemetry_postcard.ingress") | Dictionary |  |  |  |  |
+    | [<samp>&nbsp;&nbsp;&nbsp;&nbsp;collection</samp>](## "monitor_telemetry_postcard.ingress.collection") | Dictionary |  |  |  | Collector configuration. |
+    | [<samp>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;source</samp>](## "monitor_telemetry_postcard.ingress.collection.source") | String |  |  |  | Configure source IP address of GRE tunnel. |
+    | [<samp>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;destination</samp>](## "monitor_telemetry_postcard.ingress.collection.destination") | String |  |  |  | Configure destination IP address of GRE tunnel. |
+    | [<samp>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;version</samp>](## "monitor_telemetry_postcard.ingress.collection.version") | Integer |  |  | Valid Values:<br>- <code>1</code><br>- <code>2</code> | Postcard version |
+    | [<samp>&nbsp;&nbsp;&nbsp;&nbsp;sample</samp>](## "monitor_telemetry_postcard.ingress.sample") | Dictionary |  |  |  | Configure sampling parameters. |
+    | [<samp>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;rate</samp>](## "monitor_telemetry_postcard.ingress.sample.rate") | Integer |  |  | Valid Values:<br>- <code>16384</code><br>- <code>32768</code><br>- <code>65536</code> | Configure sampling rate. |
+    | [<samp>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;tcp_udp_checksum</samp>](## "monitor_telemetry_postcard.ingress.sample.tcp_udp_checksum") | Integer |  |  |  | Configure TCP/UDP checksum or IP ID checksum. |
+    | [<samp>&nbsp;&nbsp;profiles</samp>](## "monitor_telemetry_postcard.profiles") | List, items: Dictionary |  |  |  | Configure the postcard telemetry profile. |
+    | [<samp>&nbsp;&nbsp;&nbsp;&nbsp;-&nbsp;name</samp>](## "monitor_telemetry_postcard.profiles.[].name") | String | Required, Unique |  |  | Profile name |
+    | [<samp>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ingress_sample_policy</samp>](## "monitor_telemetry_postcard.profiles.[].ingress_sample_policy") | String |  |  |  | Configure ingress sample policy for the profile. |
+    | [<samp>&nbsp;&nbsp;sample_policies</samp>](## "monitor_telemetry_postcard.sample_policies") | List, items: Dictionary |  |  |  | Configure sample policies. |
+    | [<samp>&nbsp;&nbsp;&nbsp;&nbsp;-&nbsp;name</samp>](## "monitor_telemetry_postcard.sample_policies.[].name") | String | Required, Unique |  |  | Configure sample policy name. |
+    | [<samp>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;match_rules</samp>](## "monitor_telemetry_postcard.sample_policies.[].match_rules") | List, items: Dictionary |  |  |  | Configure rules for sample policy. |
+    | [<samp>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;-&nbsp;rule_name</samp>](## "monitor_telemetry_postcard.sample_policies.[].match_rules.[].rule_name") | String | Required, Unique |  |  |  |
+    | [<samp>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;type</samp>](## "monitor_telemetry_postcard.sample_policies.[].match_rules.[].type") | String |  |  | Valid Values:<br>- <code>ipv4</code><br>- <code>ipv6</code> | Select the IP address version. |
+    | [<samp>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;destination_prefix</samp>](## "monitor_telemetry_postcard.sample_policies.[].match_rules.[].destination_prefix") | String |  |  |  | IPv4 Network/Mask or IPv6 Network/Mask. |
+    | [<samp>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;source_prefix</samp>](## "monitor_telemetry_postcard.sample_policies.[].match_rules.[].source_prefix") | String |  |  |  | IPv4 Network/Mask or IPv6 Network/Mask. |
+    | [<samp>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;protocol_type</samp>](## "monitor_telemetry_postcard.sample_policies.[].match_rules.[].protocol_type") | String |  |  | Valid Values:<br>- <code>tcp</code><br>- <code>udp</code> | Select TCP/UDP. |
+    | [<samp>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;destination_port</samp>](## "monitor_telemetry_postcard.sample_policies.[].match_rules.[].destination_port") | List |  |  |  | Enter the port name or range or  port numbers in a list.<br>Example:<br>  ["12","14-20", "www"] |
+    | [<samp>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;source_port</samp>](## "monitor_telemetry_postcard.sample_policies.[].match_rules.[].source_port") | List |  |  |  | Enter the port name or range or  port numbers in a list.<br>Example:<br>  ["12","14-20", "www"] |
+
+=== "YAML"
+
+    ```yaml
+    monitor_telemetry_postcard:
+
+      # Enable or disable the postcard telemetry feature.
+      disabled: <bool>
+      ingress:
+
+        # Collector configuration.
+        collection:
+
+          # Configure source IP address of GRE tunnel.
+          source: <str>
+
+          # Configure destination IP address of GRE tunnel.
+          destination: <str>
+
+          # Postcard version
+          version: <int; 1 | 2>
+
+        # Configure sampling parameters.
+        sample:
+
+          # Configure sampling rate.
+          rate: <int; 16384 | 32768 | 65536>
+
+          # Configure TCP/UDP checksum or IP ID checksum.
+          tcp_udp_checksum: <int>
+
+      # Configure the postcard telemetry profile.
+      profiles:
+
+          # Profile name
+        - name: <str; required; unique>
+
+          # Configure ingress sample policy for the profile.
+          ingress_sample_policy: <str>
+
+      # Configure sample policies.
+      sample_policies:
+
+          # Configure sample policy name.
+        - name: <str; required; unique>
+
+          # Configure rules for sample policy.
+          match_rules:
+            - rule_name: <str; required; unique>
+
+              # Select the IP address version.
+              type: <str; "ipv4" | "ipv6">
+
+              # IPv4 Network/Mask or IPv6 Network/Mask.
+              destination_prefix: <str>
+
+              # IPv4 Network/Mask or IPv6 Network/Mask.
+              source_prefix: <str>
+
+              # Select TCP/UDP.
+              protocol_type: <str; "tcp" | "udp">
+
+              # Enter the port name or range or  port numbers in a list.
+              # Example:
+              #   ["12","14-20", "www"]
+              destination_port: <list>
+
+              # Enter the port name or range or  port numbers in a list.
+              # Example:
+              #   ["12","14-20", "www"]
+              source_port: <list>
+    ```