Geavanceerde gRPC-workflow configureren met Telegraaf, InfluxDB en Grafana op Catalyst 9800

Inleiding

In dit document wordt beschreven hoe u de stapel Telegraaf, InfluxDB en Grafana (TIG) kunt implementeren en verbinden met de Catalyst 9800.

Voorwaarden

Dit document demonstreert de programmatische interfaces van Catalyst 9800 door middel van een complexe integratie. Dit document is bedoeld om te laten zien hoe deze volledig aanpasbaar kunnen zijn op basis van elke behoefte en dagelijkse tijdbesparend kunnen zijn. De implementatie die hier wordt getoond, is gebaseerd op gRPC en biedt telemetrieconfiguratie om draadloze gegevens van de Catalyst 9800 beschikbaar te maken in elke Telegraaf-, InfluxDB-, Grafana (TIG)-observatiestack.

Vereisten

Cisco raadt kennis van de volgende onderwerpen aan:

• Configuratiemodel Catalyst Wireless 9800. 
• Netwerkprogrammeerbaarheid en datamodellen.
• TIG stack basics.
• 9800 WLC met Cisco IOS-XE 17.6 of een nieuwere versie.

Gebruikte componenten

De informatie in dit document is gebaseerd op de volgende software- en hardware-versies:

• Katalysator 9800-CL (v. 17.12.03).
• Ubuntu (v. 22.04.03).
• InfluxDB (v. 1.06.07).
• Telegraaf (v. 1.21.04).
• Grafana (v. 10.02.01).

De informatie in dit document is gebaseerd op de apparaten in een specifieke laboratoriumomgeving. Alle apparaten die in dit document worden beschreven, hadden een opgeschoonde (standaard)configuratie. Als uw netwerk live is, moet u zorgen dat u de potentiële impact van elke opdracht begrijpt.

Configureren

Netwerkdiagram

Configuraties

In dit voorbeeld is telemetrie geconfigureerd op een 9800-CL met behulp van gRPC-dial-out om informatie op een Telegraaf-toepassing op te slaan die ze opslaat in een InfluxDB-database. Hierbij werden twee apparaten gebruikt,

• Een Ubuntu-server die de hele TIG-stack host.
• Een katalysator 9800-CL.

Deze configuratiehandleiding is niet gericht op de volledige implementatie van deze apparaten, maar op de configuraties die voor elke toepassing vereist zijn om de 9800-informatie correct te verzenden, ontvangen en presenteren.

Stap 1. Maak de database klaar

Voordat u naar het configuratiegedeelte gaat, moet u ervoor zorgen dat uw Influx-instantie correct wordt uitgevoerd. Dit kan eenvoudig worden gedaan met behulp van de systemctl status opdracht, als u een Linux-distributie gebruikt.

admin@tig:~$ systemctl status influxd
● influxdb.service - InfluxDB is an open-source, distributed, time series database
     Loaded: loaded (/lib/systemd/system/influxdb.service; enabled; vendor preset: enabled)
     Active: active (running) since Wed 2023-06-14 13:06:18 UTC; 2 weeks 5 days ago
       Docs: https://docs.influxdata.com/influxdb/
   Main PID: 733 (influxd)
      Tasks: 15 (limit: 19180)
     Memory: 4.2G
        CPU: 1h 28min 47.366s
     CGroup: /system.slice/influxdb.service
             └─733 /usr/bin/influxd -config /etc/influxdb/influxdb.conf

Om het voorbeeld te laten werken, heeft Telegraaf een database nodig om de statistieken op te slaan, evenals een gebruiker om verbinding te maken met deze. Deze kunnen eenvoudig worden gemaakt vanuit de InfluxDB CLI met behulp van de volgende opdrachten:

admin@tig:~$ influx
Connected to http://localhost:8086 version 1.8.10
InfluxDB shell version: 1.8.10
> create database TELEGRAF
> create user telegraf with password 'YOUR_PASSWORD'

De database die nu is gemaakt, Telegraaf kan worden geconfigureerd om statistieken op de juiste manier op te slaan.

Stap 2. Telegraaf voorbereiden

Slechts twee Telegraaf-configuraties zijn interessant voor dit voorbeeld om te werken. Deze kunnen worden gemaakt (zoals gebruikelijk voor toepassingen die op Unix worden uitgevoerd) vanuit het /etc/telegraf/telegraf.conf configuratiebestand.

De eerste declareert de output die door Telegraaf wordt gebruikt. Zoals eerder vermeld, wordt InfluxDB hier gebruikt en is als volgt geconfigureerd in het uitvoergedeelte van het telegraf.conf bestand:

###############################################################################
#                            OUTPUT PLUGINS                                   #
###############################################################################
# Output Plugin InfluxDB
[[outputs.influxdb]]
## The full HTTP or UDP URL for your InfluxDB instance.
#   ##
#   ## Multiple URLs can be specified for a single cluster, only ONE of the
#   ## urls will be written to each interval.
  urls = [ "http://127.0.0.1:8086" ]
