/* * Copyright (C) 2019 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #include #include #include #include #include "perfetto/base/logging.h" #include "perfetto/ext/base/android_utils.h" #include "perfetto/ext/base/string_utils.h" #include "perfetto/tracing/core/data_source_config.h" #include "src/base/test/test_task_runner.h" #include "test/android_test_utils.h" #include "test/cts/heapprofd_test_helper.h" #include "test/gtest_and_gmock.h" #include "test/test_helper.h" #include "protos/perfetto/config/profiling/java_hprof_config.gen.h" #include "protos/perfetto/trace/profiling/heap_graph.gen.h" #include "protos/perfetto/trace/profiling/profile_common.gen.h" #include "protos/perfetto/trace/trace_packet.gen.h" namespace perfetto { namespace { constexpr uint64_t kTestSamplingInterval = 4096; // Activity that runs a java thread that repeatedly constructs small java // objects. static char kJavaAllocActivity[] = "JavaAllocActivity"; // Even though ART is a mainline module, there are dependencies on perfetto for // OOM heap dumps to work correctly. bool SupportsOomHeapDump() { auto sdk = base::StringToInt32(base::GetAndroidProp("ro.build.version.sdk")); if (sdk && *sdk >= 34) { PERFETTO_LOG("SDK supports OOME heap dumps"); return true; } if (base::GetAndroidProp("ro.build.version.codename") == "UpsideDownCake") { PERFETTO_LOG("Codename supports OOME heap dumps"); return true; } PERFETTO_LOG("OOME heap dumps not supported"); return false; } // TODO(rsavitski): deduplicate with heapprofd_test_helper.cc:ProfileRuntime. std::vector ProfileHeapGraphRuntime( std::string app_name) { base::TestTaskRunner task_runner; // (re)start the target app's main activity if (IsAppRunning(app_name)) { StopApp(app_name, "old.app.stopped", &task_runner); task_runner.RunUntilCheckpoint("old.app.stopped", 10000 /*ms*/); } StartAppActivity(app_name, "NoopActivity", "target.app.running", &task_runner, /*delay_ms=*/100); task_runner.RunUntilCheckpoint("target.app.running", 10000 /*ms*/); // If we try to dump too early in app initialization, we sometimes deadlock. sleep(1); // set up tracing TestHelper helper(&task_runner); helper.ConnectConsumer(); helper.WaitForConsumerConnect(); TraceConfig trace_config; trace_config.add_buffers()->set_size_kb(40 * 1024); trace_config.set_duration_ms(3000); trace_config.set_data_source_stop_timeout_ms(20000); trace_config.set_unique_session_name(RandomSessionName().c_str()); auto* ds_config = trace_config.add_data_sources()->mutable_config(); ds_config->set_name("android.java_hprof"); ds_config->set_target_buffer(0); protos::gen::JavaHprofConfig java_hprof_config; java_hprof_config.add_process_cmdline(app_name.c_str()); ds_config->set_java_hprof_config_raw(java_hprof_config.SerializeAsString()); // start tracing helper.StartTracing(trace_config); helper.WaitForTracingDisabled(); helper.ReadData(); helper.WaitForReadData(); PERFETTO_CHECK(IsAppRunning(app_name)); StopApp(app_name, "new.app.stopped", &task_runner); task_runner.RunUntilCheckpoint("new.app.stopped", 10000 /*ms*/); return helper.trace(); } std::vector TriggerOomHeapDump( std::string app_name, std::string heap_dump_target) { base::TestTaskRunner task_runner; // (re)start the target app's main activity if (IsAppRunning(app_name)) { StopApp(app_name, "old.app.stopped", &task_runner); task_runner.RunUntilCheckpoint("old.app.stopped", 10000 /*ms*/); } // set up tracing TestHelper helper(&task_runner); helper.ConnectConsumer(); helper.WaitForConsumerConnect(); TraceConfig trace_config; trace_config.add_buffers()->set_size_kb(40 * 1024); trace_config.set_unique_session_name(RandomSessionName().c_str()); trace_config.set_data_source_stop_timeout_ms(60000); auto* trigger_config = trace_config.mutable_trigger_config(); trigger_config->set_trigger_mode( perfetto::protos::gen::TraceConfig::TriggerConfig::START_TRACING); trigger_config->set_trigger_timeout_ms(60000); auto* oom_trigger = trigger_config->add_triggers(); oom_trigger->set_name("com.android.telemetry.art-outofmemory"); oom_trigger->set_stop_delay_ms(1000); auto* ds_config = trace_config.add_data_sources()->mutable_config(); ds_config->set_name("android.java_hprof.oom"); ds_config->set_target_buffer(0); protos::gen::JavaHprofConfig java_hprof_config; java_hprof_config.add_process_cmdline(heap_dump_target.c_str()); ds_config->set_java_hprof_config_raw(java_hprof_config.SerializeAsString()); // start tracing helper.StartTracing(trace_config); StartAppActivity(app_name, "JavaOomActivity", "target.app.running", &task_runner, /*delay_ms=*/100); task_runner.RunUntilCheckpoint("target.app.running", 10000 /*ms*/); if (SupportsOomHeapDump()) { helper.WaitForTracingDisabled(); helper.ReadData(); helper.WaitForReadData(); } PERFETTO_CHECK(IsAppRunning(app_name)); StopApp(app_name, "new.app.stopped", &task_runner); task_runner.RunUntilCheckpoint("new.app.stopped", 10000 /*ms*/); return helper.trace(); } void AssertGraphPresent(std::vector packets) { ASSERT_GT(packets.size(), 0u); size_t objects = 0; size_t roots = 0; for (const auto& packet : packets) { objects += static_cast(packet.heap_graph().objects_size()); roots += static_cast(packet.heap_graph().roots_size()); } ASSERT_GT(objects, 0u); ASSERT_GT(roots, 0u); } void AssertNoProfileContents(std::vector packets) { // If profile packets are present, they must be empty. for (const auto& packet : packets) { ASSERT_EQ(packet.heap_graph().roots_size(), 0); ASSERT_EQ(packet.heap_graph().objects_size(), 0); ASSERT_EQ(packet.heap_graph().types_size(), 0); ASSERT_EQ(packet.heap_graph().field_names_size(), 0); } } // // Tests for the NDK custom allocator API, as used by ART's java heap sampler. // TEST(HeapprofdJavaCtsTest, ArtHeapCustomAllocatorRuntime) { std::string app_name = "android.perfetto.cts.app.debuggable"; const auto& packets = ProfileRuntime(app_name, kJavaAllocActivity, kTestSamplingInterval, /*heap_names=*/{"com.android.art"}); AssertHasSampledAllocs(packets); StopApp(app_name); } TEST(HeapprofdJavaCtsTest, ArtHeapCustomAllocatorStartup) { std::string app_name = "android.perfetto.cts.app.debuggable"; const auto& packets = ProfileStartup(app_name, kJavaAllocActivity, kTestSamplingInterval, /*heap_names=*/{"com.android.art"}); AssertHasSampledAllocs(packets); StopApp(app_name); } // // Tests for the java heap graph plugin in ART. // TEST(HeapprofdJavaCtsTest, DebuggableAppRuntime) { std::string app_name = "android.perfetto.cts.app.debuggable"; const auto& packets = ProfileHeapGraphRuntime(app_name); AssertGraphPresent(packets); } TEST(HeapprofdJavaCtsTest, ProfileableAppRuntime) { std::string app_name = "android.perfetto.cts.app.profileable"; const auto& packets = ProfileHeapGraphRuntime(app_name); AssertGraphPresent(packets); } TEST(HeapprofdJavaCtsTest, ReleaseAppRuntime) { std::string app_name = "android.perfetto.cts.app.release"; const auto& packets = ProfileHeapGraphRuntime(app_name); if (!IsUserBuild()) AssertGraphPresent(packets); else AssertNoProfileContents(packets); } TEST(HeapprofdJavaCtsTest, DebuggableAppRuntimeByPid) { std::string app_name = "android.perfetto.cts.app.debuggable"; base::TestTaskRunner task_runner; // (re)start the target app's main activity if (IsAppRunning(app_name)) { StopApp(app_name, "old.app.stopped", &task_runner); task_runner.RunUntilCheckpoint("old.app.stopped", 10000 /*ms*/); } StartAppActivity(app_name, "NoopActivity", "target.app.running", &task_runner, /*delay_ms=*/100); task_runner.RunUntilCheckpoint("target.app.running", 10000 /*ms*/); // If we try to dump too early in app initialization, we sometimes deadlock. sleep(1); int target_pid = PidForProcessName(app_name); ASSERT_NE(target_pid, -1); // set up tracing TestHelper helper(&task_runner); helper.ConnectConsumer(); helper.WaitForConsumerConnect(); TraceConfig trace_config; trace_config.add_buffers()->set_size_kb(40 * 1024); trace_config.set_duration_ms(3000); trace_config.set_data_source_stop_timeout_ms(20000); trace_config.set_unique_session_name(RandomSessionName().c_str()); auto* ds_config = trace_config.add_data_sources()->mutable_config(); ds_config->set_name("android.java_hprof"); ds_config->set_target_buffer(0); protos::gen::JavaHprofConfig java_hprof_config; java_hprof_config.add_pid(static_cast(target_pid)); ds_config->set_java_hprof_config_raw(java_hprof_config.SerializeAsString()); // start tracing helper.StartTracing(trace_config); helper.WaitForTracingDisabled(); helper.ReadData(); helper.WaitForReadData(); PERFETTO_CHECK(IsAppRunning(app_name)); StopApp(app_name, "new.app.stopped", &task_runner); task_runner.RunUntilCheckpoint("new.app.stopped", 10000 /*ms*/); const auto& packets = helper.trace(); AssertGraphPresent(packets); } TEST(HeapprofdJavaCtsTest, DebuggableAppOom) { std::string app_name = "android.perfetto.cts.app.debuggable"; const auto& packets = TriggerOomHeapDump(app_name, "*"); if (SupportsOomHeapDump()) { AssertGraphPresent(packets); } } TEST(HeapprofdJavaCtsTest, ProfileableAppOom) { std::string app_name = "android.perfetto.cts.app.profileable"; const auto& packets = TriggerOomHeapDump(app_name, "*"); if (SupportsOomHeapDump()) { AssertGraphPresent(packets); } } TEST(HeapprofdJavaCtsTest, ReleaseAppOom) { std::string app_name = "android.perfetto.cts.app.release"; const auto& packets = TriggerOomHeapDump(app_name, "*"); if (IsUserBuild()) { AssertNoProfileContents(packets); } else if (SupportsOomHeapDump()) { AssertGraphPresent(packets); } } TEST(HeapprofdJavaCtsTest, DebuggableAppOomNotSelected) { std::string app_name = "android.perfetto.cts.app.debuggable"; const auto& packets = TriggerOomHeapDump(app_name, "not.this.app"); AssertNoProfileContents(packets); } } // namespace } // namespace perfetto