1 /* 2 * Copyright (c) 2023-2025 Huawei Device Co., Ltd. 3 * Licensed under the Apache License, Version 2.0 (the "License"); 4 * you may not use this file except in compliance with the License. 5 * You may obtain a copy of the License at 6 * 7 * http://www.apache.org/licenses/LICENSE-2.0 8 * 9 * Unless required by applicable law or agreed to in writing, software 10 * distributed under the License is distributed on an "AS IS" BASIS, 11 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 12 * See the License for the specific language governing permissions and 13 * limitations under the License. 14 */ 15 #ifndef INTERFACES_INNER_API_UNIFIED_COLLECTION_UTILITY_PERF_COLLECTOR_H 16 #define INTERFACES_INNER_API_UNIFIED_COLLECTION_UTILITY_PERF_COLLECTOR_H 17 #include <string> 18 #include <vector> 19 20 #include "collect_result.h" 21 22 namespace OHOS { 23 namespace HiviewDFX { 24 namespace UCollectUtil { 25 enum class PerfCaller { 26 EVENTLOGGER, 27 XPOWER, 28 UNIFIED_COLLECTOR, 29 PERFORMANCE_FACTORY, 30 }; 31 32 class PerfCollector { 33 public: 34 PerfCollector() = default; 35 virtual ~PerfCollector() = default; 36 virtual CollectResult<bool> StartPerf(const std::string &logDir) = 0; 37 virtual void SetSelectPids(const std::vector<pid_t> &selectPids) = 0; 38 virtual void SetTargetSystemWide(bool enable) = 0; 39 virtual void SetTimeStopSec(int timeStopSec) = 0; 40 virtual void SetFrequency(int frequency) = 0; 41 virtual void SetOffCPU(bool offCPU) = 0; 42 virtual void SetOutputFilename(const std::string &outputFilename) = 0; 43 virtual void SetCallGraph(const std::string &sampleTypes) = 0; 44 virtual void SetSelectEvents(const std::vector<std::string> &selectEvents) = 0; 45 virtual void SetCpuPercent(int cpuPercent) = 0; 46 virtual void SetReport(bool enable) = 0; 47 // for prepare recod mode 48 virtual CollectResult<bool> Prepare(const std::string &logDir) = 0; 49 virtual CollectResult<bool> StartRun() = 0; 50 virtual CollectResult<bool> Pause() = 0; 51 virtual CollectResult<bool> Resume() = 0; 52 virtual CollectResult<bool> Stop() = 0; 53 static std::shared_ptr<PerfCollector> Create(PerfCaller perfCaller); 54 }; 55 } // UCollectUtil 56 } // HivewDFX 57 } // OHOS 58 #endif // INTERFACES_INNER_API_UNIFIED_COLLECTION_UTILITY_PERF_COLLECTOR_H 59