7373_logger = getLogger (__name__ )
7474
7575
76- class LogRecord (ABC ):
77- """A LogRecord instance represents an event being logged.
78-
79- LogRecord instances are created and emitted via `Logger`
80- every time something is logged. They contain all the information
81- pertinent to the event being logged.
82- """
83-
84- def __init__ (
85- self ,
86- timestamp : Optional [int ] = None ,
87- observed_timestamp : Optional [int ] = None ,
88- trace_id : Optional [int ] = None ,
89- span_id : Optional [int ] = None ,
90- trace_flags : Optional ["TraceFlags" ] = None ,
91- severity_text : Optional [str ] = None ,
92- severity_number : Optional [SeverityNumber ] = None ,
93- body : Optional [Any ] = None ,
94- attributes : Optional ["Attributes" ] = None ,
95- ):
96- self .timestamp = timestamp
97- if observed_timestamp is None :
98- observed_timestamp = time_ns ()
99- self .observed_timestamp = observed_timestamp
100- self .trace_id = trace_id
101- self .span_id = span_id
102- self .trace_flags = trace_flags
103- self .severity_text = severity_text
104- self .severity_number = severity_number
105- self .body = body # type: ignore
106- self .attributes = attributes
107-
108-
10976class Logger (ABC ):
11077 """Handles emitting events and logs via `LogRecord`."""
11178
@@ -126,18 +93,14 @@ def __init__(
12693 def is_enabled (
12794 self ,
12895 severity_number : Optional [SeverityNumber ] = None ,
129- context : Optional [Context ] = None
96+ context : Optional [Context ] = None ,
13097 ) -> bool :
13198 """Returns True if the logger is enabled for given severity and context, False otherwise."""
13299
133100 @abstractmethod
134- def emit (self , record : "LogRecord" ) -> None :
135- """Emits a :class:`LogRecord` representing a log to the processing pipeline."""
136-
137- @abstractmethod
138- def emit_event (
101+ def emit (
139102 self ,
140- name : str ,
103+ name : str = None ,
141104 timestamp : Optional [int ] = None ,
142105 observed_timestamp : Optional [int ] = None ,
143106 severity_number : Optional [SeverityNumber ] = None ,
@@ -146,7 +109,7 @@ def emit_event(
146109 body : Optional [Any ] = None ,
147110 attributes : Optional [Attributes ] = None ,
148111 ) -> None :
149- """Emits an event to the processing pipeline ."""
112+ """Emits a log record ."""
150113
151114
152115class NoOpLogger (Logger ):
@@ -158,20 +121,19 @@ class NoOpLogger(Logger):
158121 def is_enabled (
159122 self ,
160123 severity_number : Optional [SeverityNumber ] = None ,
161- context : Optional [Context ] = None
124+ context : Optional [Context ] = None ,
162125 ) -> bool :
163126 return False
164127
165- def emit (self , record : "LogRecord" ) -> None :
166- pass
167-
168- def emit_event (
128+ def emit (
169129 self ,
170- name : str ,
130+ name : str = None ,
171131 timestamp : Optional [int ] = None ,
132+ observed_timestamp : Optional [int ] = None ,
133+ severity_number : Optional [SeverityNumber ] = None ,
134+ severity_text : Optional [str ] = None ,
172135 context : Optional [Context ] = None ,
173136 body : Optional [Any ] = None ,
174- severity_number : Optional [SeverityNumber ] = None ,
175137 attributes : Optional [Attributes ] = None ,
176138 ) -> None :
177139 pass
@@ -210,24 +172,32 @@ def _logger(self) -> Logger:
210172 def is_enabled (
211173 self ,
212174 severity_number : Optional [SeverityNumber ] = None ,
213- context : Optional [Context ] = None
175+ context : Optional [Context ] = None ,
214176 ) -> bool :
215- return self ._logger .is_enabled (severity_number = severity_number , context = context )
216-
217- def emit (self , record : LogRecord ) -> None :
218- self ._logger .emit (record )
177+ return self ._logger .is_enabled (
178+ severity_number = severity_number , context = context
179+ )
219180
220- def emit_event (
181+ def emit (
221182 self ,
222- name : str ,
183+ name : str = None ,
223184 timestamp : Optional [int ] = None ,
185+ observed_timestamp : Optional [int ] = None ,
186+ severity_number : Optional [SeverityNumber ] = None ,
187+ severity_text : Optional [str ] = None ,
224188 context : Optional [Context ] = None ,
225189 body : Optional [Any ] = None ,
226- severity_number : Optional [SeverityNumber ] = None ,
227190 attributes : Optional [Attributes ] = None ,
228191 ) -> None :
229- self ._logger .emit_event (
230- name , timestamp , context , body , severity_number , attributes
192+ self ._logger .emit (
193+ name = name ,
194+ timestamp = timestamp ,
195+ observed_timestamp = observed_timestamp ,
196+ severity_number = severity_number ,
197+ severity_text = severity_text ,
198+ context = context ,
199+ body = body ,
200+ attributes = attributes ,
231201 )
232202
233203
0 commit comments