Dygraphs Readme
We use a charting library called dygraphs to generate our performance graphs. Most browsers are supported. In particular any recent version of FireFox, Chrome, or Safari will work. Internet Explorer users will need at least IE10. This page details some of the advanced settings and features that are available to manipulate the graph suite and individual graphs.
Suite Options:
- Select a specific test suite from the test suite drop down box. The graphs in the suite will be automatically checked and displayed.
Alternatively you can select individual tests from the full list. Note that when you check a particular test it will not be displayed automatically. You have to click the "Display" button.
- When you select a suite or click "Display" the graphs will be regenerated and the initial start date is set by us and may not include all the data available in a particular graph. Click "Display" at any point to reset the graphs to this state.
- You can select or deselect all the graph check boxes, though you probably won't find many cases where you'll need to see all the graphs at once. Note that it may take a few seconds to render all of the graphs.
- When you select a suite or click "Display" the URL is updated to reflect the currently displayed graphs. This is to make it easier to share a particular graph with others or to compare the same graphs amongst different machines.
Graph Options:
- Mouse over a graph to show data in the legend. The nearest series is highlighted on the graph and in the legend.
Click and drag along either axis to zoom. As a note if you are trying to include the x-axis you have to start or end between the dates. Note that all graphs are synced along the x-axis, but not the y-axis.
Shift + click and drag a graph to pan along either axis. Note that all graphs are synced along the x-axis, but not the y-axis
Double click a graph to show all available data for this particular graph. All available data may be different from the default view of the graph that is shown when the graph is initially drawn or you click "Display". Note that all graphs are synced along the x-axis, but not the y-axis.
- Single click on a graph to select the currently highlighted series. Doing so locks series highlighting onto this series making it easier to follow a particular series, especially when two series are close together. This will also keep the data visible in the legend after you are no longer moused over the graph. Click the graph again to deselect the currently highlighted series.
Enter the roll period (number of days over which to average data) in the box in located at the bottom left of each graph.
Click the log/linear button to switch between log and linear scales. If you have not zoomed in vertically, the graph will automatically adjust the min and max vertical display range. If you have zoomed in vertically, the zoom you chose will be used for the log scale. If your zoom range includes values less than or equal to zero the graph will not render. The log button turns red to warn when this behavior will occur.
Misc:
- The yellow vertical lines on the graphs mark approximate Chapel release dates.
- Our nightly testing starts at midnight pacific time. The graphs are updated for each machine as that machine finishes testing, which may occur at different times throughout the day. If the graph has not yet been updated with the most recent nightly testing data, the date the data is from will be displayed in red under the page title. This is also useful to see if testing failures prevented the graphs from being updated.
- Let us know about any issues or feature requests!