| OLD | NEW |
| 1 // Copyright (c) 2011 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2011 The Chromium Authors. All rights reserved. |
| 2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
| 3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
| 4 | 4 |
| 5 // Trace events are for tracking application performance. | 5 // Trace events are for tracking application performance. |
| 6 // | 6 // |
| 7 // Events are issued against categories. Whereas LOG's | 7 // Events are issued against categories. Whereas LOG's |
| 8 // categories are statically defined, TRACE categories are created | 8 // categories are statically defined, TRACE categories are created |
| 9 // implicitly with a string. For example: | 9 // implicitly with a string. For example: |
| 10 // TRACE_EVENT_INSTANT0("MY_SUBSYSTEM", "SomeImportantEvent") | 10 // TRACE_EVENT_INSTANT0("MY_SUBSYSTEM", "SomeImportantEvent") |
| (...skipping 284 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 295 // Phase indicates the nature of an event entry. E.g. part of a begin/end pair. | 295 // Phase indicates the nature of an event entry. E.g. part of a begin/end pair. |
| 296 enum TraceEventPhase { | 296 enum TraceEventPhase { |
| 297 TRACE_EVENT_PHASE_BEGIN, | 297 TRACE_EVENT_PHASE_BEGIN, |
| 298 TRACE_EVENT_PHASE_END, | 298 TRACE_EVENT_PHASE_END, |
| 299 TRACE_EVENT_PHASE_INSTANT | 299 TRACE_EVENT_PHASE_INSTANT |
| 300 }; | 300 }; |
| 301 | 301 |
| 302 // Simple union of values. This is much lighter weight than base::Value, which | 302 // Simple union of values. This is much lighter weight than base::Value, which |
| 303 // requires dynamic allocation and a vtable. To keep the trace runtime overhead | 303 // requires dynamic allocation and a vtable. To keep the trace runtime overhead |
| 304 // low, we want constant size storage here. | 304 // low, we want constant size storage here. |
| 305 class BASE_API TraceValue { | 305 class BASE_EXPORT TraceValue { |
| 306 public: | 306 public: |
| 307 enum Type { | 307 enum Type { |
| 308 TRACE_TYPE_UNDEFINED, | 308 TRACE_TYPE_UNDEFINED, |
| 309 TRACE_TYPE_BOOL, | 309 TRACE_TYPE_BOOL, |
| 310 TRACE_TYPE_UINT, | 310 TRACE_TYPE_UINT, |
| 311 TRACE_TYPE_INT, | 311 TRACE_TYPE_INT, |
| 312 TRACE_TYPE_DOUBLE, | 312 TRACE_TYPE_DOUBLE, |
| 313 TRACE_TYPE_POINTER, | 313 TRACE_TYPE_POINTER, |
| 314 TRACE_TYPE_STRING | 314 TRACE_TYPE_STRING |
| 315 }; | 315 }; |
| (...skipping 119 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 435 TimeTicks timestamp_; | 435 TimeTicks timestamp_; |
| 436 TraceEventPhase phase_; | 436 TraceEventPhase phase_; |
| 437 const TraceCategory* category_; | 437 const TraceCategory* category_; |
| 438 const char* name_; | 438 const char* name_; |
| 439 const char* arg_names_[kTraceMaxNumArgs]; | 439 const char* arg_names_[kTraceMaxNumArgs]; |
| 440 TraceValue arg_values_[kTraceMaxNumArgs]; | 440 TraceValue arg_values_[kTraceMaxNumArgs]; |
| 441 scoped_refptr<base::RefCountedString> parameter_copy_storage_; | 441 scoped_refptr<base::RefCountedString> parameter_copy_storage_; |
| 442 }; | 442 }; |
| 443 | 443 |
| 444 | 444 |
| 445 class BASE_API TraceLog { | 445 class BASE_EXPORT TraceLog { |
| 446 public: | 446 public: |
| 447 static TraceLog* GetInstance(); | 447 static TraceLog* GetInstance(); |
| 448 | 448 |
| 449 // Global enable of tracing. Currently enables all categories or not. | 449 // Global enable of tracing. Currently enables all categories or not. |
| 450 // TODO(scheib): Replace with an Enable/DisableCategory() that | 450 // TODO(scheib): Replace with an Enable/DisableCategory() that |
| 451 // implicitly controls the global logging state. | 451 // implicitly controls the global logging state. |
| 452 void SetEnabled(bool enabled); | 452 void SetEnabled(bool enabled); |
| 453 bool IsEnabled() { return enabled_; } | 453 bool IsEnabled() { return enabled_; } |
| 454 | 454 |
| 455 float GetBufferPercentFull() const; | 455 float GetBufferPercentFull() const; |
| (...skipping 64 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 520 OutputCallback output_callback_; | 520 OutputCallback output_callback_; |
| 521 BufferFullCallback buffer_full_callback_; | 521 BufferFullCallback buffer_full_callback_; |
| 522 std::vector<TraceEvent> logged_events_; | 522 std::vector<TraceEvent> logged_events_; |
| 523 | 523 |
| 524 DISALLOW_COPY_AND_ASSIGN(TraceLog); | 524 DISALLOW_COPY_AND_ASSIGN(TraceLog); |
| 525 }; | 525 }; |
| 526 | 526 |
| 527 namespace internal { | 527 namespace internal { |
| 528 | 528 |
| 529 // Used by TRACE_EVENTx macro. Do not use directly. | 529 // Used by TRACE_EVENTx macro. Do not use directly. |
| 530 class BASE_API TraceEndOnScopeClose { | 530 class BASE_EXPORT TraceEndOnScopeClose { |
| 531 public: | 531 public: |
| 532 TraceEndOnScopeClose() : p_data_(NULL) {} | 532 TraceEndOnScopeClose() : p_data_(NULL) {} |
| 533 ~TraceEndOnScopeClose() { | 533 ~TraceEndOnScopeClose() { |
| 534 if (p_data_) | 534 if (p_data_) |
| 535 AddEventIfEnabled(); | 535 AddEventIfEnabled(); |
| 536 } | 536 } |
| 537 | 537 |
| 538 void Initialize(const TraceCategory* category, | 538 void Initialize(const TraceCategory* category, |
| 539 const char* name); | 539 const char* name); |
| 540 | 540 |
| 541 private: | 541 private: |
| 542 // Add the end event if the category is still enabled. | 542 // Add the end event if the category is still enabled. |
| 543 void AddEventIfEnabled(); | 543 void AddEventIfEnabled(); |
| 544 | 544 |
| 545 // This Data struct workaround is to avoid initializing all the members | 545 // This Data struct workaround is to avoid initializing all the members |
| 546 // in Data during construction of this object, since this object is always | 546 // in Data during construction of this object, since this object is always |
| 547 // constructed, even when tracing is disabled. If the members of Data were | 547 // constructed, even when tracing is disabled. If the members of Data were |
| 548 // members of this class instead, compiler warnings occur about potential | 548 // members of this class instead, compiler warnings occur about potential |
| 549 // uninitialized accesses. | 549 // uninitialized accesses. |
| 550 struct Data { | 550 struct Data { |
| 551 const TraceCategory* category; | 551 const TraceCategory* category; |
| 552 const char* name; | 552 const char* name; |
| 553 }; | 553 }; |
| 554 Data* p_data_; | 554 Data* p_data_; |
| 555 Data data_; | 555 Data data_; |
| 556 }; | 556 }; |
| 557 | 557 |
| 558 // Used by TRACE_EVENTx macro. Do not use directly. | 558 // Used by TRACE_EVENTx macro. Do not use directly. |
| 559 class BASE_API TraceEndOnScopeCloseThreshold { | 559 class BASE_EXPORT TraceEndOnScopeCloseThreshold { |
| 560 public: | 560 public: |
| 561 TraceEndOnScopeCloseThreshold() : p_data_(NULL) {} | 561 TraceEndOnScopeCloseThreshold() : p_data_(NULL) {} |
| 562 ~TraceEndOnScopeCloseThreshold() { | 562 ~TraceEndOnScopeCloseThreshold() { |
| 563 if (p_data_) | 563 if (p_data_) |
| 564 AddEventIfEnabled(); | 564 AddEventIfEnabled(); |
| 565 } | 565 } |
| 566 | 566 |
| 567 // Called by macros only when tracing is enabled at the point when the begin | 567 // Called by macros only when tracing is enabled at the point when the begin |
| 568 // event is added. | 568 // event is added. |
| 569 void Initialize(const TraceCategory* category, | 569 void Initialize(const TraceCategory* category, |
| (...skipping 19 matching lines...) Expand all Loading... |
| 589 Data* p_data_; | 589 Data* p_data_; |
| 590 Data data_; | 590 Data data_; |
| 591 }; | 591 }; |
| 592 | 592 |
| 593 } // namespace internal | 593 } // namespace internal |
| 594 | 594 |
| 595 } // namespace debug | 595 } // namespace debug |
| 596 } // namespace base | 596 } // namespace base |
| 597 | 597 |
| 598 #endif // BASE_DEBUG_TRACE_EVENT_H_ | 598 #endif // BASE_DEBUG_TRACE_EVENT_H_ |
| OLD | NEW |