SuperAPI AI 工具集

custom-visualization-builder

数据与分析

查看项目

更新于 10-16 00:20

技能介绍

用途:在 Splunk 中创建自定义仪表盘可视化。可视化运行在沙箱 iframe 中,数据来自 Splunk 搜索;可用纯 JavaScript 或 React 编写,构建打包为 .spl 后安装到受支持实例。目标实例需 Splunk Enterprise 10.4+ 或等效版本的 Splunk Cloud Platform。开发无需本地 Splunk 实例。

主要能力与结构:项目即一个 Splunk 应用,可在 visualizations/ 下包含多个可视化,每个含 config.json、src/ 与 SPL.md;构建系统会自动发现并构建 visualizations/ 下所有目录。选择框可选 JavaScript(@splunk/dashboard-studio-extension,事件监听加 getter,入口 visualization.js)或 React(@splunk/dashboard-studio-extension/react,使用 useDataSources 等 hooks,入口 visualization.jsx)。数据为列式格式,所有值为字符串,需显式解析数值。

必要用法:需 Node.js >= 22、Yarn >= 1.22。先收集项目名(只能含字母、数字、点、下划线)、viz slug(只能含 [a-z0-9_])、显示标签、描述、作者、预期 SPL 列、可配置项与渲染方式。脚手架需交互式运行:mkdir <project-name> && cd <project-name>\nnpx @splunk/create@latest --mode=dashboard-studio-extension <app_id>\n然后 yarn。开发用 yarn dev,构建用 yarn build:prod,打包用 yarn package,输出 dist/<app-id>-<version>-<hash>.spl。本地 Docker 可用 docker cp 后以 splunkctl 安装(需 --yes 且仅限非生产本地实例)。Enterprise 通过 Apps > Manage Apps 安装,无需重启;Splunk Cloud 私有应用须走 ACS CLI 和 AppInspect,不能用 Web 安装 UI。仅改代码可复制 dist/<viz-name>/visualization.js 到 $SPLUNK_HOME/etc/apps/<app-id>/appserver/static/visualizations/<viz-name>/visualization.js 后硬刷新;改 app.conf、config.json 或新增 viz 需完整重装。启用 showDrilldown 后需重启 Splunk。

限制与注意:未获用户明确确认,不得在生产或共享环境安装更新;不向用户索取凭据;沙箱不继承宿主 CSS 变量,需使用硬编码主题色值。默认要求转义不可信搜索值、交互元素可键盘访问、满足 WCAG AA 对比度、动画尊重 prefers-reduced-motion。APIs 与完整字段细节可参见资料中的 references/config-json.md 等文件。