| // Copyright 2014 The Chromium Authors. All rights reserved. |
| // Use of this source code is governed by a BSD-style license that can be |
| // found in the LICENSE file. |
| |
| #include "net/log/trace_net_log_observer.h" |
| |
| #include <memory> |
| #include <string> |
| #include <vector> |
| |
| #include "base/bind.h" |
| #include "base/check.h" |
| #include "base/json/json_reader.h" |
| #include "base/memory/ptr_util.h" |
| #include "base/memory/ref_counted.h" |
| #include "base/memory/ref_counted_memory.h" |
| #include "base/run_loop.h" |
| #include "base/strings/stringprintf.h" |
| #include "base/test/task_environment.h" |
| #include "base/trace_event/trace_buffer.h" |
| #include "base/trace_event/trace_event.h" |
| #include "base/trace_event/trace_event_impl.h" |
| #include "base/values.h" |
| #include "net/log/net_log_event_type.h" |
| #include "net/log/net_log_source_type.h" |
| #include "net/log/net_log_with_source.h" |
| #include "net/log/test_net_log.h" |
| #include "net/test/test_with_task_environment.h" |
| #include "testing/gtest/include/gtest/gtest.h" |
| |
| using base::trace_event::TraceLog; |
| |
| namespace net { |
| |
| namespace { |
| |
| // TraceLog category for NetLog events. |
| const char kNetLogTracingCategory[] = "netlog"; |
| |
| struct TraceEntryInfo { |
| std::string category; |
| std::string id; |
| std::string phase; |
| std::string name; |
| std::string source_type; |
| }; |
| |
| TraceEntryInfo GetTraceEntryInfoFromValue(const base::Value& value) { |
| TraceEntryInfo info; |
| if (const std::string* cat = value.FindStringKey("cat")) { |
| info.category = *cat; |
| } else { |
| ADD_FAILURE() << "Missing 'cat'"; |
| } |
| if (const std::string* id = value.FindStringKey("id")) { |
| info.id = *id; |
| } else { |
| ADD_FAILURE() << "Missing 'id'"; |
| } |
| if (const std::string* ph = value.FindStringKey("ph")) { |
| info.phase = *ph; |
| } else { |
| ADD_FAILURE() << "Missing 'ph'"; |
| } |
| if (const std::string* name = value.FindStringKey("name")) { |
| info.name = *name; |
| } else { |
| ADD_FAILURE() << "Missing 'name'"; |
| } |
| if (const std::string* type = value.FindStringPath("args.source_type")) { |
| info.source_type = *type; |
| } else { |
| ADD_FAILURE() << "Missing 'args.source_type'"; |
| } |
| |
| return info; |
| } |
| |
| void EnableTraceLog(base::StringPiece category) { |
| TraceLog::GetInstance()->SetEnabled( |
| base::trace_event::TraceConfig(category, ""), TraceLog::RECORDING_MODE); |
| // AsyncEnabledStateObserver will receive enabled notification one message |
| // loop iteration later. |
| base::RunLoop().RunUntilIdle(); |
| } |
| |
| void DisableTraceLog() { |
| TraceLog::GetInstance()->SetDisabled(); |
| // AsyncEnabledStateObserver will receive disabled notification one message |
| // loop iteration later. |
| base::RunLoop().RunUntilIdle(); |
| } |
| |
| void EnableTraceLogWithNetLog() { |
| EnableTraceLog(kNetLogTracingCategory); |
| } |
| |
| void EnableTraceLogWithoutNetLog() { |
| std::string disabled_netlog_category = |
| std::string("-") + kNetLogTracingCategory; |
| EnableTraceLog(disabled_netlog_category); |
| } |
| |
| class TraceNetLogObserverTest : public TestWithTaskEnvironment { |
| public: |
| TraceNetLogObserverTest() { |
| TraceLog* tracelog = TraceLog::GetInstance(); |
| DCHECK(tracelog); |
| DCHECK(!tracelog->IsEnabled()); |
| trace_buffer_.SetOutputCallback(json_output_.GetCallback()); |
| trace_net_log_observer_.reset(new TraceNetLogObserver()); |
| trace_events_.reset(new base::ListValue()); |
| } |
| |
| ~TraceNetLogObserverTest() override { |
| DCHECK(!TraceLog::GetInstance()->IsEnabled()); |
| } |
| |
| void OnTraceDataCollected( |
| base::RunLoop* run_loop, |
| const scoped_refptr<base::RefCountedString>& events_str, |
| bool has_more_events) { |
| DCHECK(trace_events_->empty()); |
| trace_buffer_.Start(); |
| trace_buffer_.AddFragment(events_str->data()); |
| trace_buffer_.Finish(); |
| |
| std::unique_ptr<base::Value> trace_value; |
| trace_value = base::JSONReader::ReadDeprecated(json_output_.json_output, |
| base::JSON_PARSE_RFC); |
| |
| ASSERT_TRUE(trace_value) << json_output_.json_output; |
| base::ListValue* trace_events = nullptr; |
| ASSERT_TRUE(trace_value->GetAsList(&trace_events)); |
| |
| trace_events_ = FilterNetLogTraceEvents(*trace_events); |
| |
| if (!has_more_events) |
| run_loop->Quit(); |
| } |
| |
| void EndTraceAndFlush() { |
| DisableTraceLog(); |
| base::RunLoop run_loop; |
| TraceLog::GetInstance()->Flush(base::BindRepeating( |
| &TraceNetLogObserverTest::OnTraceDataCollected, base::Unretained(this), |
| base::Unretained(&run_loop))); |
| run_loop.Run(); |
| } |
| |
| void set_trace_net_log_observer(TraceNetLogObserver* trace_net_log_observer) { |
| trace_net_log_observer_.reset(trace_net_log_observer); |
| } |
| |
| static std::unique_ptr<base::ListValue> FilterNetLogTraceEvents( |
| const base::ListValue& trace_events) { |
| std::unique_ptr<base::ListValue> filtered_trace_events( |
| new base::ListValue()); |
| for (size_t i = 0; i < trace_events.GetSize(); i++) { |
| const base::Value* dict = &trace_events.GetList()[i]; |
| if (!dict->is_dict()) { |
| ADD_FAILURE() << "Unexpected non-dictionary event in trace_events"; |
| continue; |
| } |
| const std::string* category = dict->FindStringPath("cat"); |
| if (!category) { |
| ADD_FAILURE() |
| << "Unexpected item without a category field in trace_events"; |
| continue; |
| } |
| if (*category != kNetLogTracingCategory) |
| continue; |
| filtered_trace_events->Append(dict->CreateDeepCopy()); |
| } |
| return filtered_trace_events; |
| } |
| |
| base::ListValue* trace_events() const { return trace_events_.get(); } |
| |
| RecordingTestNetLog* net_log() { return &net_log_; } |
| |
| TraceNetLogObserver* trace_net_log_observer() const { |
| return trace_net_log_observer_.get(); |
| } |
| |
| private: |
| std::unique_ptr<base::ListValue> trace_events_; |
| base::trace_event::TraceResultBuffer trace_buffer_; |
| base::trace_event::TraceResultBuffer::SimpleOutput json_output_; |
| RecordingTestNetLog net_log_; |
| std::unique_ptr<TraceNetLogObserver> trace_net_log_observer_; |
| }; |
| |
| TEST_F(TraceNetLogObserverTest, TracingNotEnabled) { |
| trace_net_log_observer()->WatchForTraceStart(net_log()); |
| net_log()->AddGlobalEntry(NetLogEventType::REQUEST_ALIVE); |
| |
| EndTraceAndFlush(); |
| trace_net_log_observer()->StopWatchForTraceStart(); |
| |
| EXPECT_EQ(0u, trace_events()->GetSize()); |
| } |
| |
| // This test will result in a deadlock if EnabledStateObserver instead |
| // of AsyncEnabledStateObserver is used. Regression test for crbug.com/760817. |
| TEST_F(TraceNetLogObserverTest, TracingDisabledDuringOnAddEntry) { |
| trace_net_log_observer()->WatchForTraceStart(net_log()); |
| TraceLog* trace_log = TraceLog::GetInstance(); |
| trace_log->SetTraceBufferForTesting(base::WrapUnique( |
| base::trace_event::TraceBuffer::CreateTraceBufferVectorOfSize(1))); |
| EnableTraceLogWithNetLog(); |
| // TraceLog will disable itself when an event makes the TraceBuffer full. |
| while (!trace_log->BufferIsFull()) { |
| net_log()->AddGlobalEntry(NetLogEventType::REQUEST_ALIVE); |
| } |
| |
| base::RunLoop().RunUntilIdle(); |
| ASSERT_FALSE(trace_log->IsEnabled()); |
| ASSERT_FALSE(trace_net_log_observer()->net_log()); |
| trace_net_log_observer()->StopWatchForTraceStart(); |
| // Flush now so that TraceLog's buffer is empty in the next test. |
| EndTraceAndFlush(); |
| } |
| |
| TEST_F(TraceNetLogObserverTest, TraceEventCaptured) { |
| auto entries = net_log()->GetEntries(); |
| EXPECT_TRUE(entries.empty()); |
| |
| trace_net_log_observer()->WatchForTraceStart(net_log()); |
| EnableTraceLogWithNetLog(); |
| NetLogWithSource net_log_with_source = |
| NetLogWithSource::Make(net_log(), net::NetLogSourceType::NONE); |
| net_log()->AddGlobalEntry(NetLogEventType::CANCELLED); |
| net_log_with_source.BeginEvent(NetLogEventType::URL_REQUEST_START_JOB); |
| net_log_with_source.EndEvent(NetLogEventType::REQUEST_ALIVE); |
| |
| entries = net_log()->GetEntries(); |
| EXPECT_EQ(3u, entries.size()); |
| EndTraceAndFlush(); |
| trace_net_log_observer()->StopWatchForTraceStart(); |
| EXPECT_EQ(3u, trace_events()->GetSize()); |
| const base::Value* item1 = &trace_events()->GetList()[0]; |
| ASSERT_TRUE(item1->is_dict()); |
| const base::Value* item2 = &trace_events()->GetList()[1]; |
| ; |
| ASSERT_TRUE(item2->is_dict()); |
| const base::Value* item3 = &trace_events()->GetList()[2]; |
| ; |
| ASSERT_TRUE(item3->is_dict()); |
| |
| TraceEntryInfo actual_item1 = GetTraceEntryInfoFromValue(*item1); |
| TraceEntryInfo actual_item2 = GetTraceEntryInfoFromValue(*item2); |
| TraceEntryInfo actual_item3 = GetTraceEntryInfoFromValue(*item3); |
| EXPECT_EQ(kNetLogTracingCategory, actual_item1.category); |
| EXPECT_EQ(base::StringPrintf("0x%d", entries[0].source.id), actual_item1.id); |
| EXPECT_EQ(std::string(1, TRACE_EVENT_PHASE_NESTABLE_ASYNC_INSTANT), |
| actual_item1.phase); |
| EXPECT_EQ(NetLog::EventTypeToString(NetLogEventType::CANCELLED), |
| actual_item1.name); |
| EXPECT_EQ(NetLog::SourceTypeToString(entries[0].source.type), |
| actual_item1.source_type); |
| |
| EXPECT_EQ(kNetLogTracingCategory, actual_item2.category); |
| EXPECT_EQ(base::StringPrintf("0x%d", entries[1].source.id), actual_item2.id); |
| EXPECT_EQ(std::string(1, TRACE_EVENT_PHASE_NESTABLE_ASYNC_BEGIN), |
| actual_item2.phase); |
| EXPECT_EQ(NetLog::EventTypeToString(NetLogEventType::URL_REQUEST_START_JOB), |
| actual_item2.name); |
| EXPECT_EQ(NetLog::SourceTypeToString(entries[1].source.type), |
| actual_item2.source_type); |
| |
| EXPECT_EQ(kNetLogTracingCategory, actual_item3.category); |
| EXPECT_EQ(base::StringPrintf("0x%d", entries[2].source.id), actual_item3.id); |
| EXPECT_EQ(std::string(1, TRACE_EVENT_PHASE_NESTABLE_ASYNC_END), |
| actual_item3.phase); |
| EXPECT_EQ(NetLog::EventTypeToString(NetLogEventType::REQUEST_ALIVE), |
| actual_item3.name); |
| EXPECT_EQ(NetLog::SourceTypeToString(entries[2].source.type), |
| actual_item3.source_type); |
| } |
| |
| TEST_F(TraceNetLogObserverTest, EnableAndDisableTracing) { |
| trace_net_log_observer()->WatchForTraceStart(net_log()); |
| EnableTraceLogWithNetLog(); |
| net_log()->AddGlobalEntry(NetLogEventType::CANCELLED); |
| DisableTraceLog(); |
| net_log()->AddGlobalEntry(NetLogEventType::REQUEST_ALIVE); |
| EnableTraceLogWithNetLog(); |
| net_log()->AddGlobalEntry(NetLogEventType::URL_REQUEST_START_JOB); |
| |
| EndTraceAndFlush(); |
| trace_net_log_observer()->StopWatchForTraceStart(); |
| |
| auto entries = net_log()->GetEntries(); |
| EXPECT_EQ(3u, entries.size()); |
| EXPECT_EQ(2u, trace_events()->GetSize()); |
| const base::Value* item1 = &trace_events()->GetList()[0]; |
| ASSERT_TRUE(item1->is_dict()); |
| const base::Value* item2 = &trace_events()->GetList()[1]; |
| ASSERT_TRUE(item2->is_dict()); |
| |
| TraceEntryInfo actual_item1 = GetTraceEntryInfoFromValue(*item1); |
| TraceEntryInfo actual_item2 = GetTraceEntryInfoFromValue(*item2); |
| EXPECT_EQ(kNetLogTracingCategory, actual_item1.category); |
| EXPECT_EQ(base::StringPrintf("0x%d", entries[0].source.id), actual_item1.id); |
| EXPECT_EQ(std::string(1, TRACE_EVENT_PHASE_NESTABLE_ASYNC_INSTANT), |
| actual_item1.phase); |
| EXPECT_EQ(NetLog::EventTypeToString(NetLogEventType::CANCELLED), |
| actual_item1.name); |
| EXPECT_EQ(NetLog::SourceTypeToString(entries[0].source.type), |
| actual_item1.source_type); |
| |
| EXPECT_EQ(kNetLogTracingCategory, actual_item2.category); |
| EXPECT_EQ(base::StringPrintf("0x%d", entries[2].source.id), actual_item2.id); |
| EXPECT_EQ(std::string(1, TRACE_EVENT_PHASE_NESTABLE_ASYNC_INSTANT), |
| actual_item2.phase); |
| EXPECT_EQ(NetLog::EventTypeToString(NetLogEventType::URL_REQUEST_START_JOB), |
| actual_item2.name); |
| EXPECT_EQ(NetLog::SourceTypeToString(entries[2].source.type), |
| actual_item2.source_type); |
| } |
| |
| TEST_F(TraceNetLogObserverTest, DestroyObserverWhileTracing) { |
| trace_net_log_observer()->WatchForTraceStart(net_log()); |
| EnableTraceLogWithNetLog(); |
| net_log()->AddGlobalEntry(NetLogEventType::CANCELLED); |
| trace_net_log_observer()->StopWatchForTraceStart(); |
| set_trace_net_log_observer(nullptr); |
| net_log()->AddGlobalEntry(NetLogEventType::REQUEST_ALIVE); |
| |
| EndTraceAndFlush(); |
| |
| auto entries = net_log()->GetEntries(); |
| EXPECT_EQ(2u, entries.size()); |
| EXPECT_EQ(1u, trace_events()->GetSize()); |
| |
| const base::Value* item1 = &trace_events()->GetList()[0]; |
| ASSERT_TRUE(item1->is_dict()); |
| |
| TraceEntryInfo actual_item1 = GetTraceEntryInfoFromValue(*item1); |
| EXPECT_EQ(kNetLogTracingCategory, actual_item1.category); |
| EXPECT_EQ(base::StringPrintf("0x%d", entries[0].source.id), actual_item1.id); |
| EXPECT_EQ(std::string(1, TRACE_EVENT_PHASE_NESTABLE_ASYNC_INSTANT), |
| actual_item1.phase); |
| EXPECT_EQ(NetLog::EventTypeToString(NetLogEventType::CANCELLED), |
| actual_item1.name); |
| EXPECT_EQ(NetLog::SourceTypeToString(entries[0].source.type), |
| actual_item1.source_type); |
| } |
| |
| TEST_F(TraceNetLogObserverTest, DestroyObserverWhileNotTracing) { |
| trace_net_log_observer()->WatchForTraceStart(net_log()); |
| net_log()->AddGlobalEntry(NetLogEventType::CANCELLED); |
| trace_net_log_observer()->StopWatchForTraceStart(); |
| set_trace_net_log_observer(nullptr); |
| net_log()->AddGlobalEntry(NetLogEventType::REQUEST_ALIVE); |
| net_log()->AddGlobalEntry(NetLogEventType::URL_REQUEST_START_JOB); |
| |
| EndTraceAndFlush(); |
| |
| auto entries = net_log()->GetEntries(); |
| EXPECT_EQ(3u, entries.size()); |
| EXPECT_EQ(0u, trace_events()->GetSize()); |
| } |
| |
| TEST_F(TraceNetLogObserverTest, CreateObserverAfterTracingStarts) { |
| set_trace_net_log_observer(nullptr); |
| EnableTraceLogWithNetLog(); |
| set_trace_net_log_observer(new TraceNetLogObserver()); |
| trace_net_log_observer()->WatchForTraceStart(net_log()); |
| net_log()->AddGlobalEntry(NetLogEventType::CANCELLED); |
| trace_net_log_observer()->StopWatchForTraceStart(); |
| net_log()->AddGlobalEntry(NetLogEventType::REQUEST_ALIVE); |
| net_log()->AddGlobalEntry(NetLogEventType::URL_REQUEST_START_JOB); |
| |
| EndTraceAndFlush(); |
| |
| auto entries = net_log()->GetEntries(); |
| EXPECT_EQ(3u, entries.size()); |
| EXPECT_EQ(1u, trace_events()->GetSize()); |
| } |
| |
| TEST_F(TraceNetLogObserverTest, |
| CreateObserverAfterTracingStartsDisabledCategory) { |
| set_trace_net_log_observer(nullptr); |
| |
| EnableTraceLogWithoutNetLog(); |
| |
| set_trace_net_log_observer(new TraceNetLogObserver()); |
| trace_net_log_observer()->WatchForTraceStart(net_log()); |
| net_log()->AddGlobalEntry(NetLogEventType::CANCELLED); |
| trace_net_log_observer()->StopWatchForTraceStart(); |
| net_log()->AddGlobalEntry(NetLogEventType::REQUEST_ALIVE); |
| net_log()->AddGlobalEntry(NetLogEventType::URL_REQUEST_START_JOB); |
| |
| EndTraceAndFlush(); |
| |
| auto entries = net_log()->GetEntries(); |
| EXPECT_EQ(3u, entries.size()); |
| EXPECT_EQ(0u, trace_events()->GetSize()); |
| } |
| |
| TEST_F(TraceNetLogObserverTest, EventsWithAndWithoutParameters) { |
| trace_net_log_observer()->WatchForTraceStart(net_log()); |
| EnableTraceLogWithNetLog(); |
| |
| net_log()->AddGlobalEntryWithStringParams(NetLogEventType::CANCELLED, "foo", |
| "bar"); |
| net_log()->AddGlobalEntry(NetLogEventType::REQUEST_ALIVE); |
| |
| EndTraceAndFlush(); |
| trace_net_log_observer()->StopWatchForTraceStart(); |
| |
| auto entries = net_log()->GetEntries(); |
| EXPECT_EQ(2u, entries.size()); |
| EXPECT_EQ(2u, trace_events()->GetSize()); |
| const base::Value* item1 = &trace_events()->GetList()[0]; |
| ASSERT_TRUE(item1->is_dict()); |
| const base::Value* item2 = &trace_events()->GetList()[1]; |
| ASSERT_TRUE(item2->is_dict()); |
| |
| TraceEntryInfo actual_item1 = GetTraceEntryInfoFromValue(*item1); |
| TraceEntryInfo actual_item2 = GetTraceEntryInfoFromValue(*item2); |
| EXPECT_EQ(kNetLogTracingCategory, actual_item1.category); |
| EXPECT_EQ(base::StringPrintf("0x%d", entries[0].source.id), actual_item1.id); |
| EXPECT_EQ(std::string(1, TRACE_EVENT_PHASE_NESTABLE_ASYNC_INSTANT), |
| actual_item1.phase); |
| EXPECT_EQ(NetLog::EventTypeToString(NetLogEventType::CANCELLED), |
| actual_item1.name); |
| EXPECT_EQ(NetLog::SourceTypeToString(entries[0].source.type), |
| actual_item1.source_type); |
| |
| EXPECT_EQ(kNetLogTracingCategory, actual_item2.category); |
| EXPECT_EQ(base::StringPrintf("0x%d", entries[1].source.id), actual_item2.id); |
| EXPECT_EQ(std::string(1, TRACE_EVENT_PHASE_NESTABLE_ASYNC_INSTANT), |
| actual_item2.phase); |
| EXPECT_EQ(NetLog::EventTypeToString(NetLogEventType::REQUEST_ALIVE), |
| actual_item2.name); |
| EXPECT_EQ(NetLog::SourceTypeToString(entries[1].source.type), |
| actual_item2.source_type); |
| |
| const std::string* item1_params = item1->FindStringPath("args.params.foo"); |
| ASSERT_TRUE(item1_params); |
| EXPECT_EQ("bar", *item1_params); |
| |
| const base::Value* item2_params = item2->FindDictPath("args.params"); |
| ASSERT_TRUE(item2_params); |
| EXPECT_TRUE(item2_params->DictEmpty()); |
| } |
| |
| TEST(TraceNetLogObserverCategoryTest, DisabledCategory) { |
| base::test::TaskEnvironment task_environment; |
| TraceNetLogObserver observer; |
| TestNetLog net_log; |
| observer.WatchForTraceStart(&net_log); |
| |
| EXPECT_FALSE(net_log.IsCapturing()); |
| |
| EnableTraceLogWithoutNetLog(); |
| |
| EXPECT_FALSE(net_log.IsCapturing()); |
| observer.StopWatchForTraceStart(); |
| EXPECT_FALSE(net_log.IsCapturing()); |
| |
| DisableTraceLog(); |
| } |
| |
| TEST(TraceNetLogObserverCategoryTest, EnabledCategory) { |
| base::test::TaskEnvironment task_environment; |
| TraceNetLogObserver observer; |
| TestNetLog net_log; |
| observer.WatchForTraceStart(&net_log); |
| |
| EXPECT_FALSE(net_log.IsCapturing()); |
| |
| EnableTraceLogWithNetLog(); |
| |
| EXPECT_TRUE(net_log.IsCapturing()); |
| observer.StopWatchForTraceStart(); |
| EXPECT_FALSE(net_log.IsCapturing()); |
| |
| DisableTraceLog(); |
| } |
| |
| } // namespace |
| |
| } // namespace net |