mirror of
https://github.com/mollyim/webrtc.git
synced 2025-05-13 22:00:47 +01:00
13f4c896d5
This reverts commit 870bca1f41.
Reason for revert: it breaks internal tests and builds
Original change's description:
> Replace the usage of MetricsObserverInterface by RTC_HISTOGRAM_*.
>
> We now use RTC_HISTOGRAM_* macros in system_wrappers/include/metrics.h
> to report the metrics in pc/ and p2p/ that are currently been reported
> using MetricsObserverInterface.
>
> TBR=tommi@webrtc.org
>
> Bug: webrtc:9409
> Change-Id: I47c9975402293c72250203fa1ec19eb1668766f6
> Reviewed-on: https://webrtc-review.googlesource.com/83782
> Commit-Queue: Qingsi Wang <qingsi@google.com>
> Reviewed-by: Harald Alvestrand <hta@webrtc.org>
> Reviewed-by: Taylor (left Google) <deadbeef@webrtc.org>
> Reviewed-by: Steve Anton <steveanton@webrtc.org>
> Cr-Commit-Position: refs/heads/master@{#23914}
TBR=steveanton@webrtc.org,deadbeef@webrtc.org,hta@webrtc.org,tommi@webrtc.org
Change-Id: I1afd92d44f3b8cf3ae9aa6e6daa9a3a272e8097f
No-Presubmit: true
No-Tree-Checks: true
No-Try: true
Bug: webrtc:9409
Reviewed-on: https://webrtc-review.googlesource.com/88040
Reviewed-by: Qingsi Wang <qingsi@webrtc.org>
Commit-Queue: Qingsi Wang <qingsi@google.com>
Cr-Commit-Position: refs/heads/master@{#23916}
277 lines
12 KiB
C++
277 lines
12 KiB
C++
//
|
|
// Copyright (c) 2014 The WebRTC project authors. All Rights Reserved.
|
|
//
|
|
// Use of this source code is governed by a BSD-style license
|
|
// that can be found in the LICENSE file in the root of the source
|
|
// tree. An additional intellectual property rights grant can be found
|
|
// in the file PATENTS. All contributing project authors may
|
|
// be found in the AUTHORS file in the root of the source tree.
|
|
//
|
|
|
|
#ifndef SYSTEM_WRAPPERS_INCLUDE_METRICS_H_
|
|
#define SYSTEM_WRAPPERS_INCLUDE_METRICS_H_
|
|
|
|
#include <string>
|
|
|
|
#include "common_types.h" // NOLINT(build/include)
|
|
#include "rtc_base/atomicops.h"
|
|
#include "rtc_base/checks.h"
|
|
|
|
// Macros for allowing WebRTC clients (e.g. Chrome) to gather and aggregate
|
|
// statistics.
|
|
//
|
|
// Histogram for counters.
|
|
// RTC_HISTOGRAM_COUNTS(name, sample, min, max, bucket_count);
|
|
//
|
|
// Histogram for enumerators.
|
|
// The boundary should be above the max enumerator sample.
|
|
// RTC_HISTOGRAM_ENUMERATION(name, sample, boundary);
|
|
//
|
|
//
|
|
// The macros use the methods HistogramFactoryGetCounts,
|
|
// HistogramFactoryGetEnumeration and HistogramAdd.
|
|
//
|
|
// Therefore, WebRTC clients must either:
|
|
//
|
|
// - provide implementations of
|
|
// Histogram* webrtc::metrics::HistogramFactoryGetCounts(
|
|
// const std::string& name, int sample, int min, int max,
|
|
// int bucket_count);
|
|
// Histogram* webrtc::metrics::HistogramFactoryGetEnumeration(
|
|
// const std::string& name, int sample, int boundary);
|
|
// void webrtc::metrics::HistogramAdd(
|
|
// Histogram* histogram_pointer, const std::string& name, int sample);
|
|
//
|
|
// - or link with the default implementations (i.e.
|
|
// system_wrappers:metrics_default).
|
|
//
|
|
//
|
|
// Example usage:
|
|
//
|
|
// RTC_HISTOGRAM_COUNTS("WebRTC.Video.NacksSent", nacks_sent, 1, 100000, 100);
|
|
//
|
|
// enum Types {
|
|
// kTypeX,
|
|
// kTypeY,
|
|
// kBoundary,
|
|
// };
|
|
//
|
|
// RTC_HISTOGRAM_ENUMERATION("WebRTC.Types", kTypeX, kBoundary);
|
|
//
|
|
// NOTE: It is recommended to do the Chromium review for modifications to
|
|
// histograms.xml before new metrics are committed to WebRTC.
|
|
|
|
// Macros for adding samples to a named histogram.
|
|
|
|
// Histogram for counters (exponentially spaced buckets).
|
|
#define RTC_HISTOGRAM_COUNTS_100(name, sample) \
|
|
RTC_HISTOGRAM_COUNTS(name, sample, 1, 100, 50)
|
|
|
|
#define RTC_HISTOGRAM_COUNTS_200(name, sample) \
|
|
RTC_HISTOGRAM_COUNTS(name, sample, 1, 200, 50)
|
|
|
|
#define RTC_HISTOGRAM_COUNTS_500(name, sample) \
|
|
RTC_HISTOGRAM_COUNTS(name, sample, 1, 500, 50)
|
|
|
|
#define RTC_HISTOGRAM_COUNTS_1000(name, sample) \
|
|
RTC_HISTOGRAM_COUNTS(name, sample, 1, 1000, 50)
|
|
|
|
#define RTC_HISTOGRAM_COUNTS_10000(name, sample) \
|
|
RTC_HISTOGRAM_COUNTS(name, sample, 1, 10000, 50)
|
|
|
|
#define RTC_HISTOGRAM_COUNTS_100000(name, sample) \
|
|
RTC_HISTOGRAM_COUNTS(name, sample, 1, 100000, 50)
|
|
|
|
#define RTC_HISTOGRAM_COUNTS(name, sample, min, max, bucket_count) \
|
|
RTC_HISTOGRAM_COMMON_BLOCK(name, sample, \
|
|
webrtc::metrics::HistogramFactoryGetCounts( \
|
|
name, min, max, bucket_count))
|
|
|
|
#define RTC_HISTOGRAM_COUNTS_LINEAR(name, sample, min, max, bucket_count) \
|
|
RTC_HISTOGRAM_COMMON_BLOCK(name, sample, \
|
|
webrtc::metrics::HistogramFactoryGetCountsLinear( \
|
|
name, min, max, bucket_count))
|
|
|
|
// Slow metrics: pointer to metric is acquired at each call and is not cached.
|
|
//
|
|
#define RTC_HISTOGRAM_COUNTS_SPARSE_100(name, sample) \
|
|
RTC_HISTOGRAM_COUNTS_SPARSE(name, sample, 1, 100, 50)
|
|
|
|
#define RTC_HISTOGRAM_COUNTS_SPARSE_200(name, sample) \
|
|
RTC_HISTOGRAM_COUNTS_SPARSE(name, sample, 1, 200, 50)
|
|
|
|
#define RTC_HISTOGRAM_COUNTS_SPARSE_500(name, sample) \
|
|
RTC_HISTOGRAM_COUNTS_SPARSE(name, sample, 1, 500, 50)
|
|
|
|
#define RTC_HISTOGRAM_COUNTS_SPARSE_1000(name, sample) \
|
|
RTC_HISTOGRAM_COUNTS_SPARSE(name, sample, 1, 1000, 50)
|
|
|
|
#define RTC_HISTOGRAM_COUNTS_SPARSE_10000(name, sample) \
|
|
RTC_HISTOGRAM_COUNTS_SPARSE(name, sample, 1, 10000, 50)
|
|
|
|
#define RTC_HISTOGRAM_COUNTS_SPARSE_100000(name, sample) \
|
|
RTC_HISTOGRAM_COUNTS_SPARSE(name, sample, 1, 100000, 50)
|
|
|
|
#define RTC_HISTOGRAM_COUNTS_SPARSE(name, sample, min, max, bucket_count) \
|
|
RTC_HISTOGRAM_COMMON_BLOCK_SLOW(name, sample, \
|
|
webrtc::metrics::HistogramFactoryGetCounts( \
|
|
name, min, max, bucket_count))
|
|
|
|
// Histogram for percentage (evenly spaced buckets).
|
|
#define RTC_HISTOGRAM_PERCENTAGE_SPARSE(name, sample) \
|
|
RTC_HISTOGRAM_ENUMERATION_SPARSE(name, sample, 101)
|
|
|
|
// Histogram for booleans.
|
|
#define RTC_HISTOGRAM_BOOLEAN_SPARSE(name, sample) \
|
|
RTC_HISTOGRAM_ENUMERATION_SPARSE(name, sample, 2)
|
|
|
|
// Histogram for enumerators (evenly spaced buckets).
|
|
// |boundary| should be above the max enumerator sample.
|
|
#define RTC_HISTOGRAM_ENUMERATION_SPARSE(name, sample, boundary) \
|
|
RTC_HISTOGRAM_COMMON_BLOCK( \
|
|
name, sample, \
|
|
webrtc::metrics::SparseHistogramFactoryGetEnumeration(name, boundary))
|
|
|
|
// Histogram for percentage (evenly spaced buckets).
|
|
#define RTC_HISTOGRAM_PERCENTAGE(name, sample) \
|
|
RTC_HISTOGRAM_ENUMERATION(name, sample, 101)
|
|
|
|
// Histogram for booleans.
|
|
#define RTC_HISTOGRAM_BOOLEAN(name, sample) \
|
|
RTC_HISTOGRAM_ENUMERATION(name, sample, 2)
|
|
|
|
// Histogram for enumerators (evenly spaced buckets).
|
|
// |boundary| should be above the max enumerator sample.
|
|
#define RTC_HISTOGRAM_ENUMERATION(name, sample, boundary) \
|
|
RTC_HISTOGRAM_COMMON_BLOCK( \
|
|
name, sample, \
|
|
webrtc::metrics::HistogramFactoryGetEnumeration(name, boundary))
|
|
|
|
// The name of the histogram should not vary.
|
|
// TODO(asapersson): Consider changing string to const char*.
|
|
#define RTC_HISTOGRAM_COMMON_BLOCK(constant_name, sample, \
|
|
factory_get_invocation) \
|
|
do { \
|
|
static webrtc::metrics::Histogram* atomic_histogram_pointer = nullptr; \
|
|
webrtc::metrics::Histogram* histogram_pointer = \
|
|
rtc::AtomicOps::AcquireLoadPtr(&atomic_histogram_pointer); \
|
|
if (!histogram_pointer) { \
|
|
histogram_pointer = factory_get_invocation; \
|
|
webrtc::metrics::Histogram* prev_pointer = \
|
|
rtc::AtomicOps::CompareAndSwapPtr( \
|
|
&atomic_histogram_pointer, \
|
|
static_cast<webrtc::metrics::Histogram*>(nullptr), \
|
|
histogram_pointer); \
|
|
RTC_DCHECK(prev_pointer == nullptr || \
|
|
prev_pointer == histogram_pointer); \
|
|
} \
|
|
if (histogram_pointer) { \
|
|
webrtc::metrics::HistogramAdd(histogram_pointer, sample); \
|
|
} \
|
|
} while (0)
|
|
|
|
// Deprecated.
|
|
// The histogram is constructed/found for each call.
|
|
// May be used for histograms with infrequent updates.`
|
|
#define RTC_HISTOGRAM_COMMON_BLOCK_SLOW(name, sample, factory_get_invocation) \
|
|
do { \
|
|
webrtc::metrics::Histogram* histogram_pointer = factory_get_invocation; \
|
|
if (histogram_pointer) { \
|
|
webrtc::metrics::HistogramAdd(histogram_pointer, sample); \
|
|
} \
|
|
} while (0)
|
|
|
|
// Helper macros.
|
|
// Macros for calling a histogram with varying name (e.g. when using a metric
|
|
// in different modes such as real-time vs screenshare). Fast, because pointer
|
|
// is cached. |index| should be different for different names. Allowed |index|
|
|
// values are 0, 1, and 2.
|
|
#define RTC_HISTOGRAMS_COUNTS_100(index, name, sample) \
|
|
RTC_HISTOGRAMS_COMMON(index, name, sample, \
|
|
RTC_HISTOGRAM_COUNTS(name, sample, 1, 100, 50))
|
|
|
|
#define RTC_HISTOGRAMS_COUNTS_200(index, name, sample) \
|
|
RTC_HISTOGRAMS_COMMON(index, name, sample, \
|
|
RTC_HISTOGRAM_COUNTS(name, sample, 1, 200, 50))
|
|
|
|
#define RTC_HISTOGRAMS_COUNTS_500(index, name, sample) \
|
|
RTC_HISTOGRAMS_COMMON(index, name, sample, \
|
|
RTC_HISTOGRAM_COUNTS(name, sample, 1, 500, 50))
|
|
|
|
#define RTC_HISTOGRAMS_COUNTS_1000(index, name, sample) \
|
|
RTC_HISTOGRAMS_COMMON(index, name, sample, \
|
|
RTC_HISTOGRAM_COUNTS(name, sample, 1, 1000, 50))
|
|
|
|
#define RTC_HISTOGRAMS_COUNTS_10000(index, name, sample) \
|
|
RTC_HISTOGRAMS_COMMON(index, name, sample, \
|
|
RTC_HISTOGRAM_COUNTS(name, sample, 1, 10000, 50))
|
|
|
|
#define RTC_HISTOGRAMS_COUNTS_100000(index, name, sample) \
|
|
RTC_HISTOGRAMS_COMMON(index, name, sample, \
|
|
RTC_HISTOGRAM_COUNTS(name, sample, 1, 100000, 50))
|
|
|
|
#define RTC_HISTOGRAMS_ENUMERATION(index, name, sample, boundary) \
|
|
RTC_HISTOGRAMS_COMMON(index, name, sample, \
|
|
RTC_HISTOGRAM_ENUMERATION(name, sample, boundary))
|
|
|
|
#define RTC_HISTOGRAMS_PERCENTAGE(index, name, sample) \
|
|
RTC_HISTOGRAMS_COMMON(index, name, sample, \
|
|
RTC_HISTOGRAM_PERCENTAGE(name, sample))
|
|
|
|
#define RTC_HISTOGRAMS_COMMON(index, name, sample, macro_invocation) \
|
|
do { \
|
|
switch (index) { \
|
|
case 0: \
|
|
macro_invocation; \
|
|
break; \
|
|
case 1: \
|
|
macro_invocation; \
|
|
break; \
|
|
case 2: \
|
|
macro_invocation; \
|
|
break; \
|
|
default: \
|
|
RTC_NOTREACHED(); \
|
|
} \
|
|
} while (0)
|
|
|
|
namespace webrtc {
|
|
namespace metrics {
|
|
|
|
// Time that should have elapsed for stats that are gathered once per call.
|
|
enum { kMinRunTimeInSeconds = 10 };
|
|
|
|
class Histogram;
|
|
|
|
// Functions for getting pointer to histogram (constructs or finds the named
|
|
// histogram).
|
|
|
|
// Get histogram for counters.
|
|
Histogram* HistogramFactoryGetCounts(const std::string& name,
|
|
int min,
|
|
int max,
|
|
int bucket_count);
|
|
|
|
// Get histogram for counters with linear bucket spacing.
|
|
Histogram* HistogramFactoryGetCountsLinear(const std::string& name,
|
|
int min,
|
|
int max,
|
|
int bucket_count);
|
|
|
|
// Get histogram for enumerators.
|
|
// |boundary| should be above the max enumerator sample.
|
|
Histogram* HistogramFactoryGetEnumeration(const std::string& name,
|
|
int boundary);
|
|
|
|
// Get sparse histogram for enumerators.
|
|
// |boundary| should be above the max enumerator sample.
|
|
Histogram* SparseHistogramFactoryGetEnumeration(const std::string& name,
|
|
int boundary);
|
|
|
|
// Function for adding a |sample| to a histogram.
|
|
void HistogramAdd(Histogram* histogram_pointer, int sample);
|
|
|
|
} // namespace metrics
|
|
} // namespace webrtc
|
|
|
|
#endif // SYSTEM_WRAPPERS_INCLUDE_METRICS_H_
|