Spyglass on Prow

Spyglass Architecture

Mon, 01 Jan 0001 00:00:00 +0000

Spyglass is split into two major parts: the Spyglass core, and a set of independent lenses. Lenses are designed to run statelessly and without any knowledge of the world outside being provided with a list of artifacts. The core is responsible for selecting lenses and providing them with artifacts.

Spyglass Core

The Spyglass Core is split across pkg/spyglass and cmd/deck. It has the following responsibilities:

Looking up artifacts for a given job and mapping those to lenses
Generating a page that loads the required lenses
Framing lenses with their boilerplate
Facilitating communication between the lens frontends and backends

Spyglass Lenses

Spyglass Lenses currently all live in pkg/spyglass/lenses, though hopefully in the future they can live elsewhere. Spyglass lenses have the following responsibilities:

Build a Spyglass Lens

Mon, 01 Jan 0001 00:00:00 +0000

Spyglass lenses consist of two components: a frontend (which may be trivial) and a backend.

Lens backend

Today, a lens backend must be linked in to the deck binary. As such, lenses must live under pkg/spyglass/lenses. Additionally lenses must be in a folder that matches the name of the lens. The content of this folder will be served by deck, enabling you to reference static content such as images, stylesheets, or scripts.

REST API coverage lens

Mon, 01 Jan 0001 00:00:00 +0000

Presents REST endpoints statistics

Configuration

threshold_warning set threshold for warning highlight
threshold_error set threshold for error highlight

Expected input

uniqueHits total number of unique params calls (first hit of any leaf should increase this value)
expectedUniqueHits total number of params (leaves)
percent is uniqueHits * 100 / expectedUniqueHits
methodCalled whether the method was called
body body params
query query params
root root of the tree
hits number of all params hits
items collection of nodes, if not present then the node is a leaf
height height of the tree
size size of the tree

{
    "uniqueHits": 2,
    "expectedUniqueHits": 4,
    "percent": 50.00,
    "endpoints": {
        "/pets": {
            "post": {
                "uniqueHits": 2,
                "expectedUniqueHits": 4,
                "percent": 50.00,
                "methodCalled": true,
                "params": {
                    "body": {
                        "uniqueHits": 2,
                        "expectedUniqueHits": 4,
                        "percent": 50.00,
                        "root": {
                            "hits": 15,
                            "items": {
                                "origin": {
                                   "hits": 8,
                                   "items": {
                                       "country": {
                                           "hits": 8,
                                           "items": {
                                               "name": {
                                                   "hits": 8
                                               },
                                               "region": {
                                                   "hits": 0
                                               }
                                           }
                                       }
                                   }
                                },
                                "color": {
                                    "hits": 0
                                },
                                "type": {
                                    "hits": 7
                                }
                            }
                        },
                        "height": 4,
                        "size": 7
                    }
                }
            }
        }
    }
}