Dashboard view
Here is some information about the main dashboard view in Jenkins, in Fuego:
If you click on "Home" in the upper left part of any page in the fuego web interface, you will be taked to a page with the following parts:
- top of screen are some logos and a search bar
- a navigation bar below that (with a context trail)
- a sidebar of the left of the page with:
- a menu
- test run queue
- target status
- the main test history/selection panel, consisting of several tabs:
- 0.History
- Benchmarks
- Functional
- all
- batch_runs
- + sign
To see the configuration for each view, select the tab you want to view/edit, and select "Edit Dashboard" in the left sidebar menu.
For each Dashboard (pane?) you can set:
- Name, Description
- Job Filters
- You can select individual tests, or use a regular expression to include tests in the view
- columns
- you can add or remote columns, or reorder the columns
- possible columns:
- Compact Column: All Statuses
- Compact Column: Stable + Failed
- Compact Column: Test Name
- Compact Column: Unstable + Stable
- Last Failure
- Last Run Duration
- Last Stable
- Last Success
- Name
- OSV Framework Column: Device
- OSV Framework Column: Platform SDK
- Priority Value
- Run Test Button
- Status
- Test New w/ Status Color
- Weather
- possible columns:
- you can add or remote columns, or reorder the columns
- Dashboard Portlets
- Portlets at the top of the page
- Portlets in the left column
- Portlets in the right column
- portlets at the bottom of the page
0.History dashboard [edit section]
The 0.History dashboard has a regular expression to show Functional and Benchmark tests, with columns:- Status, Weather, Name, Run Test Button, Last Run Duration, OSV Framework Column: Device
It has a "Latests tests runs" portlet, and a "Test Run statistics" portlet at the top of the page.
Latest tests runs" portlet [edit section]
The Latest tests runs" portlet has the following columns:- Test, Run, Time, Platform SDK, Device
where is configuration? [edit section]
"Latest tests runs" is mentioned in- /userdata/conf/config.xml
- value for <name>
- /var/lib/jenkins/plugins/dashboard-view/WEB-INF/classes/hudson/plugins/view/dashboard/Messages_en_US.properties
- value for: Dashboard.LatestBuilds
- /fuego-install/jenkins-updates/en_US/plugins/dashboard-view/WEB-INF/classes/hudson/plugins/view/dashboard/Messages_en_US.properties
- value for: Dashboard.LatestBuilds
Benchmarks dashboard [edit section]
The Benchmarks dashboard has a regular expression to show Benchmark tests, with columns:- Status, Weather, Run Test Button, Test Name w/ Status Color, Priority Value, Last Run Duration, OSV Framework Column: Device
It has a "Tests list" portlet defined to be shown at the bottom of the page.
Available portlets [edit section]
Available Dashboard portlets are:- Latest tests runs
- Test Run statistics
- Test Statistics Chart
- Test Statistics Grid
- Test Trend Chart
- Test statistics
- Tests Grid
- Tests list
- Unstable Tests
Notes [edit section]
Comment: tbwiki formatting is a dream compared to this Jenkins/Hudson/java/js/groovy/stapler/jelly mess!
the 0.History notepad icon mystery [edit section]
Where does the notepad icon come from, in the 0.History list, and what does it mean?Note: The code for this appears to have been coded by Kohsuke Kawaguchi himself (sometime between 2004 and 2009)
this dashboard portlet is labeled "Latest tests runs", and is a "LatestBuild" portlet in the plugin source.
The "LatestBuild" jelly (xml used for HTML emission??) is located at:
- /var/lib/jenkins/plugins/dashboard-view/WEB-INF/classes/hudson/plugins/view/dashboard/builds/LatestBuilds/latestbuilds.jelly
- this file has the definitions for the table to show each row of information
- the Test is defined with <dp:jobLink job="${build.parent} note="${build.description}"/>
- this file has the definitions for the table to show each row of information
- dp: must be some kind of jelly directive
- note: there's a t: jelly directive in a comment in the file.
- the jobLink.jelly file has more info:
- there's a test in:
- /var/lib/jenkins/plugins/dashboard-view/WEB-INF/classes/hudson/view/dashboard/jobLink.jelly
- here's the test:
- <j: if test="${!empty(build.description)}">
- then emit a notepag.png with a tooltip ${note} with href ${job.shortUrl}
- <j: if test="${!empty(build.description)}">
- test is follow by jelly code to emit test name with tooltip of description
- there's a test in:
So the answer appears to be that this test in jobLink.jelly for a non-empty build.description controls whether the entry includes a little notepad.png icon (with a link to the job (shortUrl).