blob: a4126bc921c513cd7c093f7233e133da8b3c507c [file] [log] [blame]
terelius54ce6802016-07-13 06:44:41 -07001/*
2 * Copyright (c) 2016 The WebRTC project authors. All Rights Reserved.
3 *
4 * Use of this source code is governed by a BSD-style license
5 * that can be found in the LICENSE file in the root of the source
6 * tree. An additional intellectual property rights grant can be found
7 * in the file PATENTS. All contributing project authors may
8 * be found in the AUTHORS file in the root of the source tree.
9 */
10
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020011#include "rtc_tools/event_log_visualizer/analyzer.h"
terelius54ce6802016-07-13 06:44:41 -070012
13#include <algorithm>
Oleh Prypin6581f212017-11-16 00:17:05 +010014#include <cmath>
terelius54ce6802016-07-13 06:44:41 -070015#include <limits>
16#include <map>
terelius54ce6802016-07-13 06:44:41 -070017#include <string>
18#include <utility>
19
Karl Wiberg918f50c2018-07-05 11:40:33 +020020#include "absl/memory/memory.h"
Bjorn Terelius6c4b1b72019-01-11 13:01:29 +010021#include "absl/strings/string_view.h"
Sebastian Jansson95edb032019-01-17 16:24:12 +010022#include "api/transport/field_trial_based_config.h"
Sebastian Jansson5c94f552018-10-15 18:46:51 +020023#include "api/transport/goog_cc_factory.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020024#include "call/audio_receive_stream.h"
25#include "call/audio_send_stream.h"
26#include "call/call.h"
27#include "call/video_receive_stream.h"
28#include "call/video_send_stream.h"
Mirko Bonadei71207422017-09-15 13:58:09 +020029#include "common_types.h" // NOLINT(build/include)
Elad Alon99a81b62017-09-21 10:25:29 +020030#include "logging/rtc_event_log/rtc_stream_config.h"
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +020031#include "modules/audio_coding/audio_network_adaptor/include/audio_network_adaptor.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020032#include "modules/audio_coding/neteq/tools/audio_sink.h"
33#include "modules/audio_coding/neteq/tools/fake_decode_from_file.h"
34#include "modules/audio_coding/neteq/tools/neteq_delay_analyzer.h"
35#include "modules/audio_coding/neteq/tools/neteq_replacement_input.h"
36#include "modules/audio_coding/neteq/tools/neteq_test.h"
37#include "modules/audio_coding/neteq/tools/resample_input_audio_file.h"
Sebastian Jansson172fd852018-05-24 14:17:06 +020038#include "modules/congestion_controller/goog_cc/acknowledged_bitrate_estimator.h"
39#include "modules/congestion_controller/goog_cc/bitrate_estimator.h"
Sebastian Jansson04b18cb2018-07-02 09:25:25 +020040#include "modules/congestion_controller/goog_cc/delay_based_bwe.h"
Bjorn Terelius28db2662017-10-04 14:22:43 +020041#include "modules/congestion_controller/include/receive_side_congestion_controller.h"
Sebastian Jansson5c94f552018-10-15 18:46:51 +020042#include "modules/congestion_controller/rtp/transport_feedback_adapter.h"
Niels Möllerfd6c0912017-10-31 10:19:10 +010043#include "modules/pacing/packet_router.h"
Sebastian Jansson5c94f552018-10-15 18:46:51 +020044#include "modules/remote_bitrate_estimator/include/bwe_defines.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020045#include "modules/rtp_rtcp/include/rtp_rtcp.h"
46#include "modules/rtp_rtcp/include/rtp_rtcp_defines.h"
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +020047#include "modules/rtp_rtcp/source/rtcp_packet.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020048#include "modules/rtp_rtcp/source/rtcp_packet/common_header.h"
49#include "modules/rtp_rtcp/source/rtcp_packet/receiver_report.h"
50#include "modules/rtp_rtcp/source/rtcp_packet/remb.h"
51#include "modules/rtp_rtcp/source/rtcp_packet/sender_report.h"
52#include "modules/rtp_rtcp/source/rtcp_packet/transport_feedback.h"
53#include "modules/rtp_rtcp/source/rtp_header_extensions.h"
54#include "modules/rtp_rtcp/source/rtp_utility.h"
55#include "rtc_base/checks.h"
56#include "rtc_base/format_macros.h"
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +020057#include "rtc_base/function_view.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020058#include "rtc_base/logging.h"
Bjorn Terelius0295a962017-10-25 17:42:41 +020059#include "rtc_base/numerics/sequence_number_util.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020060#include "rtc_base/rate_statistics.h"
Jonas Olsson366a50c2018-09-06 13:41:30 +020061#include "rtc_base/strings/string_builder.h"
terelius54ce6802016-07-13 06:44:41 -070062
Bjorn Terelius6984ad22017-10-24 12:19:45 +020063#ifndef BWE_TEST_LOGGING_COMPILE_TIME_ENABLE
64#define BWE_TEST_LOGGING_COMPILE_TIME_ENABLE 0
65#endif // BWE_TEST_LOGGING_COMPILE_TIME_ENABLE
66
tereliusdc35dcd2016-08-01 12:03:27 -070067namespace webrtc {
tereliusdc35dcd2016-08-01 12:03:27 -070068
terelius54ce6802016-07-13 06:44:41 -070069namespace {
70
Qingsi Wang8eca1ff2018-02-02 11:49:44 -080071const int kNumMicrosecsPerSec = 1000000;
72
elad.alonec304f92017-03-08 05:03:53 -080073void SortPacketFeedbackVector(std::vector<PacketFeedback>* vec) {
74 auto pred = [](const PacketFeedback& packet_feedback) {
75 return packet_feedback.arrival_time_ms == PacketFeedback::kNotReceived;
76 };
77 vec->erase(std::remove_if(vec->begin(), vec->end(), pred), vec->end());
78 std::sort(vec->begin(), vec->end(), PacketFeedbackComparator());
79}
80
terelius54ce6802016-07-13 06:44:41 -070081std::string SsrcToString(uint32_t ssrc) {
Jonas Olsson366a50c2018-09-06 13:41:30 +020082 rtc::StringBuilder ss;
terelius54ce6802016-07-13 06:44:41 -070083 ss << "SSRC " << ssrc;
Jonas Olsson84df1c72018-09-14 16:59:32 +020084 return ss.Release();
terelius54ce6802016-07-13 06:44:41 -070085}
86
87// Checks whether an SSRC is contained in the list of desired SSRCs.
88// Note that an empty SSRC list matches every SSRC.
89bool MatchingSsrc(uint32_t ssrc, const std::vector<uint32_t>& desired_ssrc) {
90 if (desired_ssrc.size() == 0)
91 return true;
92 return std::find(desired_ssrc.begin(), desired_ssrc.end(), ssrc) !=
93 desired_ssrc.end();
94}
95
96double AbsSendTimeToMicroseconds(int64_t abs_send_time) {
97 // The timestamp is a fixed point representation with 6 bits for seconds
98 // and 18 bits for fractions of a second. Thus, we divide by 2^18 to get the
Qingsi Wang8eca1ff2018-02-02 11:49:44 -080099 // time in seconds and then multiply by kNumMicrosecsPerSec to convert to
100 // microseconds.
terelius54ce6802016-07-13 06:44:41 -0700101 static constexpr double kTimestampToMicroSec =
Qingsi Wang8eca1ff2018-02-02 11:49:44 -0800102 static_cast<double>(kNumMicrosecsPerSec) / static_cast<double>(1ul << 18);
terelius54ce6802016-07-13 06:44:41 -0700103 return abs_send_time * kTimestampToMicroSec;
104}
105
106// Computes the difference |later| - |earlier| where |later| and |earlier|
107// are counters that wrap at |modulus|. The difference is chosen to have the
108// least absolute value. For example if |modulus| is 8, then the difference will
109// be chosen in the range [-3, 4]. If |modulus| is 9, then the difference will
110// be in [-4, 4].
111int64_t WrappingDifference(uint32_t later, uint32_t earlier, int64_t modulus) {
112 RTC_DCHECK_LE(1, modulus);
113 RTC_DCHECK_LT(later, modulus);
114 RTC_DCHECK_LT(earlier, modulus);
115 int64_t difference =
116 static_cast<int64_t>(later) - static_cast<int64_t>(earlier);
117 int64_t max_difference = modulus / 2;
118 int64_t min_difference = max_difference - modulus + 1;
119 if (difference > max_difference) {
120 difference -= modulus;
121 }
122 if (difference < min_difference) {
123 difference += modulus;
124 }
terelius6addf492016-08-23 17:34:07 -0700125 if (difference > max_difference / 2 || difference < min_difference / 2) {
Mirko Bonadei675513b2017-11-09 11:09:25 +0100126 RTC_LOG(LS_WARNING) << "Difference between" << later << " and " << earlier
127 << " expected to be in the range ("
128 << min_difference / 2 << "," << max_difference / 2
129 << ") but is " << difference
130 << ". Correct unwrapping is uncertain.";
terelius6addf492016-08-23 17:34:07 -0700131 }
terelius54ce6802016-07-13 06:44:41 -0700132 return difference;
133}
134
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200135// This is much more reliable for outgoing streams than for incoming streams.
136template <typename RtpPacketContainer>
Danil Chapovalov431abd92018-06-18 12:54:17 +0200137absl::optional<uint32_t> EstimateRtpClockFrequency(
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200138 const RtpPacketContainer& packets,
139 int64_t end_time_us) {
140 RTC_CHECK(packets.size() >= 2);
141 SeqNumUnwrapper<uint32_t> unwrapper;
142 uint64_t first_rtp_timestamp =
143 unwrapper.Unwrap(packets[0].rtp.header.timestamp);
144 int64_t first_log_timestamp = packets[0].log_time_us();
145 uint64_t last_rtp_timestamp = first_rtp_timestamp;
146 int64_t last_log_timestamp = first_log_timestamp;
147 for (size_t i = 1; i < packets.size(); i++) {
148 if (packets[i].log_time_us() > end_time_us)
149 break;
150 last_rtp_timestamp = unwrapper.Unwrap(packets[i].rtp.header.timestamp);
151 last_log_timestamp = packets[i].log_time_us();
152 }
153 if (last_log_timestamp - first_log_timestamp < kNumMicrosecsPerSec) {
154 RTC_LOG(LS_WARNING)
155 << "Failed to estimate RTP clock frequency: Stream too short. ("
156 << packets.size() << " packets, "
157 << last_log_timestamp - first_log_timestamp << " us)";
Danil Chapovalov431abd92018-06-18 12:54:17 +0200158 return absl::nullopt;
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200159 }
160 double duration =
161 static_cast<double>(last_log_timestamp - first_log_timestamp) /
162 kNumMicrosecsPerSec;
163 double estimated_frequency =
164 (last_rtp_timestamp - first_rtp_timestamp) / duration;
165 for (uint32_t f : {8000, 16000, 32000, 48000, 90000}) {
166 if (std::fabs(estimated_frequency - f) < 0.05 * f) {
167 return f;
168 }
169 }
170 RTC_LOG(LS_WARNING) << "Failed to estimate RTP clock frequency: Estimate "
171 << estimated_frequency
172 << "not close to any stardard RTP frequency.";
Danil Chapovalov431abd92018-06-18 12:54:17 +0200173 return absl::nullopt;
ivocaac9d6f2016-09-22 07:01:47 -0700174}
175
tereliusdc35dcd2016-08-01 12:03:27 -0700176constexpr float kLeftMargin = 0.01f;
177constexpr float kRightMargin = 0.02f;
178constexpr float kBottomMargin = 0.02f;
179constexpr float kTopMargin = 0.05f;
terelius54ce6802016-07-13 06:44:41 -0700180
Danil Chapovalov431abd92018-06-18 12:54:17 +0200181absl::optional<double> NetworkDelayDiff_AbsSendTime(
Bjorn Terelius6c373cc2018-11-01 14:31:10 +0100182 const LoggedRtpPacketIncoming& old_packet,
183 const LoggedRtpPacketIncoming& new_packet) {
184 if (old_packet.rtp.header.extension.hasAbsoluteSendTime &&
185 new_packet.rtp.header.extension.hasAbsoluteSendTime) {
terelius53dc23c2017-03-13 05:24:05 -0700186 int64_t send_time_diff = WrappingDifference(
Bjorn Terelius6c373cc2018-11-01 14:31:10 +0100187 new_packet.rtp.header.extension.absoluteSendTime,
188 old_packet.rtp.header.extension.absoluteSendTime, 1ul << 24);
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200189 int64_t recv_time_diff =
190 new_packet.log_time_us() - old_packet.log_time_us();
terelius53dc23c2017-03-13 05:24:05 -0700191 double delay_change_us =
192 recv_time_diff - AbsSendTimeToMicroseconds(send_time_diff);
Oskar Sundbom3928dbc2017-11-16 10:53:09 +0100193 return delay_change_us / 1000;
terelius53dc23c2017-03-13 05:24:05 -0700194 } else {
Danil Chapovalov431abd92018-06-18 12:54:17 +0200195 return absl::nullopt;
terelius6addf492016-08-23 17:34:07 -0700196 }
197}
198
Danil Chapovalov431abd92018-06-18 12:54:17 +0200199absl::optional<double> NetworkDelayDiff_CaptureTime(
Bjorn Terelius6c373cc2018-11-01 14:31:10 +0100200 const LoggedRtpPacketIncoming& old_packet,
201 const LoggedRtpPacketIncoming& new_packet,
202 const double sample_rate) {
203 int64_t send_time_diff =
204 WrappingDifference(new_packet.rtp.header.timestamp,
205 old_packet.rtp.header.timestamp, 1ull << 32);
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200206 int64_t recv_time_diff = new_packet.log_time_us() - old_packet.log_time_us();
terelius53dc23c2017-03-13 05:24:05 -0700207
terelius53dc23c2017-03-13 05:24:05 -0700208 double delay_change =
209 static_cast<double>(recv_time_diff) / 1000 -
Bjorn Terelius6c373cc2018-11-01 14:31:10 +0100210 static_cast<double>(send_time_diff) / sample_rate * 1000;
terelius53dc23c2017-03-13 05:24:05 -0700211 if (delay_change < -10000 || 10000 < delay_change) {
Mirko Bonadei675513b2017-11-09 11:09:25 +0100212 RTC_LOG(LS_WARNING) << "Very large delay change. Timestamps correct?";
Bjorn Terelius6c373cc2018-11-01 14:31:10 +0100213 RTC_LOG(LS_WARNING) << "Old capture time "
214 << old_packet.rtp.header.timestamp << ", received time "
215 << old_packet.log_time_us();
216 RTC_LOG(LS_WARNING) << "New capture time "
217 << new_packet.rtp.header.timestamp << ", received time "
218 << new_packet.log_time_us();
Mirko Bonadei675513b2017-11-09 11:09:25 +0100219 RTC_LOG(LS_WARNING) << "Receive time difference " << recv_time_diff << " = "
Qingsi Wang8eca1ff2018-02-02 11:49:44 -0800220 << static_cast<double>(recv_time_diff) /
221 kNumMicrosecsPerSec
222 << "s";
Mirko Bonadei675513b2017-11-09 11:09:25 +0100223 RTC_LOG(LS_WARNING) << "Send time difference " << send_time_diff << " = "
Bjorn Terelius6c373cc2018-11-01 14:31:10 +0100224 << static_cast<double>(send_time_diff) / sample_rate
Mirko Bonadei675513b2017-11-09 11:09:25 +0100225 << "s";
terelius53dc23c2017-03-13 05:24:05 -0700226 }
Oskar Sundbom3928dbc2017-11-16 10:53:09 +0100227 return delay_change;
terelius53dc23c2017-03-13 05:24:05 -0700228}
229
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200230// For each element in data_view, use |f()| to extract a y-coordinate and
terelius53dc23c2017-03-13 05:24:05 -0700231// store the result in a TimeSeries.
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200232template <typename DataType, typename IterableType>
Stefan Holmer1d4a2272018-05-24 13:48:09 +0200233void ProcessPoints(rtc::FunctionView<float(const DataType&)> fx,
Danil Chapovalov431abd92018-06-18 12:54:17 +0200234 rtc::FunctionView<absl::optional<float>(const DataType&)> fy,
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200235 const IterableType& data_view,
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200236 TimeSeries* result) {
237 for (size_t i = 0; i < data_view.size(); i++) {
238 const DataType& elem = data_view[i];
Stefan Holmer1d4a2272018-05-24 13:48:09 +0200239 float x = fx(elem);
Danil Chapovalov431abd92018-06-18 12:54:17 +0200240 absl::optional<float> y = fy(elem);
terelius53dc23c2017-03-13 05:24:05 -0700241 if (y)
242 result->points.emplace_back(x, *y);
243 }
244}
245
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200246// For each pair of adjacent elements in |data|, use |f()| to extract a
terelius6addf492016-08-23 17:34:07 -0700247// y-coordinate and store the result in a TimeSeries. Note that the x-coordinate
248// will be the time of the second element in the pair.
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200249template <typename DataType, typename ResultType, typename IterableType>
terelius53dc23c2017-03-13 05:24:05 -0700250void ProcessPairs(
Stefan Holmer1d4a2272018-05-24 13:48:09 +0200251 rtc::FunctionView<float(const DataType&)> fx,
Danil Chapovalov431abd92018-06-18 12:54:17 +0200252 rtc::FunctionView<absl::optional<ResultType>(const DataType&,
253 const DataType&)> fy,
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200254 const IterableType& data,
terelius53dc23c2017-03-13 05:24:05 -0700255 TimeSeries* result) {
tereliusccbbf8d2016-08-10 07:34:28 -0700256 for (size_t i = 1; i < data.size(); i++) {
Stefan Holmer1d4a2272018-05-24 13:48:09 +0200257 float x = fx(data[i]);
Danil Chapovalov431abd92018-06-18 12:54:17 +0200258 absl::optional<ResultType> y = fy(data[i - 1], data[i]);
terelius53dc23c2017-03-13 05:24:05 -0700259 if (y)
260 result->points.emplace_back(x, static_cast<float>(*y));
261 }
262}
263
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200264// For each pair of adjacent elements in |data|, use |f()| to extract a
terelius53dc23c2017-03-13 05:24:05 -0700265// y-coordinate and store the result in a TimeSeries. Note that the x-coordinate
266// will be the time of the second element in the pair.
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200267template <typename DataType, typename ResultType, typename IterableType>
terelius53dc23c2017-03-13 05:24:05 -0700268void AccumulatePairs(
Stefan Holmer1d4a2272018-05-24 13:48:09 +0200269 rtc::FunctionView<float(const DataType&)> fx,
Danil Chapovalov431abd92018-06-18 12:54:17 +0200270 rtc::FunctionView<absl::optional<ResultType>(const DataType&,
271 const DataType&)> fy,
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200272 const IterableType& data,
terelius53dc23c2017-03-13 05:24:05 -0700273 TimeSeries* result) {
274 ResultType sum = 0;
275 for (size_t i = 1; i < data.size(); i++) {
Stefan Holmer1d4a2272018-05-24 13:48:09 +0200276 float x = fx(data[i]);
Danil Chapovalov431abd92018-06-18 12:54:17 +0200277 absl::optional<ResultType> y = fy(data[i - 1], data[i]);
Bjorn Terelius6c373cc2018-11-01 14:31:10 +0100278 if (y) {
terelius53dc23c2017-03-13 05:24:05 -0700279 sum += *y;
Bjorn Terelius6c373cc2018-11-01 14:31:10 +0100280 result->points.emplace_back(x, static_cast<float>(sum));
281 }
tereliusccbbf8d2016-08-10 07:34:28 -0700282 }
283}
284
terelius6addf492016-08-23 17:34:07 -0700285// Calculates a moving average of |data| and stores the result in a TimeSeries.
286// A data point is generated every |step| microseconds from |begin_time|
287// to |end_time|. The value of each data point is the average of the data
288// during the preceeding |window_duration_us| microseconds.
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200289template <typename DataType, typename ResultType, typename IterableType>
terelius53dc23c2017-03-13 05:24:05 -0700290void MovingAverage(
Danil Chapovalov431abd92018-06-18 12:54:17 +0200291 rtc::FunctionView<absl::optional<ResultType>(const DataType&)> fy,
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200292 const IterableType& data_view,
Bjorn Terelius068fc352019-02-13 22:38:25 +0100293 AnalyzerConfig config,
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200294 TimeSeries* result) {
terelius6addf492016-08-23 17:34:07 -0700295 size_t window_index_begin = 0;
296 size_t window_index_end = 0;
terelius53dc23c2017-03-13 05:24:05 -0700297 ResultType sum_in_window = 0;
terelius6addf492016-08-23 17:34:07 -0700298
Bjorn Terelius068fc352019-02-13 22:38:25 +0100299 for (int64_t t = config.begin_time_; t < config.end_time_ + config.step_;
300 t += config.step_) {
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200301 while (window_index_end < data_view.size() &&
302 data_view[window_index_end].log_time_us() < t) {
Danil Chapovalov431abd92018-06-18 12:54:17 +0200303 absl::optional<ResultType> value = fy(data_view[window_index_end]);
terelius53dc23c2017-03-13 05:24:05 -0700304 if (value)
305 sum_in_window += *value;
terelius6addf492016-08-23 17:34:07 -0700306 ++window_index_end;
307 }
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200308 while (window_index_begin < data_view.size() &&
309 data_view[window_index_begin].log_time_us() <
Bjorn Terelius068fc352019-02-13 22:38:25 +0100310 t - config.window_duration_) {
Danil Chapovalov431abd92018-06-18 12:54:17 +0200311 absl::optional<ResultType> value = fy(data_view[window_index_begin]);
terelius53dc23c2017-03-13 05:24:05 -0700312 if (value)
313 sum_in_window -= *value;
terelius6addf492016-08-23 17:34:07 -0700314 ++window_index_begin;
315 }
Qingsi Wang8eca1ff2018-02-02 11:49:44 -0800316 float window_duration_s =
Bjorn Terelius068fc352019-02-13 22:38:25 +0100317 static_cast<float>(config.window_duration_) / kNumMicrosecsPerSec;
318 float x = config.GetCallTimeSec(t);
terelius53dc23c2017-03-13 05:24:05 -0700319 float y = sum_in_window / window_duration_s;
terelius6addf492016-08-23 17:34:07 -0700320 result->points.emplace_back(x, y);
321 }
322}
323
Bjorn Terelius7c974e62019-02-15 17:20:12 +0100324template <typename T>
325TimeSeries CreateRtcpTypeTimeSeries(const std::vector<T>& rtcp_list,
326 AnalyzerConfig config,
327 std::string rtcp_name,
328 int category_id) {
329 TimeSeries time_series(rtcp_name, LineStyle::kNone, PointStyle::kHighlight);
330 for (const auto& rtcp : rtcp_list) {
331 float x = config.GetCallTimeSec(rtcp.log_time_us());
332 float y = category_id;
333 time_series.points.emplace_back(x, y);
334 }
335 return time_series;
336}
337
Qingsi Wang8eca1ff2018-02-02 11:49:44 -0800338const char kUnknownEnumValue[] = "unknown";
339
340const char kIceCandidateTypeLocal[] = "local";
341const char kIceCandidateTypeStun[] = "stun";
342const char kIceCandidateTypePrflx[] = "prflx";
343const char kIceCandidateTypeRelay[] = "relay";
344
345const char kProtocolUdp[] = "udp";
346const char kProtocolTcp[] = "tcp";
347const char kProtocolSsltcp[] = "ssltcp";
348const char kProtocolTls[] = "tls";
349
350const char kAddressFamilyIpv4[] = "ipv4";
351const char kAddressFamilyIpv6[] = "ipv6";
352
353const char kNetworkTypeEthernet[] = "ethernet";
354const char kNetworkTypeLoopback[] = "loopback";
355const char kNetworkTypeWifi[] = "wifi";
356const char kNetworkTypeVpn[] = "vpn";
357const char kNetworkTypeCellular[] = "cellular";
358
359std::string GetIceCandidateTypeAsString(webrtc::IceCandidateType type) {
360 switch (type) {
361 case webrtc::IceCandidateType::kLocal:
362 return kIceCandidateTypeLocal;
363 case webrtc::IceCandidateType::kStun:
364 return kIceCandidateTypeStun;
365 case webrtc::IceCandidateType::kPrflx:
366 return kIceCandidateTypePrflx;
367 case webrtc::IceCandidateType::kRelay:
368 return kIceCandidateTypeRelay;
369 default:
370 return kUnknownEnumValue;
371 }
372}
373
374std::string GetProtocolAsString(webrtc::IceCandidatePairProtocol protocol) {
375 switch (protocol) {
376 case webrtc::IceCandidatePairProtocol::kUdp:
377 return kProtocolUdp;
378 case webrtc::IceCandidatePairProtocol::kTcp:
379 return kProtocolTcp;
380 case webrtc::IceCandidatePairProtocol::kSsltcp:
381 return kProtocolSsltcp;
382 case webrtc::IceCandidatePairProtocol::kTls:
383 return kProtocolTls;
384 default:
385 return kUnknownEnumValue;
386 }
387}
388
389std::string GetAddressFamilyAsString(
390 webrtc::IceCandidatePairAddressFamily family) {
391 switch (family) {
392 case webrtc::IceCandidatePairAddressFamily::kIpv4:
393 return kAddressFamilyIpv4;
394 case webrtc::IceCandidatePairAddressFamily::kIpv6:
395 return kAddressFamilyIpv6;
396 default:
397 return kUnknownEnumValue;
398 }
399}
400
401std::string GetNetworkTypeAsString(webrtc::IceCandidateNetworkType type) {
402 switch (type) {
403 case webrtc::IceCandidateNetworkType::kEthernet:
404 return kNetworkTypeEthernet;
405 case webrtc::IceCandidateNetworkType::kLoopback:
406 return kNetworkTypeLoopback;
407 case webrtc::IceCandidateNetworkType::kWifi:
408 return kNetworkTypeWifi;
409 case webrtc::IceCandidateNetworkType::kVpn:
410 return kNetworkTypeVpn;
411 case webrtc::IceCandidateNetworkType::kCellular:
412 return kNetworkTypeCellular;
413 default:
414 return kUnknownEnumValue;
415 }
416}
417
418std::string GetCandidatePairLogDescriptionAsString(
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200419 const LoggedIceCandidatePairConfig& config) {
Qingsi Wang8eca1ff2018-02-02 11:49:44 -0800420 // Example: stun:wifi->relay(tcp):cellular@udp:ipv4
421 // represents a pair of a local server-reflexive candidate on a WiFi network
422 // and a remote relay candidate using TCP as the relay protocol on a cell
423 // network, when the candidate pair communicates over UDP using IPv4.
Jonas Olsson366a50c2018-09-06 13:41:30 +0200424 rtc::StringBuilder ss;
Qingsi Wang8eca1ff2018-02-02 11:49:44 -0800425 std::string local_candidate_type =
426 GetIceCandidateTypeAsString(config.local_candidate_type);
427 std::string remote_candidate_type =
428 GetIceCandidateTypeAsString(config.remote_candidate_type);
429 if (config.local_candidate_type == webrtc::IceCandidateType::kRelay) {
430 local_candidate_type +=
431 "(" + GetProtocolAsString(config.local_relay_protocol) + ")";
432 }
433 ss << local_candidate_type << ":"
434 << GetNetworkTypeAsString(config.local_network_type) << ":"
435 << GetAddressFamilyAsString(config.local_address_family) << "->"
436 << remote_candidate_type << ":"
437 << GetAddressFamilyAsString(config.remote_address_family) << "@"
438 << GetProtocolAsString(config.candidate_pair_protocol);
Jonas Olsson84df1c72018-09-14 16:59:32 +0200439 return ss.Release();
Qingsi Wang8eca1ff2018-02-02 11:49:44 -0800440}
441
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200442std::string GetDirectionAsString(PacketDirection direction) {
443 if (direction == kIncomingPacket) {
444 return "Incoming";
445 } else {
446 return "Outgoing";
447 }
448}
449
450std::string GetDirectionAsShortString(PacketDirection direction) {
451 if (direction == kIncomingPacket) {
452 return "In";
453 } else {
454 return "Out";
455 }
456}
457
terelius54ce6802016-07-13 06:44:41 -0700458} // namespace
459
Sebastian Janssonb290a6d2019-01-03 14:46:23 +0100460EventLogAnalyzer::EventLogAnalyzer(const ParsedRtcEventLog& log,
Stefan Holmer1d4a2272018-05-24 13:48:09 +0200461 bool normalize_time)
Bjorn Terelius068fc352019-02-13 22:38:25 +0100462 : parsed_log_(log) {
463 config_.window_duration_ = 250000;
464 config_.step_ = 10000;
465 config_.normalize_time_ = normalize_time;
466 config_.begin_time_ = parsed_log_.first_timestamp();
467 config_.end_time_ = parsed_log_.last_timestamp();
468 if (config_.end_time_ < config_.begin_time_) {
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200469 RTC_LOG(LS_WARNING) << "No useful events in the log.";
Bjorn Terelius068fc352019-02-13 22:38:25 +0100470 config_.begin_time_ = config_.end_time_ = 0;
Björn Tereliusff612732018-04-25 14:23:01 +0000471 }
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200472
473 const auto& log_start_events = parsed_log_.start_log_events();
474 const auto& log_end_events = parsed_log_.stop_log_events();
475 auto start_iter = log_start_events.begin();
476 auto end_iter = log_end_events.begin();
477 while (start_iter != log_start_events.end()) {
478 int64_t start = start_iter->log_time_us();
479 ++start_iter;
Danil Chapovalov431abd92018-06-18 12:54:17 +0200480 absl::optional<int64_t> next_start;
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200481 if (start_iter != log_start_events.end())
482 next_start.emplace(start_iter->log_time_us());
483 if (end_iter != log_end_events.end() &&
484 end_iter->log_time_us() <=
485 next_start.value_or(std::numeric_limits<int64_t>::max())) {
486 int64_t end = end_iter->log_time_us();
487 RTC_DCHECK_LE(start, end);
488 log_segments_.push_back(std::make_pair(start, end));
489 ++end_iter;
490 } else {
491 // we're missing an end event. Assume that it occurred just before the
492 // next start.
493 log_segments_.push_back(
Bjorn Terelius068fc352019-02-13 22:38:25 +0100494 std::make_pair(start, next_start.value_or(config_.end_time_)));
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200495 }
henrik.lundin3c938fc2017-06-14 06:09:58 -0700496 }
Bjorn Terelius2eb31882017-11-30 15:15:25 +0100497 RTC_LOG(LS_INFO) << "Found " << log_segments_.size()
Yves Gerey665174f2018-06-19 15:03:05 +0200498 << " (LOG_START, LOG_END) segments in log.";
terelius54ce6802016-07-13 06:44:41 -0700499}
500
Sebastian Jansson5c94f552018-10-15 18:46:51 +0200501class BitrateObserver : public RemoteBitrateObserver {
Stefan Holmer13181032016-07-29 14:48:54 +0200502 public:
503 BitrateObserver() : last_bitrate_bps_(0), bitrate_updated_(false) {}
504
Sebastian Jansson5c94f552018-10-15 18:46:51 +0200505 void Update(NetworkControlUpdate update) {
506 if (update.target_rate) {
507 last_bitrate_bps_ = update.target_rate->target_rate.bps();
508 bitrate_updated_ = true;
509 }
Stefan Holmer13181032016-07-29 14:48:54 +0200510 }
511
512 void OnReceiveBitrateChanged(const std::vector<uint32_t>& ssrcs,
513 uint32_t bitrate) override {}
514
515 uint32_t last_bitrate_bps() const { return last_bitrate_bps_; }
516 bool GetAndResetBitrateUpdated() {
517 bool bitrate_updated = bitrate_updated_;
518 bitrate_updated_ = false;
519 return bitrate_updated;
520 }
521
522 private:
523 uint32_t last_bitrate_bps_;
524 bool bitrate_updated_;
525};
526
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200527void EventLogAnalyzer::CreatePacketGraph(PacketDirection direction,
terelius54ce6802016-07-13 06:44:41 -0700528 Plot* plot) {
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200529 for (const auto& stream : parsed_log_.rtp_packets_by_ssrc(direction)) {
530 // Filter on SSRC.
531 if (!MatchingSsrc(stream.ssrc, desired_ssrc_)) {
terelius6addf492016-08-23 17:34:07 -0700532 continue;
terelius54ce6802016-07-13 06:44:41 -0700533 }
terelius54ce6802016-07-13 06:44:41 -0700534
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200535 TimeSeries time_series(GetStreamName(direction, stream.ssrc),
536 LineStyle::kBar);
537 auto GetPacketSize = [](const LoggedRtpPacket& packet) {
Danil Chapovalov431abd92018-06-18 12:54:17 +0200538 return absl::optional<float>(packet.total_length);
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200539 };
Stefan Holmer1d4a2272018-05-24 13:48:09 +0200540 auto ToCallTime = [this](const LoggedRtpPacket& packet) {
Bjorn Terelius068fc352019-02-13 22:38:25 +0100541 return this->config_.GetCallTimeSec(packet.log_time_us());
Stefan Holmer1d4a2272018-05-24 13:48:09 +0200542 };
543 ProcessPoints<LoggedRtpPacket>(ToCallTime, GetPacketSize,
544 stream.packet_view, &time_series);
philipel35ba9bd2017-04-19 05:58:51 -0700545 plot->AppendTimeSeries(std::move(time_series));
terelius54ce6802016-07-13 06:44:41 -0700546 }
547
Bjorn Terelius068fc352019-02-13 22:38:25 +0100548 plot->SetXAxis(config_.CallBeginTimeSec(), config_.CallEndTimeSec(),
549 "Time (s)", kLeftMargin, kRightMargin);
tereliusdc35dcd2016-08-01 12:03:27 -0700550 plot->SetSuggestedYAxis(0, 1, "Packet size (bytes)", kBottomMargin,
551 kTopMargin);
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200552 plot->SetTitle(GetDirectionAsString(direction) + " RTP packets");
terelius54ce6802016-07-13 06:44:41 -0700553}
554
Bjorn Terelius7c974e62019-02-15 17:20:12 +0100555void EventLogAnalyzer::CreateRtcpTypeGraph(PacketDirection direction,
556 Plot* plot) {
557 plot->AppendTimeSeries(CreateRtcpTypeTimeSeries(
558 parsed_log_.transport_feedbacks(direction), config_, "TWCC", 1));
559 plot->AppendTimeSeries(CreateRtcpTypeTimeSeries(
560 parsed_log_.receiver_reports(direction), config_, "RR", 2));
561 plot->AppendTimeSeries(CreateRtcpTypeTimeSeries(
562 parsed_log_.sender_reports(direction), config_, "SR", 3));
563 plot->AppendTimeSeries(CreateRtcpTypeTimeSeries(
564 parsed_log_.extended_reports(direction), config_, "XR", 4));
565 plot->AppendTimeSeries(CreateRtcpTypeTimeSeries(parsed_log_.nacks(direction),
566 config_, "NACK", 5));
567 plot->AppendTimeSeries(CreateRtcpTypeTimeSeries(parsed_log_.rembs(direction),
568 config_, "REMB", 6));
569 plot->AppendTimeSeries(
570 CreateRtcpTypeTimeSeries(parsed_log_.firs(direction), config_, "FIR", 7));
571 plot->AppendTimeSeries(
572 CreateRtcpTypeTimeSeries(parsed_log_.plis(direction), config_, "PLI", 8));
573 plot->SetXAxis(config_.CallBeginTimeSec(), config_.CallEndTimeSec(),
574 "Time (s)", kLeftMargin, kRightMargin);
575 plot->SetSuggestedYAxis(0, 1, "RTCP type", kBottomMargin, kTopMargin);
576 plot->SetTitle(GetDirectionAsString(direction) + " RTCP packets");
577}
578
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200579template <typename IterableType>
philipelccd74892016-09-05 02:46:25 -0700580void EventLogAnalyzer::CreateAccumulatedPacketsTimeSeries(
philipelccd74892016-09-05 02:46:25 -0700581 Plot* plot,
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200582 const IterableType& packets,
583 const std::string& label) {
584 TimeSeries time_series(label, LineStyle::kStep);
585 for (size_t i = 0; i < packets.size(); i++) {
Bjorn Terelius068fc352019-02-13 22:38:25 +0100586 float x = config_.GetCallTimeSec(packets[i].log_time_us());
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200587 time_series.points.emplace_back(x, i + 1);
philipelccd74892016-09-05 02:46:25 -0700588 }
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200589 plot->AppendTimeSeries(std::move(time_series));
philipelccd74892016-09-05 02:46:25 -0700590}
591
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200592void EventLogAnalyzer::CreateAccumulatedPacketsGraph(PacketDirection direction,
593 Plot* plot) {
594 for (const auto& stream : parsed_log_.rtp_packets_by_ssrc(direction)) {
595 if (!MatchingSsrc(stream.ssrc, desired_ssrc_))
596 continue;
597 std::string label =
598 std::string("RTP ") + GetStreamName(direction, stream.ssrc);
599 CreateAccumulatedPacketsTimeSeries(plot, stream.packet_view, label);
600 }
601 std::string label =
602 std::string("RTCP ") + "(" + GetDirectionAsShortString(direction) + ")";
603 if (direction == kIncomingPacket) {
604 CreateAccumulatedPacketsTimeSeries(
605 plot, parsed_log_.incoming_rtcp_packets(), label);
606 } else {
607 CreateAccumulatedPacketsTimeSeries(
608 plot, parsed_log_.outgoing_rtcp_packets(), label);
609 }
philipelccd74892016-09-05 02:46:25 -0700610
Bjorn Terelius068fc352019-02-13 22:38:25 +0100611 plot->SetXAxis(config_.CallBeginTimeSec(), config_.CallEndTimeSec(),
612 "Time (s)", kLeftMargin, kRightMargin);
philipelccd74892016-09-05 02:46:25 -0700613 plot->SetSuggestedYAxis(0, 1, "Received Packets", kBottomMargin, kTopMargin);
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200614 plot->SetTitle(std::string("Accumulated ") + GetDirectionAsString(direction) +
615 " RTP/RTCP packets");
philipelccd74892016-09-05 02:46:25 -0700616}
617
terelius54ce6802016-07-13 06:44:41 -0700618// For each SSRC, plot the time between the consecutive playouts.
619void EventLogAnalyzer::CreatePlayoutGraph(Plot* plot) {
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200620 for (const auto& playout_stream : parsed_log_.audio_playout_events()) {
621 uint32_t ssrc = playout_stream.first;
622 if (!MatchingSsrc(ssrc, desired_ssrc_))
623 continue;
Danil Chapovalov431abd92018-06-18 12:54:17 +0200624 absl::optional<int64_t> last_playout_ms;
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200625 TimeSeries time_series(SsrcToString(ssrc), LineStyle::kBar);
Minyue Li27e2b7d2018-05-07 15:20:24 +0200626 for (const auto& playout_event : playout_stream.second) {
Bjorn Terelius068fc352019-02-13 22:38:25 +0100627 float x = config_.GetCallTimeSec(playout_event.log_time_us());
Minyue Li27e2b7d2018-05-07 15:20:24 +0200628 int64_t playout_time_ms = playout_event.log_time_ms();
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200629 // If there were no previous playouts, place the point on the x-axis.
Minyue Li27e2b7d2018-05-07 15:20:24 +0200630 float y = playout_time_ms - last_playout_ms.value_or(playout_time_ms);
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200631 time_series.points.push_back(TimeSeriesPoint(x, y));
Minyue Li27e2b7d2018-05-07 15:20:24 +0200632 last_playout_ms.emplace(playout_time_ms);
terelius54ce6802016-07-13 06:44:41 -0700633 }
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200634 plot->AppendTimeSeries(std::move(time_series));
terelius54ce6802016-07-13 06:44:41 -0700635 }
636
Bjorn Terelius068fc352019-02-13 22:38:25 +0100637 plot->SetXAxis(config_.CallBeginTimeSec(), config_.CallEndTimeSec(),
638 "Time (s)", kLeftMargin, kRightMargin);
tereliusdc35dcd2016-08-01 12:03:27 -0700639 plot->SetSuggestedYAxis(0, 1, "Time since last playout (ms)", kBottomMargin,
640 kTopMargin);
641 plot->SetTitle("Audio playout");
terelius54ce6802016-07-13 06:44:41 -0700642}
643
ivocaac9d6f2016-09-22 07:01:47 -0700644// For audio SSRCs, plot the audio level.
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200645void EventLogAnalyzer::CreateAudioLevelGraph(PacketDirection direction,
646 Plot* plot) {
647 for (const auto& stream : parsed_log_.rtp_packets_by_ssrc(direction)) {
648 if (!IsAudioSsrc(direction, stream.ssrc))
649 continue;
650 TimeSeries time_series(GetStreamName(direction, stream.ssrc),
651 LineStyle::kLine);
652 for (auto& packet : stream.packet_view) {
ivocaac9d6f2016-09-22 07:01:47 -0700653 if (packet.header.extension.hasAudioLevel) {
Bjorn Terelius068fc352019-02-13 22:38:25 +0100654 float x = config_.GetCallTimeSec(packet.log_time_us());
ivocaac9d6f2016-09-22 07:01:47 -0700655 // The audio level is stored in -dBov (so e.g. -10 dBov is stored as 10)
656 // Here we convert it to dBov.
657 float y = static_cast<float>(-packet.header.extension.audioLevel);
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200658 time_series.points.emplace_back(TimeSeriesPoint(x, y));
ivocaac9d6f2016-09-22 07:01:47 -0700659 }
660 }
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200661 plot->AppendTimeSeries(std::move(time_series));
ivocaac9d6f2016-09-22 07:01:47 -0700662 }
663
Bjorn Terelius068fc352019-02-13 22:38:25 +0100664 plot->SetXAxis(config_.CallBeginTimeSec(), config_.CallEndTimeSec(),
665 "Time (s)", kLeftMargin, kRightMargin);
Yves Gerey665174f2018-06-19 15:03:05 +0200666 plot->SetYAxis(-127, 0, "Audio level (dBov)", kBottomMargin, kTopMargin);
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200667 plot->SetTitle(GetDirectionAsString(direction) + " audio level");
ivocaac9d6f2016-09-22 07:01:47 -0700668}
669
terelius54ce6802016-07-13 06:44:41 -0700670// For each SSRC, plot the time between the consecutive playouts.
671void EventLogAnalyzer::CreateSequenceNumberGraph(Plot* plot) {
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200672 for (const auto& stream : parsed_log_.incoming_rtp_packets_by_ssrc()) {
673 // Filter on SSRC.
674 if (!MatchingSsrc(stream.ssrc, desired_ssrc_)) {
terelius6addf492016-08-23 17:34:07 -0700675 continue;
terelius54ce6802016-07-13 06:44:41 -0700676 }
terelius54ce6802016-07-13 06:44:41 -0700677
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200678 TimeSeries time_series(GetStreamName(kIncomingPacket, stream.ssrc),
679 LineStyle::kBar);
680 auto GetSequenceNumberDiff = [](const LoggedRtpPacketIncoming& old_packet,
681 const LoggedRtpPacketIncoming& new_packet) {
682 int64_t diff =
683 WrappingDifference(new_packet.rtp.header.sequenceNumber,
684 old_packet.rtp.header.sequenceNumber, 1ul << 16);
685 return diff;
686 };
Stefan Holmer1d4a2272018-05-24 13:48:09 +0200687 auto ToCallTime = [this](const LoggedRtpPacketIncoming& packet) {
Bjorn Terelius068fc352019-02-13 22:38:25 +0100688 return this->config_.GetCallTimeSec(packet.log_time_us());
Stefan Holmer1d4a2272018-05-24 13:48:09 +0200689 };
690 ProcessPairs<LoggedRtpPacketIncoming, float>(
691 ToCallTime, GetSequenceNumberDiff, stream.incoming_packets,
692 &time_series);
philipel35ba9bd2017-04-19 05:58:51 -0700693 plot->AppendTimeSeries(std::move(time_series));
terelius54ce6802016-07-13 06:44:41 -0700694 }
695
Bjorn Terelius068fc352019-02-13 22:38:25 +0100696 plot->SetXAxis(config_.CallBeginTimeSec(), config_.CallEndTimeSec(),
697 "Time (s)", kLeftMargin, kRightMargin);
tereliusdc35dcd2016-08-01 12:03:27 -0700698 plot->SetSuggestedYAxis(0, 1, "Difference since last packet", kBottomMargin,
699 kTopMargin);
700 plot->SetTitle("Sequence number");
terelius54ce6802016-07-13 06:44:41 -0700701}
702
Stefan Holmer99f8e082016-09-09 13:37:50 +0200703void EventLogAnalyzer::CreateIncomingPacketLossGraph(Plot* plot) {
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200704 for (const auto& stream : parsed_log_.incoming_rtp_packets_by_ssrc()) {
705 const std::vector<LoggedRtpPacketIncoming>& packets =
706 stream.incoming_packets;
707 // Filter on SSRC.
708 if (!MatchingSsrc(stream.ssrc, desired_ssrc_) || packets.size() == 0) {
Stefan Holmer99f8e082016-09-09 13:37:50 +0200709 continue;
710 }
711
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200712 TimeSeries time_series(GetStreamName(kIncomingPacket, stream.ssrc),
713 LineStyle::kLine, PointStyle::kHighlight);
714 // TODO(terelius): Should the window and step size be read from the class
715 // instead?
716 const int64_t kWindowUs = 1000000;
717 const int64_t kStep = 1000000;
Bjorn Terelius2eb31882017-11-30 15:15:25 +0100718 SeqNumUnwrapper<uint16_t> unwrapper_;
719 SeqNumUnwrapper<uint16_t> prior_unwrapper_;
terelius4c9b4af2017-01-30 08:44:51 -0800720 size_t window_index_begin = 0;
721 size_t window_index_end = 0;
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200722 uint64_t highest_seq_number =
723 unwrapper_.Unwrap(packets[0].rtp.header.sequenceNumber) - 1;
724 uint64_t highest_prior_seq_number =
725 prior_unwrapper_.Unwrap(packets[0].rtp.header.sequenceNumber) - 1;
terelius4c9b4af2017-01-30 08:44:51 -0800726
Bjorn Terelius068fc352019-02-13 22:38:25 +0100727 for (int64_t t = config_.begin_time_; t < config_.end_time_ + kStep;
728 t += kStep) {
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200729 while (window_index_end < packets.size() &&
730 packets[window_index_end].rtp.log_time_us() < t) {
731 uint64_t sequence_number = unwrapper_.Unwrap(
732 packets[window_index_end].rtp.header.sequenceNumber);
terelius4c9b4af2017-01-30 08:44:51 -0800733 highest_seq_number = std::max(highest_seq_number, sequence_number);
734 ++window_index_end;
Stefan Holmer99f8e082016-09-09 13:37:50 +0200735 }
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200736 while (window_index_begin < packets.size() &&
737 packets[window_index_begin].rtp.log_time_us() < t - kWindowUs) {
738 uint64_t sequence_number = prior_unwrapper_.Unwrap(
739 packets[window_index_begin].rtp.header.sequenceNumber);
terelius4c9b4af2017-01-30 08:44:51 -0800740 highest_prior_seq_number =
741 std::max(highest_prior_seq_number, sequence_number);
742 ++window_index_begin;
743 }
Bjorn Terelius068fc352019-02-13 22:38:25 +0100744 float x = config_.GetCallTimeSec(t);
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200745 uint64_t expected_packets = highest_seq_number - highest_prior_seq_number;
terelius4c9b4af2017-01-30 08:44:51 -0800746 if (expected_packets > 0) {
747 int64_t received_packets = window_index_end - window_index_begin;
748 int64_t lost_packets = expected_packets - received_packets;
749 float y = static_cast<float>(lost_packets) / expected_packets * 100;
750 time_series.points.emplace_back(x, y);
751 }
Stefan Holmer99f8e082016-09-09 13:37:50 +0200752 }
philipel35ba9bd2017-04-19 05:58:51 -0700753 plot->AppendTimeSeries(std::move(time_series));
Stefan Holmer99f8e082016-09-09 13:37:50 +0200754 }
755
Bjorn Terelius068fc352019-02-13 22:38:25 +0100756 plot->SetXAxis(config_.CallBeginTimeSec(), config_.CallEndTimeSec(),
757 "Time (s)", kLeftMargin, kRightMargin);
Konrad Hofbauerd036c652019-02-14 16:17:28 +0100758 plot->SetSuggestedYAxis(0, 1, "Loss rate (in %)", kBottomMargin, kTopMargin);
759 plot->SetTitle("Incoming packet loss (derived from incoming packets)");
Stefan Holmer99f8e082016-09-09 13:37:50 +0200760}
761
terelius2ee076d2017-08-15 02:04:02 -0700762void EventLogAnalyzer::CreateIncomingDelayGraph(Plot* plot) {
Bjorn Terelius6c373cc2018-11-01 14:31:10 +0100763 for (const auto& stream : parsed_log_.incoming_rtp_packets_by_ssrc()) {
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200764 // Filter on SSRC.
765 if (!MatchingSsrc(stream.ssrc, desired_ssrc_) ||
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200766 IsRtxSsrc(kIncomingPacket, stream.ssrc)) {
terelius88e64e52016-07-19 01:51:06 -0700767 continue;
768 }
terelius54ce6802016-07-13 06:44:41 -0700769
Bjorn Terelius6c373cc2018-11-01 14:31:10 +0100770 const std::vector<LoggedRtpPacketIncoming>& packets =
771 stream.incoming_packets;
772 if (packets.size() < 100) {
773 RTC_LOG(LS_WARNING) << "Can't estimate the RTP clock frequency with "
774 << packets.size() << " packets in the stream.";
775 continue;
776 }
777 int64_t end_time_us = log_segments_.empty()
778 ? std::numeric_limits<int64_t>::max()
779 : log_segments_.front().second;
780 absl::optional<uint32_t> estimated_frequency =
781 EstimateRtpClockFrequency(packets, end_time_us);
782 if (!estimated_frequency)
783 continue;
784 const double frequency_hz = *estimated_frequency;
785 if (IsVideoSsrc(kIncomingPacket, stream.ssrc) && frequency_hz != 90000) {
786 RTC_LOG(LS_WARNING)
787 << "Video stream should use a 90 kHz clock but appears to use "
788 << frequency_hz / 1000 << ". Discarding.";
789 continue;
790 }
791
792 auto ToCallTime = [this](const LoggedRtpPacketIncoming& packet) {
Bjorn Terelius068fc352019-02-13 22:38:25 +0100793 return this->config_.GetCallTimeSec(packet.log_time_us());
Bjorn Terelius6c373cc2018-11-01 14:31:10 +0100794 };
795 auto ToNetworkDelay = [frequency_hz](
796 const LoggedRtpPacketIncoming& old_packet,
797 const LoggedRtpPacketIncoming& new_packet) {
798 return NetworkDelayDiff_CaptureTime(old_packet, new_packet, frequency_hz);
799 };
800
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200801 TimeSeries capture_time_data(
802 GetStreamName(kIncomingPacket, stream.ssrc) + " capture-time",
803 LineStyle::kLine);
Bjorn Terelius6c373cc2018-11-01 14:31:10 +0100804 AccumulatePairs<LoggedRtpPacketIncoming, double>(
805 ToCallTime, ToNetworkDelay, packets, &capture_time_data);
philipel35ba9bd2017-04-19 05:58:51 -0700806 plot->AppendTimeSeries(std::move(capture_time_data));
terelius88e64e52016-07-19 01:51:06 -0700807
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200808 TimeSeries send_time_data(
809 GetStreamName(kIncomingPacket, stream.ssrc) + " abs-send-time",
810 LineStyle::kLine);
Bjorn Terelius6c373cc2018-11-01 14:31:10 +0100811 AccumulatePairs<LoggedRtpPacketIncoming, double>(
812 ToCallTime, NetworkDelayDiff_AbsSendTime, packets, &send_time_data);
813 plot->AppendTimeSeriesIfNotEmpty(std::move(send_time_data));
terelius54ce6802016-07-13 06:44:41 -0700814 }
815
Bjorn Terelius068fc352019-02-13 22:38:25 +0100816 plot->SetXAxis(config_.CallBeginTimeSec(), config_.CallEndTimeSec(),
817 "Time (s)", kLeftMargin, kRightMargin);
Konrad Hofbauer5be3bbd2019-01-21 12:31:07 +0100818 plot->SetSuggestedYAxis(0, 1, "Delay (ms)", kBottomMargin, kTopMargin);
819 plot->SetTitle("Incoming network delay (relative to first packet)");
terelius54ce6802016-07-13 06:44:41 -0700820}
821
tereliusf736d232016-08-04 10:00:11 -0700822// Plot the fraction of packets lost (as perceived by the loss-based BWE).
823void EventLogAnalyzer::CreateFractionLossGraph(Plot* plot) {
Bjorn Tereliusb577d5e2017-11-10 16:21:34 +0100824 TimeSeries time_series("Fraction lost", LineStyle::kLine,
825 PointStyle::kHighlight);
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200826 for (auto& bwe_update : parsed_log_.bwe_loss_updates()) {
Bjorn Terelius068fc352019-02-13 22:38:25 +0100827 float x = config_.GetCallTimeSec(bwe_update.log_time_us());
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200828 float y = static_cast<float>(bwe_update.fraction_lost) / 255 * 100;
philipel35ba9bd2017-04-19 05:58:51 -0700829 time_series.points.emplace_back(x, y);
tereliusf736d232016-08-04 10:00:11 -0700830 }
tereliusf736d232016-08-04 10:00:11 -0700831
Bjorn Terelius19f5be32017-10-18 12:39:49 +0200832 plot->AppendTimeSeries(std::move(time_series));
Bjorn Terelius068fc352019-02-13 22:38:25 +0100833 plot->SetXAxis(config_.CallBeginTimeSec(), config_.CallEndTimeSec(),
834 "Time (s)", kLeftMargin, kRightMargin);
Konrad Hofbauerd036c652019-02-14 16:17:28 +0100835 plot->SetSuggestedYAxis(0, 10, "Loss rate (in %)", kBottomMargin, kTopMargin);
836 plot->SetTitle("Outgoing packet loss (as reported by BWE)");
tereliusf736d232016-08-04 10:00:11 -0700837}
838
terelius54ce6802016-07-13 06:44:41 -0700839// Plot the total bandwidth used by all RTP streams.
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200840void EventLogAnalyzer::CreateTotalIncomingBitrateGraph(Plot* plot) {
841 // TODO(terelius): This could be provided by the parser.
842 std::multimap<int64_t, size_t> packets_in_order;
843 for (const auto& stream : parsed_log_.incoming_rtp_packets_by_ssrc()) {
844 for (const LoggedRtpPacketIncoming& packet : stream.incoming_packets)
845 packets_in_order.insert(
846 std::make_pair(packet.rtp.log_time_us(), packet.rtp.total_length));
terelius54ce6802016-07-13 06:44:41 -0700847 }
848
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200849 auto window_begin = packets_in_order.begin();
850 auto window_end = packets_in_order.begin();
terelius54ce6802016-07-13 06:44:41 -0700851 size_t bytes_in_window = 0;
terelius54ce6802016-07-13 06:44:41 -0700852
Piotr (Peter) Slatalacf8405e2019-02-14 13:44:57 -0800853 if (!packets_in_order.empty()) {
854 // Calculate a moving average of the bitrate and store in a TimeSeries.
855 TimeSeries bitrate_series("Bitrate", LineStyle::kLine);
856 for (int64_t time = config_.begin_time_;
857 time < config_.end_time_ + config_.step_; time += config_.step_) {
858 while (window_end != packets_in_order.end() && window_end->first < time) {
859 bytes_in_window += window_end->second;
860 ++window_end;
861 }
862 while (window_begin != packets_in_order.end() &&
863 window_begin->first < time - config_.window_duration_) {
864 RTC_DCHECK_LE(window_begin->second, bytes_in_window);
865 bytes_in_window -= window_begin->second;
866 ++window_begin;
867 }
868 float window_duration_in_seconds =
869 static_cast<float>(config_.window_duration_) / kNumMicrosecsPerSec;
870 float x = config_.GetCallTimeSec(time);
871 float y = bytes_in_window * 8 / window_duration_in_seconds / 1000;
872 bitrate_series.points.emplace_back(x, y);
terelius54ce6802016-07-13 06:44:41 -0700873 }
Piotr (Peter) Slatalacf8405e2019-02-14 13:44:57 -0800874 plot->AppendTimeSeries(std::move(bitrate_series));
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200875 }
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200876
877 // Overlay the outgoing REMB over incoming bitrate.
878 TimeSeries remb_series("Remb", LineStyle::kStep);
879 for (const auto& rtcp : parsed_log_.rembs(kOutgoingPacket)) {
Bjorn Terelius068fc352019-02-13 22:38:25 +0100880 float x = config_.GetCallTimeSec(rtcp.log_time_us());
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200881 float y = static_cast<float>(rtcp.remb.bitrate_bps()) / 1000;
882 remb_series.points.emplace_back(x, y);
883 }
884 plot->AppendTimeSeriesIfNotEmpty(std::move(remb_series));
885
Piotr (Peter) Slatalacf8405e2019-02-14 13:44:57 -0800886 if (!parsed_log_.generic_packets_received().empty()) {
887 TimeSeries time_series("Incoming generic bitrate", LineStyle::kLine);
888 auto GetPacketSizeKilobits = [](const LoggedGenericPacketReceived& packet) {
889 return packet.packet_length * 8.0 / 1000.0;
890 };
891 MovingAverage<LoggedGenericPacketReceived, double>(
892 GetPacketSizeKilobits, parsed_log_.generic_packets_received(), config_,
893 &time_series);
894 plot->AppendTimeSeries(std::move(time_series));
895 }
896
Bjorn Terelius068fc352019-02-13 22:38:25 +0100897 plot->SetXAxis(config_.CallBeginTimeSec(), config_.CallEndTimeSec(),
898 "Time (s)", kLeftMargin, kRightMargin);
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200899 plot->SetSuggestedYAxis(0, 1, "Bitrate (kbps)", kBottomMargin, kTopMargin);
900 plot->SetTitle("Incoming RTP bitrate");
901}
902
903// Plot the total bandwidth used by all RTP streams.
904void EventLogAnalyzer::CreateTotalOutgoingBitrateGraph(Plot* plot,
905 bool show_detector_state,
906 bool show_alr_state) {
907 // TODO(terelius): This could be provided by the parser.
908 std::multimap<int64_t, size_t> packets_in_order;
909 for (const auto& stream : parsed_log_.outgoing_rtp_packets_by_ssrc()) {
910 for (const LoggedRtpPacketOutgoing& packet : stream.outgoing_packets)
911 packets_in_order.insert(
912 std::make_pair(packet.rtp.log_time_us(), packet.rtp.total_length));
913 }
914
915 auto window_begin = packets_in_order.begin();
916 auto window_end = packets_in_order.begin();
917 size_t bytes_in_window = 0;
918
Piotr (Peter) Slatalacf8405e2019-02-14 13:44:57 -0800919 if (!packets_in_order.empty()) {
920 // Calculate a moving average of the bitrate and store in a TimeSeries.
921 TimeSeries bitrate_series("Bitrate", LineStyle::kLine);
922 for (int64_t time = config_.begin_time_;
923 time < config_.end_time_ + config_.step_; time += config_.step_) {
924 while (window_end != packets_in_order.end() && window_end->first < time) {
925 bytes_in_window += window_end->second;
926 ++window_end;
927 }
928 while (window_begin != packets_in_order.end() &&
929 window_begin->first < time - config_.window_duration_) {
930 RTC_DCHECK_LE(window_begin->second, bytes_in_window);
931 bytes_in_window -= window_begin->second;
932 ++window_begin;
933 }
934 float window_duration_in_seconds =
935 static_cast<float>(config_.window_duration_) / kNumMicrosecsPerSec;
936 float x = config_.GetCallTimeSec(time);
937 float y = bytes_in_window * 8 / window_duration_in_seconds / 1000;
938 bitrate_series.points.emplace_back(x, y);
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200939 }
Piotr (Peter) Slatalacf8405e2019-02-14 13:44:57 -0800940 plot->AppendTimeSeries(std::move(bitrate_series));
terelius54ce6802016-07-13 06:44:41 -0700941 }
942
terelius8058e582016-07-25 01:32:41 -0700943 // Overlay the send-side bandwidth estimate over the outgoing bitrate.
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200944 TimeSeries loss_series("Loss-based estimate", LineStyle::kStep);
945 for (auto& loss_update : parsed_log_.bwe_loss_updates()) {
Bjorn Terelius068fc352019-02-13 22:38:25 +0100946 float x = config_.GetCallTimeSec(loss_update.log_time_us());
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200947 float y = static_cast<float>(loss_update.bitrate_bps) / 1000;
948 loss_series.points.emplace_back(x, y);
949 }
philipel10fc0e62017-04-11 01:50:23 -0700950
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200951 TimeSeries delay_series("Delay-based estimate", LineStyle::kStep);
952 IntervalSeries overusing_series("Overusing", "#ff8e82",
953 IntervalSeries::kHorizontal);
954 IntervalSeries underusing_series("Underusing", "#5092fc",
955 IntervalSeries::kHorizontal);
956 IntervalSeries normal_series("Normal", "#c4ffc4",
957 IntervalSeries::kHorizontal);
958 IntervalSeries* last_series = &normal_series;
959 double last_detector_switch = 0.0;
philipel23c7f252017-07-14 06:30:03 -0700960
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200961 BandwidthUsage last_detector_state = BandwidthUsage::kBwNormal;
philipel23c7f252017-07-14 06:30:03 -0700962
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200963 for (auto& delay_update : parsed_log_.bwe_delay_updates()) {
Bjorn Terelius068fc352019-02-13 22:38:25 +0100964 float x = config_.GetCallTimeSec(delay_update.log_time_us());
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200965 float y = static_cast<float>(delay_update.bitrate_bps) / 1000;
philipel23c7f252017-07-14 06:30:03 -0700966
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200967 if (last_detector_state != delay_update.detector_state) {
968 last_series->intervals.emplace_back(last_detector_switch, x);
969 last_detector_state = delay_update.detector_state;
970 last_detector_switch = x;
philipel23c7f252017-07-14 06:30:03 -0700971
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200972 switch (delay_update.detector_state) {
973 case BandwidthUsage::kBwNormal:
974 last_series = &normal_series;
975 break;
976 case BandwidthUsage::kBwUnderusing:
977 last_series = &underusing_series;
978 break;
979 case BandwidthUsage::kBwOverusing:
980 last_series = &overusing_series;
981 break;
982 case BandwidthUsage::kLast:
983 RTC_NOTREACHED();
philipele127e7a2017-03-29 16:28:53 +0200984 }
985 }
philipel23c7f252017-07-14 06:30:03 -0700986
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200987 delay_series.points.emplace_back(x, y);
988 }
Bjorn Terelius9e336ec2018-04-24 16:28:35 +0200989
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200990 RTC_CHECK(last_series);
Bjorn Terelius068fc352019-02-13 22:38:25 +0100991 last_series->intervals.emplace_back(last_detector_switch, config_.end_time_);
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200992
993 TimeSeries created_series("Probe cluster created.", LineStyle::kNone,
994 PointStyle::kHighlight);
995 for (auto& cluster : parsed_log_.bwe_probe_cluster_created_events()) {
Bjorn Terelius068fc352019-02-13 22:38:25 +0100996 float x = config_.GetCallTimeSec(cluster.log_time_us());
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +0200997 float y = static_cast<float>(cluster.bitrate_bps) / 1000;
998 created_series.points.emplace_back(x, y);
999 }
1000
1001 TimeSeries result_series("Probing results.", LineStyle::kNone,
1002 PointStyle::kHighlight);
Bjorn Terelius7a0bb002018-05-29 14:45:53 +02001003 for (auto& result : parsed_log_.bwe_probe_success_events()) {
Bjorn Terelius068fc352019-02-13 22:38:25 +01001004 float x = config_.GetCallTimeSec(result.log_time_us());
Bjorn Terelius7a0bb002018-05-29 14:45:53 +02001005 float y = static_cast<float>(result.bitrate_bps) / 1000;
1006 result_series.points.emplace_back(x, y);
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001007 }
1008
Piotr (Peter) Slatalaf996c842019-01-04 06:54:22 -08001009 TimeSeries probe_failures_series("Probe failed", LineStyle::kNone,
1010 PointStyle::kHighlight);
1011 for (auto& failure : parsed_log_.bwe_probe_failure_events()) {
Bjorn Terelius068fc352019-02-13 22:38:25 +01001012 float x = config_.GetCallTimeSec(failure.log_time_us());
Piotr (Peter) Slatalaf996c842019-01-04 06:54:22 -08001013 probe_failures_series.points.emplace_back(x, 0);
1014 }
1015
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001016 IntervalSeries alr_state("ALR", "#555555", IntervalSeries::kHorizontal);
1017 bool previously_in_alr = false;
1018 int64_t alr_start = 0;
1019 for (auto& alr : parsed_log_.alr_state_events()) {
Bjorn Terelius068fc352019-02-13 22:38:25 +01001020 float y = config_.GetCallTimeSec(alr.log_time_us());
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001021 if (!previously_in_alr && alr.in_alr) {
1022 alr_start = alr.log_time_us();
1023 previously_in_alr = true;
1024 } else if (previously_in_alr && !alr.in_alr) {
Bjorn Terelius068fc352019-02-13 22:38:25 +01001025 float x = config_.GetCallTimeSec(alr_start);
Ilya Nikolaevskiya4259f62017-12-05 13:19:45 +01001026 alr_state.intervals.emplace_back(x, y);
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001027 previously_in_alr = false;
Björn Tereliusff612732018-04-25 14:23:01 +00001028 }
Björn Tereliusff612732018-04-25 14:23:01 +00001029 }
1030
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001031 if (previously_in_alr) {
Bjorn Terelius068fc352019-02-13 22:38:25 +01001032 float x = config_.GetCallTimeSec(alr_start);
1033 float y = config_.GetCallTimeSec(config_.end_time_);
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001034 alr_state.intervals.emplace_back(x, y);
1035 }
1036
1037 if (show_detector_state) {
1038 plot->AppendIntervalSeries(std::move(overusing_series));
1039 plot->AppendIntervalSeries(std::move(underusing_series));
1040 plot->AppendIntervalSeries(std::move(normal_series));
1041 }
1042
1043 if (show_alr_state) {
1044 plot->AppendIntervalSeries(std::move(alr_state));
1045 }
1046 plot->AppendTimeSeries(std::move(loss_series));
Piotr (Peter) Slatalaf996c842019-01-04 06:54:22 -08001047 plot->AppendTimeSeriesIfNotEmpty(std::move(probe_failures_series));
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001048 plot->AppendTimeSeries(std::move(delay_series));
1049 plot->AppendTimeSeries(std::move(created_series));
1050 plot->AppendTimeSeries(std::move(result_series));
1051
1052 // Overlay the incoming REMB over the outgoing bitrate.
Björn Tereliusff612732018-04-25 14:23:01 +00001053 TimeSeries remb_series("Remb", LineStyle::kStep);
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001054 for (const auto& rtcp : parsed_log_.rembs(kIncomingPacket)) {
Bjorn Terelius068fc352019-02-13 22:38:25 +01001055 float x = config_.GetCallTimeSec(rtcp.log_time_us());
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001056 float y = static_cast<float>(rtcp.remb.bitrate_bps()) / 1000;
terelius2c8e8a32017-06-02 01:29:48 -07001057 remb_series.points.emplace_back(x, y);
1058 }
1059 plot->AppendTimeSeriesIfNotEmpty(std::move(remb_series));
1060
Piotr (Peter) Slatalacf8405e2019-02-14 13:44:57 -08001061 if (!parsed_log_.generic_packets_sent().empty()) {
1062 {
1063 TimeSeries time_series("Outgoing generic total bitrate",
1064 LineStyle::kLine);
1065 auto GetPacketSizeKilobits = [](const LoggedGenericPacketSent& packet) {
1066 return packet.packet_length() * 8.0 / 1000.0;
1067 };
1068 MovingAverage<LoggedGenericPacketSent, double>(
1069 GetPacketSizeKilobits, parsed_log_.generic_packets_sent(), config_,
1070 &time_series);
1071 plot->AppendTimeSeries(std::move(time_series));
1072 }
1073
1074 {
1075 TimeSeries time_series("Outgoing generic payload bitrate",
1076 LineStyle::kLine);
1077 auto GetPacketSizeKilobits = [](const LoggedGenericPacketSent& packet) {
1078 return packet.payload_length * 8.0 / 1000.0;
1079 };
1080 MovingAverage<LoggedGenericPacketSent, double>(
1081 GetPacketSizeKilobits, parsed_log_.generic_packets_sent(), config_,
1082 &time_series);
1083 plot->AppendTimeSeries(std::move(time_series));
1084 }
1085 }
1086
Bjorn Terelius068fc352019-02-13 22:38:25 +01001087 plot->SetXAxis(config_.CallBeginTimeSec(), config_.CallEndTimeSec(),
1088 "Time (s)", kLeftMargin, kRightMargin);
tereliusdc35dcd2016-08-01 12:03:27 -07001089 plot->SetSuggestedYAxis(0, 1, "Bitrate (kbps)", kBottomMargin, kTopMargin);
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001090 plot->SetTitle("Outgoing RTP bitrate");
terelius54ce6802016-07-13 06:44:41 -07001091}
1092
1093// For each SSRC, plot the bandwidth used by that stream.
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001094void EventLogAnalyzer::CreateStreamBitrateGraph(PacketDirection direction,
1095 Plot* plot) {
1096 for (const auto& stream : parsed_log_.rtp_packets_by_ssrc(direction)) {
1097 // Filter on SSRC.
1098 if (!MatchingSsrc(stream.ssrc, desired_ssrc_)) {
terelius6addf492016-08-23 17:34:07 -07001099 continue;
terelius54ce6802016-07-13 06:44:41 -07001100 }
1101
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001102 TimeSeries time_series(GetStreamName(direction, stream.ssrc),
1103 LineStyle::kLine);
1104 auto GetPacketSizeKilobits = [](const LoggedRtpPacket& packet) {
1105 return packet.total_length * 8.0 / 1000.0;
1106 };
terelius53dc23c2017-03-13 05:24:05 -07001107 MovingAverage<LoggedRtpPacket, double>(
Bjorn Terelius068fc352019-02-13 22:38:25 +01001108 GetPacketSizeKilobits, stream.packet_view, config_, &time_series);
philipel35ba9bd2017-04-19 05:58:51 -07001109 plot->AppendTimeSeries(std::move(time_series));
terelius54ce6802016-07-13 06:44:41 -07001110 }
1111
Bjorn Terelius068fc352019-02-13 22:38:25 +01001112 plot->SetXAxis(config_.CallBeginTimeSec(), config_.CallEndTimeSec(),
1113 "Time (s)", kLeftMargin, kRightMargin);
tereliusdc35dcd2016-08-01 12:03:27 -07001114 plot->SetSuggestedYAxis(0, 1, "Bitrate (kbps)", kBottomMargin, kTopMargin);
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001115 plot->SetTitle(GetDirectionAsString(direction) + " bitrate per stream");
terelius54ce6802016-07-13 06:44:41 -07001116}
1117
Bjorn Terelius9775a582019-02-15 17:29:58 +01001118// Plot the bitrate allocation for each temporal and spatial layer.
1119// Computed from RTCP XR target bitrate block, so the graph is only populated if
1120// those are sent.
1121void EventLogAnalyzer::CreateBitrateAllocationGraph(PacketDirection direction,
1122 Plot* plot) {
1123 std::map<LayerDescription, TimeSeries> time_series;
1124 const auto& xr_list = parsed_log_.extended_reports(direction);
1125 for (const auto& rtcp : xr_list) {
1126 const absl::optional<rtcp::TargetBitrate>& target_bitrate =
1127 rtcp.xr.target_bitrate();
1128 if (!target_bitrate.has_value())
1129 continue;
1130 for (const auto& bitrate_item : target_bitrate->GetTargetBitrates()) {
1131 LayerDescription layer(rtcp.xr.sender_ssrc(), bitrate_item.spatial_layer,
1132 bitrate_item.temporal_layer);
1133 auto time_series_it = time_series.find(layer);
1134 if (time_series_it == time_series.end()) {
1135 std::string layer_name = GetLayerName(layer);
1136 bool inserted;
1137 std::tie(time_series_it, inserted) = time_series.insert(
1138 std::make_pair(layer, TimeSeries(layer_name, LineStyle::kStep)));
1139 RTC_DCHECK(inserted);
1140 }
1141 float x = config_.GetCallTimeSec(rtcp.log_time_us());
1142 float y = bitrate_item.target_bitrate_kbps;
1143 time_series_it->second.points.emplace_back(x, y);
1144 }
1145 }
1146 for (auto& layer : time_series) {
1147 plot->AppendTimeSeries(std::move(layer.second));
1148 }
1149 plot->SetXAxis(config_.CallBeginTimeSec(), config_.CallEndTimeSec(),
1150 "Time (s)", kLeftMargin, kRightMargin);
1151 plot->SetSuggestedYAxis(0, 1, "Bitrate (kbps)", kBottomMargin, kTopMargin);
1152 if (direction == kIncomingPacket)
1153 plot->SetTitle("Target bitrate per incoming layer");
1154 else
1155 plot->SetTitle("Target bitrate per outgoing layer");
1156}
1157
Bjorn Terelius28db2662017-10-04 14:22:43 +02001158void EventLogAnalyzer::CreateSendSideBweSimulationGraph(Plot* plot) {
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001159 using RtpPacketType = LoggedRtpPacketOutgoing;
1160 using TransportFeedbackType = LoggedRtcpPacketTransportFeedback;
Stefan Holmer13181032016-07-29 14:48:54 +02001161
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001162 // TODO(terelius): This could be provided by the parser.
1163 std::multimap<int64_t, const RtpPacketType*> outgoing_rtp;
1164 for (const auto& stream : parsed_log_.outgoing_rtp_packets_by_ssrc()) {
1165 for (const RtpPacketType& rtp_packet : stream.outgoing_packets)
1166 outgoing_rtp.insert(
1167 std::make_pair(rtp_packet.rtp.log_time_us(), &rtp_packet));
Stefan Holmer13181032016-07-29 14:48:54 +02001168 }
1169
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001170 const std::vector<TransportFeedbackType>& incoming_rtcp =
1171 parsed_log_.transport_feedbacks(kIncomingPacket);
Stefan Holmer13181032016-07-29 14:48:54 +02001172
1173 SimulatedClock clock(0);
1174 BitrateObserver observer;
1175 RtcEventLogNullImpl null_event_log;
nisse0245da02016-11-30 03:35:20 -08001176 PacketRouter packet_router;
Stefan Holmer5c8942a2017-08-22 16:16:44 +02001177 PacedSender pacer(&clock, &packet_router, &null_event_log);
Sebastian Jansson05acd2b2019-01-21 13:07:47 +01001178 TransportFeedbackAdapter transport_feedback;
Sebastian Jansson5c94f552018-10-15 18:46:51 +02001179 auto factory = GoogCcNetworkControllerFactory(&null_event_log);
1180 TimeDelta process_interval = factory.GetProcessInterval();
Stefan Holmer13181032016-07-29 14:48:54 +02001181 // TODO(holmer): Log the call config and use that here instead.
1182 static const uint32_t kDefaultStartBitrateBps = 300000;
Sebastian Jansson5c94f552018-10-15 18:46:51 +02001183 NetworkControllerConfig cc_config;
Sebastian Jansson78416b62018-10-18 13:08:17 +02001184 cc_config.constraints.at_time = Timestamp::us(clock.TimeInMicroseconds());
Sebastian Jansson5c94f552018-10-15 18:46:51 +02001185 cc_config.constraints.starting_rate = DataRate::bps(kDefaultStartBitrateBps);
1186 auto goog_cc = factory.Create(cc_config);
Stefan Holmer13181032016-07-29 14:48:54 +02001187
Bjorn Tereliusb577d5e2017-11-10 16:21:34 +01001188 TimeSeries time_series("Delay-based estimate", LineStyle::kStep,
1189 PointStyle::kHighlight);
1190 TimeSeries acked_time_series("Acked bitrate", LineStyle::kLine,
1191 PointStyle::kHighlight);
1192 TimeSeries acked_estimate_time_series(
1193 "Acked bitrate estimate", LineStyle::kLine, PointStyle::kHighlight);
Stefan Holmer13181032016-07-29 14:48:54 +02001194
1195 auto rtp_iterator = outgoing_rtp.begin();
1196 auto rtcp_iterator = incoming_rtcp.begin();
1197
1198 auto NextRtpTime = [&]() {
1199 if (rtp_iterator != outgoing_rtp.end())
1200 return static_cast<int64_t>(rtp_iterator->first);
1201 return std::numeric_limits<int64_t>::max();
1202 };
1203
1204 auto NextRtcpTime = [&]() {
1205 if (rtcp_iterator != incoming_rtcp.end())
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001206 return static_cast<int64_t>(rtcp_iterator->log_time_us());
Stefan Holmer13181032016-07-29 14:48:54 +02001207 return std::numeric_limits<int64_t>::max();
1208 };
Bjorn Tereliusa728c912018-12-06 12:26:30 +01001209 int64_t next_process_time_us_ = std::min({NextRtpTime(), NextRtcpTime()});
Stefan Holmer13181032016-07-29 14:48:54 +02001210
1211 auto NextProcessTime = [&]() {
1212 if (rtcp_iterator != incoming_rtcp.end() ||
1213 rtp_iterator != outgoing_rtp.end()) {
Sebastian Jansson5c94f552018-10-15 18:46:51 +02001214 return next_process_time_us_;
Stefan Holmer13181032016-07-29 14:48:54 +02001215 }
1216 return std::numeric_limits<int64_t>::max();
1217 };
1218
Stefan Holmer492ee282016-10-27 17:19:20 +02001219 RateStatistics acked_bitrate(250, 8000);
Bjorn Terelius6984ad22017-10-24 12:19:45 +02001220#if !(BWE_TEST_LOGGING_COMPILE_TIME_ENABLE)
Sebastian Jansson95edb032019-01-17 16:24:12 +01001221 FieldTrialBasedConfig field_trial_config_;
Bjorn Terelius6984ad22017-10-24 12:19:45 +02001222 // The event_log_visualizer should normally not be compiled with
1223 // BWE_TEST_LOGGING_COMPILE_TIME_ENABLE since the normal plots won't work.
1224 // However, compiling with BWE_TEST_LOGGING, runnning with --plot_sendside_bwe
1225 // and piping the output to plot_dynamics.py can be used as a hack to get the
1226 // internal state of various BWE components. In this case, it is important
1227 // we don't instantiate the AcknowledgedBitrateEstimator both here and in
1228 // SendSideCongestionController since that would lead to duplicate outputs.
1229 AcknowledgedBitrateEstimator acknowledged_bitrate_estimator(
Sebastian Jansson95edb032019-01-17 16:24:12 +01001230 &field_trial_config_,
1231 absl::make_unique<BitrateEstimator>(&field_trial_config_));
Bjorn Terelius6984ad22017-10-24 12:19:45 +02001232#endif // !(BWE_TEST_LOGGING_COMPILE_TIME_ENABLE)
Sebastian Jansson5c94f552018-10-15 18:46:51 +02001233 int64_t time_us =
1234 std::min({NextRtpTime(), NextRtcpTime(), NextProcessTime()});
Stefan Holmer492ee282016-10-27 17:19:20 +02001235 int64_t last_update_us = 0;
Stefan Holmer13181032016-07-29 14:48:54 +02001236 while (time_us != std::numeric_limits<int64_t>::max()) {
1237 clock.AdvanceTimeMicroseconds(time_us - clock.TimeInMicroseconds());
Bjorn Tereliusc60a7772018-12-05 21:15:30 +01001238 if (clock.TimeInMicroseconds() >= NextRtpTime()) {
1239 RTC_DCHECK_EQ(clock.TimeInMicroseconds(), NextRtpTime());
1240 const RtpPacketType& rtp_packet = *rtp_iterator->second;
1241 if (rtp_packet.rtp.header.extension.hasTransportSequenceNumber) {
1242 RTC_DCHECK(rtp_packet.rtp.header.extension.hasTransportSequenceNumber);
1243 transport_feedback.AddPacket(
1244 rtp_packet.rtp.header.ssrc,
1245 rtp_packet.rtp.header.extension.transportSequenceNumber,
Sebastian Jansson05acd2b2019-01-21 13:07:47 +01001246 rtp_packet.rtp.total_length, PacedPacketInfo(),
1247 Timestamp::us(rtp_packet.rtp.log_time_us()));
Bjorn Tereliusc60a7772018-12-05 21:15:30 +01001248 rtc::SentPacket sent_packet(
1249 rtp_packet.rtp.header.extension.transportSequenceNumber,
1250 rtp_packet.rtp.log_time_us() / 1000);
1251 auto sent_msg = transport_feedback.ProcessSentPacket(sent_packet);
1252 if (sent_msg)
1253 observer.Update(goog_cc->OnSentPacket(*sent_msg));
1254 }
1255 ++rtp_iterator;
1256 }
Stefan Holmer13181032016-07-29 14:48:54 +02001257 if (clock.TimeInMicroseconds() >= NextRtcpTime()) {
stefanc3de0332016-08-02 07:22:17 -07001258 RTC_DCHECK_EQ(clock.TimeInMicroseconds(), NextRtcpTime());
Sebastian Jansson5c94f552018-10-15 18:46:51 +02001259
1260 auto feedback_msg = transport_feedback.ProcessTransportFeedback(
Sebastian Jansson05acd2b2019-01-21 13:07:47 +01001261 rtcp_iterator->transport_feedback,
1262 Timestamp::ms(clock.TimeInMilliseconds()));
Danil Chapovalov431abd92018-06-18 12:54:17 +02001263 absl::optional<uint32_t> bitrate_bps;
Sebastian Jansson5c94f552018-10-15 18:46:51 +02001264 if (feedback_msg) {
1265 observer.Update(goog_cc->OnTransportPacketsFeedback(*feedback_msg));
1266 std::vector<PacketFeedback> feedback =
1267 transport_feedback.GetTransportFeedbackVector();
1268 SortPacketFeedbackVector(&feedback);
1269 if (!feedback.empty()) {
Bjorn Terelius6984ad22017-10-24 12:19:45 +02001270#if !(BWE_TEST_LOGGING_COMPILE_TIME_ENABLE)
Sebastian Jansson5c94f552018-10-15 18:46:51 +02001271 acknowledged_bitrate_estimator.IncomingPacketFeedbackVector(feedback);
Bjorn Terelius6984ad22017-10-24 12:19:45 +02001272#endif // !(BWE_TEST_LOGGING_COMPILE_TIME_ENABLE)
Sebastian Jansson5c94f552018-10-15 18:46:51 +02001273 for (const PacketFeedback& packet : feedback)
1274 acked_bitrate.Update(packet.payload_size, packet.arrival_time_ms);
1275 bitrate_bps = acked_bitrate.Rate(feedback.back().arrival_time_ms);
1276 }
Stefan Holmer13181032016-07-29 14:48:54 +02001277 }
Sebastian Jansson5c94f552018-10-15 18:46:51 +02001278
Bjorn Terelius068fc352019-02-13 22:38:25 +01001279 float x = config_.GetCallTimeSec(clock.TimeInMicroseconds());
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001280 float y = bitrate_bps.value_or(0) / 1000;
1281 acked_time_series.points.emplace_back(x, y);
1282#if !(BWE_TEST_LOGGING_COMPILE_TIME_ENABLE)
1283 y = acknowledged_bitrate_estimator.bitrate_bps().value_or(0) / 1000;
1284 acked_estimate_time_series.points.emplace_back(x, y);
1285#endif // !(BWE_TEST_LOGGING_COMPILE_TIME_ENABLE)
Stefan Holmer13181032016-07-29 14:48:54 +02001286 ++rtcp_iterator;
1287 }
stefanc3de0332016-08-02 07:22:17 -07001288 if (clock.TimeInMicroseconds() >= NextProcessTime()) {
1289 RTC_DCHECK_EQ(clock.TimeInMicroseconds(), NextProcessTime());
Sebastian Jansson5c94f552018-10-15 18:46:51 +02001290 ProcessInterval msg;
1291 msg.at_time = Timestamp::us(clock.TimeInMicroseconds());
1292 observer.Update(goog_cc->OnProcessInterval(msg));
1293 next_process_time_us_ += process_interval.us();
stefanc3de0332016-08-02 07:22:17 -07001294 }
Stefan Holmer492ee282016-10-27 17:19:20 +02001295 if (observer.GetAndResetBitrateUpdated() ||
1296 time_us - last_update_us >= 1e6) {
Stefan Holmer13181032016-07-29 14:48:54 +02001297 uint32_t y = observer.last_bitrate_bps() / 1000;
Bjorn Terelius068fc352019-02-13 22:38:25 +01001298 float x = config_.GetCallTimeSec(clock.TimeInMicroseconds());
Stefan Holmer13181032016-07-29 14:48:54 +02001299 time_series.points.emplace_back(x, y);
Stefan Holmer492ee282016-10-27 17:19:20 +02001300 last_update_us = time_us;
Stefan Holmer13181032016-07-29 14:48:54 +02001301 }
1302 time_us = std::min({NextRtpTime(), NextRtcpTime(), NextProcessTime()});
1303 }
1304 // Add the data set to the plot.
philipel35ba9bd2017-04-19 05:58:51 -07001305 plot->AppendTimeSeries(std::move(time_series));
1306 plot->AppendTimeSeries(std::move(acked_time_series));
Bjorn Terelius6984ad22017-10-24 12:19:45 +02001307 plot->AppendTimeSeriesIfNotEmpty(std::move(acked_estimate_time_series));
Stefan Holmer13181032016-07-29 14:48:54 +02001308
Bjorn Terelius068fc352019-02-13 22:38:25 +01001309 plot->SetXAxis(config_.CallBeginTimeSec(), config_.CallEndTimeSec(),
1310 "Time (s)", kLeftMargin, kRightMargin);
tereliusdc35dcd2016-08-01 12:03:27 -07001311 plot->SetSuggestedYAxis(0, 10, "Bitrate (kbps)", kBottomMargin, kTopMargin);
Bjorn Terelius28db2662017-10-04 14:22:43 +02001312 plot->SetTitle("Simulated send-side BWE behavior");
1313}
1314
1315void EventLogAnalyzer::CreateReceiveSideBweSimulationGraph(Plot* plot) {
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001316 using RtpPacketType = LoggedRtpPacketIncoming;
Bjorn Terelius28db2662017-10-04 14:22:43 +02001317 class RembInterceptingPacketRouter : public PacketRouter {
1318 public:
1319 void OnReceiveBitrateChanged(const std::vector<uint32_t>& ssrcs,
1320 uint32_t bitrate_bps) override {
1321 last_bitrate_bps_ = bitrate_bps;
1322 bitrate_updated_ = true;
1323 PacketRouter::OnReceiveBitrateChanged(ssrcs, bitrate_bps);
1324 }
1325 uint32_t last_bitrate_bps() const { return last_bitrate_bps_; }
1326 bool GetAndResetBitrateUpdated() {
1327 bool bitrate_updated = bitrate_updated_;
1328 bitrate_updated_ = false;
1329 return bitrate_updated;
1330 }
1331
1332 private:
1333 uint32_t last_bitrate_bps_;
1334 bool bitrate_updated_;
1335 };
1336
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001337 std::multimap<int64_t, const RtpPacketType*> incoming_rtp;
Bjorn Terelius28db2662017-10-04 14:22:43 +02001338
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001339 for (const auto& stream : parsed_log_.incoming_rtp_packets_by_ssrc()) {
1340 if (IsVideoSsrc(kIncomingPacket, stream.ssrc)) {
1341 for (const auto& rtp_packet : stream.incoming_packets)
1342 incoming_rtp.insert(
1343 std::make_pair(rtp_packet.rtp.log_time_us(), &rtp_packet));
Bjorn Terelius28db2662017-10-04 14:22:43 +02001344 }
1345 }
1346
1347 SimulatedClock clock(0);
1348 RembInterceptingPacketRouter packet_router;
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001349 // TODO(terelius): The PacketRouter is used as the RemoteBitrateObserver.
Bjorn Terelius28db2662017-10-04 14:22:43 +02001350 // Is this intentional?
1351 ReceiveSideCongestionController rscc(&clock, &packet_router);
1352 // TODO(holmer): Log the call config and use that here instead.
1353 // static const uint32_t kDefaultStartBitrateBps = 300000;
1354 // rscc.SetBweBitrates(0, kDefaultStartBitrateBps, -1);
1355
Bjorn Tereliusb577d5e2017-11-10 16:21:34 +01001356 TimeSeries time_series("Receive side estimate", LineStyle::kLine,
1357 PointStyle::kHighlight);
1358 TimeSeries acked_time_series("Received bitrate", LineStyle::kLine);
Bjorn Terelius28db2662017-10-04 14:22:43 +02001359
1360 RateStatistics acked_bitrate(250, 8000);
1361 int64_t last_update_us = 0;
1362 for (const auto& kv : incoming_rtp) {
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001363 const RtpPacketType& packet = *kv.second;
1364 int64_t arrival_time_ms = packet.rtp.log_time_us() / 1000;
1365 size_t payload = packet.rtp.total_length; /*Should subtract header?*/
1366 clock.AdvanceTimeMicroseconds(packet.rtp.log_time_us() -
Bjorn Terelius28db2662017-10-04 14:22:43 +02001367 clock.TimeInMicroseconds());
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001368 rscc.OnReceivedPacket(arrival_time_ms, payload, packet.rtp.header);
Bjorn Terelius28db2662017-10-04 14:22:43 +02001369 acked_bitrate.Update(payload, arrival_time_ms);
Danil Chapovalov431abd92018-06-18 12:54:17 +02001370 absl::optional<uint32_t> bitrate_bps = acked_bitrate.Rate(arrival_time_ms);
Bjorn Terelius28db2662017-10-04 14:22:43 +02001371 if (bitrate_bps) {
1372 uint32_t y = *bitrate_bps / 1000;
Bjorn Terelius068fc352019-02-13 22:38:25 +01001373 float x = config_.GetCallTimeSec(clock.TimeInMicroseconds());
Bjorn Terelius28db2662017-10-04 14:22:43 +02001374 acked_time_series.points.emplace_back(x, y);
1375 }
1376 if (packet_router.GetAndResetBitrateUpdated() ||
1377 clock.TimeInMicroseconds() - last_update_us >= 1e6) {
1378 uint32_t y = packet_router.last_bitrate_bps() / 1000;
Bjorn Terelius068fc352019-02-13 22:38:25 +01001379 float x = config_.GetCallTimeSec(clock.TimeInMicroseconds());
Bjorn Terelius28db2662017-10-04 14:22:43 +02001380 time_series.points.emplace_back(x, y);
1381 last_update_us = clock.TimeInMicroseconds();
1382 }
1383 }
1384 // Add the data set to the plot.
1385 plot->AppendTimeSeries(std::move(time_series));
1386 plot->AppendTimeSeries(std::move(acked_time_series));
1387
Bjorn Terelius068fc352019-02-13 22:38:25 +01001388 plot->SetXAxis(config_.CallBeginTimeSec(), config_.CallEndTimeSec(),
1389 "Time (s)", kLeftMargin, kRightMargin);
Bjorn Terelius28db2662017-10-04 14:22:43 +02001390 plot->SetSuggestedYAxis(0, 10, "Bitrate (kbps)", kBottomMargin, kTopMargin);
1391 plot->SetTitle("Simulated receive-side BWE behavior");
Stefan Holmer13181032016-07-29 14:48:54 +02001392}
1393
tereliuse34c19c2016-08-15 08:47:14 -07001394void EventLogAnalyzer::CreateNetworkDelayFeedbackGraph(Plot* plot) {
Bjorn Tereliusb577d5e2017-11-10 16:21:34 +01001395 TimeSeries late_feedback_series("Late feedback results.", LineStyle::kNone,
1396 PointStyle::kHighlight);
Bjorn Terelius57ba7e12018-10-25 15:31:35 +02001397 TimeSeries time_series("Network delay", LineStyle::kLine,
Bjorn Tereliusb577d5e2017-11-10 16:21:34 +01001398 PointStyle::kHighlight);
Bjorn Terelius57ba7e12018-10-25 15:31:35 +02001399 int64_t min_send_receive_diff_ms = std::numeric_limits<int64_t>::max();
1400 int64_t min_rtt_ms = std::numeric_limits<int64_t>::max();
stefanc3de0332016-08-02 07:22:17 -07001401
stefana0a8ed72017-09-06 02:06:32 -07001402 int64_t prev_y = 0;
Christoffer Rodbro89f64d32018-09-27 14:29:35 +02001403 for (auto packet : GetNetworkTrace(parsed_log_)) {
1404 if (packet.arrival_time_ms == PacketFeedback::kNotReceived)
1405 continue;
Bjorn Terelius068fc352019-02-13 22:38:25 +01001406 float x = config_.GetCallTimeSec(1000 * packet.feedback_arrival_time_ms);
Christoffer Rodbro89f64d32018-09-27 14:29:35 +02001407 if (packet.send_time_ms == PacketFeedback::kNoSendTime) {
1408 late_feedback_series.points.emplace_back(x, prev_y);
1409 continue;
stefanc3de0332016-08-02 07:22:17 -07001410 }
Christoffer Rodbro89f64d32018-09-27 14:29:35 +02001411 int64_t y = packet.arrival_time_ms - packet.send_time_ms;
1412 prev_y = y;
Bjorn Terelius57ba7e12018-10-25 15:31:35 +02001413 int64_t rtt_ms = packet.feedback_arrival_time_ms - packet.send_time_ms;
1414 min_rtt_ms = std::min(rtt_ms, min_rtt_ms);
1415 min_send_receive_diff_ms = std::min(y, min_send_receive_diff_ms);
Christoffer Rodbro89f64d32018-09-27 14:29:35 +02001416 time_series.points.emplace_back(x, y);
stefanc3de0332016-08-02 07:22:17 -07001417 }
Christoffer Rodbro89f64d32018-09-27 14:29:35 +02001418
Bjorn Terelius57ba7e12018-10-25 15:31:35 +02001419 // We assume that the base network delay (w/o queues) is equal to half
1420 // the minimum RTT. Therefore rescale the delays by subtracting the minimum
1421 // observed 1-ways delay and add half the minumum RTT.
1422 const int64_t estimated_clock_offset_ms =
1423 min_send_receive_diff_ms - min_rtt_ms / 2;
stefanc3de0332016-08-02 07:22:17 -07001424 for (TimeSeriesPoint& point : time_series.points)
Bjorn Terelius57ba7e12018-10-25 15:31:35 +02001425 point.y -= estimated_clock_offset_ms;
stefana0a8ed72017-09-06 02:06:32 -07001426 for (TimeSeriesPoint& point : late_feedback_series.points)
Bjorn Terelius57ba7e12018-10-25 15:31:35 +02001427 point.y -= estimated_clock_offset_ms;
1428
stefanc3de0332016-08-02 07:22:17 -07001429 // Add the data set to the plot.
stefana0a8ed72017-09-06 02:06:32 -07001430 plot->AppendTimeSeriesIfNotEmpty(std::move(time_series));
1431 plot->AppendTimeSeriesIfNotEmpty(std::move(late_feedback_series));
stefanc3de0332016-08-02 07:22:17 -07001432
Bjorn Terelius068fc352019-02-13 22:38:25 +01001433 plot->SetXAxis(config_.CallBeginTimeSec(), config_.CallEndTimeSec(),
1434 "Time (s)", kLeftMargin, kRightMargin);
stefanc3de0332016-08-02 07:22:17 -07001435 plot->SetSuggestedYAxis(0, 10, "Delay (ms)", kBottomMargin, kTopMargin);
Konrad Hofbauer5be3bbd2019-01-21 12:31:07 +01001436 plot->SetTitle("Outgoing network delay (based on per-packet feedback)");
stefanc3de0332016-08-02 07:22:17 -07001437}
stefan08383272016-12-20 08:51:52 -08001438
Bjorn Terelius0295a962017-10-25 17:42:41 +02001439void EventLogAnalyzer::CreatePacerDelayGraph(Plot* plot) {
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001440 for (const auto& stream : parsed_log_.outgoing_rtp_packets_by_ssrc()) {
1441 const std::vector<LoggedRtpPacketOutgoing>& packets =
1442 stream.outgoing_packets;
Bjorn Terelius0295a962017-10-25 17:42:41 +02001443
1444 if (packets.size() < 2) {
Mirko Bonadei675513b2017-11-09 11:09:25 +01001445 RTC_LOG(LS_WARNING)
1446 << "Can't estimate a the RTP clock frequency or the "
1447 "pacer delay with less than 2 packets in the stream";
Bjorn Terelius0295a962017-10-25 17:42:41 +02001448 continue;
1449 }
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001450 int64_t end_time_us = log_segments_.empty()
1451 ? std::numeric_limits<int64_t>::max()
1452 : log_segments_.front().second;
Danil Chapovalov431abd92018-06-18 12:54:17 +02001453 absl::optional<uint32_t> estimated_frequency =
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001454 EstimateRtpClockFrequency(packets, end_time_us);
Bjorn Terelius0295a962017-10-25 17:42:41 +02001455 if (!estimated_frequency)
1456 continue;
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001457 if (IsVideoSsrc(kOutgoingPacket, stream.ssrc) &&
1458 *estimated_frequency != 90000) {
Mirko Bonadei675513b2017-11-09 11:09:25 +01001459 RTC_LOG(LS_WARNING)
Bjorn Terelius0295a962017-10-25 17:42:41 +02001460 << "Video stream should use a 90 kHz clock but appears to use "
1461 << *estimated_frequency / 1000 << ". Discarding.";
1462 continue;
1463 }
1464
1465 TimeSeries pacer_delay_series(
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001466 GetStreamName(kOutgoingPacket, stream.ssrc) + "(" +
Bjorn Terelius0295a962017-10-25 17:42:41 +02001467 std::to_string(*estimated_frequency / 1000) + " kHz)",
Bjorn Tereliusb577d5e2017-11-10 16:21:34 +01001468 LineStyle::kLine, PointStyle::kHighlight);
Bjorn Terelius0295a962017-10-25 17:42:41 +02001469 SeqNumUnwrapper<uint32_t> timestamp_unwrapper;
1470 uint64_t first_capture_timestamp =
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001471 timestamp_unwrapper.Unwrap(packets.front().rtp.header.timestamp);
1472 uint64_t first_send_timestamp = packets.front().rtp.log_time_us();
1473 for (const auto& packet : packets) {
Bjorn Terelius0295a962017-10-25 17:42:41 +02001474 double capture_time_ms = (static_cast<double>(timestamp_unwrapper.Unwrap(
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001475 packet.rtp.header.timestamp)) -
Bjorn Terelius0295a962017-10-25 17:42:41 +02001476 first_capture_timestamp) /
1477 *estimated_frequency * 1000;
1478 double send_time_ms =
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001479 static_cast<double>(packet.rtp.log_time_us() - first_send_timestamp) /
1480 1000;
Bjorn Terelius068fc352019-02-13 22:38:25 +01001481 float x = config_.GetCallTimeSec(packet.rtp.log_time_us());
Bjorn Terelius0295a962017-10-25 17:42:41 +02001482 float y = send_time_ms - capture_time_ms;
1483 pacer_delay_series.points.emplace_back(x, y);
1484 }
1485 plot->AppendTimeSeries(std::move(pacer_delay_series));
1486 }
1487
Bjorn Terelius068fc352019-02-13 22:38:25 +01001488 plot->SetXAxis(config_.CallBeginTimeSec(), config_.CallEndTimeSec(),
1489 "Time (s)", kLeftMargin, kRightMargin);
Bjorn Terelius0295a962017-10-25 17:42:41 +02001490 plot->SetSuggestedYAxis(0, 10, "Pacer delay (ms)", kBottomMargin, kTopMargin);
1491 plot->SetTitle(
1492 "Delay from capture to send time. (First packet normalized to 0.)");
1493}
1494
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001495void EventLogAnalyzer::CreateTimestampGraph(PacketDirection direction,
1496 Plot* plot) {
1497 for (const auto& stream : parsed_log_.rtp_packets_by_ssrc(direction)) {
1498 TimeSeries rtp_timestamps(
1499 GetStreamName(direction, stream.ssrc) + " capture-time",
1500 LineStyle::kLine, PointStyle::kHighlight);
1501 for (const auto& packet : stream.packet_view) {
Bjorn Terelius068fc352019-02-13 22:38:25 +01001502 float x = config_.GetCallTimeSec(packet.log_time_us());
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001503 float y = packet.header.timestamp;
1504 rtp_timestamps.points.emplace_back(x, y);
stefane372d3c2017-02-02 08:04:18 -08001505 }
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001506 plot->AppendTimeSeries(std::move(rtp_timestamps));
Björn Tereliusff612732018-04-25 14:23:01 +00001507
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001508 TimeSeries rtcp_timestamps(
1509 GetStreamName(direction, stream.ssrc) + " rtcp capture-time",
1510 LineStyle::kLine, PointStyle::kHighlight);
1511 // TODO(terelius): Why only sender reports?
1512 const auto& sender_reports = parsed_log_.sender_reports(direction);
1513 for (const auto& rtcp : sender_reports) {
1514 if (rtcp.sr.sender_ssrc() != stream.ssrc)
1515 continue;
Bjorn Terelius068fc352019-02-13 22:38:25 +01001516 float x = config_.GetCallTimeSec(rtcp.log_time_us());
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001517 float y = rtcp.sr.rtp_timestamp();
1518 rtcp_timestamps.points.emplace_back(x, y);
Björn Tereliusff612732018-04-25 14:23:01 +00001519 }
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001520 plot->AppendTimeSeriesIfNotEmpty(std::move(rtcp_timestamps));
stefane372d3c2017-02-02 08:04:18 -08001521 }
1522
Bjorn Terelius068fc352019-02-13 22:38:25 +01001523 plot->SetXAxis(config_.CallBeginTimeSec(), config_.CallEndTimeSec(),
1524 "Time (s)", kLeftMargin, kRightMargin);
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001525 plot->SetSuggestedYAxis(0, 1, "RTP timestamp", kBottomMargin, kTopMargin);
1526 plot->SetTitle(GetDirectionAsString(direction) + " timestamps");
stefane372d3c2017-02-02 08:04:18 -08001527}
michaelt6e5b2192017-02-22 07:33:27 -08001528
Bjorn Tereliusb1222c22018-07-24 13:45:31 +02001529void EventLogAnalyzer::CreateSenderAndReceiverReportPlot(
1530 PacketDirection direction,
1531 rtc::FunctionView<float(const rtcp::ReportBlock&)> fy,
1532 std::string title,
1533 std::string yaxis_label,
1534 Plot* plot) {
1535 std::map<uint32_t, TimeSeries> sr_reports_by_ssrc;
1536 const auto& sender_reports = parsed_log_.sender_reports(direction);
1537 for (const auto& rtcp : sender_reports) {
Bjorn Terelius068fc352019-02-13 22:38:25 +01001538 float x = config_.GetCallTimeSec(rtcp.log_time_us());
Bjorn Tereliusb1222c22018-07-24 13:45:31 +02001539 uint32_t ssrc = rtcp.sr.sender_ssrc();
1540 for (const auto& block : rtcp.sr.report_blocks()) {
1541 float y = fy(block);
1542 auto sr_report_it = sr_reports_by_ssrc.find(ssrc);
1543 bool inserted;
1544 if (sr_report_it == sr_reports_by_ssrc.end()) {
1545 std::tie(sr_report_it, inserted) = sr_reports_by_ssrc.emplace(
1546 ssrc, TimeSeries(GetStreamName(direction, ssrc) + " Sender Reports",
1547 LineStyle::kLine, PointStyle::kHighlight));
1548 }
1549 sr_report_it->second.points.emplace_back(x, y);
1550 }
1551 }
1552 for (auto& kv : sr_reports_by_ssrc) {
1553 plot->AppendTimeSeries(std::move(kv.second));
1554 }
1555
1556 std::map<uint32_t, TimeSeries> rr_reports_by_ssrc;
1557 const auto& receiver_reports = parsed_log_.receiver_reports(direction);
1558 for (const auto& rtcp : receiver_reports) {
Bjorn Terelius068fc352019-02-13 22:38:25 +01001559 float x = config_.GetCallTimeSec(rtcp.log_time_us());
Bjorn Tereliusb1222c22018-07-24 13:45:31 +02001560 uint32_t ssrc = rtcp.rr.sender_ssrc();
1561 for (const auto& block : rtcp.rr.report_blocks()) {
1562 float y = fy(block);
1563 auto rr_report_it = rr_reports_by_ssrc.find(ssrc);
1564 bool inserted;
1565 if (rr_report_it == rr_reports_by_ssrc.end()) {
1566 std::tie(rr_report_it, inserted) = rr_reports_by_ssrc.emplace(
1567 ssrc,
1568 TimeSeries(GetStreamName(direction, ssrc) + " Receiver Reports",
1569 LineStyle::kLine, PointStyle::kHighlight));
1570 }
1571 rr_report_it->second.points.emplace_back(x, y);
1572 }
1573 }
1574 for (auto& kv : rr_reports_by_ssrc) {
1575 plot->AppendTimeSeries(std::move(kv.second));
1576 }
1577
Bjorn Terelius068fc352019-02-13 22:38:25 +01001578 plot->SetXAxis(config_.CallBeginTimeSec(), config_.CallEndTimeSec(),
1579 "Time (s)", kLeftMargin, kRightMargin);
Bjorn Tereliusb1222c22018-07-24 13:45:31 +02001580 plot->SetSuggestedYAxis(0, 1, yaxis_label, kBottomMargin, kTopMargin);
1581 plot->SetTitle(title);
1582}
1583
michaelt6e5b2192017-02-22 07:33:27 -08001584void EventLogAnalyzer::CreateAudioEncoderTargetBitrateGraph(Plot* plot) {
Bjorn Tereliusb577d5e2017-11-10 16:21:34 +01001585 TimeSeries time_series("Audio encoder target bitrate", LineStyle::kLine,
1586 PointStyle::kHighlight);
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001587 auto GetAnaBitrateBps = [](const LoggedAudioNetworkAdaptationEvent& ana_event)
Danil Chapovalov431abd92018-06-18 12:54:17 +02001588 -> absl::optional<float> {
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001589 if (ana_event.config.bitrate_bps)
Danil Chapovalov431abd92018-06-18 12:54:17 +02001590 return absl::optional<float>(
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001591 static_cast<float>(*ana_event.config.bitrate_bps));
Danil Chapovalov431abd92018-06-18 12:54:17 +02001592 return absl::nullopt;
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001593 };
Stefan Holmer1d4a2272018-05-24 13:48:09 +02001594 auto ToCallTime = [this](const LoggedAudioNetworkAdaptationEvent& packet) {
Bjorn Terelius068fc352019-02-13 22:38:25 +01001595 return this->config_.GetCallTimeSec(packet.log_time_us());
Stefan Holmer1d4a2272018-05-24 13:48:09 +02001596 };
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001597 ProcessPoints<LoggedAudioNetworkAdaptationEvent>(
Stefan Holmer1d4a2272018-05-24 13:48:09 +02001598 ToCallTime, GetAnaBitrateBps,
1599 parsed_log_.audio_network_adaptation_events(), &time_series);
philipel35ba9bd2017-04-19 05:58:51 -07001600 plot->AppendTimeSeries(std::move(time_series));
Bjorn Terelius068fc352019-02-13 22:38:25 +01001601 plot->SetXAxis(config_.CallBeginTimeSec(), config_.CallEndTimeSec(),
1602 "Time (s)", kLeftMargin, kRightMargin);
michaelt6e5b2192017-02-22 07:33:27 -08001603 plot->SetSuggestedYAxis(0, 1, "Bitrate (bps)", kBottomMargin, kTopMargin);
1604 plot->SetTitle("Reported audio encoder target bitrate");
1605}
1606
1607void EventLogAnalyzer::CreateAudioEncoderFrameLengthGraph(Plot* plot) {
Bjorn Tereliusb577d5e2017-11-10 16:21:34 +01001608 TimeSeries time_series("Audio encoder frame length", LineStyle::kLine,
1609 PointStyle::kHighlight);
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001610 auto GetAnaFrameLengthMs =
1611 [](const LoggedAudioNetworkAdaptationEvent& ana_event) {
michaelt6e5b2192017-02-22 07:33:27 -08001612 if (ana_event.config.frame_length_ms)
Danil Chapovalov431abd92018-06-18 12:54:17 +02001613 return absl::optional<float>(
michaelt6e5b2192017-02-22 07:33:27 -08001614 static_cast<float>(*ana_event.config.frame_length_ms));
Danil Chapovalov431abd92018-06-18 12:54:17 +02001615 return absl::optional<float>();
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001616 };
Stefan Holmer1d4a2272018-05-24 13:48:09 +02001617 auto ToCallTime = [this](const LoggedAudioNetworkAdaptationEvent& packet) {
Bjorn Terelius068fc352019-02-13 22:38:25 +01001618 return this->config_.GetCallTimeSec(packet.log_time_us());
Stefan Holmer1d4a2272018-05-24 13:48:09 +02001619 };
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001620 ProcessPoints<LoggedAudioNetworkAdaptationEvent>(
Stefan Holmer1d4a2272018-05-24 13:48:09 +02001621 ToCallTime, GetAnaFrameLengthMs,
1622 parsed_log_.audio_network_adaptation_events(), &time_series);
philipel35ba9bd2017-04-19 05:58:51 -07001623 plot->AppendTimeSeries(std::move(time_series));
Bjorn Terelius068fc352019-02-13 22:38:25 +01001624 plot->SetXAxis(config_.CallBeginTimeSec(), config_.CallEndTimeSec(),
1625 "Time (s)", kLeftMargin, kRightMargin);
michaelt6e5b2192017-02-22 07:33:27 -08001626 plot->SetSuggestedYAxis(0, 1, "Frame length (ms)", kBottomMargin, kTopMargin);
1627 plot->SetTitle("Reported audio encoder frame length");
1628}
1629
terelius2ee076d2017-08-15 02:04:02 -07001630void EventLogAnalyzer::CreateAudioEncoderPacketLossGraph(Plot* plot) {
philipel35ba9bd2017-04-19 05:58:51 -07001631 TimeSeries time_series("Audio encoder uplink packet loss fraction",
Bjorn Tereliusb577d5e2017-11-10 16:21:34 +01001632 LineStyle::kLine, PointStyle::kHighlight);
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001633 auto GetAnaPacketLoss =
1634 [](const LoggedAudioNetworkAdaptationEvent& ana_event) {
michaelt6e5b2192017-02-22 07:33:27 -08001635 if (ana_event.config.uplink_packet_loss_fraction)
Danil Chapovalov431abd92018-06-18 12:54:17 +02001636 return absl::optional<float>(static_cast<float>(
michaelt6e5b2192017-02-22 07:33:27 -08001637 *ana_event.config.uplink_packet_loss_fraction));
Danil Chapovalov431abd92018-06-18 12:54:17 +02001638 return absl::optional<float>();
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001639 };
Stefan Holmer1d4a2272018-05-24 13:48:09 +02001640 auto ToCallTime = [this](const LoggedAudioNetworkAdaptationEvent& packet) {
Bjorn Terelius068fc352019-02-13 22:38:25 +01001641 return this->config_.GetCallTimeSec(packet.log_time_us());
Stefan Holmer1d4a2272018-05-24 13:48:09 +02001642 };
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001643 ProcessPoints<LoggedAudioNetworkAdaptationEvent>(
Stefan Holmer1d4a2272018-05-24 13:48:09 +02001644 ToCallTime, GetAnaPacketLoss,
1645 parsed_log_.audio_network_adaptation_events(), &time_series);
philipel35ba9bd2017-04-19 05:58:51 -07001646 plot->AppendTimeSeries(std::move(time_series));
Bjorn Terelius068fc352019-02-13 22:38:25 +01001647 plot->SetXAxis(config_.CallBeginTimeSec(), config_.CallEndTimeSec(),
1648 "Time (s)", kLeftMargin, kRightMargin);
michaelt6e5b2192017-02-22 07:33:27 -08001649 plot->SetSuggestedYAxis(0, 10, "Percent lost packets", kBottomMargin,
1650 kTopMargin);
1651 plot->SetTitle("Reported audio encoder lost packets");
1652}
1653
1654void EventLogAnalyzer::CreateAudioEncoderEnableFecGraph(Plot* plot) {
Bjorn Tereliusb577d5e2017-11-10 16:21:34 +01001655 TimeSeries time_series("Audio encoder FEC", LineStyle::kLine,
1656 PointStyle::kHighlight);
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001657 auto GetAnaFecEnabled =
1658 [](const LoggedAudioNetworkAdaptationEvent& ana_event) {
michaelt6e5b2192017-02-22 07:33:27 -08001659 if (ana_event.config.enable_fec)
Danil Chapovalov431abd92018-06-18 12:54:17 +02001660 return absl::optional<float>(
michaelt6e5b2192017-02-22 07:33:27 -08001661 static_cast<float>(*ana_event.config.enable_fec));
Danil Chapovalov431abd92018-06-18 12:54:17 +02001662 return absl::optional<float>();
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001663 };
Stefan Holmer1d4a2272018-05-24 13:48:09 +02001664 auto ToCallTime = [this](const LoggedAudioNetworkAdaptationEvent& packet) {
Bjorn Terelius068fc352019-02-13 22:38:25 +01001665 return this->config_.GetCallTimeSec(packet.log_time_us());
Stefan Holmer1d4a2272018-05-24 13:48:09 +02001666 };
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001667 ProcessPoints<LoggedAudioNetworkAdaptationEvent>(
Stefan Holmer1d4a2272018-05-24 13:48:09 +02001668 ToCallTime, GetAnaFecEnabled,
1669 parsed_log_.audio_network_adaptation_events(), &time_series);
philipel35ba9bd2017-04-19 05:58:51 -07001670 plot->AppendTimeSeries(std::move(time_series));
Bjorn Terelius068fc352019-02-13 22:38:25 +01001671 plot->SetXAxis(config_.CallBeginTimeSec(), config_.CallEndTimeSec(),
1672 "Time (s)", kLeftMargin, kRightMargin);
michaelt6e5b2192017-02-22 07:33:27 -08001673 plot->SetSuggestedYAxis(0, 1, "FEC (false/true)", kBottomMargin, kTopMargin);
1674 plot->SetTitle("Reported audio encoder FEC");
1675}
1676
1677void EventLogAnalyzer::CreateAudioEncoderEnableDtxGraph(Plot* plot) {
Bjorn Tereliusb577d5e2017-11-10 16:21:34 +01001678 TimeSeries time_series("Audio encoder DTX", LineStyle::kLine,
1679 PointStyle::kHighlight);
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001680 auto GetAnaDtxEnabled =
1681 [](const LoggedAudioNetworkAdaptationEvent& ana_event) {
michaelt6e5b2192017-02-22 07:33:27 -08001682 if (ana_event.config.enable_dtx)
Danil Chapovalov431abd92018-06-18 12:54:17 +02001683 return absl::optional<float>(
michaelt6e5b2192017-02-22 07:33:27 -08001684 static_cast<float>(*ana_event.config.enable_dtx));
Danil Chapovalov431abd92018-06-18 12:54:17 +02001685 return absl::optional<float>();
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001686 };
Stefan Holmer1d4a2272018-05-24 13:48:09 +02001687 auto ToCallTime = [this](const LoggedAudioNetworkAdaptationEvent& packet) {
Bjorn Terelius068fc352019-02-13 22:38:25 +01001688 return this->config_.GetCallTimeSec(packet.log_time_us());
Stefan Holmer1d4a2272018-05-24 13:48:09 +02001689 };
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001690 ProcessPoints<LoggedAudioNetworkAdaptationEvent>(
Stefan Holmer1d4a2272018-05-24 13:48:09 +02001691 ToCallTime, GetAnaDtxEnabled,
1692 parsed_log_.audio_network_adaptation_events(), &time_series);
philipel35ba9bd2017-04-19 05:58:51 -07001693 plot->AppendTimeSeries(std::move(time_series));
Bjorn Terelius068fc352019-02-13 22:38:25 +01001694 plot->SetXAxis(config_.CallBeginTimeSec(), config_.CallEndTimeSec(),
1695 "Time (s)", kLeftMargin, kRightMargin);
michaelt6e5b2192017-02-22 07:33:27 -08001696 plot->SetSuggestedYAxis(0, 1, "DTX (false/true)", kBottomMargin, kTopMargin);
1697 plot->SetTitle("Reported audio encoder DTX");
1698}
1699
1700void EventLogAnalyzer::CreateAudioEncoderNumChannelsGraph(Plot* plot) {
Bjorn Tereliusb577d5e2017-11-10 16:21:34 +01001701 TimeSeries time_series("Audio encoder number of channels", LineStyle::kLine,
1702 PointStyle::kHighlight);
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001703 auto GetAnaNumChannels =
1704 [](const LoggedAudioNetworkAdaptationEvent& ana_event) {
michaelt6e5b2192017-02-22 07:33:27 -08001705 if (ana_event.config.num_channels)
Danil Chapovalov431abd92018-06-18 12:54:17 +02001706 return absl::optional<float>(
michaelt6e5b2192017-02-22 07:33:27 -08001707 static_cast<float>(*ana_event.config.num_channels));
Danil Chapovalov431abd92018-06-18 12:54:17 +02001708 return absl::optional<float>();
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001709 };
Stefan Holmer1d4a2272018-05-24 13:48:09 +02001710 auto ToCallTime = [this](const LoggedAudioNetworkAdaptationEvent& packet) {
Bjorn Terelius068fc352019-02-13 22:38:25 +01001711 return this->config_.GetCallTimeSec(packet.log_time_us());
Stefan Holmer1d4a2272018-05-24 13:48:09 +02001712 };
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001713 ProcessPoints<LoggedAudioNetworkAdaptationEvent>(
Stefan Holmer1d4a2272018-05-24 13:48:09 +02001714 ToCallTime, GetAnaNumChannels,
1715 parsed_log_.audio_network_adaptation_events(), &time_series);
philipel35ba9bd2017-04-19 05:58:51 -07001716 plot->AppendTimeSeries(std::move(time_series));
Bjorn Terelius068fc352019-02-13 22:38:25 +01001717 plot->SetXAxis(config_.CallBeginTimeSec(), config_.CallEndTimeSec(),
1718 "Time (s)", kLeftMargin, kRightMargin);
michaelt6e5b2192017-02-22 07:33:27 -08001719 plot->SetSuggestedYAxis(0, 1, "Number of channels (1 (mono)/2 (stereo))",
1720 kBottomMargin, kTopMargin);
1721 plot->SetTitle("Reported audio encoder number of channels");
1722}
henrik.lundin3c938fc2017-06-14 06:09:58 -07001723
1724class NetEqStreamInput : public test::NetEqInput {
1725 public:
1726 // Does not take any ownership, and all pointers must refer to valid objects
1727 // that outlive the one constructed.
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001728 NetEqStreamInput(const std::vector<LoggedRtpPacketIncoming>* packet_stream,
Minyue Li27e2b7d2018-05-07 15:20:24 +02001729 const std::vector<LoggedAudioPlayoutEvent>* output_events,
Danil Chapovalov431abd92018-06-18 12:54:17 +02001730 absl::optional<int64_t> end_time_ms)
henrik.lundin3c938fc2017-06-14 06:09:58 -07001731 : packet_stream_(*packet_stream),
1732 packet_stream_it_(packet_stream_.begin()),
Minyue Li27e2b7d2018-05-07 15:20:24 +02001733 output_events_it_(output_events->begin()),
1734 output_events_end_(output_events->end()),
1735 end_time_ms_(end_time_ms) {
henrik.lundin3c938fc2017-06-14 06:09:58 -07001736 RTC_DCHECK(packet_stream);
Minyue Li27e2b7d2018-05-07 15:20:24 +02001737 RTC_DCHECK(output_events);
henrik.lundin3c938fc2017-06-14 06:09:58 -07001738 }
1739
Danil Chapovalov431abd92018-06-18 12:54:17 +02001740 absl::optional<int64_t> NextPacketTime() const override {
henrik.lundin3c938fc2017-06-14 06:09:58 -07001741 if (packet_stream_it_ == packet_stream_.end()) {
Danil Chapovalov431abd92018-06-18 12:54:17 +02001742 return absl::nullopt;
henrik.lundin3c938fc2017-06-14 06:09:58 -07001743 }
Minyue Li27e2b7d2018-05-07 15:20:24 +02001744 if (end_time_ms_ && packet_stream_it_->rtp.log_time_ms() > *end_time_ms_) {
Danil Chapovalov431abd92018-06-18 12:54:17 +02001745 return absl::nullopt;
henrik.lundin3c938fc2017-06-14 06:09:58 -07001746 }
Minyue Li27e2b7d2018-05-07 15:20:24 +02001747 return packet_stream_it_->rtp.log_time_ms();
henrik.lundin3c938fc2017-06-14 06:09:58 -07001748 }
1749
Danil Chapovalov431abd92018-06-18 12:54:17 +02001750 absl::optional<int64_t> NextOutputEventTime() const override {
Minyue Li27e2b7d2018-05-07 15:20:24 +02001751 if (output_events_it_ == output_events_end_) {
Danil Chapovalov431abd92018-06-18 12:54:17 +02001752 return absl::nullopt;
henrik.lundin3c938fc2017-06-14 06:09:58 -07001753 }
Minyue Li27e2b7d2018-05-07 15:20:24 +02001754 if (end_time_ms_ && output_events_it_->log_time_ms() > *end_time_ms_) {
Danil Chapovalov431abd92018-06-18 12:54:17 +02001755 return absl::nullopt;
henrik.lundin3c938fc2017-06-14 06:09:58 -07001756 }
Minyue Li27e2b7d2018-05-07 15:20:24 +02001757 return output_events_it_->log_time_ms();
henrik.lundin3c938fc2017-06-14 06:09:58 -07001758 }
1759
1760 std::unique_ptr<PacketData> PopPacket() override {
1761 if (packet_stream_it_ == packet_stream_.end()) {
1762 return std::unique_ptr<PacketData>();
1763 }
1764 std::unique_ptr<PacketData> packet_data(new PacketData());
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001765 packet_data->header = packet_stream_it_->rtp.header;
Minyue Li27e2b7d2018-05-07 15:20:24 +02001766 packet_data->time_ms = packet_stream_it_->rtp.log_time_ms();
henrik.lundin3c938fc2017-06-14 06:09:58 -07001767
1768 // This is a header-only "dummy" packet. Set the payload to all zeros, with
1769 // length according to the virtual length.
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001770 packet_data->payload.SetSize(packet_stream_it_->rtp.total_length -
1771 packet_stream_it_->rtp.header_length);
henrik.lundin3c938fc2017-06-14 06:09:58 -07001772 std::fill_n(packet_data->payload.data(), packet_data->payload.size(), 0);
1773
1774 ++packet_stream_it_;
1775 return packet_data;
1776 }
1777
1778 void AdvanceOutputEvent() override {
Minyue Li27e2b7d2018-05-07 15:20:24 +02001779 if (output_events_it_ != output_events_end_) {
1780 ++output_events_it_;
henrik.lundin3c938fc2017-06-14 06:09:58 -07001781 }
1782 }
1783
1784 bool ended() const override { return !NextEventTime(); }
1785
Danil Chapovalov431abd92018-06-18 12:54:17 +02001786 absl::optional<RTPHeader> NextHeader() const override {
henrik.lundin3c938fc2017-06-14 06:09:58 -07001787 if (packet_stream_it_ == packet_stream_.end()) {
Danil Chapovalov431abd92018-06-18 12:54:17 +02001788 return absl::nullopt;
henrik.lundin3c938fc2017-06-14 06:09:58 -07001789 }
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001790 return packet_stream_it_->rtp.header;
henrik.lundin3c938fc2017-06-14 06:09:58 -07001791 }
1792
1793 private:
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001794 const std::vector<LoggedRtpPacketIncoming>& packet_stream_;
1795 std::vector<LoggedRtpPacketIncoming>::const_iterator packet_stream_it_;
Minyue Li27e2b7d2018-05-07 15:20:24 +02001796 std::vector<LoggedAudioPlayoutEvent>::const_iterator output_events_it_;
1797 const std::vector<LoggedAudioPlayoutEvent>::const_iterator output_events_end_;
Danil Chapovalov431abd92018-06-18 12:54:17 +02001798 const absl::optional<int64_t> end_time_ms_;
henrik.lundin3c938fc2017-06-14 06:09:58 -07001799};
1800
1801namespace {
Bjorn Terelius6c4b1b72019-01-11 13:01:29 +01001802
1803// Factory to create a "replacement decoder" that produces the decoded audio
1804// by reading from a file rather than from the encoded payloads.
1805class ReplacementAudioDecoderFactory : public AudioDecoderFactory {
1806 public:
1807 ReplacementAudioDecoderFactory(const absl::string_view replacement_file_name,
1808 int file_sample_rate_hz)
1809 : replacement_file_name_(replacement_file_name),
1810 file_sample_rate_hz_(file_sample_rate_hz) {}
1811
1812 std::vector<AudioCodecSpec> GetSupportedDecoders() override {
1813 RTC_NOTREACHED();
1814 return {};
1815 }
1816
1817 bool IsSupportedDecoder(const SdpAudioFormat& format) override {
1818 return true;
1819 }
1820
1821 std::unique_ptr<AudioDecoder> MakeAudioDecoder(
1822 const SdpAudioFormat& format,
1823 absl::optional<AudioCodecPairId> codec_pair_id) override {
1824 auto replacement_file = absl::make_unique<test::ResampleInputAudioFile>(
1825 replacement_file_name_, file_sample_rate_hz_);
1826 replacement_file->set_output_rate_hz(48000);
1827 return absl::make_unique<test::FakeDecodeFromFile>(
1828 std::move(replacement_file), 48000, false);
1829 }
1830
1831 private:
1832 const std::string replacement_file_name_;
1833 const int file_sample_rate_hz_;
1834};
1835
henrik.lundin3c938fc2017-06-14 06:09:58 -07001836// Creates a NetEq test object and all necessary input and output helpers. Runs
1837// the test and returns the NetEqDelayAnalyzer object that was used to
1838// instrument the test.
Minyue Lic6ff7572018-05-04 09:46:44 +02001839std::unique_ptr<test::NetEqStatsGetter> CreateNetEqTestAndRun(
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001840 const std::vector<LoggedRtpPacketIncoming>* packet_stream,
Minyue Li27e2b7d2018-05-07 15:20:24 +02001841 const std::vector<LoggedAudioPlayoutEvent>* output_events,
Danil Chapovalov431abd92018-06-18 12:54:17 +02001842 absl::optional<int64_t> end_time_ms,
henrik.lundin3c938fc2017-06-14 06:09:58 -07001843 const std::string& replacement_file_name,
1844 int file_sample_rate_hz) {
1845 std::unique_ptr<test::NetEqInput> input(
Minyue Li27e2b7d2018-05-07 15:20:24 +02001846 new NetEqStreamInput(packet_stream, output_events, end_time_ms));
henrik.lundin3c938fc2017-06-14 06:09:58 -07001847
1848 constexpr int kReplacementPt = 127;
1849 std::set<uint8_t> cn_types;
1850 std::set<uint8_t> forbidden_types;
1851 input.reset(new test::NetEqReplacementInput(std::move(input), kReplacementPt,
1852 cn_types, forbidden_types));
1853
1854 NetEq::Config config;
1855 config.max_packets_in_buffer = 200;
1856 config.enable_fast_accelerate = true;
1857
1858 std::unique_ptr<test::VoidAudioSink> output(new test::VoidAudioSink());
1859
Niels Möller3f651d82018-12-19 15:06:17 +01001860 rtc::scoped_refptr<AudioDecoderFactory> decoder_factory =
Bjorn Terelius6c4b1b72019-01-11 13:01:29 +01001861 new rtc::RefCountedObject<ReplacementAudioDecoderFactory>(
1862 replacement_file_name, file_sample_rate_hz);
Niels Möller3f651d82018-12-19 15:06:17 +01001863
Niels Möller05543682019-01-10 16:55:06 +01001864 test::NetEqTest::DecoderMap codecs = {
1865 {kReplacementPt, SdpAudioFormat("l16", 48000, 1)}};
henrik.lundin3c938fc2017-06-14 06:09:58 -07001866
1867 std::unique_ptr<test::NetEqDelayAnalyzer> delay_cb(
1868 new test::NetEqDelayAnalyzer);
Minyue Lic6ff7572018-05-04 09:46:44 +02001869 std::unique_ptr<test::NetEqStatsGetter> neteq_stats_getter(
1870 new test::NetEqStatsGetter(std::move(delay_cb)));
henrik.lundin3c938fc2017-06-14 06:09:58 -07001871 test::DefaultNetEqTestErrorCallback error_cb;
1872 test::NetEqTest::Callbacks callbacks;
1873 callbacks.error_callback = &error_cb;
Minyue Lic6ff7572018-05-04 09:46:44 +02001874 callbacks.post_insert_packet = neteq_stats_getter->delay_analyzer();
1875 callbacks.get_audio_callback = neteq_stats_getter.get();
henrik.lundin3c938fc2017-06-14 06:09:58 -07001876
Niels Möllerbd6dee82019-01-02 09:39:47 +01001877 test::NetEqTest test(config, decoder_factory, codecs, nullptr,
Niels Möller3f651d82018-12-19 15:06:17 +01001878 std::move(input), std::move(output), callbacks);
henrik.lundin3c938fc2017-06-14 06:09:58 -07001879 test.Run();
Minyue Lic6ff7572018-05-04 09:46:44 +02001880 return neteq_stats_getter;
henrik.lundin3c938fc2017-06-14 06:09:58 -07001881}
1882} // namespace
1883
Minyue Lic6ff7572018-05-04 09:46:44 +02001884EventLogAnalyzer::NetEqStatsGetterMap EventLogAnalyzer::SimulateNetEq(
henrik.lundin3c938fc2017-06-14 06:09:58 -07001885 const std::string& replacement_file_name,
Minyue Lic6ff7572018-05-04 09:46:44 +02001886 int file_sample_rate_hz) const {
1887 NetEqStatsGetterMap neteq_stats;
1888
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001889 for (const auto& stream : parsed_log_.incoming_rtp_packets_by_ssrc()) {
Minyue Li27e2b7d2018-05-07 15:20:24 +02001890 const uint32_t ssrc = stream.ssrc;
1891 if (!IsAudioSsrc(kIncomingPacket, ssrc))
1892 continue;
1893 const std::vector<LoggedRtpPacketIncoming>* audio_packets =
1894 &stream.incoming_packets;
1895 if (audio_packets == nullptr) {
1896 // No incoming audio stream found.
1897 continue;
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02001898 }
henrik.lundin3c938fc2017-06-14 06:09:58 -07001899
Minyue Li27e2b7d2018-05-07 15:20:24 +02001900 RTC_DCHECK(neteq_stats.find(ssrc) == neteq_stats.end());
1901
1902 std::map<uint32_t, std::vector<LoggedAudioPlayoutEvent>>::const_iterator
1903 output_events_it = parsed_log_.audio_playout_events().find(ssrc);
1904 if (output_events_it == parsed_log_.audio_playout_events().end()) {
1905 // Could not find output events with SSRC matching the input audio stream.
1906 // Using the first available stream of output events.
1907 output_events_it = parsed_log_.audio_playout_events().cbegin();
1908 }
1909
Danil Chapovalov431abd92018-06-18 12:54:17 +02001910 absl::optional<int64_t> end_time_ms =
Minyue Li27e2b7d2018-05-07 15:20:24 +02001911 log_segments_.empty()
Danil Chapovalov431abd92018-06-18 12:54:17 +02001912 ? absl::nullopt
1913 : absl::optional<int64_t>(log_segments_.front().second / 1000);
Minyue Li27e2b7d2018-05-07 15:20:24 +02001914
1915 neteq_stats[ssrc] = CreateNetEqTestAndRun(
1916 audio_packets, &output_events_it->second, end_time_ms,
1917 replacement_file_name, file_sample_rate_hz);
henrik.lundin3c938fc2017-06-14 06:09:58 -07001918 }
1919
Minyue Lic6ff7572018-05-04 09:46:44 +02001920 return neteq_stats;
1921}
1922
Minyue Lic97933f2018-08-10 12:51:15 +02001923// Given a NetEqStatsGetter and the SSRC that the NetEqStatsGetter was created
1924// for, this method generates a plot for the jitter buffer delay profile.
Minyue Lic6ff7572018-05-04 09:46:44 +02001925void EventLogAnalyzer::CreateAudioJitterBufferGraph(
Minyue Li01d2a672018-06-21 21:17:19 +02001926 uint32_t ssrc,
1927 const test::NetEqStatsGetter* stats_getter,
Minyue Lic6ff7572018-05-04 09:46:44 +02001928 Plot* plot) const {
Minyue Li45fc6df2018-06-21 11:47:14 +02001929 test::NetEqDelayAnalyzer::Delays arrival_delay_ms;
1930 test::NetEqDelayAnalyzer::Delays corrected_arrival_delay_ms;
1931 test::NetEqDelayAnalyzer::Delays playout_delay_ms;
1932 test::NetEqDelayAnalyzer::Delays target_delay_ms;
1933
Minyue Li01d2a672018-06-21 21:17:19 +02001934 stats_getter->delay_analyzer()->CreateGraphs(
Minyue Li45fc6df2018-06-21 11:47:14 +02001935 &arrival_delay_ms, &corrected_arrival_delay_ms, &playout_delay_ms,
1936 &target_delay_ms);
henrik.lundin3c938fc2017-06-14 06:09:58 -07001937
Minyue Lic97933f2018-08-10 12:51:15 +02001938 TimeSeries time_series_packet_arrival("packet arrival delay",
1939 LineStyle::kLine);
1940 TimeSeries time_series_relative_packet_arrival(
1941 "Relative packet arrival delay", LineStyle::kLine);
1942 TimeSeries time_series_play_time("Playout delay", LineStyle::kLine);
1943 TimeSeries time_series_target_time("Target delay", LineStyle::kLine,
1944 PointStyle::kHighlight);
Minyue Li45fc6df2018-06-21 11:47:14 +02001945
1946 for (const auto& data : arrival_delay_ms) {
Bjorn Terelius068fc352019-02-13 22:38:25 +01001947 const float x = config_.GetCallTimeSec(data.first * 1000); // ms to us.
Minyue Li45fc6df2018-06-21 11:47:14 +02001948 const float y = data.second;
Minyue Lic97933f2018-08-10 12:51:15 +02001949 time_series_packet_arrival.points.emplace_back(TimeSeriesPoint(x, y));
Minyue Li45fc6df2018-06-21 11:47:14 +02001950 }
1951 for (const auto& data : corrected_arrival_delay_ms) {
Bjorn Terelius068fc352019-02-13 22:38:25 +01001952 const float x = config_.GetCallTimeSec(data.first * 1000); // ms to us.
Minyue Li45fc6df2018-06-21 11:47:14 +02001953 const float y = data.second;
Minyue Lic97933f2018-08-10 12:51:15 +02001954 time_series_relative_packet_arrival.points.emplace_back(
Minyue Li45fc6df2018-06-21 11:47:14 +02001955 TimeSeriesPoint(x, y));
1956 }
1957 for (const auto& data : playout_delay_ms) {
Bjorn Terelius068fc352019-02-13 22:38:25 +01001958 const float x = config_.GetCallTimeSec(data.first * 1000); // ms to us.
Minyue Li45fc6df2018-06-21 11:47:14 +02001959 const float y = data.second;
Minyue Lic97933f2018-08-10 12:51:15 +02001960 time_series_play_time.points.emplace_back(TimeSeriesPoint(x, y));
Minyue Li45fc6df2018-06-21 11:47:14 +02001961 }
1962 for (const auto& data : target_delay_ms) {
Bjorn Terelius068fc352019-02-13 22:38:25 +01001963 const float x = config_.GetCallTimeSec(data.first * 1000); // ms to us.
Minyue Li45fc6df2018-06-21 11:47:14 +02001964 const float y = data.second;
Minyue Lic97933f2018-08-10 12:51:15 +02001965 time_series_target_time.points.emplace_back(TimeSeriesPoint(x, y));
henrik.lundin3c938fc2017-06-14 06:09:58 -07001966 }
1967
Minyue Lic97933f2018-08-10 12:51:15 +02001968 plot->AppendTimeSeries(std::move(time_series_packet_arrival));
1969 plot->AppendTimeSeries(std::move(time_series_relative_packet_arrival));
1970 plot->AppendTimeSeries(std::move(time_series_play_time));
1971 plot->AppendTimeSeries(std::move(time_series_target_time));
henrik.lundin3c938fc2017-06-14 06:09:58 -07001972
Bjorn Terelius068fc352019-02-13 22:38:25 +01001973 plot->SetXAxis(config_.CallBeginTimeSec(), config_.CallEndTimeSec(),
1974 "Time (s)", kLeftMargin, kRightMargin);
Minyue Li45fc6df2018-06-21 11:47:14 +02001975 plot->SetSuggestedYAxis(0, 1, "Relative delay (ms)", kBottomMargin,
1976 kTopMargin);
Minyue Li27e2b7d2018-05-07 15:20:24 +02001977 plot->SetTitle("NetEq timing for " + GetStreamName(kIncomingPacket, ssrc));
1978}
1979
Minyue Lic9ac93f2018-06-26 13:01:32 +02001980template <typename NetEqStatsType>
1981void EventLogAnalyzer::CreateNetEqStatsGraphInternal(
Minyue Li27e2b7d2018-05-07 15:20:24 +02001982 const NetEqStatsGetterMap& neteq_stats,
Minyue Lic9ac93f2018-06-26 13:01:32 +02001983 rtc::FunctionView<const std::vector<std::pair<int64_t, NetEqStatsType>>*(
1984 const test::NetEqStatsGetter*)> data_extractor,
1985 rtc::FunctionView<float(const NetEqStatsType&)> stats_extractor,
Minyue Li27e2b7d2018-05-07 15:20:24 +02001986 const std::string& plot_name,
1987 Plot* plot) const {
Minyue Li27e2b7d2018-05-07 15:20:24 +02001988 std::map<uint32_t, TimeSeries> time_series;
Minyue Li27e2b7d2018-05-07 15:20:24 +02001989
1990 for (const auto& st : neteq_stats) {
1991 const uint32_t ssrc = st.first;
Minyue Lic9ac93f2018-06-26 13:01:32 +02001992 const std::vector<std::pair<int64_t, NetEqStatsType>>* data_vector =
1993 data_extractor(st.second.get());
1994 for (const auto& data : *data_vector) {
Bjorn Terelius068fc352019-02-13 22:38:25 +01001995 const float time =
1996 config_.GetCallTimeSec(data.first * 1000); // ms to us.
Minyue Lic9ac93f2018-06-26 13:01:32 +02001997 const float value = stats_extractor(data.second);
Minyue Li27e2b7d2018-05-07 15:20:24 +02001998 time_series[ssrc].points.emplace_back(TimeSeriesPoint(time, value));
Minyue Li27e2b7d2018-05-07 15:20:24 +02001999 }
2000 }
2001
2002 for (auto& series : time_series) {
2003 series.second.label = GetStreamName(kIncomingPacket, series.first);
2004 series.second.line_style = LineStyle::kLine;
2005 plot->AppendTimeSeries(std::move(series.second));
2006 }
2007
Bjorn Terelius068fc352019-02-13 22:38:25 +01002008 plot->SetXAxis(config_.CallBeginTimeSec(), config_.CallEndTimeSec(),
2009 "Time (s)", kLeftMargin, kRightMargin);
Minyue Li45fc6df2018-06-21 11:47:14 +02002010 plot->SetSuggestedYAxis(0, 1, plot_name, kBottomMargin, kTopMargin);
Minyue Li27e2b7d2018-05-07 15:20:24 +02002011 plot->SetTitle(plot_name);
henrik.lundin3c938fc2017-06-14 06:09:58 -07002012}
Bjorn Terelius2eb31882017-11-30 15:15:25 +01002013
Minyue Lic9ac93f2018-06-26 13:01:32 +02002014void EventLogAnalyzer::CreateNetEqNetworkStatsGraph(
2015 const NetEqStatsGetterMap& neteq_stats,
2016 rtc::FunctionView<float(const NetEqNetworkStatistics&)> stats_extractor,
2017 const std::string& plot_name,
2018 Plot* plot) const {
2019 CreateNetEqStatsGraphInternal<NetEqNetworkStatistics>(
2020 neteq_stats,
2021 [](const test::NetEqStatsGetter* stats_getter) {
2022 return stats_getter->stats();
2023 },
2024 stats_extractor, plot_name, plot);
2025}
2026
2027void EventLogAnalyzer::CreateNetEqLifetimeStatsGraph(
2028 const NetEqStatsGetterMap& neteq_stats,
2029 rtc::FunctionView<float(const NetEqLifetimeStatistics&)> stats_extractor,
2030 const std::string& plot_name,
2031 Plot* plot) const {
2032 CreateNetEqStatsGraphInternal<NetEqLifetimeStatistics>(
2033 neteq_stats,
2034 [](const test::NetEqStatsGetter* stats_getter) {
2035 return stats_getter->lifetime_stats();
2036 },
2037 stats_extractor, plot_name, plot);
2038}
2039
Qingsi Wang8eca1ff2018-02-02 11:49:44 -08002040void EventLogAnalyzer::CreateIceCandidatePairConfigGraph(Plot* plot) {
2041 std::map<uint32_t, TimeSeries> configs_by_cp_id;
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02002042 for (const auto& config : parsed_log_.ice_candidate_pair_configs()) {
Qingsi Wang8eca1ff2018-02-02 11:49:44 -08002043 if (configs_by_cp_id.find(config.candidate_pair_id) ==
2044 configs_by_cp_id.end()) {
2045 const std::string candidate_pair_desc =
2046 GetCandidatePairLogDescriptionAsString(config);
Qingsi Wang93a84392018-01-30 17:13:09 -08002047 configs_by_cp_id[config.candidate_pair_id] =
2048 TimeSeries("[" + std::to_string(config.candidate_pair_id) + "]" +
2049 candidate_pair_desc,
2050 LineStyle::kNone, PointStyle::kHighlight);
Qingsi Wang8eca1ff2018-02-02 11:49:44 -08002051 candidate_pair_desc_by_id_[config.candidate_pair_id] =
2052 candidate_pair_desc;
2053 }
Bjorn Terelius068fc352019-02-13 22:38:25 +01002054 float x = config_.GetCallTimeSec(config.log_time_us());
Qingsi Wang8eca1ff2018-02-02 11:49:44 -08002055 float y = static_cast<float>(config.type);
2056 configs_by_cp_id[config.candidate_pair_id].points.emplace_back(x, y);
2057 }
2058
2059 // TODO(qingsi): There can be a large number of candidate pairs generated by
2060 // certain calls and the frontend cannot render the chart in this case due to
2061 // the failure of generating a palette with the same number of colors.
2062 for (auto& kv : configs_by_cp_id) {
2063 plot->AppendTimeSeries(std::move(kv.second));
2064 }
2065
Bjorn Terelius068fc352019-02-13 22:38:25 +01002066 plot->SetXAxis(config_.CallBeginTimeSec(), config_.CallEndTimeSec(),
2067 "Time (s)", kLeftMargin, kRightMargin);
Qingsi Wang8eca1ff2018-02-02 11:49:44 -08002068 plot->SetSuggestedYAxis(0, 3, "Numeric Config Type", kBottomMargin,
2069 kTopMargin);
2070 plot->SetTitle("[IceEventLog] ICE candidate pair configs");
2071}
2072
2073std::string EventLogAnalyzer::GetCandidatePairLogDescriptionFromId(
2074 uint32_t candidate_pair_id) {
2075 if (candidate_pair_desc_by_id_.find(candidate_pair_id) !=
2076 candidate_pair_desc_by_id_.end()) {
2077 return candidate_pair_desc_by_id_[candidate_pair_id];
2078 }
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02002079 for (const auto& config : parsed_log_.ice_candidate_pair_configs()) {
Qingsi Wang8eca1ff2018-02-02 11:49:44 -08002080 // TODO(qingsi): Add the handling of the "Updated" config event after the
2081 // visualization of property change for candidate pairs is introduced.
2082 if (candidate_pair_desc_by_id_.find(config.candidate_pair_id) ==
2083 candidate_pair_desc_by_id_.end()) {
2084 const std::string candidate_pair_desc =
2085 GetCandidatePairLogDescriptionAsString(config);
2086 candidate_pair_desc_by_id_[config.candidate_pair_id] =
2087 candidate_pair_desc;
2088 }
2089 }
2090 return candidate_pair_desc_by_id_[candidate_pair_id];
2091}
2092
2093void EventLogAnalyzer::CreateIceConnectivityCheckGraph(Plot* plot) {
2094 std::map<uint32_t, TimeSeries> checks_by_cp_id;
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02002095 for (const auto& event : parsed_log_.ice_candidate_pair_events()) {
Qingsi Wang8eca1ff2018-02-02 11:49:44 -08002096 if (checks_by_cp_id.find(event.candidate_pair_id) ==
2097 checks_by_cp_id.end()) {
2098 checks_by_cp_id[event.candidate_pair_id] = TimeSeries(
Qingsi Wang93a84392018-01-30 17:13:09 -08002099 "[" + std::to_string(event.candidate_pair_id) + "]" +
2100 GetCandidatePairLogDescriptionFromId(event.candidate_pair_id),
Qingsi Wang8eca1ff2018-02-02 11:49:44 -08002101 LineStyle::kNone, PointStyle::kHighlight);
2102 }
Bjorn Terelius068fc352019-02-13 22:38:25 +01002103 float x = config_.GetCallTimeSec(event.log_time_us());
Zach Stein6353fbc2018-12-03 14:35:59 -08002104 constexpr int kIceCandidatePairEventTypeOffset =
2105 static_cast<int>(IceCandidatePairConfigType::kNumValues);
2106 float y = static_cast<float>(event.type) + kIceCandidatePairEventTypeOffset;
Qingsi Wang8eca1ff2018-02-02 11:49:44 -08002107 checks_by_cp_id[event.candidate_pair_id].points.emplace_back(x, y);
2108 }
2109
2110 // TODO(qingsi): The same issue as in CreateIceCandidatePairConfigGraph.
2111 for (auto& kv : checks_by_cp_id) {
2112 plot->AppendTimeSeries(std::move(kv.second));
2113 }
2114
Bjorn Terelius068fc352019-02-13 22:38:25 +01002115 plot->SetXAxis(config_.CallBeginTimeSec(), config_.CallEndTimeSec(),
2116 "Time (s)", kLeftMargin, kRightMargin);
Qingsi Wang8eca1ff2018-02-02 11:49:44 -08002117 plot->SetSuggestedYAxis(0, 4, "Numeric Connectivity State", kBottomMargin,
2118 kTopMargin);
2119 plot->SetTitle("[IceEventLog] ICE connectivity checks");
2120}
2121
Zach Stein10a58012018-12-07 12:26:28 -08002122void EventLogAnalyzer::CreateDtlsTransportStateGraph(Plot* plot) {
2123 TimeSeries states("DTLS Transport State", LineStyle::kNone,
2124 PointStyle::kHighlight);
2125 for (const auto& event : parsed_log_.dtls_transport_states()) {
Bjorn Terelius068fc352019-02-13 22:38:25 +01002126 float x = config_.GetCallTimeSec(event.log_time_us());
Zach Stein10a58012018-12-07 12:26:28 -08002127 float y = static_cast<float>(event.dtls_transport_state);
2128 states.points.emplace_back(x, y);
2129 }
2130 plot->AppendTimeSeries(std::move(states));
Bjorn Terelius068fc352019-02-13 22:38:25 +01002131 plot->SetXAxis(config_.CallBeginTimeSec(), config_.CallEndTimeSec(),
2132 "Time (s)", kLeftMargin, kRightMargin);
Zach Stein10a58012018-12-07 12:26:28 -08002133 plot->SetSuggestedYAxis(0, static_cast<float>(DtlsTransportState::kNumValues),
2134 "Numeric Transport State", kBottomMargin, kTopMargin);
2135 plot->SetTitle("DTLS Transport State");
2136}
2137
2138void EventLogAnalyzer::CreateDtlsWritableStateGraph(Plot* plot) {
2139 TimeSeries writable("DTLS Writable", LineStyle::kNone,
2140 PointStyle::kHighlight);
2141 for (const auto& event : parsed_log_.dtls_writable_states()) {
Bjorn Terelius068fc352019-02-13 22:38:25 +01002142 float x = config_.GetCallTimeSec(event.log_time_us());
Zach Stein10a58012018-12-07 12:26:28 -08002143 float y = static_cast<float>(event.writable);
2144 writable.points.emplace_back(x, y);
2145 }
2146 plot->AppendTimeSeries(std::move(writable));
Bjorn Terelius068fc352019-02-13 22:38:25 +01002147 plot->SetXAxis(config_.CallBeginTimeSec(), config_.CallEndTimeSec(),
2148 "Time (s)", kLeftMargin, kRightMargin);
Zach Stein10a58012018-12-07 12:26:28 -08002149 plot->SetSuggestedYAxis(0, 1, "Writable", kBottomMargin, kTopMargin);
2150 plot->SetTitle("DTLS Writable State");
2151}
2152
Bjorn Terelius2eb31882017-11-30 15:15:25 +01002153void EventLogAnalyzer::PrintNotifications(FILE* file) {
Bjorn Terelius2eb31882017-11-30 15:15:25 +01002154 fprintf(file, "========== TRIAGE NOTIFICATIONS ==========\n");
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02002155 for (const auto& alert : incoming_rtp_recv_time_gaps_) {
2156 fprintf(file, "%3.3lf s : %s\n", alert.Time(), alert.ToString().c_str());
2157 }
2158 for (const auto& alert : incoming_rtcp_recv_time_gaps_) {
2159 fprintf(file, "%3.3lf s : %s\n", alert.Time(), alert.ToString().c_str());
2160 }
2161 for (const auto& alert : outgoing_rtp_send_time_gaps_) {
2162 fprintf(file, "%3.3lf s : %s\n", alert.Time(), alert.ToString().c_str());
2163 }
2164 for (const auto& alert : outgoing_rtcp_send_time_gaps_) {
2165 fprintf(file, "%3.3lf s : %s\n", alert.Time(), alert.ToString().c_str());
2166 }
2167 for (const auto& alert : incoming_seq_num_jumps_) {
2168 fprintf(file, "%3.3lf s : %s\n", alert.Time(), alert.ToString().c_str());
2169 }
2170 for (const auto& alert : incoming_capture_time_jumps_) {
2171 fprintf(file, "%3.3lf s : %s\n", alert.Time(), alert.ToString().c_str());
2172 }
2173 for (const auto& alert : outgoing_seq_num_jumps_) {
2174 fprintf(file, "%3.3lf s : %s\n", alert.Time(), alert.ToString().c_str());
2175 }
2176 for (const auto& alert : outgoing_capture_time_jumps_) {
2177 fprintf(file, "%3.3lf s : %s\n", alert.Time(), alert.ToString().c_str());
2178 }
2179 for (const auto& alert : outgoing_high_loss_alerts_) {
2180 fprintf(file, " : %s\n", alert.ToString().c_str());
Bjorn Terelius2eb31882017-11-30 15:15:25 +01002181 }
2182 fprintf(file, "========== END TRIAGE NOTIFICATIONS ==========\n");
2183}
2184
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02002185void EventLogAnalyzer::CreateStreamGapAlerts(PacketDirection direction) {
2186 // With 100 packets/s (~800kbps), false positives would require 10 s without
2187 // data.
2188 constexpr int64_t kMaxSeqNumJump = 1000;
2189 // With a 90 kHz clock, false positives would require 10 s without data.
2190 constexpr int64_t kMaxCaptureTimeJump = 900000;
2191
2192 int64_t end_time_us = log_segments_.empty()
2193 ? std::numeric_limits<int64_t>::max()
2194 : log_segments_.front().second;
2195
2196 SeqNumUnwrapper<uint16_t> seq_num_unwrapper;
Danil Chapovalov431abd92018-06-18 12:54:17 +02002197 absl::optional<int64_t> last_seq_num;
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02002198 SeqNumUnwrapper<uint32_t> capture_time_unwrapper;
Danil Chapovalov431abd92018-06-18 12:54:17 +02002199 absl::optional<int64_t> last_capture_time;
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02002200 // Check for gaps in sequence numbers and capture timestamps.
2201 for (const auto& stream : parsed_log_.rtp_packets_by_ssrc(direction)) {
2202 for (const auto& packet : stream.packet_view) {
2203 if (packet.log_time_us() > end_time_us) {
2204 // Only process the first (LOG_START, LOG_END) segment.
2205 break;
2206 }
2207
2208 int64_t seq_num = seq_num_unwrapper.Unwrap(packet.header.sequenceNumber);
2209 if (last_seq_num.has_value() &&
2210 std::abs(seq_num - last_seq_num.value()) > kMaxSeqNumJump) {
Bjorn Terelius068fc352019-02-13 22:38:25 +01002211 Alert_SeqNumJump(direction,
2212 config_.GetCallTimeSec(packet.log_time_us()),
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02002213 packet.header.ssrc);
2214 }
2215 last_seq_num.emplace(seq_num);
2216
2217 int64_t capture_time =
2218 capture_time_unwrapper.Unwrap(packet.header.timestamp);
2219 if (last_capture_time.has_value() &&
2220 std::abs(capture_time - last_capture_time.value()) >
2221 kMaxCaptureTimeJump) {
Bjorn Terelius068fc352019-02-13 22:38:25 +01002222 Alert_CaptureTimeJump(direction,
2223 config_.GetCallTimeSec(packet.log_time_us()),
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02002224 packet.header.ssrc);
2225 }
2226 last_capture_time.emplace(capture_time);
2227 }
2228 }
2229}
2230
2231void EventLogAnalyzer::CreateTransmissionGapAlerts(PacketDirection direction) {
2232 constexpr int64_t kMaxRtpTransmissionGap = 500000;
2233 constexpr int64_t kMaxRtcpTransmissionGap = 2000000;
2234 int64_t end_time_us = log_segments_.empty()
2235 ? std::numeric_limits<int64_t>::max()
2236 : log_segments_.front().second;
2237
2238 // TODO(terelius): The parser could provide a list of all packets, ordered
2239 // by time, for each direction.
2240 std::multimap<int64_t, const LoggedRtpPacket*> rtp_in_direction;
2241 for (const auto& stream : parsed_log_.rtp_packets_by_ssrc(direction)) {
2242 for (const LoggedRtpPacket& rtp_packet : stream.packet_view)
2243 rtp_in_direction.emplace(rtp_packet.log_time_us(), &rtp_packet);
2244 }
Danil Chapovalov431abd92018-06-18 12:54:17 +02002245 absl::optional<int64_t> last_rtp_time;
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02002246 for (const auto& kv : rtp_in_direction) {
2247 int64_t timestamp = kv.first;
2248 if (timestamp > end_time_us) {
2249 // Only process the first (LOG_START, LOG_END) segment.
2250 break;
2251 }
2252 int64_t duration = timestamp - last_rtp_time.value_or(0);
2253 if (last_rtp_time.has_value() && duration > kMaxRtpTransmissionGap) {
2254 // No packet sent/received for more than 500 ms.
Bjorn Terelius068fc352019-02-13 22:38:25 +01002255 Alert_RtpLogTimeGap(direction, config_.GetCallTimeSec(timestamp),
2256 duration / 1000);
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02002257 }
2258 last_rtp_time.emplace(timestamp);
2259 }
2260
Danil Chapovalov431abd92018-06-18 12:54:17 +02002261 absl::optional<int64_t> last_rtcp_time;
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02002262 if (direction == kIncomingPacket) {
2263 for (const auto& rtcp : parsed_log_.incoming_rtcp_packets()) {
2264 if (rtcp.log_time_us() > end_time_us) {
2265 // Only process the first (LOG_START, LOG_END) segment.
2266 break;
2267 }
2268 int64_t duration = rtcp.log_time_us() - last_rtcp_time.value_or(0);
2269 if (last_rtcp_time.has_value() && duration > kMaxRtcpTransmissionGap) {
2270 // No feedback sent/received for more than 2000 ms.
Bjorn Terelius068fc352019-02-13 22:38:25 +01002271 Alert_RtcpLogTimeGap(direction,
2272 config_.GetCallTimeSec(rtcp.log_time_us()),
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02002273 duration / 1000);
2274 }
2275 last_rtcp_time.emplace(rtcp.log_time_us());
2276 }
2277 } else {
2278 for (const auto& rtcp : parsed_log_.outgoing_rtcp_packets()) {
2279 if (rtcp.log_time_us() > end_time_us) {
2280 // Only process the first (LOG_START, LOG_END) segment.
2281 break;
2282 }
2283 int64_t duration = rtcp.log_time_us() - last_rtcp_time.value_or(0);
2284 if (last_rtcp_time.has_value() && duration > kMaxRtcpTransmissionGap) {
2285 // No feedback sent/received for more than 2000 ms.
Bjorn Terelius068fc352019-02-13 22:38:25 +01002286 Alert_RtcpLogTimeGap(direction,
2287 config_.GetCallTimeSec(rtcp.log_time_us()),
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02002288 duration / 1000);
2289 }
2290 last_rtcp_time.emplace(rtcp.log_time_us());
2291 }
2292 }
2293}
2294
Bjorn Terelius2eb31882017-11-30 15:15:25 +01002295// TODO(terelius): Notifications could possibly be generated by the same code
2296// that produces the graphs. There is some code duplication that could be
2297// avoided, but that might be solved anyway when we move functionality from the
2298// analyzer to the parser.
2299void EventLogAnalyzer::CreateTriageNotifications() {
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02002300 CreateStreamGapAlerts(kIncomingPacket);
2301 CreateStreamGapAlerts(kOutgoingPacket);
2302 CreateTransmissionGapAlerts(kIncomingPacket);
2303 CreateTransmissionGapAlerts(kOutgoingPacket);
Bjorn Terelius2eb31882017-11-30 15:15:25 +01002304
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02002305 int64_t end_time_us = log_segments_.empty()
2306 ? std::numeric_limits<int64_t>::max()
2307 : log_segments_.front().second;
Bjorn Terelius2eb31882017-11-30 15:15:25 +01002308
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02002309 constexpr double kMaxLossFraction = 0.05;
Bjorn Terelius2eb31882017-11-30 15:15:25 +01002310 // Loss feedback
2311 int64_t total_lost_packets = 0;
2312 int64_t total_expected_packets = 0;
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02002313 for (auto& bwe_update : parsed_log_.bwe_loss_updates()) {
2314 if (bwe_update.log_time_us() > end_time_us) {
Bjorn Terelius2eb31882017-11-30 15:15:25 +01002315 // Only process the first (LOG_START, LOG_END) segment.
2316 break;
2317 }
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02002318 int64_t lost_packets = static_cast<double>(bwe_update.fraction_lost) / 255 *
Bjorn Terelius2eb31882017-11-30 15:15:25 +01002319 bwe_update.expected_packets;
2320 total_lost_packets += lost_packets;
2321 total_expected_packets += bwe_update.expected_packets;
2322 }
2323 double avg_outgoing_loss =
2324 static_cast<double>(total_lost_packets) / total_expected_packets;
Bjorn Tereliusc4ca1d32018-04-27 14:33:34 +02002325 if (avg_outgoing_loss > kMaxLossFraction) {
2326 Alert_OutgoingHighLoss(avg_outgoing_loss);
Bjorn Terelius2eb31882017-11-30 15:15:25 +01002327 }
2328}
2329
terelius54ce6802016-07-13 06:44:41 -07002330} // namespace webrtc