🌱 linkerd: Viz - blank page on loading any of the tools

solutions/cncf-generated/linkerd/linkerd-9306-viz-blank-page-on-loading-any-of-the-tools.json

@@ -0,0 +1,79 @@
+{
+  "version": "kc-mission-v1",
+  "name": "linkerd-9306-viz-blank-page-on-loading-any-of-the-tools",
+  "missionClass": "solution",
+  "author": "KubeStellar Bot",
+  "authorGithub": "kubestellar",
+  "mission": {
+    "title": "linkerd: Viz - blank page on loading any of the tools",
+    "description": "Viz - blank page on loading any of the tools. This issue affects 14+ users.",
+    "type": "troubleshoot",
+    "status": "completed",
+    "steps": [
+      {
+        "title": "Identify linkerd troubleshoot symptoms",
+        "description": "Check for the issue in your linkerd deployment:\n```bash\nkubectl get pods -n linkerd -l app.kubernetes.io/name=linkerd\nkubectl logs -l app.kubernetes.io/name=linkerd -n linkerd --tail=100 | grep -i error\n```\nLook for error: `output, etc`"
+      },
+      {
+        "title": "Review linkerd configuration",
+        "description": "Inspect the relevant linkerd configuration:\n```bash\nkubectl get all -n linkerd -l app.kubernetes.io/name=linkerd\nkubectl get configmap -n linkerd -l app.kubernetes.io/part-of=linkerd\n```\n### What is the issue?\n\nIf I select any of the Tap / Top / Routes options from the Viz dashboard, I get a blank white page:\n\nAnother user on Slack confirmed they also have this issue"
+      },
+      {
+        "title": "Apply the fix for Viz - blank page on loading any of the tools",
+        "description": "See `use-query-params` [documentation](https://github.com/pbeshai/use-query-params/blob/d06731d0b3f07a40529fc39dc2430e1ec66bbf80/packages/use-query-params/README.md?plain=1#L52).\n```yaml\nmain.82c8da3a2c82d46049d2.js:2 TypeError: Cannot read properties of undefined (reading 'search')\n    at main.82c8da3a2c82d46049d2.js:2:788239\n    at n (main.82c8da3a2c82d46049d2.js:2:789521)\n    at Ko (main.82c8da3a2c82d46049d2.js:2:245602)\n    at xs (main.82c8da3a2c82d46049d2.js:2:291507)\n    at pl (main.82c8da3a2c82d46049d2.js:2:284283)\n    at dl (main.82c8da3a2c82d46049d2.js:2:284208)\n    at rl (main.82c8da3a2c82d46049d2.js:2:281238)\n    at main.82c8da3a2c82d46049d2.js:2:233011\n    at t.unstable_runWithPriority (main.82c8da3a2c82d46049d2.js:2:321171)\n    at Va (main.82c8da3a2c82d46049d2.js:\n```"
+      },
+      {
+        "title": "Confirm Viz - blank page on loading any of the tools is resolved",
+        "description": "Verify the fix by checking that the original error no longer occurs:\n```bash\nkubectl logs -l app.kubernetes.io/name=linkerd -n linkerd --tail=50 --since=5m\nkubectl get events -n linkerd --sort-by='.lastTimestamp' | tail -10\n```\nConfirm that `output, etc` no longer appears in logs."
+      }
+    ],
+    "resolution": {
+      "summary": "See `use-query-params` [documentation](https://github.com/pbeshai/use-query-params/blob/d06731d0b3f07a40529fc39dc2430e1ec66bbf80/packages/use-query-params/README.md?plain=1#L52).",
+      "codeSnippets": [
+        "main.82c8da3a2c82d46049d2.js:2 TypeError: Cannot read properties of undefined (reading 'search')\n    at main.82c8da3a2c82d46049d2.js:2:788239\n    at n (main.82c8da3a2c82d46049d2.js:2:789521)\n    at Ko (main.82c8da3a2c82d46049d2.js:2:245602)\n    at xs (main.82c8da3a2c82d46049d2.js:2:291507)\n    at pl (main.82c8da3a2c82d46049d2.js:2:284283)\n    at dl (main.82c8da3a2c82d46049d2.js:2:284208)\n    at rl (main.82c8da3a2c82d46049d2.js:2:281238)\n    at main.82c8da3a2c82d46049d2.js:2:233011\n    at t.unstable_runWithPriority (main.82c8da3a2c82d46049d2.js:2:321171)\n    at Va (main.82c8da3a2c82d46049d2.js:2:232720)\nns @ main.82c8da3a2c82d46049d2.js:2\nn.callback @ main.82c8da3a2c82d46049d2.js:2\nmo @ main.82c8da3a2c82d46049d2.js:2\nss @ main.82c8da3a2c82d46049d2.js:2\nvl @ main.82c8da3a2c82d46049d2.js:2\nt.",
+        "Subject\n\nProblem\n\nSolution\n\nValidation\n\nFixes #[GitHub issue ID]\n\nDCO Sign off",
+        "Introduce Pull Request Template\n\nGitHub's community guidelines recommend a pull request template, the repo was\nlacking one.\n\nIntroduce a `PULL_REQUEST_TEMPLATE.md` file.\n\nOnce merged, the\n[Community profile checklist](https://github.com/linkerd/linkerd2/community)\nshould indicate the repo now provides a pull request template.\n\nFixes #3321\n\nSigned-off-by: Jane Smith <jane.smith@example.com>"
+      ]
+    }
+  },
+  "metadata": {
+    "tags": [
+      "linkerd",
+      "graduated",
+      "networking",
+      "troubleshoot"
+    ],
+    "cncfProjects": [
+      "linkerd"
+    ],
+    "targetResourceKinds": [
+      "Pod"
+    ],
+    "difficulty": "intermediate",
+    "issueTypes": [
+      "troubleshoot"
+    ],
+    "maturity": "graduated",
+    "sourceUrls": {
+      "issue": "https://github.com/linkerd/linkerd2/issues/9306",
+      "repo": "https://github.com/linkerd/linkerd2",
+      "pr": "https://github.com/linkerd/linkerd2/pull/9451"
+    },
+    "reactions": 14,
+    "comments": 12,
+    "synthesizedBy": "copilot"
+  },
+  "prerequisites": {
+    "kubernetes": ">=1.24",
+    "tools": [
+      "kubectl"
+    ],
+    "description": "A running Kubernetes cluster with linkerd installed or the issue environment reproducible."
+  },
+  "security": {
+    "scannedAt": "2026-03-11T02:02:20.023Z",
+    "scannerVersion": "cncf-gen-3.0.0",
+    "sanitized": true,
+    "findings": []
+  }
+}