Lägg till en nod i Skydive-topologin manuellt via Skydive-klienten

Skydive är en öppen källkodsnätverks- och protokollanalysator i realtid. Den syftar till att ge ett omfattande sätt att förstå vad som händer i nätverksinfrastrukturen.

För att väcka ert intresse kommer jag att visa ett par skärmdumpar om Skydive. Lite längre ner kommer det att finnas ett inlägg som introducerar Skydive.

Inlägg «Introduktion till skydive.network» på Habré.

Skydive visar nätverkstopologin genom att ta emot nätverkshändelser från Skydive-agenter. Har du någonsin undrat hur man lägger till eller visar nätverkskomponenter på topologidiagrammet som är utanför Skydive-agenternas nätverk eller icke-nätverksobjekt som TOR, datalager, etc. Oroa dig inte längre för detta, tack vare Node rule API.

Från och med version 0.20 tillhandahåller Skydive Node rule API, vilket kan användas för att skapa nya noder och kanter samt för att uppdatera metadata för befintliga noder. Node rule API är uppdelat i två API-gränssnitt: nodregel-API och kantregel-API. Nodregel-API används för att skapa en ny nod och uppdatera metadata för en befintlig nod. Kantregel-API används för att skapa en kant mellan två noder, d.v.s. koppla ihop två noder.

I den här bloggen kommer vi att se två användningsfall, varav det ena är en nätverkskomponent som inte är en del av skydive-nätverket. Det andra alternativet är en icke-nätverkskomponent. Innan detta kommer vi att gå igenom några grundläggande användningssätt av topologins regel-API.

Skapa en Skydive-nod

För att skapa en nod måste du ange ett unikt nodnamn och en giltig nodtyp. Du kan också ange några ytterligare parametrar.

skydive client node-rule create --action="create" --node-name="node1" --node-type="fabric" --name="node rule1"
{
  "UUID": "ea21c30f-cfaa-4f2d-693d-95159acb71ed",
  "Name": "node rule1",
  "Description": "",
  "Metadata": {
    "Name": "node1",
    "Type": "fabric"
  },
  "Action": "create",
  "Query": ""
}

Uppdatera Skydive-nodernas Metadata

För att uppdatera metadata för en befintlig nod måste du tillhandahålla en förfrågan på gremlin-språket för att välja de noder där du vill uppdatera metadata. Enligt din förfrågan kan du uppdatera metadata för en eller flera noder med hjälp av en nodregel.

skydive client node-rule create --action="update" --name="update rule" --query="G.V().Has('Name', 'node1')" --metadata="key1=val1, key2=val2"
{
  "UUID": "3e6c0e15-a863-4583-6345-715053ac47ce",
  "Name": "update rule",
  "Description": "",
  "Metadata": {
    "key1": "val1",
    "key2": "val2"
  },
  "Action": "update",
  "Query": "G.V().Has('Name', 'node1')"
}

Skapa en Skydive-kant

För att skapa en kant måste du ange käll- och målnoder samt typ av relation för kanten. För att skapa en undernod ska värdet på relationen vara ownership, och för att skapa en relation av typen layer2 ska värdet vara layer2. Du kan skapa mer än en relation mellan två noder, men typ av relation måste vara olika.

skydive client edge-rule create --name="edge" --src="G.v().has('TID', '2f6f9b99-82ef-5507-76b6-cbab28bda9cb')" --dst="G.V().Has('TID', 'd6ec6e2f-362e-51e5-4bb5-6ade37c2ca5c')" --relationtype="both"
{
  "UUID": "50fec124-c6d0-40c7-42a3-2ed8d5fbd410",
  "Name": "edge",
  "Description": "",
  "Src": "G.v().has('TID', '2f6f9b99-82ef-5507-76b6-cbab28bda9cb')",
  "Dst": "G.V().Has('TID', 'd6ec6e2f-362e-51e5-4bb5-6ade37c2ca5c')",
  "Metadata": {
    "RelationType": "both"
  }
}

Första användningsalternativet

I det här fallet kommer vi att visa hur man representerar en icke-nätverksenhet i Skydive-topologin. Låt oss anta att vi har ett datalager som ska visas i Skydive-topologidiagrammet med viss användbar metadata.

