Visualisation of network topology by integrating Maat with Network Map Panel (NMP) in Grafana

Network Map Panel (NMP), a Grafana's plugin, offers another way to configure the visulization of network topology data stored in Maat.

The MaatDex script fetches data from Maat via REST API and monitoring data from Victoria Metrics database. Example of data are presented here in section "Example data model for the Mapgl plugin". Next, data are transformed into a format compatible with NMP. This allows to visualize network topology and measurement data in an interactive map in Grafana.

Files generated for NMP

MaatDex creates two output files based on data fetched from Maat (network topology) and VictoriaMetrics (network monitoring data).

The following json snippets present topology data (the first output file) and monitoring data (the second output file).

{
  "edges": [
    {
      "name": "Poznan--Warszawa",
      "meta": {
        "endpoint_identifiers": {
          "names": [
            "Poznan",
            "Warszawa"
          ],
          "devif": [
            "ptx-poz-1 ae2"
          ]
        }
      },
      "coordinates": [
        [
          52.40699171944117,
          16.95275184036807
        ],
        [
          52.221055825018006,
          21.0097401209817
        ]
      ],
      "children": []
    },
    {
      "name": "Poznan--Wroclaw",
      "meta": {
        "endpoint_identifiers": {
          "names": [
            "Poznan",
            "Wroclaw"
          ],
          "devif": [
            "ptx-poz-1 ae3"
          ]
        }
      },
      "coordinates": [
        [
          52.40699171944117,
          16.95275184036807
        ],
        [
          51.11002330867643,
          17.057098573520435
        ]
      ],
      "children": []
    }
  ],
  "nodes": [
    {
      "name": "Poznan",
      "meta": {
        "displayName": "Poznan"
      },
      "coordinate": [
        52.40699171944117,
        16.95275184036807
      ]
    },
    {
      "name": "Warszawa",
      "meta": {
        "displayName": "Warszawa"
      },
      "coordinate": [
        52.221055825018006,
        21.0097401209817
      ]
    }
  ]
}

    {
        "src": "Poznan",
        "dst": "Warszawa",
        "in_bits": 475758396,
        "out_bits": 689176268
    },
    {
        "src": "Poznan",
        "dst": "Wroclaw",
        "in_bits": 678045192,
        "out_bits": 342085412
    },
    {
        "src": "Gdansk",
        "dst": "Warszawa",
        "in_bits": 645503906,
        "out_bits": 737511208
    }

NMP — Dashboard Import and Configuration

Instructions how to import NMP dashboard into Grafana

1. Create a new folder in the Dashboards menu (e.g., Example NMP) and click the Import button.
   

2. Import the JSON file containing the prepared dashboard. Network Map Panel.json

3. Click the Edit button in the Network topology panel.
   

4. Paste the URL of file generated by MaatDex with monitoring data. Also, copy-paste the content of topology file generated by MaatDex into the Layer 1 Map data (json) field.
   

✅ Done! The result will be visible after refreshing the panel.

---