#   ## The target database for metrics; will be created as needed.
#   ## For UDP url endpoint database needs to be configured on server side.
  database = "TELEGRAF"
#   ## HTTP Basic Auth
  username = "telegraf"
  password = "YOUR_PASSWORD"

Dit instrueert het Telegraaf-proces om de gegevens die het ontvangt op te slaan in de InfluxDB die op dezelfde host op poort 8086 draait en om de database genaamd "TELEGRAF" te gebruiken (evenals de inloggegevens telegraf / YOUR_PASSWORD om toegang te krijgen).

Als het eerste wat wordt gedeclareerd het uitvoerformaat is, is het tweede natuurlijk het invoerformaat. Om Telegraaf te informeren dat de gegevens die het ontvangt afkomstig zijn van een Cisco-apparaat met behulp van telemetrie, kunt u de invoermodule "cisco_telemetry_mdt" gebruiken. Om dit te configureren, hoeft u alleen deze regels toe te voegen aan het /etc/telegraf/telegraf.conf bestand:

###############################################################################
#                             INPUT PLUGINS                                   #
###############################################################################
# # Cisco model-driven telemetry (MDT) input plugin for IOS XR, IOS XE and NX-OS platforms
[[inputs.cisco_telemetry_mdt]]
#  ## Telemetry transport can be "tcp" or "grpc".  TLS is only supported when
#  ## using the grpc transport.
    transport = "grpc"
#
#  ## Address and port to host telemetry listener
    service_address = ":57000"
#  ## Define aliases to map telemetry encoding paths to simple measurement names
[inputs.cisco_telemetry_mdt.aliases]
    ifstats = "ietf-interfaces:interfaces-state/interface/statistics"

Hierdoor kan de Telegraaf-toepassing die op de host wordt uitgevoerd (op standaardpoort 57000) de ontvangen gegevens decoderen die afkomstig zijn van de WLC.

Zodra de configuratie is opgeslagen, moet u Telegraaf opnieuw starten om deze op de service toe te passen. Zorg er ook voor dat de service weer goed is opgestart:

admin@tig:~$ sudo systemctl restart telegraf
admin@tig:~$ systemctl status telegraf.service
● telegraf.service - Telegraf
     Loaded: loaded (/lib/systemd/system/telegraf.service; enabled; vendor preset: enabled)
     Active: active (running) since Mon 2023-07-03 17:12:49 UTC; 2min 18s ago
       Docs: https://github.com/influxdata/telegraf
   Main PID: 110182 (telegraf)
      Tasks: 10 (limit: 19180)
     Memory: 47.6M
        CPU: 614ms
     CGroup: /system.slice/telegraf.service
             └─110182 /usr/bin/telegraf -config /etc/telegraf/telegraf.conf -config-directory /etc/telegraf/telegraf.d

Stap 3. Telemetrie-abonnement met de gewenste metriek bepalen

Zoals gezegd, worden op Cisco-apparaten, net als op vele andere, statistieken georganiseerd volgens het YANG-model. De specifieke Cisco YANG-modellen voor elke versie van IOS XE (gebruikt op de 9800) zijn hier te vinden, met name die voor IOS XE Dublin 17.12.03 die in dit voorbeeld wordt gebruikt.

In dit voorbeeld richten we ons op het verzamelen van CPU-gebruikstatistieken van de gebruikte 9800-CL-instantie. Door het YANG-model te inspecteren voor Cisco IOS XE Dublin 17.12.03, kan men bepalen welke module het CPU-gebruik van de controller bevat, en in het bijzonder voor de laatste 5 seconden. Deze maken deel uit van de Cisco-IOS-XE-process-cpu-oper module, onder de cpu-utilisatie groepering (blad vijf seconden).

Stap 4. NETCONF inschakelen op de controller

Het gRPC dial-out framework vertrouwt op NETCONF om hetzelfde te werken. Daarom moet deze functie worden ingeschakeld op de 9800 en dit wordt bereikt door de volgende opdrachten uit te voeren:

WLC(config)#netconf ssh
WLC(config)#netconf-yang

Stap 5. Het Telemetry-abonnement configureren op de controller

Zodra de XPaths (ook bekend als XML Paths Language) van de metrics zijn bepaald op basis van het YANG-model, kan een telemetrieabonnement eenvoudig worden geconfigureerd vanuit de 9800 CLI om te beginnen met het streamen van deze naar de Telegraaf-instantie die is geconfigureerd in stap 2. Dit gebeurt door het uitvoeren van deze commando’s:

WLC(config)#telemetry ietf subscription 101
WLC(config-mdt-subs)#encoding encode-kvgpb
WLC(config-mdt-subs)#filter xpath /process-cpu-ios-xe-oper:cpu-usage/cpu-utilization/five-seconds
WLC(config-mdt-subs)#source-address 10.48.39.130
WLC(config-mdt-subs)#stream yang-push
WLC(config-mdt-subs)#update-policy periodic 100
WLC(config-mdt-subs)#receiver ip address 10.48.39.98 57000 protocol grpc-tcp

