Telemetry simple configuration in Cisco XR devices

 Telemetry 是一种类似SNMP技术的feature，用于远程采集网络设备上相关信息。与SNMP不同的是，SNMP是Pull Mode，需要server端主动的要求Get某些信息，而Telemetry则是一种Push Mode，可以周期性、主动的push相关信息到server上。

如何获得相应的sensor-path

与SNMP的OID类似，sensor-path代表着你想要的获得哪些信息，在XR设备上我们可以使用如下命令去判断我们需要获得的信息是哪一类，即获得关键字；然后到yang文件夹过滤相关关键字:

1

RP/0/RSP1/CPU0:9910-B#schema-describe show segment-routing traffic-eng forwarding policy name test-policy detail

2

Fri Dec 27 01:57:38.336 UTC

3

Action: get

4

Path:   RootOper.XTC.PolicyForwarding   <<< XTC

5

​

6

RP/0/RSP1/CPU0:9910-B#run

7

Fri Dec 27 01:57:42.449 UTC

8

[xr-vm_node0_RSP1_CPU0:~]$cd /pkg/yang/

9

[xr-vm_node0_RSP1_CPU0:/pkg/yang]$ls | grep xtc      <<<cfg代表配置相关，oper与show command相关

10

Cisco-IOS-XR-infra-xtc-agent-cfg.yang

11

Cisco-IOS-XR-infra-xtc-agent-oper-sub1.yang

12

Cisco-IOS-XR-infra-xtc-agent-oper-sub2.yang

13

Cisco-IOS-XR-infra-xtc-agent-oper.yang

14

Cisco-IOS-XR-infra-xtc-cfg.yang

15

Cisco-IOS-XR-infra-xtc-oper-sub1.yang

16

Cisco-IOS-XR-infra-xtc-oper.yang

17

​

18

//有用的文件：

19

RP/0/RP0/CPU0:XTC#run

20

Tue Jan 22 06:58:56.512 UTC

21

[xr-vm_node0_RP0_CPU0:~]$cd /pkg/telemetry/mdt/protogen

22

[xr-vm_node0_RP0_CPU0:/pkg/telemetry/mdt/protogen]$ls

23

yang_to_schema.txt

XR device configuration

1

RP/0/RSP1/CPU0:9910-B#show run telemetry model-driven 

2

Fri Dec 27 00:50:44.990 UTC

3

telemetry model-driven

4

destination-group spr-telemetry

5

  address-family ipv4 10.75.49.238 port 5432

6

   encoding self-describing-gpb

7

   protocol tcp

8

  !

9

sensor-group sr-policy-forwarding

10

  sensor-path Cisco-IOS-XR-infra-xtc-agent-oper:xtc/policy-forwardings/policy-forwarding     <<< 这个路径自己定义，查看相关yang文件补全后面的路径

11

!

12

subscription test

13

  sensor-group-id sr-policy-forwarding strict-timer

14

  sensor-group-id sr-policy-forwarding sample-interval 5000

15

  destination-id spr-telemetry

16

  source-interface MgmtEth0/RSP1/CPU0/0

Use Pipeline get Telemetry info

1

[root@localhost ~]# git clone https://github.com/cisco/bigmuddy-network-telemetry-pipeline.git

2

[root@localhost ~]# cd bigmuddy-network-telemetry-pipeline/

3

[root@localhost bigmuddy-network-telemetry-pipeline]# cp pipeline.conf pipeline-stdout.conf

4

[root@localhost bigmuddy-network-telemetry-pipeline]# vi pipeline-stdout.conf

5

​

6

#

7

file = /opt/xuxing.text   <<< 定义存储的位置

8

#

9

​

10

[root@localhost bigmuddy-network-telemetry-pipeline]# ./bin/pipeline -log= -config=pipeline-stdout.conf

11

INFO[2019-12-26 21:24:58.871798] Conductor says hello, loading config          config=pipeline-stdout.conf debug=false fluentd= logfile= maxthreads=4 tag=pipeline version="v1.0.0(bigmuddy)"

