| 12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504 |
- /// Constructs a new span.
- ///
- /// See [the top-level documentation][lib] for details on the syntax accepted by
- /// this macro.
- ///
- /// [lib]: crate#using-the-macros
- ///
- /// # Examples
- ///
- /// Creating a new span:
- /// ```
- /// # use tracing::{span, Level};
- /// # fn main() {
- /// let span = span!(Level::TRACE, "my span");
- /// let _enter = span.enter();
- /// // do work inside the span...
- /// # }
- /// ```
- #[macro_export]
- macro_rules! span {
- (target: $target:expr, parent: $parent:expr, $lvl:expr, $name:expr) => {
- $crate::span!(target: $target, parent: $parent, $lvl, $name,)
- };
- (target: $target:expr, parent: $parent:expr, $lvl:expr, $name:expr, $($fields:tt)*) => {
- {
- use $crate::__macro_support::Callsite as _;
- static CALLSITE: $crate::callsite::DefaultCallsite = $crate::callsite2! {
- name: $name,
- kind: $crate::metadata::Kind::SPAN,
- target: $target,
- level: $lvl,
- fields: $($fields)*
- };
- let mut interest = $crate::subscriber::Interest::never();
- if $crate::level_enabled!($lvl)
- && { interest = CALLSITE.interest(); !interest.is_never() }
- && $crate::__macro_support::__is_enabled(CALLSITE.metadata(), interest)
- {
- let meta = CALLSITE.metadata();
- // span with explicit parent
- $crate::Span::child_of(
- $parent,
- meta,
- &$crate::valueset!(meta.fields(), $($fields)*),
- )
- } else {
- let span = $crate::__macro_support::__disabled_span(CALLSITE.metadata());
- $crate::if_log_enabled! { $lvl, {
- span.record_all(&$crate::valueset!(CALLSITE.metadata().fields(), $($fields)*));
- }};
- span
- }
- }
- };
- (target: $target:expr, $lvl:expr, $name:expr, $($fields:tt)*) => {
- {
- use $crate::__macro_support::Callsite as _;
- static CALLSITE: $crate::callsite::DefaultCallsite = $crate::callsite2! {
- name: $name,
- kind: $crate::metadata::Kind::SPAN,
- target: $target,
- level: $lvl,
- fields: $($fields)*
- };
- let mut interest = $crate::subscriber::Interest::never();
- if $crate::level_enabled!($lvl)
- && { interest = CALLSITE.interest(); !interest.is_never() }
- && $crate::__macro_support::__is_enabled(CALLSITE.metadata(), interest)
- {
- let meta = CALLSITE.metadata();
- // span with contextual parent
- $crate::Span::new(
- meta,
- &$crate::valueset!(meta.fields(), $($fields)*),
- )
- } else {
- let span = $crate::__macro_support::__disabled_span(CALLSITE.metadata());
- $crate::if_log_enabled! { $lvl, {
- span.record_all(&$crate::valueset!(CALLSITE.metadata().fields(), $($fields)*));
- }};
- span
- }
- }
- };
- (target: $target:expr, parent: $parent:expr, $lvl:expr, $name:expr) => {
- $crate::span!(target: $target, parent: $parent, $lvl, $name,)
- };
- (parent: $parent:expr, $lvl:expr, $name:expr, $($fields:tt)*) => {
- $crate::span!(
- target: module_path!(),
- parent: $parent,
- $lvl,
- $name,
- $($fields)*
- )
- };
- (parent: $parent:expr, $lvl:expr, $name:expr) => {
- $crate::span!(
- target: module_path!(),
- parent: $parent,
- $lvl,
- $name,
- )
- };
- (target: $target:expr, $lvl:expr, $name:expr, $($fields:tt)*) => {
- $crate::span!(
- target: $target,
- $lvl,
- $name,
- $($fields)*
- )
- };
- (target: $target:expr, $lvl:expr, $name:expr) => {
- $crate::span!(target: $target, $lvl, $name,)
- };
- ($lvl:expr, $name:expr, $($fields:tt)*) => {
- $crate::span!(
- target: module_path!(),
- $lvl,
- $name,
- $($fields)*
- )
- };
- ($lvl:expr, $name:expr) => {
- $crate::span!(
- target: module_path!(),
- $lvl,
- $name,
- )
- };
- }
- /// Constructs a span at the trace level.
- ///
- /// [Fields] and [attributes] are set using the same syntax as the [`span!`]
- /// macro.
- ///
- /// See [the top-level documentation][lib] for details on the syntax accepted by
- /// this macro.
- ///
- /// [lib]: crate#using-the-macros
- /// [attributes]: crate#configuring-attributes
- /// [Fields]: crate#recording-fields
- /// [`span!`]: crate::span!
- ///
- /// # Examples
- ///
- /// ```rust
- /// # use tracing::{trace_span, span, Level};
- /// # fn main() {
- /// trace_span!("my_span");
- /// // is equivalent to:
- /// span!(Level::TRACE, "my_span");
- /// # }
- /// ```
- ///
- /// ```rust
- /// # use tracing::{trace_span, span, Level};
- /// # fn main() {
- /// let span = trace_span!("my span");
- /// span.in_scope(|| {
- /// // do work inside the span...
- /// });
- /// # }
- /// ```
- #[macro_export]
- macro_rules! trace_span {
- (target: $target:expr, parent: $parent:expr, $name:expr, $($field:tt)*) => {
- $crate::span!(
- target: $target,
- parent: $parent,
- $crate::Level::TRACE,
- $name,
- $($field)*
- )
- };
- (target: $target:expr, parent: $parent:expr, $name:expr) => {
- $crate::trace_span!(target: $target, parent: $parent, $name,)
- };
- (parent: $parent:expr, $name:expr, $($field:tt)*) => {
- $crate::span!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::TRACE,
- $name,
- $($field)*
- )
- };
- (parent: $parent:expr, $name:expr) => {
- $crate::trace_span!(parent: $parent, $name,)
- };
- (target: $target:expr, $name:expr, $($field:tt)*) => {
- $crate::span!(
- target: $target,
- $crate::Level::TRACE,
- $name,
- $($field)*
- )
- };
- (target: $target:expr, $name:expr) => {
- $crate::trace_span!(target: $target, $name,)
- };
- ($name:expr, $($field:tt)*) => {
- $crate::span!(
- target: module_path!(),
- $crate::Level::TRACE,
- $name,
- $($field)*
- )
- };
- ($name:expr) => { $crate::trace_span!($name,) };
- }
- /// Constructs a span at the debug level.
- ///
- /// [Fields] and [attributes] are set using the same syntax as the [`span!`]
- /// macro.
- ///
- /// See [the top-level documentation][lib] for details on the syntax accepted by
- /// this macro.
- ///
- /// [lib]: crate#using-the-macros
- /// [attributes]: crate#configuring-attributes
- /// [Fields]: crate#recording-fields
- /// [`span!`]: crate::span!
- ///
- /// # Examples
- ///
- /// ```rust
- /// # use tracing::{debug_span, span, Level};
- /// # fn main() {
- /// debug_span!("my_span");
- /// // is equivalent to:
- /// span!(Level::DEBUG, "my_span");
- /// # }
- /// ```
- ///
- /// ```rust
- /// # use tracing::debug_span;
- /// # fn main() {
- /// let span = debug_span!("my span");
- /// span.in_scope(|| {
- /// // do work inside the span...
- /// });
- /// # }
- /// ```
- #[macro_export]
- macro_rules! debug_span {
- (target: $target:expr, parent: $parent:expr, $name:expr, $($field:tt)*) => {
- $crate::span!(
- target: $target,
- parent: $parent,
- $crate::Level::DEBUG,
- $name,
- $($field)*
- )
- };
- (target: $target:expr, parent: $parent:expr, $name:expr) => {
- $crate::debug_span!(target: $target, parent: $parent, $name,)
- };
- (parent: $parent:expr, $name:expr, $($field:tt)*) => {
- $crate::span!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::DEBUG,
- $name,
- $($field)*
- )
- };
- (parent: $parent:expr, $name:expr) => {
- $crate::debug_span!(parent: $parent, $name,)
- };
- (target: $target:expr, $name:expr, $($field:tt)*) => {
- $crate::span!(
- target: $target,
- $crate::Level::DEBUG,
- $name,
- $($field)*
- )
- };
- (target: $target:expr, $name:expr) => {
- $crate::debug_span!(target: $target, $name,)
- };
- ($name:expr, $($field:tt)*) => {
- $crate::span!(
- target: module_path!(),
- $crate::Level::DEBUG,
- $name,
- $($field)*
- )
- };
- ($name:expr) => {$crate::debug_span!($name,)};
- }
- /// Constructs a span at the info level.
- ///
- /// [Fields] and [attributes] are set using the same syntax as the [`span!`]
- /// macro.
- ///
- /// See [the top-level documentation][lib] for details on the syntax accepted by
- /// this macro.
- ///
- /// [lib]: crate#using-the-macros
- /// [attributes]: crate#configuring-attributes
- /// [Fields]: crate#recording-fields
- /// [`span!`]: crate::span!
- ///
- /// # Examples
- ///
- /// ```rust
- /// # use tracing::{span, info_span, Level};
- /// # fn main() {
- /// info_span!("my_span");
- /// // is equivalent to:
- /// span!(Level::INFO, "my_span");
- /// # }
- /// ```
- ///
- /// ```rust
- /// # use tracing::info_span;
- /// # fn main() {
- /// let span = info_span!("my span");
- /// span.in_scope(|| {
- /// // do work inside the span...
- /// });
- /// # }
- /// ```
- #[macro_export]
- macro_rules! info_span {
- (target: $target:expr, parent: $parent:expr, $name:expr, $($field:tt)*) => {
- $crate::span!(
- target: $target,
- parent: $parent,
- $crate::Level::INFO,
- $name,
- $($field)*
- )
- };
- (target: $target:expr, parent: $parent:expr, $name:expr) => {
- $crate::info_span!(target: $target, parent: $parent, $name,)
- };
- (parent: $parent:expr, $name:expr, $($field:tt)*) => {
- $crate::span!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::INFO,
- $name,
- $($field)*
- )
- };
- (parent: $parent:expr, $name:expr) => {
- $crate::info_span!(parent: $parent, $name,)
- };
- (target: $target:expr, $name:expr, $($field:tt)*) => {
- $crate::span!(
- target: $target,
- $crate::Level::INFO,
- $name,
- $($field)*
- )
- };
- (target: $target:expr, $name:expr) => {
- $crate::info_span!(target: $target, $name,)
- };
- ($name:expr, $($field:tt)*) => {
- $crate::span!(
- target: module_path!(),
- $crate::Level::INFO,
- $name,
- $($field)*
- )
- };
- ($name:expr) => {$crate::info_span!($name,)};
- }
- /// Constructs a span at the warn level.
- ///
- /// [Fields] and [attributes] are set using the same syntax as the [`span!`]
- /// macro.
- ///
- /// See [the top-level documentation][lib] for details on the syntax accepted by
- /// this macro.
- ///
- /// [lib]: crate#using-the-macros
- /// [attributes]: crate#configuring-attributes
- /// [Fields]: crate#recording-fields
- /// [`span!`]: crate::span!
- ///
- /// # Examples
- ///
- /// ```rust
- /// # use tracing::{warn_span, span, Level};
- /// # fn main() {
- /// warn_span!("my_span");
- /// // is equivalent to:
- /// span!(Level::WARN, "my_span");
- /// # }
- /// ```
- ///
- /// ```rust
- /// use tracing::warn_span;
- /// # fn main() {
- /// let span = warn_span!("my span");
- /// span.in_scope(|| {
- /// // do work inside the span...
- /// });
- /// # }
- /// ```
- #[macro_export]
- macro_rules! warn_span {
- (target: $target:expr, parent: $parent:expr, $name:expr, $($field:tt)*) => {
- $crate::span!(
- target: $target,
- parent: $parent,
- $crate::Level::WARN,
- $name,
- $($field)*
- )
- };
- (target: $target:expr, parent: $parent:expr, $name:expr) => {
- $crate::warn_span!(target: $target, parent: $parent, $name,)
- };
- (parent: $parent:expr, $name:expr, $($field:tt)*) => {
- $crate::span!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::WARN,
- $name,
- $($field)*
- )
- };
- (parent: $parent:expr, $name:expr) => {
- $crate::warn_span!(parent: $parent, $name,)
- };
- (target: $target:expr, $name:expr, $($field:tt)*) => {
- $crate::span!(
- target: $target,
- $crate::Level::WARN,
- $name,
- $($field)*
- )
- };
- (target: $target:expr, $name:expr) => {
- $crate::warn_span!(target: $target, $name,)
- };
- ($name:expr, $($field:tt)*) => {
- $crate::span!(
- target: module_path!(),
- $crate::Level::WARN,
- $name,
- $($field)*
- )
- };
- ($name:expr) => {$crate::warn_span!($name,)};
- }
- /// Constructs a span at the error level.
- ///
- /// [Fields] and [attributes] are set using the same syntax as the [`span!`]
- /// macro.
- ///
- /// See [the top-level documentation][lib] for details on the syntax accepted by
- /// this macro.
- ///
- /// [lib]: crate#using-the-macros
- /// [attributes]: crate#configuring-attributes
- /// [Fields]: crate#recording-fields
- /// [`span!`]: crate::span!
- ///
- /// # Examples
- ///
- /// ```rust
- /// # use tracing::{span, error_span, Level};
- /// # fn main() {
- /// error_span!("my_span");
- /// // is equivalent to:
- /// span!(Level::ERROR, "my_span");
- /// # }
- /// ```
- ///
- /// ```rust
- /// # use tracing::error_span;
- /// # fn main() {
- /// let span = error_span!("my span");
- /// span.in_scope(|| {
- /// // do work inside the span...
- /// });
- /// # }
- /// ```
- #[macro_export]
- macro_rules! error_span {
- (target: $target:expr, parent: $parent:expr, $name:expr, $($field:tt)*) => {
- $crate::span!(
- target: $target,
- parent: $parent,
- $crate::Level::ERROR,
- $name,
- $($field)*
- )
- };
- (target: $target:expr, parent: $parent:expr, $name:expr) => {
- $crate::error_span!(target: $target, parent: $parent, $name,)
- };
- (parent: $parent:expr, $name:expr, $($field:tt)*) => {
- $crate::span!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::ERROR,
- $name,
- $($field)*
- )
- };
- (parent: $parent:expr, $name:expr) => {
- $crate::error_span!(parent: $parent, $name,)
- };
- (target: $target:expr, $name:expr, $($field:tt)*) => {
- $crate::span!(
- target: $target,
- $crate::Level::ERROR,
- $name,
- $($field)*
- )
- };
- (target: $target:expr, $name:expr) => {
- $crate::error_span!(target: $target, $name,)
- };
- ($name:expr, $($field:tt)*) => {
- $crate::span!(
- target: module_path!(),
- $crate::Level::ERROR,
- $name,
- $($field)*
- )
- };
- ($name:expr) => {$crate::error_span!($name,)};
- }
- /// Constructs a new `Event`.
- ///
- /// The event macro is invoked with a `Level` and up to 32 key-value fields.
- /// Optionally, a format string and arguments may follow the fields; this will
- /// be used to construct an implicit field named "message".
- ///
- /// See [the top-level documentation][lib] for details on the syntax accepted by
- /// this macro.
- ///
- /// [lib]: crate#using-the-macros
- ///
- /// # Examples
- ///
- /// ```rust
- /// use tracing::{event, Level};
- ///
- /// # fn main() {
- /// let data = (42, "forty-two");
- /// let private_data = "private";
- /// let error = "a bad error";
- ///
- /// event!(Level::ERROR, %error, "Received error");
- /// event!(
- /// target: "app_events",
- /// Level::WARN,
- /// private_data,
- /// ?data,
- /// "App warning: {}",
- /// error
- /// );
- /// event!(Level::INFO, the_answer = data.0);
- /// # }
- /// ```
- ///
- // /// Note that *unlike `span!`*, `event!` requires a value for all fields. As
- // /// events are recorded immediately when the macro is invoked, there is no
- // /// opportunity for fields to be recorded later. A trailing comma on the final
- // /// field is valid.
- // ///
- // /// For example, the following does not compile:
- // /// ```rust,compile_fail
- // /// # use tracing::{Level, event};
- // /// # fn main() {
- // /// event!(Level::INFO, foo = 5, bad_field, bar = "hello")
- // /// #}
- // /// ```
- #[macro_export]
- macro_rules! event {
- (target: $target:expr, parent: $parent:expr, $lvl:expr, { $($fields:tt)* } )=> ({
- use $crate::__macro_support::Callsite as _;
- static CALLSITE: $crate::callsite::DefaultCallsite = $crate::callsite2! {
- name: $crate::__macro_support::concat!(
- "event ",
- file!(),
- ":",
- line!()
- ),
- kind: $crate::metadata::Kind::EVENT,
- target: $target,
- level: $lvl,
- fields: $($fields)*
- };
- let enabled = $crate::level_enabled!($lvl) && {
- let interest = CALLSITE.interest();
- !interest.is_never() && $crate::__macro_support::__is_enabled(CALLSITE.metadata(), interest)
- };
- if enabled {
- (|value_set: $crate::field::ValueSet| {
- $crate::__tracing_log!(
- $lvl,
- CALLSITE,
- &value_set
- );
- let meta = CALLSITE.metadata();
- // event with explicit parent
- $crate::Event::child_of(
- $parent,
- meta,
- &value_set
- );
- })($crate::valueset!(CALLSITE.metadata().fields(), $($fields)*));
- } else {
- $crate::__tracing_log!(
- $lvl,
- CALLSITE,
- &$crate::valueset!(CALLSITE.metadata().fields(), $($fields)*)
- );
- }
- });
- (target: $target:expr, parent: $parent:expr, $lvl:expr, { $($fields:tt)* }, $($arg:tt)+ ) => (
- $crate::event!(
- target: $target,
- parent: $parent,
- $lvl,
- { message = format_args!($($arg)+), $($fields)* }
- )
- );
- (target: $target:expr, parent: $parent:expr, $lvl:expr, $($k:ident).+ = $($fields:tt)* ) => (
- $crate::event!(target: $target, parent: $parent, $lvl, { $($k).+ = $($fields)* })
- );
- (target: $target:expr, parent: $parent:expr, $lvl:expr, $($arg:tt)+) => (
- $crate::event!(target: $target, parent: $parent, $lvl, { $($arg)+ })
- );
- (target: $target:expr, $lvl:expr, { $($fields:tt)* } )=> ({
- use $crate::__macro_support::Callsite as _;
- static CALLSITE: $crate::callsite::DefaultCallsite = $crate::callsite2! {
- name: $crate::__macro_support::concat!(
- "event ",
- file!(),
- ":",
- line!()
- ),
- kind: $crate::metadata::Kind::EVENT,
- target: $target,
- level: $lvl,
- fields: $($fields)*
- };
- let enabled = $crate::level_enabled!($lvl) && {
- let interest = CALLSITE.interest();
- !interest.is_never() && $crate::__macro_support::__is_enabled(CALLSITE.metadata(), interest)
- };
- if enabled {
- (|value_set: $crate::field::ValueSet| {
- let meta = CALLSITE.metadata();
- // event with contextual parent
- $crate::Event::dispatch(
- meta,
- &value_set
- );
- $crate::__tracing_log!(
- $lvl,
- CALLSITE,
- &value_set
- );
- })($crate::valueset!(CALLSITE.metadata().fields(), $($fields)*));
- } else {
- $crate::__tracing_log!(
- $lvl,
- CALLSITE,
- &$crate::valueset!(CALLSITE.metadata().fields(), $($fields)*)
- );
- }
- });
- (target: $target:expr, $lvl:expr, { $($fields:tt)* }, $($arg:tt)+ ) => (
- $crate::event!(
- target: $target,
- $lvl,
- { message = format_args!($($arg)+), $($fields)* }
- )
- );
- (target: $target:expr, $lvl:expr, $($k:ident).+ = $($fields:tt)* ) => (
- $crate::event!(target: $target, $lvl, { $($k).+ = $($fields)* })
- );
- (target: $target:expr, $lvl:expr, $($arg:tt)+ ) => (
- $crate::event!(target: $target, $lvl, { $($arg)+ })
- );
- (parent: $parent:expr, $lvl:expr, { $($fields:tt)* }, $($arg:tt)+ ) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $lvl,
- { message = format_args!($($arg)+), $($fields)* }
- )
- );
- (parent: $parent:expr, $lvl:expr, $($k:ident).+ = $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $lvl,
- { $($k).+ = $($field)*}
- )
- );
- (parent: $parent:expr, $lvl:expr, ?$($k:ident).+ = $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $lvl,
- { ?$($k).+ = $($field)*}
- )
- );
- (parent: $parent:expr, $lvl:expr, %$($k:ident).+ = $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $lvl,
- { %$($k).+ = $($field)*}
- )
- );
- (parent: $parent:expr, $lvl:expr, $($k:ident).+, $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $lvl,
- { $($k).+, $($field)*}
- )
- );
- (parent: $parent:expr, $lvl:expr, %$($k:ident).+, $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $lvl,
- { %$($k).+, $($field)*}
- )
- );
- (parent: $parent:expr, $lvl:expr, ?$($k:ident).+, $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $lvl,
- { ?$($k).+, $($field)*}
- )
- );
- (parent: $parent:expr, $lvl:expr, $($arg:tt)+ ) => (
- $crate::event!(target: module_path!(), parent: $parent, $lvl, { $($arg)+ })
- );
- ( $lvl:expr, { $($fields:tt)* }, $($arg:tt)+ ) => (
- $crate::event!(
- target: module_path!(),
- $lvl,
- { message = format_args!($($arg)+), $($fields)* }
- )
- );
- ( $lvl:expr, { $($fields:tt)* }, $($arg:tt)+ ) => (
- $crate::event!(
- target: module_path!(),
- $lvl,
- { message = format_args!($($arg)+), $($fields)* }
- )
- );
- ($lvl:expr, $($k:ident).+ = $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- $lvl,
- { $($k).+ = $($field)*}
- )
- );
- ($lvl:expr, $($k:ident).+, $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- $lvl,
- { $($k).+, $($field)*}
- )
- );
- ($lvl:expr, ?$($k:ident).+, $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- $lvl,
- { ?$($k).+, $($field)*}
- )
- );
- ($lvl:expr, %$($k:ident).+, $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- $lvl,
- { %$($k).+, $($field)*}
- )
- );
- ($lvl:expr, ?$($k:ident).+) => (
- $crate::event!($lvl, ?$($k).+,)
- );
- ($lvl:expr, %$($k:ident).+) => (
- $crate::event!($lvl, %$($k).+,)
- );
- ($lvl:expr, $($k:ident).+) => (
- $crate::event!($lvl, $($k).+,)
- );
- ( $lvl:expr, $($arg:tt)+ ) => (
- $crate::event!(target: module_path!(), $lvl, { $($arg)+ })
- );
- }
- /// Tests whether an event with the specified level and target would be enabled.
- ///
- /// This is similar to [`enabled!`], but queries the current subscriber specifically for
- /// an event, whereas [`enabled!`] queries for an event _or_ span.
- ///
- /// See the documentation for [`enabled!]` for more details on using this macro.
- /// See also [`span_enabled!`].
- ///
- /// # Examples
- ///
- /// ```rust
- /// # use tracing::{event_enabled, Level};
- /// if event_enabled!(target: "my_crate", Level::DEBUG) {
- /// // some expensive work...
- /// }
- /// // simpler
- /// if event_enabled!(Level::DEBUG) {
- /// // some expensive work...
- /// }
- /// // with fields
- /// if event_enabled!(Level::DEBUG, foo_field) {
- /// // some expensive work...
- /// }
- /// ```
- ///
- /// [`enabled!`]: crate::enabled
- /// [`span_enabled!`]: crate::span_enabled
- #[macro_export]
- macro_rules! event_enabled {
- ($($rest:tt)*)=> (
- $crate::enabled!(kind: $crate::metadata::Kind::EVENT, $($rest)*)
- )
- }
- /// Tests whether a span with the specified level and target would be enabled.
- ///
- /// This is similar to [`enabled!`], but queries the current subscriber specifically for
- /// an event, whereas [`enabled!`] queries for an event _or_ span.
- ///
- /// See the documentation for [`enabled!]` for more details on using this macro.
- /// See also [`span_enabled!`].
- ///
- /// # Examples
- ///
- /// ```rust
- /// # use tracing::{span_enabled, Level};
- /// if span_enabled!(target: "my_crate", Level::DEBUG) {
- /// // some expensive work...
- /// }
- /// // simpler
- /// if span_enabled!(Level::DEBUG) {
- /// // some expensive work...
- /// }
- /// // with fields
- /// if span_enabled!(Level::DEBUG, foo_field) {
- /// // some expensive work...
- /// }
- /// ```
- ///
- /// [`enabled!`]: crate::enabled
- /// [`span_enabled!`]: crate::span_enabled
- #[macro_export]
- macro_rules! span_enabled {
- ($($rest:tt)*)=> (
- $crate::enabled!(kind: $crate::metadata::Kind::SPAN, $($rest)*)
- )
- }
- /// Checks whether a span or event is [enabled] based on the provided [metadata].
- ///
- /// [enabled]: crate::Subscriber::enabled
- /// [metadata]: crate::Metadata
- ///
- /// This macro is a specialized tool: it is intended to be used prior
- /// to an expensive computation required *just* for that event, but
- /// *cannot* be done as part of an argument to that event, such as
- /// when multiple events are emitted (e.g., iterating over a collection
- /// and emitting an event for each item).
- ///
- /// # Usage
- ///
- /// [Subscribers] can make filtering decisions based all the data included in a
- /// span or event's [`Metadata`]. This means that it is possible for `enabled!`
- /// to return a _false positive_ (indicating that something would be enabled
- /// when it actually would not be) or a _false negative_ (indicating that
- /// something would be disabled when it would actually be enabled).
- ///
- /// [Subscribers]: crate::subscriber::Subscriber
- /// [`Metadata`]: crate::metadata::Metadata
- ///
- /// This occurs when a subscriber is using a _more specific_ filter than the
- /// metadata provided to the `enabled!` macro. Some situations that can result
- /// in false positives or false negatives include:
- ///
- /// - If a subscriber is using a filter which may enable a span or event based
- /// on field names, but `enabled!` is invoked without listing field names,
- /// `enabled!` may return a false negative if a specific field name would
- /// cause the subscriber to enable something that would otherwise be disabled.
- /// - If a subscriber is using a filter which enables or disables specific events by
- /// file path and line number, a particular event may be enabled/disabled
- /// even if an `enabled!` invocation with the same level, target, and fields
- /// indicated otherwise.
- /// - The subscriber can choose to enable _only_ spans or _only_ events, which `enabled`
- /// will not reflect.
- ///
- /// `enabled!()` requires a [level](crate::Level) argument, an optional `target:`
- /// argument, and an optional set of field names. If the fields are not provided,
- /// they are considered to be unknown. `enabled!` attempts to match the
- /// syntax of `event!()` as closely as possible, which can be seen in the
- /// examples below.
- ///
- /// # Examples
- ///
- /// If the current subscriber is interested in recording `DEBUG`-level spans and
- /// events in the current file and module path, this will evaluate to true:
- /// ```rust
- /// use tracing::{enabled, Level};
- ///
- /// if enabled!(Level::DEBUG) {
- /// // some expensive work...
- /// }
- /// ```
- ///
- /// If the current subscriber is interested in recording spans and events
- /// in the current file and module path, with the target "my_crate", and at the
- /// level `DEBUG`, this will evaluate to true:
- /// ```rust
- /// # use tracing::{enabled, Level};
- /// if enabled!(target: "my_crate", Level::DEBUG) {
- /// // some expensive work...
- /// }
- /// ```
- ///
- /// If the current subscriber is interested in recording spans and events
- /// in the current file and module path, with the target "my_crate", at
- /// the level `DEBUG`, and with a field named "hello", this will evaluate
- /// to true:
- ///
- /// ```rust
- /// # use tracing::{enabled, Level};
- /// if enabled!(target: "my_crate", Level::DEBUG, hello) {
- /// // some expensive work...
- /// }
- /// ```
- ///
- /// # Alternatives
- ///
- /// `enabled!` queries subscribers with [`Metadata`] where
- /// [`is_event`] and [`is_span`] both return `false`. Alternatively,
- /// use [`event_enabled!`] or [`span_enabled!`] to ensure one of these
- /// returns true.
- ///
- ///
- /// [`Metadata`]: crate::Metadata
- /// [`is_event`]: crate::Metadata::is_event
- /// [`is_span`]: crate::Metadata::is_span
- /// [`enabled!`]: crate::enabled
- /// [`span_enabled!`]: crate::span_enabled
- #[macro_export]
- macro_rules! enabled {
- (kind: $kind:expr, target: $target:expr, $lvl:expr, { $($fields:tt)* } )=> ({
- if $crate::level_enabled!($lvl) {
- use $crate::__macro_support::Callsite as _;
- static CALLSITE: $crate::callsite::DefaultCallsite = $crate::callsite2! {
- name: $crate::__macro_support::concat!(
- "enabled ",
- file!(),
- ":",
- line!()
- ),
- kind: $kind.hint(),
- target: $target,
- level: $lvl,
- fields: $($fields)*
- };
- let interest = CALLSITE.interest();
- if !interest.is_never() && $crate::__macro_support::__is_enabled(CALLSITE.metadata(), interest) {
- let meta = CALLSITE.metadata();
- $crate::dispatcher::get_default(|current| current.enabled(meta))
- } else {
- false
- }
- } else {
- false
- }
- });
- // Just target and level
- (kind: $kind:expr, target: $target:expr, $lvl:expr ) => (
- $crate::enabled!(kind: $kind, target: $target, $lvl, { })
- );
- (target: $target:expr, $lvl:expr ) => (
- $crate::enabled!(kind: $crate::metadata::Kind::HINT, target: $target, $lvl, { })
- );
- // These four cases handle fields with no values
- (kind: $kind:expr, target: $target:expr, $lvl:expr, $($field:tt)*) => (
- $crate::enabled!(
- kind: $kind,
- target: $target,
- $lvl,
- { $($field)*}
- )
- );
- (target: $target:expr, $lvl:expr, $($field:tt)*) => (
- $crate::enabled!(
- kind: $crate::metadata::Kind::HINT,
- target: $target,
- $lvl,
- { $($field)*}
- )
- );
- // Level and field case
- (kind: $kind:expr, $lvl:expr, $($field:tt)*) => (
- $crate::enabled!(
- kind: $kind,
- target: module_path!(),
- $lvl,
- { $($field)*}
- )
- );
- // Simplest `enabled!` case
- (kind: $kind:expr, $lvl:expr) => (
- $crate::enabled!(kind: $kind, target: module_path!(), $lvl, { })
- );
- ($lvl:expr) => (
- $crate::enabled!(kind: $crate::metadata::Kind::HINT, target: module_path!(), $lvl, { })
- );
- // Fallthrough from above
- ($lvl:expr, $($field:tt)*) => (
- $crate::enabled!(
- kind: $crate::metadata::Kind::HINT,
- target: module_path!(),
- $lvl,
- { $($field)*}
- )
- );
- }
- /// Constructs an event at the trace level.
- ///
- /// This functions similarly to the [`event!`] macro. See [the top-level
- /// documentation][lib] for details on the syntax accepted by
- /// this macro.
- ///
- /// [`event!`]: crate::event!
- /// [lib]: crate#using-the-macros
- ///
- /// # Examples
- ///
- /// ```rust
- /// use tracing::trace;
- /// # #[derive(Debug, Copy, Clone)] struct Position { x: f32, y: f32 }
- /// # impl Position {
- /// # const ORIGIN: Self = Self { x: 0.0, y: 0.0 };
- /// # fn dist(&self, other: Position) -> f32 {
- /// # let x = (other.x - self.x).exp2(); let y = (self.y - other.y).exp2();
- /// # (x + y).sqrt()
- /// # }
- /// # }
- /// # fn main() {
- /// let pos = Position { x: 3.234, y: -1.223 };
- /// let origin_dist = pos.dist(Position::ORIGIN);
- ///
- /// trace!(position = ?pos, ?origin_dist);
- /// trace!(
- /// target: "app_events",
- /// position = ?pos,
- /// "x is {} and y is {}",
- /// if pos.x >= 0.0 { "positive" } else { "negative" },
- /// if pos.y >= 0.0 { "positive" } else { "negative" }
- /// );
- /// # }
- /// ```
- #[macro_export]
- macro_rules! trace {
- (target: $target:expr, parent: $parent:expr, { $($field:tt)* }, $($arg:tt)* ) => (
- $crate::event!(target: $target, parent: $parent, $crate::Level::TRACE, { $($field)* }, $($arg)*)
- );
- (target: $target:expr, parent: $parent:expr, $($k:ident).+ $($field:tt)+ ) => (
- $crate::event!(target: $target, parent: $parent, $crate::Level::TRACE, { $($k).+ $($field)+ })
- );
- (target: $target:expr, parent: $parent:expr, ?$($k:ident).+ $($field:tt)+ ) => (
- $crate::event!(target: $target, parent: $parent, $crate::Level::TRACE, { $($k).+ $($field)+ })
- );
- (target: $target:expr, parent: $parent:expr, %$($k:ident).+ $($field:tt)+ ) => (
- $crate::event!(target: $target, parent: $parent, $crate::Level::TRACE, { $($k).+ $($field)+ })
- );
- (target: $target:expr, parent: $parent:expr, $($arg:tt)+ ) => (
- $crate::event!(target: $target, parent: $parent, $crate::Level::TRACE, {}, $($arg)+)
- );
- (parent: $parent:expr, { $($field:tt)+ }, $($arg:tt)+ ) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::TRACE,
- { $($field)+ },
- $($arg)+
- )
- );
- (parent: $parent:expr, $($k:ident).+ = $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::TRACE,
- { $($k).+ = $($field)*}
- )
- );
- (parent: $parent:expr, ?$($k:ident).+ = $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::TRACE,
- { ?$($k).+ = $($field)*}
- )
- );
- (parent: $parent:expr, %$($k:ident).+ = $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::TRACE,
- { %$($k).+ = $($field)*}
- )
- );
- (parent: $parent:expr, $($k:ident).+, $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::TRACE,
- { $($k).+, $($field)*}
- )
- );
- (parent: $parent:expr, ?$($k:ident).+, $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::TRACE,
- { ?$($k).+, $($field)*}
- )
- );
- (parent: $parent:expr, %$($k:ident).+, $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::TRACE,
- { %$($k).+, $($field)*}
- )
- );
- (parent: $parent:expr, $($arg:tt)+) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::TRACE,
- {},
- $($arg)+
- )
- );
- (target: $target:expr, { $($field:tt)* }, $($arg:tt)* ) => (
- $crate::event!(target: $target, $crate::Level::TRACE, { $($field)* }, $($arg)*)
- );
- (target: $target:expr, $($k:ident).+ $($field:tt)* ) => (
- $crate::event!(target: $target, $crate::Level::TRACE, { $($k).+ $($field)* })
- );
- (target: $target:expr, ?$($k:ident).+ $($field:tt)* ) => (
- $crate::event!(target: $target, $crate::Level::TRACE, { ?$($k).+ $($field)* })
- );
- (target: $target:expr, %$($k:ident).+ $($field:tt)* ) => (
- $crate::event!(target: $target, $crate::Level::TRACE, { %$($k).+ $($field)* })
- );
- (target: $target:expr, $($arg:tt)+ ) => (
- $crate::event!(target: $target, $crate::Level::TRACE, {}, $($arg)+)
- );
- ({ $($field:tt)+ }, $($arg:tt)+ ) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::TRACE,
- { $($field)+ },
- $($arg)+
- )
- );
- ($($k:ident).+ = $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::TRACE,
- { $($k).+ = $($field)*}
- )
- );
- ($($k:ident).+, $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::TRACE,
- { $($k).+, $($field)*}
- )
- );
- (?$($k:ident).+, $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::TRACE,
- { ?$($k).+, $($field)*}
- )
- );
- (%$($k:ident).+, $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::TRACE,
- { %$($k).+, $($field)*}
- )
- );
- (?$($k:ident).+) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::TRACE,
- { ?$($k).+ }
- )
- );
- (%$($k:ident).+) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::TRACE,
- { %$($k).+ }
- )
- );
- ($($k:ident).+) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::TRACE,
- { $($k).+ }
- )
- );
- ($($arg:tt)+) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::TRACE,
- {},
- $($arg)+
- )
- );
- }
- /// Constructs an event at the debug level.
- ///
- /// This functions similarly to the [`event!`] macro. See [the top-level
- /// documentation][lib] for details on the syntax accepted by
- /// this macro.
- ///
- /// [`event!`]: crate::event!
- /// [lib]: crate#using-the-macros
- ///
- /// # Examples
- ///
- /// ```rust
- /// use tracing::debug;
- /// # fn main() {
- /// # #[derive(Debug)] struct Position { x: f32, y: f32 }
- ///
- /// let pos = Position { x: 3.234, y: -1.223 };
- ///
- /// debug!(?pos.x, ?pos.y);
- /// debug!(target: "app_events", position = ?pos, "New position");
- /// # }
- /// ```
- #[macro_export]
- macro_rules! debug {
- (target: $target:expr, parent: $parent:expr, { $($field:tt)* }, $($arg:tt)* ) => (
- $crate::event!(target: $target, parent: $parent, $crate::Level::DEBUG, { $($field)* }, $($arg)*)
- );
- (target: $target:expr, parent: $parent:expr, $($k:ident).+ $($field:tt)+ ) => (
- $crate::event!(target: $target, parent: $parent, $crate::Level::DEBUG, { $($k).+ $($field)+ })
- );
- (target: $target:expr, parent: $parent:expr, ?$($k:ident).+ $($field:tt)+ ) => (
- $crate::event!(target: $target, parent: $parent, $crate::Level::DEBUG, { $($k).+ $($field)+ })
- );
- (target: $target:expr, parent: $parent:expr, %$($k:ident).+ $($field:tt)+ ) => (
- $crate::event!(target: $target, parent: $parent, $crate::Level::DEBUG, { $($k).+ $($field)+ })
- );
- (target: $target:expr, parent: $parent:expr, $($arg:tt)+ ) => (
- $crate::event!(target: $target, parent: $parent, $crate::Level::DEBUG, {}, $($arg)+)
- );
- (parent: $parent:expr, { $($field:tt)+ }, $($arg:tt)+ ) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::DEBUG,
- { $($field)+ },
- $($arg)+
- )
- );
- (parent: $parent:expr, $($k:ident).+ = $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::DEBUG,
- { $($k).+ = $($field)*}
- )
- );
- (parent: $parent:expr, ?$($k:ident).+ = $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::DEBUG,
- { ?$($k).+ = $($field)*}
- )
- );
- (parent: $parent:expr, %$($k:ident).+ = $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::DEBUG,
- { %$($k).+ = $($field)*}
- )
- );
- (parent: $parent:expr, $($k:ident).+, $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::DEBUG,
- { $($k).+, $($field)*}
- )
- );
- (parent: $parent:expr, ?$($k:ident).+, $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::DEBUG,
- { ?$($k).+, $($field)*}
- )
- );
- (parent: $parent:expr, %$($k:ident).+, $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::DEBUG,
- { %$($k).+, $($field)*}
- )
- );
- (parent: $parent:expr, $($arg:tt)+) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::DEBUG,
- {},
- $($arg)+
- )
- );
- (target: $target:expr, { $($field:tt)* }, $($arg:tt)* ) => (
- $crate::event!(target: $target, $crate::Level::DEBUG, { $($field)* }, $($arg)*)
- );
- (target: $target:expr, $($k:ident).+ $($field:tt)* ) => (
- $crate::event!(target: $target, $crate::Level::DEBUG, { $($k).+ $($field)* })
- );
- (target: $target:expr, ?$($k:ident).+ $($field:tt)* ) => (
- $crate::event!(target: $target, $crate::Level::DEBUG, { ?$($k).+ $($field)* })
- );
- (target: $target:expr, %$($k:ident).+ $($field:tt)* ) => (
- $crate::event!(target: $target, $crate::Level::DEBUG, { %$($k).+ $($field)* })
- );
- (target: $target:expr, $($arg:tt)+ ) => (
- $crate::event!(target: $target, $crate::Level::DEBUG, {}, $($arg)+)
- );
- ({ $($field:tt)+ }, $($arg:tt)+ ) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::DEBUG,
- { $($field)+ },
- $($arg)+
- )
- );
- ($($k:ident).+ = $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::DEBUG,
- { $($k).+ = $($field)*}
- )
- );
- (?$($k:ident).+ = $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::DEBUG,
- { ?$($k).+ = $($field)*}
- )
- );
- (%$($k:ident).+ = $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::DEBUG,
- { %$($k).+ = $($field)*}
- )
- );
- ($($k:ident).+, $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::DEBUG,
- { $($k).+, $($field)*}
- )
- );
- (?$($k:ident).+, $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::DEBUG,
- { ?$($k).+, $($field)*}
- )
- );
- (%$($k:ident).+, $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::DEBUG,
- { %$($k).+, $($field)*}
- )
- );
- (?$($k:ident).+) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::DEBUG,
- { ?$($k).+ }
- )
- );
- (%$($k:ident).+) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::DEBUG,
- { %$($k).+ }
- )
- );
- ($($k:ident).+) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::DEBUG,
- { $($k).+ }
- )
- );
- ($($arg:tt)+) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::DEBUG,
- {},
- $($arg)+
- )
- );
- }
- /// Constructs an event at the info level.
- ///
- /// This functions similarly to the [`event!`] macro. See [the top-level
- /// documentation][lib] for details on the syntax accepted by
- /// this macro.
- ///
- /// [`event!`]: crate::event!
- /// [lib]: crate#using-the-macros
- ///
- /// # Examples
- ///
- /// ```rust
- /// use tracing::info;
- /// # // this is so the test will still work in no-std mode
- /// # #[derive(Debug)]
- /// # pub struct Ipv4Addr;
- /// # impl Ipv4Addr { fn new(o1: u8, o2: u8, o3: u8, o4: u8) -> Self { Self } }
- /// # fn main() {
- /// # struct Connection { port: u32, speed: f32 }
- /// use tracing::field;
- ///
- /// let addr = Ipv4Addr::new(127, 0, 0, 1);
- /// let conn = Connection { port: 40, speed: 3.20 };
- ///
- /// info!(conn.port, "connected to {:?}", addr);
- /// info!(
- /// target: "connection_events",
- /// ip = ?addr,
- /// conn.port,
- /// ?conn.speed,
- /// );
- /// # }
- /// ```
- #[macro_export]
- macro_rules! info {
- (target: $target:expr, parent: $parent:expr, { $($field:tt)* }, $($arg:tt)* ) => (
- $crate::event!(target: $target, parent: $parent, $crate::Level::INFO, { $($field)* }, $($arg)*)
- );
- (target: $target:expr, parent: $parent:expr, $($k:ident).+ $($field:tt)+ ) => (
- $crate::event!(target: $target, parent: $parent, $crate::Level::INFO, { $($k).+ $($field)+ })
- );
- (target: $target:expr, parent: $parent:expr, ?$($k:ident).+ $($field:tt)+ ) => (
- $crate::event!(target: $target, parent: $parent, $crate::Level::INFO, { $($k).+ $($field)+ })
- );
- (target: $target:expr, parent: $parent:expr, %$($k:ident).+ $($field:tt)+ ) => (
- $crate::event!(target: $target, parent: $parent, $crate::Level::INFO, { $($k).+ $($field)+ })
- );
- (target: $target:expr, parent: $parent:expr, $($arg:tt)+ ) => (
- $crate::event!(target: $target, parent: $parent, $crate::Level::INFO, {}, $($arg)+)
- );
- (parent: $parent:expr, { $($field:tt)+ }, $($arg:tt)+ ) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::INFO,
- { $($field)+ },
- $($arg)+
- )
- );
- (parent: $parent:expr, $($k:ident).+ = $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::INFO,
- { $($k).+ = $($field)*}
- )
- );
- (parent: $parent:expr, ?$($k:ident).+ = $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::INFO,
- { ?$($k).+ = $($field)*}
- )
- );
- (parent: $parent:expr, %$($k:ident).+ = $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::INFO,
- { %$($k).+ = $($field)*}
- )
- );
- (parent: $parent:expr, $($k:ident).+, $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::INFO,
- { $($k).+, $($field)*}
- )
- );
- (parent: $parent:expr, ?$($k:ident).+, $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::INFO,
- { ?$($k).+, $($field)*}
- )
- );
- (parent: $parent:expr, %$($k:ident).+, $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::INFO,
- { %$($k).+, $($field)*}
- )
- );
- (parent: $parent:expr, $($arg:tt)+) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::INFO,
- {},
- $($arg)+
- )
- );
- (target: $target:expr, { $($field:tt)* }, $($arg:tt)* ) => (
- $crate::event!(target: $target, $crate::Level::INFO, { $($field)* }, $($arg)*)
- );
- (target: $target:expr, $($k:ident).+ $($field:tt)* ) => (
- $crate::event!(target: $target, $crate::Level::INFO, { $($k).+ $($field)* })
- );
- (target: $target:expr, ?$($k:ident).+ $($field:tt)* ) => (
- $crate::event!(target: $target, $crate::Level::INFO, { ?$($k).+ $($field)* })
- );
- (target: $target:expr, %$($k:ident).+ $($field:tt)* ) => (
- $crate::event!(target: $target, $crate::Level::INFO, { $($k).+ $($field)* })
- );
- (target: $target:expr, $($arg:tt)+ ) => (
- $crate::event!(target: $target, $crate::Level::INFO, {}, $($arg)+)
- );
- ({ $($field:tt)+ }, $($arg:tt)+ ) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::INFO,
- { $($field)+ },
- $($arg)+
- )
- );
- ($($k:ident).+ = $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::INFO,
- { $($k).+ = $($field)*}
- )
- );
- (?$($k:ident).+ = $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::INFO,
- { ?$($k).+ = $($field)*}
- )
- );
- (%$($k:ident).+ = $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::INFO,
- { %$($k).+ = $($field)*}
- )
- );
- ($($k:ident).+, $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::INFO,
- { $($k).+, $($field)*}
- )
- );
- (?$($k:ident).+, $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::INFO,
- { ?$($k).+, $($field)*}
- )
- );
- (%$($k:ident).+, $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::INFO,
- { %$($k).+, $($field)*}
- )
- );
- (?$($k:ident).+) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::INFO,
- { ?$($k).+ }
- )
- );
- (%$($k:ident).+) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::INFO,
- { %$($k).+ }
- )
- );
- ($($k:ident).+) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::INFO,
- { $($k).+ }
- )
- );
- ($($arg:tt)+) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::INFO,
- {},
- $($arg)+
- )
- );
- }
- /// Constructs an event at the warn level.
- ///
- /// This functions similarly to the [`event!`] macro. See [the top-level
- /// documentation][lib] for details on the syntax accepted by
- /// this macro.
- ///
- /// [`event!`]: crate::event!
- /// [lib]: crate#using-the-macros
- ///
- /// # Examples
- ///
- /// ```rust
- /// use tracing::warn;
- /// # fn main() {
- ///
- /// let warn_description = "Invalid Input";
- /// let input = &[0x27, 0x45];
- ///
- /// warn!(?input, warning = warn_description);
- /// warn!(
- /// target: "input_events",
- /// warning = warn_description,
- /// "Received warning for input: {:?}", input,
- /// );
- /// # }
- /// ```
- #[macro_export]
- macro_rules! warn {
- (target: $target:expr, parent: $parent:expr, { $($field:tt)* }, $($arg:tt)* ) => (
- $crate::event!(target: $target, parent: $parent, $crate::Level::WARN, { $($field)* }, $($arg)*)
- );
- (target: $target:expr, parent: $parent:expr, $($k:ident).+ $($field:tt)+ ) => (
- $crate::event!(target: $target, parent: $parent, $crate::Level::WARN, { $($k).+ $($field)+ })
- );
- (target: $target:expr, parent: $parent:expr, ?$($k:ident).+ $($field:tt)+ ) => (
- $crate::event!(target: $target, parent: $parent, $crate::Level::WARN, { $($k).+ $($field)+ })
- );
- (target: $target:expr, parent: $parent:expr, %$($k:ident).+ $($field:tt)+ ) => (
- $crate::event!(target: $target, parent: $parent, $crate::Level::WARN, { $($k).+ $($field)+ })
- );
- (target: $target:expr, parent: $parent:expr, $($arg:tt)+ ) => (
- $crate::event!(target: $target, parent: $parent, $crate::Level::WARN, {}, $($arg)+)
- );
- (parent: $parent:expr, { $($field:tt)+ }, $($arg:tt)+ ) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::WARN,
- { $($field)+ },
- $($arg)+
- )
- );
- (parent: $parent:expr, $($k:ident).+ = $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::WARN,
- { $($k).+ = $($field)*}
- )
- );
- (parent: $parent:expr, ?$($k:ident).+ = $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::WARN,
- { ?$($k).+ = $($field)*}
- )
- );
- (parent: $parent:expr, %$($k:ident).+ = $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::WARN,
- { %$($k).+ = $($field)*}
- )
- );
- (parent: $parent:expr, $($k:ident).+, $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::WARN,
- { $($k).+, $($field)*}
- )
- );
- (parent: $parent:expr, ?$($k:ident).+, $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::WARN,
- { ?$($k).+, $($field)*}
- )
- );
- (parent: $parent:expr, %$($k:ident).+, $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::WARN,
- { %$($k).+, $($field)*}
- )
- );
- (parent: $parent:expr, $($arg:tt)+) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::WARN,
- {},
- $($arg)+
- )
- );
- (target: $target:expr, { $($field:tt)* }, $($arg:tt)* ) => (
- $crate::event!(target: $target, $crate::Level::WARN, { $($field)* }, $($arg)*)
- );
- (target: $target:expr, $($k:ident).+ $($field:tt)* ) => (
- $crate::event!(target: $target, $crate::Level::WARN, { $($k).+ $($field)* })
- );
- (target: $target:expr, ?$($k:ident).+ $($field:tt)* ) => (
- $crate::event!(target: $target, $crate::Level::WARN, { ?$($k).+ $($field)* })
- );
- (target: $target:expr, %$($k:ident).+ $($field:tt)* ) => (
- $crate::event!(target: $target, $crate::Level::WARN, { %$($k).+ $($field)* })
- );
- (target: $target:expr, $($arg:tt)+ ) => (
- $crate::event!(target: $target, $crate::Level::WARN, {}, $($arg)+)
- );
- ({ $($field:tt)+ }, $($arg:tt)+ ) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::WARN,
- { $($field)+ },
- $($arg)+
- )
- );
- ($($k:ident).+ = $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::WARN,
- { $($k).+ = $($field)*}
- )
- );
- (?$($k:ident).+ = $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::WARN,
- { ?$($k).+ = $($field)*}
- )
- );
- (%$($k:ident).+ = $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::WARN,
- { %$($k).+ = $($field)*}
- )
- );
- ($($k:ident).+, $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::WARN,
- { $($k).+, $($field)*}
- )
- );
- (?$($k:ident).+, $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::WARN,
- { ?$($k).+, $($field)*}
- )
- );
- (%$($k:ident).+, $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::WARN,
- { %$($k).+, $($field)*}
- )
- );
- (?$($k:ident).+) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::WARN,
- { ?$($k).+ }
- )
- );
- (%$($k:ident).+) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::WARN,
- { %$($k).+ }
- )
- );
- ($($k:ident).+) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::WARN,
- { $($k).+ }
- )
- );
- ($($arg:tt)+) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::WARN,
- {},
- $($arg)+
- )
- );
- }
- /// Constructs an event at the error level.
- ///
- /// This functions similarly to the [`event!`] macro. See [the top-level
- /// documentation][lib] for details on the syntax accepted by
- /// this macro.
- ///
- /// [`event!`]: crate::event!
- /// [lib]: crate#using-the-macros
- ///
- /// # Examples
- ///
- /// ```rust
- /// use tracing::error;
- /// # fn main() {
- ///
- /// let (err_info, port) = ("No connection", 22);
- ///
- /// error!(port, error = %err_info);
- /// error!(target: "app_events", "App Error: {}", err_info);
- /// error!({ info = err_info }, "error on port: {}", port);
- /// # }
- /// ```
- #[macro_export]
- macro_rules! error {
- (target: $target:expr, parent: $parent:expr, { $($field:tt)* }, $($arg:tt)* ) => (
- $crate::event!(target: $target, parent: $parent, $crate::Level::ERROR, { $($field)* }, $($arg)*)
- );
- (target: $target:expr, parent: $parent:expr, $($k:ident).+ $($field:tt)+ ) => (
- $crate::event!(target: $target, parent: $parent, $crate::Level::ERROR, { $($k).+ $($field)+ })
- );
- (target: $target:expr, parent: $parent:expr, ?$($k:ident).+ $($field:tt)+ ) => (
- $crate::event!(target: $target, parent: $parent, $crate::Level::ERROR, { $($k).+ $($field)+ })
- );
- (target: $target:expr, parent: $parent:expr, %$($k:ident).+ $($field:tt)+ ) => (
- $crate::event!(target: $target, parent: $parent, $crate::Level::ERROR, { $($k).+ $($field)+ })
- );
- (target: $target:expr, parent: $parent:expr, $($arg:tt)+ ) => (
- $crate::event!(target: $target, parent: $parent, $crate::Level::ERROR, {}, $($arg)+)
- );
- (parent: $parent:expr, { $($field:tt)+ }, $($arg:tt)+ ) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::ERROR,
- { $($field)+ },
- $($arg)+
- )
- );
- (parent: $parent:expr, $($k:ident).+ = $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::ERROR,
- { $($k).+ = $($field)*}
- )
- );
- (parent: $parent:expr, ?$($k:ident).+ = $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::ERROR,
- { ?$($k).+ = $($field)*}
- )
- );
- (parent: $parent:expr, %$($k:ident).+ = $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::ERROR,
- { %$($k).+ = $($field)*}
- )
- );
- (parent: $parent:expr, $($k:ident).+, $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::ERROR,
- { $($k).+, $($field)*}
- )
- );
- (parent: $parent:expr, ?$($k:ident).+, $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::ERROR,
- { ?$($k).+, $($field)*}
- )
- );
- (parent: $parent:expr, %$($k:ident).+, $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::ERROR,
- { %$($k).+, $($field)*}
- )
- );
- (parent: $parent:expr, $($arg:tt)+) => (
- $crate::event!(
- target: module_path!(),
- parent: $parent,
- $crate::Level::ERROR,
- {},
- $($arg)+
- )
- );
- (target: $target:expr, { $($field:tt)* }, $($arg:tt)* ) => (
- $crate::event!(target: $target, $crate::Level::ERROR, { $($field)* }, $($arg)*)
- );
- (target: $target:expr, $($k:ident).+ $($field:tt)* ) => (
- $crate::event!(target: $target, $crate::Level::ERROR, { $($k).+ $($field)* })
- );
- (target: $target:expr, ?$($k:ident).+ $($field:tt)* ) => (
- $crate::event!(target: $target, $crate::Level::ERROR, { ?$($k).+ $($field)* })
- );
- (target: $target:expr, %$($k:ident).+ $($field:tt)* ) => (
- $crate::event!(target: $target, $crate::Level::ERROR, { %$($k).+ $($field)* })
- );
- (target: $target:expr, $($arg:tt)+ ) => (
- $crate::event!(target: $target, $crate::Level::ERROR, {}, $($arg)+)
- );
- ({ $($field:tt)+ }, $($arg:tt)+ ) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::ERROR,
- { $($field)+ },
- $($arg)+
- )
- );
- ($($k:ident).+ = $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::ERROR,
- { $($k).+ = $($field)*}
- )
- );
- (?$($k:ident).+ = $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::ERROR,
- { ?$($k).+ = $($field)*}
- )
- );
- (%$($k:ident).+ = $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::ERROR,
- { %$($k).+ = $($field)*}
- )
- );
- ($($k:ident).+, $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::ERROR,
- { $($k).+, $($field)*}
- )
- );
- (?$($k:ident).+, $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::ERROR,
- { ?$($k).+, $($field)*}
- )
- );
- (%$($k:ident).+, $($field:tt)*) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::ERROR,
- { %$($k).+, $($field)*}
- )
- );
- (?$($k:ident).+) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::ERROR,
- { ?$($k).+ }
- )
- );
- (%$($k:ident).+) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::ERROR,
- { %$($k).+ }
- )
- );
- ($($k:ident).+) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::ERROR,
- { $($k).+ }
- )
- );
- ($($arg:tt)+) => (
- $crate::event!(
- target: module_path!(),
- $crate::Level::ERROR,
- {},
- $($arg)+
- )
- );
- }
- /// Constructs a new static callsite for a span or event.
- #[doc(hidden)]
- #[macro_export]
- macro_rules! callsite {
- (name: $name:expr, kind: $kind:expr, fields: $($fields:tt)*) => {{
- $crate::callsite! {
- name: $name,
- kind: $kind,
- target: module_path!(),
- level: $crate::Level::TRACE,
- fields: $($fields)*
- }
- }};
- (
- name: $name:expr,
- kind: $kind:expr,
- level: $lvl:expr,
- fields: $($fields:tt)*
- ) => {{
- $crate::callsite! {
- name: $name,
- kind: $kind,
- target: module_path!(),
- level: $lvl,
- fields: $($fields)*
- }
- }};
- (
- name: $name:expr,
- kind: $kind:expr,
- target: $target:expr,
- level: $lvl:expr,
- fields: $($fields:tt)*
- ) => {{
- static META: $crate::Metadata<'static> = {
- $crate::metadata! {
- name: $name,
- target: $target,
- level: $lvl,
- fields: $crate::fieldset!( $($fields)* ),
- callsite: &CALLSITE,
- kind: $kind,
- }
- };
- static CALLSITE: $crate::callsite::DefaultCallsite = $crate::callsite::DefaultCallsite::new(&META);
- CALLSITE.register();
- &CALLSITE
- }};
- }
- /// Constructs a new static callsite for a span or event.
- #[doc(hidden)]
- #[macro_export]
- macro_rules! callsite2 {
- (name: $name:expr, kind: $kind:expr, fields: $($fields:tt)*) => {{
- $crate::callsite2! {
- name: $name,
- kind: $kind,
- target: module_path!(),
- level: $crate::Level::TRACE,
- fields: $($fields)*
- }
- }};
- (
- name: $name:expr,
- kind: $kind:expr,
- level: $lvl:expr,
- fields: $($fields:tt)*
- ) => {{
- $crate::callsite2! {
- name: $name,
- kind: $kind,
- target: module_path!(),
- level: $lvl,
- fields: $($fields)*
- }
- }};
- (
- name: $name:expr,
- kind: $kind:expr,
- target: $target:expr,
- level: $lvl:expr,
- fields: $($fields:tt)*
- ) => {{
- static META: $crate::Metadata<'static> = {
- $crate::metadata! {
- name: $name,
- target: $target,
- level: $lvl,
- fields: $crate::fieldset!( $($fields)* ),
- callsite: &CALLSITE,
- kind: $kind,
- }
- };
- $crate::callsite::DefaultCallsite::new(&META)
- }};
- }
- #[macro_export]
- // TODO: determine if this ought to be public API?`
- #[doc(hidden)]
- macro_rules! level_enabled {
- ($lvl:expr) => {
- $lvl <= $crate::level_filters::STATIC_MAX_LEVEL
- && $lvl <= $crate::level_filters::LevelFilter::current()
- };
- }
- #[doc(hidden)]
- #[macro_export]
- macro_rules! valueset {
- // === base case ===
- (@ { $(,)* $($val:expr),* $(,)* }, $next:expr $(,)*) => {
- &[ $($val),* ]
- };
- // === recursive case (more tts) ===
- // TODO(#1138): determine a new syntax for uninitialized span fields, and
- // re-enable this.
- // (@{ $(,)* $($out:expr),* }, $next:expr, $($k:ident).+ = _, $($rest:tt)*) => {
- // $crate::valueset!(@ { $($out),*, (&$next, None) }, $next, $($rest)*)
- // };
- (@ { $(,)* $($out:expr),* }, $next:expr, $($k:ident).+ = ?$val:expr, $($rest:tt)*) => {
- $crate::valueset!(
- @ { $($out),*, (&$next, Some(&debug(&$val) as &Value)) },
- $next,
- $($rest)*
- )
- };
- (@ { $(,)* $($out:expr),* }, $next:expr, $($k:ident).+ = %$val:expr, $($rest:tt)*) => {
- $crate::valueset!(
- @ { $($out),*, (&$next, Some(&display(&$val) as &Value)) },
- $next,
- $($rest)*
- )
- };
- (@ { $(,)* $($out:expr),* }, $next:expr, $($k:ident).+ = $val:expr, $($rest:tt)*) => {
- $crate::valueset!(
- @ { $($out),*, (&$next, Some(&$val as &Value)) },
- $next,
- $($rest)*
- )
- };
- (@ { $(,)* $($out:expr),* }, $next:expr, $($k:ident).+, $($rest:tt)*) => {
- $crate::valueset!(
- @ { $($out),*, (&$next, Some(&$($k).+ as &Value)) },
- $next,
- $($rest)*
- )
- };
- (@ { $(,)* $($out:expr),* }, $next:expr, ?$($k:ident).+, $($rest:tt)*) => {
- $crate::valueset!(
- @ { $($out),*, (&$next, Some(&debug(&$($k).+) as &Value)) },
- $next,
- $($rest)*
- )
- };
- (@ { $(,)* $($out:expr),* }, $next:expr, %$($k:ident).+, $($rest:tt)*) => {
- $crate::valueset!(
- @ { $($out),*, (&$next, Some(&display(&$($k).+) as &Value)) },
- $next,
- $($rest)*
- )
- };
- (@ { $(,)* $($out:expr),* }, $next:expr, $($k:ident).+ = ?$val:expr) => {
- $crate::valueset!(
- @ { $($out),*, (&$next, Some(&debug(&$val) as &Value)) },
- $next,
- )
- };
- (@ { $(,)* $($out:expr),* }, $next:expr, $($k:ident).+ = %$val:expr) => {
- $crate::valueset!(
- @ { $($out),*, (&$next, Some(&display(&$val) as &Value)) },
- $next,
- )
- };
- (@ { $(,)* $($out:expr),* }, $next:expr, $($k:ident).+ = $val:expr) => {
- $crate::valueset!(
- @ { $($out),*, (&$next, Some(&$val as &Value)) },
- $next,
- )
- };
- (@ { $(,)* $($out:expr),* }, $next:expr, $($k:ident).+) => {
- $crate::valueset!(
- @ { $($out),*, (&$next, Some(&$($k).+ as &Value)) },
- $next,
- )
- };
- (@ { $(,)* $($out:expr),* }, $next:expr, ?$($k:ident).+) => {
- $crate::valueset!(
- @ { $($out),*, (&$next, Some(&debug(&$($k).+) as &Value)) },
- $next,
- )
- };
- (@ { $(,)* $($out:expr),* }, $next:expr, %$($k:ident).+) => {
- $crate::valueset!(
- @ { $($out),*, (&$next, Some(&display(&$($k).+) as &Value)) },
- $next,
- )
- };
- // Handle literal names
- (@ { $(,)* $($out:expr),* }, $next:expr, $k:literal = ?$val:expr, $($rest:tt)*) => {
- $crate::valueset!(
- @ { $($out),*, (&$next, Some(&debug(&$val) as &Value)) },
- $next,
- $($rest)*
- )
- };
- (@ { $(,)* $($out:expr),* }, $next:expr, $k:literal = %$val:expr, $($rest:tt)*) => {
- $crate::valueset!(
- @ { $($out),*, (&$next, Some(&display(&$val) as &Value)) },
- $next,
- $($rest)*
- )
- };
- (@ { $(,)* $($out:expr),* }, $next:expr, $k:literal = $val:expr, $($rest:tt)*) => {
- $crate::valueset!(
- @ { $($out),*, (&$next, Some(&$val as &Value)) },
- $next,
- $($rest)*
- )
- };
- (@ { $(,)* $($out:expr),* }, $next:expr, $k:literal = ?$val:expr) => {
- $crate::valueset!(
- @ { $($out),*, (&$next, Some(&debug(&$val) as &Value)) },
- $next,
- )
- };
- (@ { $(,)* $($out:expr),* }, $next:expr, $k:literal = %$val:expr) => {
- $crate::valueset!(
- @ { $($out),*, (&$next, Some(&display(&$val) as &Value)) },
- $next,
- )
- };
- (@ { $(,)* $($out:expr),* }, $next:expr, $k:literal = $val:expr) => {
- $crate::valueset!(
- @ { $($out),*, (&$next, Some(&$val as &Value)) },
- $next,
- )
- };
- // Remainder is unparseable, but exists --- must be format args!
- (@ { $(,)* $($out:expr),* }, $next:expr, $($rest:tt)+) => {
- $crate::valueset!(@ { (&$next, Some(&format_args!($($rest)+) as &Value)), $($out),* }, $next, )
- };
- // === entry ===
- ($fields:expr, $($kvs:tt)+) => {
- {
- #[allow(unused_imports)]
- use $crate::field::{debug, display, Value};
- let mut iter = $fields.iter();
- $fields.value_set($crate::valueset!(
- @ { },
- iter.next().expect("FieldSet corrupted (this is a bug)"),
- $($kvs)+
- ))
- }
- };
- ($fields:expr,) => {
- {
- $fields.value_set(&[])
- }
- };
- }
- #[doc(hidden)]
- #[macro_export]
- macro_rules! fieldset {
- // == base case ==
- (@ { $(,)* $($out:expr),* $(,)* } $(,)*) => {
- &[ $($out),* ]
- };
- // == recursive cases (more tts) ==
- (@ { $(,)* $($out:expr),* } $($k:ident).+ = ?$val:expr, $($rest:tt)*) => {
- $crate::fieldset!(@ { $($out),*, $crate::__tracing_stringify!($($k).+) } $($rest)*)
- };
- (@ { $(,)* $($out:expr),* } $($k:ident).+ = %$val:expr, $($rest:tt)*) => {
- $crate::fieldset!(@ { $($out),*, $crate::__tracing_stringify!($($k).+) } $($rest)*)
- };
- (@ { $(,)* $($out:expr),* } $($k:ident).+ = $val:expr, $($rest:tt)*) => {
- $crate::fieldset!(@ { $($out),*, $crate::__tracing_stringify!($($k).+) } $($rest)*)
- };
- // TODO(#1138): determine a new syntax for uninitialized span fields, and
- // re-enable this.
- // (@ { $($out:expr),* } $($k:ident).+ = _, $($rest:tt)*) => {
- // $crate::fieldset!(@ { $($out),*, $crate::__tracing_stringify!($($k).+) } $($rest)*)
- // };
- (@ { $(,)* $($out:expr),* } ?$($k:ident).+, $($rest:tt)*) => {
- $crate::fieldset!(@ { $($out),*, $crate::__tracing_stringify!($($k).+) } $($rest)*)
- };
- (@ { $(,)* $($out:expr),* } %$($k:ident).+, $($rest:tt)*) => {
- $crate::fieldset!(@ { $($out),*, $crate::__tracing_stringify!($($k).+) } $($rest)*)
- };
- (@ { $(,)* $($out:expr),* } $($k:ident).+, $($rest:tt)*) => {
- $crate::fieldset!(@ { $($out),*, $crate::__tracing_stringify!($($k).+) } $($rest)*)
- };
- // Handle literal names
- (@ { $(,)* $($out:expr),* } $k:literal = ?$val:expr, $($rest:tt)*) => {
- $crate::fieldset!(@ { $($out),*, $k } $($rest)*)
- };
- (@ { $(,)* $($out:expr),* } $k:literal = %$val:expr, $($rest:tt)*) => {
- $crate::fieldset!(@ { $($out),*, $k } $($rest)*)
- };
- (@ { $(,)* $($out:expr),* } $k:literal = $val:expr, $($rest:tt)*) => {
- $crate::fieldset!(@ { $($out),*, $k } $($rest)*)
- };
- // Remainder is unparseable, but exists --- must be format args!
- (@ { $(,)* $($out:expr),* } $($rest:tt)+) => {
- $crate::fieldset!(@ { "message", $($out),*, })
- };
- // == entry ==
- ($($args:tt)*) => {
- $crate::fieldset!(@ { } $($args)*,)
- };
- }
- #[cfg(feature = "log")]
- #[doc(hidden)]
- #[macro_export]
- macro_rules! level_to_log {
- ($level:expr) => {
- match $level {
- $crate::Level::ERROR => $crate::log::Level::Error,
- $crate::Level::WARN => $crate::log::Level::Warn,
- $crate::Level::INFO => $crate::log::Level::Info,
- $crate::Level::DEBUG => $crate::log::Level::Debug,
- _ => $crate::log::Level::Trace,
- }
- };
- }
- #[doc(hidden)]
- #[macro_export]
- macro_rules! __tracing_stringify {
- ($s:expr) => {
- stringify!($s)
- };
- }
- #[cfg(not(feature = "log"))]
- #[doc(hidden)]
- #[macro_export]
- macro_rules! __tracing_log {
- ($level:expr, $callsite:expr, $value_set:expr) => {};
- }
- #[cfg(feature = "log")]
- #[doc(hidden)]
- #[macro_export]
- macro_rules! __tracing_log {
- ($level:expr, $callsite:expr, $value_set:expr) => {
- $crate::if_log_enabled! { $level, {
- use $crate::log;
- let level = $crate::level_to_log!($level);
- if level <= log::max_level() {
- let meta = $callsite.metadata();
- let log_meta = log::Metadata::builder()
- .level(level)
- .target(meta.target())
- .build();
- let logger = log::logger();
- if logger.enabled(&log_meta) {
- $crate::__macro_support::__tracing_log(meta, logger, log_meta, $value_set)
- }
- }
- }}
- };
- }
- #[cfg(not(feature = "log"))]
- #[doc(hidden)]
- #[macro_export]
- macro_rules! if_log_enabled {
- ($lvl:expr, $e:expr;) => {
- $crate::if_log_enabled! { $lvl, $e }
- };
- ($lvl:expr, $if_log:block) => {
- $crate::if_log_enabled! { $lvl, $if_log else {} }
- };
- ($lvl:expr, $if_log:block else $else_block:block) => {
- $else_block
- };
- }
- #[cfg(all(feature = "log", not(feature = "log-always")))]
- #[doc(hidden)]
- #[macro_export]
- macro_rules! if_log_enabled {
- ($lvl:expr, $e:expr;) => {
- $crate::if_log_enabled! { $lvl, $e }
- };
- ($lvl:expr, $if_log:block) => {
- $crate::if_log_enabled! { $lvl, $if_log else {} }
- };
- ($lvl:expr, $if_log:block else $else_block:block) => {
- if $crate::level_to_log!($lvl) <= $crate::log::STATIC_MAX_LEVEL {
- if !$crate::dispatcher::has_been_set() {
- $if_log
- } else {
- $else_block
- }
- } else {
- $else_block
- }
- };
- }
- #[cfg(all(feature = "log", feature = "log-always"))]
- #[doc(hidden)]
- #[macro_export]
- macro_rules! if_log_enabled {
- ($lvl:expr, $e:expr;) => {
- $crate::if_log_enabled! { $lvl, $e }
- };
- ($lvl:expr, $if_log:block) => {
- $crate::if_log_enabled! { $lvl, $if_log else {} }
- };
- ($lvl:expr, $if_log:block else $else_block:block) => {
- if $crate::level_to_log!($lvl) <= $crate::log::STATIC_MAX_LEVEL {
- #[allow(unused_braces)]
- $if_log
- } else {
- $else_block
- }
- };
- }
|