From 575e3e2c8fb89b52c59f730d57bdbb4901be1948 Mon Sep 17 00:00:00 2001
From: Lars Windolf <lars.windolf@gmx.de>
Date: Mon, 4 Sep 2023 23:11:54 +0200
Subject: [PATCH] Implement notebook loading. Add ARP example notebook

---
 frontend/index.html       | 17 +++++--------
 frontend/inter.var.woff2  |  1 +
 frontend/js/app.js        | 14 +++++++----
 frontend/js/notebook.js   | 30 +++++++++++++++++++++-
 frontend/notebooks/arp.md | 52 +++++++++++++++++++++++++++++++++++++++
 5 files changed, 97 insertions(+), 17 deletions(-)
 create mode 120000 frontend/inter.var.woff2
 create mode 100644 frontend/notebooks/arp.md

diff --git a/frontend/index.html b/frontend/index.html
index f48c896..4d792ca 100644
--- a/frontend/index.html
+++ b/frontend/index.html
@@ -53,12 +53,13 @@
 			<option value='localhost'>
 		</datalist>
 
-		Notebook <input type='text' id='notebook-name' list='notebook-names' placeholder='Name of a notebook' value='default'/>
-		<datalist id='notebook-names'>
+		Notebook
+		<select id='notebook-name'>
 			<!-- FIXME load list automatically -->
-			<option value='default'>
-			<option value='systemd'>
-		</datalist>
+			<option default>default</option>
+			<option>systemd</option>
+			<option>arp</option>
+		</select>
 	</div>
 
 	<div class='main' id='settings'>
@@ -101,12 +102,6 @@ <h2>Backend Endpoint</h2>
 		(async function() {
 			'use strict';
 
-			let response = await fetch("/notebooks/default.md");
-			window.initialNotebookContent = await response.text();			
-
-			/* Async module load to ensure above webpack workaround is done 
-			   and we have loaded the initial notebook markdown */
-			await import('./node_modules/starboard-notebook/dist/starboard-notebook.js');
 			setupApp();
 		})();
 	</script>
diff --git a/frontend/inter.var.woff2 b/frontend/inter.var.woff2
new file mode 120000
index 0000000..d036b4a
--- /dev/null
+++ b/frontend/inter.var.woff2
@@ -0,0 +1 @@
+node_modules/starboard-notebook/dist/inter.var.woff2
\ No newline at end of file
diff --git a/frontend/js/app.js b/frontend/js/app.js
index c6f8730..82b6fdb 100644
--- a/frontend/js/app.js
+++ b/frontend/js/app.js
@@ -1,15 +1,15 @@
 // vim: set ts=4 sw=4:
 /* jshint esversion: 6 */
 
-import { registerStarboardShellCellType } from './notebook.js';
+import { setupNotebook } from './notebook.js';
 import { settingsDialog, settingsLoad } from './settings.js';
 import { ProbeAPI } from './probeapi.js';
 
 import { perfRenderer } from './renderer/perf-flamegraph.js';
 import { netmapRenderer } from './renderer/netmap.js';
 
-var hosts = {};
-var renderers = {
+const params = new URLSearchParams(window.location.search);
+const renderers = {
         'netmap': netmapRenderer,
         'perfFlameGraph': perfRenderer
 };
@@ -316,8 +316,12 @@ function setupApp() {
                 $('#menu a').on('click', function() {
                         view($(this).attr('data-view'));
                 });
-                view('main');
-                registerStarboardShellCellType();
+
+                view(params.get('view')?params.get('view'):'main');
+                setupNotebook(
+                        params.get('host'),
+                        params.get('notebook')
+                );
 
                 $('#renderer').on('change', function() {
                         visualizeHost($('#visualizedHost').text(), $(this).val());
diff --git a/frontend/js/notebook.js b/frontend/js/notebook.js
index 98828ad..e6da9aa 100644
--- a/frontend/js/notebook.js
+++ b/frontend/js/notebook.js
@@ -91,4 +91,32 @@ function registerStarboardShellCellType() {
         runtime.definitions.cellTypes.register("shell", SHELL_CELL_TYPE_DEFINITION);
 }
 
-export { registerStarboardShellCellType };
\ No newline at end of file
+function reloadNotebook() {
+        var n = $('#notebook-name').find("option:selected").val();
+        var h = $('#notebook-host').val();
+
+        window.location.href = `/?view=notebook&notebook=${n}&host=${h}`;
+}
+
+async function setupNotebook(host, name) {
+        if (!host)
+                host = 'localhost';
+        if (!name)
+                name = 'default';
+        
+        $('#notebook-name').val(name);
+        $('#notebook-host').val(host);
+
+        let response = await fetch(`/notebooks/${name}.md`);
+        window.initialNotebookContent = await response.text();			
+
+        /* Async module load to ensure we have loaded the initial notebook markdown above */
+        import('../node_modules/starboard-notebook/dist/starboard-notebook.js').then(() => {
+                registerStarboardShellCellType();
+
+                $('#notebook-name').on('change', reloadNotebook);
+                $('#notebook-host').on('change', reloadNotebook);
+        });
+}
+
+export { setupNotebook };
\ No newline at end of file
diff --git a/frontend/notebooks/arp.md b/frontend/notebooks/arp.md
new file mode 100644
index 0000000..851929f
--- /dev/null
+++ b/frontend/notebooks/arp.md
@@ -0,0 +1,52 @@
+# %% [markdown]
+## ARP Debugging
+
+### Kernel Settings
+
+Check wether ARP ignoring is active. If you want ARP resolving the `arp_ignore` value should be 1
+# %% [shell]
+sysctl net.ipv4.conf.all.arp_ignore
+# %% [markdown]
+Check ARP garbage collection settings:
+# %% [shell]
+sysctl -a 2>/dev/null | grep net.ipv4.neigh.default.gc
+# %% [markdown]
+A typical problem on routers or large k8s cluster node is that the nodes ARP cache runs full because `gc_thres3` is to small. Note also that when `gc_thres1` is larger than the set of entries you usually cache no eviction will ever happen. 
+
+\
+Check ARP cache timeout settings:
+# %% [shell]
+sysctl -a 2>/dev/null | grep net.ipv4.neigh.default.base_reachable
+# %% [markdown]
+While you can query settings per network interface via `sysctl` too it’s easier to use `ip ntable show` to get an overview of effective settings per network interface:
+# %% [shell]
+ip ntable show 
+# %% [markdown]
+### Clear Cache
+
+To clear the complete cache run
+# %% [shell]
+ip -s -s neigh flush all
+# %% [markdown]
+You can also run `arp -d `. To delete individual items run:
+# %% [shell]
+arp -d <ip>
+# %% [markdown]
+
+### Show Cache
+
+Print ARP cache with `ip neigh`
+# %% [shell]
+ip neigh
+# %% [markdown]
+Note how valid entries are marked as `REACHABLE` outdated entries are marked as `STALE`
+
+\
+Or if ARP tools are installed print ARP cache with `arp -a` or `arp -n` for table format.
+# %% [shell]
+arp -a
+# %% [markdown]
+### Further Reading
+
+* <https://www.baeldung.com/linux/arp-settings>
+* <https://manpages.debian.org/bullseye/manpages/arp.7.en.html>
\ No newline at end of file