| /* | |
| * Copyright 2012 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. | |
| */ | |
| #include "webrtc/pc/statscollector.h" | |
| #include <memory> | |
| #include <utility> | |
| #include <vector> | |
| #include "webrtc/pc/channel.h" | |
| #include "webrtc/pc/peerconnection.h" | |
| #include "webrtc/rtc_base/base64.h" | |
| #include "webrtc/rtc_base/checks.h" | |
| namespace webrtc { | |
| namespace { | |
| // The following is the enum RTCStatsIceCandidateType from | |
| // http://w3c.github.io/webrtc-stats/#rtcstatsicecandidatetype-enum such that | |
| // our stats report for ice candidate type could conform to that. | |
| const char STATSREPORT_LOCAL_PORT_TYPE[] = "host"; | |
| const char STATSREPORT_STUN_PORT_TYPE[] = "serverreflexive"; | |
| const char STATSREPORT_PRFLX_PORT_TYPE[] = "peerreflexive"; | |
| const char STATSREPORT_RELAY_PORT_TYPE[] = "relayed"; | |
| // Strings used by the stats collector to report adapter types. This fits the | |
| // general stype of http://w3c.github.io/webrtc-stats than what | |
| // AdapterTypeToString does. | |
| const char* STATSREPORT_ADAPTER_TYPE_ETHERNET = "lan"; | |
| const char* STATSREPORT_ADAPTER_TYPE_WIFI = "wlan"; | |
| const char* STATSREPORT_ADAPTER_TYPE_WWAN = "wwan"; | |
| const char* STATSREPORT_ADAPTER_TYPE_VPN = "vpn"; | |
| const char* STATSREPORT_ADAPTER_TYPE_LOOPBACK = "loopback"; | |
| template<typename ValueType> | |
| struct TypeForAdd { | |
| const StatsReport::StatsValueName name; | |
| const ValueType& value; | |
| }; | |
| typedef TypeForAdd<bool> BoolForAdd; | |
| typedef TypeForAdd<float> FloatForAdd; | |
| typedef TypeForAdd<int64_t> Int64ForAdd; | |
| typedef TypeForAdd<int> IntForAdd; | |
| StatsReport::Id GetTransportIdFromProxy(const ProxyTransportMap& map, | |
| const std::string& proxy) { | |
| RTC_DCHECK(!proxy.empty()); | |
| auto found = map.find(proxy); | |
| if (found == map.end()) { | |
| return StatsReport::Id(); | |
| } | |
| return StatsReport::NewComponentId( | |
| found->second, cricket::ICE_CANDIDATE_COMPONENT_RTP); | |
| } | |
| StatsReport* AddTrackReport(StatsCollection* reports, | |
| const std::string& track_id) { | |
| // Adds an empty track report. | |
| StatsReport::Id id( | |
| StatsReport::NewTypedId(StatsReport::kStatsReportTypeTrack, track_id)); | |
| StatsReport* report = reports->ReplaceOrAddNew(id); | |
| report->AddString(StatsReport::kStatsValueNameTrackId, track_id); | |
| return report; | |
| } | |
| template <class TrackVector> | |
| void CreateTrackReports(const TrackVector& tracks, StatsCollection* reports, | |
| TrackIdMap& track_ids) { | |
| for (const auto& track : tracks) { | |
| const std::string& track_id = track->id(); | |
| StatsReport* report = AddTrackReport(reports, track_id); | |
| RTC_DCHECK(report != nullptr); | |
| track_ids[track_id] = report; | |
| } | |
| } | |
| void ExtractCommonSendProperties(const cricket::MediaSenderInfo& info, | |
| StatsReport* report) { | |
| report->AddString(StatsReport::kStatsValueNameCodecName, info.codec_name); | |
| report->AddInt64(StatsReport::kStatsValueNameBytesSent, info.bytes_sent); | |
| if (info.rtt_ms >= 0) { | |
| report->AddInt64(StatsReport::kStatsValueNameRtt, info.rtt_ms); | |
| } | |
| } | |
| void ExtractCommonReceiveProperties(const cricket::MediaReceiverInfo& info, | |
| StatsReport* report) { | |
| report->AddString(StatsReport::kStatsValueNameCodecName, info.codec_name); | |
| } | |
| void SetAudioProcessingStats(StatsReport* report, | |
| bool typing_noise_detected, | |
| int echo_return_loss, | |
| int echo_return_loss_enhancement, | |
| int echo_delay_median_ms, | |
| float aec_quality_min, | |
| int echo_delay_std_ms, | |
| float residual_echo_likelihood, | |
| float residual_echo_likelihood_recent_max) { | |
| report->AddBoolean(StatsReport::kStatsValueNameTypingNoiseState, | |
| typing_noise_detected); | |
| if (aec_quality_min >= 0.0f) { | |
| report->AddFloat(StatsReport::kStatsValueNameEchoCancellationQualityMin, | |
| aec_quality_min); | |
| } | |
| const IntForAdd ints[] = { | |
| { StatsReport::kStatsValueNameEchoDelayMedian, echo_delay_median_ms }, | |
| { StatsReport::kStatsValueNameEchoDelayStdDev, echo_delay_std_ms }, | |
| }; | |
| for (const auto& i : ints) { | |
| if (i.value >= 0) { | |
| report->AddInt(i.name, i.value); | |
| } | |
| } | |
| // These can take on valid negative values. | |
| report->AddInt(StatsReport::kStatsValueNameEchoReturnLoss, echo_return_loss); | |
| report->AddInt(StatsReport::kStatsValueNameEchoReturnLossEnhancement, | |
| echo_return_loss_enhancement); | |
| if (residual_echo_likelihood >= 0.0f) { | |
| report->AddFloat(StatsReport::kStatsValueNameResidualEchoLikelihood, | |
| residual_echo_likelihood); | |
| } | |
| if (residual_echo_likelihood_recent_max >= 0.0f) { | |
| report->AddFloat( | |
| StatsReport::kStatsValueNameResidualEchoLikelihoodRecentMax, | |
| residual_echo_likelihood_recent_max); | |
| } | |
| } | |
| void ExtractStats(const cricket::VoiceReceiverInfo& info, StatsReport* report) { | |
| ExtractCommonReceiveProperties(info, report); | |
| const FloatForAdd floats[] = { | |
| { StatsReport::kStatsValueNameExpandRate, info.expand_rate }, | |
| { StatsReport::kStatsValueNameSecondaryDecodedRate, | |
| info.secondary_decoded_rate }, | |
| { StatsReport::kStatsValueNameSecondaryDiscardedRate, | |
| info.secondary_discarded_rate }, | |
| { StatsReport::kStatsValueNameSpeechExpandRate, info.speech_expand_rate }, | |
| { StatsReport::kStatsValueNameAccelerateRate, info.accelerate_rate }, | |
| { StatsReport::kStatsValueNamePreemptiveExpandRate, | |
| info.preemptive_expand_rate }, | |
| { StatsReport::kStatsValueNameTotalAudioEnergy, info.total_output_energy }, | |
| { StatsReport::kStatsValueNameTotalSamplesDuration, | |
| info.total_output_duration } | |
| }; | |
| const IntForAdd ints[] = { | |
| { StatsReport::kStatsValueNameCurrentDelayMs, info.delay_estimate_ms }, | |
| { StatsReport::kStatsValueNameDecodingCNG, info.decoding_cng }, | |
| { StatsReport::kStatsValueNameDecodingCTN, info.decoding_calls_to_neteq }, | |
| { StatsReport::kStatsValueNameDecodingCTSG, | |
| info.decoding_calls_to_silence_generator }, | |
| { StatsReport::kStatsValueNameDecodingMutedOutput, | |
| info.decoding_muted_output }, | |
| { StatsReport::kStatsValueNameDecodingNormal, info.decoding_normal }, | |
| { StatsReport::kStatsValueNameDecodingPLC, info.decoding_plc }, | |
| { StatsReport::kStatsValueNameDecodingPLCCNG, info.decoding_plc_cng }, | |
| { StatsReport::kStatsValueNameJitterBufferMs, info.jitter_buffer_ms }, | |
| { StatsReport::kStatsValueNameJitterReceived, info.jitter_ms }, | |
| { StatsReport::kStatsValueNamePacketsLost, info.packets_lost }, | |
| { StatsReport::kStatsValueNamePacketsReceived, info.packets_rcvd }, | |
| { StatsReport::kStatsValueNamePreferredJitterBufferMs, | |
| info.jitter_buffer_preferred_ms }, | |
| }; | |
| for (const auto& f : floats) | |
| report->AddFloat(f.name, f.value); | |
| for (const auto& i : ints) | |
| report->AddInt(i.name, i.value); | |
| if (info.audio_level >= 0) { | |
| report->AddInt(StatsReport::kStatsValueNameAudioOutputLevel, | |
| info.audio_level); | |
| } | |
| report->AddInt64(StatsReport::kStatsValueNameBytesReceived, | |
| info.bytes_rcvd); | |
| if (info.capture_start_ntp_time_ms >= 0) { | |
| report->AddInt64(StatsReport::kStatsValueNameCaptureStartNtpTimeMs, | |
| info.capture_start_ntp_time_ms); | |
| } | |
| report->AddString(StatsReport::kStatsValueNameMediaType, "audio"); | |
| } | |
| void ExtractStats(const cricket::VoiceSenderInfo& info, StatsReport* report) { | |
| ExtractCommonSendProperties(info, report); | |
| SetAudioProcessingStats( | |
| report, info.typing_noise_detected, info.echo_return_loss, | |
| info.echo_return_loss_enhancement, info.echo_delay_median_ms, | |
| info.aec_quality_min, info.echo_delay_std_ms, | |
| info.residual_echo_likelihood, info.residual_echo_likelihood_recent_max); | |
| const FloatForAdd floats[] = { | |
| { StatsReport::kStatsValueNameTotalAudioEnergy, info.total_input_energy }, | |
| { StatsReport::kStatsValueNameTotalSamplesDuration, | |
| info.total_input_duration } | |
| }; | |
| RTC_DCHECK_GE(info.audio_level, 0); | |
| const IntForAdd ints[] = { | |
| { StatsReport::kStatsValueNameAudioInputLevel, info.audio_level}, | |
| { StatsReport::kStatsValueNameJitterReceived, info.jitter_ms }, | |
| { StatsReport::kStatsValueNamePacketsLost, info.packets_lost }, | |
| { StatsReport::kStatsValueNamePacketsSent, info.packets_sent }, | |
| }; | |
| for (const auto& f : floats) { | |
| report->AddFloat(f.name, f.value); | |
| } | |
| for (const auto& i : ints) { | |
| if (i.value >= 0) { | |
| report->AddInt(i.name, i.value); | |
| } | |
| } | |
| report->AddString(StatsReport::kStatsValueNameMediaType, "audio"); | |
| } | |
| void ExtractStats(const cricket::VideoReceiverInfo& info, StatsReport* report) { | |
| ExtractCommonReceiveProperties(info, report); | |
| report->AddString(StatsReport::kStatsValueNameCodecImplementationName, | |
| info.decoder_implementation_name); | |
| report->AddInt64(StatsReport::kStatsValueNameBytesReceived, | |
| info.bytes_rcvd); | |
| if (info.capture_start_ntp_time_ms >= 0) { | |
| report->AddInt64(StatsReport::kStatsValueNameCaptureStartNtpTimeMs, | |
| info.capture_start_ntp_time_ms); | |
| } | |
| if (info.qp_sum) | |
| report->AddInt64(StatsReport::kStatsValueNameQpSum, *info.qp_sum); | |
| const IntForAdd ints[] = { | |
| { StatsReport::kStatsValueNameCurrentDelayMs, info.current_delay_ms }, | |
| { StatsReport::kStatsValueNameDecodeMs, info.decode_ms }, | |
| { StatsReport::kStatsValueNameFirsSent, info.firs_sent }, | |
| { StatsReport::kStatsValueNameFrameHeightReceived, info.frame_height }, | |
| { StatsReport::kStatsValueNameFrameRateDecoded, info.framerate_decoded }, | |
| { StatsReport::kStatsValueNameFrameRateOutput, info.framerate_output }, | |
| { StatsReport::kStatsValueNameFrameRateReceived, info.framerate_rcvd }, | |
| { StatsReport::kStatsValueNameFrameWidthReceived, info.frame_width }, | |
| { StatsReport::kStatsValueNameJitterBufferMs, info.jitter_buffer_ms }, | |
| { StatsReport::kStatsValueNameMaxDecodeMs, info.max_decode_ms }, | |
| { StatsReport::kStatsValueNameMinPlayoutDelayMs, | |
| info.min_playout_delay_ms }, | |
| { StatsReport::kStatsValueNameNacksSent, info.nacks_sent }, | |
| { StatsReport::kStatsValueNamePacketsLost, info.packets_lost }, | |
| { StatsReport::kStatsValueNamePacketsReceived, info.packets_rcvd }, | |
| { StatsReport::kStatsValueNamePlisSent, info.plis_sent }, | |
| { StatsReport::kStatsValueNameRenderDelayMs, info.render_delay_ms }, | |
| { StatsReport::kStatsValueNameTargetDelayMs, info.target_delay_ms }, | |
| { StatsReport::kStatsValueNameFramesDecoded, info.frames_decoded }, | |
| }; | |
| for (const auto& i : ints) | |
| report->AddInt(i.name, i.value); | |
| report->AddString(StatsReport::kStatsValueNameMediaType, "video"); | |
| if (info.timing_frame_info) { | |
| report->AddString(StatsReport::kStatsValueNameTimingFrameInfo, | |
| info.timing_frame_info->ToString()); | |
| } | |
| report->AddInt64(StatsReport::kStatsValueNameInterframeDelayMaxMs, | |
| info.interframe_delay_max_ms); | |
| report->AddString( | |
| StatsReport::kStatsValueNameContentType, | |
| webrtc::videocontenttypehelpers::ToString(info.content_type)); | |
| } | |
| void ExtractStats(const cricket::VideoSenderInfo& info, StatsReport* report) { | |
| ExtractCommonSendProperties(info, report); | |
| report->AddString(StatsReport::kStatsValueNameCodecImplementationName, | |
| info.encoder_implementation_name); | |
| report->AddBoolean(StatsReport::kStatsValueNameBandwidthLimitedResolution, | |
| (info.adapt_reason & 0x2) > 0); | |
| report->AddBoolean(StatsReport::kStatsValueNameCpuLimitedResolution, | |
| (info.adapt_reason & 0x1) > 0); | |
| if (info.qp_sum) | |
| report->AddInt(StatsReport::kStatsValueNameQpSum, *info.qp_sum); | |
| const IntForAdd ints[] = { | |
| { StatsReport::kStatsValueNameAdaptationChanges, info.adapt_changes }, | |
| { StatsReport::kStatsValueNameAvgEncodeMs, info.avg_encode_ms }, | |
| { StatsReport::kStatsValueNameEncodeUsagePercent, | |
| info.encode_usage_percent }, | |
| { StatsReport::kStatsValueNameFirsReceived, info.firs_rcvd }, | |
| { StatsReport::kStatsValueNameFrameHeightSent, info.send_frame_height }, | |
| { StatsReport::kStatsValueNameFrameRateInput, info.framerate_input }, | |
| { StatsReport::kStatsValueNameFrameRateSent, info.framerate_sent }, | |
| { StatsReport::kStatsValueNameFrameWidthSent, info.send_frame_width }, | |
| { StatsReport::kStatsValueNameNacksReceived, info.nacks_rcvd }, | |
| { StatsReport::kStatsValueNamePacketsLost, info.packets_lost }, | |
| { StatsReport::kStatsValueNamePacketsSent, info.packets_sent }, | |
| { StatsReport::kStatsValueNamePlisReceived, info.plis_rcvd }, | |
| { StatsReport::kStatsValueNameFramesEncoded, info.frames_encoded }, | |
| }; | |
| for (const auto& i : ints) | |
| report->AddInt(i.name, i.value); | |
| report->AddString(StatsReport::kStatsValueNameMediaType, "video"); | |
| } | |
| void ExtractStats(const cricket::BandwidthEstimationInfo& info, | |
| double stats_gathering_started, | |
| StatsReport* report) { | |
| RTC_DCHECK(report->type() == StatsReport::kStatsReportTypeBwe); | |
| report->set_timestamp(stats_gathering_started); | |
| const IntForAdd ints[] = { | |
| { StatsReport::kStatsValueNameAvailableSendBandwidth, | |
| info.available_send_bandwidth }, | |
| { StatsReport::kStatsValueNameAvailableReceiveBandwidth, | |
| info.available_recv_bandwidth }, | |
| { StatsReport::kStatsValueNameTargetEncBitrate, info.target_enc_bitrate }, | |
| { StatsReport::kStatsValueNameActualEncBitrate, info.actual_enc_bitrate }, | |
| { StatsReport::kStatsValueNameRetransmitBitrate, info.retransmit_bitrate }, | |
| { StatsReport::kStatsValueNameTransmitBitrate, info.transmit_bitrate }, | |
| }; | |
| for (const auto& i : ints) | |
| report->AddInt(i.name, i.value); | |
| report->AddInt64(StatsReport::kStatsValueNameBucketDelay, info.bucket_delay); | |
| } | |
| void ExtractRemoteStats(const cricket::MediaSenderInfo& info, | |
| StatsReport* report) { | |
| report->set_timestamp(info.remote_stats[0].timestamp); | |
| // TODO(hta): Extract some stats here. | |
| } | |
| void ExtractRemoteStats(const cricket::MediaReceiverInfo& info, | |
| StatsReport* report) { | |
| report->set_timestamp(info.remote_stats[0].timestamp); | |
| // TODO(hta): Extract some stats here. | |
| } | |
| // Template to extract stats from a data vector. | |
| // In order to use the template, the functions that are called from it, | |
| // ExtractStats and ExtractRemoteStats, must be defined and overloaded | |
| // for each type. | |
| template<typename T> | |
| void ExtractStatsFromList(const std::vector<T>& data, | |
| const StatsReport::Id& transport_id, | |
| StatsCollector* collector, | |
| StatsReport::Direction direction) { | |
| for (const auto& d : data) { | |
| uint32_t ssrc = d.ssrc(); | |
| // Each track can have stats for both local and remote objects. | |
| // TODO(hta): Handle the case of multiple SSRCs per object. | |
| StatsReport* report = collector->PrepareReport(true, ssrc, transport_id, | |
| direction); | |
| if (report) | |
| ExtractStats(d, report); | |
| if (!d.remote_stats.empty()) { | |
| report = collector->PrepareReport(false, ssrc, transport_id, direction); | |
| if (report) | |
| ExtractRemoteStats(d, report); | |
| } | |
| } | |
| } | |
| } // namespace | |
| const char* IceCandidateTypeToStatsType(const std::string& candidate_type) { | |
| if (candidate_type == cricket::LOCAL_PORT_TYPE) { | |
| return STATSREPORT_LOCAL_PORT_TYPE; | |
| } | |
| if (candidate_type == cricket::STUN_PORT_TYPE) { | |
| return STATSREPORT_STUN_PORT_TYPE; | |
| } | |
| if (candidate_type == cricket::PRFLX_PORT_TYPE) { | |
| return STATSREPORT_PRFLX_PORT_TYPE; | |
| } | |
| if (candidate_type == cricket::RELAY_PORT_TYPE) { | |
| return STATSREPORT_RELAY_PORT_TYPE; | |
| } | |
| RTC_NOTREACHED(); | |
| return "unknown"; | |
| } | |
| const char* AdapterTypeToStatsType(rtc::AdapterType type) { | |
| switch (type) { | |
| case rtc::ADAPTER_TYPE_UNKNOWN: | |
| return "unknown"; | |
| case rtc::ADAPTER_TYPE_ETHERNET: | |
| return STATSREPORT_ADAPTER_TYPE_ETHERNET; | |
| case rtc::ADAPTER_TYPE_WIFI: | |
| return STATSREPORT_ADAPTER_TYPE_WIFI; | |
| case rtc::ADAPTER_TYPE_CELLULAR: | |
| return STATSREPORT_ADAPTER_TYPE_WWAN; | |
| case rtc::ADAPTER_TYPE_VPN: | |
| return STATSREPORT_ADAPTER_TYPE_VPN; | |
| case rtc::ADAPTER_TYPE_LOOPBACK: | |
| return STATSREPORT_ADAPTER_TYPE_LOOPBACK; | |
| default: | |
| RTC_NOTREACHED(); | |
| return ""; | |
| } | |
| } | |
| StatsCollector::StatsCollector(PeerConnection* pc) | |
| : pc_(pc), stats_gathering_started_(0) { | |
| RTC_DCHECK(pc_); | |
| } | |
| StatsCollector::~StatsCollector() { | |
| RTC_DCHECK(pc_->session()->signaling_thread()->IsCurrent()); | |
| } | |
| // Wallclock time in ms. | |
| double StatsCollector::GetTimeNow() { | |
| return rtc::TimeUTCMicros() / | |
| static_cast<double>(rtc::kNumMicrosecsPerMillisec); | |
| } | |
| // Adds a MediaStream with tracks that can be used as a |selector| in a call | |
| // to GetStats. | |
| void StatsCollector::AddStream(MediaStreamInterface* stream) { | |
| RTC_DCHECK(pc_->session()->signaling_thread()->IsCurrent()); | |
| RTC_DCHECK(stream != NULL); | |
| CreateTrackReports<AudioTrackVector>(stream->GetAudioTracks(), | |
| &reports_, track_ids_); | |
| CreateTrackReports<VideoTrackVector>(stream->GetVideoTracks(), | |
| &reports_, track_ids_); | |
| } | |
| void StatsCollector::AddLocalAudioTrack(AudioTrackInterface* audio_track, | |
| uint32_t ssrc) { | |
| RTC_DCHECK(pc_->session()->signaling_thread()->IsCurrent()); | |
| RTC_DCHECK(audio_track != NULL); | |
| #if RTC_DCHECK_IS_ON | |
| for (const auto& track : local_audio_tracks_) | |
| RTC_DCHECK(track.first != audio_track || track.second != ssrc); | |
| #endif | |
| local_audio_tracks_.push_back(std::make_pair(audio_track, ssrc)); | |
| // Create the kStatsReportTypeTrack report for the new track if there is no | |
| // report yet. | |
| StatsReport::Id id(StatsReport::NewTypedId(StatsReport::kStatsReportTypeTrack, | |
| audio_track->id())); | |
| StatsReport* report = reports_.Find(id); | |
| if (!report) { | |
| report = reports_.InsertNew(id); | |
| report->AddString(StatsReport::kStatsValueNameTrackId, audio_track->id()); | |
| } | |
| } | |
| void StatsCollector::RemoveLocalAudioTrack(AudioTrackInterface* audio_track, | |
| uint32_t ssrc) { | |
| RTC_DCHECK(audio_track != NULL); | |
| local_audio_tracks_.erase( | |
| std::remove_if( | |
| local_audio_tracks_.begin(), local_audio_tracks_.end(), | |
| [audio_track, ssrc](const LocalAudioTrackVector::value_type& track) { | |
| return track.first == audio_track && track.second == ssrc; | |
| }), | |
| local_audio_tracks_.end()); | |
| } | |
| void StatsCollector::GetStats(MediaStreamTrackInterface* track, | |
| StatsReports* reports) { | |
| RTC_DCHECK(pc_->session()->signaling_thread()->IsCurrent()); | |
| RTC_DCHECK(reports != NULL); | |
| RTC_DCHECK(reports->empty()); | |
| rtc::Thread::ScopedDisallowBlockingCalls no_blocking_calls; | |
| if (!track) { | |
| reports->reserve(reports_.size()); | |
| for (auto* r : reports_) | |
| reports->push_back(r); | |
| return; | |
| } | |
| StatsReport* report = reports_.Find(StatsReport::NewTypedId( | |
| StatsReport::kStatsReportTypeSession, pc_->session()->id())); | |
| if (report) | |
| reports->push_back(report); | |
| report = reports_.Find(StatsReport::NewTypedId( | |
| StatsReport::kStatsReportTypeTrack, track->id())); | |
| if (!report) | |
| return; | |
| reports->push_back(report); | |
| std::string track_id; | |
| for (const auto* r : reports_) { | |
| if (r->type() != StatsReport::kStatsReportTypeSsrc) | |
| continue; | |
| const StatsReport::Value* v = | |
| r->FindValue(StatsReport::kStatsValueNameTrackId); | |
| if (v && v->string_val() == track->id()) | |
| reports->push_back(r); | |
| } | |
| } | |
| void | |
| StatsCollector::UpdateStats(PeerConnectionInterface::StatsOutputLevel level) { | |
| RTC_DCHECK(pc_->session()->signaling_thread()->IsCurrent()); | |
| double time_now = GetTimeNow(); | |
| // Calls to UpdateStats() that occur less than kMinGatherStatsPeriod number of | |
| // ms apart will be ignored. | |
| const double kMinGatherStatsPeriod = 50; | |
| if (stats_gathering_started_ != 0 && | |
| stats_gathering_started_ + kMinGatherStatsPeriod > time_now) { | |
| return; | |
| } | |
| stats_gathering_started_ = time_now; | |
| // TODO(pthatcher): Merge PeerConnection and WebRtcSession so there is no | |
| // pc_->session(). | |
| if (pc_->session()) { | |
| // TODO(tommi): All of these hop over to the worker thread to fetch | |
| // information. We could use an AsyncInvoker to run all of these and post | |
| // the information back to the signaling thread where we can create and | |
| // update stats reports. That would also clean up the threading story a bit | |
| // since we'd be creating/updating the stats report objects consistently on | |
| // the same thread (this class has no locks right now). | |
| ExtractSessionInfo(); | |
| ExtractBweInfo(); | |
| ExtractVoiceInfo(); | |
| ExtractVideoInfo(level); | |
| ExtractSenderInfo(); | |
| ExtractDataInfo(); | |
| UpdateTrackReports(); | |
| } | |
| } | |
| StatsReport* StatsCollector::PrepareReport( | |
| bool local, | |
| uint32_t ssrc, | |
| const StatsReport::Id& transport_id, | |
| StatsReport::Direction direction) { | |
| RTC_DCHECK(pc_->session()->signaling_thread()->IsCurrent()); | |
| StatsReport::Id id(StatsReport::NewIdWithDirection( | |
| local ? StatsReport::kStatsReportTypeSsrc | |
| : StatsReport::kStatsReportTypeRemoteSsrc, | |
| rtc::ToString<uint32_t>(ssrc), direction)); | |
| StatsReport* report = reports_.Find(id); | |
| // Use the ID of the track that is currently mapped to the SSRC, if any. | |
| std::string track_id; | |
| if (!GetTrackIdBySsrc(ssrc, &track_id, direction)) { | |
| if (!report) { | |
| // The ssrc is not used by any track or existing report, return NULL | |
| // in such case to indicate no report is prepared for the ssrc. | |
| return NULL; | |
| } | |
| // The ssrc is not used by any existing track. Keeps the old track id | |
| // since we want to report the stats for inactive ssrc. | |
| const StatsReport::Value* v = | |
| report->FindValue(StatsReport::kStatsValueNameTrackId); | |
| if (v) | |
| track_id = v->string_val(); | |
| } | |
| if (!report) | |
| report = reports_.InsertNew(id); | |
| // FYI - for remote reports, the timestamp will be overwritten later. | |
| report->set_timestamp(stats_gathering_started_); | |
| report->AddInt64(StatsReport::kStatsValueNameSsrc, ssrc); | |
| report->AddString(StatsReport::kStatsValueNameTrackId, track_id); | |
| // Add the mapping of SSRC to transport. | |
| report->AddId(StatsReport::kStatsValueNameTransportId, transport_id); | |
| return report; | |
| } | |
| bool StatsCollector::IsValidTrack(const std::string& track_id) { | |
| return reports_.Find(StatsReport::NewTypedId( | |
| StatsReport::kStatsReportTypeTrack, track_id)) != nullptr; | |
| } | |
| StatsReport* StatsCollector::AddCertificateReports( | |
| const rtc::SSLCertificate* cert) { | |
| RTC_DCHECK(pc_->session()->signaling_thread()->IsCurrent()); | |
| RTC_DCHECK(cert != NULL); | |
| std::unique_ptr<rtc::SSLCertificateStats> first_stats = cert->GetStats(); | |
| StatsReport* first_report = nullptr; | |
| StatsReport* prev_report = nullptr; | |
| for (rtc::SSLCertificateStats* stats = first_stats.get(); stats; | |
| stats = stats->issuer.get()) { | |
| StatsReport::Id id(StatsReport::NewTypedId( | |
| StatsReport::kStatsReportTypeCertificate, stats->fingerprint)); | |
| StatsReport* report = reports_.ReplaceOrAddNew(id); | |
| report->set_timestamp(stats_gathering_started_); | |
| report->AddString(StatsReport::kStatsValueNameFingerprint, | |
| stats->fingerprint); | |
| report->AddString(StatsReport::kStatsValueNameFingerprintAlgorithm, | |
| stats->fingerprint_algorithm); | |
| report->AddString(StatsReport::kStatsValueNameDer, | |
| stats->base64_certificate); | |
| if (!first_report) | |
| first_report = report; | |
| else | |
| prev_report->AddId(StatsReport::kStatsValueNameIssuerId, id); | |
| prev_report = report; | |
| } | |
| return first_report; | |
| } | |
| StatsReport* StatsCollector::AddConnectionInfoReport( | |
| const std::string& content_name, int component, int connection_id, | |
| const StatsReport::Id& channel_report_id, | |
| const cricket::ConnectionInfo& info) { | |
| StatsReport::Id id(StatsReport::NewCandidatePairId(content_name, component, | |
| connection_id)); | |
| StatsReport* report = reports_.ReplaceOrAddNew(id); | |
| report->set_timestamp(stats_gathering_started_); | |
| const BoolForAdd bools[] = { | |
| {StatsReport::kStatsValueNameActiveConnection, info.best_connection}, | |
| {StatsReport::kStatsValueNameReceiving, info.receiving}, | |
| {StatsReport::kStatsValueNameWritable, info.writable}, | |
| }; | |
| for (const auto& b : bools) | |
| report->AddBoolean(b.name, b.value); | |
| report->AddId(StatsReport::kStatsValueNameChannelId, channel_report_id); | |
| report->AddId(StatsReport::kStatsValueNameLocalCandidateId, | |
| AddCandidateReport(info.local_candidate, true)->id()); | |
| report->AddId(StatsReport::kStatsValueNameRemoteCandidateId, | |
| AddCandidateReport(info.remote_candidate, false)->id()); | |
| const Int64ForAdd int64s[] = { | |
| {StatsReport::kStatsValueNameBytesReceived, info.recv_total_bytes}, | |
| {StatsReport::kStatsValueNameBytesSent, info.sent_total_bytes}, | |
| {StatsReport::kStatsValueNamePacketsSent, info.sent_total_packets}, | |
| {StatsReport::kStatsValueNameRtt, info.rtt}, | |
| {StatsReport::kStatsValueNameSendPacketsDiscarded, | |
| info.sent_discarded_packets}, | |
| {StatsReport::kStatsValueNameSentPingRequestsTotal, | |
| info.sent_ping_requests_total}, | |
| {StatsReport::kStatsValueNameSentPingRequestsBeforeFirstResponse, | |
| info.sent_ping_requests_before_first_response}, | |
| {StatsReport::kStatsValueNameSentPingResponses, info.sent_ping_responses}, | |
| {StatsReport::kStatsValueNameRecvPingRequests, info.recv_ping_requests}, | |
| {StatsReport::kStatsValueNameRecvPingResponses, info.recv_ping_responses}, | |
| }; | |
| for (const auto& i : int64s) | |
| report->AddInt64(i.name, i.value); | |
| report->AddString(StatsReport::kStatsValueNameLocalAddress, | |
| info.local_candidate.address().ToString()); | |
| report->AddString(StatsReport::kStatsValueNameLocalCandidateType, | |
| info.local_candidate.type()); | |
| report->AddString(StatsReport::kStatsValueNameRemoteAddress, | |
| info.remote_candidate.address().ToString()); | |
| report->AddString(StatsReport::kStatsValueNameRemoteCandidateType, | |
| info.remote_candidate.type()); | |
| report->AddString(StatsReport::kStatsValueNameTransportType, | |
| info.local_candidate.protocol()); | |
| return report; | |
| } | |
| StatsReport* StatsCollector::AddCandidateReport( | |
| const cricket::Candidate& candidate, | |
| bool local) { | |
| StatsReport::Id id(StatsReport::NewCandidateId(local, candidate.id())); | |
| StatsReport* report = reports_.Find(id); | |
| if (!report) { | |
| report = reports_.InsertNew(id); | |
| report->set_timestamp(stats_gathering_started_); | |
| if (local) { | |
| report->AddString(StatsReport::kStatsValueNameCandidateNetworkType, | |
| AdapterTypeToStatsType(candidate.network_type())); | |
| } | |
| report->AddString(StatsReport::kStatsValueNameCandidateIPAddress, | |
| candidate.address().ipaddr().ToString()); | |
| report->AddString(StatsReport::kStatsValueNameCandidatePortNumber, | |
| candidate.address().PortAsString()); | |
| report->AddInt(StatsReport::kStatsValueNameCandidatePriority, | |
| candidate.priority()); | |
| report->AddString(StatsReport::kStatsValueNameCandidateType, | |
| IceCandidateTypeToStatsType(candidate.type())); | |
| report->AddString(StatsReport::kStatsValueNameCandidateTransportType, | |
| candidate.protocol()); | |
| } | |
| return report; | |
| } | |
| void StatsCollector::ExtractSessionInfo() { | |
| RTC_DCHECK(pc_->session()->signaling_thread()->IsCurrent()); | |
| // Extract information from the base session. | |
| StatsReport::Id id(StatsReport::NewTypedId( | |
| StatsReport::kStatsReportTypeSession, pc_->session()->id())); | |
| StatsReport* report = reports_.ReplaceOrAddNew(id); | |
| report->set_timestamp(stats_gathering_started_); | |
| report->AddBoolean(StatsReport::kStatsValueNameInitiator, | |
| pc_->session()->initial_offerer()); | |
| std::unique_ptr<SessionStats> stats = pc_->session()->GetStats_s(); | |
| if (!stats) { | |
| return; | |
| } | |
| // Store the proxy map away for use in SSRC reporting. | |
| // TODO(tommi): This shouldn't be necessary if we post the stats back to the | |
| // signaling thread after fetching them on the worker thread, then just use | |
| // the proxy map directly from the session stats. | |
| // As is, if GetStats() failed, we could be using old (incorrect?) proxy | |
| // data. | |
| proxy_to_transport_ = stats->proxy_to_transport; | |
| for (const auto& transport_iter : stats->transport_stats) { | |
| // Attempt to get a copy of the certificates from the transport and | |
| // expose them in stats reports. All channels in a transport share the | |
| // same local and remote certificates. | |
| // | |
| StatsReport::Id local_cert_report_id, remote_cert_report_id; | |
| rtc::scoped_refptr<rtc::RTCCertificate> certificate; | |
| if (pc_->session()->GetLocalCertificate( | |
| transport_iter.second.transport_name, &certificate)) { | |
| StatsReport* r = AddCertificateReports(&(certificate->ssl_certificate())); | |
| if (r) | |
| local_cert_report_id = r->id(); | |
| } | |
| std::unique_ptr<rtc::SSLCertificate> cert = | |
| pc_->session()->GetRemoteSSLCertificate( | |
| transport_iter.second.transport_name); | |
| if (cert) { | |
| StatsReport* r = AddCertificateReports(cert.get()); | |
| if (r) | |
| remote_cert_report_id = r->id(); | |
| } | |
| for (const auto& channel_iter : transport_iter.second.channel_stats) { | |
| StatsReport::Id id(StatsReport::NewComponentId( | |
| transport_iter.second.transport_name, channel_iter.component)); | |
| StatsReport* channel_report = reports_.ReplaceOrAddNew(id); | |
| channel_report->set_timestamp(stats_gathering_started_); | |
| channel_report->AddInt(StatsReport::kStatsValueNameComponent, | |
| channel_iter.component); | |
| if (local_cert_report_id.get()) { | |
| channel_report->AddId(StatsReport::kStatsValueNameLocalCertificateId, | |
| local_cert_report_id); | |
| } | |
| if (remote_cert_report_id.get()) { | |
| channel_report->AddId(StatsReport::kStatsValueNameRemoteCertificateId, | |
| remote_cert_report_id); | |
| } | |
| int srtp_crypto_suite = channel_iter.srtp_crypto_suite; | |
| if (srtp_crypto_suite != rtc::SRTP_INVALID_CRYPTO_SUITE && | |
| rtc::SrtpCryptoSuiteToName(srtp_crypto_suite).length()) { | |
| channel_report->AddString( | |
| StatsReport::kStatsValueNameSrtpCipher, | |
| rtc::SrtpCryptoSuiteToName(srtp_crypto_suite)); | |
| } | |
| int ssl_cipher_suite = channel_iter.ssl_cipher_suite; | |
| if (ssl_cipher_suite != rtc::TLS_NULL_WITH_NULL_NULL && | |
| rtc::SSLStreamAdapter::SslCipherSuiteToName(ssl_cipher_suite) | |
| .length()) { | |
| channel_report->AddString( | |
| StatsReport::kStatsValueNameDtlsCipher, | |
| rtc::SSLStreamAdapter::SslCipherSuiteToName(ssl_cipher_suite)); | |
| } | |
| int connection_id = 0; | |
| for (const cricket::ConnectionInfo& info : | |
| channel_iter.connection_infos) { | |
| StatsReport* connection_report = AddConnectionInfoReport( | |
| transport_iter.first, channel_iter.component, connection_id++, | |
| channel_report->id(), info); | |
| if (info.best_connection) { | |
| channel_report->AddId( | |
| StatsReport::kStatsValueNameSelectedCandidatePairId, | |
| connection_report->id()); | |
| } | |
| } | |
| } | |
| } | |
| } | |
| void StatsCollector::ExtractBweInfo() { | |
| RTC_DCHECK(pc_->session()->signaling_thread()->IsCurrent()); | |
| if (pc_->session()->state() == WebRtcSession::State::STATE_CLOSED) | |
| return; | |
| webrtc::Call::Stats call_stats = pc_->session()->GetCallStats(); | |
| cricket::BandwidthEstimationInfo bwe_info; | |
| bwe_info.available_send_bandwidth = call_stats.send_bandwidth_bps; | |
| bwe_info.available_recv_bandwidth = call_stats.recv_bandwidth_bps; | |
| bwe_info.bucket_delay = call_stats.pacer_delay_ms; | |
| // Fill in target encoder bitrate, actual encoder bitrate, rtx bitrate, etc. | |
| // TODO(holmer): Also fill this in for audio. | |
| if (pc_->session()->video_channel()) { | |
| pc_->session()->video_channel()->FillBitrateInfo(&bwe_info); | |
| } | |
| StatsReport::Id report_id(StatsReport::NewBandwidthEstimationId()); | |
| StatsReport* report = reports_.FindOrAddNew(report_id); | |
| ExtractStats(bwe_info, stats_gathering_started_, report); | |
| } | |
| void StatsCollector::ExtractVoiceInfo() { | |
| RTC_DCHECK(pc_->session()->signaling_thread()->IsCurrent()); | |
| if (!pc_->session()->voice_channel()) { | |
| return; | |
| } | |
| cricket::VoiceMediaInfo voice_info; | |
| if (!pc_->session()->voice_channel()->GetStats(&voice_info)) { | |
| LOG(LS_ERROR) << "Failed to get voice channel stats."; | |
| return; | |
| } | |
| // TODO(tommi): The above code should run on the worker thread and post the | |
| // results back to the signaling thread, where we can add data to the reports. | |
| rtc::Thread::ScopedDisallowBlockingCalls no_blocking_calls; | |
| StatsReport::Id transport_id(GetTransportIdFromProxy( | |
| proxy_to_transport_, pc_->session()->voice_channel()->content_name())); | |
| if (!transport_id.get()) { | |
| LOG(LS_ERROR) << "Failed to get transport name for proxy " | |
| << pc_->session()->voice_channel()->content_name(); | |
| return; | |
| } | |
| ExtractStatsFromList(voice_info.receivers, transport_id, this, | |
| StatsReport::kReceive); | |
| ExtractStatsFromList(voice_info.senders, transport_id, this, | |
| StatsReport::kSend); | |
| UpdateStatsFromExistingLocalAudioTracks(); | |
| } | |
| void StatsCollector::ExtractVideoInfo( | |
| PeerConnectionInterface::StatsOutputLevel level) { | |
| RTC_DCHECK(pc_->session()->signaling_thread()->IsCurrent()); | |
| if (!pc_->session()->video_channel()) | |
| return; | |
| cricket::VideoMediaInfo video_info; | |
| if (!pc_->session()->video_channel()->GetStats(&video_info)) { | |
| LOG(LS_ERROR) << "Failed to get video channel stats."; | |
| return; | |
| } | |
| // TODO(tommi): The above code should run on the worker thread and post the | |
| // results back to the signaling thread, where we can add data to the reports. | |
| rtc::Thread::ScopedDisallowBlockingCalls no_blocking_calls; | |
| StatsReport::Id transport_id(GetTransportIdFromProxy( | |
| proxy_to_transport_, pc_->session()->video_channel()->content_name())); | |
| if (!transport_id.get()) { | |
| LOG(LS_ERROR) << "Failed to get transport name for proxy " | |
| << pc_->session()->video_channel()->content_name(); | |
| return; | |
| } | |
| ExtractStatsFromList(video_info.receivers, transport_id, this, | |
| StatsReport::kReceive); | |
| ExtractStatsFromList(video_info.senders, transport_id, this, | |
| StatsReport::kSend); | |
| } | |
| void StatsCollector::ExtractSenderInfo() { | |
| RTC_DCHECK(pc_->session()->signaling_thread()->IsCurrent()); | |
| for (const auto& sender : pc_->GetSenders()) { | |
| // TODO(nisse): SSRC == 0 currently means none. Delete check when | |
| // that is fixed. | |
| if (!sender->ssrc()) { | |
| continue; | |
| } | |
| const rtc::scoped_refptr<MediaStreamTrackInterface> track(sender->track()); | |
| if (!track || track->kind() != MediaStreamTrackInterface::kVideoKind) { | |
| continue; | |
| } | |
| // Safe, because kind() == kVideoKind implies a subclass of | |
| // VideoTrackInterface; see mediastreaminterface.h. | |
| VideoTrackSourceInterface* source = | |
| static_cast<VideoTrackInterface*>(track.get())->GetSource(); | |
| VideoTrackSourceInterface::Stats stats; | |
| if (!source->GetStats(&stats)) { | |
| continue; | |
| } | |
| const StatsReport::Id stats_id = StatsReport::NewIdWithDirection( | |
| StatsReport::kStatsReportTypeSsrc, | |
| rtc::ToString<uint32_t>(sender->ssrc()), StatsReport::kSend); | |
| StatsReport* report = reports_.FindOrAddNew(stats_id); | |
| report->AddInt(StatsReport::kStatsValueNameFrameWidthInput, | |
| stats.input_width); | |
| report->AddInt(StatsReport::kStatsValueNameFrameHeightInput, | |
| stats.input_height); | |
| } | |
| } | |
| void StatsCollector::ExtractDataInfo() { | |
| RTC_DCHECK(pc_->session()->signaling_thread()->IsCurrent()); | |
| rtc::Thread::ScopedDisallowBlockingCalls no_blocking_calls; | |
| for (const auto& dc : pc_->sctp_data_channels()) { | |
| StatsReport::Id id(StatsReport::NewTypedIntId( | |
| StatsReport::kStatsReportTypeDataChannel, dc->id())); | |
| StatsReport* report = reports_.ReplaceOrAddNew(id); | |
| report->set_timestamp(stats_gathering_started_); | |
| report->AddString(StatsReport::kStatsValueNameLabel, dc->label()); | |
| // Filter out the initial id (-1). | |
| if (dc->id() >= 0) { | |
| report->AddInt(StatsReport::kStatsValueNameDataChannelId, dc->id()); | |
| } | |
| report->AddString(StatsReport::kStatsValueNameProtocol, dc->protocol()); | |
| report->AddString(StatsReport::kStatsValueNameState, | |
| DataChannelInterface::DataStateString(dc->state())); | |
| } | |
| } | |
| StatsReport* StatsCollector::GetReport(const StatsReport::StatsType& type, | |
| const std::string& id, | |
| StatsReport::Direction direction) { | |
| RTC_DCHECK(pc_->session()->signaling_thread()->IsCurrent()); | |
| RTC_DCHECK(type == StatsReport::kStatsReportTypeSsrc || | |
| type == StatsReport::kStatsReportTypeRemoteSsrc); | |
| return reports_.Find(StatsReport::NewIdWithDirection(type, id, direction)); | |
| } | |
| void StatsCollector::UpdateStatsFromExistingLocalAudioTracks() { | |
| RTC_DCHECK(pc_->session()->signaling_thread()->IsCurrent()); | |
| // Loop through the existing local audio tracks. | |
| for (const auto& it : local_audio_tracks_) { | |
| AudioTrackInterface* track = it.first; | |
| uint32_t ssrc = it.second; | |
| StatsReport* report = | |
| GetReport(StatsReport::kStatsReportTypeSsrc, | |
| rtc::ToString<uint32_t>(ssrc), StatsReport::kSend); | |
| if (report == NULL) { | |
| // This can happen if a local audio track is added to a stream on the | |
| // fly and the report has not been set up yet. Do nothing in this case. | |
| LOG(LS_ERROR) << "Stats report does not exist for ssrc " << ssrc; | |
| continue; | |
| } | |
| // The same ssrc can be used by both local and remote audio tracks. | |
| const StatsReport::Value* v = | |
| report->FindValue(StatsReport::kStatsValueNameTrackId); | |
| if (!v || v->string_val() != track->id()) | |
| continue; | |
| report->set_timestamp(stats_gathering_started_); | |
| UpdateReportFromAudioTrack(track, report); | |
| } | |
| } | |
| void StatsCollector::UpdateReportFromAudioTrack(AudioTrackInterface* track, | |
| StatsReport* report) { | |
| RTC_DCHECK(pc_->session()->signaling_thread()->IsCurrent()); | |
| RTC_DCHECK(track != NULL); | |
| // Don't overwrite report values if they're not available. | |
| int signal_level; | |
| if (track->GetSignalLevel(&signal_level)) { | |
| RTC_DCHECK_GE(signal_level, 0); | |
| report->AddInt(StatsReport::kStatsValueNameAudioInputLevel, signal_level); | |
| } | |
| auto audio_processor(track->GetAudioProcessor()); | |
| if (audio_processor.get()) { | |
| AudioProcessorInterface::AudioProcessorStats stats; | |
| audio_processor->GetStats(&stats); | |
| SetAudioProcessingStats( | |
| report, stats.typing_noise_detected, stats.echo_return_loss, | |
| stats.echo_return_loss_enhancement, stats.echo_delay_median_ms, | |
| stats.aec_quality_min, stats.echo_delay_std_ms, | |
| stats.residual_echo_likelihood, | |
| stats.residual_echo_likelihood_recent_max); | |
| report->AddFloat(StatsReport::kStatsValueNameAecDivergentFilterFraction, | |
| stats.aec_divergent_filter_fraction); | |
| } | |
| } | |
| bool StatsCollector::GetTrackIdBySsrc(uint32_t ssrc, | |
| std::string* track_id, | |
| StatsReport::Direction direction) { | |
| RTC_DCHECK(pc_->session()->signaling_thread()->IsCurrent()); | |
| if (direction == StatsReport::kSend) { | |
| if (!pc_->session()->GetLocalTrackIdBySsrc(ssrc, track_id)) { | |
| LOG(LS_WARNING) << "The SSRC " << ssrc | |
| << " is not associated with a sending track"; | |
| return false; | |
| } | |
| } else { | |
| RTC_DCHECK(direction == StatsReport::kReceive); | |
| if (!pc_->session()->GetRemoteTrackIdBySsrc(ssrc, track_id)) { | |
| LOG(LS_WARNING) << "The SSRC " << ssrc | |
| << " is not associated with a receiving track"; | |
| return false; | |
| } | |
| } | |
| return true; | |
| } | |
| void StatsCollector::UpdateTrackReports() { | |
| RTC_DCHECK(pc_->session()->signaling_thread()->IsCurrent()); | |
| rtc::Thread::ScopedDisallowBlockingCalls no_blocking_calls; | |
| for (const auto& entry : track_ids_) { | |
| StatsReport* report = entry.second; | |
| report->set_timestamp(stats_gathering_started_); | |
| } | |
| } | |
| void StatsCollector::ClearUpdateStatsCacheForTest() { | |
| stats_gathering_started_ = 0; | |
| } | |
| } // namespace webrtc |