In dit codeblok wordt eerst het telemetrieabonnement met identificatiecode 101 gedefinieerd. De ID van het abonnement kan elk nummer tussen <0-2147483647> zijn, zolang het niet overlapt met een ander abonnement. Voor dit abonnement worden geconfigureerd, in deze volgorde:

• De gebruikte coderingsmethode, die kvGPB moet zijn bij het werken met het gRPC-transportprotocol.
• Het filter voor de statistieken die door het abonnement worden verzonden, is de XPath die de metriek definieert die voor ons interessant is (om te weten, /process-cpu-ios-xe-oper:cpu-usage/cpu-utilization/five-seconds).
• Het IP-adres van de bron dat door de controller wordt gebruikt om de statistieken te verzenden.
• Het stroomtype dat wordt gebruikt om de statistieken te communiceren, in dit geval YANG Push IETF-standaard.
• De frequentie die door de controller wordt gebruikt om gegevens in 100^e seconden naar de abonnee te verzenden. In dit geval is het geconfigureerd om elke seconde periodiek updates te verzenden.
• Het IP-adres van de ontvanger en het poortnummer, evenals het protocol dat wordt gebruikt voor de communicatie tussen de controller en de abonnee. In dit voorbeeld wordt gRPC-TCPwordt gebruikt om metriek te verzenden naar host 10.48.39.98 op poort 57000.

Stap 6. Grafana-gegevensbron configureren

Nu de controller gegevens naar Telegraaf begint te verzenden en deze in de TELEGRAF InfluxDB-database worden opgeslagen, is het tijd om Grafana te configureren om deze statistieken te laten doorbladeren.

Navigeer vanuit uw Grafana GUI naar Home > Connections > Connect data en gebruik de zoekbalk om de InfluxDB-gegevensbron te vinden.

Selecteer dit type gegevensbron en gebruik de knop "Een InfluxDB-gegevensbron maken" om Grafana te verbinden met de TELEGRAPH-database die is gemaakt in stap 1.

Vul het formulier in dat op het scherm verschijnt, met name:

• Een naam voor de gegevensbron.
• De URL van de gebruikte InfluxDB-instantie.
• De gebruikte databasenaam (in dit voorbeeld "TELEGRAF").
• De referenties van de gebruiker die is gedefinieerd om toegang te krijgen (in dit voorbeeld, telegraf / YOUR_PASSWORD).

Stap 7. Een dashboard maken

Grafana visualisaties zijn georganiseerd in Dashboards. Om een dashboard te maken met de Catalyst 9800 metrics visualisaties, navigeert u naar Home > Dashboards en gebruikt u de knop "Nieuw dashboard"

Hierdoor wordt het nieuwe dashboard geopend. Klik op de tandwielpictogrammen om toegang te krijgen tot de dashboardparameter en de naam te wijzigen. In het voorbeeld wordt "Catalyst 9800 Telemetry" gebruikt. Zodra dit is gebeurd, gebruikt u de knop "Dashboard opslaan" om uw dashboard op te slaan.

Stap 8. Een visualisatie toevoegen aan het dashboard

Nu de gegevens goed worden verzonden, ontvangen en opgeslagen en Grafana toegang heeft tot deze opslaglocatie, is het tijd om een visualisatie voor hen te maken.

Vanuit een van uw Grafana-dashboard gebruikt u de knop "Toevoegen" en selecteert u "Visualisatie" in het menu dat verschijnt om een visualisatie van uw statistieken te maken.

Hiermee wordt het deelvenster Bewerken van de gemaakte visualisatie geopend:

Selecteer in dit deelvenster

• De naam van de gegevensbron die u hebt gemaakt in stap 6, TELEGRAF in dit voorbeeld.
• De meting (schema) met de gegevens die u wilt visualiseren, "Cisco-IOS-XE-process-cpu-oper: cpu-usage/cpu-utilization" in dit voorbeeld.
• Het veld uit de database dat de statistieken weergeeft die u wilt visualiseren, "five_seconds" in dit voorbeeld.
• De titel van de visualisatie, "CPU Utilization 9800-CL" in dit voorbeeld.

Zodra de knop "Opslaan/Toepassen" van de vorige figuur is ingedrukt, wordt de visualisatie die het CPU-gebruik van de Catalyst 9800-controller in de loop van de tijd weergeeft, toegevoegd aan het dashboard. De wijzigingen die in het dashboard zijn aangebracht, kunnen worden opgeslagen met behulp van de disketteknop.

Verifiëren

WLC-hardloopconfiguratie

Building configuration...
Current configuration : 112215 bytes
!
! Last configuration change at 14:28:36 UTC Thu May 23 2024 by admin
! NVRAM config last updated at 14:28:23 UTC Thu May 23 2024 by admin
!
version 17.12
[...]
aaa new-model
!
!
aaa authentication login default local
aaa authentication login local-auth local
aaa authentication dot1x default group radius
aaa authorization exec default local 
aaa authorization network default group radius 
[...]
vlan internal allocation policy ascending
!
vlan 39 
!
vlan 1413
 name VLAN_1413
