1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
|
/*
* Copyright (c) 2016 The WebRTC project authors. All Rights Reserved.
*
* Use of this source code is governed by a BSD-style license
* that can be found in the LICENSE file in the root of the source
* tree. An additional intellectual property rights grant can be found
* in the file PATENTS. All contributing project authors may
* be found in the AUTHORS file in the root of the source tree.
*/
#ifndef RTC_TOOLS_RTC_EVENT_LOG_VISUALIZER_ANALYZER_H_
#define RTC_TOOLS_RTC_EVENT_LOG_VISUALIZER_ANALYZER_H_
#include <cstdint>
#include <cstdio>
#include <functional>
#include <string>
#include <vector>
#include "api/environment/environment.h"
#include "api/function_view.h"
#include "logging/rtc_event_log/rtc_event_log_parser.h"
#include "modules/rtp_rtcp/source/rtcp_packet/report_block.h"
#include "rtc_base/checks.h"
#include "rtc_tools/rtc_event_log_visualizer/analyzer_common.h"
#include "rtc_tools/rtc_event_log_visualizer/plot_base.h"
namespace webrtc {
class EventLogAnalyzer {
struct PlotDeclaration {
PlotDeclaration(const std::string& label, std::function<void(Plot*)> f)
: label(label), plot_func(f) {}
const std::string label;
// TODO(terelius): Add a help text/explanation.
const std::function<void(Plot*)> plot_func;
};
class PlotMap {
public:
void RegisterPlot(const std::string& label, std::function<void(Plot*)> f) {
for (const auto& plot : plots_) {
RTC_DCHECK(plot.label != label)
<< "Can't use the same label for multiple plots";
}
plots_.push_back({label, f});
}
std::vector<PlotDeclaration>::const_iterator begin() const {
return plots_.begin();
}
std::vector<PlotDeclaration>::const_iterator end() const {
return plots_.end();
}
private:
std::vector<PlotDeclaration> plots_;
};
public:
// The EventLogAnalyzer keeps a reference to the ParsedRtcEventLogNew for the
// duration of its lifetime. The ParsedRtcEventLogNew must not be destroyed or
// modified while the EventLogAnalyzer is being used.
EventLogAnalyzer(const ParsedRtcEventLog& log, bool normalize_time);
EventLogAnalyzer(const Environment& env,
const ParsedRtcEventLog& log,
const AnalyzerConfig& config);
void CreateGraphsByName(const std::vector<std::string>& names,
PlotCollection* collection) const;
void InitializeMapOfNamedGraphs(bool show_detector_state,
bool show_alr_state,
bool show_link_capacity);
std::vector<std::string> GetGraphNames() const {
std::vector<std::string> plot_names;
for (const auto& plot : plots_) {
plot_names.push_back(plot.label);
}
return plot_names;
}
void CreatePacketGraph(PacketDirection direction, Plot* plot) const;
void CreateRtcpTypeGraph(PacketDirection direction, Plot* plot) const;
void CreateAccumulatedPacketsGraph(PacketDirection direction,
Plot* plot) const;
void CreatePacketRateGraph(PacketDirection direction, Plot* plot) const;
void CreateTotalPacketRateGraph(PacketDirection direction, Plot* plot) const;
void CreatePlayoutGraph(Plot* plot) const;
void CreateNetEqSetMinimumDelay(Plot* plot) const;
void CreateAudioLevelGraph(PacketDirection direction, Plot* plot) const;
void CreateSequenceNumberGraph(Plot* plot) const;
void CreateIncomingPacketLossGraph(Plot* plot) const;
void CreateIncomingDelayGraph(Plot* plot) const;
void CreateFractionLossGraph(Plot* plot) const;
void CreateTotalIncomingBitrateGraph(Plot* plot) const;
void CreateTotalOutgoingBitrateGraph(Plot* plot,
bool show_detector_state = false,
bool show_alr_state = false,
bool show_link_capacity = false) const;
void CreateStreamBitrateGraph(PacketDirection direction, Plot* plot) const;
void CreateBitrateAllocationGraph(PacketDirection direction,
Plot* plot) const;
void CreateOutgoingTWCCLossRateGraph(Plot* plot) const;
void CreateOutgoingEcnFeedbackGraph(Plot* plot) const;
void CreateIncomingEcnFeedbackGraph(Plot* plot) const;
void CreateGoogCcSimulationGraph(Plot* plot) const;
void CreateSendSideBweSimulationGraph(Plot* plot) const;
void CreateReceiveSideBweSimulationGraph(Plot* plot) const;
void CreateNetworkDelayFeedbackGraph(Plot* plot) const;
void CreatePacerDelayGraph(Plot* plot) const;
void CreateTimestampGraph(PacketDirection direction, Plot* plot) const;
void CreateSenderAndReceiverReportPlot(
PacketDirection direction,
FunctionView<float(const rtcp::ReportBlock&)> fy,
std::string title,
std::string yaxis_label,
Plot* plot) const;
void CreateIceCandidatePairConfigGraph(Plot* plot) const;
void CreateIceConnectivityCheckGraph(Plot* plot) const;
void CreateDtlsTransportStateGraph(Plot* plot) const;
void CreateDtlsWritableStateGraph(Plot* plot) const;
void CreateTriageNotifications() const;
void PrintNotifications(FILE* file) const;
private:
template <typename IterableType>
void CreateAccumulatedPacketsTimeSeries(Plot* plot,
const IterableType& packets,
const std::string& label) const;
void CreateEcnFeedbackGraph(Plot* plot, PacketDirection direction) const;
const Environment env_;
const ParsedRtcEventLog& parsed_log_;
// A list of SSRCs we are interested in analysing.
// If left empty, all SSRCs will be considered relevant.
std::vector<uint32_t> desired_ssrc_;
AnalyzerConfig config_;
PlotMap plots_;
};
} // namespace webrtc
#endif // RTC_TOOLS_RTC_EVENT_LOG_VISUALIZER_ANALYZER_H_
|
