apache_beam.metrics.metric module

User-facing classes for Metrics API.

The classes in this file allow users to define and use metrics to be collected and displayed as part of their pipeline execution.

• Metrics - This class lets pipeline and transform writers create and access

  metric objects such as counters, distributions, etc.

class apache_beam.metrics.metric.Metrics

Bases: object

Lets users create/access metric objects during pipeline execution.

static get_namespace(namespace)

static counter(namespace, name)

Obtains or creates a Counter metric.

Parameters:

• namespace – A class or string that gives the namespace to a metric
• name – A string that gives a unique name to a metric

Returns:

A Counter object.

static distribution(namespace, name)

Obtains or creates a Distribution metric.

Distribution metrics are restricted to integer-only distributions.

Parameters:

• namespace – A class or string that gives the namespace to a metric
• name – A string that gives a unique name to a metric

Returns:

A Distribution object.

class DelegatingCounter(metric_name)

Bases: apache_beam.metrics.metricbase.Counter

inc(n=1)

class DelegatingDistribution(metric_name)

Bases: apache_beam.metrics.metricbase.Distribution

update(value)

class apache_beam.metrics.metric.MetricsFilter

Bases: object

Simple object to filter metrics results.

This class is experimental. No backwards-compatibility guarantees.

If filters by matching a result’s step-namespace-name with three internal sets. No execution/matching logic is added to this object, so that it may be used to construct arguments as an RPC request. It is left for runners to implement matching logic by themselves.

steps

names

namespaces

with_name(name)

with_names(names)

with_namespace(namespace)

with_namespaces(namespaces)

with_step(step)

with_steps(steps)