!
!
interface GigabitEthernet1
 switchport access vlan 1413
 negotiation auto
 no mop enabled
 no mop sysid
!
interface GigabitEthernet2
 switchport trunk allowed vlan 39,1413
 switchport mode trunk
 negotiation auto
 no mop enabled
 no mop sysid
!
interface Vlan1
 no ip address
 no ip proxy-arp
 no mop enabled
 no mop sysid
!
interface Vlan39
 ip address 10.48.39.130 255.255.255.0
 no ip proxy-arp
 no mop enabled
 no mop sysid
[...]
telemetry ietf subscription 101
 encoding encode-kvgpb
 filter xpath /process-cpu-ios-xe-oper:cpu-usage/cpu-utilization
 source-address 10.48.39.130
 stream yang-push
 update-policy periodic 1000
 receiver ip address 10.48.39.98 57000 protocol grpc-tcp
[...]
netconf-yang

telegrafconfiguratie

# Configuration for telegraf agent
[agent]
  metric_buffer_limit = 10000
  collection_jitter = "0s"
  debug = true
  quiet = false
  flush_jitter = "0s"
  hostname = ""
  omit_hostname = false

###############################################################################
#                            OUTPUT PLUGINS                                   #
###############################################################################
# Configuration for sending metrics to InfluxDB
[[outputs.influxdb]]
  urls = ["http://127.0.0.1:8086"]
  database = "TELEGRAF"
  username = "telegraf"
  password = "Wireless123#"

###############################################################################
#                            INPUT PLUGINS                                    #
###############################################################################

###############################################################################
#                            SERVICE INPUT PLUGINS                            #
###############################################################################
# # Cisco model-driven telemetry (MDT) input plugin for IOS XR, IOS XE and NX-OS platforms
[[inputs.cisco_telemetry_mdt]]
  transport = "grpc"
  service_address = "10.48.39.98:57000"
 [inputs.cisco_telemetry_mdt.aliases]
    ifstats = "ietf-interfaces:interfaces-state/interface/statistics"

InfluxDB-configuratie

### Welcome to the InfluxDB configuration file.
reporting-enabled = false
[meta]
  dir = "/var/lib/influxdb/meta"

[data]
  dir = "/var/lib/influxdb/data"
  wal-dir = "/var/lib/influxdb/wal"

[retention]
  enabled = true
  check-interval = "30m"

Grafana-configuratie

#################################### Server ####################################
[server]
http_addr = 10.48.39.98
domain = 10.48.39.98

Problemen oplossen

WLC One Stop-Shop Reflex

Van de WLC-kant is het allereerste dat moet worden geverifieerd dat processen met betrekking tot programmatische interfaces actief zijn.

#show platform software yang-management process
confd : Running
nesd : Running
syncfd : Running
ncsshd : Running               <-- NETCONF / gRPC Dial-Out
dmiauthd : Running             <-- For all of them, Device Managment Interface needs to be up.  
nginx : Running                <-- RESTCONF 
ndbmand : Running
pubd : Running
gnmib : Running                <-- gNMI 

Voor NETCONF (gebruikt door gRPC-inbelverbinding) kunnen deze opdrachten ook helpen bij het controleren van de status van het proces.

WLC#show netconf-yang status 
netconf-yang: enabled
netconf-yang candidate-datastore: disabled
netconf-yang side-effect-sync: enabled
netconf-yang ssh port: 830
netconf-yang turbocli: disabled
netconf-yang ssh hostkey algorithms: rsa-sha2-256,rsa-sha2-512,ssh-rsa
netconf-yang ssh encryption algorithms: aes128-ctr,aes192-ctr,aes256-ctr,aes128-cbc,aes256-cbc
netconf-yang ssh MAC algorithms: hmac-sha2-256,hmac-sha2-512,hmac-sha1
netconf-yang ssh KEX algorithms: diffie-hellman-group14-sha1,diffie-hellman-group14-sha256,ecdh-sha2-nistp256,ecdh-sha2-nistp384,ecdh-sha2-nistp521,diffie-hellman-group16-sha512

Als de processtatus is gecontroleerd, is een andere belangrijke controle de status van de telemetrieverbinding tussen de Catalyst 9800 en de Telegraaf-ontvanger. Het kan worden bekeken met de opdracht "Toon alle telemetrieverbindingen".

WLC#show telemetry connection all 
Telemetry connections

Index Peer Address               Port  VRF Source Address             State      State Description
----- -------------------------- ----- --- -------------------------- ---------- --------------------
28851 10.48.39.98                57000 0   10.48.39.130               Active     Connection up       

Als de telemetrieverbinding tussen de WLC en de ontvanger tot stand is gebracht, kan men er ook voor zorgen dat de geconfigureerde abonnementen geldig zijn met behulp van de show telemetry ietf subscription all brief opdracht.

WLC#show telemetry ietf subscription all brief
ID         Type       State      State Description
101        Configured Valid      Subscription validated

