← Back to branch summary

~ubuntu-branches/debian/jessie/lava-server/jessie

« back to all changes in this revision

Viewing changes to doc/filters-reports.rst

  • Committer: Package Import Robot
  • Author(s): Neil Williams
  • Date: 2014-06-29 19:29:34 UTC
  • Revision ID: package-import@ubuntu.com-20140629192934-ue8hrzzpye9isevt
Tags: upstream-2014.05.30.09
Import upstream version 2014.05.30.09

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/filters-reports.rst
 
1
.. index:: filter
 
2
 
 
3
.. filter:
 
4
 
 
5
Filters
 
6
=======
 
7
 
 
8
What is a Filter?
 
9
-----------------
 
10
 
 
11
You can use filters in LAVA to combine test results from multiple bundle
 
12
streams in a single view and provides ability to apply attribute filtering
 
13
as well include/exclude particular tests or test cases.
 
14
 
 
15
Filters can be public or private. Public filters are accessible by all
 
16
authenticated and anonymous users, while private ones are only accessible by
 
17
the users which created it.
 
18
 
 
19
 
 
20
How to create a Filter?
 
21
-----------------------
 
22
 
 
23
.. image:: ./images/create-filter.png
 
24
    :width: 800
 
25
    :height: 480
 
26
 
 
27
Select a list of bundle streams you would like to be included in your filter
 
28
and add attribute labels and values by which you would like to filter out your
 
29
test results.
 
30
 
 
31
You can set build number attribute as well at this stage, which will sort your
 
32
test runs based on a specified field.
 
33
 
 
34
After setting up everything you will see a preview page where you can check
 
35
if the data your new filter correlates to your need, and you can continue
 
36
editing or save the filter.
 
37
 
 
38
Subscriptions
 
39
-------------
 
40
 
 
41
Subscribing to a filter will cause LAVA to send an email to you whenever
 
42
certain conditions are satisfied.
 
43
 
 
44
You can choose your own level of subscription:
 
45
 * whenever a test that matches the criteria of filter is executed
 
46
 * only when a test that matches the criteria of filter fails
 
47
 
 
48
.. index:: image reports
 
49
 
 
50
.. _image_reports:
 
51
 
 
52
Image Reports
 
53
=============
 
54
 
 
55
Image reports allow you to view test run pass/fail results or test result
 
56
measurements over time. Only site superusers are allowed to manipulate over
 
57
image reports.
 
58
 
 
59
 
 
60
Image Report options
 
61
--------------------
 
62
 
 
63
You can change the options (filters section) in the image reports page like
 
64
start/end build numbers, tests, target goal and graph type. Those changes are
 
65
saved so every time you come to the same image report, you will have options
 
66
from your last visit selected.
 
67
 
 
68
Start/end build number will limit the build numbers on the graph and the table
 
69
below as well.
 
70
 
 
71
With tests option can include/exclude particular tests from this image report
 
72
as well as in the table on the bottom.
 
73
 
 
74
If you set the target goal value a dotted vertical line will be displayed in
 
75
the report chart.
 
76
 
 
77
Graph type can have three different options:
 
78
 * pass/fail displays number of passed test cases in each test run on the
 
79
   report
 
80
 * percentage displays percentage of passed test cases in each test run
 
81
 * measurement graph type will display the first test case measurement from
 
82
   each test run
 
83
 
 
84
 
 
85
Image Report table
 
86
------------------
 
87
 
 
88
Image report table includes pass/fail numbers for all the test runs.
 
89
 
 
90
From here you can go to the particular test run by clicking the cell link and
 
91
you can also link a bug from a launchpad to the test run.
 
92