tracing_category.pony

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
type TracingCategory is
  ( SchedulerTracing
  | SchedulerMessagingTracing
  | ActorTracing
  | ActorBehaviorTracing
  | ActorGCTracing
  | ActorStateChangeTracing
  | SystematicTestingTracing
  | SystematicTestingDetailsTracing
  | RuntimeLifecycleTracing
  | SchedulerStealingTracing
  | CycleDetectorTracing )
  """
  A tracing category passed to `RuntimeTracing` to control which runtime
  events are recorded.
  """

// Keep in sync with tracing_category_t in src/libponyrt/tracing/tracing.c;
// a mismatch silently enables or disables wrong categories.
primitive SchedulerTracing
  """
  Scheduler thread lifecycle and state events.
  """
  fun apply(): U64 => 1

primitive SchedulerMessagingTracing
  """
  Inter-scheduler message send and receive events.
  """
  fun apply(): U64 => 2

primitive ActorTracing
  """
  Actor creation and destruction events.
  """
  fun apply(): U64 => 4

primitive ActorBehaviorTracing
  """
  Actor behavior scheduling and execution events.
  """
  fun apply(): U64 => 8

primitive ActorGCTracing
  """
  Actor garbage collection phase events.
  """
  fun apply(): U64 => 16

primitive ActorStateChangeTracing
  """
  Actor state transitions: muted, overloaded, blocked, etc.
  """
  fun apply(): U64 => 32

primitive SystematicTestingTracing
  """
  Systematic testing lifecycle events.
  """
  fun apply(): U64 => 64

primitive SystematicTestingDetailsTracing
  """
  Detailed systematic testing events (timeslices, waiting).
  """
  fun apply(): U64 => 128

primitive RuntimeLifecycleTracing
  """
  Runtime init, start, and shutdown events.
  """
  fun apply(): U64 => 256

primitive SchedulerStealingTracing
  """
  Work-stealing success and failure events.
  """
  fun apply(): U64 => 512

primitive CycleDetectorTracing
  """
  Actor events for the cycle detector only. Enables all actor event types
  (creation, destruction, behavior runs, GC phases, state changes) but only
  for the cycle detector actor.
  """
  fun apply(): U64 => 1024