blob: ff0e7590c8bdb451ee0c9a893babca16e0cbff36 [file] [log] [blame]
/*
* 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 <stdlib.h>
#include <sys/system_properties.h>
#include <sys/types.h>
#include <sys/wait.h>
#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/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 {
// 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;
}
std::string RandomSessionName() {
std::random_device rd;
std::default_random_engine generator(rd());
std::uniform_int_distribution<> distribution('a', 'z');
constexpr size_t kSessionNameLen = 20;
std::string result(kSessionNameLen, '\0');
for (size_t i = 0; i < kSessionNameLen; ++i)
result[i] = static_cast<char>(distribution(generator));
return result;
}
std::vector<protos::gen::TracePacket> ProfileRuntime(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, "MainActivity", "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<protos::gen::TracePacket> 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<protos::gen::TracePacket> packets) {
ASSERT_GT(packets.size(), 0u);
size_t objects = 0;
size_t roots = 0;
for (const auto& packet : packets) {
objects += static_cast<size_t>(packet.heap_graph().objects_size());
roots += static_cast<size_t>(packet.heap_graph().roots_size());
}
ASSERT_GT(objects, 0u);
ASSERT_GT(roots, 0u);
}
void AssertNoProfileContents(std::vector<protos::gen::TracePacket> 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);
}
}
TEST(HeapprofdJavaCtsTest, DebuggableAppRuntime) {
std::string app_name = "android.perfetto.cts.app.debuggable";
const auto& packets = ProfileRuntime(app_name);
AssertGraphPresent(packets);
}
TEST(HeapprofdJavaCtsTest, ProfileableAppRuntime) {
std::string app_name = "android.perfetto.cts.app.profileable";
const auto& packets = ProfileRuntime(app_name);
AssertGraphPresent(packets);
}
TEST(HeapprofdJavaCtsTest, ReleaseAppRuntime) {
std::string app_name = "android.perfetto.cts.app.release";
const auto& packets = ProfileRuntime(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, "MainActivity", "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<uint64_t>(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