De gedetailleerde versie van deze opdracht show telemetry ietf subscription all detailbiedt meer informatie over abonnementen en kan helpen om een probleem uit de configuratie op te sporen.

WLC#show telemetry ietf subscription all detail 
Telemetry subscription detail:

  Subscription ID: 101
  Type: Configured
  State: Valid
  Stream: yang-push
  Filter:
    Filter type: xpath
    XPath: /process-cpu-ios-xe-oper:cpu-usage/cpu-utilization
  Update policy:
    Update Trigger: periodic
    Period: 1000
  Encoding: encode-kvgpb
  Source VRF: 
  Source Address: 10.48.39.130
  Notes: Subscription validated

  Named Receivers:
    Name                                              Last State Change  State                 Explanation                                                   
    -------------------------------------------------------------------------------------------------------------------------------------------------------
    grpc-tcp://10.48.39.98:57000                      05/23/24 08:00:25  Connected                                                                           

Netwerkbereikbaarheid bevestigen

De Catalyst 9800-controller verzendt gRPC-gegevens naar de ontvangerpoort die is geconfigureerd voor elk telemetrieabonnement.

WLC#show run | include receiver ip address
receiver ip address 10.48.39.98 57000 protocol grpc-tcp

Om de netwerkconnectiviteit tussen de WLC en de ontvanger op deze geconfigureerde poort te verifiëren, zijn verschillende tools beschikbaar.

Vanuit de WLC kan men telnet gebruiken op de geconfigureerde ontvanger/IP-poort (hier 10.48.39.98:57000) om te controleren of deze open en bereikbaar is vanaf de controller zelf. Als het verkeer niet wordt geblokkeerd, moet de poort als open in de uitvoer worden weergegeven:

WLC#telnet 10.48.39.98 57000
Trying 10.48.39.98, 57000 ... Open <-------

Als alternatief kan men Nmap van elke host gebruiken om ervoor te zorgen dat de ontvanger goed wordt belicht op de geconfigureerde poort.

