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 Deprecated. since 0.13. In the future all Views will be cumulative.
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) Constructs a new View.
static View	create(View.Name name, String description, Measure measure, Aggregation aggregation, List<TagKey> columns, View.AggregationWindow window) Deprecated. in favor of create(Name, String, Measure, Aggregation, List).
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() Deprecated. since 0.13. In the future all Views will be cumulative.

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

@Deprecated
public abstract View.AggregationWindow getWindow()

Deprecated. since 0.13. In the future all Views will be cumulative.

Returns the time View.AggregationWindow for this View.

Returns:

the time View.AggregationWindow.

Since:

0.8

create

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

Deprecated. in favor of create(Name, String, Measure, Aggregation, List).

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

create

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

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.

Returns:

a new View.

Since:

0.13