12

INFO[2019-12-26 21:24:58.872676] Conductor starting up section                 name=conductor section=inspector stage="xport_output" tag=pipeline

13

INFO[2019-12-26 21:24:58.872739] Conductor starting up section                 name=conductor section=testbed stage="xport_input" tag=pipeline

14

INFO[2019-12-26 21:24:58.872756] Metamonitoring: serving pipeline metrics to prometheus  name=default resource="/metrics" server=":8989" tag=pipeline

15

INFO[2019-12-26 21:24:58.873114] TCP server starting                           listen=":5432" name=testbed tag=pipeline

16

INFO[2019-12-26 21:24:58.873113] Starting up tap                               countonly=false filename="/opt/xuxing.text" name=inspector streamSpec=&{2 <nil>} tag=pipeline

17

​

1

[root@localhost opt]# cat xuxing.text 

2

​

3

------- 2019-12-26 19:40:31.267904257 -0500 EST -------

4

Summary: GPB(common) Message [10.75.49.65:48094(9910-B)/Cisco-IOS-XR-infra-xtc-agent-oper:xtc/policy-forwardings/policy-forwarding msg len: 827]

5

{

6

    "Source": "10.75.49.65:48094",

7

    "Telemetry": {

8

        "node_id_str": "9910-B",

9

        "subscription_id_str": "test",

10

        "encoding_path": "Cisco-IOS-XR-infra-xtc-agent-oper:xtc/policy-forwardings/policy-forwarding",

11

        "collection_id": 56265,

12

        "collection_start_time": 1577406835874,

13

        "msg_timestamp": 1577406835874,

14

        "collection_end_time": 1577406835886

15

    },

16

    "Rows": [

17

        {

18

            "Timestamp": 1577406835885,

19

            "Keys": {

20

                "name": "srte_c_888_ep_10.1.3.3"

21

            },

22

            "Content": {

23

                "are-stats-valid": "true",

24

                "binding-sid": {

25

                    "label": 24005,

26

                    "sid-type": "mpls"

27

                },

28

                "candidate-path-name": "test",

29

                "color": 888,

30

                "endpoint-address": {

31

                    "af-name": "ipv4",

32

                    "ipv4": "10.1.3.3"

33

                },

34

                "forwarding-stats-bytes": 140,

35

                "forwarding-stats-pkts": 5,

36

                "is-local-label-valid": "true",

37

                "local-label": 24004,

38

                "paths": {

39

                    "are-stats-valid": "true",

40

                    "bkup-path-id": 0,

41

                    "forwarding-stats-bytes": 140,

42

                    "forwarding-stats-pkts": 5,

43

                    "is-protected": "false",

44

                    "is-pure-bkup": "false",

45

                    "label-stack": 16003,

46

                    "load-metric": 64,

47

                    "next-hop-ipv4": "10.1.12.1",

48

                    "next-hop-table-id": 3758096384,

49

                    "outgoing-interface": "HundredGigE0/0/0/0",

50

                    "path-id": 1,

51

                    "segment-list-name": "test"

52

                },

53

                "policy-name": "srte_c_888_ep_10.1.3.3"

54

            }

55

        }

56

    ]

57

}

58

​

1

RP/0/RSP1/CPU0:9910-B#show segment-routing traffic-eng forwarding policy      

2

Fri Dec 27 00:53:24.082 UTC

3

​

4

SR-TE Policy Forwarding database

5

--------------------------------

6

​

7

Color: 888, End-point: 10.1.3.3

8

  Name: srte_c_888_ep_10.1.3.3

9

  Candidate path name: test

10

  Binding SID: 24005

11

  Segment Lists:

12

    SL[0]:

13

      Name: test

14

      Paths:

15

        Path[0]:

16

          Outgoing Label: 16003

17

          Outgoing Interface: HundredGigE0/0/0/0

18

          Next Hop: 10.1.12.1

19

          Switched Packets/Bytes: 5/140

20

          FRR Pure Backup: No

21

  Policy Packets/Bytes Switched: 5/140