$ sudo nmap -sU -p 57000 10.48.39.98
Starting Nmap 7.95 ( https://nmap.org ) at 2024-05-17 13:12 CEST
Nmap scan report for air-1852e-i-1.cisco.com (10.48.39.98)
Host is up (0.020s latency).

PORT      STATE         SERVICE
57000/udp open|filtered unknown

Nmap done: 1 IP address (1 host up) scanned in 0.35 seconds

Logboekregistratie en foutopsporing

2024/05/23 14:40:36.566486156 {pubd_R0-0}{2}: [mdt-ctrl] [30214]: (note): **** Event Entry: Configured legacy receiver creation/modification of subscription 101 receiver 'grpc-tcp://10.48.39.98:57000'
2024/05/23 14:40:36.566598609 {pubd_R0-0}{2}: [mdt-ctrl] [30214]: (note): Use count for named receiver 'grpc-tcp://10.48.39.98:57000' set to 46.
2024/05/23 14:40:36.566600301 {pubd_R0-0}{2}: [mdt-ctrl] [30214]: (note): {subscription receiver event='configuration created'} received for subscription 101 receiver 'grpc-tcp://10.48.39.98:57000'
[...]
2024/05/23 14:40:36.572402901 {pubd_R0-0}{2}: [pubd] [30214]: (info): Collated data collector filters for subscription 101.
2024/05/23 14:40:36.572405081 {pubd_R0-0}{2}: [pubd] [30214]: (debug): Creating periodic sensor for subscription 101.
2024/05/23 14:40:36.572670046 {pubd_R0-0}{2}: [pubd] [30214]: (info): Creating data collector type 'ei_do periodic' for subscription 101 using filter '/process-cpu-ios-xe-oper:cpu-usage/cpu-utilization'.
2024/05/23 14:40:36.572670761 {pubd_R0-0}{2}: [pubd] [30214]: (debug): Creating crimson data collector for filter '/process-cpu-ios-xe-oper:cpu-usage/cpu-utilization' (1 subfilters) with cap 0x0001.
2024/05/23 14:40:36.572671763 {pubd_R0-0}{2}: [pubd] [30214]: (debug): Need new data collector instance 0 for subfilter '/process-cpu-ios-xe-oper:cpu-usage/cpu-utilization'.
2024/05/23 14:40:36.572675434 {pubd_R0-0}{2}: [pubd] [30214]: (debug): Creating CRIMSON periodic data collector for filter '/process-cpu-ios-xe-oper:cpu-usage/cpu-utilization'.
2024/05/23 14:40:36.572688399 {pubd_R0-0}{2}: [pubd] [30214]: (debug): tree rooted at cpu-usage
2024/05/23 14:40:36.572715384 {pubd_R0-0}{2}: [pubd] [30214]: (debug): last container/list node 0
2024/05/23 14:40:36.572740734 {pubd_R0-0}{2}: [pubd] [30214]: (debug): 1 non leaf children to render from cpu-usage down
2024/05/23 14:40:36.573135594 {pubd_R0-0}{2}: [pubd] [30214]: (debug): URI:/cpu_usage;singleton_id=0 SINGLETON
2024/05/23 14:40:36.573147953 {pubd_R0-0}{2}: [pubd] [30214]: (debug): 0 non leaf children to render from cpu-utilization down
2024/05/23 14:40:36.573159482 {pubd_R0-0}{2}: [pubd] [30214]: (debug): Timer created for subscription 101, sensor 0x62551136f0e8
2024/05/23 14:40:36.573166451 {pubd_R0-0}{2}: [mdt-ctrl] [30214]: (note): {subscription receiver event='receiver connected'} received with peer (10.48.39.98:57000) for subscription 101 receiver 'grpc-tcp://10.48.39.98:57000'
2024/05/23 14:40:36.573197750 {pubd_R0-0}{2}: [pubd] [30214]: (debug): Starting batch from periodic collector 'ei_do periodic'.
2024/05/23 14:40:36.573198408 {pubd_R0-0}{2}: [pubd] [30214]: (debug): Building from the template
2024/05/23 14:40:36.575467870 {pubd_R0-0}{2}: [pubd] [30214]: (debug): Created dbal batch:133, for crimson subscription
2024/05/23 14:40:36.575470867 {pubd_R0-0}{2}: [pubd] [30214]: (debug): Done building from the template
2024/05/23 14:40:36.575481078 {pubd_R0-0}{2}: [pubd] [30214]: (debug): Executing batch:133 for periodic subscription
2024/05/23 14:40:36.575539723 {pubd_R0-0}{2}: [mdt-ctrl] [30214]: (note): {subscription id=101 receiver name='grpc-tcp://10.48.39.98:57000', state='connecting'} handling 'receiver connected' event with result 'e_mdt_rc_ok'
2024/05/23 14:40:36.575558274 {pubd_R0-0}{2}: [mdt-ctrl] [30214]: (note): {subscription receiver event='receiver connected'} subscription 101 receiver 'grpc-tcp://10.48.39.98:57000' changed
2024/05/23 14:40:36.577274757 {ndbmand_R0-0}{2}: [ndbmand] [30690]: (info): get__next_table reached the end of table for /services;serviceName=ewlc_oper/capwap_data@23
2024/05/23 14:40:36.577279206 {ndbmand_R0-0}{2}: [ndbmand] [30690]: (debug): Cleanup table for /services;serviceName=ewlc_oper/capwap_data cursor=0x57672da538b0
2024/05/23 14:40:36.577314397 {ndbmand_R0-0}{2}: [ndbmand] [30690]: (info): get__next_object cp=ewlc-oper-db exit return CONFD_OK
2024/05/23 14:40:36.577326609 {ndbmand_R0-0}{2}: [ndbmand] [30690]: (debug): yield ewlc-oper-db
2024/05/23 14:40:36.579099782 {iosrp_R0-0}{1}: [parser_cmd] [26295]: (note): id= A.B.C.D@vty0:user= cmd: 'receiver ip address 10.48.39.98 57000 protocol grpc-tcp' SUCCESS 2024/05/23 14:40:36.578 UTC
2024/05/23 14:40:36.580979429 {pubd_R0-0}{2}: [pubd] [30214]: (debug): Batch response received for crimson sensor, batch:133
2024/05/23 14:40:36.580988867 {pubd_R0-0}{2}: [pubd] [30214]: (debug): Green response: Result rc 0, Length: 360, num_records 1
2024/05/23 14:40:36.581175013 {pubd_R0-0}{2}: [pubd] [30214]: (debug): Green Resp cursor len 63
2024/05/23 14:40:36.581176173 {pubd_R0-0}{2}: [pubd] [30214]: (debug): There is no more data left to be retrieved from batch 133.
2024/05/23 14:40:36.581504331 {iosrp_R0-0}{2}: [parser_cmd] [24367]: (note): id= 10.227.65.133@vty1:user=admin cmd: 'receiver ip address 10.48.39.98 57000 protocol grpc-tcp' SUCCESS 2024/05/23 14:40:36.553 UTC
[...]
2024/05/23 14:40:37.173223406 {pubd_R0-0}{2}: [pubd] [30214]: (info): Added queue (wq: tc_inst 60293411, 101) to be monitored (mqid: 470)
2024/05/23 14:40:37.173226005 {pubd_R0-0}{2}: [pubd] [30214]: (debug): New subscription (subscription 101) monitoring object stored at id 19
2024/05/23 14:40:37.173226315 {pubd_R0-0}{2}: [pubd] [30214]: (note): Added subscription for monitoring (subscription 101, msid 19)
2024/05/23 14:40:37.173230769 {pubd_R0-0}{2}: [pubd] [30214]: (debug): Stats updated for Q (wq: tc_inst 60293411, 101), total_enqueue: 1
2024/05/23 14:40:37.173235969 {pubd_R0-0}{2}: [pubd] [30214]: (debug): (grpc::events) Processing event Q
2024/05/23 14:40:37.173241290 {pubd_R0-0}{2}: [pubd] [30214]: (debug): GRPC telemetry connector update data for subscription 101, period 1 (first: true)
2024/05/23 14:40:37.173257944 {pubd_R0-0}{2}: [pubd] [30214]: (debug): Encoding path is Cisco-IOS-XE-process-cpu-oper:cpu-usage/cpu-utilization
2024/05/23 14:40:37.173289128 {pubd_R0-0}{2}: [pubd] [30214]: (debug): Creating kvgpb encoder
2024/05/23 14:40:37.173307771 {pubd_R0-0}{2}: [pubd] [30214]: (debug): Creating combined parser
2024/05/23 14:40:37.173310050 {pubd_R0-0}{2}: [pubd] [30214]: (debug): Beginning MDT yang container walk for record 0
2024/05/23 14:40:37.173329761 {pubd_R0-0}{2}: [pubd] [30214]: (debug): Dispatching new container [data_node: name=Cisco-IOS-XE-process-cpu-oper:cpu-usage, type=container, parent=n/a, key=false]
2024/05/23 14:40:37.173334681 {pubd_R0-0}{2}: [pubd] [30214]: (debug): Container 'Cisco-IOS-XE-process-cpu-oper:cpu-usage' started successfully
2024/05/23 14:40:37.173340313 {pubd_R0-0}{2}: [pubd] [30214]: (debug): add data in progress
2024/05/23 14:40:37.173343079 {pubd_R0-0}{2}: [pubd] [30214]: (debug): GRPC telemetry connector continue data for subscription 101, period 1 (first: true)
2024/05/23 14:40:37.173345689 {pubd_R0-0}{2}: [pubd] [30214]: (debug): (grpc::events) Processing event Q
2024/05/23 14:40:37.173350431 {pubd_R0-0}{2}: [pubd] [30214]: (debug): Dispatching new container [data_node: name=cpu-utilization, type=container, parent=Cisco-IOS-XE-process-cpu-oper:cpu-usage, key=false]
2024/05/23 14:40:37.173353194 {pubd_R0-0}{2}: [pubd] [30214]: (debug): Deferred container cpu-utilization
2024/05/23 14:40:37.173355275 {pubd_R0-0}{2}: [pubd] [30214]: (debug): Container 'cpu-utilization' started successfully
2024/05/23 14:40:37.173380121 {pubd_R0-0}{2}: [pubd] [30214]: (debug): Dispatching new leaf [name=five-seconds, value=3, parent=cpu-utilization, key=false]
2024/05/23 14:40:37.173390655 {pubd_R0-0}{2}: [pubd] [30214]: (debug): Leaf 'five-seconds' added successfully
2024/05/23 14:40:37.173393529 {pubd_R0-0}{2}: [pubd] [30214]: (debug): add data in progress
2024/05/23 14:40:37.173395693 {pubd_R0-0}{2}: [pubd] [30214]: (debug): GRPC telemetry connector continue data for subscription 101, period 1 (first: true)
2024/05/23 14:40:37.173397974 {pubd_R0-0}{2}: [pubd] [30214]: (debug): (grpc::events) Processing event Q
2024/05/23 14:40:37.173406311 {pubd_R0-0}{2}: [pubd] [30214]: (debug): Dispatching new leaf [name=five-seconds-intr, value=0, parent=cpu-utilization, key=false]
2024/05/23 14:40:37.173408937 {pubd_R0-0}{2}: [pubd] [30214]: (debug): Leaf 'five-seconds-intr' added successfully
2024/05/23 14:40:37.173411575 {pubd_R0-0}{2}: [pubd] [30214]: (debug): add data in progress
[...]

Zorg ervoor dat statistieken de TIG-stapel bereiken

Van InfluxDB CLI

Net als elk ander databasesysteem wordt InfluxDB geleverd met een CLI die kan worden gebruikt om te controleren of statistieken correct door Telegraaf worden ontvangen en worden opgeslagen in de gedefinieerde database. InfluxDB organiseert meetwaarden, zogenaamde punten, in metingen die zelf als reeksen zijn georganiseerd. Sommige basiscommando's die hier worden gepresenteerd, kunnen worden gebruikt om het gegevensschema aan de InfluxDB-kant te verifiëren en ervoor te zorgen dat gegevens deze toepassing bereiken.

Eerst kunt u controleren of de serie, metingen en hun structuur (sleutels) goed zijn gegenereerd. Deze worden automatisch gegenereerd door Telegraaf en InfluxDB op basis van de structuur van de gebruikte RPC.

Opmerking: Deze structuur is natuurlijk volledig aanpasbaar vanuit de configuraties Telegraaf en InfluxDB. Dit gaat echter verder dan de reikwijdte van deze configuratiegids.

$ influx
Connected to http://localhost:8086 version 1.6.7~rc0
InfluxDB shell version: 1.6.7~rc0
> USE TELEGRAF
Using database TELEGRAF
> SHOW SERIES
key
---
Cisco-IOS-XE-process-cpu-oper:cpu-usage/cpu-utilization,host=ubuntu-virtual-machine,path=Cisco-IOS-XE-process-cpu-oper:cpu-usage/cpu-utilization,source=WLC,subscription=101
> SHOW MEASUREMENTS
name: measurements
name
----
Cisco-IOS-XE-process-cpu-oper:cpu-usage/cpu-utilization
> SHOW FIELD KEYS FROM "Cisco-IOS-XE-process-cpu-oper:cpu-usage/cpu-utilization"
name: Cisco-IOS-XE-process-cpu-oper:cpu-usage/cpu-utilization
fieldKey                                               fieldType
--------                                               ---------
cpu_usage_processes/cpu_usage_process/avg_run_time     integer
cpu_usage_processes/cpu_usage_process/five_minutes     float
cpu_usage_processes/cpu_usage_process/five_seconds     float
cpu_usage_processes/cpu_usage_process/invocation_count integer
cpu_usage_processes/cpu_usage_process/name             string
cpu_usage_processes/cpu_usage_process/one_minute       float
cpu_usage_processes/cpu_usage_process/pid              integer
cpu_usage_processes/cpu_usage_process/total_run_time   integer
cpu_usage_processes/cpu_usage_process/tty              integer
five_minutes                                           integer
five_seconds                                           integer
five_seconds_intr                                      integer
one_minute                                             integer

Zodra de gegevensstructuur is verduidelijkt (geheel getal, string, boolean, ...), kan men het aantal gegevenspunten krijgen dat op deze metingen wordt opgeslagen op basis van een bepaald veld.

# Get the number of points from "Cisco-IOS-XE-process-cpu-oper:cpu-usage/cpu-utilization" for the field "five_seconds".
> SELECT COUNT(five_seconds) FROM "Cisco-IOS-XE-process-cpu-oper:cpu-usage/cpu-utilization"
name: Cisco-IOS-XE-process-cpu-oper:cpu-usage/cpu-utilization
time count
---- -----
0    1170
> SELECT COUNT(five_seconds) FROM "Cisco-IOS-XE-process-cpu-oper:cpu-usage/cpu-utilization"
name: Cisco-IOS-XE-process-cpu-oper:cpu-usage/cpu-utilization
time count
---- -----
0    1171

# Fix timestamp display
> precision rfc3339
# Get the last point stored in "Cisco-IOS-XE-process-cpu-oper:cpu-usage/cpu-utilization" for the field "five_seconds".
> SELECT LAST(five_seconds) FROM "Cisco-IOS-XE-process-cpu-oper:cpu-usage/cpu-utilization"
name: Cisco-IOS-XE-process-cpu-oper:cpu-usage/cpu-utilization
time                    last
----                    ----
2024-05-23T13:18:53.51Z 0
> SELECT LAST(five_seconds) FROM "Cisco-IOS-XE-process-cpu-oper:cpu-usage/cpu-utilization"
name: Cisco-IOS-XE-process-cpu-oper:cpu-usage/cpu-utilization
time                     last
----                     ----
2024-05-23T13:19:03.589Z 2

Als het aantal punten voor een bepaald veld en de tijdstempel voor de laatste gebeurtenis toenemen, is het een goed teken dat de TIG-stapel de gegevens die door de WLC worden verzonden, ontvangt en correct opslaat.

Van Telegraaf

Om te controleren of de Telegraaf-ontvanger daadwerkelijk enkele statistieken van de controller ontvangt en hun formaat controleert, kunt u de Telegraaf-statistieken omleiden naar een uitvoerbestand op de host. Dit kan erg handig zijn als het gaat om het oplossen van problemen met apparaatinterconnectie. Om dit te bereiken, maakt u eenvoudig gebruik van de "file" -uitvoerplug-in van Telegraaf, configureerbaar vanaf de /etc/telegraf/telegraf.confwebsite.

# Send telegraf metrics to file(s)
[[outputs.file]]
#   ## Files to write to, "stdout" is a specially handled file.
   files = ["stdout", "/tmp/metrics.out", "other/path/to/the/file"]
#
#   ## Use batch serialization format instead of line based delimiting.  The
#   ## batch format allows for the production of non line based output formats and
#   ## may more efficiently encode metric groups.
#   # use_batch_format = false
#
#   ## The file will be rotated after the time interval specified.  When set
#   ## to 0 no time based rotation is performed.
#   # rotation_interval = "0d"
#
#   ## The logfile will be rotated when it becomes larger than the specified
#   ## size.  When set to 0 no size based rotation is performed.
#   # rotation_max_size = "0MB"
#
#   ## Maximum number of rotated archives to keep, any older logs are deleted.
#   ## If set to -1, no archives are removed.
#   # rotation_max_archives = 5
#
#   ## Data format to output.
#   ## Each data format has its own unique set of configuration options, read
#   ## more about them here:
#   ## https://github.com/influxdata/telegraf/blob/master/docs/DATA_FORMATS_OUTPUT.md
   data_format = "influx"

Referenties

Richtlijnen voor het bepalen van de grootte van hardware

Grafana-vereisten