5#ifndef V8_V8_PROFILER_H_
6#define V8_V8_PROFILER_H_
11#include <unordered_set>
26struct HeapStatsUpdate;
46template class V8_EXPORT std::vector<v8::CpuProfileDeoptFrame>;
54 std::vector<CpuProfileDeoptFrame>
stack;
60template class V8_EXPORT std::vector<v8::CpuProfileDeoptInfo>;
179 static const int kNoLineNumberInfo = Message::kNoLineNumberInfo;
180 static const int kNoColumnNumberInfo = Message::kNoColumnInfo;
352 friend internal::CpuProfile;
354 void SetId(
ProfilerId id) { profiler_id_ = id; }
356 ProfilerId profiler_id_;
365 static const unsigned kNoSampleLimit = UINT_MAX;
384 unsigned max_samples = kNoSampleLimit,
int sampling_interval_us = 0,
395 friend class internal::CpuProfile;
397 bool has_filter_context()
const {
return !filter_context_.IsEmpty(); }
398 void* raw_filter_context()
const;
401 unsigned max_samples_;
402 int sampling_interval_us_;
429 Isolate* isolate,
const std::optional<uint64_t> trace_id = std::nullopt);
458 std::unique_ptr<DiscardedSamplesDelegate> delegate =
nullptr);
467 std::unique_ptr<DiscardedSamplesDelegate> delegate =
nullptr);
482 unsigned max_samples = CpuProfilingOptions::kNoSampleLimit);
498 std::unique_ptr<DiscardedSamplesDelegate> delegate =
nullptr);
513 unsigned max_samples = CpuProfilingOptions::kNoSampleLimit);
521 bool record_samples =
false);
554 kContextVariable = 0,
826 static const int kNoLineNumberInfo = Message::kNoLineNumberInfo;
827 static const int kNoColumnNumberInfo = Message::kNoColumnInfo;
863 virtual const char*
Name() = 0;
976 kSamplingNoFlags = 0,
977 kSamplingForceGC = 1 << 0,
978 kSamplingIncludeObjectsCollectedByMajorGC = 1 << 1,
979 kSamplingIncludeObjectsCollectedByMinorGC = 1 << 2,
1002 uint16_t class_id,
void* data);
1077 kExposeNumericValues
1126 bool hide_internals =
true,
bool capture_numeric_value =
false);
1159 int64_t* timestamp_us =
nullptr);
1194 int stack_depth = 16,
1240 static const uint16_t kPersistentHandleNoClassId = 0;
1255 : index(index), count(count), size(size) { }
1261#define CODE_EVENTS_LIST(V) \
1266 V(InterpretedFunction) \
1268 V(BytecodeHandler) \
1281#define V(Name) , k##Name##Type
1291 uintptr_t GetCodeStartAddress();
1292 size_t GetCodeSize();
1295 int GetScriptLine();
1296 int GetScriptColumn();
1303 const char* GetComment();
1305 static const char* GetCodeEventTypeName(
CodeEventType code_event_type);
1307 uintptr_t GetPreviousCodeStartAddress();
1349 void* internal_listener_;
Definition: v8-profiler.h:701
ControlOption
Definition: v8-profiler.h:703
virtual ControlOption ReportProgressValue(uint32_t done, uint32_t total)=0
virtual ~ActivityControl()=default
Definition: v8-profiler.h:719
virtual const std::vector< Sample > & GetSamples()=0
virtual Node * GetRootNode()=0
virtual ~AllocationProfile()=default
Definition: v8-profiler.h:1312
Definition: v8-profiler.h:1288
Definition: v8-profiler.h:68
const CpuProfileNode * GetChild(int index) const
bool GetLineTicks(LineTick *entries, unsigned int length) const
const CpuProfileNode * GetParent() const
unsigned GetHitCount() const
unsigned int GetHitLineCount() const
int GetLineNumber() const
unsigned GetNodeId() const
const char * GetScriptResourceNameStr() const
const char * GetFunctionNameStr() const
const std::vector< CpuProfileDeoptInfo > & GetDeoptInfos() const
SourceType
Definition: v8-profiler.h:83
int GetColumnNumber() const
Local< String > GetFunctionName() const
Local< String > GetScriptResourceName() const
SourceType GetSourceType() const
const char * GetBailoutReason() const
bool IsScriptSharedCrossOrigin() const
int GetChildrenCount() const
Definition: v8-profiler.h:214
const CpuProfileNode * GetTopDownRoot() const
int GetSamplesCount() const
StateTag GetSampleState(int index) const
Local< String > GetTitle() const
int64_t GetEndTime() const
const CpuProfileNode * GetSample(int index) const
SerializationFormat
Definition: v8-profiler.h:216
int64_t GetSampleTimestamp(int index) const
int64_t GetStartTime() const
EmbedderStateTag GetSampleEmbedderState(int index) const
void Serialize(OutputStream *stream, SerializationFormat format=kJSON) const
Definition: v8-profiler.h:410
CpuProfilingResult Start(CpuProfilingOptions options, std::unique_ptr< DiscardedSamplesDelegate > delegate=nullptr)
static void CollectSample(Isolate *isolate, const std::optional< uint64_t > trace_id=std::nullopt)
CpuProfilingStatus StartProfiling(Local< String > title, CpuProfilingOptions options, std::unique_ptr< DiscardedSamplesDelegate > delegate=nullptr)
void SetUsePreciseSampling(bool)
static CpuProfiler * New(Isolate *isolate, CpuProfilingNamingMode=kDebugNaming, CpuProfilingLoggingMode=kLazyLogging)
CpuProfilingResult Start(Local< String > title, CpuProfilingMode mode, bool record_samples=false, unsigned max_samples=CpuProfilingOptions::kNoSampleLimit)
CpuProfilingStatus StartProfiling(Local< String > title, CpuProfilingMode mode, bool record_samples=false, unsigned max_samples=CpuProfilingOptions::kNoSampleLimit)
CpuProfile * StopProfiling(Local< String > title)
CpuProfilingResult Start(Local< String > title, CpuProfilingOptions options, std::unique_ptr< DiscardedSamplesDelegate > delegate=nullptr)
void SetSamplingInterval(int us)
CpuProfile * Stop(ProfilerId id)
static void UseDetailedSourcePositionsForProfiling(Isolate *isolate)
CpuProfilingStatus StartProfiling(Local< String > title, bool record_samples=false)
CpuProfilingResult Start(Local< String > title, bool record_samples=false)
Definition: v8-profiler.h:362
CpuProfilingOptions & operator=(CpuProfilingOptions &&)=default
int sampling_interval_us() const
Definition: v8-profiler.h:392
CpuProfilingMode mode() const
Definition: v8-profiler.h:390
unsigned max_samples() const
Definition: v8-profiler.h:391
CpuProfilingOptions(CpuProfilingOptions &&)=default
CpuProfilingOptions(CpuProfilingMode mode=kLeafNodeLineNumbers, unsigned max_samples=kNoSampleLimit, int sampling_interval_us=0, MaybeLocal< Context > filter_context=MaybeLocal< Context >())
Definition: v8-profiler.h:342
ProfilerId GetId() const
Definition: v8-profiler.h:349
DiscardedSamplesDelegate()=default
virtual ~DiscardedSamplesDelegate()=default
Definition: v8-profiler.h:846
virtual Detachedness GetDetachedness()
Definition: v8-profiler.h:891
Detachedness
Definition: v8-profiler.h:855
Node & operator=(const Node &)=delete
virtual size_t SizeInBytes()=0
virtual bool IsEmbedderNode()
Definition: v8-profiler.h:873
virtual const char * Name()=0
virtual NativeObject GetNativeObject()
Definition: v8-profiler.h:883
virtual Node * WrapperNode()
Definition: v8-profiler.h:870
Node(const Node &)=delete
virtual const char * NamePrefix()
Definition: v8-profiler.h:877
virtual const void * GetAddress()
Definition: v8-profiler.h:900
virtual bool IsRootNode()
Definition: v8-profiler.h:871
Definition: v8-profiler.h:844
virtual void AddNativeSize(size_t size)
Definition: v8-profiler.h:954
virtual ~EmbedderGraph()=default
virtual void AddEdge(Node *from, Node *to, const char *name=nullptr)=0
virtual Node * AddNode(std::unique_ptr< Node > node)=0
virtual Node * V8Node(const v8::Local< v8::Data > &value)
virtual Node * V8Node(const v8::Local< v8::Value > &value)=0
Definition: v8-persistent-handle.h:349
Definition: v8-profiler.h:551
Type
Definition: v8-profiler.h:553
const HeapGraphNode * GetToNode() const
const HeapGraphNode * GetFromNode() const
Local< Value > GetName() const
Definition: v8-profiler.h:587
Local< String > GetName() const
SnapshotObjectId GetId() const
Type
Definition: v8-profiler.h:589
const HeapGraphEdge * GetChild(int index) const
size_t GetShallowSize() const
int GetChildrenCount() const
Definition: v8-profiler.h:1045
virtual ~ObjectNameResolver()=default
virtual const char * GetName(Local< Object > object)=0
Definition: v8-profiler.h:969
void StartTrackingHeapObjects(bool track_allocations=false)
void SetGetDetachednessCallback(GetDetachednessCallback callback, void *data)
Local< Value > FindObjectById(SnapshotObjectId id)
AllocationProfile * GetAllocationProfile()
void RemoveBuildEmbedderGraphCallback(BuildEmbedderGraphCallback callback, void *data)
void AddBuildEmbedderGraphCallback(BuildEmbedderGraphCallback callback, void *data)
std::vector< v8::Local< v8::Value > > GetDetachedJSWrapperObjects()
void DeleteAllHeapSnapshots()
bool StartSamplingHeapProfiler(uint64_t sample_interval=512 *1024, int stack_depth=16, SamplingFlags flags=kSamplingNoFlags)
const char * CopyNameForHeapSnapshot(const char *name)
HeapSnapshotMode
Definition: v8-profiler.h:1057
const HeapSnapshot * TakeHeapSnapshot(ActivityControl *control, ObjectNameResolver *global_object_name_resolver=nullptr, bool hide_internals=true, bool capture_numeric_value=false)
SamplingFlags
Definition: v8-profiler.h:975
void QueryObjects(v8::Local< v8::Context > context, QueryObjectPredicate *predicate, std::vector< v8::Global< v8::Object > > *objects)
SnapshotObjectId GetObjectId(NativeObject value)
SnapshotObjectId GetObjectId(Local< Value > value)
void StopSamplingHeapProfiler()
const HeapSnapshot * TakeHeapSnapshot(const HeapSnapshotOptions &options=HeapSnapshotOptions())
const HeapSnapshot * GetHeapSnapshot(int index)
SnapshotObjectId GetHeapStats(OutputStream *stream, int64_t *timestamp_us=nullptr)
void StopTrackingHeapObjects()
EmbedderGraph::Node::Detachedness(*)(v8::Isolate *isolate, const v8::Local< v8::Value > &v8_value, uint16_t class_id, void *data) GetDetachednessCallback
Definition: v8-profiler.h:1002
NumericsMode
Definition: v8-profiler.h:1068
Definition: v8-profiler.h:638
const HeapGraphNode * GetNodeById(SnapshotObjectId id) const
int GetNodesCount() const
SerializationFormat
Definition: v8-profiler.h:640
const HeapGraphNode * GetRoot() const
SnapshotObjectId GetMaxSnapshotJSObjectId() const
const HeapGraphNode * GetNode(int index) const
void Serialize(OutputStream *stream, SerializationFormat format=kJSON) const
Definition: v8-isolate.h:274
Definition: v8-local-handle.h:267
Definition: v8-local-handle.h:635
Definition: v8-profiler.h:186
virtual ~OutputStream()=default
virtual WriteResult WriteHeapStatsChunk(HeapStatsUpdate *data, int count)
Definition: v8-profiler.h:205
WriteResult
Definition: v8-profiler.h:188
virtual WriteResult WriteAsciiChunk(char *data, int size)=0
virtual void EndOfStream()=0
virtual int GetChunkSize()
Definition: v8-profiler.h:193
Definition: v8-profiler.h:959
virtual bool Filter(v8::Local< v8::Object > object)=0
virtual ~QueryObjectPredicate()=default
EmbedderStackState
Definition: common.h:15
@ kMayContainHeapPointers
Definition: libplatform.h:15
uint32_t SnapshotObjectId
Definition: v8-profiler.h:31
CpuProfilingStatus
Definition: v8-profiler.h:324
uint32_t ProfilerId
Definition: v8-profiler.h:32
CpuProfilingLoggingMode
Definition: v8-profiler.h:312
@ kEagerLogging
Definition: v8-profiler.h:318
@ kLazyLogging
Definition: v8-profiler.h:315
EmbedderStateTag
Definition: v8-embedder-state-scope.h:22
CpuProfilingMode
Definition: v8-profiler.h:293
@ kLeafNodeLineNumbers
Definition: v8-profiler.h:297
@ kCallerLineNumbers
Definition: v8-profiler.h:300
void * NativeObject
Definition: v8-profiler.h:30
CpuProfilingNamingMode
Definition: v8-profiler.h:304
@ kStandardNaming
Definition: v8-profiler.h:306
@ kDebugNaming
Definition: v8-profiler.h:309
CodeEventType
Definition: v8-profiler.h:1279
@ kUnknownType
Definition: v8-profiler.h:1280
StateTag
Definition: v8-unwinder.h:36
Definition: v8-profiler.h:721
unsigned int count
Definition: v8-profiler.h:730
size_t size
Definition: v8-profiler.h:725
Definition: v8-profiler.h:736
std::vector< Node * > children
Definition: v8-profiler.h:782
int script_id
Definition: v8-profiler.h:753
int start_position
Definition: v8-profiler.h:758
std::vector< Allocation > allocations
Definition: v8-profiler.h:787
int column_number
Definition: v8-profiler.h:770
uint32_t node_id
Definition: v8-profiler.h:775
int line_number
Definition: v8-profiler.h:764
Local< String > script_name
Definition: v8-profiler.h:747
Local< String > name
Definition: v8-profiler.h:741
Definition: v8-profiler.h:793
unsigned int count
Definition: v8-profiler.h:807
size_t size
Definition: v8-profiler.h:802
uint32_t node_id
Definition: v8-profiler.h:797
uint64_t sample_id
Definition: v8-profiler.h:813
Definition: v8-profiler.h:34
size_t position
Definition: v8-profiler.h:36
int script_id
Definition: v8-profiler.h:35
Definition: v8-profiler.h:51
const char * deopt_reason
Definition: v8-profiler.h:53
std::vector< CpuProfileDeoptFrame > stack
Definition: v8-profiler.h:54
Definition: v8-profiler.h:70
unsigned int hit_count
Definition: v8-profiler.h:79
int column
Definition: v8-profiler.h:76
int line
Definition: v8-profiler.h:72
Definition: v8-profiler.h:334
const ProfilerId id
Definition: v8-profiler.h:335
const CpuProfilingStatus status
Definition: v8-profiler.h:336
Definition: v8-profiler.h:1080
HeapSnapshotOptions()
Definition: v8-profiler.h:1084
Definition: v8-profiler.h:1253
uint32_t size
Definition: v8-profiler.h:1258
uint32_t index
Definition: v8-profiler.h:1256
uint32_t count
Definition: v8-profiler.h:1257
HeapStatsUpdate(uint32_t index, uint32_t count, uint32_t size)
Definition: v8-profiler.h:1254
#define CODE_EVENTS_LIST(V)
Definition: v8-profiler.h:1261
#define V8_EXPORT
Definition: v8config.h:800