22

​

Some command

1

show telemetry model-driven sensor-group

2

show telemetry model-driven destination

3

show telemetry model-driven subscription

4

​

5

For a specific sensor-group, destination-group, or subscription.

6

show telemetry model-driven sensor-group <sensor-group-nme> internal

7

show telemetry model-driven destination <destination-name>

8

show telemetry model-driven subscription <subscription-name> internal

9

10

For traces or showtech.

11

show telemetry model-driven trace all (included in show tech telemetry)

12

show tech-support telemetry model-driven 

13

14

For gRPC.

15

show grpc status

16

show grpc trace all (included in show tech telemetry) 

17

show tech-support grpc

18

Some sensor path

BGP	Cisco-IOS-XR-ipv4-bgp-oper:bgp/bpm-instances-table/bpm-instances Cisco-IOS-XR-ipv4-bgp-oper:bgp/instances/instance/instance-active/default-vrf/process-info Cisco-IOS-XR-ipv4-bgp-oper:bgp/instances/instance/instance-active/default-vrf/neighbors/neighbor/message-statistics Cisco-IOS-XR-ip-rib-ipv4-oper:rib/vrfs/vrf/afs/af/safs/saf/ip-rib-route-table-names/ip-rib-route-table-name/protocol/bgp/as/information
Qos	Cisco-IOS-XR-qos-ma-oper:qos/nodes/node/policy-map/interface-table/interface/input Cisco-IOS-XR-qos-ma-oper:qos/nodes/node/policy-map/interface-table/interface/output
CPU	Cisco-IOS-XR-wdsysmon-fd-oper:system-monitoring/cpu-utilization
Memory	Cisco-IOS-XR-nto-misc-oper:memory-summary/nodes/node/summary
SLA	Cisco-IOS-XR-man-ipsla-oper:ipsla/operation-data/operations/operation/statistics/latest/target/specific-stats/icmp-path-jitter-stats Cisco-IOS-XR-man-ipsla-oper:ipsla/operation-data/operations/operation/statistics/latest/hops/hop/specific-stats/icmp-path-jitter-stats
ISIS	Cisco-IOS-XR-clns-isis-oper:isis/instances/instance/statistics-global Cisco-IOS-XR-clns-isis-oper:isis/instances/instance/levels/level/adjacencies/adjacency Cisco-IOS-XR-ip-rib-ipv4-oper:rib/vrfs/vrf/afs/af/safs/saf/ip-rib-route-table-names/ip-rib-route-table-name/protocol/isis/as/information Cisco-IOS-XR-ip-rib-ipv6-oper:ipv6-rib/vrfs/vrf/afs/af/safs/saf/ip-rib-route-table-names/ip-rib-route-table-name/protocol/isis/as/information
IPv4/IPv6 Interface counter	Cisco-IOS-XR-infra-statsd-oper:infra-statistics/interfaces/interface/latest/protocols/protocol
Optical	Cisco-IOS-XR-controller-optics-oper:optics-oper/optics-ports/optics-port/optics-info
Env	Cisco-IOS-XR-sysadmin-envmon-ui:environment/oper/
Uptime	Cisco-IOS-XR-shellutil-oper:system-time/uptime
interface	Cisco-IOS-XR-pfi-im-cmd-oper:interfaces/interface-summary Cisco-IOS-XR-infra-statsd-oper:infra-statistics/interfaces/interface/latest/generic-counters
NCS55xx_NPU	Cisco-IOS-XR-platforms-ofa-oper:ofa/stats/nodes/node/Cisco-IOS-XR-NCS-BDplatforms-npu-resources-oper:hw-resources-datas Cisco-IOS-XR-platforms-ofa-oper:ofa/stats/nodes/node/Cisco-IOS-XR-NCS-BDplatforms-npu-resources-oper:stats-resources-datas
interface-date-rate	Cisco-IOS-XR-infra-statsd-oper:infra-statistics/interfaces/interface/latest/data-rate

           

The Blog from Xuxing's Blog;

Link: http://imxing.cn/?p=458