io.opencensus.stats

Class View

java.lang.Object

io.opencensus.stats.View

@Immutable
public abstract class View
extends Object

A View specifies an aggregation and a set of tag keys. The aggregation will be broken down by the unique set of matching tag values for each measure.

Since:

0.8

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	View.AggregationWindow The time window for a View.
static class	View.Name The name of a View.

Method Summary

Modifier and Type	Method and Description
static View	create(View.Name name, String description, Measure measure, Aggregation aggregation, List<TagKey> columns, View.AggregationWindow window) Constructs a new View.
abstract Aggregation	getAggregation() The Aggregation associated with this View.
abstract List<TagKey>	getColumns() Columns (a.k.a Tag Keys) to match with the associated Measure.
abstract String	getDescription() More detailed description, for documentation purposes.
abstract Measure	getMeasure() Measure type of this view.
abstract View.Name	getName() Name of view.
abstract View.AggregationWindow	getWindow() Returns the time View.AggregationWindow for this View.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getName

public abstract View.Name getName()

Name of view. Must be unique.

Since:

0.8

getDescription

public abstract String getDescription()

More detailed description, for documentation purposes.

Since:

0.8

getMeasure

public abstract Measure getMeasure()

Measure type of this view.

Since:

0.8

getAggregation

public abstract Aggregation getAggregation()

The Aggregation associated with this View.

Since:

0.8

getColumns

public abstract List<TagKey> getColumns()

Columns (a.k.a Tag Keys) to match with the associated Measure.

Measure will be recorded in a "greedy" way. That is, every view aggregates every measure. This is similar to doing a GROUPBY on view’s columns. Columns must be unique.

Since:

0.8

getWindow

public abstract View.AggregationWindow getWindow()

Returns the time View.AggregationWindow for this View.

Returns:

the time View.AggregationWindow.

Since:

0.8

create

public static View create(View.Name name,
                          String description,
                          Measure measure,
                          Aggregation aggregation,
                          List<TagKey> columns,
                          View.AggregationWindow window)

Constructs a new View.

Parameters:

name - the View.Name of view. Must be unique.

description - the description of view.

measure - the Measure to be aggregated by this view.

aggregation - the basic Aggregation that this view will support.

columns - the TagKeys that this view will aggregate on. Columns should not contain duplicates.

window - the View.AggregationWindow of view.

Returns:

a new View.

Since:

0.8