I have a couple of "documentation" panels in one of my dashboards - each contains a single html tag bracketing the formatted text contents (no searches, etc., just nested bulleted and/or numbered lists). One provides condensed debug information = token values. The other provides release notes and lists known issues for the current version of the dashboard. I collect both in panels so that I can hide them (keeping the dashboard tidy) unless they are called up by yes/no "Show Debug" and "Show Notes" inputs.
I currently update these panels by editing the entire dashboard in the Simple XML editor - but I'd rather be able to edit these in isolation, without opening up (and risking accidental damage to) the entire dashboard - so I tried converting them to pre-built panels.
1. Is there somewhere that I can edit a pre-built panel? I don't see the names I assigned them in the Dashboards or Reports lists.
(Is editing them not permitted/provided, because they're "pre-built"?)
2. Does someone have an alternate approach to embedding documentation in (or linking it to) a dashboard?
Pre-built panels should be constructed more in a way so that they are re-usable contents across all your dashboards. Since their code is not exposed within Simple XML you can change them only from Prebuilt panels menu.
Based on the needs that you have described you can also try embedding an HTML page directly in your Dashboard. Refer to HTML examples in Splunk 6.x Dashboard Examples App.
Thanks niketnilay! You are correct, this is not the intended use of pre-built panels - I'm only doing it to separate these documentation panels (which are not reusable, being specific to one version of the containing dashboard) from the dashboard XML proper, which is quite large. I'll look into your embedded HTML page suggestion.
Pre-built panels are just another type of knowledge object. They reside in
$APP_HOME/[default|local]/data/ui/panels. You can edit there, and
<splunk>/en-US/debug/refresh?entity=admin/panels to reload the contents. You can refer to them in any dashboard you want, as long as permissions are correct.