# tf.data.experimental.StatsAggregator

<br />

|---|---|
| [![](https://www.tensorflow.org/images/tf_logo_32px.png) TensorFlow 1 version](https://www.tensorflow.org/versions/r1.15/api_docs/python/tf/data/experimental/StatsAggregator) | [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/tensorflow/tensorflow/blob/v2.1.0/tensorflow/python/data/experimental/ops/stats_aggregator.py#L31-L78) |

A stateful resource that aggregates statistics from one or more iterators.

    tf.data.experimental.StatsAggregator()

To record statistics, use one of the custom transformation functions defined
in this module when defining your [`tf.data.Dataset`](https://www.tensorflow.org/versions/r2.1/api_docs/python/tf/data/Dataset). All statistics will be
aggregated by the `StatsAggregator` that is associated with a particular
iterator (see below). For example, to record the latency of producing each
element by iterating over a dataset:

    dataset = ...
    dataset = dataset.apply(tf.data.experimental.latency_stats("total_bytes"))

To associate a `StatsAggregator` with a [`tf.data.Dataset`](https://www.tensorflow.org/versions/r2.1/api_docs/python/tf/data/Dataset) object, use
the following pattern:

    aggregator = tf.data.experimental.StatsAggregator()
    dataset = ...

    # Apply `StatsOptions` to associate `dataset` with `aggregator`.
    options = tf.data.Options()
    options.experimental_stats.aggregator = aggregator
    dataset = dataset.with_options(options)

> [!NOTE]
> **Note:** This interface is experimental and expected to change. In particular, we expect to add other implementations of `StatsAggregator` that provide different ways of exporting statistics, and add more types of statistics.