Splunk官方文档地址:Developing Views and Apps for Splunk Web
本文主要内容为自定义仪表盘样式和行为
目录
可以通过自定义.js和.css文件自定义仪表板样式和行为,你可以自定义app中的一个特定的仪表板,也可以自定义特定app中所有的仪表板。
包含自定义JavaScript文件可能会导致仪表板呈现问题。在编辑模式下打开仪表板时,您可能会看到有关自定义脚本的警告。
实践:自定义一个仪表板的样式和行为
创建自定义文件
要自定义特定的面板,首先创建一个或多个.css或.js文件来定义样式和行为。
根据仪表板所属的应用程序,将这些文件放在应用程序的appserver/static目录中,该目录位于此处:
bash
$SPLUNK_HOME/etc/apps/<app_name>/appserver/static
例如,要自定义搜索和报告中仪表板的样式和行为,请使用此目录路径:
bash
$SPLUNK_HOME/etc/apps/search/appserver/static
将自定义文件添加到仪表板
当自定义文件位于应用程序的appserver/static目录中时,将它们添加到仪表板中。使用以下语法:
html
<dashboard stylesheet="<style_filename>.css"script="<script_filename>.js">
您可以为一个面板使用多个自定义文件。对于多个.css或.js文件,请使用以下语法:
html
<dashboard stylesheet="<style_filename1>.css, <style_filename2>.css" script="<script_filename1>.js, <script_filename2>.js">
注意:表单在SimpleXML中有根元素,而不是。如果要向表单中添加自定义文件,请使用<form-stylesheet="...">。
将其他应用程序中的自定义文件添加到仪表板
您可以将自定义文件从一个应用程序的appserver/static目录添加到另一个应用的仪表板。使用此语法可以指示自定义文件的其他应用程序上下文。
html
<dashboard stylesheet="<app_name>:<style_filename>.css"script="<app_name>:<script_filename>.js">
例如,要引用位于搜索和报告应用程序上下文中的文件,请使用以下语法。
html
<dashboard stylesheet="search:my_custom_styles.css"script="search:mi_custom_script.js">
注意:确保自定义文件存在于指定应用程序的appserver/static目录中。当找不到文件时,不支持相关性检查和警告消息。
实践:自定义应用程序中所有仪表板的样式和行为
仪表板会自动从appserver/static目录加载dashboard.js和dashboard.css。若要自定义应用程序中所有仪表板的样式和行为,请创建以下一个或两个文件。
- dashboard.js
- dashboard.css
将文件放在以下目录中:
bash
$SPLUNK_HOME/etc/apps/<app_name>/appserver/static