Vi behöver bara skapa en nodregel för att lägga till enheten i topologin. Vi kan lägga till metadata för enheten som en del av create-kommandot eller senare skapa en eller flera update nodregler.

Kör kommandot för nodregeln nedan för att lägga till lagringsenheten i topologisk schemat.

skydive client node-rule create --action="create" --node-name="sda" --node-type="persistentvolume" --metadata="DEVNAME=\/dev\/sda,DEVTYPE=disk,ID.MODEL=SD_MMC, ID.MODEL ID=0316, ID.PATH TAG=pci-0000_00_14_0-usb-0_3_1_0-scsi-0_0_0_0, ID.SERIAL SHORT=20120501030900000, ID.VENDOR=Generic-, ID.VENDOR ID=0bda, MAJOR=8, MINOR=0, SUBSYSTEM=block, USEC_INITIALIZED=104393719727"

Kör kommandot för kanten nedan för att koppla den skapade noden med värdnoden.

skydive client edge-rule create --src="G.V().Has('Name', 'node1')" --dst="G.V().Has('Name', 'sda')" --relationtype="ownership"

Efter kommandona ovan kan du nu se enheten synlig i Skydive-topologin med angiven metadata, som visas på bilden nedan.

Andra användningsalternativet

I det här fallet kommer vi att se hur man lägger till en nätverksenhet som inte är en del av skydive-nätverket. Låt oss titta på det här exemplet. Vi har två skydive-agenter som körs på två olika värdar, för att koppla dessa två värdar behöver vi en TOR-switch. Även om vi kan uppnå detta genom att definiera strukturer och länkar i konfigurationsfilen, låt oss se hur vi kan göra samma sak med API:et för toppologiregler.

Utan TOR-switchen skulle de två agenterna se ut som två olika noder utan några länkar, som visas i bilden nedan.

Nu kör följande kommandon för Node Rules för att skapa TOR-switchen och portarna.

skydive client node-rule create --node-name="TOR" --node-type="fabric" --action="create"
skydive client node-rule create --node-name="port1" --node-type="port" --action="create"
skydive client node-rule create --node-name="port2" --node-type="port" --action="create"

Som ni ser har TOR-switchen och portarna skapats och lagts till i skydive-topologin, och nu kommer topologin att se ut som på bilden nedan.

Nu kör de följande Edge Rule-kommandona för att skapa en koppling mellan TOR-switchen, port 1 och den offentliga gränssnittet på värd 1.

skydive client edge-rule create --src="G.V().Has('Name', 'TOR')" --dst="G.V().Has('Name', 'port1')" --relationtype="ownership"
skydive client edge-rule create --src="G.V().Has('Name', 'TOR')" --dst="G.V().Has('Name', 'port1')" --relationtype="layer2"
skydive client edge-rule create --src="G.V().Has('TID', '372c254d-bac9-50c2-4ca9-86dcc6ce8a57')" --dst="G.V().Has('Name', 'port1')" --relationtype="layer2"

Kör följande kommandon för att skapa en koppling mellan TOR-switchen, port 2 och den offentliga gränssnittet på värd 2.

skydive client edge-rule create --src="G.V().Has('Name', 'TOR')" --dst="G.V().Has('Name', 'port2')" --relationtype="layer2"
skydive client edge-rule create --src="G.V().Has('Name', 'TOR')" --dst="G.V().Has('Name', 'port2')" --relationtype="ownership"
skydive client edge-rule create --src="G.V().Has('TID', '50037073-7862-5234-4996-e58cc067c69c')" --dst="G.V().Has('Name', 'port2')" --relationtype="layer2"

Nu skapas ownership- och layer2-kopplingarna mellan TOR-switchen och porten, liksom layer2-kopplingarna mellan agenterna och portarna. Nu kommer den slutliga topologin att se ut som på bilden nedan.

Nu är de två värdarna/agenterna korrekt kopplade, och du kan kontrollera anslutningen eller skapa en fångst av den kortaste vägen mellan de två värdarna.

P.S. Länk till originalinlägget

Det söks efter personer som kan skriva inlägg om andra möjligheter med Skydive.
Telegram-chatten på skydive.network.

Källa: habr.com