From 80175a488b9fc3ac33c9391499e8afdf7046dda3 Mon Sep 17 00:00:00 2001
From: getsentry-bot <bot@getsentry.com>
Date: Wed, 3 Apr 2024 08:48:39 +0000
Subject: [PATCH] craft(gh-pages): update, version "2.0.0rc4"

---
 .buildinfo                                    |    2 +-
 .doctrees/api.doctree                         |  Bin 116941 -> 133984 bytes
 .doctrees/apidocs.doctree                     |  Bin 525892 -> 631272 bytes
 .doctrees/environment.pickle                  |  Bin 3312063 -> 3512642 bytes
 _modules/index.html                           |    4 +-
 _modules/sentry_sdk/api.html                  |  639 ++--
 _modules/sentry_sdk/attachments.html          |    6 +-
 _modules/sentry_sdk/client.html               | 1629 ++++-----
 _modules/sentry_sdk/envelope.html             |  661 ++--
 _modules/sentry_sdk/hub.html                  | 1461 ++++----
 _modules/sentry_sdk/integrations/logging.html |  577 ++--
 _modules/sentry_sdk/monitor.html              |    6 +-
 _modules/sentry_sdk/profiler.html             | 1582 ++++-----
 _modules/sentry_sdk/scope.html                | 3050 ++++++++++-------
 _modules/sentry_sdk/scrubber.html             |  304 +-
 _modules/sentry_sdk/session.html              |  337 +-
 _modules/sentry_sdk/tracing.html              | 2140 ++++++------
 _modules/sentry_sdk/transport.html            | 1183 ++++---
 _sources/api.rst.txt                          |   11 +-
 _sources/apidocs.rst.txt                      |    6 +
 _static/documentation_options.js              |    2 +-
 api.html                                      |  117 +-
 apidocs.html                                  |  635 +++-
 genindex.html                                 |   72 +-
 index.html                                    |    4 +-
 integrations.html                             |    4 +-
 objects.inv                                   |  Bin 1358 -> 1474 bytes
 py-modindex.html                              |    4 +-
 search.html                                   |    4 +-
 searchindex.js                                |    2 +-
 30 files changed, 7759 insertions(+), 6683 deletions(-)

diff --git a/.buildinfo b/.buildinfo
index bfddf8afda..d0259433e9 100644
--- a/.buildinfo
+++ b/.buildinfo
@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: 357458dadfd694894c028ebaee2099fd
+config: 1f73bdb38ce0c31d8c616f07a2c8c918
 tags: 645f666f9bcd5a90fca523b33c5a78b7
diff --git a/.doctrees/api.doctree b/.doctrees/api.doctree
index 38dc22061b870eb1084ff7390e4567d95ac36006..cf9b16274ad2f3f19f31d47f2bfb9b71fc0e010a 100644
GIT binary patch
delta 18323
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

delta 10939
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
Y_Lj4V<fRLU^L;uAFWK6IgD{o(f3OZ+Jpcdz

diff --git a/.doctrees/apidocs.doctree b/.doctrees/apidocs.doctree
index 15e08f39a3c92b89105cdb539c446447ab37f578..1acca89a9517a896e4ba8ea185a27f71958102ca 100644
GIT binary patch
literal 631272
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

literal 525892
zcmd>n37lL<arf$29jnW>EcuXEezt6DB(GM!z>Z=G%d(A)&scI|kd)oo-H~R-yEE&V
zS;@;`48{=SG4ZhmW6qDm5C;elAb?GPT!bTm1QSRImy>)1aEQ4-0w4LR`gmQ{uV24o
zX0;|CzaQ4@dwo>@tGc?ns=D88y${Umnb(8=Yp-ffmMgVe28&~3wfb18In!P;Rv(?3
zDAigs_s?v4$;^vp3hkwh;^Ag}sxexcY4<>h(Q;*ctWm1X?4N0`#Nw^WcymzIU)(H>
zwkq{nSiRg^UQ}MZf2L4g+U{*tTH_`1s=Z|AbyozJ)JK~$SO$tL+*7&*`zCMhn2~fW
znk+)Et(o%C?WIE@ndJrTMT)v>+6%`kwbINrQzON8U$NC{R7R#+Fe)6yg34GEDPBA}
zUTikuA^h&G6({7cC1X>Q=8uu$=uM5%0W34sUfe1k#8)%rRpoW%<>iyg3(EcN9b3!w
ziPF}_RIOHOY&~3W+_bd`#5Jb3Ois7T^_uk;klWl^oUGu#gN-H(V*Qm1rbfy=?cPdl
ztaJ;(M8Z`*8Hg^Q0+?)o|DO*3-w6NTgag2CDuV0+482l22#~f<xO{3PD2TBIm0BQa
z8ETH*v<aAG{u+d0Gv!6sv}TG^<ul7$%!sZjuLs<KpoJg@qY-)v@Ma~x8ERGlj@DFz
z@o@vR3%yr>wxN1ss5~{Y{hE5MG!QgL>yst%dy`->wzEpKQ>@kMt)e9>?Q`~CxS<6i
zur1gq2D5R;Kyab%cc?j894&1N!Xm-O9XkLPAzo|Sy`sj9k{1}-m6BQE(82-8hR7h>
z^8zV>Yw?$9;Rf15kujw`@9<2Kas~n2jlE8dlvqhxsJ---iScb>93bP9jZ(AJI8>U!
zx>rEmOO<#HWfL#M;H?1t;N<i+6f_W%+QFcHfJnn2z6M^Q{LK^WUM`sd3IJtXPx^9i
zdzoo;P-DZM8I<brC>5Zc%E2u#P|<#S1$HO+B>pZ@Y|7R0O$fw<0irw}61r3nYE!vD
z3<h<_+P3&@sCtQyswGI3BxwmY98b-Qozxs7r~!=xsI^Ls@e0go0^WN6TnMLvl*q6d
z+Qc!@Cc<h0MVyI4HXbWjEzLLUsln(?@ffw|)uQtK1_0x=LT-*003Zo4!5hU^y+Mhe
zw_SG)zf5=U^>tT|cK06D-O~1=N=@i?g7HGsFuEK0hw15)o}K``1I4NF*3hBi_*9Aa
z+Fsq9nw+dRT0_l=Vxx8QR2>(PJ5ek@E{Tbs+gg5K0|oB~kRFr^D9oikqXrcZ-x$8@
z74P&o)L&*GUyUC~`H_hJLH>Lhy8ffE`4~=o$J6Yik!Fz(*z705X1(D5%+vViSmOzB
zL!YVP_7`lQFaaE|451JWh4T&mgn28tdoK)8X<w~$fH-L$!Fn`!s8TvS3O3SAdzJn<
zRIH7bncOF>-Alo$XcZd=ORbsqaYGaJv8nM=Q<)05Sflm^vjj?2#%9X5w->=L(B!b_
zE877Vit4doy%}od>PAL?VG(Txuy|l{&VcBFqN|To!7Q6$+P1w&_K!t`<$?r2=W-D(
zFKRD2Ff~3d^b1hZH`J<+B5<wdOmzzqaQn+=zz)NwstnGNUFCj>9?*9YN`cT7a*Y|S
z*ILjKQ4_{8T#76?*eFhx$?NvRd&;E%APEk`n`Y30zo3!PsRpbjqtn4eu~s}-LSq#d
zIefeOk}C&;;L_q~8UAdPieo{!*zBvcnnC?=O|%3Cp(u&1PE-z-;jc!q);v&Z1cxgv
ztX2vRjMooii=|siXx!FoLFGW7p#GLtaH!a524IK=#Y4r)cyVOB6t0fHF64&FrMe9n
zDGXXEMcl%nYctB-1z5VjeMD@N^1A9X6me4{)!%@hq3XHh3dw9_VWk;NHA`cXcSZS6
z6Rb)p6_wUTkebp2=<{NuGCmy?VQ+E>-j0PlyDURvPu%v}*yaqTSLDF7dO22Fe`PNl
zc6m^bIZ3b3JwbU}y8!#Sp%Ik-(Z<xoNMTb@FjE}OzW|Jua(xW;2L1d6?gU9qzEuc0
zQtnqK^|LsEh4Ll(LHk_j#%iq~s8JgO*mt(n&&``}It)s&sdossg^jGV$&rSh{n&s%
z?ghV4ZkO+7N>DG^VB}THVcm9Zmd$Sq7;TN;7Y_X71gMl1K`abYA!=cWccFzL|1y}}
z9**0o1e``j^~F#rg`H8o*Wb9))X<Hmvo@-4@^_KN;7~o2#njq;Yk2_^ulfQBf#Jc@
zP^Kd+SctDQ2jm}y0U!1cz|DXU$lj9-z3N~28+S86HJ*|IkNdmG!~ofIP6jN|nndAm
zz?r{!vqm3(8tnhWPrDnQ??~*84Zlb#Fx`dz({%F-e>ZLx%Wkq@;V)Y~2B^@+E>U;Y
z=OcB(Ay8cdKeZN0T6Hp6v+ZM|3&Koj;8r(4zs9yD#M$O;brecU3%9xvepU<cAEwi*
z1Mq|ywbem*Qog;q70aJ8AO3R|{@Mh;q|=~nuPCpWsh)$a92+INut|7pz|swI17%Rc
z9)!JHJr90z2n*bRIcDeB7}$`3S)oI7#P!NZ(b+(7W^-*W)-nKOP|*sD#L{-(fl6t7
zOzyVK4&Ipmz2ZGF{mm;?)%J7rU8h|y%5}W9O&=M|uF8bjbFlQf>a+2mkiWRlg<}}0
zk4;Aih1bhQV7F9i#gB0*?lp%hV2(zrbMY7v3v^Jpb`tj<#qqtDR7P8S!J9V_?5s`i
z-@hr?vL(Q0__i@^_AO(@Rxv2beUdcmf<xzTJ#;}Z*{H)ltv(Jrnn~CPHl?@;m+m+a
z)F_S*LG$(6K|&d91krZXDoy=maII&;bwc7=fqwwZwe9&qfhb{oOy!#R8D7@2ZF0J2
z8xE~!ThDOMt*z-v@M;cfaNyCtpl4stURh3TURgl|Dy|R=8eR<qF?|5q@Opob_AvLf
zmrs^zW6=H3EwC}CV66ix1(Dl^Z3>4agiG6t71pF)^-dhQG-{XVArWBiwt(ULvqF2J
zprbv1avEF&lha!eCceu@oq89xvab3H_y-~*@vdp@Z4k;B!anGGm?&0iGt~#7YI`v}
z0QA8FvQYHXUIq_9qQ)zu6>y@6_h84@;OA06LwOgZmR$l5lw;v`(X#e}tg`qi92|Eb
z!Tq2EU`+zTUm^%c2X9ZXm!N~ssn}Fs4iB{EZ6A*;5q%n-pfE^&RNJI%^^dV7$%chk
zhIH~ls}qi2q52wlFBt%1+#<)wmLtM}_d(g59QZhPV>qC^H1RB`{sB}F*jFEcU$FT7
zA-1qg!7T=fl%;@LaiBTE@m)pmg^A>X^~>0^^36jLg6cown^?y~HdMa^ZRJGuUl5bd
zQC)z8^PxF^fCQC<Jk!B*T-Qcb2`C~LyuTpuLJ<P*|4j{VqSp9%esmWvVCW`kjTn*b
zQzDBa^kTe!KS99O4csyYw}<fT4i%?bb#Sl_p<cr+T5}8j;voU(6n+2IaPgYAiF6cM
zyC4o3JaOCol;MstJ8%Yeuz;I|*lwJU)ak=pS3QuxRRnqrg=k&1D2i4~@Q>E5(mLZ-
z%bf^cg3+?G7Sxqd1AbJ9y@0#5*a}9AwP2(q9eE?u@bf^uQ6gTbzE(XLoocq~6P4#<
zl@hU>(b|C~&>>rzsI)@YUZGke1h>8W?_D6LbUtzwZzHHonP)*Ihbe=PX<JWEQ-*7t
zMB{}omV0rC@ixnT3jvNMRqcto=eYu7-T-9>-##*n<seignmwoPNn@SdAc%}wC-|I7
z0>?ayb@F0t$!(py#Oj1&MZr$CPF^Gi!dpm*_FYhwpgmjGi3@7bQ2029b@Eok&S{;z
z9p7}xI{9DFR!-~WkDzK7P>r)rLNvK`;+Na>*2$*`yxcnZbZU4LHN;=$NB4^y-JBXC
z!8$P*Gwa00n6KH@07zqDa&3Zyiw-kEB5RJr1aXu(Bi(XLY@J9WOWUhNO5YIf1TiSf
zGKf|WN0xH68D85yI`WG2^MAbpLUj__DZjwd>#7mr*0#51wH%C9Ww*vTWRoBwqwA^{
z0wun=9<i$Ytqw^8Y@aZ|;`K7N`aD?_{Z_t|2`qZ4EPAmhTD=VZ;bvW-dL?<*UUq#6
zlKpCdu#1(tWX}v{XD#%pO&c@iYTJU9sH?5Imvry4G)d~oCp78p)zXIpi4N%f!OWl@
zwPj*Xft9$qf<oIw5!a^bN~A|Ewj#mEjPGji_~>H02wVZsOROvA3TVkEC?3P+cc3a+
z6c%7NncV;qLX-w;|9`22uy}Q}(+h~ra5YJGIJ&TlDse{H$Ry7G`E(Ho7AOksnbuKk
zf2DKLv2XnQMpPkvlGiLqH_##(Tj#uQFVe2GdtglM#lST&p{n=dpCSX1{#~nYk!iu;
zRjbwY&z1V|7Ll(5ezxW6rT+V9D5279nqi?;HSqn4)Ens(hI-f%_SY=6THwx<8BjZf
z$)oZvbc8=|3c~3lK=qJJM)c($oM`1AkZK(yABeCGX{t~w9gb!fEF&efpPM~1Q~v|N
zCXYqv%`13sSho!cURkon4K^v$dI#BvWQwmzDp&w0$Z?vOwRvWundTX|T(OS9;j`gb
zGUN(;3M%=u9Sy4gd5W?;j%nbn{uxp?+i}cQ7!ss7b7hT6^;oGh3}ulZ<{tv3odhv|
z0QF@M^XKqO1u>cI>Iml17P%yRso?_k_HINjW%zRa#W1xoehH!x$Qd4hhX(yJWq?M{
zq@-d-sOI(hCYQZ7s4TQ2K9vBaUm28kMvatino?^sL845l)mW)t&jOfob8JeTjr6!p
zsdK&K%VJ7xg_eBEh0jjrBiasCvzk&k-B?5=)|5KaL0G&gwb2WRa}KPlp62MnE~-o^
zlnvWpv5Tsm!BHt%Ri>1l5SdIVt!s>^W-_I!4<HK;0g=^L<FCW`>owu82jSP9)z^yu
zJ|zD8I`QAvi~qhs{P&IcUr^NLu9`d>M~jnqE^4TB2<$PR(Q}en*fAS(kX7u!?0HtC
zv4WswAP6(l=!vX>VDn~i_+Th5|8j*znVihlQ=`c50aoO-lG<V2_QY&kN!F-rJ82*b
zXkxi5kh31WqPAQGjZH<Lf_p}mG043m9DN46>a9@8r~0T}^(Il4keN4G@#A?YeN^^t
z^6}iKQmTLBZ`_@Yry4iD0OBB6+m?SAq`&I#B2%)W?3wQZsZ#YaApe=5>W}?naAy-f
zm68YZ7x^Y}+06shcuF1|<?kXB4`k0dd9aczKsA?*n8v1!Zt{=74btgQ2||WODJ-Yj
zSKH0}p%L8k{aw15F1yTvj=wD5dKsNveIttGY;V29UWO}gZr+j2m!U1P`FaJ=+R5f?
zKX5{BzDn>*ZN98UQE$IiN0(%iKdM24t;L;cN`uj!oIkot8XB+%s|8{u2{&EGI9?eM
zn(&JdIc1JOs*Tnhtj2&xRgr2R{yBH&cm+}%;dB;ya?#bcZJ1b7yYaX=x2J}6w&U9N
z(y%gdX}r(^g~w?(rS3+|UmhucIW{eACVB?jK_u+T4V!+?qKLcx>E;OIV~7EFHX`#>
z&fm+RDW8eJrw`j5-3L|4?r5RtC&|-{6M}7z*87=5GJ2{nz+uC+2*7>hiAb)PH%M@?
zITf#}jQG-4iA+Ve?}g-02u(0nY^9G313!QxiH#pq3jqmLyZ85DrGBkQVfe1y`*6hV
zP)N+oxm>7-pl~T}OGNVU&H&Gbf#?*+AZ-R8vqYS+N&~Wl;kX>~4qZFD;oruznnygb
zCc&=#d?qARYRzXg_j#5uKBlOW)S7`v_OBGX9z4@J*dx-rnu7uWXISVooaH)Klt?VC
z=n58n8%dHAyjQeNr1d)%x$(0&IW^<o1R}fzDn_1Z{3EDJrg6&DjL1AbE(R4cfx~>=
zZ#k%q_k4uhW-;vuvmG&QN15~Uinf`&cB?70%)07dJBCadg!5eG)BU9=nmB9Uks_aN
z7ld^nKf8&?Ig2v;f26JsI7g?oI1hcGQJ>HmcEHjx@CQu6X=!z8px&q)tiX{2I4Ce$
z5}A4dM5;g;1oZ|ud@tX#=Q>awH&2zC@I<_DDg|%0-R8x78plgDf~Hi$8BocQZHJFz
zRKnBf-~hKMGG^Odj6;+v#&tsA5(@#2rfn;D&j(y2Fy;+V8TKfdYoIDoGU;+@B045b
zw%vt-$Y{15KBtnvG0&21cK}<GfZJyQ%2p>FD++e9N*@yg;Vq;@y8%@R+Idxa(pdl(
z)L@(8;~d#`uSD!5tRf-JDBL!_iM5upq56B!R!)2O)ljtysK#a6g=q3@JHOnf&$fFH
zftP37y*D+yiP?7V%8%|xIl4JDL_)Tm!I)*+*%<Q`J>D`27aeAqMAjUKW#TAvLEgoh
zn3Q(2)n7uwS(pN~LZ{o|x*jIlEmMhh_>eU9gjXu4BEnTzrP$g1gBsr1xdCA`f!#i5
zlueY%C)$u8l-W(MJB3@0oMjLjc6siS=1dZkSd_r6QgLz;Hcs$E*k8@TzC92Ym+cj6
zWAc{@w*=ueMDjwJiK*69aU5!c@ijixtQ=A|%UDMl{P#sw7ccQ?QyW8NUM+x14)Y2h
zQ_W0vTzg{9OzK07J+bF9C2DeKCV&|f;6Vj-&XO<P8O^1Wk>q%D=@e^3eEp?sO`<aF
z7ntz|D7+qX=}f3fmYST(Fpar%f*>+#F5z>^S&sRJnC&oOmuok?3mcW#_X?g8eRHYR
zA;*mZpKLnq6ocX|q(uH&s7jE}YdWnZQ=fq1+6;#rm`9JN+4yr!7r!Kh6O}DVk$LJ^
zk{o50Q)NbYWf$ebaS{;@0)t?<ODd*~R2*fOC!M~aivn^uzkuA)9RZ1s6qg~HY^z<8
z%fXn|Pz&XILhJ%UaMCq&$_2Lp77q(?3|D{qI>GAeyfD*QMAm(~PtYg55PKM-XB_P^
zoUWCUF17N7<i*9h-rXfCH>6o(js0PdfzL`C9A$s>BnVq}`{OaeLv1A#z?>IeTfMXf
z!qXG6H3s`G11F8Ty%MfO<DpIP<$@g|{J6p=DyHk;)FiZ38bYU#>aMV97EBh-X0=4{
zhlUA%pNaR%fcaa&1dvPaGRDVrnIi_wNihZtpzU-Kr{9Ww7duruUA`52(jtd1VRR8p
zv_Ae_445}S1=M4G{1mE^H87|3k+2o}R|kFZ%UZ}jwyZ_C=UCPpWwvIVC`7s1t#KuG
z)G(h@p&GN(2#heFxReWEJi~~(wW$#57U!>zQg+N`&=a+c&Ux3WJ&1%$AwE5o+90%@
z<sGyw=HB?_05p};pR*0BQZdgLzub^w@WkxXYx_~Kwre(uwSAFPs{|$eI_E-uofl-P
z3X&wtTFCu$Wn9Qdx<qBhh1?!Ps)hWs4wYr&$YMDDR@LdfKT8oAQaQR90Zy5t`yLrY
z>SoIM1DRN*g4Xw8rKF%WyS;UV*3NjNmE7@@Re49us;n!;xfP(TE;$h1izAA6AiUp;
zlC9gk@s{^MQ#p0pV^EdqHqlS!+>A61ghvFCQ3nD(r<N7pBc`|;=y7a7SxNkEpntHM
z=4&Q}IN4S3_kw)h0-e(yGwGX9m0+CLRS*{s2!UmO0UK7XV&V;`hrO855#ws0b}nyC
z00)aI)r9jrlWO9G+XSfN13Do`FM<9_>LjMllrw54$MJ#wKFCuN#|PHqFL8W8{F=Mt
z180VbjXL)3J3>JBaxBGASMJ~#!FFeZg;JwYZ$v)pl6;8Z=*Ylys;lFTF`dr`#!wBz
zC$ax3=X1ll?VFF-VFH7^eW2isbkM2vV{<sO&(u@zOzv>6c&Cw6e;M?y2@%L}px`-B
z39MC<{~VL1zt7*eJNsERo-#$e>hB^`in#1KUb)aT{mUc-ga^VIBg8(+1Mx28f&9zx
z;CBBQ+!@<1mINg7;9h^@ZXT${Q}W<V{w^}{K=z!I2loCN?S=vo)7Uiq5Bo>p2I&Km
z17@mmPn9xS_(Q|=zw&qKX1eS$3p)O?JWbzd!|J6--E61nuW_y)@s~Xt`XZ_NgFtU5
zsrpYseVMBNWB8>~^&QKOPS-!qNjf<*tpSAn{aJ`*$}`hzSzf+gDZ;e<xYtIkeyKXs
zrV?KbZTm{4?$6QM2iW}FV8eEQ=Z6{i9uHN-UPwyeU$%^!3VbuNB~w>IoAWgOHQ2n|
zs+<;a2Stcwsr<)TlySDvy-Z>%|7vI|=XUWFs7kgn=~DS|!mw2SQ<KL|Jz;$~beYbN
z{1IL-md<Z;EncOCdzStxX_d&>?56YY!jZ%#sM&K*c}6b6O8r{l!tlG5&i|M&{DQ&_
zHMl->@5RMt=~Asv27*0PljEhm+FP=B58Uy>i|pS&5QMK;W%^=I1HQ9}U%|u%unOLU
z6ehr!<X{LwDfu4^;6plC3i5%bn}bkfs8Tynhb_$E%J?{B9E<Bco!P<(mhA6lLSMy$
zo~I>_$Aj=O<)raE-FP3|*%9M>5=h5+o*0HuDE2mS!5XU-^xLr8$~9}Oa^h$LD~ODV
zD`b-dH<-thmDFRjvDgtNH6<=@FEt05bip7feUMddF7R?^1c_u`M9$pnEjZ)~V;n+;
zOV!;g3K0kVEtW9&b+gx%*An8!8=!i@<7Rp(RHeE(l`Aizo0r3FPIxW893$#W>te4-
zL1EO7htKJZ;7jKTB-eupf(z@1uqlc43Rak4{(7rB4jEk!lYM&+iXrh9QiA?4R3)IN
z^zB7Zw}$D1ooD^}QFjQqP#!MO|I~oqD+&>?Kam>j#BlRt`LX^C$2wiOIRdp7a5+XF
z(&QrnV2C2pcD8!Pl)@(vMk&{>6Bz%BuVbwPD$<E4e-oO@Y2tk!suGFLiE^5VfJ>9a
z0PQ+<feV*QkQXfvQC^5;h#W7$SE&$ARvHVTt(*`a162vcd6kAfb|D7YnILCU&zlXv
zmfkYE%z-W<UC590GrNPdHB2AY3(?3WBIj4o85PJi26>kPxh^&6i3;SZ{FpzFWB&9|
zAejWbVPLj6Zv?!R8tY_LGMOLjTRGTyRf#oBpMWozMfrZU0p2Cw52nUEQNCyLL;e;H
z`O`zb17cs}ccbjhk!zv+s6l%L+es1i^;l}ilg0eQ`7!@1j(J`&U+qAKc$&g<=b>dn
zwRwzbl6(>L*A3409a7&+4R6v#(Epqt-0yO5Q(XidF{@*5FAT9{=?V6-$X#~v=?S4b
zhUIrgyfKdaPDh!O;MhW}3yMqvyDCrSTtsdFhi$RV;$v3$Y)-n(M6IjN$JsqXyL{hg
z7vLlvHOyUSa`r<bEBSLW#?!h)=1R*=XI4y`WX^IM2$fm#I|&;Z#7w2q?GZ&2uS58?
zK9hGvCN3!#=A}?cIL)~W6Ccyfka1zQpRQ-}ib!(&271&Q5%=h1+CUEp%y<J-L_L1E
z38+eTce7|8>=i^tU2*uFa+bT|a-PY%0~=KiP;usiD34cI9dg_#@X1!f?P5^8g_OwO
z3snj7d98#DXYxW0u*J>BpKH4K#VwquY;lXsQ^(@wC=+)k&o0V^BkP&GM~zfOPpTQ+
z|FJF#$Vc)E$fvp^AkmSU4U>*5E(LQ@LoJkVsxx`Ih7Qj2Wj*ms-q*Y^(^*7p4ZBa!
zCy_IGb{S4r##H|Q>=Kn3Q~B*N@L6etqwJ516ND|h{qg_znY?3H@}((W&m*$RfH?{(
zISd$lOqV%gz|7v6yaDV~E`tmBnY=-Z96mI<2qt<bHj4rC2B?5~td9$zDp><_S|15#
z^3HJ37r(59>|@JXgnN!<%~7U<GkJDvT#4m4lef>yamp~FZfz=ry0y;a*=6_|-T9fk
zNhDkfapp654ey|BG54Oyt2xAoqUI6v7eZAk=Bdu)MVuB{&*Z6`p%t*UYZeK;6g`ut
zU*}xN@AHC8F-npw>r9@Xu8a%$+qy($#)aG-L#l;*MS`qF7IJ^9>P+5mrEpKEgD;rI
zmGa=rcInCJ=9#=NXJVDgJbN4~C1swmtjwqTnY<t3h~gaxKlY+z>o#v9&r{G;&hYTB
zpeogE`4V~3MBtwkL`EG5_?%i+eEmsrCU5Pk5NGR-zT@#tmqPHzLR&d8J{77GjPtq*
z;?CrSz%svp4J%hM@dnhtTkME83{i`zoy)%o-ujCw)r9lB%c^Oy{MctxA885yHa>yf
zUP-XmIHi)V!%CS{(sR+tk2g~fRmOtK0r7RQ-IrV$jFm<!V{p3(WS&AgGW-kItI4Zw
z3)T%MyT&U}o!<pt*tAKdpyKR-E{Hd5%o-TCGy8@$HKA92iGD&F8MhkoGg5^O?4E(P
zGc$~tbZ@uBHNa+PBD@PHSKRS79GX<Zr;to=S9O*G|57g`ws!Vfp0`3%IW<QcsuInS
zGX?(Sgn^T&r1mHs16HSIi`)%^2%71nUulbzD;Ik@DJ4-%zybA%QW7}xGARi^0qWqc
zPQ6b@wK}+~&&wD^kmKO)pTl_M!QH>WU*h1d_%(M2cQ@%HAQPo#vv{!NJGM(dhd_@S
zsj3|u+P%clTtPKE5R8Ma8qaZdca=3Zy)Z<c8;SlJ@Wo>)ct4f;k73<*{YahL4WYMB
z?QYG8p1_8F32brLG^$N=o{&FZ+YbLWApST6BE#|Br=XHgJ<@ZoPl~eSdtiM=MASeG
z!M)<0=DqsM5WD;+AIHn?Bacg<66nLkbFL@)8+RY!RE?)R=UVW0k?EYP>^WYE`gxH5
ztnp6&7~DMAo{|UG`WtuiKsBC{2mAe9Wa5GBIVTTtpEW+@AAuXBhU9>mYW!HSvbXp{
zGx1*L@6ye5*<}`V{AKxBW23>V-$NZX+h>j0_qDXX<sL}1hSV3C4Rw)|#*YKFot!j&
z1b87&8owWYsguT$Wm2CrW=EtI+2oY5h7N4Ue?Syr=bh%mV5@h99|nU@f(T<IJYwv8
zXGH0veo=CN8f;G1Xu#x86tVWl!Jd)jbg=>`>1^?*EnxVT>P+XBN+eo@J5Sw_SU>s6
z;xA(3a!(b1y4Hw?Vb_-|s`x%L)28b0pedi#z$X*?MA$c=YUWK9P7ijjm|kV$M2_yN
z{u&1^PZc9)#Ey!cDz^C*ue?I9OMjKLN@QzxPZiHQT25@ehvF=>cYex|@+%yEzgDd<
z{BE5p-mau9D8OZ0;<{OJaeb=+rwT)7i~35CE($)F-SJ-r3$0ou;Njm!iciV}feI@h
z50&IbIw+8hG(M)=4iZ*AR-Wq(57COt;^b^(w`QjBke-LV$O&tCNS|r-&)G?5WO6dq
zIbw*s1u77pDR~i8B~vn`hcq%L<2<B;4$9&^pdqVR2sy$jM+n(bW+0P58X>crN}&+e
zRo6JiNjZSJLnW{tBZ?*_u)b34p~y!iuBx<3jpF#;jR)W;^Z3SrVB=_`(yENg-{O!z
zK0I7()L;(cPdreM|BjVLrVei0FVEw{vHMzG?(c(2Gnj1D521r}KzK&SN(YKl<1O<V
zn{Xe(_iynI!yxJGikD49M$OcwKnA>-JcAV<)3(S={anlm{FsyF7-C_k;uWUmVEi!r
zlmPc^grDMgzIdjwwjK-Et!Ih@)>A~%dL;Owp23-RxsB%bLdKJ0zmHH!b>li&bFYOY
z=L*$1iMcCx3tsUCsK9$v&g-BmQ90>yS0WlGP2lTJL1Z-Wh0m!(am-Id8x2Lp+!vta
z#O3DxV{A)8zE~9_tIP+jo;YBc5PzQ-3~wMM;va{qog=;yj@96u0eX};bFEtgT!4f9
zjgR3_b(?&Qw7qP2SZT81Fha6eJs|*o$qOJIKa!)qVjGgdPg6wL&Inow1nF76(a_Xq
z9ul&?-6gU-;7E;b2wA*QJ|R^6e0Hf=0f^}3#L%%cd`2i)b_}0U@nY&{Qw$z`K#5q*
z3>k~$142Xp?9zY&D_2rO#A5Y?P_eZ$D%gj}Y=PybNW2{tE~Lzkimam!JIYaJFq_3d
zps*X`5z<A&$kA}_FT}q{<=vTZRFP4;M^OE2vuD5OfZEzbMb9Q-miackDACz$yI<?W
zNw;KTj56(7P|2|g!^d<XCZ^rf^>ETXNOHW1b)PjNt_U+N_^%R}@dl`fdQ7a>L)Fd~
z{4^%kD+Q5J6APbH&T<ng=i#IeV51WI$OpqdWOc}KqrfNcr{6CI#al>;{3oC)K|b$(
zI>X_lkOM3U$;O{+y7;9doTzN+h|E*R(%~o*cR0x|%7r8A;iT^xsfZrgG5h)_yC@+4
zo?k$I+8qIjj?|dr+C7OM4AW2x<(ukolCGisjC|EjJe;(AHJ|wLvj_=R>$cq|=#$9d
zB)bf!D`QUc`YutKF{jxc1D};t#UMD!{<t|o*s|Ln|9>A&+Lej-%7A$mRB{+F_?Rwp
z#DJN-!%2IwQ@IRUhm-bO<nYNy7r{ga&vV6qc>`2HJ=VuTs7ltroDQCZ!$~(d=!;+0
zLiVv`Ey6v=vgRn$!QmvkHLk>R98S8+%W=vuqHb*}gu1m3C)s8A8r}Kfq&FeqQiwAj
zPWoToLEB>PO%Z*ALyRbD9x?wzs7l2=)#0RwA2aLWBo%tZ4~A(L3B43OoTOjpT*yD^
z1({-$Bw5zsBtKml7xFK5iOP%%xjlwd3;Bf!vKCp${jI9QNvl%0CscATMuSr(_x?f@
zt#<Qp(xPMeS{c8#AP_2my#OmE1+agu4kw+0BZ_w*Z1AFF>o)J<q?4g3pX17-+qOVe
zs@qZ>PKxNZG!BGyg2<=?0iRRLimyK@LhqMi1IkL`9}Ii8)if7G3URWlV3#1Dw?K8H
z2jky@ss!V_u7bGGdk8G^3)rx76%%hj9p}Z2ju<De+PNH?01g&astM<LmsL}E7)eP%
z__y&1yfo9OluCLrR?4K3j{M=I`>la-J2U0sq}N%E#7j9cQf=k!o?&L^Je*{=#5F)?
zhm-yYhbEOnro&0^^Fl&Z2X3&umgl>nshryRQK(8ZN4mpF5$&AiaFVh**MQZj*&=tt
z>~NBPr7cdbTw;{OJqb7vC4n<9lalZgpbjVL48C+!tHVh;&DJP_9EX#B2;-55lYWH1
z#Nj0IYwivw1*75^B&7A3Z@<GyA<Pq+EHzrwn`YW;_^Ux#Blaj#dt|mw=7<wag4~(%
z`fETQpS9^FGcSTKef7c>pD?)#<xBK~b{{P)-aRLL_l&(4ZfKQmX>AKO>S1o&F%Voh
zR%(t8H7f^)nv?K(lWjp*D%iMVhf3E0^|nM;BGJngYq<4N-V^pVFVF{L;Fnp7)>t(x
zWjkE7rcZe{%th?RHzD-tkt?9=(y)Ug#E~muMwD+0$Gu3)iB!A#PlLebkU-ZNCjSQ<
z&ETq=uo-za%dj}Ol?bgQWN??1^cRZH(8%Pga!>o%kn59Ewb9m8u?3&anYn)^9LKzE
zA^)}!{_XHm-<~%)V{@>2Ay!#ey#W3Jq!K0MYHtr^w}i;X+0rQ|2MF#Wi2xbIUVj%P
ztDoj|x93kz&zSY7ItZV}5${{Y#=%l+rhR-I_%q@g#LY=Kq<x?=I&)`xDWqOa)W@dA
zOEc9i*bG?U+e9MnO!;<P2}HtCddw#M1M*_F9qJmczcA$b3khJidfTsF0k1n{d)wPZ
z4z}A@*FNO$AcpDH3RE*pZ_E3Hmo`cVG}mQ6opCsR0e7o5GW$){>H@)r4X`3qH-b=A
z3-F&3)u+_~l(jx1rZYl_%ePmziWg+@kY{!t#lbIt$MBUxrPtI^o$6!o3M93>3rqv8
zi(r;7g2%X@b)L(qG7rWX>Q)7jk~=!pXuwje*X4RmJS|U+geP^<7B`yq&lN4&;<45m
z!f~8(Vl&rY?Zrx<S79ul2*={Dsca=ZbOMOIXceRmF-s|D&jSmAYySkjN^9w>_)Azz
z;#UXOk{T5n4}*HHEB$yfS`w$gG7oY?Wu?6sEu%`QIfE9)w)UpcdhI~v;8deDB#vWd
zI?m0j#@bMFLG;--=L-?#%@rUwd>p^ZrVergp{+`7sx;KX&$Vse)0ir4QtO^srdL_R
z(P}U9+=$bUl{mP?$-i(v71lihC%8F0U^EI7<vz{$_NmE$DZI@0epj$M>a{taxkSI#
zIGP6rz-4QtZg2w_b0B&#R06S0JP>_?zj60DQ`LCN!?+v$U1U0pD|<G|+n#<}@4p80
z&;kj8Va95Qh(}nmk{8m9u^$`uT;v~~``GM-lD0(lT;p%t%^uY_VGmAbJ(7ju4@3Vx
ze;1k9BYV!m9)DSW8rW!q>U<>n$eaeY)B<<e;tHrv0~_ihr-8o*YOIsfz_-I_rDbs!
z{0dJ4Ta@wB!2BgS4XmMq8S)=Wy*jOq0yjI3yS^0a{-&@p#CjIm8L{t;q}}hAG^b%P
zH+mnixknKT*v#(9&39%(MR}Ruj+OfLGyqNSI=RWr#shk(A&16xfdx<;fls{d6(?o&
zms!K3VCMK2R+a{*G8*6u53MpYL5VmNsx^9;!z^mbscIe=;rLi47*yWPN1zg{a`u@p
zd`zQ5B=6>-4$p*X$jqUzeLZ`v6QMoIozOGX9J^^y;vxWsO6J?C*0)K!a>DCNIB@Af
zah>q`vV{w`&u#y-H+uL*fjn=3*};oouQyg7ovCiXJreHx#_AKrN^Pe4EvQPihUpT3
zQ1P*I-f5zTpBF@ec#y9+7GQ4Ub1EOq0n&Dys?%I|9r5}(Hl{Gw<%kd97gk>!vP_u&
zObmxNkP`FW<GP7?ILy%J(jR^{Da3qXPq23{0m2V@&YbUl7?%P+lJk8szU$I0lk1?Z
zoZ*;F9Qu@j+=#qq$oURgV11^|&w=D`SnV`m+g_qwsj*J_hSjt3BYibTI@LF<A~?&D
z`2>4DJB4L~$_?81ka@Utv7E!m%H_y8bd-4}oWjbpSexb7Zj=v$YMIdKv#$D~1cih}
zRRkXm7Tc|3w|XfU4WOOhB8ql3x#*Q%@wDksHr6Y!QYIVgWPP%H?=EnrK+NdsVhyhF
zYbf(d28D<*az{2}B)oD$eEJ*@+wyLVO#)|>d!%Dr9%z@YOSe6uLRE=tpdOoR4SYL7
z6>oRE!wY|=HSn#_R8B?wKB#(R?2b1HBBOQ(KBp@Z$NW@0SuS{Nj+S!<yP*Fxwke@s
z$xD;9_p?^V+=ieGNX}{clo%XufzBYlL1vcUm!K-)K;ETrjXG*>4cDQwU5o$?gOBac
zc;_@g{sWPf@J9@g|HOA)GC;luZRM2vpF`Cypq{}131R0;r7iw^jfr0>U+2Y<${typ
z9!vm?tWBusySz4q*<?yK!oSUmyZLyZbl9U(Ytlxnlxa=6S{~3I)%*4ez15{rYE3n2
z&7c^J$^|Q!kSiAK?2D~Hzs75^$@U%;TbElksQhLoR8%J61yIR1IS8*2z)Za6LTa-`
zB?)O~k#^DhE2+Sj_P!Z@=13A6gYn3)R|$WKu$TDNLD);hlk$eV3Mfk^lH`kc^_!UL
zpbAlunjHkZo*iwiP^ulOH0rgXdSj?uDvp&J&4HjksiI%C;zUW`Xk4FaKmhETdd(34
zv*Q4I>E&Z4OYg0~7SAH!y}<bSVcm9Zw$h|9RvZN@8vQyq2Yf2HVj?idL>rM|2@?{F
zEwZ-ldSx`n10h(h1fiHP*}YK7r#Wam>26V$TynfvNsk()8N>Ygq>i@WPebFo^U(MQ
zvfsp5(WCyx-LWFoIEfXZ+-vIXZT_ddT|6+q2Yh|-zjCIakt88rWqNtAG@Q5*E-b`X
z;Yh?Eh7(VCM-n3~Ur))2r~Hk(IiVU)$%$Y2yU4@<*>g??ENdEd8DYU9`BF1M|7qB8
z+zCGI7{i9uP$^Ap`*eTfZZ@dKQ?lV)e;1k9AbZZj27g%|JT+@cwT-ef+riUg9E%Fy
z8lqLEVyA|<NbGb9i0veH`aIx}jGd0aFBLnrS8*LWJvK@-iJWTOU<Y|vO}{je)7`sE
zEg3PzRN&%4kuw?^+y@%<i9juj6PU_XZv@Ib3Gis7w!w=5<mJ?w#Zk;S4Wq8J(zcnN
zRlj(<Berv4ssKw4Dq5WZ+pc;OUz`aQwR3wRR_fPt5A;`J#CF*p!*HoVjZ!+t8*;=9
zE_4r)26~k5h+R=D?wi&gCt`{_>bqP|58;rc?}O25<mdHXq_X*)9)z}hrW#i+%<uFt
zRL$-IL4CnOj`VXY4v5Ib(qS}g#zAzvqvIYZ9luww_nvC=d$*$tyQp%)qYS3p{7$E6
zRc(It#LKk#)e6*1i5#2XZvc^U^ZQNwB{sj}*W7J>PlwNl4K?Ame9+Rqo$rZcy5XWj
zs&%mKJ=$st7B8Hj1#-}08S6>SUi!?;-k$@g@#5&u-26#cw|&!WZ(S+%k*v-63WIW7
z#;)F8+zV@np}M;GL>T;R8%e7yenGxCO`9MVlA$bOAw309cVZ!}hmlGP=?wU#EF>l-
z+B|ZI7mz4&*)?1M;tv(;)7VCvF0GA8+el}!tGT1TSl1}wHPo;p4K1DwHH;(=A~Rz>
z@wT><DeXsIZUMV96``|l#O%rhi85j?!b<&mZlp0{qz6G*3C4O^Ev*-p0VNa_4~Qja
zB>XPYBXyYVsu=c;kD4Ay843HKrJROG6{-@$BUMHMPC{mO#AYPi=pZcKxYz@wGtPl^
z)!%Y-VNVxjT%c^EG%mKMXjK^(dO~C}F0=+RqMF0Fcq<Sojf=P8FJWAWUvp<%oP1z>
zs#*4#6~|g;g{aVhL2(8yP_oxnWujD{YU$G=DxMVMCht`p%ekrkGWz&qfM~od`Ynr(
zgmv4c*|sdyDD0CU>pWN}gUk55m(#-Pt#K7ER&T`%2&{#F8?YV^2b{sN{ROC$#z*#q
zzj3#ZOf_y4I??iL+qNct%HKsMADQgg@ApEJ1kZnbPC{Tf(T&46OV{}%H^yPv3zgC^
z<2ZlgZf2;)Q!?Xpe;1jUA$!ik41Zbfur%|$`dO5q*|x=(hN>>!3O6)Gtnd#2jh$HG
zR{>+B6}|_4DJxtlPHlfL3rQqiNevE2{D;&`OJjKt$gi6n0C%JFt7G!?x77X8`BMP(
z)Msjuu+~0HsJIy?@|y6nlWoIfb&9snz5r1@fNjd<<Aj)M0D{qyWs3%$phWGx#Jg9<
zpsAb&UjwQVgD>6PE68wW@f{a4VB%pql4~DG7IHYrxKk&AUj{{SvO=xr;!k<1IeLbs
zt1j7lRZrSX<lMI{R<)aX6;|rk+6Bg!=#nMtoYA*k+s(WS>2dF7-s2q~mF}e7%p=fJ
zPT~GAR3*ZlYBv*+?bzMS!w$mYcQbGC0%9{<xk}&U=)x|lb~7j&Ndm9(mG4T?s@l!y
z38BR_emz9jkIEC$THT0hj@`@;fJnKU`62!iyBYCo?shY$!|fkKBgKOU6TWh8yGlv5
z4t6%emqnU#xk|}vZJ#fr&&=wx>?En_G-J8`@o#7rhjnM)<wU9P%vEZruAYDcm~Hb+
zxJoJcv93}>S;R=250rLdq@4xzrIB_4{L-#cN|iR%9O9*2r5Y|+AQvKXa)CS#QfKs4
z1M-du>j3T!eecJ`a>@iHIDuJe1R{Wp8JZXxJ_L!Hlf@bak;CUabF<TCjLcu8h<D4p
ztyhnfQ<XA9nIYQ^%Cl^S+>i+pWrkdjmHPE8N@Iqs&}T9B!qugbQzbico+=R^GVRJS
z)JYtXG-O=IP#a#9s4<gx4}A@q%4yBK5ULVuCfzYqoc7FAPjd{lDu|382f^pm3&yui
zDK4>{!3HGG*7svyZ8dGJN7dKBQ7e6^&h!>}g%-P12kj5_y}bJb`Md=>ySXA}f%i8<
zRf2KK10NBP<1Vocfn}H2+OTpXE8e6$;KhuN7{O5{<!AypSX7ymIL}j>l-H(cRhg7p
zxoIuTM{859OiI1(7`2nbr2HBXDNV|+<1b-SieGbQQf@-+UxA}{2OA>G%I7Ml*&OIs
zv8r}pTAu1?u7LTcn0hYeS~M)bD$>22*OBLD{rwrBPSppWp?;h5M`7LBzhEOWGTWWL
zf?*>qZQ`|cyfyxFSKYO3>#4zPWxo%z824=-RPrq{I)eb6&Wlo%<$g}XifS)XH`|8v
zYKL^jdpr$w5o7xMAVZxP)91lxr7?XW{8GkrMBcSQy~aT{@q%jTfCWz}*-qmHeXTaC
z(SRn3BS61ss|>jZWw_pUWI8}0M5|g%-@zb&Q&nhvm-?Uxd@)<z@)wNMryylhR4wUe
zWAzdiX$9pXSm)wg73ruCTB!xYm~=mksSYyTvot329nj_a@}~!h#MOEUiYdva;Ma#Q
zl7rD3W;+^ml~tK*EqlFE*M?({;+~fk93wNaZJPYcpxTVoXFGoAQhgwyI~4{Xq3n*H
z>!nmFAqWl?$EQU83rdd?5tLIDNf4ETQ$<J+ZIw!6L8~sMtJtRmvDj)AN6S=<)_K|{
zye(Pm$;8_Ut8yydVvmBiXXA{@HaNq7o9;CHuZ|(T>#ywPEScp!;$4|QQhUVT!%A?=
zrX(2fN_16=Z-0r+f$>z&-bcqCM#9uiWM^%f2-G{h!_BnWdmA+6TZcUxk@rJYvJpwQ
z*~4XtZT1pAI`(D<eev6k*F$NlMg5aSZ8u))=)%^SYP*3VlXAOpM~YU}c0;SKOxq2;
zA{z<LvEBF{5Gl7CPvS4J-4MU#c)Nj_;HAkTUc;MpyFsdUu-ynPBhsA1n=LFWQbaG%
zk>^IK_OADdsDFnsFRXiHb{K4A_6{Rc60o7Xx*7*@#0+ve1g^`_i=d858R{Yi`7dE!
zbYhTihS5rc{2cg24RT6Z#2_axi9xQRgSGWnKo@GdGzR%))Y>I2=k#`Wt2r|#wuN#n
z@lT<)`{!l`0P^Q6VgdPCwrZ};1dFn2uEI+FdX}ZJYM$<%?<$Tc-t#@~MJbapREDN<
z8bgPmYGz{yRRS}H(s;hd1d&nCH$JDfPiD{etFQs5=ldS3X+A$G#K~73wFUXS1!`?^
zCCxnF4?$IeaZ1m31mrl+cL*%=eA}?{O;EfkI_$-aj+l79_a}fuJl{CaQ<|bzq-a%{
zqFT9SGDY=TWYkU$Q}oL~q%=jpg1>|*Dt^tKDSAPrRcgqq`-jLeV|~+!&obRYvdz%R
z=5MJ3Lv>4X>jjKn$K;f+Pa;g}gQQ|+DgOa5k7^-4(f#J_e}r}0x6ZZ~DQVocwYxL~
z(e|ZVZwh7ONMDGR^qxTeVUSvKvJa^kxA{V-lqTzWt-o=1*0XBd_%=vtUNi;$G=CSF
zvYutnT(wdaNuvQh0s<~qc3B<`FmhG>ZxpfF-h7ByRf2%=WsdAc46%{D$iD;eo$N)f
z1mxsiWH<a$dy%B6t+ytprBF1RFqu{yUDP;(z5HD@tJCaM-X?b{!R34QTo>NhaJXC<
zEeCKmrhZs_6i?swP={~<`UwKORC_SE1pXVeiZ_*NeI`u@^L84g$wmqFF&y6)?$Ac*
z=BZM%HGt<Ki-(F8abG*!TZPdH2r<ad|Mbb6ANlbgk?w=V!D}3zn*8-3)+n64{t4^8
zc;e}xh(U;MRJ70jrfV`2N@~+JftC8Tc1g48I^)@;S_uN`^~T;kQ<Lzy0LT;?2r%_%
zKztof{x_0`^ho563UzO1*qn7?EzS*jU#%)Adb0|N034Q*=}H5E)r-nv>d`OQA=8+r
z&MR>H9oMmjl)J9OxC?=mHptSjAn}CX?d4XsoynchR?gkuYoKcOoe64Tw*5QGW+pkD
z5MF<AhafY$|HJ3h^5Xly;}Llj26GRtkOUX#e}pYb(0fH80{Hu^Uidmp0Z+^`d$$+}
zZ-6f3e2HW`!AGGg!8={(Ap-YuIwjIV4ax|Swy(NPky-XdgwDCY{t~_+!C#IE1vPnp
z{ddq-PAUEdR3)gU++RmvjoV*`f;)eJeumXAw<&P_SuCzU?;@^0$&c%T;K<-=eVV`z
zZ1P0_>ws(}uXe&gKfX#Out`T}PJotjit9!WYpSC&5n+uzI^&Smn5mzP<g?<D+=;Kc
zg5-8+DJPOwLRB*HXA4Q@SF@#)Z~o%_YA^B5X}W$8zuK({lb86_(3DH*SF5IIRr%Gl
z{hG<Irgu)pvdrOE`#s>T^sC*8zl2{+{F*zz+Q#u>vo%yY1Y5G9%9ziMc9P{rV--8_
znu&Zp)|ex>yMh(aZXD~W*<QT`;PuR8@1?|V4C}ThX4~^+jmma(WeV#Wx~uQSA<VXC
zMVtWQ1K?I7aikd9B94^T0<E1mQa%Osr6c9@@Jl&TEWyxz6Q`(YH;D!fR+iTxeklXG
zFQoxpgd-4>DY)X2!M<$`uxd-&f^E&oa;0|5P;shNhi`@r;Zu0fYKmXmhWEjSV4v6#
z?Ax|)c;Btc7S^X=;L*Nd-@bi&WjV1!#DcIDgjf5`>GcgMXd(NDFRNi{MM%EfGWTa}
z{tbzf7P{+<&9^Pu<IVKMz0bcuQ#lvwA3#;ISf|_jpq#R;W|~OjHw2N<ohCk~nvU-@
zQ&{XvPYH3h&e$x&H>u2_<ekuBXe%eiYoIE@IOR?#0&?6=C<K;SL^iBxEh3y!NfwJr
z&YgqB1ytMPN?ssv(bHaa2tE=37dcMU$0`RZrLmd&XY>)x_NOjESM6xA1?jiVN)24Q
zs&H`j;CW{aK4V+32h+z7Ox47Vy_m2&W@_NgzK1LDP0f)K_<SeohoF^84Zg#1U<$s-
zfzQTE#b#*`8YzWsG=tINB)*pR$Uyk#1l%_Xho}d{g~4H&TOchBFALV`#ON^Ax;GfB
z0P(HyY3U*6X~_ShhE^b2`;<hUY0D`^Nn=f2oS+CUz!}<SxIbf`v@3rcByUI9O7(pF
zx&F#UA}xCNEXWaA<V?5H^xz5KtA;~yLK9dnrJ!ZuDkUO`q`4cyQKU(aQtACR4bTDi
zyVwOdkw=F_s)-Pixk{6%UJybLc8SnMa@LWS{lu;gi7n{~8j^doCO3RVnw{<v!Rr(B
zfst!_AY94Q?Q45EM7L_qaq!u~=Y(hOB-`0-A=yN%xi!LCT8PHq44W?P#Y(lpF(s*7
zg##3)m0W*y%b3WI3Os3rQKula84G(>ZQR;53-XZcBD}t+KE@|*^?`+8sJtDhkbBmL
z@t4@MieGcLXWcwmpBxflz@aI)G5$cww{1Py+P2ztJJ`9d#W1Yho@4WRlwC$^;pht^
zoF5Ol?@~1W<c&wey6wr?-oi%5*3mB3kY4>89K~$!V#OB`B4dc%$Qtq@8`%#5xt(le
z{}t-XjqH=~OKoJM5~BCAal)s!vl=~686QR<Q*LKZy{<lq-%FEG_VMC0y@8_%hpui4
zWA15+8hQS)B0_IA<5gs+T>IxpdI7Q@7|7TOw(WZw(|8(fs)<J(Awj|Vtem-OZW3-X
zl}ZZEJ=U5n_#&4?4$nNEoX`we78jhVR{>?eurC~}ads&53%_n|1vVqM)5{HMpsWms
zR#`o94$;V0;tg}lpsAeOy%V4++3uygVGd^u+fw(LF_K_nbv_Pp{gn%V!-%V}KbIQz
z7%Xhm<4pr2t+aI_KeL>e{+l?Y*j+j`J&;nBBXI#%>em_;a7a9Ew_avOXqVJpdA%Vd
zNbDZ1PnP0xBT{8NL<;Fn;xZ$8Zk21g{NArT5jrRdf-3vNB#1DTf>#i#ZBWpS#l>VP
zaKA~G2>ov(mN60f8@<f2rxXIgO)zAcx}{_fG?jBojX+g8r9?mNWpERJ>6Xdy%4nrE
zbEkNJxY(%8+*$pD`7oOzQz|h+f1RK(>Y~EuR6;q_>!QgJn*Va&!1dVkv9Wl!;0vw3
z{5s4F_$^{Mya76$xQ)P4B3=$vI|n?CThN6$C^vj;XGNTjK#M5>X(z-eX7k4d`5O^a
z3Hc&9%gCbfW_%f|eyD^eI|*M8ZRHg4N1!S}Jf)K`BIC!$;X)RXF!{$|4{DG=;+OZF
z-(mhU!-U9pnE#@SJorR@9{g>0c#z>c%pnJu@7Bhjuif#{?5n&m(y1S=`Rl4zB;bWb
z)q!PPbnX4O-Kx5B^BE~xRncs1X=uBekJfHqc?R^3z}NseqS?zfz%ub_^bst_U&1pW
ze$Aa{;51|Q`FsNO!ez0C4{h}hyaDI%mJ0fd)cS)0?4!Z3kC<|NeV3Z8O6Af=#y&kA
z5cjBEZ-D!hux`6L>)ru^tnC*#H5nmkn~_h_cH@fs3&ZidJS#DWJuZMsX%2fl$KSa7
zu!m|q<zbH-{as`_>>+!O*BSJ%$9WP0b92>d{!wTl(~4u}+>QMyN+s6zV<Xx(`-k^P
z(b8$<H-N!2A!$qehVYC1jl0>S8Yk?**(*j0*6u>_hoS#&e;1k9BYV!m9)DSW7RM-p
z>bXetZ2Q_)at#@ODVHHE;$=Gt2<^nn_5r9by=;%cFXd&UI#&DFj^f0Ulm8kk5WDpV
zTT0K`8P|a>gsZZOL9KK+ke)RNUZNLC>`39j0rjq>Ep7zwFBCD_5{Tcrg!W7S5nllS
zv`-q)qP~$r^0oPW*TKC|5U_yQwVs3Ykpbi%GXbJpBmaPv`t^hWouB9$d8uB<f`Z<;
z?%f4Pq%c&pcdzg>sDmW?_iqZeY{9$L;0WuX%2;V^0Qe7)a~XaK(0UOPA_M~C-{a%W
zKHa<w#DT9`eo#&d4IIF#sL$mVs<rv%j^*|eT~C8#9vFzep9!J~Xdf8(U8p2nXY+#s
z+4taMYLk$_^h4RM?2UMYG@L!dJ^O;5eLZ`{|6xPhBX_j&R1NhC33QB;C-e#N<1+i*
z?w^c4iAATuz~g-qOYn87EplS2(n4q|=MMQ8s7iLo=~9(YM>4-^8lOauATsI)!sir+
zL_d(`y2~lC85>iW>vBXE2duuhE~IXWM9d3fIJ^OBf_VHu&xESo!#o@&s_#2+D)xuI
zh!FFIJ;C0+1PDLqIh_&L81N&`i0e`#pX?C2DnInk<Ityc2u0*QgEJyzfpzr5&w=Cv
z3k?Idee|Q18tbH^ACvi!zLg`L>cBz-=h&kkA*%ED@Arr`H+$oKJmJzck4C;CE7#g~
zZ}7xz_fxN)qs-Qf3pt_RZjC4W^g#~I`1lBzgJJ57Yw>>A%YLe(P-CcEB)ezO)9ZYe
zg|QXvnjCYxJ9VMow}q_`uRV!>3@xve{;@BLqRFP>GIfSs<lLy`f;}^%`<qN)Dr508
zSSgdSc(O4OW$5_oVhvIo8_G_M1k&!vW;v0Nmr5ev#k%PU4X7-}lQTw^(MbAtgeu-h
z`mPuLObhn^hNf~FNk4|F-CM9Vt6jl^Cj^mEBMG0!8%g3*b2^6OWU$LtT7G&6{Yowl
zL?f-lLaD6O<aN6b+RDj+<Dn|yK;CtGjT4--jDS53^1+Uv<+PU0GVn*NrE|K7`e1(4
zFYFHL8LXvH{`tCYi$7mu;@9=BThqqB;Hb6ft6~oNi>lZSD*7(3O^elG9lbpd|2AvV
zgjYK36<4iERjib0O?ocaF?h$jvN<r7-}onrksK#+#e1_{pBf+Q8!2Hbl(?W9923Nu
zMg0<><rc{<h`zbi8e1+4=;c-;eqJgI$nF`)yRw^OHvF@D;?ivMPf6tqU`#&cNh~I0
zbtb9w6QClB+CQiLi2h0{qNqKgM)Gn*6h8vvkrBm@;x7?V6u;&!qWDa>u4oFrY=TGk
zhMI5=1rD5uYv^u*8;pE0#xqGO0lJcX?Q{@z6!%;C+IHk4pX4jA)serDk?}7Ar#yCp
zHxl{zux|T>vmJ@_kJ*k*W;%ImhEe?%j%c>yC_$n;ai0`w40XG*AvF?N`3#WWNo3{!
zKz$im={W;zxCKDuOxrI-I@Xd#h+z=oHZzSd*l3?q;*;h!v-_?W^BBS}Fp($V<4L1|
zn$6<kGMvron<(L}V=63DInXy&X`(ZKEGQKl<CRhazK<dfE#c*5aLx?<@x@kfP~0Ll
zK0Y1oqYp1f6MewiTB?c0!aVAyBWY%SF9Bx8&u`}%*8en^%^)7Vit^dNr>s8{M#@e*
z5i9j;jREU;VxUPn$;2kw#G<?Qb><6@9=Soc{fyhZ<D;ANBtPRbp(USj!xa}xs=NfM
zlAU2HKO<@)7Qcw~GoIrhEPlH&2&FSlignd99bMS-M{PGyHc}dP$E9dh8FqR?WHRiu
zk~N~5!?1f15Gf72Tk)4L?8L9RGwk{sQ#GIcc8qPmP1QOu)5K*N*rVQLMZb`@0A6e3
zOZ+xE_%#4pytw(#g54k1ZI8~njfEqyO)2BK7TU$64_Plv%8>P9EeT~COx_cYD?=97
zBT&hwerUSW!zs%0d>R9F_3cRAY}<j0g&hc(bFE3tJws8%+<O&J*onFKIMkQs-ao@H
zW$p>N)mGh7MIK3=(Xhbkd=Da&GIeI+dN}79fF~mKP{_O)efkP-pDl||Yk_69a~v{5
zYGC0VDuF2m&-)HnT4l_xX_Y46j5oAW!)pnI-$Etel;MkG{Kf!q3LN2HjcEU?f=26U
zzgI)J4f>DV<Obe-%kVCm!PC{K%+E7Hp)9MPVx@jP2h&(qeS6?g_HP#(g*{R)lhl=S
zt@~Gd^zA&VijJrh;K%SD{7;Y4?T-8g%XP1saQW<y-3Vil*4ScIj5yEM;@d7c>yLr9
zd^(XU7iN+LP?eZuDV_DGFPKrbvNb&k`>#PgPE=r4e#1&ZqzsqPoFjZrfnbM)+P%ZW
zdxpah>byM!!Dm_({c}v6!3wEh(PNti?k|fsBKtCtpuB^N1rUB}l@W>4Af*xcBT>}f
zsxl(=+}Fy9kJh$lm3L4pdowF@7?E`tx-=pu@s}_n#jm+DB2Sh{cm-}Niks0(aQD}y
znf9^#)u5;lYe=?>vt^>;TCDnBe+?w>JxgEo11UtHW(ws?^n<oow^dp3>N(-7XY9Rj
zL#uR4Yg@1pKf-}y+_+;PxNxl0935&_4i3RZ?W1tvSy(FAxMPQk9>e5aqAQV!_)2RQ
zl=p<a%?q?W48P3sc%N0n65HWOg7|J&valQ9WYCu16;Sr&VFyQsA6LR;DBl(iyVqb3
zn5n<a@ZS+q=Q4c#n*lSj>ciNKwABrNkD~_z1sO7hQt+Wr-M)t8m(JT3a%UUi&PTlD
zRj+_1Yz9>?gol9p2caq;kthJ4@^(>n3xI5#t;tgK5#!x>h?xxHOa30n_55r-tiU+T
zdRQHt2Y)VwW45hg1HP0y(~gUeinF-Q$<ip?!ZiwKahJkLO}LY53a*-|Zox(%<Sr9k
zXUeyStD^=iUIV*@ny}tft=<Mh?qEMawT9dl`~(_Q+X5xSYGY9SDZJ6{TrGyc{@WGk
zPIoT9!RvH-(V_ZCgmTv!i+)hcXUfuMiv3?jiC*I@4MW(E%#a3n^`%$|CKQb1zrvCD
zYpT^z4;)rU4Tr6&)IB{$fwC*M<V`)t7WDeK27ih5QT*y)eN>~u6=P5<C^c<Pei5u1
zr+{+b0RJbDv=_rBt5GR6XK-2B*4_v^uSQG9&U`Kx`-WLoF?P+ATF|$kiSIJ8#$dsg
zkvy1XrR^JwlXwgswv6@K#;9Xv1*@us%6e*qXAr=rCMg#Izkc2v)}8&kXRT4$ZkrS1
zA(9XnM@~{v`WdF>v{{WMe`uh*G=#&o)Ww|C+X<CGToaFi?e;hBJ_@E9H}3ZpOnCHw
ztfyu~MSrK64u?rvj0(3WqSpSe0gbd>fWk$QPFgI>omoZ{s}~~Cv+c|h9#SroeCLU(
zRz)!lZ4tND=|F1-%UJdIpuSwc?tx!w{j%n|c5sR7gc-@i)ullL@HZlUDP3J_cB8h`
zr^M7`30Jb1w?@7mR9$6Rx#mLE04fg{RA$+U^zKZcC@0b*SgBvjK4_FV4$u8H(&G-#
zea1V!EaADof|hdnf*yye#`bNe3eVvbW1gVc@Z6s{2#fcu{3(=<UxKOL3+=ac)khs&
z*hQ6R1!cpw(Cnh>CWm*VXjOSu^n}oJH(s+N)yj6%y2XfU4$sPpP1<r?iNA#9D1LQd
zIV!U(uhn>((yQ>%IG@RA-{fFwbzm=U6V4K8wPOF_=O*DRb#Rkg1M<OY5M$WBQTlc^
z4g{Mw-voCj9c)I8$39AtoWAst(cBvW`FNT2n~fX7y0d?tmyXA_88@d#N?1w-a<fC;
zPj~JJ$DYAP+y<4>*oas88+Y4?s&Qi@lDv)Rr#qkL?;?{$D0`0A8`L6vri8#)@oSv2
zt@vbuv&(5QZSV4jMyQ+q!MX2ps7uNc4fvP%8+S8DHEx)*M9*S97W2T2<M;htWnz+~
zASaWSXicN|VnCX|d9xk?{xr0|(@(n_rngBR7`88x3Ql*S|1{lv$lr~d)v}u`Soq8G
zEsRl%)n_1ev%Q58_gfJC7`uNlghlo*>w(Zt_Ambo_2vHMU*VV9zt9y&Z(hXx7KT`|
zbJ19VjUFIuDR(Z{?8X%{fU9HiL$8O+b+{sRve>|gJ0v}d%TndnTroisz8P=`?!Ca0
z_^DUCTpOR&Yw|;|HFa-4_-4D^tdZC!)!?+f6~8+Ut;8d6Uxs0cNTmTLe8(_>-9>x<
z9>{rUl;DF2wct>3e5!;v7Xxz5ABjC-0xHH>cLU_|LfRsH(_x?wL$8=tF)i~UiXzRz
zy3`i#yA@Q4&o4Avc+R6TfeEwXiw?t>UNPJ^GG5nr1LF<1Yu&^Vz4QwUe&(8Q)3a7_
z!w|}dMSQEhn?YcunRQ%DHA2E-EZwCr`T}Sx=ho?Hs7kg@DZ}VEzuD#~cEBjUGM--j
zF9cm)fQ$Hp4Yam>wXkZtB@P7M2#0^UfW(g$Nx{)8%0d()QhB47H}-Bz9qkFnv{=id
zneH|<@hgd$?i8<>X?Ww&5TLoX1``Oi8GOP7CJ$W6qQ7@SR9gVb5R%S8AHsy%4gWT#
z2ZO8Y%~l_L3aWGvK0plmuc@aRRf+**m!kp&KQ%;M8x_c8!YK$JL^%N3vvf;w0=`<@
zCw{}11g3$XqjfPs#kafFC$<NJ8=9p))DC#t%(h`NJ*3Vdqz)sAYR-%6ipV=q?eJOe
zdQGSs_y#w84ZH!DTVt;n_&x~v@J;EkLOt-vuMadt_?~46AJ<JAQ-bKwPgh{WQa`Qt
zF#wihBe_>v)bNFh`gam9=6*Ibl~YUI09A>WN_R1LL`l&YPekm<`CL8o7Q+IF+z^`T
zqK?JVfNHZii#kA}V$?x<=VdS@n^TjM^#*=AX;>TV!!Y$rX%=TQcUJPIh(z3MNrZiP
zGVD}qSF>+02uxdzaIuQfu-LQUMXwl-k0y3eea`j#Zlp2wdj9*~5z&c~e1`olG0=ES
zxN*<Y0A34K$xJx{>-h>0$dEJh20dKKBIejC5%XF0(m(2Do-K~bOaEc4)UUU9AeqTt
zdbEJ$v@lM9Gb2f!QaQ^T=Be%6qmnh5aGyqOZkj<uE4q?A{{g9&(!EfSWhUoWyl7+-
z<;S6|oJ#)*sCr~XIlRj13l3`IUHzZ);$%yWN}~L<qYJyJa`mHtrF8XwFh#4%)vsrj
z-g^3HrE>M_&A5^G9IpO#XKGjfN%%{+`o*ugbM>DYu>*V_e_=s4riYqiHw_v;J+V(a
zaQt8HY_LEYSC=_cA84vDz|oO0>Xq5?#%O_O0FOKyRPW*Hv%|XWn`bMlv<z9LPRydm
zfX>d0qCkj-2#&IwP$i6)av3S10cOt(v{!}jWQZGF4wcfx4W8$3-0gE!jhj`;8#gHX
zyU65{mOaNSAsRQhL_#pTaf6rm2j_MszerMMT;lV#YZ-uFhV#GgZ`{os)wp4f2@|Ll
z+&nN{y}{pACMHP=ax%%-|440tWJkru4L;<j-3`<GB@fJu)PVv8lK#^`^cVha+^m+}
zWWmB;md6c@=B(~Q>SjA`u*R)I`3?h}QY!t)&=(0G3;?~Igb%(8^=0_rhww{<4;)LB
zjv^fAB%K5kG=Q*`7(^^n1`|%+ErSX08DZt&E>ee>+#`c~DY2XpwEt4wYnv;6YiIm_
zbG32;T0b*rF|U77BLjZFO0$J-c(UjPl>@;+2(3UIr4Am$#^DM?VMf6}2OdNGCbKX@
zAV>gLkmH>cI_d)7YK9|{GQ<~Rdjxti+*vx{vvh3ZT%}wu!AjDb9S7GoaZ!f~Knb5~
zFj)tGD|(V9inXcYIKqda5#a@wxgEk28{*JO6J~(Nbuhq19(nltoiG6KEMZ>CsQ9+F
zI^Q}nRT*yuBM@vG8^hs^mMh~R0K!QPgGYZdk${0d6c4M65FuFwzSPY<!ltMY9&r9b
zi%h1#4_2&6x468@T=WU<VL0d@!hgeq(kd2B6*dj4YtSX|=sf=DukYB1y>Yt5dG4$`
z%0@xkEGs!Wq`@s#gMLk>LL*3paNI2kVK%~PlNi5R8r@h`vu}w<IGdM>cm$D^iK!+C
zC4BR}Qmepa_haxI;ui8_nnWBil&Omh^chu#Qae@CZ<I7+Tm`P^87(&8M*VQw&Pm?}
z(n~Wji7T|_9!THyI}m;egSGkuJg73fMYcJhA%V$E;Do3yU=&_`gz?_K5JVMRDnS)>
zkX}aS0vXc9&lO;pXR0Z*2#*an2gK(I#LONZluf#3^5_wun#_>h7WjP1B}5+gT9s2x
zFYHlFud}kkmYVEk1YoTsmWG&<W+plsfJ;BvcxKTLt31N|yFx6irHIY_pwfc%WqcfU
z2Kr=8>{Qw;Aj(jrX{6cc8Wn|vb!4`?F|+=TOwjXLzuE)T<vbLWDXO%`*m=WdZH*5u
z-EWP7Po6&0w-!RPximn$&T1spB*LEE!KDaI%>TZb_}@uX6%?Szd7%IZnt9I1A0esH
zn5?5VnPczsjxU>k{@r5O@d)vaAPY4;3RScF=W%bxQb%Yk+BI%m^;HImTJ_h0u!ihn
z5ht5fS#$-qN-X(VjyQeI%R_t5p(0NIgq8ZWV*tc8G2(R64K+yY*h{2vAh@P}?IcEg
z<k@&~-N;=s5*7IZj%cGN)$Q#L213PwAXSV@69zRTZOLCo7NohtTmJ{4k`t>}6e9EI
zzr5Jf`IGp8mY+gXIm25Ex3KAx?xQ%7*`vRVEXQc(N*L1mp`Z{Jq6P4E76Jl3r|x~8
zW^yLcYObgv5hxe>C&Abh`pZaB(*1fY(WUga6QQk~Oek<BqzsowxR73lMfozHeZbex
zmO=ts^bB(G<RZh9CAu78$i-b`$d3FBxvD!1S?5@a!$JFI3HzF_%?!Sr#0Q4IZ_Tav
z<u%;WuB(18L6u-p6&S{KAZ1|q%PCq_fnmM)X(uHgt-U0vz_50#nq?_RVE9g8y1ZTI
zmH0~phQ+VB3k;u!xyIRV-rhvyPP(V#TInEEEbd_T(I*Ve0=d@Z#Q4(MkoFZZruAEa
zKOVL14GO<0tlNJ6><5M8ako#7Wx8+M45Ioz9M5dWXVxc35x37#N2oxJAv6-Gc?bya
zBvA9$P+taWz5u^epvEUZI%1P7xG(^5)3(MIZ1UG5%qc@Rr|gDV3l68)d$vOlU5b)M
z>c65$(3&xYKJTA%83*XTWT0bloR^8f1YAi8iK4|u1@p({og^Y2;kl0-)33!%nBeQ|
z1E)MV)ZsvCv^JjV2!`cbw-P1ZfYK46hL}3vw%Ey?4D0=LYkldzUEavfe_EaSWk)&8
zkwW2&V7ptJZvO(U96bLU`<HPlA`Y{>yInEpTPAE%LhWw*uu{KPt1$k=-7QH{G072K
zyOg|u^r#HUYv9ZQk)X}q@zEV*(xv2QKubCIF6Tj2;(tkX>j5fk=6#91_25(oVeuC4
zdM_Y0!-Z(BtFCi&VHZ^vFUm$ri+6E~R+Yu8Cxq7P{t2ZlUcDX}QO#lTP5_b8;;rE?
zVeyJzb7%3Mg}$585T5dZ4=CYzpdmP{Q}pFSo^DyY?iM<*bWca?$K9&A86kS{!CH3}
zt-9l08>RgUU`k#y_x7-E`_OEgxpCvPO<e1OgDzZs@WybI8B!P@f=aNgC1%OJ%ip*=
z{Yy1&76P(5M6W*hsK1L$*>SSxc;!J;7+)<Qh&KYFmth%ssy={3&-RYv#P~TEf7!bs
zGP2va6^QO+xA85gFLxW?fnRF35jTbPPUEEbL68J7jVGAOw;{ACcNt}Q10?1$KxSC+
zU=xldRz~5Pckx|1j22dERmd|D=P)7N<?=mOUlpLWJr1c*%|3Vn=5hV7xT;sFS`qz5
z{R>qgCjmbaRIi1bl_S@oQGq{DfatX`USvZbR{xwTJYeGY4HIYCz+JS}w?NoNj52T+
zV5NRNi_;jm3m~&fu3AQ|9c#r>posHe&?@39hB7Xf@F_@;v~WdFhWi`5<D&*{@@ck{
zp{<-I?iQ#@Ox%?2dDIik$Q6S_F|}@XU+17K-o`!7i;2y1W#b;}=)x|lY+MwNG&b%7
z^LpUeH~bGIz9&WV%GlMDLr>`V^$L+v#;#V2Mr?B!y9a<sY3v@vU&7cGzdAN{(~O~f
zk+kH><8tZbb=2jyO0pa`+qOdDr$XYzuRO$;muvKMUunBe+!q}b#OECF+`F;C;mY@;
z%wPKU>_ykKW{T)n+frT!{garR@7~(Qq8nH%Q9l&Q=9=zv%r)$Sge-TkE0m3zc@;p)
zC`!D4`_)zrYgrn$@Aod_1?<?3Z)Rx&4KHASW!OQxl-qol*O$X}2V?b7(7l+v2I*~t
zH?n}hSRYra={t_w%Sb`JXJO9_fPWZL>oUU&<>!}Qz+_sFbb^hv`Uo~7Hx0LiWT>0T
z)dCT@r~D%cUAN13JG*{yT-Vh#pw@KnNf$lStIbask{6aYw;JHK3WR6cy>JD3Wo)MU
zC{P>gD>pokSg&_Ly<FDoqUu%{j_6lfum1!si9cUHQ$0t&!g;w1l&fX{VDk!vEBL?8
zivUvKcah(?2Xa!yNP}{Hd<?$tcnfR^sSOF)k&t6)EK@`%%wFp&LAE|z_$tbbl*a3r
z&|im~w$SpNy$*~Fe?tvet43=|lk2^4VUljmBRMyLC;uGsB)8t)45{!##a630TE;6J
zEw_r$1S&Zi)cDCpkfj<Q<h3oAiY8AZ=u_-v(UsL+VPqP1ChCCcfyy|1CUl~t{+ukf
z%Ic@c_^q{u;Nm9z7U_bo6NA+0^Bm3XmlemGCB1SOeX`OXgS0&D$3`#~oW)lME*So6
zDgQeZs&?y$sBsHXt<~?-3ax#8_c2zBvpEmhXZld@%xSn@@lLNN>MsNKiC(Z{?mJ%#
zmC`tL3jW634jt9F+4*=KI?wcXk;$PWd*+5BHQMzminp5|BOx$6Si$B`gbhpdYt0Gs
zz%b)l|6tq)6R(t%Bzo8O`x|#NLp7d~88`X6$ixiUb53R~4YgN<5exB^W`g{~FyLkW
z0k|1(TS^Ap=WpE20M&R(2E5tdMJ5Kwo^vwb=*XH8VZ?G;L^FgxG>rL(e_(FLd@v<r
zKIL!R%^1~qO2&N2-$f?I$ewdD=7iXlJHnvVj-r}R&Uc1g-}evK&93jJWY;hKjl0>U
z8aM3f73PW_kNV4upzmy-5mL^?Fxht&hWX3#qvOWpsUD5UbQUN`v8iew>#`-|g9L`a
z$TsW0z+B6-&64{ovC}#m7$tXFzX8AWceUEKd8s1=YhARH*nox*miS+W)_?MjY}3v$
z*oMK?vc}ZME!BZ3aXeP-x6rx|w^$i!7^&RpmrD1ZY3>YR0C9(+7`C;u?3@4XOxP&j
z{BEq&uO|)|wR4<&ax>E7PCjXR$47nhNy#U5Xep;>{zXugc;-_jpWwU{et9`-|8PDu
z5u1N<lY_Q+-~2%+O&y7Rt4MA4(1)<DI_BuYE~<R<C>}l!BDSi&x^Z2KR+UR$&k4P6
zkJt9tzH-THZDgc1hfDrLK%{iZ{|WvQE_v}Qk5^l|NBX5w@616mg4el@!c7Pxc^o9B
zb_WiUXPAY-v{w)`DK|(N?r=~)^<|ea-VW1%wlBnTL>?QJ{smw}ya@Zf9iI#99!YNp
z8HREm8*j(S34kdh(`=jjOa=9hxGuyy4PmeR%OLmdaP%%Gc#P}fU!YPN*Tql#jk}FZ
z)wnS-y{?M|=lD3E&BT;F$14)*y7-2K!0=#cDA^GfEW}ru1M&~UfRp?Ka9jDuL!~qf
z*z9lI%>dPSN(Nlu?;?|pFMH0(0CSpIhTV)WC-$nW-}2M$hUaRDy_sS9ZY*VT=syjM
zhy2~RSuDHBf`z{<-|rZuSN%Fp(j&UxA-XR%tYip`>~}r|1b4XKxdS*N_d9pPFTUR)
z)H(J$<}KOpXb8bn|FlwhX(CX^$o)=W+6*@~u2)8&9`Fm)obO=Ffb_R8?o$*ycQA$O
zWnj)~XTOYI7OGd0XYIc0iVX;>z}LH)T9ML62AW4QL8CS>@4!m^dM1Eob!}jV2|b#|
zQsfzrF^-7kHYi*>i8*P-@x7N+Mq7I!syz_wtWEFVzbV+VCBSF+7CrzVuJgicHSipH
z03Y?h-!h&R96EpNp$jnYtyLebk3+N)uVd0T_E&3!lD1mqb@bU@^ZzmvMibC72=*tT
z5-d4u+w+40$>zt$)bb)n;$IeXBwm9Ne<~h7ZUWytL15wviOj9=aD3$0J)nyx;oWE9
z*I{-SR@pXutLjSA<jVB=8V*rzCzt4Q1c7f@2=MI_-BKo=i2tg<m^VN-Ra{%L3njh-
zRmq+*-HCWqe)gtvm4yho+dn*i{bfOC^jthXr^3L`#UD?S>NM`iVi)G~&J8hNh-C=g
z3-A@m#NlvJypz-G{#y)$w~!L>6+i|7JY{;F3-M({+|!~B6B5C0j&O)m<Sm|VkhSs_
zH+B)&4bWCj@5tF*12!&oF%(~ZeSlwj*G82FC>fXRUO^CsB1CkrOpS1&s(5yOfN$Uc
z=T{ZtBUGTLaggX_u`)yr%=`Bf5Nw#a*&6Sr3KyVx^cyRY^=ECnH+bT<`vcOWqs)#D
z7hPj;*p2hyP-Q~AXMdWYcd+P~Tz4N8MXO1c#+|swOfWQd!bjVbA)-D!CX$!by^~W-
zywz`7UF<hxY&cB1ABF4x;L}9Umlyt-cPjr0Z>cLyR9cX>FHP72H%PoY;CsBY!bVV;
zBW)r75px6|)5YO`pgHnR9AdmV@`!~1U)<>On5bhO78vseC_6mn$OoV*SsnB1m^9|d
zTLhg^a|EALVc=_J7IWlt*piAUSmwyzTAgsXDBj8D$Y;brcnc{3{|ZzkfX|{i;zAqD
z5qzA(9C-@ilgL`;$Pe*Nm+ZXnLt8n`kzYd9?f@HSj)Z`6bHp#b>CKU2&oc;fb7U>P
zNriBtsyGIk$_a1)RSCfPRYih1Vqj+Ghz&DezvIo3Z~<cGNM!wSm?MrdXQW%2iA`fS
z!tY^NJuI*1C9Al!R6$7|9eG8Xz1%AjR2QL%qHbKUX@O3*W;Gg&L1nkb8Df*5jtbqG
zFu@}RmA};?X?uM*g_)*;oajPI8RUGMwCECjUdz-`N!T8iw9|_{Gnl;~6Wf&6>lUn(
z<n>~ApO8q5i4Jt_&WKkdJ!+A)?u>ZQJ3hL|CWY;1prxFO>Mc-}D5_Lpd)IzHHf(>7
zgEo%>@?sJ<PaIv?MU_OOcw~}j|CCZ;d+i9$6t>q+btA1g!uDT<@yM|KKjSYEwimzV
zE^NOQlLJeQM!kVoM~uQfLiL6}c7K}laD&xE2Lb#|CV+1>S~xIO8-?!yjLV}A(V)G^
zX0$44wdH(g)YngdAs$1-do$V(!n*D0BX?LKGER8_%*60la<~K#^qW`<@x6q{L=wqE
zxOG94Fd!{|h7Y8eNc|G1<WqMvq`gp-CHGq_(acuV8$uVr8_iqs+mLx$9x?;jwF%kA
zd;;nmf8*|et!mt?SY#QCUT$%bzl%)qY}s?XUW}seFUw=NM)Io*km%Wu;hqqy9pV#L
z4V95V?vpTeI}GF=gn`RIZXJGwfn2A)(a~Ia3Rs*uvZgT!>1sq_XZwAnVbX+j&%3^K
z5WenHf={TZvxVbzxX>*S9bxcJD*2!;KD#1|ghAhYmCe*U>=#{kSa^<=Cg9srWY2nR
zxSa_fWhLK<mHPDz17+H!*zk=D;D9Qs_@J;0t~4o*jF<NAh0m_kS_8qJDflk@UL9-P
zy9YJ^doM0FOPAg<S`rT2{rd-k@HKx!UhKh3QAUcRH(>+&Ssl@lia+lZw-RDGd6@NZ
zy>SzK&b~5H880?40UI*1Me;R~-;t>ne(s@CJ5;|3+{R(ty56W9tU#a}!qbXWaiA9N
zMy$Y)FrwWo!I70Q_^!!8xcyM4a@+1=vp7cA!FOchqH-6%6)HKR*Z7zk9>!gK<CDOi
zm;kosmx)d9>)C7FEYhQH{+3@N?h(g6n}Y&&s5YQ3b&tfY1?Nq>5OeAgk?Njp@K6U$
zHRr8z;z|Kl5cwWgh)E3;f>?PxSxG%c8;c!bQd44-rRE?LUPWIA6#Ds*K2bpP-WB-!
zI7*Z9%<FQ*xAI9#*tnmUZekPNZ66cj%p0KFIFD!kvrv`nV$-?XaB+=G6bMI(J{Btk
z_z^)T_=6V01^V;`eSASD9(T>heV3cgA{PVx1zVL2=oM3qp#N`Hj~qOTezKqbTVhze
zg_Q9BCsZZyr}Wdi@IQ`h1t~DDP;AHt?qc?HK?F#6nv76SF60+K(;zPj5#*QRyY9G|
zd!Z@ccE%(3tD!0ZKEK@SuSUpW`h?#4YJ?x{j7dpn8o*siNn5&y`KJ7spWiLa(?kJ7
z87HuVb%~GdxRfjOhij!vvadBjFT^rLuzxEx$jK_@>ij70<tTTcQgkMg7-ve!j)C|D
zlI+E-0~f|kgYgPhn1DUiMX+zq5B7_@2DUX)AKVMkb|+YLRg=8NfbY^IuT716qSf+1
ze%Rm2Vb8C<yR1nviTR@jX^Z)05C5^$a3|}OkL1VuQylLObc!`npO`P0MJfM=!QLh1
z-%1U8qLhCvKkDD(s6TC_JRr&(H=*|S%%#&8oF7_*E7)F+=&@cblgcto7WR42R!-A!
z6;vgrVF$v#+5wK&9`6-y83IXHRr^N61DDWmN)3Oa(4U?k{c}0`PaC1ny9vG0fF9X|
zUY#28WP!gTKjgo|A@4xo^KC*|0*)>5JOmOS{|;SxECDCt(Q_o=ILh2Q$4*dV0NBKF
zIH;Eamr|Af^5z7G1Qu2K#BUHq6Z460ga{u=C&nFt?SdAEm$W-?e0l(a8t^q772_}t
z;HLaKHF%3rIXcsWJ>kUryfemzLwS2&C8h?ro%mTLd`y=c<LzzNV_dy@cyV6T&?k!k
z#T8;(8tKZE5moN>%IE=j1V^L1jhaldki5$pEcaGXe^;V%f2V+xH$aj1cwIgORmsvi
zyUP7-f=*yN@c<NHe~Qm3-#P4AoB@A}EvXbG<T%0m3sxr_E{b=uYX6)V2yY=J;Qs_w
z3E&;5_9SP33vC6q?QhAnOZuU~*xEZ7CHdnng8fu}uz%Gxu&t3gc1a=J^V#ZY%Qjyw
z;#bd5MY7d1q9Gltr=!f-TK}Y91q?6k_V@^>*pmhCt^}q<7Ce8eD&O;=6w9c}j>E8U
z%Ivt8%N4hq`JT_dfNQjPRe?aLNcJUIDJhbD1oJ&dkRGK>t$fch@A#-PP0IHihL&<}
z3u{o7sM1vVo~}SmY`*6{2W{~)_C_xzG4tdGM;CTcCDAAznIzgjrBuGBPVUH*@2N9x
zjI`#+_k0J8N9KFJ6Mu<(Pw{K6^F1-gqr-ep-b4rao+p!xF5alf_l(Q(<VAHRpv=0m
z-Wf&zNnist!?@D&U()oku<jAf^0dYhxv7aHY?_;Z$U~DcNghU1TD}sFF2f~Ek3%J&
zW~0f4Ur14wCl?yPtDi^ej%;$Fg*)G1;F6|3)N81WBo}@dsO~Vi@K?};OfFpX8?Y3p
zuQ;@wV(v;V<f9<Tg&I*Xmp_W&f(x{x<U;I7Z@lY`jLC)G%4YVi1PJ11uf3+IFAW^Y
z<U)?NzIbMtB74@83pZrKN10>+R_fO?45qUyxsaJ;V=*a%cq)}#EJLyYX{w+2S}?YN
z7tX**?{e`_sTqt{ZYt?x-;h)ibA;QMlXpR;!7DG#c~HrblZTI~pcyaCjmI2`oV;in
z9by~j+ev#5P5#`vBayjw9b&G0Nnt*hnfupUEU{MZ>TBS*TzmfH^h`U^mvoI_I&Xj~
z53cIj6*v2!DzV4Y`I1m`=gC}qj-b<#xrQ&Ocyeb_-k?DXTa^rm1Pu;ZJ#z5qW+>US
z)DXksEu@71HmFMAPw825;h!aF5b}X%uKBs(a_QkDcEu?lG|1aG4L#IF;9s2|__uWp
zc<s^?R~VofWu<F|U|SAUKiVlS9eT`wY@PD|(=KBC(fk<yb=NSCJLMl@YXlk0KYVI?
zOVc0i|0aSbwZ;N|wEqcwlPa>FsIk8eP5Jg29*zAZR3$1Szs62D+8<(TCrbGRH)FtM
z;kFQMS2TSQzU~g>^P#DnkRJtAy8?NdM5z#WqAy~EI`6_*FrY^k#?7e_PhJ?$$Pf8>
z9P%T+FtT`nE%Dq*7w=sRjd2zah}hzecz~nKI?q0Xgv{)k{0@ti`VI@RC6P-v*kjAp
z^%ZiXVr<lXUSXg%4laD^<_envj+R|X1>4U~P>9&R@~PtfE~QVkUldKg36<Rdp_D&+
zW*~WSCP>tl^o3X{)0UJRr!{A6yLKzYLr9N1O7ME`_^4r=6eV~NTFR+#ABL(#;iifb
zxQyc1D8Y<_w)lB`j~9~|iN4#>g<VuhG>S(iiS|z^6(!JKnoLmw?K(5knj=c^4H%D%
z5_}VXi70{iHFr^h&Be*d@oD@rq&RiyzYxOlwM$mJgV?}U6&qmf6$DKK0bVx<89(AQ
zYTS(wEBQcln81E)6xPpy1s)U1dk@4<!n#N7GY$-x=tnD0h=odK|B#y&dPPwQkck=4
zr?BwKG6t=qe$$6m%!Lrkp^{J2(Wt=^QI?QNu5mO}l7|r45T80QG#2vEcv>ekE~hf7
zfHuS~R&TW|hJPE9FUmvmg%Ya73oNejH}1Z`LN#s{SF+*)<W}r_pTCPt7g)%i<5hT6
zTKr{sjLA&d>S82%_G3)?qicNT@*OM*FBt+O;iacQ-E<gUx*f(W!%KI;uQ0r1t4AGK
z(jQ%8w3DEch7dMjKUBIfO;G9LozP$fq5yc+e5H1v-k2zg=m36MvRJ9X>3(`y1>OgM
zB@b30-XgCB2=A}xMpI@U-tU)V_iYwO>N9PO2|CtvkD}NaYwD_H|ISR<D9irsSgBu6
zHCP1_gH5Y+UYER>V!zayMi2dV?yOmPcG-P7g6yWi9qSo=HGhs{RRIk>2(t71OD}$O
z=aA?g`y@2wTTr=jVF8WLLshbMNar3yT@e@12uJGh?S4$q8BLDG=hWunu;+E#d>dPh
ziD!Jr>XAnyDEP^4n|~9d;w{jfiwFH5K~;i&O1F&*{w(o~kPY+bo#-|b_$nH|+xv(Y
zN(ux@gz{f}C;>C#zd)6da<})E6s@Y=p4O9@c6)kFGa4+%ZttuM^=|KM{3UjK;@8~m
z_BM?cC-M8HX*PT7rP>^7j@>jUH)pJJ2YbD19L>?Kp890pC|C;N_xqZo^~qBBEkE(s
z&`pQoVxML-ZES@_s8kKsQ?vFz2e?C(5})AyRI$s#y6xtXxe(AAn|&4FZ;*XpHXPOV
z#iW+e9iiFO(5H@lVlf0HLw4DIsN`GLsOA4$QI_lz^L`6&IuE5&viHQT*DL&uySHAd
zabxm$w_XqUyU4Wll0EZ<fGTt^1D27A8rcIck}vfZSpR8e-+TPSaDT7vk(6wB%-^`1
z4XW{!Z1{}7i%e{gJ?CUYpHYz!F7%3bnhEMJ!-IeEkHO7@Z=~eG5B!b0d7v6k$%Fs)
zcaez)vge#USh;yKU78dhjJAmVIOOr$eQQwJ4brht33A$uZeAYg9AjAQp<((N{x022
zmtAH-$6uEFXv}I_y%AYD`#zf0yV0%~<clh|<B5yL&=+yh>;!r{bkSS|43RFHJ@6}Z
z(O7ni_Ry?xP)-~)8b5H*>{7EMjf3WxUD7~ohW9Xr4j0!eBTf7K(&Toa%$dmqs61B@
z45+Z2*Q>8CH4cJ@O8T6{+)*D$go`9c;quI;xS#?)4_V$eOibim!dm5$G^`FF!z?^C
zxmn^exXD73?~^y<4H@YO5E`i3hLlPD#mnjxwk=KKQxfP0c`_V6Y|&(y$yQz_k~dSL
zHU!S2yX2=1n$VQb-s2OHxiMY>Rmnzrq3EZ*tWi1u->4j~j8<ARcZ&D0H>l0rS^Wd(
zv5ND_c4N?3mWy}fCXH$phra&G1t2!a8IeakZ;)VP^DAEIg<Io(+A0yoorG8V%b$s-
z`RM0K6>sSy!^F4ZNMiGbY<4MM-kY&fzgEdGe3vh8*g<#Fcf>9io0Xt&DW=nl6aG5`
z{I2};mWkpReB?`<7NDOE8>=+nJEU;%9|ae^!@J?%#<cUCf5JxPPctE*vdBNGxzEq~
z<70}d$s%tLNUtTy^OkeY>5Y`L_2mS~c3z*@KOjjlKC!P@<i^kBWS`jM0ukN<6(i47
zegdkJshrX$=9<e{d}3d45FGFG3K`Bal_LChWGXqzoS#>^&HS}nO`&MkRsX~>WXdDd
zN$SFm4~U|P7k0cO#RmX)$&gMn02N)tn>~Z#NF8o+#(++AX5+LE4m9c$^lZpL(3~1A
z>rWFqu6wSJR6!pEa15y!T)t<|b)Y?No+>rriFo1E3*Hd&2|M^qju&hMO=*QSP|0z&
z1Ruv}h5spED?S^CD7B0$OZ8j}0gfhhz9&XLwhD}S15}1RdS*LRC3+@Z<in+A(qyTg
zDd>zwKJYme25!-1IYV#*wj?pP&k+2M)d`1-;+?G6cZ-4W7E%IUgsKGa4itOR83GsD
zV5H$=JJCJG!GURnPa<m_9C!h~i8Y(D0ecwQ%4z)G0ad#LY}~<t5Kwb)057%iOK<u!
z1aBY+^D_i*N{w)$s(4*~fd7C4oL^NWoFOnUvwUhBX1=<|TPfiJ#H^Ia`s1)t9Az%Z
zyKs~Jklid#wq8M#t;1aFWhB>{H1&60!JrxmS7eoHZTAoQcxUIvgfYYH_Bo?$qEsmK
zm;|}ZZiZbeo$KW4G`W-AFZNP<z|c|!V5bCMTn-@L26s+lmD)jShIzM9+GDR2qyE!i
z@zYEUQYO<61s1>-zLCPmRL_!)RCm%pBp!njCcGU@x@h@ooH6}l<+H+N!({{=g|Abs
z9f_K4IW(1X={OOplBFZRW=mrPEfI7^jUaqZq2REePA`6yyJQi3W;}D9syqjqmFxB*
z$yuU5&a?XD7EQLL`z$do-U6NM9wT%IR3-R#U=tl52MzI9f#V2#=df^xoM0IsHXpe9
zieG2KS<BX$$fR|wGmbLn<j_w>>(~wQAyB5ET2&hOKfA7h@01SWf=-6oE4=bj|I*Lw
z5}t_?;!8)E*M~pEZn!zvhk(fTir{M&zf_JxFj;IAVIN&;fMdQ<3MQsnQ{al8#)~h<
zr<#x+>D=ljg#D(yQ^UqkY3?a82O^pqAJeH#H20paB<=|~WFktJ^!B|-a{T7?errU0
z+Ec}msJDM#V8$Du@Ot#d8=xxD8?&po?-F!I^)^1I%;kD}LyX=g9CK;y4`QPdes$T6
zncaV4b;zNk*e7pf|5yx)w~!M2PeN4!eg{f>El~gj7njNonZQ)G%>u6P;#GDyU75;`
z%vOiWc9dC8RT^1i?V?;hP9pL_VAze3SC?RX&j`j*c6rk2e{@kszLQ@@e%3V^i4GQ*
zE_rK$4i>F~HC>}ET#hHit|SC1T|?(U^6l8-VIh&>Ml6yZvf?5>{p05n*@D@9f>!B;
zpz;{~w1{1X)3s94rIx^uytsUZle<LahBS+<QC0RB_{5}&h8QA^1bM@v**x-(2_9;5
zp#aVmc4M{-VS}w9PRWHv$6()OxFwvLoUAumaQK3!ufSdr3=$DxBUzwRli<uR4WX}I
zbywIl3$_bqvsx(lL&JniGVxwnG8aK5hua<>)5VThGAG4YGJtlE(qt@nm)<e94?9(^
zNA4K=U5gw(`RG!ZXofsb445}S1=M4Pl%XnF3G<sF368Pfc90mqxP=^Ki(7<&j>XMU
zW~;X0Q_dBlU+vbo9y@B7PpeRq+1X-7p4(ogQ=SoxYf~XKE>2+|rA%H2orxu4p&pD*
zdnNHKx#Z1AxRm45Q)v!D+grSYwk6%0VDd(2DyO65T~L)udhP_14JpP?>_5H2uZ9&~
zb5dxhMN+vEp!DmU%lV&qan2%K)^hHrE8}whc$cWmxSZQ#NVS}A2U>mN7Fo{yt*Q&c
z-<Kk6uP#c!44srmXWk$q{D~<=?3xcXrP(v1trqX(D`xx(gFvXHqJ>x~DXEBM=B>~Q
z8n2#=91q+Pvo`BW{yP=B;RikyM-=Z*IL(Wat==$UA~t_6fTn!%=2^%Gp(<5xqMtnZ
zb7}m*CkZ;E{seqZO)S1&OcANQ3>#495(op)jh9<Zb6KP)CwmSq5#;k0sCx9kd_7bp
zFn8cNh>O&Q*fKYPjVxC*@s`x_UfAfMaSAJU>Y4<6u&7c{INQ6dpcY?Wf}?D;rikEx
zjD>$2#dLe7Q7OfA8&=Asn4Sx65#hrfs*DAd10uAx`;sezvC?Q|40ctp?E+f>{tYvq
z3f9g_MlE>qaADIXlRgYL?ol&t#u^wmIQxb*HKD1wL_Z-@<@Hu0@q&(wRFPG?X8``p
z3}YtU+bwY=&{>Z2dvRz|KV-^re!mwIsy%SC<uyUy15M@B(T_n@qCAdhj`Q(gernFh
z%`r%!nNj+cHa)q1iP01HCO|>-1Wvw8dcseDIs>fJtJ6_^?mQ44b8N!sf*fane+1)^
zH$MFse~B}|;@8}r0p1cGcDZG=B(7BQU;1=vWFHf0po6o(SIOOFq{%|5(Wp1FonVcg
z1U@>_u3jx1Z;X_$xELfLK4kB`8fs}+w|)2sp9t3cjNT4)ZVohMW&}BC+h-b4@65@w
zUhz(YtNt>8o)&_V;Z$(&|JZvIIJu7EetdOHtJ}8ZLt6RSGTxQEUSAm7Lh@~6S@@KU
zjb*Vr+MU(RXm@5kGb>p>1(?Gyh5#~GY{&s27y?NM!H&aygb?F!1PG1^fk4cC<p+fO
zU)5cGzJC4sz1i6{|HPk<S8v|yqq?fP`rFmr)sP8HkUBj#Ym2A=o>bwd`wMrUouk47
z4;Y^BuOia{Ltb;T-O|t6uH`IHXR_NnYx`V(Gu%i1uH!VMieZnxaJLw!@IWz4`m4w!
z23~VcF|={k_7(m%xMlFNKpEWcFWfByDm+jI5BjUfBm-V^P8rzVQ^b3HnzcwgYx_}u
z3*1clAeVr$c;-?Bflc$JGEtxPSLqfyuQCgF{AtazwrZTJtU>BJf7bTMgrWYBIgds(
zNH^{%8e`{e=K{@bp11uu6v5Bi{tlkxd0PiE5NB?WPH2I4?pE*;0OWjRE1-ywbGNH6
z($C$Bft=6(V2YLWS!vjUi+qs93Cw$D7N7u!<`U7sq0SzAT$_nI<Onz#Gxdnx0Z?SB
zjy?W814~igbyc_+$GqscKiV-lF;?6uyp}s%cOh%{?HITH?$SQ&s27Hdy9>j6v4CCh
z1p_zAeQB_5j6;9)O%O&Nh_;ThRIpL{Kw|)s3}S>nm>ldckBz~xEZjouzOE+){hgJG
z`?NZH24r%q&f;qwnyb~>8(t0bwge|I<8;?h*G*B^O<g;AB6%d!;2|XHj}l5@qOnRr
z|7q7IczI{@zy$289uShV(#hInLKI9=BAcXLUAvOWN~<wmSYiv)iekhU8v}-RK_hhf
z;OHGP1oaKS@Tr37++oL^kaL@c1lyQ|Tq}xKT?7K>uAF%+k%s)Q!Eed)H0wyZ*QI_1
z6qVCmvlFuF?wTN%Iu1GZk@O{`LcEzc4q8{HY-L2o{pt8#=Yz@ZOcx?Iuqe)M>zZIS
z)=XN}nT|u<OP20qznL}3EI}WwOl)9;0=NsZYJ3m$vAY;=wbaLX^IVjl@eVa-Cd8%Y
zuTy-V#}a93{)S+Fr)~kcFF(8g)MR(q77!P=g_`qb`j~Cr^nuK_PxWOys__VNl54l?
zsK)#8^VHarhoPvP_T(QRtESia86C1j=Q1gP%v`*79a6<X%%#p>Rg9jCX*6yAS}>E-
zt;bjLbNRa_m)o!&;*ct9XM5_L$yCp|SSqt+z?7+;hiQT|I-S|GpsbuKy&SS?D%}RN
zt(N-OZQsx2H`W;~Nv~qQ%aUve=6kBiep-IEpJB57DPu`8srfd=X-oJ@&94Y%ce<Ky
z&Cl=aO@2?0n$LmBon~IARLg6M_bx5JIhgIKT0Wki>$jO)f68ciq@8=fX^uT_a*dm>
zQ4C*dOtLfy-xtjFbY*{4ezw2aWP2ORez=1<+RjLMm{DRC-LfZum1W3$n2K&<6Hynd
z-=|n@-)ix2Fo)CbdU|hu{(jWtZ_r&&F1XDb=Nl-E9YnVMFn!9&JBXye#@LG;bJsZb
zVms2T#T_+CJ}Rv%*jdeeF!MFp!=%}k@^`&b)+eFJJlg+a*9hgBQ$jm|Nz#fT)3?SI
z6AD>ozSr9Ln<*l5ndQe*qo+->DRP?;wE64Q6zGjSqa!RQv!tm(rJfSe4359V2bgVM
zkgswbWODc_@wE=Vm9Mh()Qx7a35iagB5$_ZWO{CN-%sk0e>UTqS%A)9kL%}B$g0gJ
zIy>Y)ozWThy5W0Wyr$PJcQk|NVX<5Q@n{A^R-GpIboQr@{Wr08nI#1BzXDk`{<ksq
zXNqPZC1H$Mwj50Jl{{j}UTch4u}<q4u^egIi)LUKXf{C?3Yt~2z-v<Em)!#YUPm){
ztG8>|JS5Bg$Bc(Kh(~?en2WFVuB}<_r)o5V_an*4cKd@?i_C7X8;(@F{RrckS%A)7
zkKO)9$g0_m&f4wwF*@UR8{g}~HSKoJXa--yLOJ_m(G336s?cPe&iizu{Z-Z|vxGqA
ze;=}H%x}YJXNYDXg<zO$TLh-POE%fEyBa1t)>|DW+mR+Int`3v)Q_yu434~1Dn|T(
zzrx^0W3nl7)UJZEayn|)L)NL$k$7WqJfdg@t6)X|JC3?x@-Dc|@N-Z!1Cc}Q<~C<o
zsnHD1@p4-4OGq$H`|LWws>Grh*lA3<G9G{2HbqosJpO36!R(kea|npMDa9sb2O|Hw
zqZv$Ol06}rG05bYgW_x5u4qW6bI}Z5ik0%g5DqRK(16v;EON|&OdkqUVaSVFgUteT
z1@*v?Ly%Roa`|CMN;HEPI7mz$+@u7J!7V00$Kd8j(?&D{yEM~|<%nkRkXPus%ruK@
zQ^72*70tj-V~*7AM>BX73Fms8Ihw&^-bUM+?mbHODTf;AT=Qu9zd}}B(}SWJxV*?&
zqZ!Z$zYIorAth#=;?WGm=bXd&54?QV*_5VSRx|@YT^Wb-u4kEMIN5CZsmwT>+ieIM
z&dVw478}m}rBXD5jRF2*IxKuNOX@H6lG(t}HI>!ewLF#449>_TD%vZ2DrQRCEBt#E
z&EQIGQL;bbYA=^;^XA=p`D`dE=XB*p$f}#S+*>b0wn|;b=#2Xl@VySP%uy&Hnn4{4
zAh={kGiX{xn`T4ja=PbWf{|~Qpqod}C~_xc)!5vI=O8JXf#j{>Ca^hcnuKH|b+MOi
zdZW>n(JbbI6#igRGEmst15YV)19e|l7j906Ex)OjN`^5YjgY^Uui)L8nnxDuotP<;
zg_{1b1|PB-W+KnPum+#B3Q5*@ZK$<thF+dCtbtvUX${&7Yw!d%jT?$gVGaJ>%M#s;
z;H=AwMIVQvavJMzK~~L*goQP5VbLsCw-FA-s9HiYe3op4H4vW!1~m;$g28xy3M({&
zft@dt!SEA6VGYFbsW7T3tbsU{rffluum;Co2Bz$_bKy^fPb{nfdz!hh1}BN5{^P|)
zqp+vw4{8t(YiVU~Bc#E0^OT^VhyLx4#vm5USi6x8mdEJjb|Lm&4IAfxsC1lS8b<#;
z=V!{it;y+)YCvp@$28d74nrw`fjU^fK-PnNRL6YH_Yh@Bq*HvoTJk1CaD!(<CZ8SE
zqX1mS(&~{IlnPNp6v6Y@HxVd-eko#0d59h11f+%l*yk_YeX^Pg4?KQ;x4()^$Ip4q
z$)?sTgZ3gZJm7DJ`#|^`0>$tSf8lO1P~m}Mc-UV>CNc1ubBdvjNDQCzx4|ug#{y;W
zAO6DKGN8f(W$*)k6`5qfYtAWy+>sa-Z1s&u3AdilflL75l*KcHE)YI8Un={z%3q~h
z=)B4--0`P1BQdD4wel<!Y3Cy`Sa*kuA<gsvAbh1b42r^79EMYY;x^+jJQGC1<1kzV
zPcjZe49SQn3|1ToqF#%^Ah-ya|8(jjAu$*ZzevVlfICYWh?D^soZpmIZS!lD`}Xr0
z1X946%ZTKT$6gr9#2fNf?7~bvqCY@?pQ_jkXOLv0KJc{3YtrDE-HAql8Vd~;tI<$`
zzDgBb&f*qzg#(3~h7xOQowsFbI4$GuhfI!TTzsu#cWoK>2rHZcw8a^WKEM(A8mz_X
zh`i6L-<msUC+*W6k*{J+G)vH@*rpjWj(oovvT81bKu08+75l7xk|Xk72XV=cMky_0
z$u=e|$C9lh&GGF1C%+~tlVcZ<JmR1sCm(0i(K?;=n3Oi{-^`MxZrXntn{H?~5I(yM
zw^S9zcJ_`!e21~#{-}4jUT&6$`7?`rf-m<M>Q(4+_=r(P@ZXW*?#Vs9yLgb2t)o%3
z#;3|rxe-m&Yx^*kYCr3kBgN6e<XBUE#v<G|VEJc5UxY^L-6~lrku%gqKgT!&9zt`^
zD8AOq(z@uQ2?0eC!foIxh7nVQc-kccm<+)qXK+_9JhGT2?497X^_sEWdPfql-XbTh
zS4=MS4g!6+0(xXTJo^J=6}L04V}(DmIB817c2|1WmcGYiWfq_-yvNr360&NxCTx?4
z%hZIdEq#m88DCq%_qtM<-sEHOkQ=sN#Ze(uaUFO&>~hKV1(Zx1t&YI2K^qWLcjl~s
zqI|v$57XB{)+u57GB{I+;dn$tvHx1pR9rj<V1%zB%!GceMQicU5ZSXKd17k;z0r91
zbT1Eey+d+d&X=$y8Rj{%nB)zDmH|PculFjNy46dKtV^eeEDv+IT~~xG=;d!TDsJd3
z6-$95Vo*_ZERyduN-CYDq#Gz<W11pkK7XOnaC>KIK!xSwsUl(lz0s(6MSD~jmsi^g
zYXXvF3?+wC14G3|QwN4}q#4MD8#Gqfg_&!Q^M_EPvhUBuUs~qB&csLBQ*74=)_;~B
zYuo;AGSs#vgz)~E4J63}UUr1{lsK08rA!Pap!Rvl<d{q0Ykj2CfZ9{{SmqCr=w!(B
zW2;T30%U?r-)CGi3(%F#GkX6DvQEk99RiuY&FG9nCVa1p*Mv;Dk7XXdO$s1>EOQlp
z3<6K-)8my;R!;PEEM(RA-^TPf)3Hn`31jn)EeF$lC65QP*BawNtkXKi14o+nj%C^f
znoZC<1)5c|z@JI!KiMtt@Aa|F8@*k_<{??`=deByn_}Z@y_;#4`>A>?vyLPu+wG>+
zBGc?<vfC4kXJ!F9dp&mhPROd+jm}PW#~7V)yN&O4;hJ_k=dsM!VxgS<v16I9w<<JQ
zr}IADXdhyYGD`?#{+~crjrnaD?F`2<r4S60ZHvIPcgZGOc2~n>$9k*7WINI%9m}+n
zn);FTSmvWjG2$l`m6!FgDb$fq<=2saoiZJXHx|buI+pod^fs;AwiG7%g4+x~2OY~4
zImB)>a{`rmEb|9mPV0RM38pEOT_;$T*s)AIjY(J5a~#h$jZ|`v_fwhi9EaTovt!!K
zAt16nMc=Xmk^kMtGM|=7_Jm}PgG`P&D8AMQI}OQn?pWp)tdtLi*0Id<EOJb>)`!AW
z=kGIFgUteT1@*v?t&mk43G>5{lw+A^IY>+%+@u7J!7V00$Kd8j)5ft(yEM~|<v5l(
z?iIQ&GtHLSR4|Kc9m}-Sm?L%j$1<OfgmXR4d@S>Y-bUM+?%fK1mqU$ou6Z>5UdXCz
zdeE^<*V<CnW0^F<uY?g^NQqge__0j!Ip=Wxr(QnmY)Vru>sY3ru8hO^d#8xXjKjIz
zhM?hmU5dKJhI4<ZbS$$P;4h|APq-&1@DRg|ENS{-C*wkC>e9wLg~Y#=NmR6r=$n`+
zZ5z?=)v?SuS4i9ES~{PHpMxBcsRQ{eC@QBPayewx&0Em1OqY2J@dN*c^^3Sa0pIJa
zFh`+)-B7)X)oizr(!~wITu%2KJS{()&oJ5ChUXw@H<aY9;U=&-YZ{tlB=rkRBFP{T
zZ5hpCe#XS>Pf7*~d;1g{D0%vljFbGWlwriH4E9JzhN*y=G8v}nKaDwQHOvH@fu}L=
zunO@DlBV@`&Ct1Xp2oCGGL1lcr!ilJP2(^$(`n4tcv+GOg1!=p%4wq?fULTW&J97c
zoW>;hxf<Z7kPM$38>cbFCjmW8`(pPfvJ>?bR-j2CJAs`qlb!GrK&LS;L+6<`^!hW=
zX-u&{UD<*hr!oHp+QUy{egU7@X-xJsbEh$n8y+hb>i#pBy1SZ=Ok$=sPF^n6ih=V0
z*g5-32j!k^7$8~sywB1vWypU3%+m#EnkxVK$nVI!t-aH9K9aYE9Tq9QTDEaEwYzle
z9nkjUV7KOa_+LAKAP%*?3i_a;y7FsmK<7`MEY>8HeD9~CD|X)Gn?Prq=S>d3Qk*wg
z15fh23F(74Wn$?Pn2*v$&`SlMfO}7p%tOwW9CZ<jiytc}R-5H|F=`CgCW`WaNpb?E
zpzDF$WChiQEb&v%^s6IqCL%(eXG^AZR(N(MmJs+l6EjIs!cgEkTw=@$`PBhzuvdrk
z4(GeNjr$In%`rhn`b`wuksfZ8>^lms^R`dN3TZb{TmvQLgbIU@Rf7saH&I~Mvd>&3
z-b8VQgSO;p#8yb1u^X(ZT<WO8?lA-pP(1?S!RY~|5<C!nA`H|JJP;;EX=@I6@OmJU
z!-F^A6N3lrY3AU;$!sJZ++8mgMuzK?<GUMvsBnA(jAs47U}I$OfHs2Y1+)Ph#I??7
zqV*yj5MpJFaB<S!@kLqgzXrx9tE?Ydyi4Ytw)>iGM#O_JWP%y01(gqBV>%Br#1YY0
zLrkAM4wH1mRnZuO9B&7j+k_lnf+F}4*RR5pgd7f?5%9yKlLCqeUc!L;4rD9LJwl+!
z(F8?Q=Zkhvj*b@V5{r0JD3yMasucFjM9a2mWs|h&yKp=vchouH(>D~K;unrjDKPnU
zCiW08`2}X`5uIe_fyt3q0X=SDax{L@X1k{NvjCG-P*P4{vL3Q#1t!=5gMrCP2W`o~
zWT}@Y&MvX0((S0iPD;Q8)gus?{EQ_vg<_XVz(n*3(UF7v7Q)~tZOs8pZi1$BV6qFJ
z7%*W^GY3pI4%c9IR-G&kHtU7qlps>N=ZjE@k-H5@vei{yU$MHcT(4CJYxThrAg5xz
z(I3?&D3nySFkYm`Ms2b_%zwnaAj`}q3jAWfR+fIBSFQcvr7rWfn$zSLu|!}yNY2Q?
zMDir5Xi<m73*mfJQArY$tZunJDR$p0S(YK3)IE^NXGDe9=XEd$zKEsO!bvS49inEc
zHq5R~2=%~6MdMrZ(D=u^-qa{k@9`Jz4xK}VtJ%3WWshI|_hEk(nL_9Anv<=jm-UNe
zuZ=N(E`Ad1=RcGH9``rE9meL1fdcrJzi_tzsPI4m{LEiPCIRr8a|&RwW-DVNn9n~7
zA&8$!49l<fp`emm42vNXta_yOgC2k3ZZS~dfnqqxUqvP{@S3xT!JpO)lB5Qb%H60t
zou5M<;TnRIeb$P=*aUJM2ySx%c`XQvPatoECpm$%2W>HXT<xM=i;yH(2%|xbdSb}b
zar^dSll!nC9>+vsPoY_^RU^a`#ao)uXuUQb(ZDzk{+g&(j|iqjxQVM?Y);mzji?X-
zwyHJ?!<bu6Iy+Lf>Z!Z^nyxL7Xuk8AgDfDJL87?xPW1hmctdm5CT8jpoe>OLsuO)N
zTxc!C&P}SaQm0!%jJodR9=|T;@<S|+!5p*#x+ucMi}j#PC+RnCYc4}aepi5uS7Vd-
zbl0F&Y0)7sr}SBG`o^C>fU<m$&2&{6VUXSgS+#j@;Km=c9QMq2ou5mtTew>ex|8R`
zFNM^}egb<+N^AKqa#Ud_r8zOGVc?wj=73UZPAvLfra7^&q^eism=k{qh~#tPf5j&@
zCuUDGHz)2bR!0UK5D*W{wcky@R?{Xv0%=*>m<=BvE39v0p}q%ZzZ*C1g`gjM8u4lF
zVxwy6)%rWttA7lfPS#QX1o!(gZ|mminc(Ve;4nyA{$FnKg&?h(xz1w==(PqxHwutD
zYoj*LTX>C+GYJ7Y=RzjHw`v+W7bPUh=RXwlSNp4QLug)wA3vg-9H+ZooE*i1g+gg!
zT$sI4vH>3zkpq4r-B5g^&4>A1R|O};PgTuke>HAi@M^N~!k^Z}-AcbJze82;Jnmi@
z>+H#(TTvGS-QNOg+XUUaK^z=(SKvv4Zo{$&#C>>-Y7K4+&Ve?5hwMcN+}?0Wb%ew1
z;mLX(5j9!is62{s@L&@OgvP5?)h?0@Ih5Ab{aWXS#xrE>aKb|5b{-eMBoku@7vGJU
zdPHXl!Nr=VN&(_2+g$P|NRN9B=Plm$>1Z}>bIBh;Njb6XyCAEEWrH@CV0W~UY~tpU
z`yI3;<JH$g>SQcngHXb&_c^MtlM-G<^$5hP&krb-@T%w&neeJGMM_(9;MFIANRC&(
zg-;BxvZooutD`ViEY>F=q;C_#{8~FlFqG&-vEDqe;ZQ4%SGBB(c(s#T>i8&PP_gbx
z08{6Q4W6a>*qQrE7mF7y8ZV7JEXn0E$(cJhuSXZnrl?o6zW3bzX!A(1F+A8P?-^`N
zz+%^?NT!N<&pnp{eZt=Rg(8!Nh-P1F_LI^MS=+2gARKs7!%Vl8!&;miDp)<Hv>l8+
zR^#g~!nwW`(*70{kaykbme4lnINCnr#kMSfhsHa_lw-Y2@lQQedn@a(7zWK0wyXRP
z@S{Bh<kBq;h|Yit6(G{vOMs~Ibd(%znib@MkbXr%a^jzgvFY;E>r2HdK%ORG9mF~N
zAfzP30Op8DgaFp6mafF?8I?eu=@p2jqWp|fPvw``C}2Od?`+EN8x7IJNE`eFJHQ4D
zCfVxV*P1<X;E>h{i#ipR`|uW~YoS(dg}37qv%>7D4J%BoLhCai`Zl*diF?ai3((k>
zi;Y8QqBgb8-czhXFz9A+Q1cfLlE2vRN;uiJ+XKF`5^Xh~7WmBPGq}n1mEKpb4%fzE
zP#MI7jBJfP?r&J@D?u1Ue<G!YV_q%vn}w3h+j_zDcqIHSXJ$!rQ5+WMCTEYDp(iEj
z)0_%Rjba3Yt+$G!FO*!#u&RC+WCHcq+$38>MYFbOL))wTg}dDYRJelt+B_h>V*O@+
z6`5A*c+G00NID{d-jmxH3#_qPn-byxY<dio{#9;8qC4*~AorkG4NY%4T437vsmP7F
z5Qc&L_6E?(C!h#EVm<~>a>Vr80pU|PA;2_kKo>nbnIf1CLMtNQ1Gj@daYbP-jH!)D
z@Fono?DP;i8DJD1=!V$3((3^6a5bAa#75`+5a_=c6>ljwU<=irgwh7Ob>{`d__s?M
zhE3s6OtrW_p@e?euiA`8YSEQf?a=ClVhdxqq5Oa(fg^%GgkM@KwT}BmVw9LSnMYh#
zyZIqZz!5HPX@&p0Rd{kILUp90uSgM?oYk#WPPS{s`)OZpu~iVAXdr*o7PUucf{+Rj
zOl+Hsp1qx`yO3fwMz4%%WH8;CnS4ZBlrD+1z7b4ho6J42Es{^l(plALZR>XOScP4O
zHkUtD&<+^j&r@gWypQsdOyVIQ<%O83M-0zkZ&KIpHEf~)%ar*jhman(k8-!SeOY{z
z&x4YDvoaGQ80+n0kTt81636>sALWe>+LC>g&++m^pB>8Hv8J-!QH7n9e3Ymj_AJy+
zdI`V0;=F)T$ww*rgs{^7K27sufn=1n=I~Lz6^P`s<3GbEHalidZOo2oV%f&bxH&j-
z0JeCR!2?$qpBTgGW$u}Aa#?N6j3xX`F5PiL4xnvvdVxaxiPSjoL6BFnH{L%FenjS-
zzIm{(<@P){(-At=n98TIUDG(J^0dh`nP_ZiQl-d^O{)GD$ZvB}^$jS3PpZBLPx_?F
zLu+hOm7G>vxfRTYG5sOrd*GyM^jg~M2=k@rV&2W8?bOYqi}VeXnBr<}Hzj>!v#n~a
zDd#f%1paXUB+iZWW#8$lPIb)xN6Zk$+z+{@8=xhNmYrk;Vg6VNv%?1g7wzzwFnd@f
zfHog9^@y$>0?>{UcggL%xIEn4370_jNAL%3=wZN0fwtST-9<M%R%kSg%jmFtxN+{L
zsOzS#oz}KZcK2jgf8=~UHFw9IfUMzI(G>viL@&E_yqFpQ?|3LGCty4kvTA@aERro6
zGaE661i)Lz=meL+oUUl6HZ8>W`rv7Xr8r98D@&K9p=ezjV=u#!2%lpbt&+>FN=!qb
z^E-V<?4_(BW(j%+F^3xiq3?jK8p8v3#JV`XSmT9j`>TuFU{LTi+!|+WM-GTFIEL)w
zoV8*MR`E;F0o!!OR-mk$ntTgnof^g_#Tb+fHSfRkYi|H+{~(dIubx8Iz9K(s@1I82
z8aK7stTkt1$@9)*ynNGpsy6RDGKE2yl;)i{>IKd_=LD2W^G-3;3#ekY)~1@~odWEs
zK{&^}^UFXapLafvPi)@Fo@Q>|c{0w<@Hj*<Y_b^-yb>#*jTt5dxri0%m{zWgB@%N<
z#}|cD{~H+Zv7)6`>0V<wUF;{h3rzYCW!~uuyy9qMTeC*hg37GxfDxUaHB#V}ctgyw
zTbn8>8e>z%?|=Z>oGKm#&E`|Z2%h9r(V;V9e(2Fjpqj0;30{JZe2;X*xt*oY+|P2p
zJ}KPJwxvbKv%Yw|d4?`&N+>k`Vn;z=KX^YY>gxv|2rNu>l0MXpM5tj~NSe&;pRT<H
zmc0@)xTg`(op-Ts$;2L-!EM4!J)+x%%;4CS9M)v5b9aH<fb<dYyr6nOL-aR#o2w)G
z)EU%sps1X<a|E(#xHD`9g?-$fL8aUUa;<~JWCV02q|Vq=)>O7Rs<1m1At2P6Km>GF
zK&ga)L|4g#fP`gJN}K}$Jpe><1oS3+VhD&m%^U(cNsdhu1w2#X--ZSoAFRN0R`xc~
z&xvAt2U$3x$2!3k-)XiyMgs50vG>ZtzYn;dthatY`g>&F*5owXe9n=0^tmZM<@T6t
zA%`HA2g1F5>r;>kHfjW(a(lvGh5KX|uOfNABETx{)A|G_NA01@amwxg`H6J%;YT(f
z#IZISUBpkNjI*EPQ^tg#8N8Y-yzr+r_pB)$uY4St(0QP|%GvpoPr4}zV=(z$KyjNe
zxer9bVe+Z)Bw=#Qq6m;|!+c>%<z_U&MbON@B&`a8$Oj$BmZqR56H?|8C8EB<UWg+B
zYbWeAuYUs%K>=^O>A>9Bfe6D)?1N~_6NM@Uq`)i<jJ(`%uDS?_eYb-UfY^LA;G`hZ
z?l3W`&z$Y=Gunns>3ZpzNplTyKa)uAJV3u96LSclUyhl2M0XDX=u71i3ofkK>ni8w
zTvy>sCUn@w^dGN57d>t{-!yb5d8GvjE-!rvTg0J&Yh|S3<x(bGKMF<V#Pv<cni<!l
zQL=G;$jZoWMrV9w1mEj$$YgtfZ@Gm9INkQIu!=UZgwEx3xBbf)`DO|F#KH8b80#Ug
zhpZZ#1J^@bd`@!POWqn+1KFH42jS$2)$_b;(;F@A+nUPG6#igRnpk0P51d#%E1*=G
zSP2uCX<{YDLuGt&Osu{DMDmH%7x9Trtk~1cO|1H0^S6vk>7P~g#Aa1`-ZrLG6thb&
z&EZR4qJI}7zWGv(ygvl~>bAn{j{d3BcV*sIeR`%&X3N@g9xLK2zrl8N9uptNF|pAG
z)5c+srY%N_yci(<FCe!~KzzjY0uZl-Ckcp6B@t-Yt#v>v^A-!{0VMhs=|cz<E?vaV
zLEv^DI@ki}b$_WmT#|v*5X%nfkaUQ}SsU72*t4gwr#K{|ud&E%nA)|`h;;xwBXMF_
zjhd_Q1mKO{H_YP`a2F?Yo^ZI#5ernaM1QLl)^8PNb~JkkpyLuq0Xr@cyY|~p+ak#%
z(f=0^*EEXGZHuB41KF=kjZLySc-kBwKm1G?7EtHoh(Dc2_`5Pmf)M_Vn5jn?uMmWP
z^i~+c3e8%5=Z?vVv7%=e)g9Ijr!E1|MG4jpDMazcE-F@ml}PTj%Cn7Xtz$orAjUOY
zxCOaGvjve()BRh$9M6Vh_d!`XrweyO*6cVIZFbUpLADjgk{97F_8vIZ41*gebe$0z
zpD*Bh!_FDoeArGZbDGAa>*D(TSQ6*@JeEjf`J1d-OarL1JaysajjSPN0lNJ#M^$6y
z@aK?K<9OJ@i;Lk)Xv)f)8OUuCLXMqOA5xsPc2a#Ln6K$mvJd2E?4u@Q1E*vz&L&OC
zr23jWsr=d-Fx&k`B5VI^3R(O0{H*=aG_uy%NoBLv9I=z9yHzjW^qz|ShK=-VDtl8H
zgh^?-i$h=FbocszQfay?#`{duU4ePkNStH3d-4rpx;ubRY`V*yW^TH>sf^QI=6yEK
z0aL_d{{;9H_XIexv^J*1XKItG#PZX_X|D4(SD@&$WD4v)3k0c;speqipI2Wb^S17u
z#(8xj`#Qct`8?U+3@em3LZ<K)$}xWx?iEU2g=zJ4>!q(yK8KUj)(Yj_ej?o~lm~4-
zh$Tq^V&bRL%~$)Yar1&#lZ6-lwB`z>Qu)etNL}Z>F?9SdrQe%K5{Dr2&nSXp{+V;3
z0d4wc9)cqHg5`(cN&08f%#ZNc(AEoo+q7d~g5>~D&qwYD9s_#|Uqy^A+p*(n=?&mM
zoWj^xZ9j`eC&K90Ai4%_%#Cm=F%Vr0f1@VE=BRc{_YGUbtQRNhMI1jc#s)fd>cyKU
zi;ZSKMg=YGE0o6yyT^)fF%Vzuq?OQaz5rTP3!s=B4w%WPS-&5|s!sYz5`;h_<^ZBw
zA&H@So<hR~sM5!kDs}h}+E+61iu@;!W2PQqZbJMgCq9eE`-(eI`lBo1z#{(}TRMF(
z$(bUHvm7N;>P-=+)r@<5<ry~ft#g^S$KiRAl)Ib&|AUO>PJl%+q2>tqrB_<IBOrak
z`ZFjir|)I%a}7^G;Di<JvF&?VL9PJRSnQIP^W`Uu(zx>l-|IlpT&&IFd|3+(N^-ue
z!*7Xupmm<7I$w@~qH?ml&t!R+^ToySROgF}+hCILbq?pt`HHia^X0-|zNYK)x%nCU
zY?HBV=yH<tMKaWMzWB8_!1*$g$lB2<WbN+!teu!X*3Q}0uSb;i^EUn7^_MEv^7u9i
zT)Zrpw`rlVU!0$_hfK}}g~oOngT&C-4xLS~0qM+qXEHP2HD%0vFh4UNnl@${8)9r7
zHRpWE9>O13qh0{IT~qlk8$$g_$wP?XF3>~xrGQe&Lnsifz~p9YZA?yQEyavVVa*&K
z!k>b8`G%OE;S=)^vZtBz5FR&H+*cg)M<8Dva|E(XZTR~ZbAKNd11Phv)X_lT%WpJ+
zQ+goqBdr{kz79D9fnzm3eHET23<SPdR?sST&OK=GneVhYDB>iy<|+OIqNQJIc<GlE
zy8L;5=cj62<s>YIRjoQ&Wj?%Y&%4qxbcnlI&WBQ^n}ym#-jvD(@C^Vx+wCGq0x>K^
z>H<9_$NOS^GhRwRMMzS`>C1=+VUa9lb8noUMy&xpU84AO&T(B`QismI7(G415DaxB
zYCyQvVgwP;@e;1+w1HCxPTdq;*MPn3aGsm-2NoR4)kYKIpK?x_XHVNJtFNTu$3$sV
ziKT$_gi1<-UMcle&IZ0zu7E$rVQtj84*~;s%G{Ob;N!Y&^VpuCxyT@GUaivcUT4lE
zS8f`etPXF2O-sa4*VMg%<@2fgVwn&eg{mo&k{D;#uDlMm9Po(lIFZCE57~{XyqpKu
zyBUhgIgz{zvg)h&te)25dU3RP3&ffmE;kR|!@k4qY1KpbRNf9XR<MuTQ};!(m0B<q
z!REOd^BKn%DIHWCvDvO{l^uAxwFEq%)y5dOKEZ`~=pN~~TT{7SvQ<<LGEVNymDhu^
zw7N%R4?0wNBfgo(x(;g!>J*>xixTHhXUw^usr%|e9j<JKWkGq_nf^*K<U!dMmx|aZ
ziM(-d!%RKG<bz(M#_T+1Utw&r7@d4_v;(}v%t%Dd8d?mBi(ILK)TOzZ$C8WQOTQG+
zAIwDbIM?7uAQNrR`})Dx=zS5t=>8TMC0EADRMp$*la)wQnul2R$y$O*2@fNCefR>C
zQq0S@1e8j6SeSM(`uM3PJS@gdCG8|UtS)9TObEXd;%7i6N5ntJCx(dG)65~_jrHO<
zT;mZIdgRy`G&Xa$fsrZ3gIQkR-Xh!ygvPy3yUS&nnMiaG`?XTk6+2DEHnq<W?Uu;A
zt!cV?*lr!iv9Fd!VGb~bw^^;*s(0$}t9l1v$S{v$NUv;^)7rTgQ`bW#pM4i_ACJBs
z8<5sqOjUfYtV8NLznDr}#4UCwE}kj^InR{cs4M`2+k^L&E1(FD>aT+*iRx{g7K^2H
znYc;2wm2$S2%=bo+zf>Lhh58z0d8=oxVIAGyFMv}+C`NJqiXgrd-$Yn(lghefGsyF
zwsd%*ubzoF1TAWq2`(VQf7Wdaffk(&2YxRS!a=s}mwlzTefly@nqT(iP?FEWn0?dO
zBKro&s)6euzby7N8(Sy(Wnbc;E!kE0LP)Jcset~lrgG3xh23=s8lidwLZh*OQVAM~
zJ|TLsGI92-0HGH_BVk{ZwkAQN`2fUAwGne}#evc1fJhFEK95ff7_q0B14eyhT;Yzs
zdcnVSFn)GU&)WtlqBH$^X>LfgL{B0Bk@->?>+b=Jla<pChrT8APS^1{vt=CsLvwEO
zu_Gb&#qWR*K2xQGp<e~0HNlYLa^;uE@XmuFI_GCF+cdY><!K+8A}<Do{u9V;6AEnr
zd2lFn8azoTWNNbjLMDi#zA8gr2<E|f|4rm$APnlcR>GjhL~*!0S{{a&-(UtJfYA~W
zrKD2*?Hs>?x&58fbcW0jIO-X&>KR0DPM^zS+F=J9Op3x38SfNluFS+4f=1gg6I}4f
zJI2gIqcYOthDLk6?aKm<_CQHKdt>%h0~$?2)~wJ7dtNX!8g|f@42=dMb@J$A;~hF@
zag(D8J1IdURF6PtbXh>D1dT+W$OMgq%~9H#0~);xh~&`d-T1_y5qp|BXmlc3jb>qw
z9~iAk@)tqQHeeA2YSO51`iZ(#0%3>rSIP{15*VATl72w+F`2hD(Yb}q28Kr(;LDqO
zt2zLOzA77(!8i18kjZDBbU5^-fV3tYQarAF5vl7u99j`$wP|2AFr<i!fuRoqv2B8(
zdAkG{S_)4R4C#6-ppXgSSl^UDNU#k?_YWfn1A)+y*T#Vm6f7Z7;&;`zRsq?`eap7t
z<QbZoo&?M}jHq=&pT5ea+Tsk|`d-<ly=&=<ON0sZSBfngGqHt`PcLTb5q%&8`J4!b
z5q7&Y>l<**X&d~&BMq?h1X9F>CvHoeYfm2c@p+kur*)@iLMFEEG&}0kT+#Si*AH!3
z`v_|fIy-{TEV;Q#9I#{adaQ+GG;1^LbFKPKPmK=I(l^6i$C_xCpli5kLky5M3|Tdh
z7PuJ}ZGsKck~YI$;~*{>rAcYc(ihTW!h(G?k+q8GNON?u;;9~C=kq(C2p691Xq3)z
zw9|wOvGWAt!V_51^xkgFYDm3|cdB*wLy@|gCo2h(O#S^0m?=|#@2nH}eMpacrt`43
zeR?-aa{|8?O7cMoPbc~)WYs!RkQ3O|g%X{>f90Spxext?mnXKGl14x1sKQQ48jb3a
zNu&K;ie@@u2+TCo5uie8YmS-Duc1ABrt=$oVly4~G;=eZv*B3Z<alwgFxjjPHi`}0
z>ctM2?}d|o{<+V|j=4{AS#8XQ=uoJiQZ{Vri|A{8>BV%(pGaA^)z9-;H~$3cFqwC{
z?u7KW+@4Zpx)V}0rg8$dtMfCJ<HbzHqg$rQ)aEXV+}PY@DUjdh+~t{21b5_K1W$7A
z;#Vp$n+eluXbaooDwquremU|zaDMaZYgzY(^=|0j<Ao;pd8w1LbHCWhqfztFE{{|U
z2X(tg$_?BSHxd;K^|5lXJ`lmCu5yE&{Vjuz0nRQoDNx)PMm@Ic=*F|ftPaRktg^!7
z)at27n(FY|h{<A*@WUCJ)lJi7;Hljkl;kp{BpqJ;AIiij0)D$NQ;#qqFvzEFEbJ`s
zyAA1a1HU`G?aKoE4nRpcf!|9YYgXWgHp!klB?7-m2W`o~?`B9H4)zK7RUK6%06$cZ
zK;U;{K&b@$M4u3S+K(1#^<P+9rL8%D--m!m4*WihPYn36r<ntOy|~9Z=<e^eF`TDm
zZ3EWz@PS<`443}<Beo?tzA2JzeJ6qid^6rD<NY`=IaxjZXzhzKZ|mmiad&GBh{yEl
zRxBZen|n{>k7dg;_`SamnS3@&_j`Yvr7bA}_1)cS+ot{&+$($sxDwu?L7(svb}P(-
zOxegx?)=y!(><?rqVg?dV&_5c%2?k>zNJG^7sI%p1!~*GxTgSTImSH;o+QRKdY*u^
zhsUVac5DjH0XX?QGBFUro_S%pI->2@i~w@N=FMWgStwU=y8?Q73vks2ZDU~SBtd4*
z+)5kI^J}AfYr_l~4&dx&BG+*5-#4pkRu}$Pn#X<mQ|kEJk%>cu|E|GIJ)$>3*PUVf
zS3`Q-`0r+K`?BD_aVW`Wq|8~Y;XS_%vS!79*k6P3U)e!hGX5(<>f`~|26cr0b~~!D
zlak{P)guu9T^Ud+;XlziGT}dAtCY6pz<+-OL~{K1UVLKsk3G#C{(Bn2j)1M7$2id+
z%h(3?Tcbt_PJ@CuapcF215%B=k7{p}seTMto2-<6)b}Zww^f@y)JJWy9dc8M`MxRJ
zl>zg84Kn%cl#cnn!qT>j`F@j!%wJ?CGYjTZ8c}%ysp~xETW<A<WW=Xviy^*`1FdZ$
zzV$-_@tp)u67gw$PT)NarSe|9LGH&8JOfPf4<uX|<ev^WL>%)H+Y8Ro-nCBLUTgx`
ztE%0oUU(OpTp5Woph?L_!XA#uuQwwm0XTOm5o@5ij)1t!GO>j~+$ET)M|6*w2XVtl
zj~m1lz3s~a;tEib&p3KOTn(~j1##E~gF)Ob2W`n9?zxaUV^>&Hd5)tByVnqiL-hy*
zaTf-ZN+3@3iA*3)m>{LCIY8W>1CboWy&azzh+|JP4B|v2jy@ZyMf^C@hC?kkh+`Ss
z0C99i6M-bBA;EK}g>#_psl8FA`6Iy9WPSAGw-3m?(}~}Rfi`~A9b9cX!@exrl>xtf
z0W$eal#bs%8<5s?hACE8K7-UvD=^|5H*Ku8+^cAd0i%b3);59B@1O|o3R_UHfe|On
z0gQOhP{2s=42JhdkbQw}upS1CaAPAYP%hdw*uH7u4^K&@`r2}6KyqKR4f^!MAkI$I
zE#T7<BGw6mrgG2f37NP;DCjuM)Fb*r2nu>0vy)NZvoRESVQgpbD8!x_>+O$vhwEin
zqUX=Wdc9W1ml!Pv*6H!FTpg|9zaz!nlY4r1u|2Qx048W;`!dB@IVV%YX}{~4kjb&%
z6<_PBrR{h9lZ5MPi4iK`@(?_7u5|Un;}AwhX72=ptk;ZJ);nUG^%gm3y<*Iycg|SL
z$HcG1C5m0qny$h2a}>IOl4-kvw_DsX_Z8?sG&SV!RgC{;0ea6ht)$^j+yz-RBpMd-
z7mc0`MVC>KWzkTy#a4*rZH&x#h-G}Q>q(`h?=xRKG(_EEh%*@qSU_(yb~da+lDUDD
zQHU!^kr_4DPtY<TNN8WLqN!WG)W~|#6p;nS52=FS$T8+{^PmV>(97RwRJ^XUR4fIK
z2-~FSSR~(Rl)SyOlyn0n%rq)8=JOXC4Ucq|22@yXmK6~T=#56jr`w{!i1KRdtLfcJ
zp7%++ZR~uHnQh0;cSjm;{46`YNuh45uy@ij!Rf#uA9}^4G{eN9H*kizjwPMag|GR$
zO#|k)J%kqKV5UrHp|cyGjzfCfK9lv{_US`a+K%^Qp(LM3JtNi0kX0M0f_A*S2CBr3
zPiq{sCHI{py*x?K=p!6e*hxvFQ9Uwgw7*M{&qM&|Og<AaJ5k!2!)G!I?cqL?J@~|Y
zChTeEd?sh1zoJ^)Z(N`jv=OS`cCZY1ifY5JvR*9&B+^Nnfes39dJ9e>CpJq=54~yB
z<nSPfN=Ig<Ve>m;ZkKsm&!4`9v;;QAw^L=>>#o{Tc?CAB^PZ05QYD|fD5R*3`9Ago
z^=<k--U>x<-^X9TlUx+?YLxJX1nDyj>ujUD;50zr1IYA1|Hy82k2olUamN+)ZFWsL
zbdp9?h8;wWXvk#%h6bXmAmH(SoQK2K_~I?)277>egy;+@%tKDgT$cs_-%E`Ww%EMB
ze6^b@(SeU}(X18zeyeb^=h|ZqU1yFIv3dL&U*nZ|uv_3Cg2;FD6fp*%Re!Cts>3_u
zpU5N)0*GJ6Og+NjfM8~LXVlM;9ydVzg|~fK0OC)fq?`b8&Tw{sh$hVTWF!K_A3JDE
z28iGH^2F|eH0Ak@qY67I0Yp@fK!EtgfKmw{iasHXlD|vS&iDhesX|+G0L0B8J`NDK
z;1dIg>}loz;(A0<EV_i_8V$Lmc9atgLbf)5AB6}O_51cjEuchVWRSm=oqi55G%t+1
zR_1MuPalk9+_P8Hrf@gZxNKF1)wD8X^4TVRHLb|fw!0hZMR~}4er7V0J9&HuywZot
z2vXO1D7;ibVN?s#MSwma3e~45i^1M2fYLT$?>nFf4tw7NPZIXZ-X<Wfws(tJ4!I9X
za0`IPRmiwNIJ;px+Xuy>nBe(L7MRbw6)HmxWg;FSl7!v&<3)mUGhh&adk-n@#bMi2
zE&_fg6Hf@WeHt_Mh`y14+J<JwcfS>5@60<?*5e5WPkb8~2C@dX`EI5L(qi9}kjb&w
zhp+W9MqBKg!r(S@MxYjsL9O66^Y9DwDYpXa5Hvlw%`7O(XXs56WUQwxhpd{HGBCIe
zniLy`CIz?o4dcJrKa)|Yl$PP*j|t1+;&-H3y)711iD{iOBX*|bkwx?Kf5Xut8}yDq
z?|{DlHI}rJ)>nFIUHyXU0k$&!9Cj6n84oI{zvz2*9EZ{__3D{THuaecnL>fXzzhh5
zuXUZ(`pnvd1#)On7p*nFSTh){)$x^SNa|XZejZjzT?mqBK7%2P98<^iE|j_=eG_Z2
zS%A(PPY<d<R;>qxtw_5%P&cheV<S=9UW6*t1DlQcUXmLeBqsMGDM6zj#RTZ+M~*Z{
zCF-N<Np`lNo^+n0O*-3=4MtD$mpaHh-M<I)PnwkC=odIC{S@!Ysd46vC{v`k#yiEc
zcSG~_{*<hL$Osy+--(&h25e(%dS}<+K85tS-7JrK+oyNXv~{>oLP<GCxGzFht$zls
z!@0U=qMPMo4%(7C=7+pIv6Y|PEbn(zVJ9VxM)k;~(f%$)ZWe)I1zPcEA~%beHYjb)
z;bvK06mFIk_{7{S>}lrQET_UyjFG0QjlysfqfS-f9y5Q$DLAuMZPpJAHb(YRs90AS
zZ8%^~)+U`cWk_Cs)Tm9?hl^XTgav{4LA4{?<nV6o{;15@1`tfL8S}5YJx%6q-8zl#
z8jD5o<+hbErqQ~k+7>+*lW;GV3K5{aT;1Y76r;|Ujm_Z2*$kO{rcd|coXyf|UYy06
z)TsfA*7^LSaKwq9iryRY(7S`v@NT)jJ8O%m0iIOhqyEAliQQ}aF2K`NxVm3c8{2^2
zsN7l=O@9@S8dbCoZ%j^1)auQ_#(1ILym_+LEH>DsitN@*UURbDi;KaZ*4&z|x<TbE
zB)aons$-H3MzYIFkr{JYML>3&E~`I;BDl-yPvJ?rtlZ{D_^;L`w?hlzAeag&bUgAm
z(3y4K_F|LA<W&YE!fwx&WNQ;>{R<dCjK%HM((s-ogE_Qaj_Nk=Ao9gX?8l7c_?l_c
z3T*###rC)tY)W^xeJB%$2vxryGxdnh2L^YB7cc(}>2ag#uXx*+1yz3;O7aaYo>}jc
zkTol+#$IiEjS^Ay7aX)Dqw3E>>SPFFLuEqMk2$KalM<>%^$0}Oe-}_Hp=!}5L|;xG
zF>wAzs9M-BrL8$obu=na^>O&bP&Ip+IaGZDLeR-ZvF=CGM>~-;=4%5z)2$Vf0_Kj3
zqvVAmfdDk>g)-2afT78%=tslPka=6x=|jVudG_k1?pIWxSAVOJr2f|7gS<vID+BJm
z0y6oGlMcAH2Bb9sm*RBgGNi8afNPloDvaT#am5Z!>w=237|1#eNNp2j?S~>b$hr%j
zB*;>lEPxf=vmsPo15<)wFsh${ybA<V$86^-gV_3nQ-HoCs)xOVDivlk2m;MSe*y;G
ztr*l{*mHj-t`O{b17_+GU0~*6&-;)bH|%-X+rBKY=e<yp&$5_3(^xM1C}hnFd$6Ac
z!=Ar#(3T8){sK}bk2N-yA=vYvqY67I!5&nPK-lxzfKmzeh(00uZxHMemPTo74%qW+
zAd>Id`VBrY*u$P?4)#F&KL{GrXQLXn4;VrP!X4|aRrbdL%##RrS|go<4m5_b>epQf
z%j)L|HxC8HDP1gHw7T`g(5L%Km&<Qw?%ce-36Xa;MZFVsxIYUT+Iwz)w0Wf17#?ht
z_Y6V{hl`scnJVf%_gp&S3d@oUMJCPJbL1YgFO+u3+Ga%pu)&iWM~<~}SmVf$;U0nk
zy0je(I#%QB5(1WNg|vsu3Z_ja+n`sJ)Y*!;TvN!RvLCAbPnYDmV3{AOs-{)Wz+yOh
zR02NsPEBbsm^y4qAJ~qnetX2cbZF)KDqB{mjU}yFo1~aFX=1w6OJ-#&6k$uMvKd~2
z04{{Az>ic-*x{|B<kkdUxN+YR?*yQrbFryf8+Q9E(1LLq!%Z2Qp@y5vz%2N=s9qdx
z7V3M7%|opt6PSFcwHQ)~$fAetX)T&KuxY$DGC5W}RC)XqC<Qi^Y#JUbG#ZC0kHBw)
zpKQH3oM-#|P4e>06#MN`?6+$yyW3m-l!*P+-YW8l-Eu(xk-vgKvA-R)Ko>iAnzSwB
z<Z;(+#I&BSvR0Nt8{3<c7$XIrn|ufgm2(qr#Asep`7nG!V|)=H0bzQetFItdgXb<D
ztIgb**8i+x^AwoZM8lKyI;_jF3nlQ-4BE#C@03uUT<OBimPr}ePZC`M>{x@0rUKXp
zxxcou95aDQg?4>hw#%QByhDNw8guN?s;@PB;=mzo3@z&Dk6-%!Rj8E%rT@Su29(%S
z8$gL#g{Wab49#RPkG%uX!ErFYuZRCNmb4b&vS}ICVGurSYHetM<%0zpe%p`VQM698
zjf6z>%!%-ckA*&9L-(JUv}^>E+~|)sZrlrz1@<)J&ZDJ9dSUXcw@Pn*L2`HNjel_d
zsm$AIbPfwPw2M!zw%NX<<ra5X>-)5I%6TjSz1EfvHwr$@+Ncc;D@rERvwDVm>2L{T
z0@YJatGOsAQ9l2n*uTzS#e+8DC_Mmul~<u`qpi-utiBG?F687W&)PzvIx#NH-YD6C
zkBZ1=_=$A$;dGl1^SQ<fPKckXnv4C_xOu^=$-)bNTGM@}G`z9^sq4J^PDF?|Y>4S8
zKm$%bJVjs3hxa4sob8R5l?pVOkCSzHlH;UhON1j&IJb4mHE*8aAL!&y$Zj~t&^~hz
zU9}y{!|?WaYLzUq94!;RDxJF3uT$C>poYbnGiJb>{X{VEro)cBS7u@jIr3VVsYi4M
zFmyA#e)%BM<96h|)7!o*j=VpIl5#ro{uZ*TnN=%jS0Hw_U`O6t9JD1n^8N@?XLjU0
z;HW}JPuO$Fk%#JG<3Ky<C4BenJprYXBTw`Rfl-nzIFdpLRTvqitvMWdKLjE<KK&6s
zF?`CN+Q6p-{PJSc6A1&s9KsJwA@YE|7m%A~bQzT9U)elV0Cts52BY%?OwDz*@S)Pp
z2FOJ!a5}^G`}IfVD%{Wvw`Eo#Zr_$(P5^}C6Obd0R=ZVe1TfHFDMP-fY?5eVF+Wb7
zC-b(Z=~{8URW?Z77|t((XbQY7l6mQq1~c)K;31#ND(*#+11=X_!j(a5Arl~34JNyH
z*bVp#cf&&}JaC8IW`7l#cG&TnlWmBOo{!=zPy$%x)bN-vmgvcZP|TM~IM?|b=f=I)
zaLQ7JGwd(iEgULb31^|`%c3png=)vm{;DzwiBphMNI9lBFZ0vxX48wg3{)Q!a~eV<
z;-_NK>;2WZMa`?p!V7;|bBd#kW93MsuJcnIvEr{rqr~}*A}%(+=>lTgoZox^is18`
zPr#F$-{=F7nA{u|8}(GcV!<{TNM|Dl1NSLhxg8k*6B{(#(f(4cQH&-E%uxuJ!QxI&
z@*CpCv2XxjU(w|_gfVv%c8MO4Q=+LZRw?ge)Hngd%pur@d9)>TW(Hgk#Xl)g7^jq8
zgW-Vd#pYza$}dukfZK%#&k3@HicLcrZqiqjh8VgjRELZG><Ar1AqL67E|U=qmIODh
z)d2O}(u~Fn)xsXwdIGnuF&MzZDm7~pQL{Xb?q9f-tq=|EFE>j=-MhzX!+W{x`d~e0
zwVOE27xNWM2*$clYkfd7m<cz+rB<HALisEzaj8e?!M80EOg+#iR_RBIzX@gKoLc=i
zWYwltfk%q5r`waO#5Ut}f*+5pJb{f~w`~q+7K#9H(dyO}Q>qa@A^&=gwthLE>y8+T
z=b|QQnHN>K4GQa~6yi#@X@O8lC2w2hl1CTh7cDJl{7UGFH>`wZ#;dB(htL2vSpR_=
z3!yu)4x%lNL|_%c^@A%YwP-t=)eJ;e)Edq1GIY5;b-1;=1_e-W)0b87E=07Xg$Z2A
zua^tWBKAT!ri3vginkQTC&r51>=}ZZ9e|pLYpjo6wqwWD>>BT4qd5>=*C=*l&%)R?
zhJD~TUn6x$>-NlJrF{b%U#xb+(Gj#b)f$-ov3jvEg0<o{j6HB`bwing2Y-K9qbc8U
zmhzeAsW*^`4ij|}7R*hQzTy%S0C*gg=ALX(lWeK*<Tgt8kg-UG`b;6QH$YK24b@qY
zRWnp`Sv_o3wRp?KSb4bIgq8CJu#k?iq7U6uc{?~rDlR*v-!mL*xOSFX7^?+ftWY4#
zSe@UtW-7kgQqE!#kf;QU(7NDK=#_Ll3hcm;@EZ(4?=OZ7(W?6_GmFxcV!NdjW_-bJ
zRjDwrYC54fu+u8U)GQkdk&(rknJnh9_V{Qrf*9l+)oVy&@Th*Xw?)}T^>NnFWS*FK
z-`I+B8)Vfw%k+%uOF<{4aApm71d~P6u~bddJM7MXz$-snBgvirM$FVBCVrrt>F)gP
z(#@pY11IsQ91K5qZR#58qFq^C>>#oZqMboHPS8+m(ta*i$c~4QdUF0VvQ+>4J1;k~
zY4hJgSvgJr#~|ypX|oLB@z)N5lh*{^<z<zvIJCL<9gZsOq_if0Iu^Jl@VbCfX-z<M
zEP-<U9h24s#PnRLe2z7N-vE((P2jiq#MT7Z)6A_2oE$>~{-uHAwJEOd*wDag8!H5t
zCluMI6`yy#U}dbOVw84#QRd*ty<jPlqhOU<rF#wFCw#znfeAlc=56ht&Rs4Vx8iXF
zPSd`I@sjaL-wU(CE`m}hcjjU(g<!MsPBC~uGAY9X!$!yyvcRy}U%1;jONFaJ%6o+W
za(@+>eAm3@WP>D>3%BQ-$XU?Y1%_dN<J?~7K~7of0>jPz!rj85!j*8;dIAmT>V;CW
zyZlvU5)!8%r;yZ)0IBWMmdFzKP`%zyyPHjixC~T}6e|kEB=J+R=+FGsxJAvY$-)bN
zT62Lx+0V+;kh;z<FdUgM03`>UP&CHY8I}RfZLTvs3PtdBhJS%4xz6AivBYwNh;z)A
zNHi;~?WYpF1S7Hn*&4X&aO`%z>QEgKPVj>6Fyj+w@NK51Q#$tqRWG1e^1M&^2WNID
z1)hCb@yu8rC<y+js|_^%<6_GmSc$3jM>X&(*7uiT(PkLDc;Hto081G<0q;KSRqNKX
zp^G-+`yVBTr=cb#qwnUBQRO?BiTk{h*tKa#37na<Ud24K(L@crvgmArg^<a@nB4WQ
zmc*IAR`Q{pB2)u^(MAL3d-UOR7eE8R`GosghGEeN#0{%;yNl88$?{k;+6`-SBO|z~
zGh8Z<fdVjBHZ&f+&YA}FccXe(X_yM}ECbOFxm?8j#wuxq$^$N9DACX<40>GU&hvgC
zY798dR<`gs4qGi88sK1=71g(4h;BRPjK|fczx(}do93cfFlJ(V)1SA(=7IpS%S`TQ
z1unM=^xHG??I9J+x3^HTSt+MYV)F2*ETrgt3q8u&xP+}*Xu2{!*#M<1Mx*6wxlsZi
z>h2<}Zh$J9>WDp7B<b%~rVNu!R>c?6W?X$4DK~}-^^xL;?6xyfw_<5;CLz(H6dAN7
z9+tlIdRU~9tGd>jE*!kz9UMEe*1KW(7kE^dY}UrXwy}lbZplPif+|85inPnu?;^hT
z8*LqBi$RkOW<|_J<VJtD?Ab#DyhvA19-aoOwH|V&#eB2NrL0eGu`&mBFRYPuuT!(K
zEtu@Z8iR$ASR{F_6?0Wv4RF~9o1a<i!*Y)@KaZ(}ukYhkPy5R-c7V+=S6JDw151=+
zkffosS=ky|tAuf+)77Y6zb6yx&0c@Fhf$ZAt3_%JC}81fhdRYKq{i0d^`}Xz4QA&F
zTz|U5DkP{AVa@LKrx;Df`qM_uKd*TX!2q)3);a@N$1yjTyb4K;uiQFvYkllB-u7kl
z-@lSIJDEeC)u;y`Yj*!V&hqR%Ci<eatLZrK(^eB2rB;K!N{JbZQns|Rm<udb1M?kT
zl=`4ojP`;7ElT}8X6g~n0?^phMX9ydRbdCnPE8T};q?Di6SyeEqd90H<X@f;LY|cY
zYgac#T{m^@3|i6BDuj%11v_+<F20Q{c^OO)201uwedZ>Kqp-J)z=ijlhVG<L?Tj?n
z3fSYwD&Du|u|!%Idcw<ly$hv=t^ZdjD(4E=e?eBQ2Ze>LcXgm8Ixn=%4szA&Ul@@v
z9L?#9c4~aU_qy-j<n~FLZF8+XY9e+C;I~*f7r<gIsaAd0xLLhvhjcNd@0R;DYob|#
z-ibVxtQ*MC<Pf;7?h-_}C5wy3yieXQnZ6Xsh<@Y}%kju`E|!HNohFkLrcfpkl$En@
z3{06!^s_!q8kS|d)zA_bh;d)KEe~^CNnSzzjMc-E6;w`d*Hk{8qRW_+R*-Q(2wXva
zIG|KoK^CK+a9f(K)w>mvBH|uMH<K8ja;zZl1-bJT<S~3=E6D6==2noO(SQxggE)f~
zQ4cWk{P13wllqsEPtpLPaJwg!)W(|fX=!EmSx5ilN6n5&Zlaj(`I4wf$csQ|`ha4p
zyZ<QK^JU)F!RcB|P8NrKG;NCGC)_U^>s%CeuX(*5GQlK8t$BIlCp_q{!oA+bt4Qwe
z`U34CPL5ij&9V0P5kHY`K77FDgIMgNaZUVGdifcDHEv$;YO?UcpVnOaQ|exM4N}+n
zwZACMP$Vw`Dq>@cfVTtjZ7u@-42s~3fWL(&xd`YpIbt>N__Q`@%YuT<FwMIYIUcwy
zc-(fd|KP?HE==%yG#W6cVyibe3P`_iKuV>O^Q%5nX^*koU-J|(jKIJ-L_N$vjWxo%
z*`imoI1bl16zXL>!C-Mq#+?<RpBfm%h8+N4OEus}?}h~**zpgCrQ^Ao&v%G_bq~s#
zr>QtC)M)5=l_gZufwj(0w-{>I`dX(|)?-y>4z{)i(P9iz$Q)gU+r*|j*^o(?+EY0K
z>*s5rnmTmYZSu@ajV8Cr*_f$E*jZ?Qs@p`{5v6wG9L}8>wcQnTVPK#+=bqhVI6H$x
zn^+Rp9PBwr51)haij-Nn!P`E4PMmgO*A6Ht=j>}YWYuQGL7_R&blaXi-Z)el?!S|h
ztg9WgB~PNB?d6HB=(G)YtD_1#DNUkKJpw0DX9ko?lPJ+AGEJhyz@)S_$0X_xfk-}y
zx*wm|B#J%F+$8FBoH7*$@u*p058LE02xol?{s|PFtk<sWa+lJ^<cTira+jMvaa!%p
zC@gu>XVu-`3j)eJVfrhXw{`pUOqh~d+u_O5qq3nHCQF}$OyQHI$Ng2fCkVWX<grqp
zEPafV)7E6^Cw?N`lcgWnd=Rsv#K}@u&8L$I5m9(GS$N@3YfhGws#iXWOz8Y%i7vHD
z(0J3Ei~}4+ol}IyCQ9!F!rPoEod}ZQ6Qu!ok`tvQGb1KR>-Z$e-4<<vBv=dh{#~SM
z0F~mgT&*~CrE7V}05s@$>3jpge0jJOHA=Nf*!Km?=jCbzHeRvg%gtJJ*^Voo9pMyV
z4E6>#y5S8hrPubec<VGcu<al?Vn9~dq=Q>WYE?PUn!XB^p?-$HQ@Eq$&AeF#QJz7R
zgD5+U&9`OZ5n=PoFjJ4{)*;xOU31Q?mxAU~cwzh~62!r|bzywT+ddter>|FyKv_A_
zc^$H9=sa+}3N40>&yy~UA94_v49{<Z)X5me#@qzYpX;c?PD=0`H6#$8UlLF%!E@0q
zGQo3U7L~&0famW3A~`&NCq6NF&Yortp7+AoAnwxj--Mwbw3ow*$eIYmTYEbPP#sjH
z-HWl(kq3Hwhp)%@1V~%&C+U|WJZ9yvJUm0O5Xg8v23F(iE&`R}^%x(K6->8;tXndS
zvvXv9jdyA!{!dA>Yc}9tV^Zy{d>xD76Bl)7#$vIp<bvt}Hi-+nALFN9lDros{1~#r
zG$r+Zj5!mg@&u^@FWlJG0WKIC+pvj>t1JEGYxu^9Nnl-%5xXaWg@XbYIab!jZ3(;~
z{uu+H@RF(1nv7M}%HIRW+r!~4hyCEN{50UAgyn|*5*DwV4k?gQygNatAaukJk_I{P
zw&`L&o8Y#+ceSrxgTOhs33~&E&B4zNbgjq2pye+>smnRR>VlIa+HLv)Y$S9!Xzw#9
zzYhXoPTE@_*rPGcHgO?$DqIb<@{#u%d}1Rndun6kt?*X0bEm?<<OFPLD-Mp<YvY6b
zD3sqZwm!DAAYMY^Sj?@aFOF@A50CLO`|#pGI#WGX+*cf<XNc`qFEr=}9SjgZaY9I6
zV3R&Xe}h<4)h2rr--vKnyiVaubA3|!Sn=wke^3~ed0V%14yLfaIFQ8I_%Ze?r<T`z
zG}G>TSR~7*PujKu{3Q53m;F$je!k?EYxqs@4&4EnV3bQeG5tz^;cgEX6|N?O+Tu<8
zM*0W*Rb)CT&1+U;i|@9H1DplQ0obj2P)q{z*f${p`lV#>xBfP`y_J8>2}qT}$NYu6
zWk7`o%HVVUDl*A{*PK%Zi#5v?6T*D{QAk1jRATt9zZq^ZJQ*m4U-%1mi-8Ic6vKj>
zy_hnS7<kP&#jw;EGh%{RC_W2Os255Yk-sr+VXTErA$DoNU$|QsRCu5;Hv6l{Bn)12
zPGKyPBX&#>bMcc90{@`|aGk#aZUI~qD1c#q;cfv?;ei6U*<VE_0q~l03SfnelVWmM
ztfdg*Fy1Mtyv*M!w^UvnD3#ay3wKL}3J;XZpZTlEBo$tB7OD8tnrl=FMpkY?+uiv!
zs-qIoWa9diA~Lo<RRE&fn-^C;4Z`9R;V;0GoCv$1yI7k#CaDeDx|Coi%o~SkRCLah
zt#zq&*Rg4pnhE#9F1{vQX19A1)}7>PQe-Fl`oTAt2~}_UieDQwFNvD=&hVrHnD#hP
z-T4)upJd_>tpNQHGxdm01LN@w@6K9U2YTGQvzFth<X~x)*Fk(*ez#-V?ySX7lF#{J
z_F%*3b~I$w)_;O_XJLP|SAP<BXDx8hmc0Bk$IBCYO^23$x*S#5Non~9)x&o7*h%T)
zr0=n$mTT1Nl(hUK`b4JXA7Oozw&qy=xfYtvolx8Hi8-OzQyWew^6BKgIO$~F?ZO-t
ze*aTENMfvjHr!9NT_ILvAEPYpG+G%;DKL@ai?ZcoUcL3Zj7l=^bVX}&w2?1fyjoo3
z+M37s!`rUh4EkH;;?du(7C9AfUMSm_!O3$MWb&CbvG9b!{ca0LYr-qV^2)79UFYEy
z#Y&5F-n7j)($nrAMPm$I4Fk<>qN}$<5gc9p6+B6F<xp|~t|(SotOXjj61)VN6p^ig
zhayh8&cap{69Z!RL+mfU@BnZN&uUAcb#g!+hP`+$rHv00VZv7X4Lo0LnAv^_-27X`
z%?@w7c`Orq2z31uX6g}LY34!Kw~-z<==!d=efqYWG|=@Vl;pEeX2&)_*H0m9R?vmr
zG#GUKr-Qa+(DhYFoeV^6ctoJ<2}c!nQUYD59)Y0ilL4g?=n{QGbmZjewYK&r%#za9
z9H48UAwbtD_{2aLdzv}Wg^{%C{>?V4;_G~DWhUW<%GOBdmak}<&Z<w_Uem27?)<)*
ztsqgoFQjj#xW>w14Jht?HCT<WO9*&_dk`*>6-=8<tPM4M*-ltgYYlHylIMbVe(0;3
zRw-gJ42P+XTsaS3wg+@ty8dv$b1M`o0S|AQ*idmBd;)91HdF|LKmr#cZAoCp+)!~f
z3kB9F@(bsR!{yQPFz=iY3UGIA5(C=tsFe(04@4IiC+fvvSg~jKF^v}XLA*(bUk4=&
zBBLeXnfihiCVBz2Pnc3mg{?_1ZNRtyGl9T>KX*y~_;b<*48cw?!h*?mUkKTN@dl`s
z&wbyBPs|Lnr#8%Rg|`YeU??rL7h<*H<RzyFYf*U+A1(dGoYWH9SZhSTuiQ5m=zg1Q
z#-Gb(u%|rDC@m2(EajcQuf1rjjCX+bv1>+f_m3JlHXLfLRKEszN^^D&6lgvz&(4q=
z?t<3y68c6O;%4LV!YzZl@w%>IxZikpW6No$p4t!RcgKo_Mp0}KsqQP+YgN4cnBG7?
zfdHL@)xx+)(<n_gM{4`4gLn&BZL+!Lbi6cKU1GLn=PrCP2p5(O!ewM*lOsj_Rq+<}
zYNR+?m>g?DGA;X#`Xuayf@qzB1h(fD&MC)!58gakoGcDD%C{DIV;bx-v_ZH{4PFdD
z>wuvngQAv+a(T<8g|P;dUTQWc@Q~Xr2dJ6&qG7x#@2Nu6(ZOQ9UaL1)1CW39BGlPv
z4(_gv9N-oAju%JDljCqjbOY`|1k+NRV0XDu!F!8E2ud;r0hdMHJe(=SD5;K68hWE-
zL+?k5yC?V1GdRQx!=*t8hdaEN9S{-44HpK7i}j}1yCY8S6<P3;Vq*(uC(F_p)ER{5
zV*A<Q_@ekA_6$KGqvbLAnlqHAw?0`p>VxAo5I0ZCLa`L9h23MYpU5R+XRH<?m`QG!
zbr)bdN?$Z(5Uw06)<O5G@ancZ`tdx<Ee8fmpx8x_6t7!FYBp~1)_9Nn5&NMj6BLB!
zUj}i59=&4Zb6!FtWZ_JO2jSw&!r0(GI6n_<l&mJ5A8gbn>u{8k*2Hx=7{@Cimie9{
zv}9-Rz{XzaIir(Rh<yx~0S-bS8!l<=P_T=u+8k^^*WJBa?(IU2+*cTbJ}_3S?rD~w
z7o7fdNQ*o#4(<k3fdR15fRN9FC5ZQmav(aGT9Y~m8B(^9-Po_{px&$jl)-vC*epTG
zrP|oY;5b>5#zd_-R^C(MtP}1(wP*MAotxL=?V_8aUS|G!&+U&kj}#lj(2w>E!hXo%
z;-*L@iF(gHmtxC7JTx-#YFPa+*mJ`erf$srM=OUloVu|jR^uD5bS(LPSwX9m8{cz{
zAHeW=wP6U@4HDy!rP@S^jO-nt6x_Ot?Pyi$TwJV;A;P_Cyi+{<cS*1tUEW%{%@|Wf
zW5)rOsK!>lg2k}WxpYvHF<;QfT?OK&s{DH?mHV!<aaS%KtT*h3(eM9;z5g5btkF#$
z#*Fb$7(i=m)6-j@tQ`M0>>=XggW~`0VUL+y{ferE!Vu9HwX`z_z6cA=o|SQ&-84rx
zYpil_2Kp^n)Q~-LEBuAKHv>`Oft!KW`K!pZ8Hm@MJY^K460TPLlCwZ9svYi_^TY(P
z+)5;b5__)%be6w?ZULPEnL-3~iNA2SfT(aKpgAzT6D?uSiu&#T3Nnd@*PBy3OZ3@i
zOfGPrFq@l-R><F~C1d`UxaCj^l*6t5!rgM9!j&Ano7`XOuOgEqc+EK_v7%_r{A1Es
ztfdeVG2SVu{IS1PZmB#FD3y2n3wKL}3J;XZ`~6j9k_xXmuT*UBOI#{i3Mm!+os!BI
z{jG9K<#T~j`G&u6w^XR`K&kx1UqvRV@S1Z<<*>L1EGCx~b{Zj^_y;AS#gjRP{RNOI
zWK=oYU$|RBRJfARtkXq9;7L*5>n}W$Y<QhHWwYFHCGHd+1ckbm=m|ty%$KTJ=lh%G
z?lPML1#+doaJN9Ha3zr0)JAZU;G?4bCV%mnM8a#$DUy{jUvR9qEHje`vDmLw<0k!$
za|`C?K*7AwU$|Q^RCs`3Uga-7lVEtQZ3;$t<P!x$No>K0*Ge!C`WxpK%%24c<{^LK
zZoyFD0fPC2zxYgo;kD)z%+bPiquVOxhm8s72v<@eCih1rtgreT>=xF)1q$o?{=(hD
zqQaH1=Hl{&Xb=CP=>L_!icA9IHRlxABDq=>6VP1zBpbkfs0JLdFUNqt0y2dR_{aMT
zcME_D*93s;DUyEnL(zY#zlux(;5FwIz%sU&Bi9IHQdlIvi>7FARC~7i+vDyKmjue=
zdVk?=c~Iej@+kVN$RrP5b5402CHZZw(Z(cmge#>GlKZ2Q*PZ_My5)6ipuAfC!rk(s
z!j-%{ZkRXvE65}*UT;omE!UTYVck3?q{UhSAsgeJ63Kh~jdF|R-GL(cu)lD(NT_gK
zB-BK_XbGFEsQ+hw1(`&`>&+>W)$W}OG0Cj3(+Tm!Kd4rI%il`3jJ^>lqo4T;cgu(h
zS2CK%Hfo5*&@a`3x%<5XXC^uEx^v2DxwVrdCZKMWK(t1GrJB^^Z<1RmM?)qX3*6V$
zHLDB%qfLdgwrC1|lD`(Wbf^|39j{OG9Dfy=WW#IDDVr7crk<E^7HcVlbc}aOJlFbL
z<rdGC4)M68GUPAZEfp#}P%2e_6`7>MYtAbbdt+5hDoc$NLN3-@C7GA_TjrL`3j-x{
zpTBUoWT<c@nM5bepZbf>Bo$t3PN}T(Z*GgpXq7X)kX6E0C9}Wxx7#hVhXQ5xDSzQ^
znNi_NW(&o}KG7)kLbc;x{Z(a>AEzLv{0?_)K8y)%nVCp5%zmw!_hWza++zBEpqPH=
zFWfCADqM-lI}|OwW$Iu8uQ{i9R@mD>W3uU1DTG|~S4t))`rG7|$?=fM#tE*0=;{8#
z-7=xVl}u8=+lBs0GIbhWcV4Mz+d<jZ&X`mdYbk_SjCV>dJN>P4%jNn&xs?5dyX8WK
zE4g_4%6@+pnWVyN&MB4E?(NVq*{qDE6B2TKQF8hNe>>fBY6Z&aP5#2&a-zZm<@8Q}
z6`AD3YtAXBZnZr<CYyQen~(?nQZo3szYT5~d^k`BpZ6E;mH`zWD1)#0tH>k+UUN<v
z9GP$|ASRHNv4lc6jxS13zw|fMEvTOb3Toj2@969n6cw%nl``0@_E(ZgRJ`t-qFQPk
z)QAaaq4+H1qFyL*oZ@ecTO21rrjW6Ji@$KUIH+(X4(}MV&0j?(Vep!B3S$-Q=VcdM
z8OLN|LRn!a6T*pqP(m8<H_|Pnp+F(k{e`=QM1^ZY@~x^J^jDEdNWA8pLOK$b28JDn
zkYZvwES^vZ%JoT!>J9#;x<z$gps3#FFWfCEDqItlZ~g7P{wgwwir1V|REHZ9;Jf2v
zV!}l_B~KZ+*nX|V^O(PRZt;97P&`lg3wMi$3J(;|cl=dk5)ZFAr+ALGjxVT_4KX1d
z;Yuocll!9**qmFvBf48)zY7%DN`K*Qfl=Xs0z1}UMJ9pqnsW*a$0z*+W<rm`VaP}(
z1Qq|FgmkvQk!~S99WsT0h)ey2yM;uB2MTG2zluyk;x*?K(qY7X?etHqJ1sTR2=Q2N
zm2AfSZF9?}94MRH{Dr$^Lxl&*<{p0)nPkIj&MBK?Qw|@;1a(Yu1|c<H5+%Yv@w31!
z!Z!tq@Gt#^yG2NaYa;Z)zYqAU$Rt8ub50R*cGI=w>?AZ^;_luCx5{~xTnH}VtCHE5
z{B3s2?DK&#`=-Bex6G*UK$-owzluyU<2C1$*-=Ty_GA6+a7RiZFXuNUttGeRKp6`m
zQ^){zjK6TVw5aevY4!Q5$RsUZb53b3w?ZkzgtSCYAf#iyRARZn-z;}0+7c+1tNew#
z#X^NEvCO{h4$%sHRJ8B%7oSNayw;o|K}=x<vxrFr(Su4O8f3jyZQJK>n_DjRK)KxQ
zFWfB`DqP9M>oj_`zluz<;Wg)!%_?V5k(hYkFbM>1n8f%b>UJLUr4r6N{Ec%9=WT()
zdDvgLTR2p>63#-p-o007ntGwy@els0G6{)OkW)x&wH3Qqh?khGj!Z}`nwt1swfsN)
zEq6=si9iYdz+bpqf>gMYptpPd+FwN`$?=+VN^T{XH8cE9Ok7L!Btk~!OC^|9x95Nf
zD<M+|Ojz$P+$|U?JWw#F`K!nz7+!Nu!5r=gf)o?YGBc47j{RDR=W>7Z-2LX#K=It*
zFWfC2Dm+j;qy8!~iHFymQ#@-$<PBFis+gRPOh_#RmiS#s?k<1J-IBX4P;&SB3wKM7
z3fCm(o8kVUzluzf<2C1$+!`SZN6eI%;8wd63%MnIR$}`bf3w|U`^!MFeZ*h5TWnN#
zpx8d+uOgG!c+EM*#$)Drg1E(GcQjl1aODu<^Q2G`{I;J1ZV7%fP=Y`A7w(oI6|N*W
zpNFv%%@RLV8|K~N9hEalk=LG6imRM~_F|$tES^j>&h<$(be+GUZebk*nL^-4zrS#|
zu&8h)ti)}}oBYLR5)!X9r;rYJgguOjXqlNvh{t}dM6=!BJhy1B3KUJjU$|Q|RJan2
z7qZv<Rb&zmuQ{i9*go%A0LqwvR^VoFJ(&<u{DTtGOZ|;>3+e7aA-&dLxLZh6xF#eF
zw<+2(m;F%mzr|lgCL!^fa|-FW)Nr6Nfvxpr5e@byQjB=NpAl|BJ{%~>fASaZ79<s}
z3DO4_zwECflOTD`IR$xGJZNi7a!ZXgLR8jUC7Yl4+vb+d4+3S=b*Fczcguzf*JR_{
z0JF?rMJCzsnsdr#4fPl+Os;#iYPCDDkXF)XCAMCFv)y7_51B%+#hL!X-D0D{HL>}+
z)J6U(GKr1XoKtL(C9ham<5&k<>&qb|=uf2Nc$1$GZaLl%D94JwaJL+(a3x32`Sn};
z6=aekuQ#U@mzklbV=`MLzY76rZ<I7%<!_H$8utcD<IVoU-O`}Kl{CDt@GtyTWReH3
zIg32}Y0W$0oB^CGtKitO2q0aW&yFV@d&i-^(s2;Q3vPSRZ$M&KKJm!uhg!#A(D_LS
zz<vs>DN~s2Q+Sx{L#=uB;%Ir~P~`^@8q~ZtO1lqE(G$B5?jgvR=bDt#{K_fN9#${E
z8|B|XJnZL-4^>VVpTvzQB8WBwG5tHJG4V!}QW8hBn=?cKa0iGe){bGGdUM9Nk=WPb
z9U9-kCw2h{dzzt}Gfo)f0mYqHXHZOZxIyD+r2!&PI%UjxlSb<(%HOvU;`BHAqm3K)
z?#HJN$G4wzmx-Oy?@C&1<*;G~yW`tqHMVZ({Y(Vc#k-PzC(TQ%-1+$SQfxf3yb5rC
zSX{)ys=GcZ^B#E_)K~I_yH{<m9E-)+;qDhma(TRa`CC;#kW#%b;Jv$g8SuWf+)_>&
z0aYC2c`O0Fez!2Ptyvod>)=U|da;+(l6$N=A2I>FRFM|vVmA@x^B<~;YyDNY$68*6
zf1p8wilLx4b8-|57K)x5<HGEXk`4H%h^+XDbn{`<=EHn$Fa#&WPgTt={%YL3;MHW|
zg+Hx1Ksyz#vjg<0z=gyCTG105pnnNwDPVxs?^YsgP#J(xSd7zHJs+pv%AVkl7^m@*
z7^g+=2Mzl**~5@4?!UaFRE&7F5nNV=asBGm!r0gWxPJ-2X|+*?3tOU5xSwpeFwvZ3
z*M7hSt^C#(xa7V%(hVPB;2FUSLEy_cUUkMTA^fb@Cij%^bp*G~jF$Jng)eXy8s2Y%
zA<+h+XlpZS7WNh!-7F2igo^GdiVBTrZ}GtXT74vf9?SNvuo@$tfKiFrF5Z46rX4NU
z8_jN!Qr@BV|Kk>_p86nYf`03aHO4wGbDQqL5;XH|L?&qFIU1&JZM|Tu3=)JZ@HW8(
zGwc$cO+y@44Glzn*Tc7AxE~Df%R^P%U2KAyGG!ergRV7-QDbrfHA;Y=)vZOcNX>3O
zY_X~G;@Jw>w+@R}&TM0)rKPHT6w64uJm%w81*RPIn`ReI95|UZ^pJ6t4Wi|jLv_Hc
z4?|fw@0$H*$g15nOP3V27Q>VS?x-3o50{&V?qLa_=T;BhQ+Yd7Sz-3&L40C1=N<6W
z68GaET`xkqdMXcL8`o`{4<sT#VQ5|58ptRmrMb39k_Q7MfvzFcNKh)3`|`WfxoLwd
z)$l4S>*9KD8wUtRMdQV0sWt+Dp7x&UHy=@&0i!q*-pd{!Z|plyU>-iP>?>U?UbN0|
z7TCwAgqz~PR@1d#>{dzkEcE}NECf#XqTQy(iLu^#tHjZD5QMAU<!32y$p;31jf%nY
zwsChh@jLyVDJOHpwNna#uJy5t5SPMY^H^%mB?TDuw{YbbPosEtq?czUH%vMlGWmM9
znBX8}T+Y&#6q$>p@Tmog*17meh?)OTl%A4@(vx`Y8aUq~$~PjoZSfcG2BlPZpd)FU
zzluzbBwll}x$z31TXngZ1m>}Cf<^R8$za6a2Di2hL8cHFdEH;QTLx5kpbQTBtH>k+
zUUL>1_|uwm1!a#a%aCX`H}2?Mp|#3wl@g~9ip1FT;pbpY+n7G^F`Rk&-Uf~5Gl+M?
zQ%kx4TGl8)7b3TgbT*=I!yz%(5ZnaQ^b4~2A#;txF5*KGf_OfGkRaXlNp+d``Bl!1
zZud`{E65)3LC=6Qe?vqAXD$HXBnD&}<|~&v-fh#~wYsk^)ZuPh0J_pwp}$hxc{CGu
zE=Lfzrt*)NsYmn+uq~CHTIHO`%24c8U!@p(XF~bQ*ytGbU4mF@Lv-@V(FHJ-EQ}mD
zc^s}m<zj~kVW9~V$|@jvxK9_Z!fwKZ6DN&0dECx?<y<xTDpjpMG4vArjt#_5X5z#+
zlnk8sPsqeD?Chvdn=0UI9SD__dF=0ki9#2jrgUxU8tS@}&v&~R80;Es9+)UL1{edn
zhS)e@&NEKX<{6Zg<<v7$K4a$bJ0ywEJm#^|HF9S?-z3+<ZI#zSV_UN)4jgKwPdt9Z
zIAWHd`(90J##TH=YU71+^-yIokdb}jfo7><O+1d|JdH61jS$U5KudX7`-OwxN;C)U
zr)e8XAJhdtYlFtXn7je#MPEPon#iB#ti0N-`mbGc@(?FyKx-=h;b^ke*vbf3@UO6>
zsU7!i2pprntJo#cg|VF%mxr4>;k;0PbV2pNu3fAvUsS6$LCy`F1{FpM%|cXw>+PY}
z3XhP{v$5MpqxIT2baR-t!+qFrvozdBJvm%Le+_1;)ysRz;BSiH!j2-VIjZf(vlj3r
zDnys<*l{&j4|cOPeQ??ZFX+9{+cj*akySVsGC8aQzD}?TcXO+NT;WCm%mDbr1_VRF
zPTUlA-PE-+W<4k&GCU~}$N@g}M+tR+gy8e8E?A2M`_N~an>A=|kgQEZcUm;Ltjvwr
zL~dmk3fi?kaFfLW(@f|djs@W1z-kj695*l?n+53N@YtDA$g0_yxvZWv|Ax!VEVnq~
zGA}zAofwn7E83~C0^jS(V6y!v-O6hscJcg9EQ#}cE~<f6$w8|UlU+K$(+&IWtRZFz
zfee2cWYriR=uvWUe6hxhP;P_OMrJp5n=D?gu^4)Yi?e@%?BkrB14%T-z6HM|dpa_W
zn12Li`6lxoO@0?-of^in_BlpJslK!O^})=qy{qF!1B{G|!=KPN3`sN&e=?ZEsixv%
z`5F8<lfn5-MK>ufHqy)HUHWZjHk-}SJsG9Q0mwipvGK=&QXFZ{&O2~x(zJ`M{CbX>
z)wGrlX=6NB6EK(w5ov$vRSexCA)kK*^?(7e>xbemXdg@{7-pAm3d$ymIilB8o|&ST
zNPjjMb`SF&X*g{AaBZT<;nxLKx%5R#Yz!W=6gYD#OiaK$3Le-TtTE8N10WVJ4;Je9
z(;#2;jV9#m5*F8r(fDL@k}asQo6{QQeMKkGO7U$S`vRX$wRuQTYYk*_KrMW&+h=V8
zwj%)s3Ah4SC;@8e6E((|0meK8Pg4M$&O(xtq0>25i_C#oAIekh;hBtQW&t{TJp;}~
zkX0LS^4r4@=yV#RGY*~by)ImHTwkw^>-q#)lbCBH+KGj7_RnKt)vVVpt3s1?I`7kA
z)N@&*%n|~bzX!5v%x?om;XORGrEoywi)&<(LYSowOtuJ2dzU;g$?j?lOtIeT7?>Ps
zmgpu;6PKOT)Q`2AerRl9GIuG)tCV8k?L&fXwvN1J3U%a_`E}%hDbta7V-;?xd>q^Y
z;6Lexp;d63S>dA-M-rcW3^1@@h-svR0kJiZ_joz2_azMg2rA{$DXJKbYr%9a<8;vw
zD9KyGsHL}BVIQ9&D%Xb$whD;Y?KC^4%^U(EN2Tan42bwk9h?oyv8M8PfS2h;o)jI*
zz73m5z$HBCC%8i@)dRlx+9Ir6S0ljP@}fuMo#NU5yuch!l8rOcK|b)GVx}}7xUo-V
zsX!R$7~_aRgC*zYgeBa$GZg^j@E1ahk^#sn{2VmpO$8t;p{SfQ-eV!FHU@SUfGlNn
z#sLVv*I8i>FaeH*v#<cCW8oaDXj2!nL5(vR`DO{a1@PfK$f~iq4XBaiSdhFmaD~lT
z)6gX2ibY<w>5axNOlEI>3V$#u87S=SQ*59Xa04aR=j3l?n3|bdMTY5S%#_J6JqS38
zP5Pp(7Y{^N6b|6Z8lF##%A@FLhZ!F1?yT0>Udcw0xz}O09sd|@zj#|TQXDRi;O5L4
ztjINnVMC|p)yGYDH7o{~@*1!!bRgPV<&OMD877X+GQ5K+X|svDK>76>c+4)URbiK2
z8TV9;15Ksk*aS^0p+_F!qFEb$Uu3b)bU4f(!sf{_oS#2Ze81PqoZN*_Maacq*9b&5
zXM%yjOjt6ccr95$*PpOsj*1~~o+5_KMVST@xNwMzUlKQ;|JDllt0^L^TT?OBY+IzJ
zHA=85F94E!gPUemu&ZXWDt-dapA9`<?Hv$M*PrQ(SuB&-ilHpWESoYqT{WNYVl)?K
zD)-HWRoHJpd-(CHZ{ia>Ud5jB9IxWL9eeoJmfYJjHx7^08pXhEna67LJ9FzM9J_*I
z+Srb{QErQ2^fb%kMOgc!EttdLJlkCu-kY!s6GmTFIe91eFQuiw1zziD#I#m@-d&f!
zlzCgVY25O{+ry6=soj=qJY3-pHf<N<5<M|}RT~)>&{y^WEV2Bp*tY6!AKMZ(Uao{p
zFwsrj&bZ!RxO*!d6|VM*c+bV2=C2~tRytmDvZ2toGcM&UQ2R+?BbcVXF;T#cKm4<h
zg?gccak;-S?tP7ya!OK#af82bw=k&iKw*sftH>k_UUL><_|uyE8dZ<4EJ32DVPE4?
z!}c9AryV#P9>K>TMOth><4?g(P0fDBd!f;MKjVGyr0r)UD=YRfE;oqQ_Ad&q!ASda
zvYsLP7x!L-MvuW_KD03JQ=<eMU`A^D!A}9JE!x?p3*?!lQehv@2DjB0yBo#vLbX{Q
zhHa3I2tAoN8jIsD1EXV;jna@p$=f?nsfNBDu(aNs2OpV09<u}Hv6#1EL40^yb`d+r
z#hU_bS2p79R&CZer>(i80|NPCVieRgIvw*?D9VS?OcgaYsl5lXYBS@xte&*ZBdBWj
z9<?QULp9I)%nZb!%_vRg#GN&uaov`2vaLb>vYB;H<>OEkZLfPHK7!lGxsx@0Bdg)E
zBNZ{;DgF2&)g*AQsUJ34r`hu7F;kB)h0uQ2R#wA}rwz(#a5$WM?_m2GZr{SmrE~M<
zGVBtNXp=VoG<(92ksjU?>{;o5d)ueGhUSC*LoJEw|3fG#r~3Z}vTEu-2dl}W{k(Cg
zGW=ke+>ZHO2W`oIpC`RMv1LwvpKmy-u#=MC2i3!#2iZx<G5wi<QfY=J`h?I_f1jcm
zniy=9w&s|jJ>x}UhISS{y>2f2VNWwRL+cx9RHMGcnO6kCu_uc4<^ec1*OQoP018Q*
zowdfNZ)(HnSa&7ZQP0`D#R6Nf)X>}eN|%c*{;e~2ZeHIk-qPF@^@^tVp4%U79w|14
z2OH%*gN+HeZ*Eg0Q$@Y!o=g6JnCUDOnKT=I4ai!bA*P4jc&?ShvZX_@z0uoY0KsZ}
zokh$dFzm(^vV!TC&Nk>crGt{;bA%Ltd+b>aDOE`&N2Dej{8MYy!pb-n!)Lon&fTzb
z6Wz}ItbEQ?*|JL86E$m-m@mPTqUfNPqRLh%!j?^CGrR<r-ws)!;X7o*XGO9K-6{79
zZxtoC?0Mk^0OaRDkg4Y0$@~4~Yn$#3;8liJsF8<7IWXcSv0B(r)R+Kw^k{h)PAM-!
zgv`Py9bzYx@c;uqdvS=Jagqa2ID7umPrjEuri5>o?7v-;@CUr*Pl<#d^;VHX!ZuWS
z++RVUh~JJ9Uj)a_MMx}OP1`a~9&X(hO6$KWYvozc#wnSSwv6F`&rN>`g==$DW|nAX
zTKN@x1HCO>1V}(w7U<rW6VIKKQS+G9(`f05&qh^j4T^;U-4)Ls2<;3^t!&in7n{S4
zX*F&5L{o;XNIpN2^E=rRe@+5MqTw1l>`{nZ*J^Au!X|L%_0d2zcU~WZPYfEdr#7Hb
zg|`afz<@BjWEPVmp0yU>9;0%xaR_0-rq)I_r*GeZ&5B8cNaSVrU>51X=Je>^*M2yS
zr+EP5VFcz;<>bKTzm&e5;nf%aD0_;`JDu}pYR}9%urHTQcY%`x2ll0q3A8cYXX-CJ
z!Dq?~SJPr{uoLF9qy8$g`Ak{O$~xPT6@_8PfCv|IDyP<geV4y6ZU^>loRU;w-0Lsg
zEet9=P#AycuOgE$c+FXa;ZJKiuvL$*T!2JRrvsb!d(%6J5Rx3&inN#mdn1rKC1|1Y
z5h#g+gipbf1`^21#vIs;Xw88wxCULJ9~sD<b592!yg5YmnV_Nf`a-$MA}FD&dU&#4
zhk=R?3*g2N*fWCDa|s)Q)2o5tb3~5ti};6s4jg92>;v!qS@Ev3NA#b}#1-;uegiZ0
zh#mqa-{sfLb434c8u_(DCZl7uLX#gdkvalL^v7!rINZw@x<NG{hT8~k{TaobMB+8<
zD*}JTKHNOi&(J6?h~Rq2ph!{U2YcB)3%CtwvQZqN1rGCgzg*&_;YR*e`ZfC{T;0R;
zi%yvQ7B~qb=IWMt#2;T9J{4tX&(FD)lku@@YEF|JgH7dl%XJWUt(OzJFFAEH=TT5p
zPG|CokX23TTVb0y(dyZ2DIupxj$m}6JHkAOi|=(o8a|BHO6{}&lMmmFWIFB7#UdoQ
zh0dT&=g+r_H*K2E>GZQBn^_ag67=bmIWQUClglBi#_GTgoi1L(FoP|Wo|7Kwx|bX_
zwshM3HOKm7*S_p`#!-=2w{sj7aim!pGfbL@?DXbd!9_!4isUvlhh?dIrL4;c`9?bi
z?Rr5sSJ;MfYRSBNipV?+EwO31g9$xs$hPs4u`BE^TA{C<BGOmWDagngQPe15i^Wt}
zTb8t@^eZ+>BzH{|JDuhHAC@#Vq{ba$Qmu`&7r{Kc05Mf}?u2j~{ShB{`<V}!f^2NX
zFs%D(dto!~{&JH?PpwXl?}pvCuw{1wVrbwdTYkio?Lc5)PPu?c*PSD*+PEV|7D1vW
zr$;i$iN@IXK_<r-i?4OltR0tlAln!l3#=hH3BxU&_KXMD03O3<5jTUy+r-sfIZVq>
z#<K4eMbh{@wmo?O|ANIDQ}gs;C3OJ*EMvY|fUf19QRS<URU1`0JAi+h(HS4W@x87k
z<^b*pU?ODi8p?l;g%R6DI!(KOVbx`FEfd>+%9>*q5Xkm9FP&nx%a%Gub;<U*fSdFP
zCVsx_r(mEXxp=(>nnApt14%SC_u!YHvqtHl>1Ze`CqC^p`P>F*V(s%W*9@=WXKfHB
zJx?*05Stp|E|^00ZpqKyZBxeHWK1fxcg`*&fQg^O>HBns6?^T)uVOHF)As2U^7FQ4
z@-}FnjtlMc#(6c@h*)Ct)dWw;XkQ`#1MSBEfCKG2(p)xWC`k1gyBf1$y5UA<5i0zf
z6dR984OHkal@8YaGyrST{v~t+*^6N|t+apXYaEtN<-yvAygk9DgFIL7#Y}0Qt7+Vk
z_j#m;BLcgpf5F>69Sx-Q^v^;`IR~k)LRJlfb)cs^XiM(M|LEn3EpzH8pKw%RCnb$W
z^~j{r{w_s3@`N*2cn1BMXyI9S&y}|3*pYYCJ!0AUXnbPJ&g`j;WoKH=&Aa6M^gYGq
zAON!Bo;o|68MyeoA$fP6RbU&-&?kzmb5@akRoERrSgQ}RX<B><dbyQeY;K6XR~G+t
zkcS6^de2o2$h@rs)3^CB)<%1Qda1!B&I4^7)bUjvsdD9A-Ll>)?roJE$gnzn31sq_
zL46tbf`GK<%ApcU<$R=W8deTvG;CWm=A;^N0IeY^B4cZa8-VDkSwpNrNqh})KRjt`
zh_UV<Ruhj->US!zx8NzPjh%$-4O~~eOW%y7Sshwx1V<yCm)U(FLIuU(uB?*}bi-N_
zb6@eBe@1FWJf+@@=)?>xLFvUo%4)>--J|!i&ccJpwIpyWj7=vY+GO`GVwM<tO!srj
zQT3NtnUnnqsAJ@K#u}NsZK=r#)q8E4{No|5#Llp#1HHRl>0NwHc1jPM{8=Wx6SVzP
z%+w={4~W3EC~H95IT$aJp-;8ExHiG{2}zxYPQs&cei-TFP?uG#^x>o4=ITf{)!q0(
zD9UH!P0MI3VtpF2YEU=K-G~;>UN20E#`%bY#AL+#K1iL66KohOW`>R`?4*QvQELJb
z?;iz}N{Cl<6=8M!J)97)u<J^Rb0FUNFB6D&0X{Lr%bwasyg_Xc7u-P`#I<)ecT?|?
zJwi5Nm23ig%F~3>5+Q@!n?#S@A#TNU-Xsf0XO7UoxlC;0aG*nTx%$qp94Sla<J&VD
zM&tr@#^H2zmW2)3Sq`$0w^iAo0bsR3Vd_bSXIMF`!O^`{AFHtyLhqRZgW@Tcjk1E)
z&ADN|I`s=@6Gm#oeET&n*J(0Si6rmEbyeyT*~MB0F~Kq3DQ0eyl)K=$|Jqp9>dNI<
z44-8j6uZY-i!>7XXrjGQBs@2T1mA68ZW2@|i6y#T+Vh<F$3E?X*9DYSFi`$hl-InJ
zC+xi43z<T8-rnIa+`ZY83RfV(yYu$t{wgwU_T)7uTVBy!aOdqF#saGsYKK8EtvO|L
z$~pHfOg*kE)n(68x2o?1I!zd&P0$ocu?gDKAYZ@)4G!^(FrtTy+gh<+J}r9~pYW%+
ztreev2zKa0bUNT@FT4(&X!TrJfL(ZFg$CSqiWg*zjj4bG4Y_SIC6(#~AE2tm;FT;^
zWFAcsX2?ncryfz9G7$DD7bq@>{e`%l6=VcA$BMvc`~}2*m3+#aPjT+kIXG8&6f>>c
zHpgg6ZoqJ=yx6h2uQ&z=Y%L$3wBYK_%BLx<9gv^Z?NwBc2`MDkg_8JC#R<u!_7$o4
zxMOdH-4bE9;~$g+e&m&a|HR4nWZu>brhUwJ@Z0wBEfl=6hdt|q^6Xh3;0&=WLa}VY
z%T4rUb$9mxhdGeRH`mh#hu;BT)6$xQgOWt$x4d`2Y^2kJL+hAiHBAm}qezVn8czc0
zc?JzOJXF{neJ2B(`M7Z=Jn8tW74HSYqqjD>9ok_5!B{Xm-zLR(9x${H3#{2L%qMkR
zG^y}Tx1ioMO7XV%6;Fc?+Box6>6yT`O+-Ji%@}yTa0#&nLis?1%|e8G)bOTryd(>@
z>%ka34lYc2+g+(Ph655@(Et&Radv>|yBm|c$IEb`HH*DT434fZ;x_q69M{0PVPTku
z*<@Ea6dMhUx!E7>o@{p4i+d)=3iastV!d9gA20R>HcGWgsBjPL)u)Tthoq&&+xdnV
zh`^|Icz=7Nd$=|}QJ~Wwec(;~o2OXwzJBn2*1)eHd?2}rnpgJOmfD$K+2s~9#Gqqc
ziuwPw_a<<XRn`4?53~1d48sh|&`^NGG~;v+V?<?SKvqG*fG`+!7`v;htEZ}_x~r*$
zq1nVBAn_q04Tvj2L=hE?Mny$_ny7J0{>CJ(KjY6ODk7o=H3aqlJ$HF`dH3CV?^Sg-
z`Fz61xxRk&?z!ilbMLv|bMB^E@lK1JWj?J|EaJ4p1B=tHixIY>Z?hW@$W<??oI^};
zOrf>X8IGLRQ%OQZPHU8@PnvlMrETO?bAXgr)U{)JZX$l%ivn);)=v+Wwp$eNdQkF>
zh^C8TL`v^ORxMJRXi)%-9XwFV{1A47d+hR`8yvjFhe)r**Lvv2-}*&}^cqJIdLV`x
zvIvn<^YF!N=u@%GrJ8`M2$9M@A;GJ^Pl*tz93@q2%@88}XE4e4qJN#9ScsH8Wr;6x
z5Z>uQsso1gZ|^P~<#!io2<gCAINSkVh$O$?KI$b{c3E^?>#ee;k3s73?bYue{4~rP
zym}7(11@0OInXboR}=sGTjdt$Z?W!<?HSMp$oYX!MlnIKKS4M?lcqZa|DE7l(;-lz
zuRKLs=xl;NVYDbv(QxIRG3lH3nQV}l<5zq}yn!Er?+(3zW1$%C4Q$1e;SE>~Ub+H@
z#PudMxi94jK>K47ZNka@3wM?<*N(*xj%_LY$oWy+SP3wiuTSOnl`umehFmxR?G@XK
zMMy^XA7+HMvH>Uf+qZ?-M11QR(c__`=LzNklx7&t?MNji0q4%4OntJG&OMwf6F+V^
zx7S<0G;nSYDEVxkX)X*n*Fx5`aE>~EVmMcD@D>l}hVXU#@MvQ+0p~7u6k&fV;2brN
zgmCVx1XKl_lYJr;oRh{*wbl%9?t@^G!?_3OiNQJcG<R@rgE$q!IC(J~22|AdP$!HN
z=ie;a(VWg>Tq_O0<j4TK6t6GTyD=<DobxNT9d>$>&_6)D@eR|D+x|Yx8|<5X+$JPy
z<F$2e!LV>czjhjaxFwlcF@@pG_s(<h|2?d?YbH1b$9)Hxe6~!-ao=FyYRm$KXval~
zx+tC#Z8QB{7OsE8Ica;|&cd5~&8Xy_f)&J7utAGJtPA)b3SF%67m;cTmX{pwoko@6
z|JDT6s$W$8jf6fspn8>MA>u>pioXb$egyn>2&T6|PaI62iYEh1W78Q<Tc4I7dbP!|
z7DShFgO&V@Xtzm%=-b($1>x}n@@N1S3-q4Blf%^_Vh1-Ou?ra)&2xK+)%MKLW}@>B
zF0e@W13Ds{N#(L|=9aWoQT@i|J-#KAza>!loZ53J{l!9BGmpkENu?Ko#wRFKpX}XG
z(HsX?1LDVx#^2zrUm7(2SD@q@!8~aE&B&S-jg$3AjK;5b@D`88{}NxvgB}}V3pD;}
zM-ld?0*zDiNQlPwCZH<Nxa<=WF8VvN2(C)&sak6WH2yU($<g>f(-TAE>}l@M__Oww
ztJU@~)kB<Mobq-MO5I<LTbv64$kcki1-t~&BiSFyApaaPjBkB@$o-QrZ*b}CLvCIx
z8*%T4ahn;RxC2@xnz{vsT~(m+UsRXb!A2`hjm1MF#a;v&{Q&HC2#xlCgM>y0<H>+V
zyv0al6m4PTGt%+JQfLt6k3?HY0*sD0vsNz@$6D3uRF1URVB3J2at(C2Myu_2su|}{
zh4^M{TSkE^=CaX3WPO6?nTHj}r;?6<70;nep^oPsR-8}#xM9Tw-uk716+1vFBdoX>
zS<}J_>UoJ_#Y-H##lwm-@pZ}`vA%MeqX@h62v|YQBO$EVl7Om!6|zsHf)&#CsMeYR
zR@??AIjp#yo*1lPPjd$=w$^d#W_@%BH;*-k*mO&KjB$(;V?+pb060!n!&iiCKffY)
zGh5s=RLElwdaXVsuE{Jni{r*d69rLLM=0?@d|lx9MOpm^psDya?guaThk1i*XCJ&c
z>T4sJ4T)qa(4LwMUc|F;`KhR!@p>J3M|7977FGCsD326z#Lps=&s<8dMY{(+&A!#*
zhzHOLIJ1$6+9<YH7~jZ7VZBui;(J*t@ommn+pywee&X)1q9C3ytoW3_h*V)kUUIx&
z=GD#8u(L)~vVeY)n&5vZ1+2N**CS)1(W{Ut$<~@9{lwi05X2KIV2i(qR0`lFr%{0a
zTQjb!>{sPsYBjUtyR7#Z|9D46@fvYt?gj51Ix;VV&UlRXRd_NS8OP`$y_!BxO|;mr
zlr0R{dqw9=;^Lga7EY8W3iaYR)-_>`FqQ_la3%{|7|d6&<}j`|ayS-&+hQ!8813bY
zh{d=WIznBdrn>2vznQxiM?7PON$8>=DlqfD(-o;iC48sLC{v&8m@sa09Fo1A_;LGA
zZ}!$NjqfxKN<J{)3CZ4#tZ98G>g<Vqr#Cuyi}#%Zd>xM~ZHGvNWN&m7VSg%oCu$xE
zeWz9es={}YeIk|bB#oMCtr>i$?|@0}JAId)nD4}%I`*C7M?{(*5@BVzixPE^dn;|}
zwmlNyXJHi{4XePOvQ(i9M*<vuR<k)74pDK(0vxP)dqxJ+ze|2Jz&eA9JRU$U$ep2+
z0p`Ea>~8JvI9z7su;wp^?K>1pbiXAPW48;vgGxY5Cj<NmjeuK#pfy|Gp&|N?P6x<&
z#p6F6K-Ii*1d-uxsdCj<SZwl9#d@od#$X#(e5VAsSy871gj@UB(575q^SyE=&G%SM
zBaaGD?4IsrH^zT?5i<D(KH0Fy3qCQyw<gecN@1qANmh;npXPu~23IVARxCyE{8Q*S
zS@3*m5#I|*<#I58341~!_t4W%a^^ucO-S@<(N&Yc^7T7$_t9u^EZ?d&b7$?`dA`~_
z9)fM}H>#yv3T{$jguc17C6H7@unb>2^VyQ&HWIP>(TYeK#z8GZ)X$bQK2b~V1wC`%
z3R#wz#<wc5-%q(;?uwS9nX+loUA6)&M}JTa;4R(;;153D9_9_MpOfLmA$L3esCJQC
z=GFQ^*;nfa_eS&&g;h@xXZ!#%CAF~kCHU5~uu2=1_Y!xr6G}PU-(2IPDT>{Q^}Pk`
zXR*G_+;ao`4Upgl_}}pqSOdFfLwe3%9~o1*ZAlNVs>6Rk>r&dVO}CQZ6Yfg!?mQPg
z*ZYm?#6J<mO8a5~Np~RRnbc(=x*sXg{qGL-x!ZuBc8B_Jt)^!#<4nCn{f`zoe@hli
zI*EsbJJfA<{hm2rVNrRKnBqIswN^UATbd5Lg`1LOeOg594xvn;MS@V~IAZsF;>R7a
zJHcDOG!eVwLCH6)nht=mrRg+eO&hVJ0fk5G7|QqWP~Ym{Ek0s5;FXE)<&zsDB6gb`
zMcAK;h#fT#U+jRWiXH0f5>OQpJJ}~>OZE3D5$%#ArE0AiB6e4TNglDgik?`+jy+`w
zcX5>7=??X+p=-f*f*)&aZ8ETh@+<V!4#p=6-|~&r##Sfk2T8H}oQk77WV^Im{dQ;|
z-jnn@5^oCg&fY2pk3?kDO2ugOUFa%8qrX-DgZ|dBWBmhRT~l}t_aT$d#Obk_cPIGP
z^c<A<EB6q0v*S6e_i4bi*;>#>@fvX(ZUXNex(#0k3GOz02Tu{VA!g@#pQk3$VSt^J
zvIW?^nZ%sXPneM%=3-Eu5!%Wx`Jt$$G*NyuC)Tsh+61jfYs>;bPv2L1nqj#2`&6P5
zaPLXV6gI56hkI+@1b*CbZ!P_#o$PEjg*0$)H7NOPp=mk{xOW7yriFWC2ol4+6%O9w
z;oefOOl%A%;NBuf5%#A7?osnd2={)?J~fqMQx$Me_6gak6Tv-c@KkHf0QX*ws&lya
z3VLF2k3G#D+&k8_gWWJJ3g#UiH_genpLY;5ezs9!cXzYby^Yk5>n6gy!4-28AfCG&
z?Kg&XPl5BULnfbX({bKw*tgnB)Nbr(|LZJVznyc^cIoK@e&X(xkAir@m5&emi%7Nd
zk(V5A-lEFze`|tn)i)~F5Yw{*y4N@?MSP52@fZQyW$@e~*!~enaIpOto+4n|+S$I=
z!MO&mr3?Yu_L4Xgg6o;u-Tt3~2RTTZVbMgp+n=^b_y=bZ3Z-&8-Q8~U9^b0NC{*9v
z+jl7bS4#0SjMmrR>O-?Oa1v<!V9L}ddpp!L$HCd>5kGFU{sM3P(xCO{f|74U^Pu%p
zku@z^CrgqTtsm#$Egr3J_R7T8xj^g3I*PDA6=<EBM?$o|HUU+E)@7fNhRENUMQ~PH
zP}N#9p!F-jBuDF4(i21L>}l@MdOz*cO}5sfFBYux9ov~hu?L#t80ScAPf=?*yu00R
zgFHRHwD(TXTf)4-<#Pkcx%}*P8mV@?t4dVfMfI5->~ug>bMeqgu^53)0a)%3I(-5p
zICT0fo+8l6-1+WqaTvSV?sq9bjGu2HStbNdZFjYck)`c-Dq8p@QM@!&e!wH5g>&7A
zA+|3lvCS~-`1e#260qaDl&Md4l(~l;PZ2+E*zvTteraIG??EXe>{v9N9(GVKObk2z
z)4^Lj?0CW}6B|ni*zpTT5%#A7c2M(32s^%&fU1BUvQNmqoCtPE`=eTG2H0^j)W>1R
zi|C2L4)!#6u;cj1KIvo_WK%2#i4g1{czC8ctVKxA@^1K7Kx<jS%|&6};D)&YHxcPY
z=aOf6NBm?clN52tDl+-Zrylw$v2V3F<P7YHe_fVJyp}W8HY|C&pSU|LDTpTwOWxxz
zB2`$DmmF_Uy}HS|BmQB31>6^JJ(N%ZU-lDsD?kuWsDN+zi%6vaUUC`*_`fyd!peqK
z_7Kyv<J%n3W)O&XbQHf4N9TO--=U+^bDMN@mf$Jk=y-O<AK9ixTI^WL8Cd=T(N2<V
z!|Bp~c7cVvL`}I<`$J&y1F4M$g*)|(8aAPi6`~T*#|-;c8&Zi&_*O?zraswG=iaw^
z5%J^ptxomUFO6??5-9n=fhVN<=g68iq)Qz?v2V4_!CSm<^*nr?vWu**{F$Q&yEh5n
zike44-|C12RE2LP`$Q_=N*XrRS~K`o*MUjyTU}32%(r4s9s5@CBP7i+iLkWXBZ)f5
zos+h7+wPFRHLSvPSOxZ!r3zixA%85}9nUXDbncHIY}WII^2DBFrvrTfiFnH|!R6Ua
zA29iD`J*%z`ZsN&s}%P%w&kwI6^|%)@RW%uxz})pcFunQn$Wvp`<?TDYvr&)g~QIB
z^Hhx8Ui6MDfivx#zb`BxsCD8=lI8{{r?!pO3XNtRf6$$onp^KwBae+wgjd<Gab%E3
zS2=%EAmB@3JzU<Oe-FKqLFJ1?hO?#SD3)pMMzUkPQ*3;*4I94w^KLfO+U&K?Cd(O8
zYqeLXuh5{ye2a1o_uI5dR)HQB=Z||ikGX~6QDnj_yjl~!h<7Skg#1$#^R&Mhw|~Wp
zscc`{(-XFpdD~<mcvAFxZ#TP`*<mVYgM{5@DktJ4x`L?8PE|xMEFz~Baj>_DlDkhv
zBsE`Zr*i#%s#>K*0@bjeRkb$x%hWbL8tXvIsF{KxmHX(=rS;-i6PB;ooDO=G>6;Fg
z;fKa#u}~f>7p89vmZCS0*G5~_;`EMS3I1T0*-!7Faq2p-42c~Bt|9=*r^5KrPue6p
zbm2d4bCA`lNZ*>iq_gW}K6GLI5U+P*i?T;sgaMll7D7zr(do*!!KH}+NiyQd1;tRr
zS-c1N5;%(osIukAI9(aUUR-(f0+r9F#tKjaV@DpnKtIW8FKN*r*L(4rhMy!p-zXiu
zpxM0~E|#NPFzU5hGgqv#W77C-$tB#Bj04lERrY&h64xL1;x=V*|8#D$SZ8-DPZV%P
z@&v|)7M-w`r(5X4GaP28Fx8t%iF*^NRCtVYGCV?SMZs(b$3VPDY_r9%JcM>E@257l
zY>D=*<E-3dy$1C)0gHm;qs>wObkJRbiPXZXl=?b5M<D~)h-L8b9T4ov(&lsf+h00e
zz6f;C7)u16Xn#q8#^ZOLcyzOPS#w)%qZHxBlQ!p094$5qLyhvDA@q_$aa%6@D!1{Z
zlXkPghA#77A~R`&&P`U6Z4Vu9vvQatVazZ^#UzD}H--f~gS2@LyuFfwZtLROC667%
z{j5yI`@%}PaitH?DFIdPBQhLUs%CP;)&5S!8$=@5^C>TzUfA<-WQEMy!k#aAi->7Y
zoVXj}#6f6(IT{Y|K^+<?4XD%3r}V&|3JtIt1Y%>Y27`Dd+hZH@x14Q4WvyI`qB=nb
zj5l^PNFvL{0mSdAeug@NxSk=-W3BubvPg&_8#k(VJzmE`jEZsI#co0v2AqJ$NDzY{
z1P*#C76*IJ#sl6I@{J<-lX-srlL#V|n-Y}hV_Lb{C|1WpXfea3C_~Y62d}vdR$1m&
zYqkngRIVd&!7M;>e+VV#&nZGgQqTwyN%7luTZD+zXj0UJ0F~Po05u*2u6dyAV0vPK
zF7}iqO2o(aK2a+gSF@g5b=+8aqTDE1s|Q>VWxUud)kXnOHu!DnAg34$NVs+P0fFOo
zD&!=n^_N;B;<WtY#OM&+9@%K-$0uWs&0i#W;De9+Q?;S3-Ztdlf;153?d*1+EZ9oc
ziw|%rVsV&HJ_7Ej$i))*wfIFv73Sj?_7dQTJu8u&6;|6dKF6E@cseqnb*iYyyzP=a
zo)qzy`H8#dYX$Ly^R=V?B2vxQ@{-kHQaT!#QZqcdkNqMp0ww(eqAfV0hZV**Qe@U!
zCBCctb#n&_rZ{75b@O^Zakp*+@r1g$(_cg?-SCpr=*Iu88UIk7zj87$%{t=D#y^4s
zqV_O;@?0?(iHG!q;qD-w%Krf=j%fY?PZpw)=2o64e_)h<ZK_;~5hL>^l4!!PN#jg5
za22&XvIJVeaq$!nN2mn2rCAf<k-^?m5IEuXvxpBUdV(+sLp>PoLQj1k*7GCA(x~M|
z0FV$s(MZUCI45PR-v0jyF{J@Ob2?N(wO>`Ljn2CFSI&$?X8SAWXzzmF^YisQAV{&^
zkXq1RDdGG$m2kwQ`wu8npX|{Xv0VG8hBbaf^rBLXyfdM91><S1|GY^G!sV;G&T5V9
zJ~lTnkRwD+KcRWHfVe4&*DO)sPqjo~^0C|mVt|NITv{G2j&9}%y;ZMMtEAklt)iKN
z#3;w%{gnxgBR+)7I5%==BW}-|d0$J`h{iz`T6`LE!f?JW*e}<w(W2MJY@0Is=l5)z
zoa)&|*EjTR>lyBmQ-D$=cy)2E=i;7S{5ux;<{xsD*)!A_-8%@@2hVDa;A0WHG5p+M
zJ<4E3Y#X-e53|-%2{frx4yLMeWVl4~q1EP4uVnOP4T~qI2B>D!2Hq#H<Mmu#>p&_J
zw%2fi8Pztt>}MgXnotN9uyUB|T)b?uS}v5Em^oOC2s!3fC#G+#+=mh?WQ_U31{Sks
z2Z^l`GY?@+Lw~vtt(dz+2QWSf^Y!F*X`-O_x?)YSA3<Vg8iU+5r$A`SCHfPIAQ%07
zC{!!zB&#UXH`Aq#8Il1$LlP(UZLB&b1s$Gw#C{gCYGPl=3(6vQeOf_CWZEbCdAl`f
z*n&49O8oMZu!GJ!R-+c_pEyJ+_k(M0)#utA-{2^p?prBksqGTYI_mlg{rL5j|6&#>
zUbXb;DDQl~WuLY+(bpJIJJ)~F1Z?%Lv1%>fWY@J7$=TeT+fkb+a@#FCQZDpDVVLvH
zT%%NLRY!Y;J<jD}&83^l=3|QaQ3|cFFpDta^nufGTS#AY8SAYQ<+a|<V~bK4^H;N8
z5;5lVTJQ5EWy~*+G3HEUah9A(5<hOvMNB+w8k6pze9%6tjZ|nHAhE}p{ez=spK;<c
zJa461al^BaeWZ1dw_7zfTbFKn+8X>jnM_Rry7)bo=RL@(S)S|$f4MODyqXS^a~oqa
zYVGO0u6fhiuhy(R)2U0$j}QqVX7-UL=FeE<O)2SOZg1fqW>qjLB$V@)kyVp(2NoX3
zNx(?BjCv^H{Wj}1)-T}0H345OdqmhZT+;rblJ*jrK@<3oyD0GgmtEk$?3%z=%Swh)
zNho|kSCV~W#B9<lN#Zax+nAYgNqF&{VS8Rcrbv_SQu+zbsvAJ-&3O?33rdMai3>p~
zBT8I@tXgB9PsL;bE4*?(TVcQxyCIuHcRV}^ha3Z*L`ED3JaK$;e%A+LHK5wXnHAJ6
zjfPFGY|}>~*u+nDh{KrQBtSf3aWJ{D_S}Tct2m7J-#IvH>vu1^pxA8H5hj_MEK0}Q
zc&B7`vA09md<f6`6_lx+=WWbpt&nQpg(WWB9n>JoNih&bW{N{8pcMx*QhJyBs7CSL
z<&;-Sy4h$8Hd-K+(QaIeteV}(4mOf_mzOX;qj-bf>lV~B&a1TH5ZZBB=eH68;Z5Qb
z%{af^B5fiCUCQmT#+{6PlY-uweV7heH8FR9HRe<O9QHYstzn;S$(n{H-ae0e#imzU
zGkcXb@}W<Kfui2tWdpUC8>lcU82+sc(>GJqN*JbprA(;|(`n=`v)jmXXP=%cb5BnT
z=;ijoB{U<-n|o_;2kZOFhyfD32q)9KLQ6^DXQ?D0cKrVbQ&xPt*YrxlN~Kq`LD~&V
z>`IX_V~Mc*nZ$IxoI_B$%djiufVUuyb~{bmuc0S4S<jw2n5-A`-dQK=kH<3Np^^Na
zJ^4MwG_&>kj(;>pHtD=mi!y6uJD9RRB!(pBdB{NbYYWAe86|S-ZM;*>b~A*p4-jTs
z^v}}whj}|YNG{7Py-`DZsy@}RM5-2*ZB(Jzm~K2MMwjt(j*833oa52px=VA8F9j(+
z=lBXdS#yp?3z8F$o>mFt#m*{{QiX@Ofdrgz_VJZs)M3#)4XEg0aM9a_TFr8`F?cHP
zy2HKsMx$0JBl0zh`I}~mQP3qWI?TFYxn72bZSsOoX%<b`G?0oL$Lz>nBG0?!V!^al
z__$TL)g>!;z-bBgo1B`aReWv2^kvY>h+p?1YkFWs?Z%!SacrG3HKw7ixwj-}rlfv0
z2X|!qrld@%-Dvz{DPM?Rxe-N)8KPIwBkvrBH}(<&J!9p11M}nvX6N#`iQ>MT7^ipx
zzYx=v^(joo7soN<-pGyTM~j<#F*h%#FURV&%ZqA{LN`e&0ZfYu$X;VMTpNLy0$2dC
zYXXQ)V7H&YHhgB$y^ME?)Ay$0RKV4DQ>H#SNT7kZX0Q#-g`Jymqk{a$N5b^_Osp_!
zJ!T*25#E`;!7Aw368#<3Db^Bw&MT&LF5YKAE2Aa)CuE&{OBBxBKJ4H;-oJauD>G*&
zSYP?5qX_#`;ong!Oy~#Poq($F17z2eUDt2BgdZSBbJZy__yJ4aiUEW90ZZwL`2p-{
z4*h@z`~cc(fn6`%^aC`q9ryu9>qtf;*}u0qwK;cbzS=4}JOb^*Fvh6AQ?~Ias3EII
zaCn$^_Q!F(HXOv4)Z*P<B^&|%)MC;3_>Id%TcjJl!-5TZR`NL^tYeBry2m4v&-&@B
zS+}xpwWGNfGNsxq>TeOv=iewcUz&x@b5pY!Zz!T0TUG0*97o*Ex~HW#5i_Jnffljb
zRdE^dv<?B+UGlW{ffV<&UX3T))6yArdRp2C+B#1uRbZ+0B;bUe)*CJ?HnHh7CrsX;
zzE!q?{VEf=QvT9nZX6evmnW;(!NN^rqnDO}BDgjs)@5LgUA0=<$J{NpO}2^q&Kre#
zc?6D_SO<F4X(Ds(Y}nWO7`6@`)r)f$92;rhG>dHE0@WyEKe*=YHfySX-5>-kN6aK(
zckYcMTE=Tt%ZQ@vZY~pjTPg_&kbNg*>XY^%24rVhCb|Ju9D9VD^>A_M1Qxr7tA%*0
zbS@N9<3nUD_*kkcibX*mMkdD!PkOD7yV{J~ftJ63S~%T-1oJunM5S=R&*nQ+gZ`RT
zzS*GDf&H(tDw-5@JZl<XV^QXJkTpHnCnIWy9pdJ5zUW{s9?yr`GUn4G%5u!7JH9!X
zTzO}^Q+lwo#gDKwXo-o02OV|N1x}xeHG3ampSE4Ix0L~kTt6KoB$rc{C%9S1>b+ck
zq}D<}0`-x@1_xH=>gYBg<$$-DZ9cxmPz6N)S&2-J{zI>0`p;o8GuEh^vmdRa03Q~@
z<kezleCnDW-9&|o?nGyxC^c@j*fFc7cc-?K(EY5!CIMZ!p5F94WYv08vPo!HXVMQ>
zAziRTQ`G9_XE|7m?^B@$jXo7oprcPYzB!8eRGXHm)M67z)Vr2BYNsn8(!2ar#j2C{
zCFrxl>8DXKq0@gm@7~>9b#eu&ulKC@mPmpS1Nmi?sog+sM9cUBDJxXAhId_KsVXxx
zW=OvMGPB!>AKp{#WoB>o)=%%M?UtEMgObn9^YqlakyY!diI$nUI%@1Pvo|_;i|?X=
zS0;Aj7o*UPjw0+&MT@59k*Y=eyOaoHNo*@Yxj&N#V@X#@wbl$_tnZ*cJdE{SdSYQL
z_B3~4tP{vdEH#^xL)gdNY&Ft^vIe!iCL$hfoRDLY?jW4iZ-=vVj<x4#Olwty3EsUU
z@0Im`61s`EWd7OiUxj&tSI_d{g3yMc$>{O)%QQ*xK#_`XMSoLquIO*;0^^;M-SW5l
zWEZnJeF-x845A+QT9DvdbEmLUNo789HyZ(^^`7<`KYgz_jRch*L%ZryQ0X}k0uL%}
z!;=+MigXJZSnBiCNDD4W2_uB?xabN=&R#q7LJBUCpTMn<^tiP`bNND{Rv)EvHnCZg
zKHXEkv^bGFYv<1MMXqqwR=3Ehc6}<foY+O?_VC4LEuR?{0Gc>iFb_@4Y%u39Qb|c*
zz@3z-Pxeh1g0?fJn>0I?>n~3<L*G+t4DdKd-FvzW(<RWJ@lL6|nyNy=^(-Ni!}X-s
zdK2=5Zcrts%c+NM@QusYd@YqCd`*0!`I^^T<(mLq2e9o|jQl05qDevT1Re<cMr73>
zY{I3uWU3;e8>*kf&Ai&dTs(#iwPm=O5oI~tOvg8C$<2&5Le-$`Jbvsc5OdK{Azj)e
z1A&;SGbKdKFJ+&0b;ZONK~itx@eM@t0Y6WfQuY6t^#OlG{J4F<|M1pN??UZ-z#o8;
z5At|A&=bh2b)ZB(psV}D`heea@D|^HzU`HX-AqM`{)VFn`%}@Psd=Po(f%$ad_XxQ
zrt$$LqEW3igAaJ@JERY|iJq7b$e!lT2i)4M4OJSoi8Q|7F>QQ5L9zp%Z><LY215>c
z{8(GYyf`e0_u24oWpq!2pySPw-=RA>%p2^RZHF$bSw~BkRShaHrOM2P|Fg!SyLi7x
zaTxJ?wt?d=`8_3&;(pI0o-Ds7Y&Fu~iD`Wpx7c!JDM_H~6G^BEC(%!oONsNjmt1(>
zj)6jLd=dvkk6^yMUYx8KsZ+6oqNM}W)OHAPmwjE(84=YjE)$GP8|WXcg-<i5odD8q
zDQQQ2nXZDFn^K8KI5U4mnfhc$!@$+nnOS*yxzMC7l$&#y8;b0se5Ez38y?(4+5DR*
z<v|ZLN7bXB`NL+k+$Z?3qa5T>GUEIKD#_()yqD@KfD(P9`5N!@%1#GL?R|}VK`SFv
z`UtXWP${9WLFU2sHI`|zaQPf}GbW>3E9t#H^q3P8x<7{&;1cpzh=B0t@QEhlf3!%O
z-8Y?#zr@%#Dd>3214qA!tlg1u+*EuhTk{YHzi5-s&OV_@*qojHbz%v(ot=F=yMUiI
z1)OYl*42jF%+7{lHg>SuQZ~_byj$=Nuk7@;MXsQ53*OpBN}8ifhBl#Fa6<yB!Yz=a
ziyRWo+S*);sUZmfl-<wZ7M$=-=@x9GC*~Hgr;go%M0JoCWuOl7`V3pTZSUWDaae`3
z!YZ(*ELG^j{aZ&}NXKgTv(b!J7Dhc59HM+s^z9(!GaZ-YH*T$`%yV+pRvtpvhnn{1
z+n22zmi-^LuMH|)2mnUK*iA$47;>_Pj(*=A77&zX!+GM0<K9wN?%29Itbl77xBreU
zRr$(QM253<O?b`50?w@fQ0xzd&4V@t`z~Q{7p#`K&+M&QcY8UHxmD{O$b^u&nsSua
zXbI>e|5O5c&|i%Eq-9=AqU$9-?WOO%UP4r+?e!90@fHzty+lM(>2B5fp1(}}NKCpl
zYqU0=FHcNYX82aEZ-c7{#P_K%eoT|*hi=t+i;JvQ#pvb(XV;n8Q>80!0GB4dCYU4k
z87PJ#p^=v(Unijvd8-zc&*LHo-GwLmQ{JjY&obg6Z5ZVGO1w@Q@wns^e!E49-I;~0
zsWgGBFT`V)T#Qs}g}oH>V3T&eWDK2q3QFawJTkgjYBlJ*UPdslU7;bvBy&)*GEav=
zl=@(74Xs)u4B>CzERT^;<ROAfnBJ_%VVpn<dtoDzT(m`M)o<8xtskOqVlSOqw4*tl
zrv^EoF^{XYW@V|3m$P<vYB5+CTQ6XM8NN*G6stY92Zv`{Ijk1!28UEkQgFCEEZ~`-
zzi!{6^{TLTZsh0#a7r?j-9&~XM|F$VF^<zM^o4i1E7>7Ne5xc7+L`on>qR?NWQF}`
zi*~N|77>GXIB_Fr#!q}lq|La!Nm<^&Uyf#ZjU6Qx!s+T|S~RZemuZP%Ro*F@RDyT;
zYv%5eLW1T+vRBG6a^96%K=FfK`dw)RpYj%wp%K`tw7=vpAffgnx5n~fd>5uA(s6s(
zN?x<G`>U*#=cA6D06zxt_=RcSVTpsnM^Re9ebu&Cr2QP<O1vm77b>((D8;!F(7dPN
z9$G*%JgiM04i96oA5QgV*D^E+L5viuwTV4gE?67vb$zbi+bYiaX8GuXwavY_Py`3O
z0chfkaDKlCC{Hl($%?QGr{lxH(^2f+HllNs*#8F;w1A4&deE;$MP>NVxb7fWWs#Ph
zFvgHQWf8LmV67<=gcKJY5C?4SS+1SbW{U0Qf1L*T+H9XJFSujkPOrV0s@35g)#_k&
z2tC>gb`Xc{2pfk7J?yFuZ(nMqJch~%)J6ag(8+!&noGowwi=2ETFX9(fUoSSHgHRF
zo8HNg3*XW3B6?zBYxa~S=F9z&K2fVqZqqx7ypr-nt2l%+jmC$H6PK3jvFlq1*ynhZ
zIJ{eLASNu#Abf<d87vOnDrp9MckB&N>29k1g6+*YdBMHh-k_l13)H>4tOmRSX|CQ~
zrsdO`<14HN-yY!QtsIuUa>ElU#%_0U(d3K50)ne&E1K-qjNDqGg1Kv*4NhA4m|qoW
zy)>*^dT&9ArP3lY+*?rL-qn$2#2o|e?2yIc6V9)S!kX{b1>xU{^T5k_%!ZHGA(PKe
z=|Q~LvTrqJm&o2As-f=9+i%k*DRFvKOy1*X(tUH@UA$l=4H<-vjY<EFzZiEwlNS?j
z?W3~re`{`jaW;;b4QK|3#+$VGHDHR-NTBn4h_yR-xAIMp;;{Dnc#^O-rhCezV28!m
zN89-#`yPhk3q(6`;@y4|@P6pDdJ$((;$RgG^Qr?W`5u=^x^u0;?j6IP`cZaH3a#qN
zO}4649GgOeTrZ*2;bA^*4Pf0^p$O<qhp!9|i(>%scL|r@;OaJ(gW+1y^RbNrmknbV
zKd#L|P?eUW(Q)%^w+-lOyeag1ZdX~?y6aDc{N(s)!sz|&O3FUJT(7%E?g@*WH85HD
zNFY+;fdT1-OokdcKX=PCX-mcy3;AnA_PaX+N)CBCy(@ZD_R+3VyoFKN^BFM)qqF^3
zbv9$8_@g`N9zXnVv^+LeWLNc3H_6ed4TO@+tJ0{yps};5e{0MaU1qqK9Zm#K6enil
z>{y&d)DUW5hjoOPSkjyX`W)>789M8XQ%*nQf}tI!oO=d3-#~ApRVa}!FjZ^i_Aw6>
zM-=nUn9u#ig)csP%PB~5vQrN9*7NArbSEJoDs^x{obxn5hlC6ds~&k!Or5ocx87=a
zMr<uOA+vN?TQ@ptWdjw(r?(F>;gJw2tfy*&8!g7nUaBu=qs3OF!Pt9Tjs__oyfA0m
zj4<F<WYt!)EnwxeyU2yc624%N&84y1{t`M6LK51N!pfl}h{MlWh_+42Vn%2nRpZm7
z8d0}?0b_8WtC>oxwZGkhHL@=z9usee6ecyS&DmY+2^vfOnj-dM^ch*nW!hVf*eg1!
z-#p!~xA{t9TlF@e*|+F|=Wd?FwJ%kj#d_x^W$KfT2O4YJ_0Bt_aqB-fKRF4T%hx_*
zZL7MGm5ksPGKZlh#Fk&eI>yW~nR8+L%=3goH$_;V@NZ>pf>f0i8#`ZzOsqSax31D_
zy)$SVJ1>e`y)EjVYymg(&}juXgoGUNSFf@U)p10k5ZAKedx&Rln-`1EwB~=WRik)Y
z+<y7?-ArgE1>M8<7~=<#RWrs3mv6hQ@k+6LTUM1|jCDBCI~bqQ72Nb**RDBWCRoA!
z4@7{A+B!__OBQKUNcxc1Ud*3o?3)x4iuqrVwL4;tTfrU5)?C5ev1lKQ7473)6z!wg
zMf>~N6Rojo+m@_3=)|wu4lSIq89HL%9GjsX-)y1Tku;`UnP;1t$-myNLx*I2<+?U{
zqEE%9QW~~=VMqE@T+nt2`?RY&i;jPnX;R{QE%6~n+UHQFR3oi1uf!~nI$Zuak%5Uj
z&-|Ki=?!Uazw<nTXZ!EC(AOlm2BGt*O58FUysCC^fmc%LEaVQ*%IFnbjI7<UkcT_w
z6*MVpen5D#{7W2s$M@hfy%LM*Ij1>_us;<&hniukp5yPjV&8=XxiaG8&m^X>WSC9$
ziVXWMZbN<e1lH~J#3r!VQwI}RJc5~dNu4!$6*|i}n3mn(G1M5{J1Dzo2a{LQ_bkOM
zs}t2YS*}>;D{uNsr^^?CYw}96EB=2@Ca)fVDs{}(e)8&LRu0P~yC<)x7++tIp?g}?
zaer9AoCVH8ecL+`toV2M9XHJ}zbYgBm9T2*C$E%PDqkitk;$t_Gh&{5zcwGV*x*-9
z*O>1yc_qJ7od3YfdCcV1_mIgqj!3Q33iNNYZ#8B!OkO?ZXVN`+^;=%Bl1AIft0niC
zea7km?#U}&OuV&@%EJGxIeF!59CI*vB^!?EsuDI6tMnD4k;$ujp@=R`UJXJ+eDdmf
zc#4_4lDzsRuf#Xn<dy7uXtM7W%`M5~)l@hGgyCqSkuNmq(C6?rHGT4m&gm*tTkQNc
z%roUWn!Y+#g}l$}G7DN1<Rq&{7}4!u|FqLkXIkW}4(6VQA|Bk+P=4+bPD8!CBc6KY
zG!*oqjH=C8e2=FdB#xDss|6jhyNE?pFBI}X<DcPRYbwFZU@K+nlLIB%McZKOZc)FS
zC)hfQqZ`m|^SBx=?78d+GnqGC>@}3Ah%U;%RRal9)qQ+FRC;~ob;#t3y;`*XN5o!<
zXCWOKkW|vS*Q$|eCepdQcQc`x6m-AN9MFu3um_Pfy~|4jlRXobB=*Yqbi`iqUdQq2
zW3NPji`tI8TBJ=Or4#e#8T%%Mgkt^|WbKZaV`Hz3Imp(Ey;}88E!xM3fK#-OTcl0F
zq!aC<jC+$pLec&nS!YSKX6)6fzB&HIM{Yt3XU1MFYEa}tEF->EUv^G8^=^W1PNLXr
z2bNvgBb&Hc9bFgUaE?$cIP&>O^r;NRvQPa~Whj<?+TBp>yG_x>w=`l|hGHpGs&Uu|
zZ?azVObf+Qm3VJ9cvbD-0<Waf_39m<<!c_Eap_`Y?M|=G5{h;39p9nP^hzwI=bYv!
z!v0i-V%euDdXE275sH-%I8`WCI*qDVWC_KhJ|YxLPdpS$PjeTFJ$4K`n;WH=gE3j`
zm9MzRNiweX#8!@S8XfErI94OmUuunP-+>)Wo3S=xbcpVH#*yjclkA<`AE4HyFOr4x
zzAgV$-TDCtSRXq~1L!{+^ZqbzP@A;{`LaTGr0_7GU?M@oCGu<Wiwcy@$1ieq5PMd#
z`g~YlSD-T{T=-dJg5#oAsn6Rk$>T{8{}(@TcbHEQSA&UmG%~iQQ9IF!_<_HOuNde3
z1Zx_t$;n#1In)@>*PEBLYRzI}`bG?crAOe8@si^$iXQp<G#7!oY~p}u(~an1h4GCP
zne|qQ@4x+ZbB8Z~#~Ev@o2B>qI!Vl#HiCFU-5lgEB9(4<$!T=s|JI7ihLWy4OpmN1
z&Tv$AnPvgw_Yf$16b-|I(=LT!PlBd+81_s&$uO+6tTOJpLgQEqv`UFlpjF5*Nuc%S
z@O}*Rid<;)<tecZ+C$cR%IIjBMRKauDYi(tioLD{w!MHZZXLnXXrbO3A5p9SDdXl|
zEd8go#q@_dhL*BWkai^Bzy+9feyV-Fcu5Q64G+J<&3MM~r3}Ije}}Tdts)FLC&L)p
z!a0K38IL;_Qb|SlJHwQzPxf|<X0Ev7FyeG_Vpz-+x4k~Hg0VK&f8Hc-wY$!0ji@!C
z^b;bFEwnx?dPf7LZQW{?VX*h?vD`$hN$1I2S{^NqvfVMcLaWY}`cv+GWh@vSDH4fM
z=Q>f(P=9qQIf)qM<;diSQPOK2VrenT^Z7EI$O*ktBt64D7w38|?%CyCu7k=BLU#B#
zerYHbp;m@U`mR+uw-dV@E-sPZX&~awR&6Z6Sh)l3AlPqmYC33pDC#tmmq|ePbv$n1
z-N>rBfyoX<C3|g0Cs&D;p<zwQ&$pI_zLD_>b2q;yw@VWRz1J0M#?X$4SsW#_<r4iT
zh@gn6L7`evpR$TFg_h3y{y3|SNg<)wKaZ@M*b}bEb;<nzZ7qwCh->jvD0(BrW((eg
zFYz9E*g=gDTcm$FLTrw2E~F3}SnsNpQsb9hqFF~>U({m70lNFzsFpqzH~co)r)^F2
zH3kgN^<OlBxuRWT)mpx}neai8z{qBH-VnFlvLk6Ig`MBgDA9f=Y%gT?m>q~9eOIjN
zZ!`f;B%F~(oJczjx8((hE@Qn_qMY|0v!BK{eUgtb=6_)FL8mtt`_pT^&uhl~@)%>z
zL>6bsnI!R}Jghxj>)&&=l<uH>&^|M+I(3_Uc9gqm_8BKG!*d8ph#Q`T>?6(etoKS!
zH$80){y`v>G48hkSvAX(-QX`52A@~cVeQv2CZpD#-s_q-t^I1v+B2QH#JrtI2r;vd
zG%=rSkvAKuF6Q=|0ba<eU{cU6hG$?s8(B3ucVOWc@*4UiY)(n}1$?+B;Aq!yNjtBk
zy+n2)P2hzt3VbNLz{k5L@YS-Cp}}yCsA2O~!iNJwZyO_KlWu=q@^vIa-k$AP(+%`f
z><&S_Ik&qi>snCCXf$p?R;@87x+=>BR(R!nE!lu4c0)FY?s#|-4mk!qiHtZ7c;fix
z{H_ngYCyG%Gb^ZD8j_j7CQqfsCVr~oe)LNcP!;nf<i`4z>k_YGrg1m>w5v0X-}ZJ0
zTV}%Z{sv`g=Xo33-d9Mq)3(aUZ89gtKoprN4yCl)cxb{5NzG-HpQIXbli~6%f9I8w
zZZ_J2jo*M&M!PZZy}I4FZ9&hx9{MlHjyjUKnZINVM}Y^u*G;Kur4#HxJOtGdGPhR2
ztfyZRS?Ttm;~>z=DDMr1yn_xvN8BoyP_~Alwk2y?oOnb1b4w%fNK3PSKW)<<=~H2;
zsM~khQY{uYkI9LY@NZ?+U*>HLF&64V%9P4NRZpqz%TG0!%Q%=LCmM*nNGEkjyTMEs
zxz*$OW}(Cmw&BOo<SxxuTZl%FIqve%H=7O0X<M~Uc(Eu|1Au$1`kL!|mkbZn^w}^s
zV(67N!l_x={f$7Jfnb*jx+_f~BxZ2+@US5;#i=z0C=I`+ODrGmSB|d=*K1+o;5fqc
z{4f?R93;0k?bM>ZT%oQ3<u<AlA5b<XB4V66a)(zU_ITqxb>vo%%4q-o8d)`*n(WjO
z7f{`hNCKK$P`MaL2UB<}-~-6E$wJu185Z)FWNShM-WzQr56#|@5lLn5Ohav(Cb5!5
zPO2p1T5KwmvvSI&Wmw7bP1J|4Wce07v6U?BY3^3CoWKskq^?!OX=2z%=v&jmf>60|
zWlP+?!$F&72Wwn5^Z8Obty5=Gd!Cb>gujOVbb!=;C*f084r^F&?<AyRd>ufprl6gK
zkB0>WQ?s|~#!^i51kC-Tje%R`=nrZ@T6Lc(UQ<~9)kjJWm6b%sUJ$g_*>=P_6SWp)
znf4h6M`|rl^fw$kuYa#<vcX%En6*JiB9m{(kZPx`gnjJW&bAV6_cQ5UV{`&9SV^Vr
zR>E`q#kkkv@M7W(dsG(wZ_Pz3&c-ssi&oY;O<Mf&6~$v@`O44G=ex9g<q{}|FJGC$
zlU%+M?WA%c%R$asXiHjT=R+I)xiC#hmb9FG`Wfe6aK>q;>^$T2ZMlmu%kRa4j0xu<
za@z5C``aWnAo?1sO`1;h3$hl@EQaAYR9;UdanrZO0mtHNVgS>dEPgG^Xic+wf$5DP
z<+C!L*?>EcH8n7$c4beqXFd*ZuE#jEYHB)BOl&u(cxx2K0QxHTft1*4cr`upYr~BI
z-dn;At=4q`YImN#uQtJ<u>5m-yQ)09lDpK-Q(r9xlrz0F<WcKk9}yLjaNFn=X)izc
zlts*J{x;wj&NXqs6m@ckvPxX5)SH0+v7>q&oj_@cdB>56JC%p6q6abiKfd1)=Y~6J
zx0EzpXFfWl)^(!0bh{d~|6{63i=h2~Q>H!%O3@-+%jJwdzcviyXc~zG?=Q|6yzdd$
zMS0G4a<3p*PorY;(EcIs3kN<|Xn#HZoG8}ZHne{bNM#(+HXy4$qEYpx+a2)g8qtzO
z^w%&xqY-_2uZzM2BORWqwVjA_{1MZYPqvCTjjJB?Y9IA~A*-TEK{wAHaB()WYN|*W
z^>^vQwe?2pNm{%sJXI@HjWHo$E5@`;@e=~8yb{&r5rTpBmE~<jrv=E!r1;_k^r@J-
z{5|_LULo|U2#`rTDo1Rywl>!yKqfK1vTzv!WY?qWJV15>J+S~8dz!ld*_Lv%SRWFn
z75IW<VOZ>0ap+#B)ImsW4RaNAV(<{CXZM%X2CwD%?>v67E-+uJAjMtYX6g^Oye-Td
zv}P^rWLD0O@a!k#Q99x($mB>2m`CHEwz6Nw3~m8vQ2bXuNL87QZ7ZuI8jSb;6@L-$
z{|@lmCGY=pAjQ4^ui{C1|7LrUp1-sG!F-fXL*JJ&gk<j|adJ=QxtJ)oHvt$(=WE<^
zpv@(FiW5Z~Z;!S8`$}aTi_fR{_-$(qY(?4Fz$yB?i?zGXf^7znTUd~f0tNg|T7Anv
zZnRcxOl)lCrf}wdDSs(lx}n|Hz$X_sW4aMjk!<fkAy2yx=(ae_MPlKq;20Nf(6t&3
zupVwKz!<+JdDVV!&7BQ>1OLAY2}(n3x=yK`jQ?wq^A85Xc_JQ|^Ax%8!p~j8lZJlT
z5l?5zlZFgUGco#fjSmcMYraueDmCwZ6UU_!^z*Z}IAzf7TKGqBvB_x;%{Q#YKZ}Oo
z-0IX-=Pj2?JHmPEqfDWBOX9p8ayEbi*|A+aTa(qII?g`gz+J^1IBkiySc@zvSj(@-
zH=$$Sd#)DWu>!1*LTY@CR%9KySi0r*@D3vnk5N#2gCsMq$@UkLbhvM^M1H4rs_kBh
zr*kY$0IiHZ-iwhny<<TGq8+xBPF`47LeJLjpyL^%Q74by$2)nB)%i@jE~yU@B`)=a
z>?2L&d8-uD1nDAg>s9Y&6)_3uXv*Wt?L}5i;>p&@xdbj(=ksbNls2pi3EN)3oM2_#
zwIn?*S!-q7b@WT3XhnM;`8A-Gu_@n-teRjG`p7QH#;uGCo3C0A-Y*2I*WV0LBoOU;
zVnusj7e)K-?4tefEQ)sbZmrAOhQS=P<AV%ay>iogD)k$&3TLp5fap`P>X3%Mgh7Tw
z6HpaF207kKY-`rm=2`?9q)VYj;tWBCC%_~RGW?33Sdf7|&0Ub;*%QTmL*(2f3NW}<
zIWmt@Qt2SLz^8R3p?-O%W;DRCM1CWK3+jc!p}p_-TFX*Ux~ZtES~}*hhNW2)<_#{H
zwZMX^lpRzsPiXFJy~UAX)tm>$xYt|sArl<26zeUv_=|C`x8TLZ_eQBAT6=N`V<{dP
z(6{D#3#HV`!NlEcL|gcg8=+=RxI%VLoYt&(i$q%Hf!8iYS}p=99%<Q)CmCr`okvDl
zRvA57TUR0F2Kmn?5hjeVyjWiZLGg?BOB-;26pr~Rl*-l7VYwGqP4*hADu|#qlobVI
z(zu%_VK80Mj<pmuqR;V}YiTPJoyNVfg5na3H?#TL$k@ArVjQG00=O%XRReIzmiAJM
zv0ag)<D$)4{k4gXxw55bt<)%3Bx$K?OlqjGn@qd~3Q<g7<tC66>n29%k@tlep8S1>
zC`mSMvjOSD8F4D&2XCcJebVSb4s9oY7f>tagR43#>e-P{0aw2{hf6t~7xO$z_v>RC
zj?2@0h`8tdjkBfn_DQca^zPK&A^I3-W$aI%LsqRnC3J{f9qOPMxoDjzoGtvYgW-6f
z{(x6hcEb@s{r!$2>`w(yr#6-lsJ}S@RRPpx$CAz6-!TPHmm`yE@)>~oAHgIC>VKjq
z2GrTp+yV7L&8jBC>WR#A_M3LLMus{%GXsZtVI_aDzFq8m*%)0TuVxCDX;qR~-gu|_
z`oSOIHdZzT)AIS}2@eeO2F+Q6^G4NdM1MpZQ88iYH_EJaW)Pn#T)tfYOiI*zsYJRZ
z6pPapaAWjmBNIl_w&xRW_Y-&f8G^VPbC$?fB<rGHsCt~^FDlhJg`9(UJEOZG8@VXd
zx_#46>(_*|-=<Bn2K1<SANBL@7Sk{<SgF13^7p#G7`Li<F==Gs|JHQJRHv*QL)^`V
zJGQ@Vvf}5y6?+knY!%q;l1KJtkm4TMU3iinnPCE@Q+9yOyXKck0Rri+CRrx*%bs^3
zd0CipZnQ=Q8USwU6h?X85qnE#-Kk}n+zrFzLe}i6^}kmz>o)2()DUxpb7#UK-ghhU
z8jA=X+L_;56bl9N<Cw;;?_mQWRu%BKIJCK0&R5Hq7wfcHSOdeP*I~Bdwii+^VB0Yc
z4s783<SK5W&W#oe<p$2T!lG)Wg4|@SOoQxZKI>1Ks}~Ek`Y4EFCmn8PFBR+MCRPQ|
z4k&h#rmoN}8Y$&eZ%J7N&5C`@(xd5f?{8O@nL=YhLFF?<!Hx3&&LVD&{MxpI_9*`m
z(8`GNzlyBsQ9gBR+im7<3^{0g+OG0Zs^Q`1&^lt0By&_RpTicRI;gGKcmuC_##(i>
z?lQxk@h?e+v6ExADG{FWW0a{+jz19m|0vJ6_k*#0W;y*7D~)uX@e<I=*k{%uYj^rg
z8qauvgW-73xW_9hyWt4W_z$d`nwH4^RCvbJ#u9qQKTAMWc*e40$&u6FF@<L=v4Lvx
z89d|jATRD2pHENBGiFb7=NS*E)2HM1h3E3kX1zSpY8G)V!jUmymcfut>?~F=I9e;f
z%cY^&edY&)X&Rx!cfg)|F05T?XTT_^uclq9(c%N7_C{Iiinkg2{o}DPZ&05#|5&RQ
z_l{p8S7`=k4GfeU1NBC8V1S@Q%yy59a~JQ@kcHy_KEB$izp{O;S^^r(+a^6RJSq8I
z70STn3|Gzu3F9sT8t+cTON`l5$O;|r4Edjz3yaWaCSLC?qBLyNFI^ZCHvv`3O)zhz
za(UBnZGw5bmo0s)XuDkJP9}+XvuMtL8JD}g2U)eDBH41CgYJr=E4e;O?q71nPKCzS
z1@rW?lj*HKXqrM#f7s(AL{G>aZI~TPtF^e#SjCxQ)8*bC*FFqd8OP`^BdaF(gwbo4
z<dYrtsAR7%K(S>XKc2}544pfn3|Hkck|r}GDr;pJFT3NZ2ez5!Ui&XdcpT3MnpqY;
zd*yNb3`4<Ir%MLGc7b?}^U*7YU%B=S`*H>H$fbFS`Bho9Cq+pTCYWu^Ml9UHu8dG7
zh!ULsI^@)!QveKEF#rr%T^suJ^MlxzhU4+Hu?nMtlkIvc%O8*!V+B1ijKQ8dz!;)h
zG#U>|OU*9@h~29ZET+rt%eZ5PhU9I*K(jV9lHao@zo(ce0Dn|0&Iswm0u4S2`G5o8
z$)U5vnuU%XdeyJ8$>^_CJ2?ho)=i(OZ9jTAD$E-+W)D4R66EmVO;V{rsy#T0`^s~v
zB8=D!pTfb{S7^F1$3=n`VqJ*hE)s?81Gn9=ZIyFCircdb@g(h;-cn=`($VImeUs9I
z)i{C#8E4=6O#}BjaR?v_Qt5Cm+INOp&2qIdcq;FK!@c=NqgE(mU>%iv>#<8_c$mf0
zhBxQRV~CDT4d(hOuBC-G>or`_0qia}=OD0FEDp+5X4t8wbEJ*eyF{&|Ej8f*L#lGw
zdRyLEZ!{xdMIz79!eUWHt?)fo;Z_Gt6$C4QRz|RJ39_aK3)HIYAedtzp{ZXDx6Peh
zL1QMhvxwX}cZ1WE6lo!WezG7=Z{$r=nqqr7!|PB|yb-nsYq3WvWN&Nw7O(8T&AGx*
z_WngOP68)fOZ;-2@N&WW%<rJNH<ge?obO$fsZSbssIzUHZ?$wEc8R_i**P=Bm%~Ih
z#K??sdt#hNAM}`QA9<zkY8+0P(((HYRXg7C`#Y~FbqA!a<M#+iWi%;YMOMwEBy;>+
z7A1+}_esWQbYl#?*SlVqZTpXje5`H%iB)(fw*7~!f+hvsa+pZN@W6kCtePScI)W}u
zq_OScdZth{#_0#PVobvnAJzSsSEjl|LW8!x@{u;eqfbRtmn@3y+SpXZ=?8Zupemxe
z(u_)oVb<2BFPtukwv>U(5Y-)gP<mWj=!tn;?5P8fOSmvuy{%0E$dyJd*}jA$qL6El
z2Ua<e4*V?P`AcRZPS#?<rySP9zt!-17G$cM7qfr*-K*2Xyusvbx>qE6d8B4W-%7Dw
zc^TDWHhin)hSp7UNBvhgR*JQVV|6lE?UG|P4pQ8)YT-#bR$&8?UX|U#z$XhCNudFS
zo<j0V=u#ao9hiLXB^REzW1vtQpUgMQBh{k1N)vzACUh?-T-A{=w`%NH309>MGaI{Y
z#KfYGxoO%E?Bz<ZGdx56rc`nf$n|E*)F-=766Ct_^m3uecYL2RF%^NWuZ*nX78|)K
zTO4LJ_i;xcFUpBStZYxQbc?l;Tr0glKy~FPX#sJgc~%d2Wv4^c_ObH&K`SFxeF$08
zLnP|^w)?wGlZEE#hG^(LjL9farT6+sVgl6!dtkpt1h|l`?ZscWNSpmOos9p9v2Rk)
zd%kIx4H)`=k+nNAj@w=w%GTUo>=*62=u9M<y{j2NsYw{0Xs!5ni6z|D;rdN>0nhu8
zA>d>Vm#Yo;iZ)D@q@mS1gdh~N0qAWhn-Di1(7($oJH2fYD`J_(U2UX9p9(-vhBhIf
z4-!xnfL@L+ax64!YjZ6Cy&UV6-Om8%PlA^DGL4hzi2-`{)G?q>REJl-Q`)J@RrJW9
zpP5t41PMRWF$?tPVHM5|tH7SJRH3w7>LBy<&oSrMYhz`gsD3t}VJDgH=;G36`mv7n
zCF?b3M7|yrnN3FoTxqMce6u|=f4{bNb2Hubx}C0s!Gh63sW{p~`Rs2Q%~oqFp0n%3
zqnpLcn%i<48TT7c+MGLawAd&NHOhNv|97FdEf;>0+j!DRA_9dmNT^6byfNs*V7%?x
zhY2f(H8i-_K2R~fKB-RykAwvT<C)#0P+7F<BxapY_)Vx#*0xI%;r!EqF7-?A(EXzl
z?X_V&xMN}ps=su3=?bH(NEwU+%PJXE{*uUW#?*G3#UaZg7A5~y#oyAVc;Bvhck#-1
z+>og03jbQ|s-W8qCK~wyc`RItYU4xnH+~yJ_`Ryxd%QJ^xeei6$mGL{Qu?$b{hjPv
zeRsa>ouW#LZO<+5k7Qx<lf3A*n{vMDC+^;DB8aO^IsDcsiPXvbXc*@^{vuLs#^EKK
zqlP|adZoY8w1^QMEDe9>jcQ$>y;05PKmGM_@0@uep+5He8`F-OoxSANhajF%AN%`@
zNTm;6avFX3zcn`mIn77rnfSwo#%nYlHna;5wn*DO9W1OD$I7GAm0O`H(-|R5D1t<a
zqezfwH}WM260LCz1=E#597$PPRM~?6V+`;R(Mix0`}6wg%5&sT;D&{Qq&<h784@iL
zvsllKoNXDqmW8S%@TDXGd@0G=qilO@M$Fz$Yjw`0Ck8Ls(;Q*54Hp(0v`xm1%^Lhi
zK(j+Ng^0I<B5PJ;_GOX3zfm3)U~Dve3Rk&Gm_|FUis5%HoYDub)sM|qL;O)MR*U&Y
zQT$b$xU^iaP0-$2@dn3U)Q7MVDST0$9LkT5)=^cNr(Uns<sbC9crWTr9i+H@V}24F
zjS7s7jWZ1!EnC!n$?Sxc!!nRDuo0Q;2JIR)Xa(U&SU|8hGi;O%$%7i@C!(#$z`6pB
zx}}gG%Yn)Hn;N374eO8rGKP68e@TxK$QUv#Afx<S6@N=e!d<)<GKP8e;uU24?Em~e
zC4h&*vrA;1B9LT0evvw7&q~Pe2?ga6avXX^CM;cP3k(0&PuvYd-o=S0gdu<DFCrBT
z;U)W_1&x~wlyfdM=}X%jl|Ft6rBBaF`rq|)?*@V2<VClY{-b{4Zs`l+38nvge-Wvq
z&r8lI{gvi;7}0^YhFbU++8d>h)gSiaX16|8AXAdwaD<<@TOWdWLVXPQi%6vpUUEi#
zEN7=w2s{$e#$xfS>=ohPN)u=LYvR_#sR=c)(@)&32|+xeCPw^4q|yX0Iin_4jOti0
zqKYN*XQ>PILMh`4e`Vat*q2ZlH~NXYl_7{HRK^|tB2p=Xmz+@<bO3`y;t^FW;y+47
z$Ul`D9`skkt%mm}RKutJ#NBET#1pFFEB+!<sezZAQ4Py=A1I=S#o||~i12Tvi68rG
z;?~6fOQ?z8_=&qUA&4i`#JrDq$GKFR;3a3&#QwJb8PUcv?F*?9<DJsVq5fLAwXzPG
zl8oN{e&TMe2;vE~@;rYLskFjN&Zw1DRtzAblwS3L)QSE|spLF=mE0;hC!tDq`-!_%
zB8Vqc$zFdEsZ_#C&Z-hC3KLa{`XE$^_DZSbwf-u(RdP*2mAuJM+^rHpJfTYN@)wax
zCA{Q}Dp^)kaj=Lw7V#gYD&(I^4G;ON;a0=nCRD>0{KVaA5X2Lz;a~klq*4PfIinhu
zh7rh!5*E-;QU&}ErGUr%6>uxy(S!<k+E3iA06{#V0($?pdt*2+Iims)`eq?=N8C4}
zk>&cgQZwdDrJ<w!HFRs}2xLk!o^SONcWX!xR~lMjgt=vfthcI0C;JOc)oC~{X>{iQ
z)|xa6BRg6EHS?s|de@|xXbRe#8On^GGYc7t&Y9t-1aoEwM5k!1DKpUFQ)c7PQ{`6t
z8BUquIh-=XGsUxM%8VZ4R!=9IG7|)7%1n^8XBgT}nO#B5vMIAG>4{C5v8OqjGTVGg
zvzafHXiCXFYlbcQ;`fGiXpZ*FprVp>0_|0bME}TCvnZ#mXgSpc4$~9UR#?Mc5|4Dj
z8rUAf0z~;MroM)-5kp%m(%61xzS_WfKNLyqFU`<WsM{=4(SA<r?N*LNb6Ql4-Qwcr
zv~CFt2rkV$r=_ddGq0t8rqmdn-qO$S((_1D9Q(U6%6}79%QXe!Um2xDQuz>(v8TCu
zb>8_*m;OpI@qgMd;hXGoGodECF6e&a7j0infAp#{#BXX<(n9u|)QI>?RsG+*Rgam1
z`e$THGR*(TPuxAs3*u^+_pVI(wZDi|gE}wSKTyjlsDI=lP&!y)7`BKSmdKx_Ce#b1
zjAbA7qDnXBT8vCdlyQikxLX;5ctT}t^cRsz8NB3-%2*l>D-lI3pr51?_#a9EFY;Hw
zt$-5~Dqx47xLW~&ctQnS>@Omf0(i+86|g!om`4<`T>nHW#C)j~)ACo$t(Z#^D&|^0
zakpXw@q~)G#a~1!#qg3dD&~+_NEK1g8po$nPtM<zy58rnu3KIACREqQ{lwks62z6d
z7BU<u>m&YBHTb;0kW>oeWv5Y?|69{pbOMmf&f*a+XHmm;%3=I0M!;ByQ85*97z5->
z;4rS!97er-W1S`Oz@5hbguW{Dr*s<WSvrjp9l~jR1762Ejs2N-k!**Tg1M4nwKiEC
z!WrG;)=^?w4K&{>N0&j>M&XA&$6Z_P+d;bo(=n_3)@rc6Z6|#S7)Qv8tM2s!$M%mF
z&Czu92i1XAe$0nu{JZ0O!@R)_bK~no#3G#^1?*EDNTzC3IgBdDT$P#cq``WRrsJ<k
zP~1j(??Q0jY42tIlrNP2GmzsQ_=R{1boVTXwl2A~zD@g;-Cjx>-F`6%JuX&c9bPsN
z?zErC$v&N<KAjt*I}=Jck4$yvaEE=$T&km-CRmd@*{sOH2JG0{h=0fKX4^5v&iZFm
zw}5<Kq~trp8}478N?c;Y{Y8|iPj)@HOKp#eT7a9l$2mGsm|=5dn>{z%{IWFJRt71n
z^R~1NF-PGUIbFMt8^k}ixtuZ8d|F<4q}$+q326B?Mw!FCvBCS*$eMnGH+6cxiJpz*
z_v2)>;9zYiGz8<?jy&$*IDWfv8DHx=920ak97pRYLJ!ix+Q{w3)XaSGJo;3eA9O(i
zs$#pb>|4@6#DhbkFSdh7gQr@3hV8~52a`Ow{SZB|;5K{865QqprOzHwTu0G~I!LUB
zI!FX(OSf%&{_|lKz7SS{J!Ppv7q%O3KI2lvxGyZ!TO%X5*TuQ%xFLSE;`8$Lph3cf
zfyuWX4;WPXM~f3v)pA4bL&3!}t$L$;X>nG<?caxL^nTes-2PK5ht-qaTS%xFy8-Dv
zS?)ZfEhOI!3+UjS%1~pTSbO-5p$`c+)m9RHi*cAoy07jZ)gbYQur}$V>`D@qr-_Um
zWnW=2&W9=Mtzu=_$4y<En)CYwZdMc|KiuDnnY8r#_f{C+i=S2Ke2M&7idnr-^*Pd8
zpO^r8A2KD0*>3R@cZWIzaRpnv0rc(uB2oo9c**hOlk8yZs&6g=6+mBQ*_?<vmWCfl
zeQ0l#LSE*tkUREt0q3UewvJIhakoMQaix$pv8TGfkW?z+Wv5Yz|64Qm<m`}{-CF1F
zUTN!8;AsWKV<J()Jz{sS;>ZRXm2bd$C2(DheR*OeHkT?81Ker7i=OCD8Fiv(aKm=@
zN^6PH<Xgi2I(PSGk2*b{31?`uTxeSHCMh)&E2wzWW({P!za3PxO^8vs8+9~BYtKD6
z>y5!dquGzB7oWnvCOl%JS1*zeBl;`V#Xn(jkY)_|XqY#+I&*9(6j|zlT@!&E<JI^z
zPi$3FMp3>|gOYrMYfkjdY+nnj<r?8*hM}(_lh5DN?e!NEd}|s9CF#mP5O<x$ypkD*
z;NZ9h7a#3Xd`3*hhroA7CW9FV9_soXXmP9YCp-lfKnnDhF5_H>##KhUB~*$QR_4Pb
z<zzvwmv6-(183tb{Tvw&Y*x?Lr*a5vP2%`{oV?$x@i-TcPve%#Qc>6r97zP%h2MUu
zWyQ(+`H87sSd~V(3AZ6f#|g5_4rRVVzFKV{jMgYt$LL;5?p{=<a@gLFthtF|gU<X9
zY2t#8TtDu-EL2;g?8;2ZC;cEk##v3|vowySYXOMxU`UuMv$NhR4)*S(fE}+$ZnQ?3
zYlz|DrZ427dQIl*SdN5yH?_)_o0K0P8Um8BzW)_oCgCajz4#$>1TpQm?vl~SE<&Eq
z1Z#~>wm|TXp?roTork58l8AI3LYexc!G(2iAL(Rg{jlhwLa1waq_Z|s>DksZOkX$y
znky-wiI29iPh649=Mz67a%mkZbb_~jdgOA^<kSF4F)tOOrXj9NI3ARI<CuvSjkx7$
z$g0IH=TkAkGMpn*yo^rJC^x5XWIylA*C(cLtlWnPWrgfFk6JP$$fB0q$0DAr0~5D8
zc#Drv4tQna>>2ATn;b>hpNaz!sd@N9AXEVnp<I`Ms)$g^K9MRyDMu^SS~El_uLP4k
zLU|QEu?Qu5$`an=$W}xsGfxEzP)-BWOo4Ku-2o`?bHNJ6Z?(~kh2^|Z1D3N_%B<fG
z73hwEY1aLroi~Mf=Mt9lI`RmYg5~oe79Mg?z+Amk&|JM+7qDj~nh%84O99XCLnfbD
z)8YBM6MSpJb0zW0J;dGI!E+{c(?*jW5+1$cGXl?V0^i+&=U)dc4$r@Xr#N`dSoOkl
z`a*-}QnWx0H<OeT!t)*p&xu?zU>-tWVCqIOU&qm*9Hui8dE7Wi2wfm&de>m{*@V4y
z(Cq;2$}MMLy;?Og^a3o8l_y3UgS~Jl;t(~PHWw&7gx17`;auqWJVe|7D~mmY+Oai1
z6wOEuwx*S}$Njkn&!l7)>OdFxzUl%q44!|VN=gDeKS`PTq&b{>@Vw>|;KvP~*V0cg
zChk^{20X6@CEqAx8fF7LAAziC!82Lc#Nc^_gSU9_ywocbXU|w)S>!0f{#1ZxY90x}
z^RL;b{;ny&v+NU6lkxF)8WhFUxExDVYs~<jUyiDC@casTV&IuQbqt;p)j<ZuQ3n|+
zx24;5dVege!k(}S>?unXx-h-J;oRCpxrt?B&WZhT{-bqbrFc6ivYNm?`Go!vB0oP%
ze6m)@&|1chy85O0>h`V2NnAfeJLax|_;q{KehU9}Rt~GPxTo-`7`u_^y;VYDn!>*_
zETDr^Af<9VfqwZ(s6XyMsHuB>MoE4wr!bwrDZk<EVI5q4gMWLRs(<BeM254ardt+=
z4D%r-{96@&f1Bcc8{^!?E3axD+tnFqr(#w}d0I=u@3_pAzh(b|!=BZ*suG{^Rw8C<
z<Y8p;jf%3N(Ny+B>|5=O@MT)R6ZKJCFOfgWCZJv@p1+la=YQpVw4KEMiJ!Q85?c^g
zA;SH(9w%!+kBavv{p3?kU-MGqhm)up{NI``u(OF~p1yYOvlsnc&0c>1(lH^G=Ibhk
zBEIfE<V)b|>ig_v*~XR$DxdqgM}HDe^rxJ>re`q2Ca<N%K=Yo$>x6!5@ZR%_b*z#e
zZ{$kFe6?B1!3!<y#k>zDdEk}OTuZYEC$V14kHVQO6m!K(i!}8l1}c1mZDFI0Uh-F4
zlbA&kPAvOiB45qXIc>$k+<9;`X~w1wH&$HxeBtTmfF!(MMw~gE>|;hNU%*^Wp-`*S
zWKwlXI+y>07*-vuABxk*T5IHVuNcpM5V9PyQVxM=IU59{Sn4z=XZdj%77aH?T!r2H
zN8;gV{L?rN7Grs29dmrsw7q{@@Eq2FhInhT;;E9ca|Pz&;RT?pjoRu4>!U%Po(Z)=
zb|n(`ZJ}8w3N`3C_RcIf%i|-h`BEwN&%KKE2T;!n^9Gk?Ue_Rnm0Z<E{i7=yQf-n^
zRj9m@YSURnGLbnB4s_`;eyxCFF=C)k1IwKlXl9D}Qh`fAireTZJOv>z3(STi<B)M}
zQQC4TO!UYzNUq6ZkiiYYma~{1>}Lzs*RblFdohb&M}K9r_(-I&=V8DQi&6ZN?EXNt
zJdS-dqnMLF@AUJw<?^jP?3@w|4iq*VYc*T-Vs2j<!^U_GPn=w6s-H3Zs1ExYAx>#A
z5?SK8?Ve}^SF1)a!%?`~Q^`j};clf&ebNK~h0pO6_J@cccNFf!-uk79!aV>=K7Yf6
zj7AjhVPs7kg(JJdqi_rl`lqn(ckmV;g?kUaPKi#|SMG5Xp~C{g$RY|y&BGT0pijjV
z_8SvW6;U|ZCuC2KcO!_th{8#0s#<G?DBN$sB#*-Vj-FT)jy+`wVQ~zTW|NIX_o#!!
z{I+!4M&TBGN>*VZJ+UgVrz}<ILKJS}8DcB8I}9gxl>sRprXfZ7dQj#z;bHPf+)<K1
zKZeWEVt88%?IGpIV9jta?r>;9?}F`vamQFWtbxoOjH6=gwxV}h>6}wA?$EG+U?MX-
z4K?J!r{OnJ2@;g5c$~glCj4B+GTc9^A^(M8Mbby)ln^T0h>RVPTcUX8<BfWu7&yBP
z1HPD?n*kM*J2<YviYS(f$}QKw6u+t%*JAOj6l(als>YDF8ZlA1UC5MV-^{q5xI4ln
zh^q*fci+qv{vuLExp>L(Lyqi76m0wpE&`<q%)d*s64Ap#_M6m#_)F<v+Fu9vR+%?)
z2HHj$@AeaS>p&1ssDlUnMWoUJFFB14{NI|9MrX&%9BFi}g_o90g&NO+cud?#*hMU>
zQ5;1)*|o@*z?0RdF2cf%SR*mO{n+o(6a6V;jr0s|SgcXnLbUFK@H*B%jSU)UkW3N)
zoRMVhA*wB$d5oB4XL|mEo*0~APjdukjy@Ybye*W8-#1@cw4*tlCut9q)+dKCXHl{J
zlliG?EkBA|i482H9nz_v<0X#rl!x81KW7;1EP6OC*jZ`iNCbAM7`r9Kft~%r0)ooy
zfE`j*mx0dFVI|T79VLLuQAEZDI{Xj|=~Of3)u^<!O~F2Z<1SbMoKrh*&SH>N1Mp%&
zlMk~R2r}NU3&QVIRbT9_Y77WE4ViqQ0v#=!%)Zs8COgM%Sy<l1*=UOy#{I<Im_ZOv
zh#9W%7m*4x@RI#FfXpu8wumN{h9)!u+ZNDI61DL^RGXRhS0DzoB~-xOe&TKgypa=6
zsDKCkMWj*yFFB(Ex_w6F7yT7;E9P@tc5QpcH~hriiV?&UD(1)jB2p=amz+^C-8f43
zkN(QImGM+UWi0=+2{|kP;Z}wqo=_Qw`in@V3|?{?W%$1}T^r|+JJYVspFvZxu8ra-
z;@bQHfW9lP4Kcu7o3o&)3jHZv8+w+m%~5zJ^n(H5Pd?Ws`xyWOdy35=ETWjOcN<BU
zj2%a&cK#pbig*$N8w?4VanH(2tfuIj7T@2b<d_g&sujb7T-qBo%8gisnqAC475=I)
zZ_u1Q_^r#2<6Q+iQ%!>__A8TA6Gm)?J5;dJR9yTFxZ*C-xn2QoJL+7l8}TXd8$gTq
zubc4{aEBq#nu?tKj<z`2_oVR9_jZvS6Ha??)Q^9pOQvXv5^mGr+r=?0joEDMhYhEt
z6MwH7_Z@;AIoV`3Zr!UyUF81fxogT0;ItCp3{M%qKb366l<|F(sZVwnct>rgj8~mE
z$&Nj!?qZuEu?UHbks6#|#y3FIF$S~)y60*@a;zL1l-cm=;#|+gJ-fU|LiVuBOd9+Y
z7G&YY^jEIOHe$ITDp*gOsHvcB!*(gI9o1i;x{B!m$&I%9@{3;i=~L2+v8$SjjonuL
zIgs)>n&tp(%t?P8S+zOo1+1KQ`>Ls@^GRtoy0S^>RhHachd_RY@ma#A%bwgWO%(KA
zp9V9<{;Zh8ICYh|<o|P`%H_Y1wH>X*UsxrY9a|Uv5(vLg#c3O{(*GH&l}SN24Ib(L
z4p}wnFXRPf5x;(ei!K<i8s_cRL}Dw!gqHEk2p;x|QWr#MBiC0x(MD$UsaQrpCc_uc
zqff;$f_oEC70U>uos^c{tgX$pSVka6CuPAhEF*aCBj`LVXnj0Av7j}3$`Z8Zm@myT
z0*P)>2Z?!Y>9&o#pBh%-w6F^7DN7a9G6JQ8U`c+mJTO`-G^QC&A$_oSI2eY#+Xw^A
z4_YquB2+$~TaVIaV6gdqOW3Hj>IKAXHU|f?b#K)?4KG8J_1c~~Zs?oFa@SyCv)0U4
zr_aGT*Yca<DE@4rt(E2lE5&NMAwg>gmizJbbwkziL~(jYu%uCJHZck{ri0bsxYaCI
z8-rtYc5l`wAlu9G)fQIH-a5_4mS9n>)tqcKr+1WA?I7$lQN%L5S{;;@!XV?oo&5MD
z{#eEfq*C_c&tCCot6s%lE1I>!&`7?pmwrXT3u%4s)O2vbSgqE?2{}dW$8+WdE3kmO
zInf#)x{Q{APvgzX2G;XV4i#$SwAil!lI!`KVztQL4AF|eA!eh%JW3Q9$U3qYxG|cx
zi40W%#2~)?g5DC=mdigE2CIvgm77Df*1OeEZx@ahM_PM8ZzY}G0jc2&tPCH=8`>sP
zC{m@SUl*(_Pe4XEy}wYSwc*pj(pGb9-~|JXGM*1Je;i^Liw>2rI=za^EdyK=UdOpa
z)4?h(X^qN4MrAtavwpEiRQ92%2P-*U#e>X!nE8X1IoO}-(14(@pnkH7I!y;Fs`-gM
zt^A%MBtDA2_bX0J2Wzl7982GaMvIfh37l$Kpas@Df<>6R8ACN8k@6_oYH_T58Jxdh
zWxj<Y|JAEtzcQK^F0&t>915Et1j}B?mH9+)6??-PH`@gezM5<lTcfq1%f_im?T@on
zY7N|zK#Tsdrk`@MR#IpVU0TKgQml!t!nt;h{7985BDh>Ey9T=1a#W^)&cON^2&@pF
z4bj{atsW27(Gv>6HKeRB;@UY-8->c3)${wHD*h*$=xXX;XgL#m&=A=o)#-Eh-x#c%
zEKUy5Q7~BJTHq~_-i+kIJ9UoW;8L?W+1R#a3tl${C#P_k!^B{%zGusHu$I1L4B*Ql
zxYtlm6Y5xk_X8V_doJX;vOZR@$kQ7|{uoJ~&=WP;y~X-qx!4?IWxxPzDK*EdC~Rpn
zKZ0H~ii?fTSrYW2O^y$R-7~DfP-Bu>$c@4Njj4%d{<5J`c~7Z|e`vo8sx@l*%Nyg^
zQ89E$3;ntQL9Jnb^FN2GHJstaMcY>>VJAlc>f`+lQf4AV?!B!^6tNQAHOo!NpWA^O
z(Ryly^28Y0fHVx)s#0h+S|iqX<#B4fH0Q{A;{s-t&}PO*ilgYlQ(&P~EYi6=YYX^l
z?@)0(U#<?}vKlh9jP2D#nanSp3C7LZjlp~bM5cGNMuH{WoS^@rDdOOQGCBut9n9Ae
znP3fPHJC!vYQnyP#%OVj%y)2r@s_SIWUoPOEc{~;b)ixAelfk|&y_!?;p}WAjbJIg
zrtm&}#D2K3Q92T%1N$9=)`_JvDg~VWaNGA6_OSmdCHz&ne*uyQDY*gfD*+{gy-5Cy
zl7Cr+<Xe=?UyEcZB|oR+2})WABe|TCCk{dKBqbj?6v;!B>~|QF#gsfw$!{omx(~^`
z!;$=yl3!4AXAa3bDEa7-NIpr)VMil5l9DfNK=MzNyx|xmw^DM=MkLo$vY{WzCQ1%J
z7Rk|+Y<@P9t(3fF0LeQkxq1-EwUk`91<7Ag@)RY1qT~x(k$i=c$DWJiSCoAG1xOyI
z<cV!ao}}cI6Oo)r$%0dnET!bQvydE5$&b%P@+c+u?LhKDO2*GaQm5pn=Og(ACBJ_u
zl0Q;XxBy9sl8;`9<dc*<x)aGSDf!?<NIp!-f4mII&nY?S<w#DWWYH^;ETd%cE+oq-
z`5`4grR0%|k^DU+D_(`<07||_$-hzZxgjK9qU51rB%h{a-w2W`DLJ=*<N``^MI;+2
z**b>gd6cZ!gJcaQPf+qCB|T*%3n^K-7s(n*t{g}58cN<jf#gG!e5!`zvy|i~k&IDN
zs3R#+a&iO78I*jSl7}gI>S`o^qU3k4M)EWzPhN}UDN0^^9g=e?*>pXUEtDL4Ba%T%
zHvAQmO_cnElE*0d;p>t7l#)jRB!5rI4{k#86H4xV1CskGdFo~)f1>1;HzK*6lACTp
z@+L~kZ$dIbNpLHYTPQhy8p%bJ+;ba}`zX2gb|g1a(tih%0ZNX33;jvSA#X);I3<t0
z4au)4+4c@3CsXqBcOuzM$@A|*vYnFi{~F0fl-&C+B==Kt@4M-VlApa7$>WsV@jfJP
zqh#Luku0KQ)d!FqNXhUAk&IE&_W+WkC^`8-B&Sod`$I@ZDB1lt^h62WtW=?!mnw8i
zONDN6VTazb!^|smmSu&`x~$N#ITboqr$U<w**@tC?Ov(S?v@Iz{$a~CD-<lRP%ynh
zk-Z8<{#wBbePCghZUs(B<7gMwkG~=OAiv`#RewW+9(#*{Xndqr4aX|>@<8il`1MkQ
z;!;^E%XEN2A5gH~B<#7?rX_v>0tdP&)LMi<aNb*?R;}_O0|<BVY2y8@FwxgdUx1Ms
v`wTJW!{RqEHt_;OkYl`F7QSY~3pN7N`IR)B?IB3gJ4!fAKo%a59Q^+Qzj)|D

diff --git a/.doctrees/environment.pickle b/.doctrees/environment.pickle
index 8e6b3321f0356ff7290b09d35e49225a58d9eb25..96e10c4d4cd71f416f22feaaf5dfda84f1c2bfad 100644
GIT binary patch
literal 3512642
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

literal 3312063
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%0DNz7v});|s)#R{f!d$E2p
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
E0o>|jZ~y=R

diff --git a/_modules/index.html b/_modules/index.html
index 2dfe88e162..0a97733944 100644
--- a/_modules/index.html
+++ b/_modules/index.html
@@ -4,7 +4,7 @@
 <head>
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-      <title>Overview: module code - sentry-python 1.44.1 documentation</title>
+      <title>Overview: module code - sentry-python 2.0.0rc4 documentation</title>
     <link rel="index" title="Index" href="../genindex.html" /><link rel="search" title="Search" href="../search.html" />
 
   <script>
@@ -171,7 +171,7 @@ <h1>All modules for which code is available</h1>
     </div>
   </div>
 </footer></div>
-      <script src="../_static/documentation_options.js?v=fca6d697"></script>
+      <script src="../_static/documentation_options.js?v=aa9da443"></script>
       <script src="../_static/doctools.js?v=888ff710"></script>
       <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
       <script src="../_static/shibuya.js?v=999236dc"></script>
diff --git a/_modules/sentry_sdk/api.html b/_modules/sentry_sdk/api.html
index a5f6f54dca..434ea8c0c5 100644
--- a/_modules/sentry_sdk/api.html
+++ b/_modules/sentry_sdk/api.html
@@ -4,7 +4,7 @@
 <head>
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-      <title>sentry_sdk.api - sentry-python 1.44.1 documentation</title>
+      <title>sentry_sdk.api - sentry-python 2.0.0rc4 documentation</title>
     <link rel="index" title="Index" href="../../genindex.html" /><link rel="search" title="Search" href="../../search.html" />
 
   <script>
@@ -133,326 +133,429 @@
         <article class="yue" role="main">
           <h1>Source code for sentry_sdk.api</h1><div class="highlight"><pre>
 <span></span><span id="1-1"><span class="kn">import</span> <span class="nn">inspect</span>
-</span><span id="1-2">
-</span><span id="1-3"><span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="n">TYPE_CHECKING</span>
-</span><span id="1-4"><span class="kn">from</span> <span class="nn">sentry_sdk.hub</span> <span class="kn">import</span> <span class="n">Hub</span>
-</span><span id="1-5"><span class="kn">from</span> <span class="nn">sentry_sdk.scope</span> <span class="kn">import</span> <span class="n">Scope</span>
-</span><span id="1-6"><span class="kn">from</span> <span class="nn">sentry_sdk.tracing</span> <span class="kn">import</span> <span class="n">NoOpSpan</span><span class="p">,</span> <span class="n">Transaction</span>
-</span><span id="1-7">
-</span><span id="1-8"><span class="k">if</span> <span class="n">TYPE_CHECKING</span><span class="p">:</span>
-</span><span id="1-9">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Any</span>
-</span><span id="1-10">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Dict</span>
-</span><span id="1-11">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Optional</span>
-</span><span id="1-12">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">overload</span>
-</span><span id="1-13">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Callable</span>
-</span><span id="1-14">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">TypeVar</span>
-</span><span id="1-15">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">ContextManager</span>
-</span><span id="1-16">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Union</span>
-</span><span id="1-17">
-</span><span id="1-18">    <span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="p">(</span>
-</span><span id="1-19">        <span class="n">Event</span><span class="p">,</span>
-</span><span id="1-20">        <span class="n">Hint</span><span class="p">,</span>
-</span><span id="1-21">        <span class="n">Breadcrumb</span><span class="p">,</span>
-</span><span id="1-22">        <span class="n">BreadcrumbHint</span><span class="p">,</span>
-</span><span id="1-23">        <span class="n">ExcInfo</span><span class="p">,</span>
-</span><span id="1-24">        <span class="n">MeasurementUnit</span><span class="p">,</span>
-</span><span id="1-25">        <span class="n">LogLevelStr</span><span class="p">,</span>
-</span><span id="1-26">    <span class="p">)</span>
-</span><span id="1-27">    <span class="kn">from</span> <span class="nn">sentry_sdk.tracing</span> <span class="kn">import</span> <span class="n">Span</span>
-</span><span id="1-28">
-</span><span id="1-29">    <span class="n">T</span> <span class="o">=</span> <span class="n">TypeVar</span><span class="p">(</span><span class="s2">&quot;T&quot;</span><span class="p">)</span>
-</span><span id="1-30">    <span class="n">F</span> <span class="o">=</span> <span class="n">TypeVar</span><span class="p">(</span><span class="s2">&quot;F&quot;</span><span class="p">,</span> <span class="n">bound</span><span class="o">=</span><span class="n">Callable</span><span class="p">[</span><span class="o">...</span><span class="p">,</span> <span class="n">Any</span><span class="p">])</span>
-</span><span id="1-31"><span class="k">else</span><span class="p">:</span>
-</span><span id="1-32">
-</span><span id="1-33">    <span class="k">def</span> <span class="nf">overload</span><span class="p">(</span><span class="n">x</span><span class="p">):</span>
-</span><span id="1-34">        <span class="c1"># type: (T) -&gt; T</span>
-</span><span id="1-35">        <span class="k">return</span> <span class="n">x</span>
-</span><span id="1-36">
-</span><span id="1-37">
-</span><span id="1-38"><span class="c1"># When changing this, update __all__ in __init__.py too</span>
-</span><span id="1-39"><span class="n">__all__</span> <span class="o">=</span> <span class="p">[</span>
-</span><span id="1-40">    <span class="s2">&quot;capture_event&quot;</span><span class="p">,</span>
-</span><span id="1-41">    <span class="s2">&quot;capture_message&quot;</span><span class="p">,</span>
-</span><span id="1-42">    <span class="s2">&quot;capture_exception&quot;</span><span class="p">,</span>
-</span><span id="1-43">    <span class="s2">&quot;add_breadcrumb&quot;</span><span class="p">,</span>
-</span><span id="1-44">    <span class="s2">&quot;configure_scope&quot;</span><span class="p">,</span>
-</span><span id="1-45">    <span class="s2">&quot;push_scope&quot;</span><span class="p">,</span>
-</span><span id="1-46">    <span class="s2">&quot;flush&quot;</span><span class="p">,</span>
-</span><span id="1-47">    <span class="s2">&quot;last_event_id&quot;</span><span class="p">,</span>
-</span><span id="1-48">    <span class="s2">&quot;start_span&quot;</span><span class="p">,</span>
-</span><span id="1-49">    <span class="s2">&quot;start_transaction&quot;</span><span class="p">,</span>
-</span><span id="1-50">    <span class="s2">&quot;set_tag&quot;</span><span class="p">,</span>
-</span><span id="1-51">    <span class="s2">&quot;set_context&quot;</span><span class="p">,</span>
-</span><span id="1-52">    <span class="s2">&quot;set_extra&quot;</span><span class="p">,</span>
-</span><span id="1-53">    <span class="s2">&quot;set_user&quot;</span><span class="p">,</span>
-</span><span id="1-54">    <span class="s2">&quot;set_level&quot;</span><span class="p">,</span>
-</span><span id="1-55">    <span class="s2">&quot;set_measurement&quot;</span><span class="p">,</span>
+</span><span id="1-2"><span class="kn">from</span> <span class="nn">contextlib</span> <span class="kn">import</span> <span class="n">contextmanager</span>
+</span><span id="1-3">
+</span><span id="1-4"><span class="kn">from</span> <span class="nn">sentry_sdk</span> <span class="kn">import</span> <span class="n">tracing_utils</span><span class="p">,</span> <span class="n">Client</span>
+</span><span id="1-5"><span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="n">TYPE_CHECKING</span>
+</span><span id="1-6"><span class="kn">from</span> <span class="nn">sentry_sdk.consts</span> <span class="kn">import</span> <span class="n">INSTRUMENTER</span>
+</span><span id="1-7"><span class="kn">from</span> <span class="nn">sentry_sdk.scope</span> <span class="kn">import</span> <span class="n">Scope</span><span class="p">,</span> <span class="n">_ScopeManager</span><span class="p">,</span> <span class="n">new_scope</span><span class="p">,</span> <span class="n">isolation_scope</span>
+</span><span id="1-8"><span class="kn">from</span> <span class="nn">sentry_sdk.tracing</span> <span class="kn">import</span> <span class="n">NoOpSpan</span><span class="p">,</span> <span class="n">Transaction</span>
+</span><span id="1-9">
+</span><span id="1-10"><span class="k">if</span> <span class="n">TYPE_CHECKING</span><span class="p">:</span>
+</span><span id="1-11">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Any</span>
+</span><span id="1-12">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Dict</span>
+</span><span id="1-13">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Generator</span>
+</span><span id="1-14">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Optional</span>
+</span><span id="1-15">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">overload</span>
+</span><span id="1-16">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Callable</span>
+</span><span id="1-17">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">TypeVar</span>
+</span><span id="1-18">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">ContextManager</span>
+</span><span id="1-19">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Union</span>
+</span><span id="1-20">
+</span><span id="1-21">    <span class="kn">from</span> <span class="nn">typing_extensions</span> <span class="kn">import</span> <span class="n">Unpack</span>
+</span><span id="1-22">
+</span><span id="1-23">    <span class="kn">from</span> <span class="nn">sentry_sdk.client</span> <span class="kn">import</span> <span class="n">BaseClient</span>
+</span><span id="1-24">    <span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="p">(</span>
+</span><span id="1-25">        <span class="n">Event</span><span class="p">,</span>
+</span><span id="1-26">        <span class="n">Hint</span><span class="p">,</span>
+</span><span id="1-27">        <span class="n">Breadcrumb</span><span class="p">,</span>
+</span><span id="1-28">        <span class="n">BreadcrumbHint</span><span class="p">,</span>
+</span><span id="1-29">        <span class="n">ExcInfo</span><span class="p">,</span>
+</span><span id="1-30">        <span class="n">MeasurementUnit</span><span class="p">,</span>
+</span><span id="1-31">        <span class="n">LogLevelStr</span><span class="p">,</span>
+</span><span id="1-32">        <span class="n">SamplingContext</span><span class="p">,</span>
+</span><span id="1-33">    <span class="p">)</span>
+</span><span id="1-34">    <span class="kn">from</span> <span class="nn">sentry_sdk.tracing</span> <span class="kn">import</span> <span class="n">Span</span><span class="p">,</span> <span class="n">TransactionKwargs</span>
+</span><span id="1-35">
+</span><span id="1-36">    <span class="n">T</span> <span class="o">=</span> <span class="n">TypeVar</span><span class="p">(</span><span class="s2">&quot;T&quot;</span><span class="p">)</span>
+</span><span id="1-37">    <span class="n">F</span> <span class="o">=</span> <span class="n">TypeVar</span><span class="p">(</span><span class="s2">&quot;F&quot;</span><span class="p">,</span> <span class="n">bound</span><span class="o">=</span><span class="n">Callable</span><span class="p">[</span><span class="o">...</span><span class="p">,</span> <span class="n">Any</span><span class="p">])</span>
+</span><span id="1-38"><span class="k">else</span><span class="p">:</span>
+</span><span id="1-39">
+</span><span id="1-40">    <span class="k">def</span> <span class="nf">overload</span><span class="p">(</span><span class="n">x</span><span class="p">):</span>
+</span><span id="1-41">        <span class="c1"># type: (T) -&gt; T</span>
+</span><span id="1-42">        <span class="k">return</span> <span class="n">x</span>
+</span><span id="1-43">
+</span><span id="1-44">
+</span><span id="1-45"><span class="c1"># When changing this, update __all__ in __init__.py too</span>
+</span><span id="1-46"><span class="n">__all__</span> <span class="o">=</span> <span class="p">[</span>
+</span><span id="1-47">    <span class="s2">&quot;add_breadcrumb&quot;</span><span class="p">,</span>
+</span><span id="1-48">    <span class="s2">&quot;capture_event&quot;</span><span class="p">,</span>
+</span><span id="1-49">    <span class="s2">&quot;capture_exception&quot;</span><span class="p">,</span>
+</span><span id="1-50">    <span class="s2">&quot;capture_message&quot;</span><span class="p">,</span>
+</span><span id="1-51">    <span class="s2">&quot;configure_scope&quot;</span><span class="p">,</span>
+</span><span id="1-52">    <span class="s2">&quot;continue_trace&quot;</span><span class="p">,</span>
+</span><span id="1-53">    <span class="s2">&quot;flush&quot;</span><span class="p">,</span>
+</span><span id="1-54">    <span class="s2">&quot;get_baggage&quot;</span><span class="p">,</span>
+</span><span id="1-55">    <span class="s2">&quot;get_client&quot;</span><span class="p">,</span>
 </span><span id="1-56">    <span class="s2">&quot;get_current_span&quot;</span><span class="p">,</span>
 </span><span id="1-57">    <span class="s2">&quot;get_traceparent&quot;</span><span class="p">,</span>
-</span><span id="1-58">    <span class="s2">&quot;get_baggage&quot;</span><span class="p">,</span>
-</span><span id="1-59">    <span class="s2">&quot;continue_trace&quot;</span><span class="p">,</span>
-</span><span id="1-60"><span class="p">]</span>
-</span><span id="1-61">
-</span><span id="1-62">
-</span><span id="1-63"><span class="k">def</span> <span class="nf">hubmethod</span><span class="p">(</span><span class="n">f</span><span class="p">):</span>
-</span><span id="1-64">    <span class="c1"># type: (F) -&gt; F</span>
-</span><span id="1-65">    <span class="n">f</span><span class="o">.</span><span class="vm">__doc__</span> <span class="o">=</span> <span class="s2">&quot;</span><span class="si">%s</span><span class="se">\n\n</span><span class="si">%s</span><span class="s2">&quot;</span> <span class="o">%</span> <span class="p">(</span>
-</span><span id="1-66">        <span class="s2">&quot;Alias for :py:meth:`sentry_sdk.Hub.</span><span class="si">%s</span><span class="s2">`&quot;</span> <span class="o">%</span> <span class="n">f</span><span class="o">.</span><span class="vm">__name__</span><span class="p">,</span>
-</span><span id="1-67">        <span class="n">inspect</span><span class="o">.</span><span class="n">getdoc</span><span class="p">(</span><span class="nb">getattr</span><span class="p">(</span><span class="n">Hub</span><span class="p">,</span> <span class="n">f</span><span class="o">.</span><span class="vm">__name__</span><span class="p">)),</span>
-</span><span id="1-68">    <span class="p">)</span>
-</span><span id="1-69">    <span class="k">return</span> <span class="n">f</span>
-</span><span id="1-70">
+</span><span id="1-58">    <span class="s2">&quot;is_initialized&quot;</span><span class="p">,</span>
+</span><span id="1-59">    <span class="s2">&quot;isolation_scope&quot;</span><span class="p">,</span>
+</span><span id="1-60">    <span class="s2">&quot;new_scope&quot;</span><span class="p">,</span>
+</span><span id="1-61">    <span class="s2">&quot;push_scope&quot;</span><span class="p">,</span>
+</span><span id="1-62">    <span class="s2">&quot;set_context&quot;</span><span class="p">,</span>
+</span><span id="1-63">    <span class="s2">&quot;set_extra&quot;</span><span class="p">,</span>
+</span><span id="1-64">    <span class="s2">&quot;set_level&quot;</span><span class="p">,</span>
+</span><span id="1-65">    <span class="s2">&quot;set_measurement&quot;</span><span class="p">,</span>
+</span><span id="1-66">    <span class="s2">&quot;set_tag&quot;</span><span class="p">,</span>
+</span><span id="1-67">    <span class="s2">&quot;set_user&quot;</span><span class="p">,</span>
+</span><span id="1-68">    <span class="s2">&quot;start_span&quot;</span><span class="p">,</span>
+</span><span id="1-69">    <span class="s2">&quot;start_transaction&quot;</span><span class="p">,</span>
+</span><span id="1-70"><span class="p">]</span>
 </span><span id="1-71">
-</span><span id="1-72"><span class="k">def</span> <span class="nf">scopemethod</span><span class="p">(</span><span class="n">f</span><span class="p">):</span>
-</span><span id="1-73">    <span class="c1"># type: (F) -&gt; F</span>
-</span><span id="1-74">    <span class="n">f</span><span class="o">.</span><span class="vm">__doc__</span> <span class="o">=</span> <span class="s2">&quot;</span><span class="si">%s</span><span class="se">\n\n</span><span class="si">%s</span><span class="s2">&quot;</span> <span class="o">%</span> <span class="p">(</span>
-</span><span id="1-75">        <span class="s2">&quot;Alias for :py:meth:`sentry_sdk.Scope.</span><span class="si">%s</span><span class="s2">`&quot;</span> <span class="o">%</span> <span class="n">f</span><span class="o">.</span><span class="vm">__name__</span><span class="p">,</span>
-</span><span id="1-76">        <span class="n">inspect</span><span class="o">.</span><span class="n">getdoc</span><span class="p">(</span><span class="nb">getattr</span><span class="p">(</span><span class="n">Scope</span><span class="p">,</span> <span class="n">f</span><span class="o">.</span><span class="vm">__name__</span><span class="p">)),</span>
-</span><span id="1-77">    <span class="p">)</span>
-</span><span id="1-78">    <span class="k">return</span> <span class="n">f</span>
-</span><span id="1-79">
+</span><span id="1-72">
+</span><span id="1-73"><span class="k">def</span> <span class="nf">scopemethod</span><span class="p">(</span><span class="n">f</span><span class="p">):</span>
+</span><span id="1-74">    <span class="c1"># type: (F) -&gt; F</span>
+</span><span id="1-75">    <span class="n">f</span><span class="o">.</span><span class="vm">__doc__</span> <span class="o">=</span> <span class="s2">&quot;</span><span class="si">%s</span><span class="se">\n\n</span><span class="si">%s</span><span class="s2">&quot;</span> <span class="o">%</span> <span class="p">(</span>
+</span><span id="1-76">        <span class="s2">&quot;Alias for :py:meth:`sentry_sdk.Scope.</span><span class="si">%s</span><span class="s2">`&quot;</span> <span class="o">%</span> <span class="n">f</span><span class="o">.</span><span class="vm">__name__</span><span class="p">,</span>
+</span><span id="1-77">        <span class="n">inspect</span><span class="o">.</span><span class="n">getdoc</span><span class="p">(</span><span class="nb">getattr</span><span class="p">(</span><span class="n">Scope</span><span class="p">,</span> <span class="n">f</span><span class="o">.</span><span class="vm">__name__</span><span class="p">)),</span>
+</span><span id="1-78">    <span class="p">)</span>
+</span><span id="1-79">    <span class="k">return</span> <span class="n">f</span>
 </span><span id="1-80">
+</span><span id="1-81">
+</span><span id="1-82"><span class="k">def</span> <span class="nf">clientmethod</span><span class="p">(</span><span class="n">f</span><span class="p">):</span>
+</span><span id="1-83">    <span class="c1"># type: (F) -&gt; F</span>
+</span><span id="1-84">    <span class="n">f</span><span class="o">.</span><span class="vm">__doc__</span> <span class="o">=</span> <span class="s2">&quot;</span><span class="si">%s</span><span class="se">\n\n</span><span class="si">%s</span><span class="s2">&quot;</span> <span class="o">%</span> <span class="p">(</span>
+</span><span id="1-85">        <span class="s2">&quot;Alias for :py:meth:`sentry_sdk.Client.</span><span class="si">%s</span><span class="s2">`&quot;</span> <span class="o">%</span> <span class="n">f</span><span class="o">.</span><span class="vm">__name__</span><span class="p">,</span>
+</span><span id="1-86">        <span class="n">inspect</span><span class="o">.</span><span class="n">getdoc</span><span class="p">(</span><span class="nb">getattr</span><span class="p">(</span><span class="n">Client</span><span class="p">,</span> <span class="n">f</span><span class="o">.</span><span class="vm">__name__</span><span class="p">)),</span>
+</span><span id="1-87">    <span class="p">)</span>
+</span><span id="1-88">    <span class="k">return</span> <span class="n">f</span>
+</span><span id="1-89">
+</span><span id="1-90">
+<div class="viewcode-block" id="is_initialized">
+<a class="viewcode-back" href="../../api.html#sentry_sdk.api.is_initialized">[docs]</a>
+</span><span id="1-91"><span class="k">def</span> <span class="nf">is_initialized</span><span class="p">():</span>
+</span><span id="1-92">    <span class="c1"># type: () -&gt; bool</span>
+</span><span id="1-93"><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-94"><span class="sd">    .. versionadded:: 2.0.0</span>
+</span><span id="1-95">
+</span><span id="1-96"><span class="sd">    Returns whether Sentry has been initialized or not.</span>
+</span><span id="1-97">
+</span><span id="1-98"><span class="sd">    If a client is available and the client is active</span>
+</span><span id="1-99"><span class="sd">    (meaning it is configured to send data) then</span>
+</span><span id="1-100"><span class="sd">    Sentry is initialized.</span>
+</span><span id="1-101"><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="1-102">    <span class="k">return</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_client</span><span class="p">()</span><span class="o">.</span><span class="n">is_active</span><span class="p">()</span></div>
+
+</span><span id="1-103">
+</span><span id="1-104">
+<div class="viewcode-block" id="get_client">
+<a class="viewcode-back" href="../../api.html#sentry_sdk.api.get_client">[docs]</a>
+</span><span id="1-105"><span class="nd">@scopemethod</span>
+</span><span id="1-106"><span class="k">def</span> <span class="nf">get_client</span><span class="p">():</span>
+</span><span id="1-107">    <span class="c1"># type: () -&gt; BaseClient</span>
+</span><span id="1-108">    <span class="k">return</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_client</span><span class="p">()</span></div>
+
+</span><span id="1-109">
+</span><span id="1-110">
 <div class="viewcode-block" id="capture_event">
 <a class="viewcode-back" href="../../api.html#sentry_sdk.api.capture_event">[docs]</a>
-</span><span id="1-81"><span class="nd">@hubmethod</span>
-</span><span id="1-82"><span class="k">def</span> <span class="nf">capture_event</span><span class="p">(</span>
-</span><span id="1-83">    <span class="n">event</span><span class="p">,</span>  <span class="c1"># type: Event</span>
-</span><span id="1-84">    <span class="n">hint</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Hint]</span>
-</span><span id="1-85">    <span class="n">scope</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Any]</span>
-</span><span id="1-86">    <span class="o">**</span><span class="n">scope_kwargs</span>  <span class="c1"># type: Any</span>
-</span><span id="1-87"><span class="p">):</span>
-</span><span id="1-88">    <span class="c1"># type: (...) -&gt; Optional[str]</span>
-</span><span id="1-89">    <span class="k">return</span> <span class="n">Hub</span><span class="o">.</span><span class="n">current</span><span class="o">.</span><span class="n">capture_event</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="n">scope</span><span class="p">,</span> <span class="o">**</span><span class="n">scope_kwargs</span><span class="p">)</span></div>
+</span><span id="1-111"><span class="nd">@scopemethod</span>
+</span><span id="1-112"><span class="k">def</span> <span class="nf">capture_event</span><span class="p">(</span>
+</span><span id="1-113">    <span class="n">event</span><span class="p">,</span>  <span class="c1"># type: Event</span>
+</span><span id="1-114">    <span class="n">hint</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Hint]</span>
+</span><span id="1-115">    <span class="n">scope</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Any]</span>
+</span><span id="1-116">    <span class="o">**</span><span class="n">scope_kwargs</span><span class="p">,</span>  <span class="c1"># type: Any</span>
+</span><span id="1-117"><span class="p">):</span>
+</span><span id="1-118">    <span class="c1"># type: (...) -&gt; Optional[str]</span>
+</span><span id="1-119">    <span class="k">return</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_current_scope</span><span class="p">()</span><span class="o">.</span><span class="n">capture_event</span><span class="p">(</span>
+</span><span id="1-120">        <span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="n">scope</span><span class="p">,</span> <span class="o">**</span><span class="n">scope_kwargs</span>
+</span><span id="1-121">    <span class="p">)</span></div>
 
-</span><span id="1-90">
-</span><span id="1-91">
+</span><span id="1-122">
+</span><span id="1-123">
 <div class="viewcode-block" id="capture_message">
 <a class="viewcode-back" href="../../api.html#sentry_sdk.api.capture_message">[docs]</a>
-</span><span id="1-92"><span class="nd">@hubmethod</span>
-</span><span id="1-93"><span class="k">def</span> <span class="nf">capture_message</span><span class="p">(</span>
-</span><span id="1-94">    <span class="n">message</span><span class="p">,</span>  <span class="c1"># type: str</span>
-</span><span id="1-95">    <span class="n">level</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[LogLevelStr]</span>
-</span><span id="1-96">    <span class="n">scope</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Any]</span>
-</span><span id="1-97">    <span class="o">**</span><span class="n">scope_kwargs</span>  <span class="c1"># type: Any</span>
-</span><span id="1-98"><span class="p">):</span>
-</span><span id="1-99">    <span class="c1"># type: (...) -&gt; Optional[str]</span>
-</span><span id="1-100">    <span class="k">return</span> <span class="n">Hub</span><span class="o">.</span><span class="n">current</span><span class="o">.</span><span class="n">capture_message</span><span class="p">(</span><span class="n">message</span><span class="p">,</span> <span class="n">level</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="n">scope</span><span class="p">,</span> <span class="o">**</span><span class="n">scope_kwargs</span><span class="p">)</span></div>
+</span><span id="1-124"><span class="nd">@scopemethod</span>
+</span><span id="1-125"><span class="k">def</span> <span class="nf">capture_message</span><span class="p">(</span>
+</span><span id="1-126">    <span class="n">message</span><span class="p">,</span>  <span class="c1"># type: str</span>
+</span><span id="1-127">    <span class="n">level</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[LogLevelStr]</span>
+</span><span id="1-128">    <span class="n">scope</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Any]</span>
+</span><span id="1-129">    <span class="o">**</span><span class="n">scope_kwargs</span><span class="p">,</span>  <span class="c1"># type: Any</span>
+</span><span id="1-130"><span class="p">):</span>
+</span><span id="1-131">    <span class="c1"># type: (...) -&gt; Optional[str]</span>
+</span><span id="1-132">    <span class="k">return</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_current_scope</span><span class="p">()</span><span class="o">.</span><span class="n">capture_message</span><span class="p">(</span>
+</span><span id="1-133">        <span class="n">message</span><span class="p">,</span> <span class="n">level</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="n">scope</span><span class="p">,</span> <span class="o">**</span><span class="n">scope_kwargs</span>
+</span><span id="1-134">    <span class="p">)</span></div>
 
-</span><span id="1-101">
-</span><span id="1-102">
+</span><span id="1-135">
+</span><span id="1-136">
 <div class="viewcode-block" id="capture_exception">
 <a class="viewcode-back" href="../../api.html#sentry_sdk.api.capture_exception">[docs]</a>
-</span><span id="1-103"><span class="nd">@hubmethod</span>
-</span><span id="1-104"><span class="k">def</span> <span class="nf">capture_exception</span><span class="p">(</span>
-</span><span id="1-105">    <span class="n">error</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Union[BaseException, ExcInfo]]</span>
-</span><span id="1-106">    <span class="n">scope</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Any]</span>
-</span><span id="1-107">    <span class="o">**</span><span class="n">scope_kwargs</span>  <span class="c1"># type: Any</span>
-</span><span id="1-108"><span class="p">):</span>
-</span><span id="1-109">    <span class="c1"># type: (...) -&gt; Optional[str]</span>
-</span><span id="1-110">    <span class="k">return</span> <span class="n">Hub</span><span class="o">.</span><span class="n">current</span><span class="o">.</span><span class="n">capture_exception</span><span class="p">(</span><span class="n">error</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="n">scope</span><span class="p">,</span> <span class="o">**</span><span class="n">scope_kwargs</span><span class="p">)</span></div>
+</span><span id="1-137"><span class="nd">@scopemethod</span>
+</span><span id="1-138"><span class="k">def</span> <span class="nf">capture_exception</span><span class="p">(</span>
+</span><span id="1-139">    <span class="n">error</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Union[BaseException, ExcInfo]]</span>
+</span><span id="1-140">    <span class="n">scope</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Any]</span>
+</span><span id="1-141">    <span class="o">**</span><span class="n">scope_kwargs</span><span class="p">,</span>  <span class="c1"># type: Any</span>
+</span><span id="1-142"><span class="p">):</span>
+</span><span id="1-143">    <span class="c1"># type: (...) -&gt; Optional[str]</span>
+</span><span id="1-144">    <span class="k">return</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_current_scope</span><span class="p">()</span><span class="o">.</span><span class="n">capture_exception</span><span class="p">(</span>
+</span><span id="1-145">        <span class="n">error</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="n">scope</span><span class="p">,</span> <span class="o">**</span><span class="n">scope_kwargs</span>
+</span><span id="1-146">    <span class="p">)</span></div>
 
-</span><span id="1-111">
-</span><span id="1-112">
+</span><span id="1-147">
+</span><span id="1-148">
 <div class="viewcode-block" id="add_breadcrumb">
 <a class="viewcode-back" href="../../api.html#sentry_sdk.api.add_breadcrumb">[docs]</a>
-</span><span id="1-113"><span class="nd">@hubmethod</span>
-</span><span id="1-114"><span class="k">def</span> <span class="nf">add_breadcrumb</span><span class="p">(</span>
-</span><span id="1-115">    <span class="n">crumb</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Breadcrumb]</span>
-</span><span id="1-116">    <span class="n">hint</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[BreadcrumbHint]</span>
-</span><span id="1-117">    <span class="o">**</span><span class="n">kwargs</span>  <span class="c1"># type: Any</span>
-</span><span id="1-118"><span class="p">):</span>
-</span><span id="1-119">    <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-120">    <span class="k">return</span> <span class="n">Hub</span><span class="o">.</span><span class="n">current</span><span class="o">.</span><span class="n">add_breadcrumb</span><span class="p">(</span><span class="n">crumb</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></div>
-
-</span><span id="1-121">
-</span><span id="1-122">
-</span><span id="1-123"><span class="nd">@overload</span>
-</span><span id="1-124"><span class="k">def</span> <span class="nf">configure_scope</span><span class="p">():</span>
-</span><span id="1-125">    <span class="c1"># type: () -&gt; ContextManager[Scope]</span>
-</span><span id="1-126">    <span class="k">pass</span>
-</span><span id="1-127">
-</span><span id="1-128">
-</span><span id="1-129"><span class="nd">@overload</span>
-</span><span id="1-130"><span class="k">def</span> <span class="nf">configure_scope</span><span class="p">(</span>  <span class="c1"># noqa: F811</span>
-</span><span id="1-131">    <span class="n">callback</span><span class="p">,</span>  <span class="c1"># type: Callable[[Scope], None]</span>
-</span><span id="1-132"><span class="p">):</span>
-</span><span id="1-133">    <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-134">    <span class="k">pass</span>
-</span><span id="1-135">
-</span><span id="1-136">
-<div class="viewcode-block" id="configure_scope">
-<a class="viewcode-back" href="../../api.html#sentry_sdk.api.configure_scope">[docs]</a>
-</span><span id="1-137"><span class="nd">@hubmethod</span>
-</span><span id="1-138"><span class="k">def</span> <span class="nf">configure_scope</span><span class="p">(</span>  <span class="c1"># noqa: F811</span>
-</span><span id="1-139">    <span class="n">callback</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Callable[[Scope], None]]</span>
-</span><span id="1-140"><span class="p">):</span>
-</span><span id="1-141">    <span class="c1"># type: (...) -&gt; Optional[ContextManager[Scope]]</span>
-</span><span id="1-142">    <span class="k">return</span> <span class="n">Hub</span><span class="o">.</span><span class="n">current</span><span class="o">.</span><span class="n">configure_scope</span><span class="p">(</span><span class="n">callback</span><span class="p">)</span></div>
-
-</span><span id="1-143">
-</span><span id="1-144">
-</span><span id="1-145"><span class="nd">@overload</span>
-</span><span id="1-146"><span class="k">def</span> <span class="nf">push_scope</span><span class="p">():</span>
-</span><span id="1-147">    <span class="c1"># type: () -&gt; ContextManager[Scope]</span>
-</span><span id="1-148">    <span class="k">pass</span>
-</span><span id="1-149">
-</span><span id="1-150">
-</span><span id="1-151"><span class="nd">@overload</span>
-</span><span id="1-152"><span class="k">def</span> <span class="nf">push_scope</span><span class="p">(</span>  <span class="c1"># noqa: F811</span>
-</span><span id="1-153">    <span class="n">callback</span><span class="p">,</span>  <span class="c1"># type: Callable[[Scope], None]</span>
+</span><span id="1-149"><span class="nd">@scopemethod</span>
+</span><span id="1-150"><span class="k">def</span> <span class="nf">add_breadcrumb</span><span class="p">(</span>
+</span><span id="1-151">    <span class="n">crumb</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Breadcrumb]</span>
+</span><span id="1-152">    <span class="n">hint</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[BreadcrumbHint]</span>
+</span><span id="1-153">    <span class="o">**</span><span class="n">kwargs</span><span class="p">,</span>  <span class="c1"># type: Any</span>
 </span><span id="1-154"><span class="p">):</span>
 </span><span id="1-155">    <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-156">    <span class="k">pass</span>
+</span><span id="1-156">    <span class="k">return</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_isolation_scope</span><span class="p">()</span><span class="o">.</span><span class="n">add_breadcrumb</span><span class="p">(</span><span class="n">crumb</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></div>
+
 </span><span id="1-157">
 </span><span id="1-158">
+</span><span id="1-159"><span class="nd">@overload</span>
+</span><span id="1-160"><span class="k">def</span> <span class="nf">configure_scope</span><span class="p">():</span>
+</span><span id="1-161">    <span class="c1"># type: () -&gt; ContextManager[Scope]</span>
+</span><span id="1-162">    <span class="k">pass</span>
+</span><span id="1-163">
+</span><span id="1-164">
+</span><span id="1-165"><span class="nd">@overload</span>
+</span><span id="1-166"><span class="k">def</span> <span class="nf">configure_scope</span><span class="p">(</span>  <span class="c1"># noqa: F811</span>
+</span><span id="1-167">    <span class="n">callback</span><span class="p">,</span>  <span class="c1"># type: Callable[[Scope], None]</span>
+</span><span id="1-168"><span class="p">):</span>
+</span><span id="1-169">    <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-170">    <span class="k">pass</span>
+</span><span id="1-171">
+</span><span id="1-172">
+<div class="viewcode-block" id="configure_scope">
+<a class="viewcode-back" href="../../api.html#sentry_sdk.api.configure_scope">[docs]</a>
+</span><span id="1-173"><span class="k">def</span> <span class="nf">configure_scope</span><span class="p">(</span>  <span class="c1"># noqa: F811</span>
+</span><span id="1-174">    <span class="n">callback</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Callable[[Scope], None]]</span>
+</span><span id="1-175"><span class="p">):</span>
+</span><span id="1-176">    <span class="c1"># type: (...) -&gt; Optional[ContextManager[Scope]]</span>
+</span><span id="1-177"><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-178"><span class="sd">    Reconfigures the scope.</span>
+</span><span id="1-179">
+</span><span id="1-180"><span class="sd">    :param callback: If provided, call the callback with the current scope.</span>
+</span><span id="1-181">
+</span><span id="1-182"><span class="sd">    :returns: If no callback is provided, returns a context manager that returns the scope.</span>
+</span><span id="1-183"><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="1-184">    <span class="n">scope</span> <span class="o">=</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_isolation_scope</span><span class="p">()</span>
+</span><span id="1-185">    <span class="n">scope</span><span class="o">.</span><span class="n">generate_propagation_context</span><span class="p">()</span>
+</span><span id="1-186">
+</span><span id="1-187">    <span class="k">if</span> <span class="n">callback</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-188">        <span class="c1"># TODO: used to return None when client is None. Check if this changes behavior.</span>
+</span><span id="1-189">        <span class="n">callback</span><span class="p">(</span><span class="n">scope</span><span class="p">)</span>
+</span><span id="1-190">
+</span><span id="1-191">        <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-192">
+</span><span id="1-193">    <span class="nd">@contextmanager</span>
+</span><span id="1-194">    <span class="k">def</span> <span class="nf">inner</span><span class="p">():</span>
+</span><span id="1-195">        <span class="c1"># type: () -&gt; Generator[Scope, None, None]</span>
+</span><span id="1-196">        <span class="k">yield</span> <span class="n">scope</span>
+</span><span id="1-197">
+</span><span id="1-198">    <span class="k">return</span> <span class="n">inner</span><span class="p">()</span></div>
+
+</span><span id="1-199">
+</span><span id="1-200">
+</span><span id="1-201"><span class="nd">@overload</span>
+</span><span id="1-202"><span class="k">def</span> <span class="nf">push_scope</span><span class="p">():</span>
+</span><span id="1-203">    <span class="c1"># type: () -&gt; ContextManager[Scope]</span>
+</span><span id="1-204">    <span class="k">pass</span>
+</span><span id="1-205">
+</span><span id="1-206">
+</span><span id="1-207"><span class="nd">@overload</span>
+</span><span id="1-208"><span class="k">def</span> <span class="nf">push_scope</span><span class="p">(</span>  <span class="c1"># noqa: F811</span>
+</span><span id="1-209">    <span class="n">callback</span><span class="p">,</span>  <span class="c1"># type: Callable[[Scope], None]</span>
+</span><span id="1-210"><span class="p">):</span>
+</span><span id="1-211">    <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-212">    <span class="k">pass</span>
+</span><span id="1-213">
+</span><span id="1-214">
 <div class="viewcode-block" id="push_scope">
 <a class="viewcode-back" href="../../api.html#sentry_sdk.api.push_scope">[docs]</a>
-</span><span id="1-159"><span class="nd">@hubmethod</span>
-</span><span id="1-160"><span class="k">def</span> <span class="nf">push_scope</span><span class="p">(</span>  <span class="c1"># noqa: F811</span>
-</span><span id="1-161">    <span class="n">callback</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Callable[[Scope], None]]</span>
-</span><span id="1-162"><span class="p">):</span>
-</span><span id="1-163">    <span class="c1"># type: (...) -&gt; Optional[ContextManager[Scope]]</span>
-</span><span id="1-164">    <span class="k">return</span> <span class="n">Hub</span><span class="o">.</span><span class="n">current</span><span class="o">.</span><span class="n">push_scope</span><span class="p">(</span><span class="n">callback</span><span class="p">)</span></div>
+</span><span id="1-215"><span class="k">def</span> <span class="nf">push_scope</span><span class="p">(</span>  <span class="c1"># noqa: F811</span>
+</span><span id="1-216">    <span class="n">callback</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Callable[[Scope], None]]</span>
+</span><span id="1-217"><span class="p">):</span>
+</span><span id="1-218">    <span class="c1"># type: (...) -&gt; Optional[ContextManager[Scope]]</span>
+</span><span id="1-219"><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-220"><span class="sd">    Pushes a new layer on the scope stack.</span>
+</span><span id="1-221">
+</span><span id="1-222"><span class="sd">    :param callback: If provided, this method pushes a scope, calls</span>
+</span><span id="1-223"><span class="sd">        `callback`, and pops the scope again.</span>
+</span><span id="1-224">
+</span><span id="1-225"><span class="sd">    :returns: If no `callback` is provided, a context manager that should</span>
+</span><span id="1-226"><span class="sd">        be used to pop the scope again.</span>
+</span><span id="1-227"><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="1-228">    <span class="k">if</span> <span class="n">callback</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-229">        <span class="k">with</span> <span class="n">push_scope</span><span class="p">()</span> <span class="k">as</span> <span class="n">scope</span><span class="p">:</span>
+</span><span id="1-230">            <span class="n">callback</span><span class="p">(</span><span class="n">scope</span><span class="p">)</span>
+</span><span id="1-231">        <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-232">
+</span><span id="1-233">    <span class="k">return</span> <span class="n">_ScopeManager</span><span class="p">()</span></div>
 
-</span><span id="1-165">
-</span><span id="1-166">
+</span><span id="1-234">
+</span><span id="1-235">
 <div class="viewcode-block" id="set_tag">
 <a class="viewcode-back" href="../../api.html#sentry_sdk.api.set_tag">[docs]</a>
-</span><span id="1-167"><span class="nd">@scopemethod</span>
-</span><span id="1-168"><span class="k">def</span> <span class="nf">set_tag</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-</span><span id="1-169">    <span class="c1"># type: (str, Any) -&gt; None</span>
-</span><span id="1-170">    <span class="k">return</span> <span class="n">Hub</span><span class="o">.</span><span class="n">current</span><span class="o">.</span><span class="n">scope</span><span class="o">.</span><span class="n">set_tag</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">)</span></div>
+</span><span id="1-236"><span class="nd">@scopemethod</span>
+</span><span id="1-237"><span class="k">def</span> <span class="nf">set_tag</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
+</span><span id="1-238">    <span class="c1"># type: (str, Any) -&gt; None</span>
+</span><span id="1-239">    <span class="k">return</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_isolation_scope</span><span class="p">()</span><span class="o">.</span><span class="n">set_tag</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">)</span></div>
 
-</span><span id="1-171">
-</span><span id="1-172">
+</span><span id="1-240">
+</span><span id="1-241">
 <div class="viewcode-block" id="set_context">
 <a class="viewcode-back" href="../../api.html#sentry_sdk.api.set_context">[docs]</a>
-</span><span id="1-173"><span class="nd">@scopemethod</span>
-</span><span id="1-174"><span class="k">def</span> <span class="nf">set_context</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-</span><span id="1-175">    <span class="c1"># type: (str, Dict[str, Any]) -&gt; None</span>
-</span><span id="1-176">    <span class="k">return</span> <span class="n">Hub</span><span class="o">.</span><span class="n">current</span><span class="o">.</span><span class="n">scope</span><span class="o">.</span><span class="n">set_context</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">)</span></div>
+</span><span id="1-242"><span class="nd">@scopemethod</span>
+</span><span id="1-243"><span class="k">def</span> <span class="nf">set_context</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
+</span><span id="1-244">    <span class="c1"># type: (str, Dict[str, Any]) -&gt; None</span>
+</span><span id="1-245">    <span class="k">return</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_isolation_scope</span><span class="p">()</span><span class="o">.</span><span class="n">set_context</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">)</span></div>
 
-</span><span id="1-177">
-</span><span id="1-178">
+</span><span id="1-246">
+</span><span id="1-247">
 <div class="viewcode-block" id="set_extra">
 <a class="viewcode-back" href="../../api.html#sentry_sdk.api.set_extra">[docs]</a>
-</span><span id="1-179"><span class="nd">@scopemethod</span>
-</span><span id="1-180"><span class="k">def</span> <span class="nf">set_extra</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-</span><span id="1-181">    <span class="c1"># type: (str, Any) -&gt; None</span>
-</span><span id="1-182">    <span class="k">return</span> <span class="n">Hub</span><span class="o">.</span><span class="n">current</span><span class="o">.</span><span class="n">scope</span><span class="o">.</span><span class="n">set_extra</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">)</span></div>
+</span><span id="1-248"><span class="nd">@scopemethod</span>
+</span><span id="1-249"><span class="k">def</span> <span class="nf">set_extra</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
+</span><span id="1-250">    <span class="c1"># type: (str, Any) -&gt; None</span>
+</span><span id="1-251">    <span class="k">return</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_isolation_scope</span><span class="p">()</span><span class="o">.</span><span class="n">set_extra</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">)</span></div>
 
-</span><span id="1-183">
-</span><span id="1-184">
+</span><span id="1-252">
+</span><span id="1-253">
 <div class="viewcode-block" id="set_user">
 <a class="viewcode-back" href="../../api.html#sentry_sdk.api.set_user">[docs]</a>
-</span><span id="1-185"><span class="nd">@scopemethod</span>
-</span><span id="1-186"><span class="k">def</span> <span class="nf">set_user</span><span class="p">(</span><span class="n">value</span><span class="p">):</span>
-</span><span id="1-187">    <span class="c1"># type: (Optional[Dict[str, Any]]) -&gt; None</span>
-</span><span id="1-188">    <span class="k">return</span> <span class="n">Hub</span><span class="o">.</span><span class="n">current</span><span class="o">.</span><span class="n">scope</span><span class="o">.</span><span class="n">set_user</span><span class="p">(</span><span class="n">value</span><span class="p">)</span></div>
+</span><span id="1-254"><span class="nd">@scopemethod</span>
+</span><span id="1-255"><span class="k">def</span> <span class="nf">set_user</span><span class="p">(</span><span class="n">value</span><span class="p">):</span>
+</span><span id="1-256">    <span class="c1"># type: (Optional[Dict[str, Any]]) -&gt; None</span>
+</span><span id="1-257">    <span class="k">return</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_isolation_scope</span><span class="p">()</span><span class="o">.</span><span class="n">set_user</span><span class="p">(</span><span class="n">value</span><span class="p">)</span></div>
 
-</span><span id="1-189">
-</span><span id="1-190">
+</span><span id="1-258">
+</span><span id="1-259">
 <div class="viewcode-block" id="set_level">
 <a class="viewcode-back" href="../../api.html#sentry_sdk.api.set_level">[docs]</a>
-</span><span id="1-191"><span class="nd">@scopemethod</span>
-</span><span id="1-192"><span class="k">def</span> <span class="nf">set_level</span><span class="p">(</span><span class="n">value</span><span class="p">):</span>
-</span><span id="1-193">    <span class="c1"># type: (LogLevelStr) -&gt; None</span>
-</span><span id="1-194">    <span class="k">return</span> <span class="n">Hub</span><span class="o">.</span><span class="n">current</span><span class="o">.</span><span class="n">scope</span><span class="o">.</span><span class="n">set_level</span><span class="p">(</span><span class="n">value</span><span class="p">)</span></div>
+</span><span id="1-260"><span class="nd">@scopemethod</span>
+</span><span id="1-261"><span class="k">def</span> <span class="nf">set_level</span><span class="p">(</span><span class="n">value</span><span class="p">):</span>
+</span><span id="1-262">    <span class="c1"># type: (LogLevelStr) -&gt; None</span>
+</span><span id="1-263">    <span class="k">return</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_isolation_scope</span><span class="p">()</span><span class="o">.</span><span class="n">set_level</span><span class="p">(</span><span class="n">value</span><span class="p">)</span></div>
 
-</span><span id="1-195">
-</span><span id="1-196">
-</span><span id="1-197"><span class="nd">@hubmethod</span>
-</span><span id="1-198"><span class="k">def</span> <span class="nf">flush</span><span class="p">(</span>
-</span><span id="1-199">    <span class="n">timeout</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[float]</span>
-</span><span id="1-200">    <span class="n">callback</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Callable[[int, float], None]]</span>
-</span><span id="1-201"><span class="p">):</span>
-</span><span id="1-202">    <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-203">    <span class="k">return</span> <span class="n">Hub</span><span class="o">.</span><span class="n">current</span><span class="o">.</span><span class="n">flush</span><span class="p">(</span><span class="n">timeout</span><span class="o">=</span><span class="n">timeout</span><span class="p">,</span> <span class="n">callback</span><span class="o">=</span><span class="n">callback</span><span class="p">)</span>
-</span><span id="1-204">
-</span><span id="1-205">
-</span><span id="1-206"><span class="nd">@hubmethod</span>
-</span><span id="1-207"><span class="k">def</span> <span class="nf">last_event_id</span><span class="p">():</span>
-</span><span id="1-208">    <span class="c1"># type: () -&gt; Optional[str]</span>
-</span><span id="1-209">
-</span><span id="1-210">    <span class="k">return</span> <span class="n">Hub</span><span class="o">.</span><span class="n">current</span><span class="o">.</span><span class="n">last_event_id</span><span class="p">()</span>
-</span><span id="1-211">
-</span><span id="1-212">
+</span><span id="1-264">
+</span><span id="1-265">
+</span><span id="1-266"><span class="nd">@clientmethod</span>
+</span><span id="1-267"><span class="k">def</span> <span class="nf">flush</span><span class="p">(</span>
+</span><span id="1-268">    <span class="n">timeout</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[float]</span>
+</span><span id="1-269">    <span class="n">callback</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Callable[[int, float], None]]</span>
+</span><span id="1-270"><span class="p">):</span>
+</span><span id="1-271">    <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-272">    <span class="k">return</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_client</span><span class="p">()</span><span class="o">.</span><span class="n">flush</span><span class="p">(</span><span class="n">timeout</span><span class="o">=</span><span class="n">timeout</span><span class="p">,</span> <span class="n">callback</span><span class="o">=</span><span class="n">callback</span><span class="p">)</span>
+</span><span id="1-273">
+</span><span id="1-274">
 <div class="viewcode-block" id="start_span">
 <a class="viewcode-back" href="../../api.html#sentry_sdk.api.start_span">[docs]</a>
-</span><span id="1-213"><span class="nd">@hubmethod</span>
-</span><span id="1-214"><span class="k">def</span> <span class="nf">start_span</span><span class="p">(</span>
-</span><span id="1-215">    <span class="n">span</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Span]</span>
-</span><span id="1-216">    <span class="o">**</span><span class="n">kwargs</span>  <span class="c1"># type: Any</span>
-</span><span id="1-217"><span class="p">):</span>
-</span><span id="1-218">    <span class="c1"># type: (...) -&gt; Span</span>
-</span><span id="1-219">    <span class="k">return</span> <span class="n">Hub</span><span class="o">.</span><span class="n">current</span><span class="o">.</span><span class="n">start_span</span><span class="p">(</span><span class="n">span</span><span class="o">=</span><span class="n">span</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></div>
+</span><span id="1-275"><span class="nd">@scopemethod</span>
+</span><span id="1-276"><span class="k">def</span> <span class="nf">start_span</span><span class="p">(</span>
+</span><span id="1-277">    <span class="o">**</span><span class="n">kwargs</span><span class="p">,</span>  <span class="c1"># type: Any</span>
+</span><span id="1-278"><span class="p">):</span>
+</span><span id="1-279">    <span class="c1"># type: (...) -&gt; Span</span>
+</span><span id="1-280">    <span class="k">return</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_current_scope</span><span class="p">()</span><span class="o">.</span><span class="n">start_span</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></div>
 
-</span><span id="1-220">
-</span><span id="1-221">
+</span><span id="1-281">
+</span><span id="1-282">
 <div class="viewcode-block" id="start_transaction">
 <a class="viewcode-back" href="../../api.html#sentry_sdk.api.start_transaction">[docs]</a>
-</span><span id="1-222"><span class="nd">@hubmethod</span>
-</span><span id="1-223"><span class="k">def</span> <span class="nf">start_transaction</span><span class="p">(</span>
-</span><span id="1-224">    <span class="n">transaction</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Transaction]</span>
-</span><span id="1-225">    <span class="o">**</span><span class="n">kwargs</span>  <span class="c1"># type: Any</span>
-</span><span id="1-226"><span class="p">):</span>
-</span><span id="1-227">    <span class="c1"># type: (...) -&gt; Union[Transaction, NoOpSpan]</span>
-</span><span id="1-228">    <span class="k">return</span> <span class="n">Hub</span><span class="o">.</span><span class="n">current</span><span class="o">.</span><span class="n">start_transaction</span><span class="p">(</span><span class="n">transaction</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></div>
+</span><span id="1-283"><span class="nd">@scopemethod</span>
+</span><span id="1-284"><span class="k">def</span> <span class="nf">start_transaction</span><span class="p">(</span>
+</span><span id="1-285">    <span class="n">transaction</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Transaction]</span>
+</span><span id="1-286">    <span class="n">instrumenter</span><span class="o">=</span><span class="n">INSTRUMENTER</span><span class="o">.</span><span class="n">SENTRY</span><span class="p">,</span>  <span class="c1"># type: str</span>
+</span><span id="1-287">    <span class="n">custom_sampling_context</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[SamplingContext]</span>
+</span><span id="1-288">    <span class="o">**</span><span class="n">kwargs</span><span class="p">,</span>  <span class="c1"># type: Unpack[TransactionKwargs]</span>
+</span><span id="1-289"><span class="p">):</span>
+</span><span id="1-290">    <span class="c1"># type: (...) -&gt; Union[Transaction, NoOpSpan]</span>
+</span><span id="1-291"><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-292"><span class="sd">    Start and return a transaction on the current scope.</span>
+</span><span id="1-293">
+</span><span id="1-294"><span class="sd">    Start an existing transaction if given, otherwise create and start a new</span>
+</span><span id="1-295"><span class="sd">    transaction with kwargs.</span>
+</span><span id="1-296">
+</span><span id="1-297"><span class="sd">    This is the entry point to manual tracing instrumentation.</span>
+</span><span id="1-298">
+</span><span id="1-299"><span class="sd">    A tree structure can be built by adding child spans to the transaction,</span>
+</span><span id="1-300"><span class="sd">    and child spans to other spans. To start a new child span within the</span>
+</span><span id="1-301"><span class="sd">    transaction or any span, call the respective `.start_child()` method.</span>
+</span><span id="1-302">
+</span><span id="1-303"><span class="sd">    Every child span must be finished before the transaction is finished,</span>
+</span><span id="1-304"><span class="sd">    otherwise the unfinished spans are discarded.</span>
+</span><span id="1-305">
+</span><span id="1-306"><span class="sd">    When used as context managers, spans and transactions are automatically</span>
+</span><span id="1-307"><span class="sd">    finished at the end of the `with` block. If not using context managers,</span>
+</span><span id="1-308"><span class="sd">    call the `.finish()` method.</span>
+</span><span id="1-309">
+</span><span id="1-310"><span class="sd">    When the transaction is finished, it will be sent to Sentry with all its</span>
+</span><span id="1-311"><span class="sd">    finished child spans.</span>
+</span><span id="1-312">
+</span><span id="1-313"><span class="sd">    :param transaction: The transaction to start. If omitted, we create and</span>
+</span><span id="1-314"><span class="sd">        start a new transaction.</span>
+</span><span id="1-315"><span class="sd">    :param instrumenter: This parameter is meant for internal use only.</span>
+</span><span id="1-316"><span class="sd">    :param custom_sampling_context: The transaction&#39;s custom sampling context.</span>
+</span><span id="1-317"><span class="sd">    :param kwargs: Optional keyword arguments to be passed to the Transaction</span>
+</span><span id="1-318"><span class="sd">        constructor. See :py:class:`sentry_sdk.tracing.Transaction` for</span>
+</span><span id="1-319"><span class="sd">        available arguments.</span>
+</span><span id="1-320"><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="1-321">    <span class="k">return</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_current_scope</span><span class="p">()</span><span class="o">.</span><span class="n">start_transaction</span><span class="p">(</span>
+</span><span id="1-322">        <span class="n">transaction</span><span class="p">,</span> <span class="n">instrumenter</span><span class="p">,</span> <span class="n">custom_sampling_context</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span>
+</span><span id="1-323">    <span class="p">)</span></div>
 
-</span><span id="1-229">
-</span><span id="1-230">
-</span><span id="1-231"><span class="k">def</span> <span class="nf">set_measurement</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">value</span><span class="p">,</span> <span class="n">unit</span><span class="o">=</span><span class="s2">&quot;&quot;</span><span class="p">):</span>
-</span><span id="1-232">    <span class="c1"># type: (str, float, MeasurementUnit) -&gt; None</span>
-</span><span id="1-233">    <span class="n">transaction</span> <span class="o">=</span> <span class="n">Hub</span><span class="o">.</span><span class="n">current</span><span class="o">.</span><span class="n">scope</span><span class="o">.</span><span class="n">transaction</span>
-</span><span id="1-234">    <span class="k">if</span> <span class="n">transaction</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-235">        <span class="n">transaction</span><span class="o">.</span><span class="n">set_measurement</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">value</span><span class="p">,</span> <span class="n">unit</span><span class="p">)</span>
-</span><span id="1-236">
-</span><span id="1-237">
+</span><span id="1-324">
+</span><span id="1-325">
+</span><span id="1-326"><span class="k">def</span> <span class="nf">set_measurement</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">value</span><span class="p">,</span> <span class="n">unit</span><span class="o">=</span><span class="s2">&quot;&quot;</span><span class="p">):</span>
+</span><span id="1-327">    <span class="c1"># type: (str, float, MeasurementUnit) -&gt; None</span>
+</span><span id="1-328">    <span class="n">transaction</span> <span class="o">=</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_current_scope</span><span class="p">()</span><span class="o">.</span><span class="n">transaction</span>
+</span><span id="1-329">    <span class="k">if</span> <span class="n">transaction</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-330">        <span class="n">transaction</span><span class="o">.</span><span class="n">set_measurement</span><span class="p">(</span><span class="n">name</span><span class="p">,</span> <span class="n">value</span><span class="p">,</span> <span class="n">unit</span><span class="p">)</span>
+</span><span id="1-331">
+</span><span id="1-332">
 <div class="viewcode-block" id="get_current_span">
 <a class="viewcode-back" href="../../api.html#sentry_sdk.api.get_current_span">[docs]</a>
-</span><span id="1-238"><span class="k">def</span> <span class="nf">get_current_span</span><span class="p">(</span><span class="n">hub</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-</span><span id="1-239">    <span class="c1"># type: (Optional[Hub]) -&gt; Optional[Span]</span>
-</span><span id="1-240"><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-241"><span class="sd">    Returns the currently active span if there is one running, otherwise `None`</span>
-</span><span id="1-242"><span class="sd">    &quot;&quot;&quot;</span>
-</span><span id="1-243">    <span class="k">if</span> <span class="n">hub</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-244">        <span class="n">hub</span> <span class="o">=</span> <span class="n">Hub</span><span class="o">.</span><span class="n">current</span>
-</span><span id="1-245">
-</span><span id="1-246">    <span class="n">current_span</span> <span class="o">=</span> <span class="n">hub</span><span class="o">.</span><span class="n">scope</span><span class="o">.</span><span class="n">span</span>
-</span><span id="1-247">    <span class="k">return</span> <span class="n">current_span</span></div>
+</span><span id="1-333"><span class="k">def</span> <span class="nf">get_current_span</span><span class="p">(</span><span class="n">scope</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+</span><span id="1-334">    <span class="c1"># type: (Optional[Scope]) -&gt; Optional[Span]</span>
+</span><span id="1-335"><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-336"><span class="sd">    Returns the currently active span if there is one running, otherwise `None`</span>
+</span><span id="1-337"><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="1-338">    <span class="k">return</span> <span class="n">tracing_utils</span><span class="o">.</span><span class="n">get_current_span</span><span class="p">(</span><span class="n">scope</span><span class="p">)</span></div>
 
-</span><span id="1-248">
-</span><span id="1-249">
+</span><span id="1-339">
+</span><span id="1-340">
 <div class="viewcode-block" id="get_traceparent">
 <a class="viewcode-back" href="../../api.html#sentry_sdk.api.get_traceparent">[docs]</a>
-</span><span id="1-250"><span class="k">def</span> <span class="nf">get_traceparent</span><span class="p">():</span>
-</span><span id="1-251">    <span class="c1"># type: () -&gt; Optional[str]</span>
-</span><span id="1-252"><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-253"><span class="sd">    Returns the traceparent either from the active span or from the scope.</span>
-</span><span id="1-254"><span class="sd">    &quot;&quot;&quot;</span>
-</span><span id="1-255">    <span class="k">return</span> <span class="n">Hub</span><span class="o">.</span><span class="n">current</span><span class="o">.</span><span class="n">get_traceparent</span><span class="p">()</span></div>
+</span><span id="1-341"><span class="k">def</span> <span class="nf">get_traceparent</span><span class="p">():</span>
+</span><span id="1-342">    <span class="c1"># type: () -&gt; Optional[str]</span>
+</span><span id="1-343"><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-344"><span class="sd">    Returns the traceparent either from the active span or from the scope.</span>
+</span><span id="1-345"><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="1-346">    <span class="k">return</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_current_scope</span><span class="p">()</span><span class="o">.</span><span class="n">get_traceparent</span><span class="p">()</span></div>
 
-</span><span id="1-256">
-</span><span id="1-257">
+</span><span id="1-347">
+</span><span id="1-348">
 <div class="viewcode-block" id="get_baggage">
 <a class="viewcode-back" href="../../api.html#sentry_sdk.api.get_baggage">[docs]</a>
-</span><span id="1-258"><span class="k">def</span> <span class="nf">get_baggage</span><span class="p">():</span>
-</span><span id="1-259">    <span class="c1"># type: () -&gt; Optional[str]</span>
-</span><span id="1-260"><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-261"><span class="sd">    Returns Baggage either from the active span or from the scope.</span>
-</span><span id="1-262"><span class="sd">    &quot;&quot;&quot;</span>
-</span><span id="1-263">    <span class="k">return</span> <span class="n">Hub</span><span class="o">.</span><span class="n">current</span><span class="o">.</span><span class="n">get_baggage</span><span class="p">()</span></div>
+</span><span id="1-349"><span class="k">def</span> <span class="nf">get_baggage</span><span class="p">():</span>
+</span><span id="1-350">    <span class="c1"># type: () -&gt; Optional[str]</span>
+</span><span id="1-351"><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-352"><span class="sd">    Returns Baggage either from the active span or from the scope.</span>
+</span><span id="1-353"><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="1-354">    <span class="n">baggage</span> <span class="o">=</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_current_scope</span><span class="p">()</span><span class="o">.</span><span class="n">get_baggage</span><span class="p">()</span>
+</span><span id="1-355">    <span class="k">if</span> <span class="n">baggage</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-356">        <span class="k">return</span> <span class="n">baggage</span><span class="o">.</span><span class="n">serialize</span><span class="p">()</span>
+</span><span id="1-357">
+</span><span id="1-358">    <span class="k">return</span> <span class="kc">None</span></div>
 
-</span><span id="1-264">
-</span><span id="1-265">
+</span><span id="1-359">
+</span><span id="1-360">
 <div class="viewcode-block" id="continue_trace">
 <a class="viewcode-back" href="../../api.html#sentry_sdk.api.continue_trace">[docs]</a>
-</span><span id="1-266"><span class="k">def</span> <span class="nf">continue_trace</span><span class="p">(</span><span class="n">environ_or_headers</span><span class="p">,</span> <span class="n">op</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">source</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-</span><span id="1-267">    <span class="c1"># type: (Dict[str, Any], Optional[str], Optional[str], Optional[str]) -&gt; Transaction</span>
-</span><span id="1-268"><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-269"><span class="sd">    Sets the propagation context from environment or headers and returns a transaction.</span>
-</span><span id="1-270"><span class="sd">    &quot;&quot;&quot;</span>
-</span><span id="1-271">    <span class="k">return</span> <span class="n">Hub</span><span class="o">.</span><span class="n">current</span><span class="o">.</span><span class="n">continue_trace</span><span class="p">(</span><span class="n">environ_or_headers</span><span class="p">,</span> <span class="n">op</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">source</span><span class="p">)</span></div>
+</span><span id="1-361"><span class="k">def</span> <span class="nf">continue_trace</span><span class="p">(</span><span class="n">environ_or_headers</span><span class="p">,</span> <span class="n">op</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">source</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+</span><span id="1-362">    <span class="c1"># type: (Dict[str, Any], Optional[str], Optional[str], Optional[str]) -&gt; Transaction</span>
+</span><span id="1-363"><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-364"><span class="sd">    Sets the propagation context from environment or headers and returns a transaction.</span>
+</span><span id="1-365"><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="1-366">    <span class="k">return</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_isolation_scope</span><span class="p">()</span><span class="o">.</span><span class="n">continue_trace</span><span class="p">(</span>
+</span><span id="1-367">        <span class="n">environ_or_headers</span><span class="p">,</span> <span class="n">op</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">source</span>
+</span><span id="1-368">    <span class="p">)</span></div>
 
 </span></pre></div>
         </article>
@@ -486,7 +589,7 @@ <h1>Source code for sentry_sdk.api</h1><div class="highlight"><pre>
     </div>
   </div>
 </footer></div>
-      <script src="../../_static/documentation_options.js?v=fca6d697"></script>
+      <script src="../../_static/documentation_options.js?v=aa9da443"></script>
       <script src="../../_static/doctools.js?v=888ff710"></script>
       <script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
       <script src="../../_static/shibuya.js?v=999236dc"></script>
diff --git a/_modules/sentry_sdk/attachments.html b/_modules/sentry_sdk/attachments.html
index 93b75d088e..5711a931be 100644
--- a/_modules/sentry_sdk/attachments.html
+++ b/_modules/sentry_sdk/attachments.html
@@ -4,7 +4,7 @@
 <head>
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-      <title>sentry_sdk.attachments - sentry-python 1.44.1 documentation</title>
+      <title>sentry_sdk.attachments - sentry-python 2.0.0rc4 documentation</title>
     <link rel="index" title="Index" href="../../genindex.html" /><link rel="search" title="Search" href="../../search.html" />
 
   <script>
@@ -144,7 +144,7 @@ <h1>Source code for sentry_sdk.attachments</h1><div class="highlight"><pre>
 </span><span id="1-10">
 <div class="viewcode-block" id="Attachment">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.attachments.Attachment">[docs]</a>
-</span><span id="1-11"><span class="k">class</span> <span class="nc">Attachment</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
+</span><span id="1-11"><span class="k">class</span> <span class="nc">Attachment</span><span class="p">:</span>
 </span><span id="1-12">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
 </span><span id="1-13">        <span class="bp">self</span><span class="p">,</span>
 </span><span id="1-14">        <span class="nb">bytes</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Union[None, bytes, Callable[[], bytes]]</span>
@@ -225,7 +225,7 @@ <h1>Source code for sentry_sdk.attachments</h1><div class="highlight"><pre>
     </div>
   </div>
 </footer></div>
-      <script src="../../_static/documentation_options.js?v=fca6d697"></script>
+      <script src="../../_static/documentation_options.js?v=aa9da443"></script>
       <script src="../../_static/doctools.js?v=888ff710"></script>
       <script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
       <script src="../../_static/shibuya.js?v=999236dc"></script>
diff --git a/_modules/sentry_sdk/client.html b/_modules/sentry_sdk/client.html
index 7244b0a99c..03b53f16b5 100644
--- a/_modules/sentry_sdk/client.html
+++ b/_modules/sentry_sdk/client.html
@@ -4,7 +4,7 @@
 <head>
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-      <title>sentry_sdk.client - sentry-python 1.44.1 documentation</title>
+      <title>sentry_sdk.client - sentry-python 2.0.0rc4 documentation</title>
     <link rel="index" title="Index" href="../../genindex.html" /><link rel="search" title="Search" href="../../search.html" />
 
   <script>
@@ -132,824 +132,893 @@
       <div class="min-w-0 max-w-6xl px-6 pb-6 pt-8 xl:px-12">
         <article class="yue" role="main">
           <h1>Source code for sentry_sdk.client</h1><div class="highlight"><pre>
-<span></span><span id="1-1"><span class="k">try</span><span class="p">:</span>
-</span><span id="1-2">    <span class="kn">from</span> <span class="nn">collections.abc</span> <span class="kn">import</span> <span class="n">Mapping</span>
-</span><span id="1-3"><span class="k">except</span> <span class="ne">ImportError</span><span class="p">:</span>
-</span><span id="1-4">    <span class="kn">from</span> <span class="nn">collections</span> <span class="kn">import</span> <span class="n">Mapping</span>  <span class="c1"># type: ignore[attr-defined]</span>
-</span><span id="1-5">
-</span><span id="1-6"><span class="kn">from</span> <span class="nn">importlib</span> <span class="kn">import</span> <span class="n">import_module</span>
-</span><span id="1-7"><span class="kn">import</span> <span class="nn">os</span>
-</span><span id="1-8"><span class="kn">import</span> <span class="nn">uuid</span>
-</span><span id="1-9"><span class="kn">import</span> <span class="nn">random</span>
-</span><span id="1-10"><span class="kn">import</span> <span class="nn">socket</span>
-</span><span id="1-11">
-</span><span id="1-12"><span class="kn">from</span> <span class="nn">sentry_sdk._compat</span> <span class="kn">import</span> <span class="p">(</span>
-</span><span id="1-13">    <span class="n">PY37</span><span class="p">,</span>
-</span><span id="1-14">    <span class="n">datetime_utcnow</span><span class="p">,</span>
-</span><span id="1-15">    <span class="n">string_types</span><span class="p">,</span>
-</span><span id="1-16">    <span class="n">text_type</span><span class="p">,</span>
-</span><span id="1-17">    <span class="n">iteritems</span><span class="p">,</span>
-</span><span id="1-18">    <span class="n">check_uwsgi_thread_support</span><span class="p">,</span>
-</span><span id="1-19"><span class="p">)</span>
-</span><span id="1-20"><span class="kn">from</span> <span class="nn">sentry_sdk.utils</span> <span class="kn">import</span> <span class="p">(</span>
-</span><span id="1-21">    <span class="n">capture_internal_exceptions</span><span class="p">,</span>
-</span><span id="1-22">    <span class="n">current_stacktrace</span><span class="p">,</span>
-</span><span id="1-23">    <span class="n">disable_capture_event</span><span class="p">,</span>
-</span><span id="1-24">    <span class="n">format_timestamp</span><span class="p">,</span>
-</span><span id="1-25">    <span class="n">get_sdk_name</span><span class="p">,</span>
-</span><span id="1-26">    <span class="n">get_type_name</span><span class="p">,</span>
-</span><span id="1-27">    <span class="n">get_default_release</span><span class="p">,</span>
-</span><span id="1-28">    <span class="n">handle_in_app</span><span class="p">,</span>
-</span><span id="1-29">    <span class="n">is_gevent</span><span class="p">,</span>
-</span><span id="1-30">    <span class="n">logger</span><span class="p">,</span>
+<span></span><span id="1-1"><span class="kn">import</span> <span class="nn">os</span>
+</span><span id="1-2"><span class="kn">import</span> <span class="nn">uuid</span>
+</span><span id="1-3"><span class="kn">import</span> <span class="nn">random</span>
+</span><span id="1-4"><span class="kn">import</span> <span class="nn">socket</span>
+</span><span id="1-5"><span class="kn">from</span> <span class="nn">collections.abc</span> <span class="kn">import</span> <span class="n">Mapping</span>
+</span><span id="1-6"><span class="kn">from</span> <span class="nn">datetime</span> <span class="kn">import</span> <span class="n">datetime</span><span class="p">,</span> <span class="n">timezone</span>
+</span><span id="1-7"><span class="kn">from</span> <span class="nn">importlib</span> <span class="kn">import</span> <span class="n">import_module</span>
+</span><span id="1-8">
+</span><span id="1-9"><span class="kn">from</span> <span class="nn">sentry_sdk._compat</span> <span class="kn">import</span> <span class="n">PY37</span><span class="p">,</span> <span class="n">check_uwsgi_thread_support</span>
+</span><span id="1-10"><span class="kn">from</span> <span class="nn">sentry_sdk.utils</span> <span class="kn">import</span> <span class="p">(</span>
+</span><span id="1-11">    <span class="n">capture_internal_exceptions</span><span class="p">,</span>
+</span><span id="1-12">    <span class="n">current_stacktrace</span><span class="p">,</span>
+</span><span id="1-13">    <span class="n">disable_capture_event</span><span class="p">,</span>
+</span><span id="1-14">    <span class="n">format_timestamp</span><span class="p">,</span>
+</span><span id="1-15">    <span class="n">get_sdk_name</span><span class="p">,</span>
+</span><span id="1-16">    <span class="n">get_type_name</span><span class="p">,</span>
+</span><span id="1-17">    <span class="n">get_default_release</span><span class="p">,</span>
+</span><span id="1-18">    <span class="n">handle_in_app</span><span class="p">,</span>
+</span><span id="1-19">    <span class="n">is_gevent</span><span class="p">,</span>
+</span><span id="1-20">    <span class="n">logger</span><span class="p">,</span>
+</span><span id="1-21"><span class="p">)</span>
+</span><span id="1-22"><span class="kn">from</span> <span class="nn">sentry_sdk.serializer</span> <span class="kn">import</span> <span class="n">serialize</span>
+</span><span id="1-23"><span class="kn">from</span> <span class="nn">sentry_sdk.tracing</span> <span class="kn">import</span> <span class="n">trace</span>
+</span><span id="1-24"><span class="kn">from</span> <span class="nn">sentry_sdk.transport</span> <span class="kn">import</span> <span class="n">HttpTransport</span><span class="p">,</span> <span class="n">make_transport</span>
+</span><span id="1-25"><span class="kn">from</span> <span class="nn">sentry_sdk.consts</span> <span class="kn">import</span> <span class="p">(</span>
+</span><span id="1-26">    <span class="n">DEFAULT_MAX_VALUE_LENGTH</span><span class="p">,</span>
+</span><span id="1-27">    <span class="n">DEFAULT_OPTIONS</span><span class="p">,</span>
+</span><span id="1-28">    <span class="n">INSTRUMENTER</span><span class="p">,</span>
+</span><span id="1-29">    <span class="n">VERSION</span><span class="p">,</span>
+</span><span id="1-30">    <span class="n">ClientConstructor</span><span class="p">,</span>
 </span><span id="1-31"><span class="p">)</span>
-</span><span id="1-32"><span class="kn">from</span> <span class="nn">sentry_sdk.serializer</span> <span class="kn">import</span> <span class="n">serialize</span>
-</span><span id="1-33"><span class="kn">from</span> <span class="nn">sentry_sdk.tracing</span> <span class="kn">import</span> <span class="n">trace</span><span class="p">,</span> <span class="n">has_tracing_enabled</span>
-</span><span id="1-34"><span class="kn">from</span> <span class="nn">sentry_sdk.transport</span> <span class="kn">import</span> <span class="n">HttpTransport</span><span class="p">,</span> <span class="n">make_transport</span>
-</span><span id="1-35"><span class="kn">from</span> <span class="nn">sentry_sdk.consts</span> <span class="kn">import</span> <span class="p">(</span>
-</span><span id="1-36">    <span class="n">DEFAULT_MAX_VALUE_LENGTH</span><span class="p">,</span>
-</span><span id="1-37">    <span class="n">DEFAULT_OPTIONS</span><span class="p">,</span>
-</span><span id="1-38">    <span class="n">INSTRUMENTER</span><span class="p">,</span>
-</span><span id="1-39">    <span class="n">VERSION</span><span class="p">,</span>
-</span><span id="1-40">    <span class="n">ClientConstructor</span><span class="p">,</span>
-</span><span id="1-41"><span class="p">)</span>
-</span><span id="1-42"><span class="kn">from</span> <span class="nn">sentry_sdk.integrations</span> <span class="kn">import</span> <span class="n">_DEFAULT_INTEGRATIONS</span><span class="p">,</span> <span class="n">setup_integrations</span>
-</span><span id="1-43"><span class="kn">from</span> <span class="nn">sentry_sdk.utils</span> <span class="kn">import</span> <span class="n">ContextVar</span>
-</span><span id="1-44"><span class="kn">from</span> <span class="nn">sentry_sdk.sessions</span> <span class="kn">import</span> <span class="n">SessionFlusher</span>
-</span><span id="1-45"><span class="kn">from</span> <span class="nn">sentry_sdk.envelope</span> <span class="kn">import</span> <span class="n">Envelope</span>
-</span><span id="1-46"><span class="kn">from</span> <span class="nn">sentry_sdk.profiler</span> <span class="kn">import</span> <span class="n">has_profiling_enabled</span><span class="p">,</span> <span class="n">Profile</span><span class="p">,</span> <span class="n">setup_profiler</span>
-</span><span id="1-47"><span class="kn">from</span> <span class="nn">sentry_sdk.scrubber</span> <span class="kn">import</span> <span class="n">EventScrubber</span>
-</span><span id="1-48"><span class="kn">from</span> <span class="nn">sentry_sdk.monitor</span> <span class="kn">import</span> <span class="n">Monitor</span>
-</span><span id="1-49"><span class="kn">from</span> <span class="nn">sentry_sdk.spotlight</span> <span class="kn">import</span> <span class="n">setup_spotlight</span>
-</span><span id="1-50">
-</span><span id="1-51"><span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="n">TYPE_CHECKING</span>
-</span><span id="1-52">
-</span><span id="1-53"><span class="k">if</span> <span class="n">TYPE_CHECKING</span><span class="p">:</span>
-</span><span id="1-54">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Any</span>
-</span><span id="1-55">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Callable</span>
-</span><span id="1-56">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Dict</span>
-</span><span id="1-57">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Optional</span>
-</span><span id="1-58">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Sequence</span>
-</span><span id="1-59">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Type</span>
-</span><span id="1-60">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Union</span>
+</span><span id="1-32"><span class="kn">from</span> <span class="nn">sentry_sdk.integrations</span> <span class="kn">import</span> <span class="n">_DEFAULT_INTEGRATIONS</span><span class="p">,</span> <span class="n">setup_integrations</span>
+</span><span id="1-33"><span class="kn">from</span> <span class="nn">sentry_sdk.utils</span> <span class="kn">import</span> <span class="n">ContextVar</span>
+</span><span id="1-34"><span class="kn">from</span> <span class="nn">sentry_sdk.sessions</span> <span class="kn">import</span> <span class="n">SessionFlusher</span>
+</span><span id="1-35"><span class="kn">from</span> <span class="nn">sentry_sdk.envelope</span> <span class="kn">import</span> <span class="n">Envelope</span>
+</span><span id="1-36"><span class="kn">from</span> <span class="nn">sentry_sdk.profiler</span> <span class="kn">import</span> <span class="n">has_profiling_enabled</span><span class="p">,</span> <span class="n">Profile</span><span class="p">,</span> <span class="n">setup_profiler</span>
+</span><span id="1-37"><span class="kn">from</span> <span class="nn">sentry_sdk.scrubber</span> <span class="kn">import</span> <span class="n">EventScrubber</span>
+</span><span id="1-38"><span class="kn">from</span> <span class="nn">sentry_sdk.monitor</span> <span class="kn">import</span> <span class="n">Monitor</span>
+</span><span id="1-39"><span class="kn">from</span> <span class="nn">sentry_sdk.spotlight</span> <span class="kn">import</span> <span class="n">setup_spotlight</span>
+</span><span id="1-40">
+</span><span id="1-41"><span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="n">TYPE_CHECKING</span>
+</span><span id="1-42">
+</span><span id="1-43"><span class="k">if</span> <span class="n">TYPE_CHECKING</span><span class="p">:</span>
+</span><span id="1-44">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Any</span>
+</span><span id="1-45">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Callable</span>
+</span><span id="1-46">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Dict</span>
+</span><span id="1-47">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Optional</span>
+</span><span id="1-48">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Sequence</span>
+</span><span id="1-49">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Type</span>
+</span><span id="1-50">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Union</span>
+</span><span id="1-51">
+</span><span id="1-52">    <span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="n">Event</span><span class="p">,</span> <span class="n">Hint</span>
+</span><span id="1-53">    <span class="kn">from</span> <span class="nn">sentry_sdk.integrations</span> <span class="kn">import</span> <span class="n">Integration</span>
+</span><span id="1-54">    <span class="kn">from</span> <span class="nn">sentry_sdk.metrics</span> <span class="kn">import</span> <span class="n">MetricsAggregator</span>
+</span><span id="1-55">    <span class="kn">from</span> <span class="nn">sentry_sdk.scope</span> <span class="kn">import</span> <span class="n">Scope</span>
+</span><span id="1-56">    <span class="kn">from</span> <span class="nn">sentry_sdk.session</span> <span class="kn">import</span> <span class="n">Session</span>
+</span><span id="1-57">    <span class="kn">from</span> <span class="nn">sentry_sdk.transport</span> <span class="kn">import</span> <span class="n">Transport</span>
+</span><span id="1-58">
+</span><span id="1-59">
+</span><span id="1-60"><span class="n">_client_init_debug</span> <span class="o">=</span> <span class="n">ContextVar</span><span class="p">(</span><span class="s2">&quot;client_init_debug&quot;</span><span class="p">)</span>
 </span><span id="1-61">
-</span><span id="1-62">    <span class="kn">from</span> <span class="nn">sentry_sdk.integrations</span> <span class="kn">import</span> <span class="n">Integration</span>
-</span><span id="1-63">    <span class="kn">from</span> <span class="nn">sentry_sdk.scope</span> <span class="kn">import</span> <span class="n">Scope</span>
-</span><span id="1-64">    <span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="n">Event</span><span class="p">,</span> <span class="n">Hint</span>
-</span><span id="1-65">    <span class="kn">from</span> <span class="nn">sentry_sdk.session</span> <span class="kn">import</span> <span class="n">Session</span>
-</span><span id="1-66">
-</span><span id="1-67">
-</span><span id="1-68"><span class="n">_client_init_debug</span> <span class="o">=</span> <span class="n">ContextVar</span><span class="p">(</span><span class="s2">&quot;client_init_debug&quot;</span><span class="p">)</span>
+</span><span id="1-62">
+</span><span id="1-63"><span class="n">SDK_INFO</span> <span class="o">=</span> <span class="p">{</span>
+</span><span id="1-64">    <span class="s2">&quot;name&quot;</span><span class="p">:</span> <span class="s2">&quot;sentry.python&quot;</span><span class="p">,</span>  <span class="c1"># SDK name will be overridden after integrations have been loaded with sentry_sdk.integrations.setup_integrations()</span>
+</span><span id="1-65">    <span class="s2">&quot;version&quot;</span><span class="p">:</span> <span class="n">VERSION</span><span class="p">,</span>
+</span><span id="1-66">    <span class="s2">&quot;packages&quot;</span><span class="p">:</span> <span class="p">[{</span><span class="s2">&quot;name&quot;</span><span class="p">:</span> <span class="s2">&quot;pypi:sentry-sdk&quot;</span><span class="p">,</span> <span class="s2">&quot;version&quot;</span><span class="p">:</span> <span class="n">VERSION</span><span class="p">}],</span>
+</span><span id="1-67"><span class="p">}</span>
+</span><span id="1-68">
 </span><span id="1-69">
-</span><span id="1-70">
-</span><span id="1-71"><span class="n">SDK_INFO</span> <span class="o">=</span> <span class="p">{</span>
-</span><span id="1-72">    <span class="s2">&quot;name&quot;</span><span class="p">:</span> <span class="s2">&quot;sentry.python&quot;</span><span class="p">,</span>  <span class="c1"># SDK name will be overridden after integrations have been loaded with sentry_sdk.integrations.setup_integrations()</span>
-</span><span id="1-73">    <span class="s2">&quot;version&quot;</span><span class="p">:</span> <span class="n">VERSION</span><span class="p">,</span>
-</span><span id="1-74">    <span class="s2">&quot;packages&quot;</span><span class="p">:</span> <span class="p">[{</span><span class="s2">&quot;name&quot;</span><span class="p">:</span> <span class="s2">&quot;pypi:sentry-sdk&quot;</span><span class="p">,</span> <span class="s2">&quot;version&quot;</span><span class="p">:</span> <span class="n">VERSION</span><span class="p">}],</span>
-</span><span id="1-75"><span class="p">}</span>
-</span><span id="1-76">
+</span><span id="1-70"><span class="k">def</span> <span class="nf">_get_options</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
+</span><span id="1-71">    <span class="c1"># type: (*Optional[str], **Any) -&gt; Dict[str, Any]</span>
+</span><span id="1-72">    <span class="k">if</span> <span class="n">args</span> <span class="ow">and</span> <span class="p">(</span><span class="nb">isinstance</span><span class="p">(</span><span class="n">args</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="p">(</span><span class="nb">bytes</span><span class="p">,</span> <span class="nb">str</span><span class="p">))</span> <span class="ow">or</span> <span class="n">args</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">):</span>
+</span><span id="1-73">        <span class="n">dsn</span> <span class="o">=</span> <span class="n">args</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span>  <span class="c1"># type: Optional[str]</span>
+</span><span id="1-74">        <span class="n">args</span> <span class="o">=</span> <span class="n">args</span><span class="p">[</span><span class="mi">1</span><span class="p">:]</span>
+</span><span id="1-75">    <span class="k">else</span><span class="p">:</span>
+</span><span id="1-76">        <span class="n">dsn</span> <span class="o">=</span> <span class="kc">None</span>
 </span><span id="1-77">
-</span><span id="1-78"><span class="k">def</span> <span class="nf">_get_options</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-</span><span id="1-79">    <span class="c1"># type: (*Optional[str], **Any) -&gt; Dict[str, Any]</span>
-</span><span id="1-80">    <span class="k">if</span> <span class="n">args</span> <span class="ow">and</span> <span class="p">(</span><span class="nb">isinstance</span><span class="p">(</span><span class="n">args</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="p">(</span><span class="n">text_type</span><span class="p">,</span> <span class="nb">bytes</span><span class="p">,</span> <span class="nb">str</span><span class="p">))</span> <span class="ow">or</span> <span class="n">args</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">):</span>
-</span><span id="1-81">        <span class="n">dsn</span> <span class="o">=</span> <span class="n">args</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span>  <span class="c1"># type: Optional[str]</span>
-</span><span id="1-82">        <span class="n">args</span> <span class="o">=</span> <span class="n">args</span><span class="p">[</span><span class="mi">1</span><span class="p">:]</span>
-</span><span id="1-83">    <span class="k">else</span><span class="p">:</span>
-</span><span id="1-84">        <span class="n">dsn</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="1-78">    <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">args</span><span class="p">)</span> <span class="o">&gt;</span> <span class="mi">1</span><span class="p">:</span>
+</span><span id="1-79">        <span class="k">raise</span> <span class="ne">TypeError</span><span class="p">(</span><span class="s2">&quot;Only single positional argument is expected&quot;</span><span class="p">)</span>
+</span><span id="1-80">
+</span><span id="1-81">    <span class="n">rv</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="n">DEFAULT_OPTIONS</span><span class="p">)</span>
+</span><span id="1-82">    <span class="n">options</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+</span><span id="1-83">    <span class="k">if</span> <span class="n">dsn</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;dsn&quot;</span><span class="p">)</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-84">        <span class="n">options</span><span class="p">[</span><span class="s2">&quot;dsn&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">dsn</span>
 </span><span id="1-85">
-</span><span id="1-86">    <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">args</span><span class="p">)</span> <span class="o">&gt;</span> <span class="mi">1</span><span class="p">:</span>
-</span><span id="1-87">        <span class="k">raise</span> <span class="ne">TypeError</span><span class="p">(</span><span class="s2">&quot;Only single positional argument is expected&quot;</span><span class="p">)</span>
-</span><span id="1-88">
-</span><span id="1-89">    <span class="n">rv</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="n">DEFAULT_OPTIONS</span><span class="p">)</span>
-</span><span id="1-90">    <span class="n">options</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-</span><span id="1-91">    <span class="k">if</span> <span class="n">dsn</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;dsn&quot;</span><span class="p">)</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-92">        <span class="n">options</span><span class="p">[</span><span class="s2">&quot;dsn&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">dsn</span>
-</span><span id="1-93">
-</span><span id="1-94">    <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">iteritems</span><span class="p">(</span><span class="n">options</span><span class="p">):</span>
-</span><span id="1-95">        <span class="k">if</span> <span class="n">key</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">rv</span><span class="p">:</span>
-</span><span id="1-96">            <span class="c1"># Option &quot;with_locals&quot; was renamed to &quot;include_local_variables&quot;</span>
-</span><span id="1-97">            <span class="k">if</span> <span class="n">key</span> <span class="o">==</span> <span class="s2">&quot;with_locals&quot;</span><span class="p">:</span>
-</span><span id="1-98">                <span class="n">msg</span> <span class="o">=</span> <span class="p">(</span>
-</span><span id="1-99">                    <span class="s2">&quot;Deprecated: The option &#39;with_locals&#39; was renamed to &#39;include_local_variables&#39;. &quot;</span>
-</span><span id="1-100">                    <span class="s2">&quot;Please use &#39;include_local_variables&#39;. The option &#39;with_locals&#39; will be removed in the future.&quot;</span>
-</span><span id="1-101">                <span class="p">)</span>
-</span><span id="1-102">                <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span><span class="n">msg</span><span class="p">)</span>
-</span><span id="1-103">                <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;include_local_variables&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">value</span>
-</span><span id="1-104">                <span class="k">continue</span>
-</span><span id="1-105">
-</span><span id="1-106">            <span class="c1"># Option &quot;request_bodies&quot; was renamed to &quot;max_request_body_size&quot;</span>
-</span><span id="1-107">            <span class="k">if</span> <span class="n">key</span> <span class="o">==</span> <span class="s2">&quot;request_bodies&quot;</span><span class="p">:</span>
-</span><span id="1-108">                <span class="n">msg</span> <span class="o">=</span> <span class="p">(</span>
-</span><span id="1-109">                    <span class="s2">&quot;Deprecated: The option &#39;request_bodies&#39; was renamed to &#39;max_request_body_size&#39;. &quot;</span>
-</span><span id="1-110">                    <span class="s2">&quot;Please use &#39;max_request_body_size&#39;. The option &#39;request_bodies&#39; will be removed in the future.&quot;</span>
-</span><span id="1-111">                <span class="p">)</span>
-</span><span id="1-112">                <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span><span class="n">msg</span><span class="p">)</span>
-</span><span id="1-113">                <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;max_request_body_size&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">value</span>
-</span><span id="1-114">                <span class="k">continue</span>
-</span><span id="1-115">
-</span><span id="1-116">            <span class="k">raise</span> <span class="ne">TypeError</span><span class="p">(</span><span class="s2">&quot;Unknown option </span><span class="si">%r</span><span class="s2">&quot;</span> <span class="o">%</span> <span class="p">(</span><span class="n">key</span><span class="p">,))</span>
-</span><span id="1-117">
-</span><span id="1-118">        <span class="n">rv</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="o">=</span> <span class="n">value</span>
+</span><span id="1-86">    <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">options</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
+</span><span id="1-87">        <span class="k">if</span> <span class="n">key</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">rv</span><span class="p">:</span>
+</span><span id="1-88">            <span class="k">raise</span> <span class="ne">TypeError</span><span class="p">(</span><span class="s2">&quot;Unknown option </span><span class="si">%r</span><span class="s2">&quot;</span> <span class="o">%</span> <span class="p">(</span><span class="n">key</span><span class="p">,))</span>
+</span><span id="1-89">
+</span><span id="1-90">        <span class="n">rv</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="o">=</span> <span class="n">value</span>
+</span><span id="1-91">
+</span><span id="1-92">    <span class="k">if</span> <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;dsn&quot;</span><span class="p">]</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-93">        <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;dsn&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;SENTRY_DSN&quot;</span><span class="p">)</span>
+</span><span id="1-94">
+</span><span id="1-95">    <span class="k">if</span> <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;release&quot;</span><span class="p">]</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-96">        <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;release&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">get_default_release</span><span class="p">()</span>
+</span><span id="1-97">
+</span><span id="1-98">    <span class="k">if</span> <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;environment&quot;</span><span class="p">]</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-99">        <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;environment&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;SENTRY_ENVIRONMENT&quot;</span><span class="p">)</span> <span class="ow">or</span> <span class="s2">&quot;production&quot;</span>
+</span><span id="1-100">
+</span><span id="1-101">    <span class="k">if</span> <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;debug&quot;</span><span class="p">]</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-102">        <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;debug&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;SENTRY_DEBUG&quot;</span><span class="p">,</span> <span class="s2">&quot;False&quot;</span><span class="p">)</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span> <span class="ow">in</span> <span class="p">(</span>
+</span><span id="1-103">            <span class="s2">&quot;true&quot;</span><span class="p">,</span>
+</span><span id="1-104">            <span class="s2">&quot;1&quot;</span><span class="p">,</span>
+</span><span id="1-105">            <span class="s2">&quot;t&quot;</span><span class="p">,</span>
+</span><span id="1-106">        <span class="p">)</span>
+</span><span id="1-107">
+</span><span id="1-108">    <span class="k">if</span> <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;server_name&quot;</span><span class="p">]</span> <span class="ow">is</span> <span class="kc">None</span> <span class="ow">and</span> <span class="nb">hasattr</span><span class="p">(</span><span class="n">socket</span><span class="p">,</span> <span class="s2">&quot;gethostname&quot;</span><span class="p">):</span>
+</span><span id="1-109">        <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;server_name&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">socket</span><span class="o">.</span><span class="n">gethostname</span><span class="p">()</span>
+</span><span id="1-110">
+</span><span id="1-111">    <span class="k">if</span> <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;instrumenter&quot;</span><span class="p">]</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-112">        <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;instrumenter&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">INSTRUMENTER</span><span class="o">.</span><span class="n">SENTRY</span>
+</span><span id="1-113">
+</span><span id="1-114">    <span class="k">if</span> <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;project_root&quot;</span><span class="p">]</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-115">        <span class="k">try</span><span class="p">:</span>
+</span><span id="1-116">            <span class="n">project_root</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">getcwd</span><span class="p">()</span>
+</span><span id="1-117">        <span class="k">except</span> <span class="ne">Exception</span><span class="p">:</span>
+</span><span id="1-118">            <span class="n">project_root</span> <span class="o">=</span> <span class="kc">None</span>
 </span><span id="1-119">
-</span><span id="1-120">    <span class="k">if</span> <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;dsn&quot;</span><span class="p">]</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-121">        <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;dsn&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;SENTRY_DSN&quot;</span><span class="p">)</span>
-</span><span id="1-122">
-</span><span id="1-123">    <span class="k">if</span> <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;release&quot;</span><span class="p">]</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-124">        <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;release&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">get_default_release</span><span class="p">()</span>
-</span><span id="1-125">
-</span><span id="1-126">    <span class="k">if</span> <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;environment&quot;</span><span class="p">]</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-127">        <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;environment&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;SENTRY_ENVIRONMENT&quot;</span><span class="p">)</span> <span class="ow">or</span> <span class="s2">&quot;production&quot;</span>
-</span><span id="1-128">
-</span><span id="1-129">    <span class="k">if</span> <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;debug&quot;</span><span class="p">]</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-130">        <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;debug&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;SENTRY_DEBUG&quot;</span><span class="p">,</span> <span class="s2">&quot;False&quot;</span><span class="p">)</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span> <span class="ow">in</span> <span class="p">(</span>
-</span><span id="1-131">            <span class="s2">&quot;true&quot;</span><span class="p">,</span>
-</span><span id="1-132">            <span class="s2">&quot;1&quot;</span><span class="p">,</span>
-</span><span id="1-133">            <span class="s2">&quot;t&quot;</span><span class="p">,</span>
-</span><span id="1-134">        <span class="p">)</span>
+</span><span id="1-120">        <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;project_root&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">project_root</span>
+</span><span id="1-121">
+</span><span id="1-122">    <span class="k">if</span> <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;enable_tracing&quot;</span><span class="p">]</span> <span class="ow">is</span> <span class="kc">True</span> <span class="ow">and</span> <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;traces_sample_rate&quot;</span><span class="p">]</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-123">        <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;traces_sample_rate&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="mf">1.0</span>
+</span><span id="1-124">
+</span><span id="1-125">    <span class="k">if</span> <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;event_scrubber&quot;</span><span class="p">]</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-126">        <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;event_scrubber&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">EventScrubber</span><span class="p">()</span>
+</span><span id="1-127">
+</span><span id="1-128">    <span class="k">if</span> <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;socket_options&quot;</span><span class="p">]</span> <span class="ow">and</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">rv</span><span class="p">[</span><span class="s2">&quot;socket_options&quot;</span><span class="p">],</span> <span class="nb">list</span><span class="p">):</span>
+</span><span id="1-129">        <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
+</span><span id="1-130">            <span class="s2">&quot;Ignoring socket_options because of unexpected format. See urllib3.HTTPConnection.socket_options for the expected format.&quot;</span>
+</span><span id="1-131">        <span class="p">)</span>
+</span><span id="1-132">        <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;socket_options&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="1-133">
+</span><span id="1-134">    <span class="k">return</span> <span class="n">rv</span>
 </span><span id="1-135">
-</span><span id="1-136">    <span class="k">if</span> <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;server_name&quot;</span><span class="p">]</span> <span class="ow">is</span> <span class="kc">None</span> <span class="ow">and</span> <span class="nb">hasattr</span><span class="p">(</span><span class="n">socket</span><span class="p">,</span> <span class="s2">&quot;gethostname&quot;</span><span class="p">):</span>
-</span><span id="1-137">        <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;server_name&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">socket</span><span class="o">.</span><span class="n">gethostname</span><span class="p">()</span>
-</span><span id="1-138">
-</span><span id="1-139">    <span class="k">if</span> <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;instrumenter&quot;</span><span class="p">]</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-140">        <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;instrumenter&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">INSTRUMENTER</span><span class="o">.</span><span class="n">SENTRY</span>
-</span><span id="1-141">
-</span><span id="1-142">    <span class="k">if</span> <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;project_root&quot;</span><span class="p">]</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-143">        <span class="k">try</span><span class="p">:</span>
-</span><span id="1-144">            <span class="n">project_root</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">getcwd</span><span class="p">()</span>
-</span><span id="1-145">        <span class="k">except</span> <span class="ne">Exception</span><span class="p">:</span>
-</span><span id="1-146">            <span class="n">project_root</span> <span class="o">=</span> <span class="kc">None</span>
-</span><span id="1-147">
-</span><span id="1-148">        <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;project_root&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">project_root</span>
-</span><span id="1-149">
-</span><span id="1-150">    <span class="k">if</span> <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;enable_tracing&quot;</span><span class="p">]</span> <span class="ow">is</span> <span class="kc">True</span> <span class="ow">and</span> <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;traces_sample_rate&quot;</span><span class="p">]</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-151">        <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;traces_sample_rate&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="mf">1.0</span>
-</span><span id="1-152">
-</span><span id="1-153">    <span class="k">if</span> <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;event_scrubber&quot;</span><span class="p">]</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-154">        <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;event_scrubber&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">EventScrubber</span><span class="p">()</span>
-</span><span id="1-155">
-</span><span id="1-156">    <span class="k">if</span> <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;socket_options&quot;</span><span class="p">]</span> <span class="ow">and</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">rv</span><span class="p">[</span><span class="s2">&quot;socket_options&quot;</span><span class="p">],</span> <span class="nb">list</span><span class="p">):</span>
-</span><span id="1-157">        <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
-</span><span id="1-158">            <span class="s2">&quot;Ignoring socket_options because of unexpected format. See urllib3.HTTPConnection.socket_options for the expected format.&quot;</span>
-</span><span id="1-159">        <span class="p">)</span>
-</span><span id="1-160">        <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;socket_options&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="1-136">
+</span><span id="1-137"><span class="k">try</span><span class="p">:</span>
+</span><span id="1-138">    <span class="c1"># Python 3.6+</span>
+</span><span id="1-139">    <span class="n">module_not_found_error</span> <span class="o">=</span> <span class="ne">ModuleNotFoundError</span>
+</span><span id="1-140"><span class="k">except</span> <span class="ne">Exception</span><span class="p">:</span>
+</span><span id="1-141">    <span class="c1"># Older Python versions</span>
+</span><span id="1-142">    <span class="n">module_not_found_error</span> <span class="o">=</span> <span class="ne">ImportError</span>  <span class="c1"># type: ignore</span>
+</span><span id="1-143">
+</span><span id="1-144">
+<div class="viewcode-block" id="BaseClient">
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.BaseClient">[docs]</a>
+</span><span id="1-145"><span class="k">class</span> <span class="nc">BaseClient</span><span class="p">:</span>
+</span><span id="1-146"><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-147"><span class="sd">    .. versionadded:: 2.0.0</span>
+</span><span id="1-148">
+</span><span id="1-149"><span class="sd">    The basic definition of a client that is used for sending data to Sentry.</span>
+</span><span id="1-150"><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="1-151">
+</span><span id="1-152">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">options</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+</span><span id="1-153">        <span class="c1"># type: (Optional[Dict[str, Any]]) -&gt; None</span>
+</span><span id="1-154">        <span class="bp">self</span><span class="o">.</span><span class="n">options</span> <span class="o">=</span> <span class="p">(</span>
+</span><span id="1-155">            <span class="n">options</span> <span class="k">if</span> <span class="n">options</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="k">else</span> <span class="n">DEFAULT_OPTIONS</span>
+</span><span id="1-156">        <span class="p">)</span>  <span class="c1"># type: Dict[str, Any]</span>
+</span><span id="1-157">
+</span><span id="1-158">        <span class="bp">self</span><span class="o">.</span><span class="n">transport</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[Transport]</span>
+</span><span id="1-159">        <span class="bp">self</span><span class="o">.</span><span class="n">monitor</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[Monitor]</span>
+</span><span id="1-160">        <span class="bp">self</span><span class="o">.</span><span class="n">metrics_aggregator</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[MetricsAggregator]</span>
 </span><span id="1-161">
-</span><span id="1-162">    <span class="k">return</span> <span class="n">rv</span>
-</span><span id="1-163">
-</span><span id="1-164">
-</span><span id="1-165"><span class="k">try</span><span class="p">:</span>
-</span><span id="1-166">    <span class="c1"># Python 3.6+</span>
-</span><span id="1-167">    <span class="n">module_not_found_error</span> <span class="o">=</span> <span class="ne">ModuleNotFoundError</span>
-</span><span id="1-168"><span class="k">except</span> <span class="ne">Exception</span><span class="p">:</span>
-</span><span id="1-169">    <span class="c1"># Older Python versions</span>
-</span><span id="1-170">    <span class="n">module_not_found_error</span> <span class="o">=</span> <span class="ne">ImportError</span>  <span class="c1"># type: ignore</span>
-</span><span id="1-171">
-</span><span id="1-172">
-<div class="viewcode-block" id="_Client">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk._Client">[docs]</a>
-</span><span id="1-173"><span class="k">class</span> <span class="nc">_Client</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-</span><span id="1-174"><span class="w">    </span><span class="sd">&quot;&quot;&quot;The client is internally responsible for capturing the events and</span>
-</span><span id="1-175"><span class="sd">    forwarding them to sentry through the configured transport.  It takes</span>
-</span><span id="1-176"><span class="sd">    the client options as keyword arguments and optionally the DSN as first</span>
-</span><span id="1-177"><span class="sd">    argument.</span>
+</span><span id="1-162">    <span class="k">def</span> <span class="nf">__getstate__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
+</span><span id="1-163">        <span class="c1"># type: (*Any, **Any) -&gt; Any</span>
+</span><span id="1-164">        <span class="k">return</span> <span class="p">{</span><span class="s2">&quot;options&quot;</span><span class="p">:</span> <span class="p">{}}</span>
+</span><span id="1-165">
+</span><span id="1-166">    <span class="k">def</span> <span class="nf">__setstate__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
+</span><span id="1-167">        <span class="c1"># type: (*Any, **Any) -&gt; None</span>
+</span><span id="1-168">        <span class="k">pass</span>
+</span><span id="1-169">
+</span><span id="1-170">    <span class="nd">@property</span>
+</span><span id="1-171">    <span class="k">def</span> <span class="nf">dsn</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-172">        <span class="c1"># type: () -&gt; Optional[str]</span>
+</span><span id="1-173">        <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-174">
+</span><span id="1-175">    <span class="k">def</span> <span class="nf">should_send_default_pii</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-176">        <span class="c1"># type: () -&gt; bool</span>
+</span><span id="1-177">        <span class="k">return</span> <span class="kc">False</span>
 </span><span id="1-178">
-</span><span id="1-179"><span class="sd">    Alias of :py:class:`Client`. (Was created for better intelisense support)</span>
-</span><span id="1-180"><span class="sd">    &quot;&quot;&quot;</span>
-</span><span id="1-181">
-</span><span id="1-182">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-</span><span id="1-183">        <span class="c1"># type: (*Any, **Any) -&gt; None</span>
-</span><span id="1-184">        <span class="bp">self</span><span class="o">.</span><span class="n">options</span> <span class="o">=</span> <span class="n">get_options</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>  <span class="c1"># type: Dict[str, Any]</span>
-</span><span id="1-185">
-</span><span id="1-186">        <span class="bp">self</span><span class="o">.</span><span class="n">_init_impl</span><span class="p">()</span>
+<div class="viewcode-block" id="BaseClient.is_active">
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.BaseClient.is_active">[docs]</a>
+</span><span id="1-179">    <span class="k">def</span> <span class="nf">is_active</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-180">        <span class="c1"># type: () -&gt; bool</span>
+</span><span id="1-181"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-182"><span class="sd">        .. versionadded:: 2.0.0</span>
+</span><span id="1-183">
+</span><span id="1-184"><span class="sd">        Returns whether the client is active (able to send data to Sentry)</span>
+</span><span id="1-185"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-186">        <span class="k">return</span> <span class="kc">False</span></div>
+
 </span><span id="1-187">
-</span><span id="1-188">    <span class="k">def</span> <span class="nf">__getstate__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-189">        <span class="c1"># type: () -&gt; Any</span>
-</span><span id="1-190">        <span class="k">return</span> <span class="p">{</span><span class="s2">&quot;options&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">}</span>
+</span><span id="1-188">    <span class="k">def</span> <span class="nf">capture_event</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
+</span><span id="1-189">        <span class="c1"># type: (*Any, **Any) -&gt; Optional[str]</span>
+</span><span id="1-190">        <span class="k">return</span> <span class="kc">None</span>
 </span><span id="1-191">
-</span><span id="1-192">    <span class="k">def</span> <span class="nf">__setstate__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">state</span><span class="p">):</span>
-</span><span id="1-193">        <span class="c1"># type: (Any) -&gt; None</span>
-</span><span id="1-194">        <span class="bp">self</span><span class="o">.</span><span class="n">options</span> <span class="o">=</span> <span class="n">state</span><span class="p">[</span><span class="s2">&quot;options&quot;</span><span class="p">]</span>
-</span><span id="1-195">        <span class="bp">self</span><span class="o">.</span><span class="n">_init_impl</span><span class="p">()</span>
-</span><span id="1-196">
-</span><span id="1-197">    <span class="k">def</span> <span class="nf">_setup_instrumentation</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">functions_to_trace</span><span class="p">):</span>
-</span><span id="1-198">        <span class="c1"># type: (Sequence[Dict[str, str]]) -&gt; None</span>
-</span><span id="1-199"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-200"><span class="sd">        Instruments the functions given in the list `functions_to_trace` with the `@sentry_sdk.tracing.trace` decorator.</span>
-</span><span id="1-201"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-202">        <span class="k">for</span> <span class="n">function</span> <span class="ow">in</span> <span class="n">functions_to_trace</span><span class="p">:</span>
-</span><span id="1-203">            <span class="n">class_name</span> <span class="o">=</span> <span class="kc">None</span>
-</span><span id="1-204">            <span class="n">function_qualname</span> <span class="o">=</span> <span class="n">function</span><span class="p">[</span><span class="s2">&quot;qualified_name&quot;</span><span class="p">]</span>
-</span><span id="1-205">            <span class="n">module_name</span><span class="p">,</span> <span class="n">function_name</span> <span class="o">=</span> <span class="n">function_qualname</span><span class="o">.</span><span class="n">rsplit</span><span class="p">(</span><span class="s2">&quot;.&quot;</span><span class="p">,</span> <span class="mi">1</span><span class="p">)</span>
-</span><span id="1-206">
-</span><span id="1-207">            <span class="k">try</span><span class="p">:</span>
-</span><span id="1-208">                <span class="c1"># Try to import module and function</span>
-</span><span id="1-209">                <span class="c1"># ex: &quot;mymodule.submodule.funcname&quot;</span>
-</span><span id="1-210">
-</span><span id="1-211">                <span class="n">module_obj</span> <span class="o">=</span> <span class="n">import_module</span><span class="p">(</span><span class="n">module_name</span><span class="p">)</span>
-</span><span id="1-212">                <span class="n">function_obj</span> <span class="o">=</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">module_obj</span><span class="p">,</span> <span class="n">function_name</span><span class="p">)</span>
-</span><span id="1-213">                <span class="nb">setattr</span><span class="p">(</span><span class="n">module_obj</span><span class="p">,</span> <span class="n">function_name</span><span class="p">,</span> <span class="n">trace</span><span class="p">(</span><span class="n">function_obj</span><span class="p">))</span>
-</span><span id="1-214">                <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;Enabled tracing for </span><span class="si">%s</span><span class="s2">&quot;</span><span class="p">,</span> <span class="n">function_qualname</span><span class="p">)</span>
+</span><span id="1-192">    <span class="k">def</span> <span class="nf">capture_session</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
+</span><span id="1-193">        <span class="c1"># type: (*Any, **Any) -&gt; None</span>
+</span><span id="1-194">        <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-195">
+</span><span id="1-196">    <span class="k">def</span> <span class="nf">get_integration</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
+</span><span id="1-197">        <span class="c1"># type: (*Any, **Any) -&gt; Any</span>
+</span><span id="1-198">        <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-199">
+</span><span id="1-200">    <span class="k">def</span> <span class="nf">close</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
+</span><span id="1-201">        <span class="c1"># type: (*Any, **Any) -&gt; None</span>
+</span><span id="1-202">        <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-203">
+</span><span id="1-204">    <span class="k">def</span> <span class="nf">flush</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
+</span><span id="1-205">        <span class="c1"># type: (*Any, **Any) -&gt; None</span>
+</span><span id="1-206">        <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-207">
+</span><span id="1-208">    <span class="k">def</span> <span class="fm">__enter__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-209">        <span class="c1"># type: () -&gt; BaseClient</span>
+</span><span id="1-210">        <span class="k">return</span> <span class="bp">self</span>
+</span><span id="1-211">
+</span><span id="1-212">    <span class="k">def</span> <span class="fm">__exit__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">exc_type</span><span class="p">,</span> <span class="n">exc_value</span><span class="p">,</span> <span class="n">tb</span><span class="p">):</span>
+</span><span id="1-213">        <span class="c1"># type: (Any, Any, Any) -&gt; None</span>
+</span><span id="1-214">        <span class="k">return</span> <span class="kc">None</span></div>
+
 </span><span id="1-215">
-</span><span id="1-216">            <span class="k">except</span> <span class="n">module_not_found_error</span><span class="p">:</span>
-</span><span id="1-217">                <span class="k">try</span><span class="p">:</span>
-</span><span id="1-218">                    <span class="c1"># Try to import a class</span>
-</span><span id="1-219">                    <span class="c1"># ex: &quot;mymodule.submodule.MyClassName.member_function&quot;</span>
+</span><span id="1-216">
+<div class="viewcode-block" id="NonRecordingClient">
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.NonRecordingClient">[docs]</a>
+</span><span id="1-217"><span class="k">class</span> <span class="nc">NonRecordingClient</span><span class="p">(</span><span class="n">BaseClient</span><span class="p">):</span>
+</span><span id="1-218"><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-219"><span class="sd">    .. versionadded:: 2.0.0</span>
 </span><span id="1-220">
-</span><span id="1-221">                    <span class="n">module_name</span><span class="p">,</span> <span class="n">class_name</span> <span class="o">=</span> <span class="n">module_name</span><span class="o">.</span><span class="n">rsplit</span><span class="p">(</span><span class="s2">&quot;.&quot;</span><span class="p">,</span> <span class="mi">1</span><span class="p">)</span>
-</span><span id="1-222">                    <span class="n">module_obj</span> <span class="o">=</span> <span class="n">import_module</span><span class="p">(</span><span class="n">module_name</span><span class="p">)</span>
-</span><span id="1-223">                    <span class="n">class_obj</span> <span class="o">=</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">module_obj</span><span class="p">,</span> <span class="n">class_name</span><span class="p">)</span>
-</span><span id="1-224">                    <span class="n">function_obj</span> <span class="o">=</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">class_obj</span><span class="p">,</span> <span class="n">function_name</span><span class="p">)</span>
-</span><span id="1-225">                    <span class="n">function_type</span> <span class="o">=</span> <span class="nb">type</span><span class="p">(</span><span class="n">class_obj</span><span class="o">.</span><span class="vm">__dict__</span><span class="p">[</span><span class="n">function_name</span><span class="p">])</span>
-</span><span id="1-226">                    <span class="n">traced_function</span> <span class="o">=</span> <span class="n">trace</span><span class="p">(</span><span class="n">function_obj</span><span class="p">)</span>
-</span><span id="1-227">
-</span><span id="1-228">                    <span class="k">if</span> <span class="n">function_type</span> <span class="ow">in</span> <span class="p">(</span><span class="nb">staticmethod</span><span class="p">,</span> <span class="nb">classmethod</span><span class="p">):</span>
-</span><span id="1-229">                        <span class="n">traced_function</span> <span class="o">=</span> <span class="nb">staticmethod</span><span class="p">(</span><span class="n">traced_function</span><span class="p">)</span>
-</span><span id="1-230">
-</span><span id="1-231">                    <span class="nb">setattr</span><span class="p">(</span><span class="n">class_obj</span><span class="p">,</span> <span class="n">function_name</span><span class="p">,</span> <span class="n">traced_function</span><span class="p">)</span>
-</span><span id="1-232">                    <span class="nb">setattr</span><span class="p">(</span><span class="n">module_obj</span><span class="p">,</span> <span class="n">class_name</span><span class="p">,</span> <span class="n">class_obj</span><span class="p">)</span>
-</span><span id="1-233">                    <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;Enabled tracing for </span><span class="si">%s</span><span class="s2">&quot;</span><span class="p">,</span> <span class="n">function_qualname</span><span class="p">)</span>
-</span><span id="1-234">
-</span><span id="1-235">                <span class="k">except</span> <span class="ne">Exception</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
-</span><span id="1-236">                    <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
-</span><span id="1-237">                        <span class="s2">&quot;Can not enable tracing for &#39;</span><span class="si">%s</span><span class="s2">&#39;. (</span><span class="si">%s</span><span class="s2">) Please check your `functions_to_trace` parameter.&quot;</span><span class="p">,</span>
-</span><span id="1-238">                        <span class="n">function_qualname</span><span class="p">,</span>
-</span><span id="1-239">                        <span class="n">e</span><span class="p">,</span>
-</span><span id="1-240">                    <span class="p">)</span>
+</span><span id="1-221"><span class="sd">    A client that does not send any events to Sentry. This is used as a fallback when the Sentry SDK is not yet initialized.</span>
+</span><span id="1-222"><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="1-223">
+</span><span id="1-224">    <span class="k">pass</span></div>
+
+</span><span id="1-225">
+</span><span id="1-226">
+<div class="viewcode-block" id="_Client">
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk._Client">[docs]</a>
+</span><span id="1-227"><span class="k">class</span> <span class="nc">_Client</span><span class="p">(</span><span class="n">BaseClient</span><span class="p">):</span>
+</span><span id="1-228"><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-229"><span class="sd">    The client is internally responsible for capturing the events and</span>
+</span><span id="1-230"><span class="sd">    forwarding them to sentry through the configured transport.  It takes</span>
+</span><span id="1-231"><span class="sd">    the client options as keyword arguments and optionally the DSN as first</span>
+</span><span id="1-232"><span class="sd">    argument.</span>
+</span><span id="1-233">
+</span><span id="1-234"><span class="sd">    Alias of :py:class:`sentry_sdk.Client`. (Was created for better intelisense support)</span>
+</span><span id="1-235"><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="1-236">
+</span><span id="1-237">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
+</span><span id="1-238">        <span class="c1"># type: (*Any, **Any) -&gt; None</span>
+</span><span id="1-239">        <span class="nb">super</span><span class="p">(</span><span class="n">_Client</span><span class="p">,</span> <span class="bp">self</span><span class="p">)</span><span class="o">.</span><span class="fm">__init__</span><span class="p">(</span><span class="n">options</span><span class="o">=</span><span class="n">get_options</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">))</span>
+</span><span id="1-240">        <span class="bp">self</span><span class="o">.</span><span class="n">_init_impl</span><span class="p">()</span>
 </span><span id="1-241">
-</span><span id="1-242">            <span class="k">except</span> <span class="ne">Exception</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
-</span><span id="1-243">                <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
-</span><span id="1-244">                    <span class="s2">&quot;Can not enable tracing for &#39;</span><span class="si">%s</span><span class="s2">&#39;. (</span><span class="si">%s</span><span class="s2">) Please check your `functions_to_trace` parameter.&quot;</span><span class="p">,</span>
-</span><span id="1-245">                    <span class="n">function_qualname</span><span class="p">,</span>
-</span><span id="1-246">                    <span class="n">e</span><span class="p">,</span>
-</span><span id="1-247">                <span class="p">)</span>
-</span><span id="1-248">
-</span><span id="1-249">    <span class="k">def</span> <span class="nf">_init_impl</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-250">        <span class="c1"># type: () -&gt; None</span>
-</span><span id="1-251">        <span class="n">old_debug</span> <span class="o">=</span> <span class="n">_client_init_debug</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="kc">False</span><span class="p">)</span>
-</span><span id="1-252">
-</span><span id="1-253">        <span class="k">def</span> <span class="nf">_capture_envelope</span><span class="p">(</span><span class="n">envelope</span><span class="p">):</span>
-</span><span id="1-254">            <span class="c1"># type: (Envelope) -&gt; None</span>
-</span><span id="1-255">            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">transport</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-256">                <span class="bp">self</span><span class="o">.</span><span class="n">transport</span><span class="o">.</span><span class="n">capture_envelope</span><span class="p">(</span><span class="n">envelope</span><span class="p">)</span>
-</span><span id="1-257">
-</span><span id="1-258">        <span class="k">try</span><span class="p">:</span>
-</span><span id="1-259">            <span class="n">_client_init_debug</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;debug&quot;</span><span class="p">])</span>
-</span><span id="1-260">            <span class="bp">self</span><span class="o">.</span><span class="n">transport</span> <span class="o">=</span> <span class="n">make_transport</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">)</span>
-</span><span id="1-261">
-</span><span id="1-262">            <span class="bp">self</span><span class="o">.</span><span class="n">monitor</span> <span class="o">=</span> <span class="kc">None</span>
-</span><span id="1-263">            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">transport</span><span class="p">:</span>
-</span><span id="1-264">                <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;enable_backpressure_handling&quot;</span><span class="p">]:</span>
-</span><span id="1-265">                    <span class="bp">self</span><span class="o">.</span><span class="n">monitor</span> <span class="o">=</span> <span class="n">Monitor</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">transport</span><span class="p">)</span>
-</span><span id="1-266">
-</span><span id="1-267">            <span class="bp">self</span><span class="o">.</span><span class="n">session_flusher</span> <span class="o">=</span> <span class="n">SessionFlusher</span><span class="p">(</span><span class="n">capture_func</span><span class="o">=</span><span class="n">_capture_envelope</span><span class="p">)</span>
-</span><span id="1-268">
-</span><span id="1-269">            <span class="bp">self</span><span class="o">.</span><span class="n">metrics_aggregator</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[MetricsAggregator]</span>
-</span><span id="1-270">            <span class="n">experiments</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;_experiments&quot;</span><span class="p">,</span> <span class="p">{})</span>
-</span><span id="1-271">            <span class="k">if</span> <span class="n">experiments</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;enable_metrics&quot;</span><span class="p">,</span> <span class="kc">True</span><span class="p">):</span>
-</span><span id="1-272">                <span class="c1"># Context vars are not working correctly on Python &lt;=3.6</span>
-</span><span id="1-273">                <span class="c1"># with gevent.</span>
-</span><span id="1-274">                <span class="n">metrics_supported</span> <span class="o">=</span> <span class="ow">not</span> <span class="n">is_gevent</span><span class="p">()</span> <span class="ow">or</span> <span class="n">PY37</span>
-</span><span id="1-275">                <span class="k">if</span> <span class="n">metrics_supported</span><span class="p">:</span>
-</span><span id="1-276">                    <span class="kn">from</span> <span class="nn">sentry_sdk.metrics</span> <span class="kn">import</span> <span class="n">MetricsAggregator</span>
-</span><span id="1-277">
-</span><span id="1-278">                    <span class="bp">self</span><span class="o">.</span><span class="n">metrics_aggregator</span> <span class="o">=</span> <span class="n">MetricsAggregator</span><span class="p">(</span>
-</span><span id="1-279">                        <span class="n">capture_func</span><span class="o">=</span><span class="n">_capture_envelope</span><span class="p">,</span>
-</span><span id="1-280">                        <span class="n">enable_code_locations</span><span class="o">=</span><span class="nb">bool</span><span class="p">(</span>
-</span><span id="1-281">                            <span class="n">experiments</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;metric_code_locations&quot;</span><span class="p">,</span> <span class="kc">True</span><span class="p">)</span>
-</span><span id="1-282">                        <span class="p">),</span>
-</span><span id="1-283">                    <span class="p">)</span>
-</span><span id="1-284">                <span class="k">else</span><span class="p">:</span>
-</span><span id="1-285">                    <span class="n">logger</span><span class="o">.</span><span class="n">info</span><span class="p">(</span>
-</span><span id="1-286">                        <span class="s2">&quot;Metrics not supported on Python 3.6 and lower with gevent.&quot;</span>
-</span><span id="1-287">                    <span class="p">)</span>
+</span><span id="1-242">    <span class="k">def</span> <span class="nf">__getstate__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-243">        <span class="c1"># type: () -&gt; Any</span>
+</span><span id="1-244">        <span class="k">return</span> <span class="p">{</span><span class="s2">&quot;options&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">}</span>
+</span><span id="1-245">
+</span><span id="1-246">    <span class="k">def</span> <span class="nf">__setstate__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">state</span><span class="p">):</span>
+</span><span id="1-247">        <span class="c1"># type: (Any) -&gt; None</span>
+</span><span id="1-248">        <span class="bp">self</span><span class="o">.</span><span class="n">options</span> <span class="o">=</span> <span class="n">state</span><span class="p">[</span><span class="s2">&quot;options&quot;</span><span class="p">]</span>
+</span><span id="1-249">        <span class="bp">self</span><span class="o">.</span><span class="n">_init_impl</span><span class="p">()</span>
+</span><span id="1-250">
+</span><span id="1-251">    <span class="k">def</span> <span class="nf">_setup_instrumentation</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">functions_to_trace</span><span class="p">):</span>
+</span><span id="1-252">        <span class="c1"># type: (Sequence[Dict[str, str]]) -&gt; None</span>
+</span><span id="1-253"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-254"><span class="sd">        Instruments the functions given in the list `functions_to_trace` with the `@sentry_sdk.tracing.trace` decorator.</span>
+</span><span id="1-255"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-256">        <span class="k">for</span> <span class="n">function</span> <span class="ow">in</span> <span class="n">functions_to_trace</span><span class="p">:</span>
+</span><span id="1-257">            <span class="n">class_name</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="1-258">            <span class="n">function_qualname</span> <span class="o">=</span> <span class="n">function</span><span class="p">[</span><span class="s2">&quot;qualified_name&quot;</span><span class="p">]</span>
+</span><span id="1-259">            <span class="n">module_name</span><span class="p">,</span> <span class="n">function_name</span> <span class="o">=</span> <span class="n">function_qualname</span><span class="o">.</span><span class="n">rsplit</span><span class="p">(</span><span class="s2">&quot;.&quot;</span><span class="p">,</span> <span class="mi">1</span><span class="p">)</span>
+</span><span id="1-260">
+</span><span id="1-261">            <span class="k">try</span><span class="p">:</span>
+</span><span id="1-262">                <span class="c1"># Try to import module and function</span>
+</span><span id="1-263">                <span class="c1"># ex: &quot;mymodule.submodule.funcname&quot;</span>
+</span><span id="1-264">
+</span><span id="1-265">                <span class="n">module_obj</span> <span class="o">=</span> <span class="n">import_module</span><span class="p">(</span><span class="n">module_name</span><span class="p">)</span>
+</span><span id="1-266">                <span class="n">function_obj</span> <span class="o">=</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">module_obj</span><span class="p">,</span> <span class="n">function_name</span><span class="p">)</span>
+</span><span id="1-267">                <span class="nb">setattr</span><span class="p">(</span><span class="n">module_obj</span><span class="p">,</span> <span class="n">function_name</span><span class="p">,</span> <span class="n">trace</span><span class="p">(</span><span class="n">function_obj</span><span class="p">))</span>
+</span><span id="1-268">                <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;Enabled tracing for </span><span class="si">%s</span><span class="s2">&quot;</span><span class="p">,</span> <span class="n">function_qualname</span><span class="p">)</span>
+</span><span id="1-269">
+</span><span id="1-270">            <span class="k">except</span> <span class="n">module_not_found_error</span><span class="p">:</span>
+</span><span id="1-271">                <span class="k">try</span><span class="p">:</span>
+</span><span id="1-272">                    <span class="c1"># Try to import a class</span>
+</span><span id="1-273">                    <span class="c1"># ex: &quot;mymodule.submodule.MyClassName.member_function&quot;</span>
+</span><span id="1-274">
+</span><span id="1-275">                    <span class="n">module_name</span><span class="p">,</span> <span class="n">class_name</span> <span class="o">=</span> <span class="n">module_name</span><span class="o">.</span><span class="n">rsplit</span><span class="p">(</span><span class="s2">&quot;.&quot;</span><span class="p">,</span> <span class="mi">1</span><span class="p">)</span>
+</span><span id="1-276">                    <span class="n">module_obj</span> <span class="o">=</span> <span class="n">import_module</span><span class="p">(</span><span class="n">module_name</span><span class="p">)</span>
+</span><span id="1-277">                    <span class="n">class_obj</span> <span class="o">=</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">module_obj</span><span class="p">,</span> <span class="n">class_name</span><span class="p">)</span>
+</span><span id="1-278">                    <span class="n">function_obj</span> <span class="o">=</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">class_obj</span><span class="p">,</span> <span class="n">function_name</span><span class="p">)</span>
+</span><span id="1-279">                    <span class="n">function_type</span> <span class="o">=</span> <span class="nb">type</span><span class="p">(</span><span class="n">class_obj</span><span class="o">.</span><span class="vm">__dict__</span><span class="p">[</span><span class="n">function_name</span><span class="p">])</span>
+</span><span id="1-280">                    <span class="n">traced_function</span> <span class="o">=</span> <span class="n">trace</span><span class="p">(</span><span class="n">function_obj</span><span class="p">)</span>
+</span><span id="1-281">
+</span><span id="1-282">                    <span class="k">if</span> <span class="n">function_type</span> <span class="ow">in</span> <span class="p">(</span><span class="nb">staticmethod</span><span class="p">,</span> <span class="nb">classmethod</span><span class="p">):</span>
+</span><span id="1-283">                        <span class="n">traced_function</span> <span class="o">=</span> <span class="nb">staticmethod</span><span class="p">(</span><span class="n">traced_function</span><span class="p">)</span>
+</span><span id="1-284">
+</span><span id="1-285">                    <span class="nb">setattr</span><span class="p">(</span><span class="n">class_obj</span><span class="p">,</span> <span class="n">function_name</span><span class="p">,</span> <span class="n">traced_function</span><span class="p">)</span>
+</span><span id="1-286">                    <span class="nb">setattr</span><span class="p">(</span><span class="n">module_obj</span><span class="p">,</span> <span class="n">class_name</span><span class="p">,</span> <span class="n">class_obj</span><span class="p">)</span>
+</span><span id="1-287">                    <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;Enabled tracing for </span><span class="si">%s</span><span class="s2">&quot;</span><span class="p">,</span> <span class="n">function_qualname</span><span class="p">)</span>
 </span><span id="1-288">
-</span><span id="1-289">            <span class="n">max_request_body_size</span> <span class="o">=</span> <span class="p">(</span><span class="s2">&quot;always&quot;</span><span class="p">,</span> <span class="s2">&quot;never&quot;</span><span class="p">,</span> <span class="s2">&quot;small&quot;</span><span class="p">,</span> <span class="s2">&quot;medium&quot;</span><span class="p">)</span>
-</span><span id="1-290">            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;max_request_body_size&quot;</span><span class="p">]</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">max_request_body_size</span><span class="p">:</span>
-</span><span id="1-291">                <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-</span><span id="1-292">                    <span class="s2">&quot;Invalid value for max_request_body_size. Must be one of </span><span class="si">{}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span>
-</span><span id="1-293">                        <span class="n">max_request_body_size</span>
+</span><span id="1-289">                <span class="k">except</span> <span class="ne">Exception</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
+</span><span id="1-290">                    <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
+</span><span id="1-291">                        <span class="s2">&quot;Can not enable tracing for &#39;</span><span class="si">%s</span><span class="s2">&#39;. (</span><span class="si">%s</span><span class="s2">) Please check your `functions_to_trace` parameter.&quot;</span><span class="p">,</span>
+</span><span id="1-292">                        <span class="n">function_qualname</span><span class="p">,</span>
+</span><span id="1-293">                        <span class="n">e</span><span class="p">,</span>
 </span><span id="1-294">                    <span class="p">)</span>
-</span><span id="1-295">                <span class="p">)</span>
-</span><span id="1-296">
-</span><span id="1-297">            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;_experiments&quot;</span><span class="p">]</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;otel_powered_performance&quot;</span><span class="p">,</span> <span class="kc">False</span><span class="p">):</span>
-</span><span id="1-298">                <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span>
-</span><span id="1-299">                    <span class="s2">&quot;[OTel] Enabling experimental OTel-powered performance monitoring.&quot;</span>
-</span><span id="1-300">                <span class="p">)</span>
-</span><span id="1-301">                <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;instrumenter&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">INSTRUMENTER</span><span class="o">.</span><span class="n">OTEL</span>
-</span><span id="1-302">                <span class="n">_DEFAULT_INTEGRATIONS</span><span class="o">.</span><span class="n">append</span><span class="p">(</span>
-</span><span id="1-303">                    <span class="s2">&quot;sentry_sdk.integrations.opentelemetry.integration.OpenTelemetryIntegration&quot;</span><span class="p">,</span>
-</span><span id="1-304">                <span class="p">)</span>
-</span><span id="1-305">
-</span><span id="1-306">            <span class="bp">self</span><span class="o">.</span><span class="n">integrations</span> <span class="o">=</span> <span class="n">setup_integrations</span><span class="p">(</span>
-</span><span id="1-307">                <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;integrations&quot;</span><span class="p">],</span>
-</span><span id="1-308">                <span class="n">with_defaults</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;default_integrations&quot;</span><span class="p">],</span>
-</span><span id="1-309">                <span class="n">with_auto_enabling_integrations</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span>
-</span><span id="1-310">                    <span class="s2">&quot;auto_enabling_integrations&quot;</span>
-</span><span id="1-311">                <span class="p">],</span>
-</span><span id="1-312">            <span class="p">)</span>
-</span><span id="1-313">
-</span><span id="1-314">            <span class="bp">self</span><span class="o">.</span><span class="n">spotlight</span> <span class="o">=</span> <span class="kc">None</span>
-</span><span id="1-315">            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;spotlight&quot;</span><span class="p">):</span>
-</span><span id="1-316">                <span class="bp">self</span><span class="o">.</span><span class="n">spotlight</span> <span class="o">=</span> <span class="n">setup_spotlight</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">)</span>
-</span><span id="1-317">
-</span><span id="1-318">            <span class="n">sdk_name</span> <span class="o">=</span> <span class="n">get_sdk_name</span><span class="p">(</span><span class="nb">list</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">integrations</span><span class="o">.</span><span class="n">keys</span><span class="p">()))</span>
-</span><span id="1-319">            <span class="n">SDK_INFO</span><span class="p">[</span><span class="s2">&quot;name&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">sdk_name</span>
-</span><span id="1-320">            <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;Setting SDK name to &#39;</span><span class="si">%s</span><span class="s2">&#39;&quot;</span><span class="p">,</span> <span class="n">sdk_name</span><span class="p">)</span>
-</span><span id="1-321">
-</span><span id="1-322">            <span class="k">if</span> <span class="n">has_profiling_enabled</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">):</span>
-</span><span id="1-323">                <span class="k">try</span><span class="p">:</span>
-</span><span id="1-324">                    <span class="n">setup_profiler</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">)</span>
-</span><span id="1-325">                <span class="k">except</span> <span class="ne">Exception</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
-</span><span id="1-326">                    <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;Can not set up profiler. (</span><span class="si">%s</span><span class="s2">)&quot;</span><span class="p">,</span> <span class="n">e</span><span class="p">)</span>
-</span><span id="1-327">
-</span><span id="1-328">        <span class="k">finally</span><span class="p">:</span>
-</span><span id="1-329">            <span class="n">_client_init_debug</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="n">old_debug</span><span class="p">)</span>
-</span><span id="1-330">
-</span><span id="1-331">        <span class="bp">self</span><span class="o">.</span><span class="n">_setup_instrumentation</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;functions_to_trace&quot;</span><span class="p">,</span> <span class="p">[]))</span>
-</span><span id="1-332">
-</span><span id="1-333">        <span class="k">if</span> <span class="p">(</span>
-</span><span id="1-334">            <span class="bp">self</span><span class="o">.</span><span class="n">monitor</span>
-</span><span id="1-335">            <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">metrics_aggregator</span>
-</span><span id="1-336">            <span class="ow">or</span> <span class="n">has_profiling_enabled</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">)</span>
-</span><span id="1-337">            <span class="ow">or</span> <span class="nb">isinstance</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">transport</span><span class="p">,</span> <span class="n">HttpTransport</span><span class="p">)</span>
-</span><span id="1-338">        <span class="p">):</span>
-</span><span id="1-339">            <span class="c1"># If we have anything on that could spawn a background thread, we</span>
-</span><span id="1-340">            <span class="c1"># need to check if it&#39;s safe to use them.</span>
-</span><span id="1-341">            <span class="n">check_uwsgi_thread_support</span><span class="p">()</span>
+</span><span id="1-295">
+</span><span id="1-296">            <span class="k">except</span> <span class="ne">Exception</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
+</span><span id="1-297">                <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
+</span><span id="1-298">                    <span class="s2">&quot;Can not enable tracing for &#39;</span><span class="si">%s</span><span class="s2">&#39;. (</span><span class="si">%s</span><span class="s2">) Please check your `functions_to_trace` parameter.&quot;</span><span class="p">,</span>
+</span><span id="1-299">                    <span class="n">function_qualname</span><span class="p">,</span>
+</span><span id="1-300">                    <span class="n">e</span><span class="p">,</span>
+</span><span id="1-301">                <span class="p">)</span>
+</span><span id="1-302">
+</span><span id="1-303">    <span class="k">def</span> <span class="nf">_init_impl</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-304">        <span class="c1"># type: () -&gt; None</span>
+</span><span id="1-305">        <span class="n">old_debug</span> <span class="o">=</span> <span class="n">_client_init_debug</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="kc">False</span><span class="p">)</span>
+</span><span id="1-306">
+</span><span id="1-307">        <span class="k">def</span> <span class="nf">_capture_envelope</span><span class="p">(</span><span class="n">envelope</span><span class="p">):</span>
+</span><span id="1-308">            <span class="c1"># type: (Envelope) -&gt; None</span>
+</span><span id="1-309">            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">transport</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-310">                <span class="bp">self</span><span class="o">.</span><span class="n">transport</span><span class="o">.</span><span class="n">capture_envelope</span><span class="p">(</span><span class="n">envelope</span><span class="p">)</span>
+</span><span id="1-311">
+</span><span id="1-312">        <span class="k">try</span><span class="p">:</span>
+</span><span id="1-313">            <span class="n">_client_init_debug</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;debug&quot;</span><span class="p">])</span>
+</span><span id="1-314">            <span class="bp">self</span><span class="o">.</span><span class="n">transport</span> <span class="o">=</span> <span class="n">make_transport</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">)</span>
+</span><span id="1-315">
+</span><span id="1-316">            <span class="bp">self</span><span class="o">.</span><span class="n">monitor</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="1-317">            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">transport</span><span class="p">:</span>
+</span><span id="1-318">                <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;enable_backpressure_handling&quot;</span><span class="p">]:</span>
+</span><span id="1-319">                    <span class="bp">self</span><span class="o">.</span><span class="n">monitor</span> <span class="o">=</span> <span class="n">Monitor</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">transport</span><span class="p">)</span>
+</span><span id="1-320">
+</span><span id="1-321">            <span class="bp">self</span><span class="o">.</span><span class="n">session_flusher</span> <span class="o">=</span> <span class="n">SessionFlusher</span><span class="p">(</span><span class="n">capture_func</span><span class="o">=</span><span class="n">_capture_envelope</span><span class="p">)</span>
+</span><span id="1-322">
+</span><span id="1-323">            <span class="bp">self</span><span class="o">.</span><span class="n">metrics_aggregator</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[MetricsAggregator]</span>
+</span><span id="1-324">            <span class="n">experiments</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;_experiments&quot;</span><span class="p">,</span> <span class="p">{})</span>
+</span><span id="1-325">            <span class="k">if</span> <span class="n">experiments</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;enable_metrics&quot;</span><span class="p">,</span> <span class="kc">True</span><span class="p">):</span>
+</span><span id="1-326">                <span class="c1"># Context vars are not working correctly on Python &lt;=3.6</span>
+</span><span id="1-327">                <span class="c1"># with gevent.</span>
+</span><span id="1-328">                <span class="n">metrics_supported</span> <span class="o">=</span> <span class="ow">not</span> <span class="n">is_gevent</span><span class="p">()</span> <span class="ow">or</span> <span class="n">PY37</span>
+</span><span id="1-329">                <span class="k">if</span> <span class="n">metrics_supported</span><span class="p">:</span>
+</span><span id="1-330">                    <span class="kn">from</span> <span class="nn">sentry_sdk.metrics</span> <span class="kn">import</span> <span class="n">MetricsAggregator</span>
+</span><span id="1-331">
+</span><span id="1-332">                    <span class="bp">self</span><span class="o">.</span><span class="n">metrics_aggregator</span> <span class="o">=</span> <span class="n">MetricsAggregator</span><span class="p">(</span>
+</span><span id="1-333">                        <span class="n">capture_func</span><span class="o">=</span><span class="n">_capture_envelope</span><span class="p">,</span>
+</span><span id="1-334">                        <span class="n">enable_code_locations</span><span class="o">=</span><span class="nb">bool</span><span class="p">(</span>
+</span><span id="1-335">                            <span class="n">experiments</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;metric_code_locations&quot;</span><span class="p">,</span> <span class="kc">True</span><span class="p">)</span>
+</span><span id="1-336">                        <span class="p">),</span>
+</span><span id="1-337">                    <span class="p">)</span>
+</span><span id="1-338">                <span class="k">else</span><span class="p">:</span>
+</span><span id="1-339">                    <span class="n">logger</span><span class="o">.</span><span class="n">info</span><span class="p">(</span>
+</span><span id="1-340">                        <span class="s2">&quot;Metrics not supported on Python 3.6 and lower with gevent.&quot;</span>
+</span><span id="1-341">                    <span class="p">)</span>
 </span><span id="1-342">
-</span><span id="1-343">    <span class="nd">@property</span>
-</span><span id="1-344">    <span class="k">def</span> <span class="nf">dsn</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-345">        <span class="c1"># type: () -&gt; Optional[str]</span>
-</span><span id="1-346"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Returns the configured DSN as string.&quot;&quot;&quot;</span>
-</span><span id="1-347">        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;dsn&quot;</span><span class="p">]</span>
-</span><span id="1-348">
-</span><span id="1-349">    <span class="k">def</span> <span class="nf">_prepare_event</span><span class="p">(</span>
-</span><span id="1-350">        <span class="bp">self</span><span class="p">,</span>
-</span><span id="1-351">        <span class="n">event</span><span class="p">,</span>  <span class="c1"># type: Event</span>
-</span><span id="1-352">        <span class="n">hint</span><span class="p">,</span>  <span class="c1"># type: Hint</span>
-</span><span id="1-353">        <span class="n">scope</span><span class="p">,</span>  <span class="c1"># type: Optional[Scope]</span>
-</span><span id="1-354">    <span class="p">):</span>
-</span><span id="1-355">        <span class="c1"># type: (...) -&gt; Optional[Event]</span>
-</span><span id="1-356">
-</span><span id="1-357">        <span class="k">if</span> <span class="n">event</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;timestamp&quot;</span><span class="p">)</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-358">            <span class="n">event</span><span class="p">[</span><span class="s2">&quot;timestamp&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">datetime_utcnow</span><span class="p">()</span>
+</span><span id="1-343">            <span class="n">max_request_body_size</span> <span class="o">=</span> <span class="p">(</span><span class="s2">&quot;always&quot;</span><span class="p">,</span> <span class="s2">&quot;never&quot;</span><span class="p">,</span> <span class="s2">&quot;small&quot;</span><span class="p">,</span> <span class="s2">&quot;medium&quot;</span><span class="p">)</span>
+</span><span id="1-344">            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;max_request_body_size&quot;</span><span class="p">]</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">max_request_body_size</span><span class="p">:</span>
+</span><span id="1-345">                <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
+</span><span id="1-346">                    <span class="s2">&quot;Invalid value for max_request_body_size. Must be one of </span><span class="si">{}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span>
+</span><span id="1-347">                        <span class="n">max_request_body_size</span>
+</span><span id="1-348">                    <span class="p">)</span>
+</span><span id="1-349">                <span class="p">)</span>
+</span><span id="1-350">
+</span><span id="1-351">            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;_experiments&quot;</span><span class="p">]</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;otel_powered_performance&quot;</span><span class="p">,</span> <span class="kc">False</span><span class="p">):</span>
+</span><span id="1-352">                <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span>
+</span><span id="1-353">                    <span class="s2">&quot;[OTel] Enabling experimental OTel-powered performance monitoring.&quot;</span>
+</span><span id="1-354">                <span class="p">)</span>
+</span><span id="1-355">                <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;instrumenter&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">INSTRUMENTER</span><span class="o">.</span><span class="n">OTEL</span>
+</span><span id="1-356">                <span class="n">_DEFAULT_INTEGRATIONS</span><span class="o">.</span><span class="n">append</span><span class="p">(</span>
+</span><span id="1-357">                    <span class="s2">&quot;sentry_sdk.integrations.opentelemetry.integration.OpenTelemetryIntegration&quot;</span><span class="p">,</span>
+</span><span id="1-358">                <span class="p">)</span>
 </span><span id="1-359">
-</span><span id="1-360">        <span class="k">if</span> <span class="n">scope</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-361">            <span class="n">is_transaction</span> <span class="o">=</span> <span class="n">event</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;type&quot;</span><span class="p">)</span> <span class="o">==</span> <span class="s2">&quot;transaction&quot;</span>
-</span><span id="1-362">            <span class="n">event_</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">apply_to_event</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">)</span>
-</span><span id="1-363">
-</span><span id="1-364">            <span class="c1"># one of the event/error processors returned None</span>
-</span><span id="1-365">            <span class="k">if</span> <span class="n">event_</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-366">                <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">transport</span><span class="p">:</span>
-</span><span id="1-367">                    <span class="bp">self</span><span class="o">.</span><span class="n">transport</span><span class="o">.</span><span class="n">record_lost_event</span><span class="p">(</span>
-</span><span id="1-368">                        <span class="s2">&quot;event_processor&quot;</span><span class="p">,</span>
-</span><span id="1-369">                        <span class="n">data_category</span><span class="o">=</span><span class="p">(</span><span class="s2">&quot;transaction&quot;</span> <span class="k">if</span> <span class="n">is_transaction</span> <span class="k">else</span> <span class="s2">&quot;error&quot;</span><span class="p">),</span>
-</span><span id="1-370">                    <span class="p">)</span>
-</span><span id="1-371">                <span class="k">return</span> <span class="kc">None</span>
-</span><span id="1-372">
-</span><span id="1-373">            <span class="n">event</span> <span class="o">=</span> <span class="n">event_</span>
-</span><span id="1-374">
-</span><span id="1-375">        <span class="k">if</span> <span class="p">(</span>
-</span><span id="1-376">            <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;attach_stacktrace&quot;</span><span class="p">]</span>
-</span><span id="1-377">            <span class="ow">and</span> <span class="s2">&quot;exception&quot;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">event</span>
-</span><span id="1-378">            <span class="ow">and</span> <span class="s2">&quot;stacktrace&quot;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">event</span>
-</span><span id="1-379">            <span class="ow">and</span> <span class="s2">&quot;threads&quot;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">event</span>
-</span><span id="1-380">        <span class="p">):</span>
-</span><span id="1-381">            <span class="k">with</span> <span class="n">capture_internal_exceptions</span><span class="p">():</span>
-</span><span id="1-382">                <span class="n">event</span><span class="p">[</span><span class="s2">&quot;threads&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="p">{</span>
-</span><span id="1-383">                    <span class="s2">&quot;values&quot;</span><span class="p">:</span> <span class="p">[</span>
-</span><span id="1-384">                        <span class="p">{</span>
-</span><span id="1-385">                            <span class="s2">&quot;stacktrace&quot;</span><span class="p">:</span> <span class="n">current_stacktrace</span><span class="p">(</span>
-</span><span id="1-386">                                <span class="n">include_local_variables</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span>
-</span><span id="1-387">                                    <span class="s2">&quot;include_local_variables&quot;</span><span class="p">,</span> <span class="kc">True</span>
-</span><span id="1-388">                                <span class="p">),</span>
-</span><span id="1-389">                                <span class="n">max_value_length</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span>
-</span><span id="1-390">                                    <span class="s2">&quot;max_value_length&quot;</span><span class="p">,</span> <span class="n">DEFAULT_MAX_VALUE_LENGTH</span>
-</span><span id="1-391">                                <span class="p">),</span>
-</span><span id="1-392">                            <span class="p">),</span>
-</span><span id="1-393">                            <span class="s2">&quot;crashed&quot;</span><span class="p">:</span> <span class="kc">False</span><span class="p">,</span>
-</span><span id="1-394">                            <span class="s2">&quot;current&quot;</span><span class="p">:</span> <span class="kc">True</span><span class="p">,</span>
-</span><span id="1-395">                        <span class="p">}</span>
-</span><span id="1-396">                    <span class="p">]</span>
-</span><span id="1-397">                <span class="p">}</span>
-</span><span id="1-398">
-</span><span id="1-399">        <span class="k">for</span> <span class="n">key</span> <span class="ow">in</span> <span class="s2">&quot;release&quot;</span><span class="p">,</span> <span class="s2">&quot;environment&quot;</span><span class="p">,</span> <span class="s2">&quot;server_name&quot;</span><span class="p">,</span> <span class="s2">&quot;dist&quot;</span><span class="p">:</span>
-</span><span id="1-400">            <span class="k">if</span> <span class="n">event</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">key</span><span class="p">)</span> <span class="ow">is</span> <span class="kc">None</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-401">                <span class="n">event</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="o">=</span> <span class="n">text_type</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="n">key</span><span class="p">])</span><span class="o">.</span><span class="n">strip</span><span class="p">()</span>  <span class="c1"># type: ignore[literal-required]</span>
-</span><span id="1-402">        <span class="k">if</span> <span class="n">event</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;sdk&quot;</span><span class="p">)</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-403">            <span class="n">sdk_info</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="n">SDK_INFO</span><span class="p">)</span>
-</span><span id="1-404">            <span class="n">sdk_info</span><span class="p">[</span><span class="s2">&quot;integrations&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="nb">sorted</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">integrations</span><span class="o">.</span><span class="n">keys</span><span class="p">())</span>
-</span><span id="1-405">            <span class="n">event</span><span class="p">[</span><span class="s2">&quot;sdk&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">sdk_info</span>
-</span><span id="1-406">
-</span><span id="1-407">        <span class="k">if</span> <span class="n">event</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;platform&quot;</span><span class="p">)</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-408">            <span class="n">event</span><span class="p">[</span><span class="s2">&quot;platform&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="s2">&quot;python&quot;</span>
-</span><span id="1-409">
-</span><span id="1-410">        <span class="n">event</span> <span class="o">=</span> <span class="n">handle_in_app</span><span class="p">(</span>
-</span><span id="1-411">            <span class="n">event</span><span class="p">,</span>
-</span><span id="1-412">            <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;in_app_exclude&quot;</span><span class="p">],</span>
-</span><span id="1-413">            <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;in_app_include&quot;</span><span class="p">],</span>
-</span><span id="1-414">            <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;project_root&quot;</span><span class="p">],</span>
-</span><span id="1-415">        <span class="p">)</span>
-</span><span id="1-416">
-</span><span id="1-417">        <span class="k">if</span> <span class="n">event</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-418">            <span class="n">event_scrubber</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;event_scrubber&quot;</span><span class="p">]</span>
-</span><span id="1-419">            <span class="k">if</span> <span class="n">event_scrubber</span> <span class="ow">and</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;send_default_pii&quot;</span><span class="p">]:</span>
-</span><span id="1-420">                <span class="n">event_scrubber</span><span class="o">.</span><span class="n">scrub_event</span><span class="p">(</span><span class="n">event</span><span class="p">)</span>
-</span><span id="1-421">
-</span><span id="1-422">        <span class="c1"># Postprocess the event here so that annotated types do</span>
-</span><span id="1-423">        <span class="c1"># generally not surface in before_send</span>
-</span><span id="1-424">        <span class="k">if</span> <span class="n">event</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-425">            <span class="n">event</span> <span class="o">=</span> <span class="n">serialize</span><span class="p">(</span>
-</span><span id="1-426">                <span class="n">event</span><span class="p">,</span>
-</span><span id="1-427">                <span class="n">max_request_body_size</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;max_request_body_size&quot;</span><span class="p">),</span>
-</span><span id="1-428">                <span class="n">max_value_length</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;max_value_length&quot;</span><span class="p">),</span>
-</span><span id="1-429">            <span class="p">)</span>
-</span><span id="1-430">
-</span><span id="1-431">        <span class="n">before_send</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;before_send&quot;</span><span class="p">]</span>
-</span><span id="1-432">        <span class="k">if</span> <span class="p">(</span>
-</span><span id="1-433">            <span class="n">before_send</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span>
-</span><span id="1-434">            <span class="ow">and</span> <span class="n">event</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span>
-</span><span id="1-435">            <span class="ow">and</span> <span class="n">event</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;type&quot;</span><span class="p">)</span> <span class="o">!=</span> <span class="s2">&quot;transaction&quot;</span>
-</span><span id="1-436">        <span class="p">):</span>
-</span><span id="1-437">            <span class="n">new_event</span> <span class="o">=</span> <span class="kc">None</span>
-</span><span id="1-438">            <span class="k">with</span> <span class="n">capture_internal_exceptions</span><span class="p">():</span>
-</span><span id="1-439">                <span class="n">new_event</span> <span class="o">=</span> <span class="n">before_send</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span> <span class="ow">or</span> <span class="p">{})</span>
-</span><span id="1-440">            <span class="k">if</span> <span class="n">new_event</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-441">                <span class="n">logger</span><span class="o">.</span><span class="n">info</span><span class="p">(</span><span class="s2">&quot;before send dropped event&quot;</span><span class="p">)</span>
-</span><span id="1-442">                <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">transport</span><span class="p">:</span>
-</span><span id="1-443">                    <span class="bp">self</span><span class="o">.</span><span class="n">transport</span><span class="o">.</span><span class="n">record_lost_event</span><span class="p">(</span>
-</span><span id="1-444">                        <span class="s2">&quot;before_send&quot;</span><span class="p">,</span> <span class="n">data_category</span><span class="o">=</span><span class="s2">&quot;error&quot;</span>
-</span><span id="1-445">                    <span class="p">)</span>
-</span><span id="1-446">            <span class="n">event</span> <span class="o">=</span> <span class="n">new_event</span>  <span class="c1"># type: ignore</span>
-</span><span id="1-447">
-</span><span id="1-448">        <span class="n">before_send_transaction</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;before_send_transaction&quot;</span><span class="p">]</span>
-</span><span id="1-449">        <span class="k">if</span> <span class="p">(</span>
-</span><span id="1-450">            <span class="n">before_send_transaction</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span>
-</span><span id="1-451">            <span class="ow">and</span> <span class="n">event</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span>
-</span><span id="1-452">            <span class="ow">and</span> <span class="n">event</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;type&quot;</span><span class="p">)</span> <span class="o">==</span> <span class="s2">&quot;transaction&quot;</span>
-</span><span id="1-453">        <span class="p">):</span>
-</span><span id="1-454">            <span class="n">new_event</span> <span class="o">=</span> <span class="kc">None</span>
-</span><span id="1-455">            <span class="k">with</span> <span class="n">capture_internal_exceptions</span><span class="p">():</span>
-</span><span id="1-456">                <span class="n">new_event</span> <span class="o">=</span> <span class="n">before_send_transaction</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span> <span class="ow">or</span> <span class="p">{})</span>
-</span><span id="1-457">            <span class="k">if</span> <span class="n">new_event</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-458">                <span class="n">logger</span><span class="o">.</span><span class="n">info</span><span class="p">(</span><span class="s2">&quot;before send transaction dropped event&quot;</span><span class="p">)</span>
-</span><span id="1-459">                <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">transport</span><span class="p">:</span>
-</span><span id="1-460">                    <span class="bp">self</span><span class="o">.</span><span class="n">transport</span><span class="o">.</span><span class="n">record_lost_event</span><span class="p">(</span>
-</span><span id="1-461">                        <span class="s2">&quot;before_send&quot;</span><span class="p">,</span> <span class="n">data_category</span><span class="o">=</span><span class="s2">&quot;transaction&quot;</span>
-</span><span id="1-462">                    <span class="p">)</span>
-</span><span id="1-463">            <span class="n">event</span> <span class="o">=</span> <span class="n">new_event</span>  <span class="c1"># type: ignore</span>
-</span><span id="1-464">
-</span><span id="1-465">        <span class="k">return</span> <span class="n">event</span>
-</span><span id="1-466">
-</span><span id="1-467">    <span class="k">def</span> <span class="nf">_is_ignored_error</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">):</span>
-</span><span id="1-468">        <span class="c1"># type: (Event, Hint) -&gt; bool</span>
-</span><span id="1-469">        <span class="n">exc_info</span> <span class="o">=</span> <span class="n">hint</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;exc_info&quot;</span><span class="p">)</span>
-</span><span id="1-470">        <span class="k">if</span> <span class="n">exc_info</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-471">            <span class="k">return</span> <span class="kc">False</span>
-</span><span id="1-472">
-</span><span id="1-473">        <span class="n">error</span> <span class="o">=</span> <span class="n">exc_info</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span>
-</span><span id="1-474">        <span class="n">error_type_name</span> <span class="o">=</span> <span class="n">get_type_name</span><span class="p">(</span><span class="n">exc_info</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
-</span><span id="1-475">        <span class="n">error_full_name</span> <span class="o">=</span> <span class="s2">&quot;</span><span class="si">%s</span><span class="s2">.</span><span class="si">%s</span><span class="s2">&quot;</span> <span class="o">%</span> <span class="p">(</span><span class="n">exc_info</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="vm">__module__</span><span class="p">,</span> <span class="n">error_type_name</span><span class="p">)</span>
-</span><span id="1-476">
-</span><span id="1-477">        <span class="k">for</span> <span class="n">ignored_error</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;ignore_errors&quot;</span><span class="p">]:</span>
-</span><span id="1-478">            <span class="c1"># String types are matched against the type name in the</span>
-</span><span id="1-479">            <span class="c1"># exception only</span>
-</span><span id="1-480">            <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">ignored_error</span><span class="p">,</span> <span class="n">string_types</span><span class="p">):</span>
-</span><span id="1-481">                <span class="k">if</span> <span class="n">ignored_error</span> <span class="o">==</span> <span class="n">error_full_name</span> <span class="ow">or</span> <span class="n">ignored_error</span> <span class="o">==</span> <span class="n">error_type_name</span><span class="p">:</span>
-</span><span id="1-482">                    <span class="k">return</span> <span class="kc">True</span>
-</span><span id="1-483">            <span class="k">else</span><span class="p">:</span>
-</span><span id="1-484">                <span class="k">if</span> <span class="nb">issubclass</span><span class="p">(</span><span class="n">error</span><span class="p">,</span> <span class="n">ignored_error</span><span class="p">):</span>
-</span><span id="1-485">                    <span class="k">return</span> <span class="kc">True</span>
-</span><span id="1-486">
-</span><span id="1-487">        <span class="k">return</span> <span class="kc">False</span>
+</span><span id="1-360">            <span class="bp">self</span><span class="o">.</span><span class="n">integrations</span> <span class="o">=</span> <span class="n">setup_integrations</span><span class="p">(</span>
+</span><span id="1-361">                <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;integrations&quot;</span><span class="p">],</span>
+</span><span id="1-362">                <span class="n">with_defaults</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;default_integrations&quot;</span><span class="p">],</span>
+</span><span id="1-363">                <span class="n">with_auto_enabling_integrations</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span>
+</span><span id="1-364">                    <span class="s2">&quot;auto_enabling_integrations&quot;</span>
+</span><span id="1-365">                <span class="p">],</span>
+</span><span id="1-366">            <span class="p">)</span>
+</span><span id="1-367">
+</span><span id="1-368">            <span class="bp">self</span><span class="o">.</span><span class="n">spotlight</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="1-369">            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;spotlight&quot;</span><span class="p">):</span>
+</span><span id="1-370">                <span class="bp">self</span><span class="o">.</span><span class="n">spotlight</span> <span class="o">=</span> <span class="n">setup_spotlight</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">)</span>
+</span><span id="1-371">
+</span><span id="1-372">            <span class="n">sdk_name</span> <span class="o">=</span> <span class="n">get_sdk_name</span><span class="p">(</span><span class="nb">list</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">integrations</span><span class="o">.</span><span class="n">keys</span><span class="p">()))</span>
+</span><span id="1-373">            <span class="n">SDK_INFO</span><span class="p">[</span><span class="s2">&quot;name&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">sdk_name</span>
+</span><span id="1-374">            <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;Setting SDK name to &#39;</span><span class="si">%s</span><span class="s2">&#39;&quot;</span><span class="p">,</span> <span class="n">sdk_name</span><span class="p">)</span>
+</span><span id="1-375">
+</span><span id="1-376">            <span class="k">if</span> <span class="n">has_profiling_enabled</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">):</span>
+</span><span id="1-377">                <span class="k">try</span><span class="p">:</span>
+</span><span id="1-378">                    <span class="n">setup_profiler</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">)</span>
+</span><span id="1-379">                <span class="k">except</span> <span class="ne">Exception</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
+</span><span id="1-380">                    <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;Can not set up profiler. (</span><span class="si">%s</span><span class="s2">)&quot;</span><span class="p">,</span> <span class="n">e</span><span class="p">)</span>
+</span><span id="1-381">
+</span><span id="1-382">        <span class="k">finally</span><span class="p">:</span>
+</span><span id="1-383">            <span class="n">_client_init_debug</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="n">old_debug</span><span class="p">)</span>
+</span><span id="1-384">
+</span><span id="1-385">        <span class="bp">self</span><span class="o">.</span><span class="n">_setup_instrumentation</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;functions_to_trace&quot;</span><span class="p">,</span> <span class="p">[]))</span>
+</span><span id="1-386">
+</span><span id="1-387">        <span class="k">if</span> <span class="p">(</span>
+</span><span id="1-388">            <span class="bp">self</span><span class="o">.</span><span class="n">monitor</span>
+</span><span id="1-389">            <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">metrics_aggregator</span>
+</span><span id="1-390">            <span class="ow">or</span> <span class="n">has_profiling_enabled</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">)</span>
+</span><span id="1-391">            <span class="ow">or</span> <span class="nb">isinstance</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">transport</span><span class="p">,</span> <span class="n">HttpTransport</span><span class="p">)</span>
+</span><span id="1-392">        <span class="p">):</span>
+</span><span id="1-393">            <span class="c1"># If we have anything on that could spawn a background thread, we</span>
+</span><span id="1-394">            <span class="c1"># need to check if it&#39;s safe to use them.</span>
+</span><span id="1-395">            <span class="n">check_uwsgi_thread_support</span><span class="p">()</span>
+</span><span id="1-396">
+<div class="viewcode-block" id="_Client.is_active">
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk._Client.is_active">[docs]</a>
+</span><span id="1-397">    <span class="k">def</span> <span class="nf">is_active</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-398">        <span class="c1"># type: () -&gt; bool</span>
+</span><span id="1-399"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-400"><span class="sd">        .. versionadded:: 2.0.0</span>
+</span><span id="1-401">
+</span><span id="1-402"><span class="sd">        Returns whether the client is active (able to send data to Sentry)</span>
+</span><span id="1-403"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-404">        <span class="k">return</span> <span class="kc">True</span></div>
+
+</span><span id="1-405">
+<div class="viewcode-block" id="_Client.should_send_default_pii">
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk._Client.should_send_default_pii">[docs]</a>
+</span><span id="1-406">    <span class="k">def</span> <span class="nf">should_send_default_pii</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-407">        <span class="c1"># type: () -&gt; bool</span>
+</span><span id="1-408"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-409"><span class="sd">        .. versionadded:: 2.0.0</span>
+</span><span id="1-410">
+</span><span id="1-411"><span class="sd">        Returns whether the client should send default PII (Personally Identifiable Information) data to Sentry.</span>
+</span><span id="1-412"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-413">        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;send_default_pii&quot;</span><span class="p">,</span> <span class="kc">False</span><span class="p">)</span></div>
+
+</span><span id="1-414">
+</span><span id="1-415">    <span class="nd">@property</span>
+</span><span id="1-416">    <span class="k">def</span> <span class="nf">dsn</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-417">        <span class="c1"># type: () -&gt; Optional[str]</span>
+</span><span id="1-418"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Returns the configured DSN as string.&quot;&quot;&quot;</span>
+</span><span id="1-419">        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;dsn&quot;</span><span class="p">]</span>
+</span><span id="1-420">
+</span><span id="1-421">    <span class="k">def</span> <span class="nf">_prepare_event</span><span class="p">(</span>
+</span><span id="1-422">        <span class="bp">self</span><span class="p">,</span>
+</span><span id="1-423">        <span class="n">event</span><span class="p">,</span>  <span class="c1"># type: Event</span>
+</span><span id="1-424">        <span class="n">hint</span><span class="p">,</span>  <span class="c1"># type: Hint</span>
+</span><span id="1-425">        <span class="n">scope</span><span class="p">,</span>  <span class="c1"># type: Optional[Scope]</span>
+</span><span id="1-426">    <span class="p">):</span>
+</span><span id="1-427">        <span class="c1"># type: (...) -&gt; Optional[Event]</span>
+</span><span id="1-428">
+</span><span id="1-429">        <span class="k">if</span> <span class="n">event</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;timestamp&quot;</span><span class="p">)</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-430">            <span class="n">event</span><span class="p">[</span><span class="s2">&quot;timestamp&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">datetime</span><span class="o">.</span><span class="n">now</span><span class="p">(</span><span class="n">timezone</span><span class="o">.</span><span class="n">utc</span><span class="p">)</span>
+</span><span id="1-431">
+</span><span id="1-432">        <span class="k">if</span> <span class="n">scope</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-433">            <span class="n">is_transaction</span> <span class="o">=</span> <span class="n">event</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;type&quot;</span><span class="p">)</span> <span class="o">==</span> <span class="s2">&quot;transaction&quot;</span>
+</span><span id="1-434">            <span class="n">event_</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">apply_to_event</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">)</span>
+</span><span id="1-435">
+</span><span id="1-436">            <span class="c1"># one of the event/error processors returned None</span>
+</span><span id="1-437">            <span class="k">if</span> <span class="n">event_</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-438">                <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">transport</span><span class="p">:</span>
+</span><span id="1-439">                    <span class="bp">self</span><span class="o">.</span><span class="n">transport</span><span class="o">.</span><span class="n">record_lost_event</span><span class="p">(</span>
+</span><span id="1-440">                        <span class="s2">&quot;event_processor&quot;</span><span class="p">,</span>
+</span><span id="1-441">                        <span class="n">data_category</span><span class="o">=</span><span class="p">(</span><span class="s2">&quot;transaction&quot;</span> <span class="k">if</span> <span class="n">is_transaction</span> <span class="k">else</span> <span class="s2">&quot;error&quot;</span><span class="p">),</span>
+</span><span id="1-442">                    <span class="p">)</span>
+</span><span id="1-443">                <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-444">
+</span><span id="1-445">            <span class="n">event</span> <span class="o">=</span> <span class="n">event_</span>
+</span><span id="1-446">
+</span><span id="1-447">        <span class="k">if</span> <span class="p">(</span>
+</span><span id="1-448">            <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;attach_stacktrace&quot;</span><span class="p">]</span>
+</span><span id="1-449">            <span class="ow">and</span> <span class="s2">&quot;exception&quot;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">event</span>
+</span><span id="1-450">            <span class="ow">and</span> <span class="s2">&quot;stacktrace&quot;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">event</span>
+</span><span id="1-451">            <span class="ow">and</span> <span class="s2">&quot;threads&quot;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">event</span>
+</span><span id="1-452">        <span class="p">):</span>
+</span><span id="1-453">            <span class="k">with</span> <span class="n">capture_internal_exceptions</span><span class="p">():</span>
+</span><span id="1-454">                <span class="n">event</span><span class="p">[</span><span class="s2">&quot;threads&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="p">{</span>
+</span><span id="1-455">                    <span class="s2">&quot;values&quot;</span><span class="p">:</span> <span class="p">[</span>
+</span><span id="1-456">                        <span class="p">{</span>
+</span><span id="1-457">                            <span class="s2">&quot;stacktrace&quot;</span><span class="p">:</span> <span class="n">current_stacktrace</span><span class="p">(</span>
+</span><span id="1-458">                                <span class="n">include_local_variables</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span>
+</span><span id="1-459">                                    <span class="s2">&quot;include_local_variables&quot;</span><span class="p">,</span> <span class="kc">True</span>
+</span><span id="1-460">                                <span class="p">),</span>
+</span><span id="1-461">                                <span class="n">max_value_length</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span>
+</span><span id="1-462">                                    <span class="s2">&quot;max_value_length&quot;</span><span class="p">,</span> <span class="n">DEFAULT_MAX_VALUE_LENGTH</span>
+</span><span id="1-463">                                <span class="p">),</span>
+</span><span id="1-464">                            <span class="p">),</span>
+</span><span id="1-465">                            <span class="s2">&quot;crashed&quot;</span><span class="p">:</span> <span class="kc">False</span><span class="p">,</span>
+</span><span id="1-466">                            <span class="s2">&quot;current&quot;</span><span class="p">:</span> <span class="kc">True</span><span class="p">,</span>
+</span><span id="1-467">                        <span class="p">}</span>
+</span><span id="1-468">                    <span class="p">]</span>
+</span><span id="1-469">                <span class="p">}</span>
+</span><span id="1-470">
+</span><span id="1-471">        <span class="k">for</span> <span class="n">key</span> <span class="ow">in</span> <span class="s2">&quot;release&quot;</span><span class="p">,</span> <span class="s2">&quot;environment&quot;</span><span class="p">,</span> <span class="s2">&quot;server_name&quot;</span><span class="p">,</span> <span class="s2">&quot;dist&quot;</span><span class="p">:</span>
+</span><span id="1-472">            <span class="k">if</span> <span class="n">event</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">key</span><span class="p">)</span> <span class="ow">is</span> <span class="kc">None</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-473">                <span class="n">event</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="o">=</span> <span class="nb">str</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="n">key</span><span class="p">])</span><span class="o">.</span><span class="n">strip</span><span class="p">()</span>  <span class="c1"># type: ignore[literal-required]</span>
+</span><span id="1-474">        <span class="k">if</span> <span class="n">event</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;sdk&quot;</span><span class="p">)</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-475">            <span class="n">sdk_info</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="n">SDK_INFO</span><span class="p">)</span>
+</span><span id="1-476">            <span class="n">sdk_info</span><span class="p">[</span><span class="s2">&quot;integrations&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="nb">sorted</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">integrations</span><span class="o">.</span><span class="n">keys</span><span class="p">())</span>
+</span><span id="1-477">            <span class="n">event</span><span class="p">[</span><span class="s2">&quot;sdk&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">sdk_info</span>
+</span><span id="1-478">
+</span><span id="1-479">        <span class="k">if</span> <span class="n">event</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;platform&quot;</span><span class="p">)</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-480">            <span class="n">event</span><span class="p">[</span><span class="s2">&quot;platform&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="s2">&quot;python&quot;</span>
+</span><span id="1-481">
+</span><span id="1-482">        <span class="n">event</span> <span class="o">=</span> <span class="n">handle_in_app</span><span class="p">(</span>
+</span><span id="1-483">            <span class="n">event</span><span class="p">,</span>
+</span><span id="1-484">            <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;in_app_exclude&quot;</span><span class="p">],</span>
+</span><span id="1-485">            <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;in_app_include&quot;</span><span class="p">],</span>
+</span><span id="1-486">            <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;project_root&quot;</span><span class="p">],</span>
+</span><span id="1-487">        <span class="p">)</span>
 </span><span id="1-488">
-</span><span id="1-489">    <span class="k">def</span> <span class="nf">_should_capture</span><span class="p">(</span>
-</span><span id="1-490">        <span class="bp">self</span><span class="p">,</span>
-</span><span id="1-491">        <span class="n">event</span><span class="p">,</span>  <span class="c1"># type: Event</span>
-</span><span id="1-492">        <span class="n">hint</span><span class="p">,</span>  <span class="c1"># type: Hint</span>
-</span><span id="1-493">        <span class="n">scope</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Scope]</span>
-</span><span id="1-494">    <span class="p">):</span>
-</span><span id="1-495">        <span class="c1"># type: (...) -&gt; bool</span>
-</span><span id="1-496">        <span class="c1"># Transactions are sampled independent of error events.</span>
-</span><span id="1-497">        <span class="n">is_transaction</span> <span class="o">=</span> <span class="n">event</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;type&quot;</span><span class="p">)</span> <span class="o">==</span> <span class="s2">&quot;transaction&quot;</span>
-</span><span id="1-498">        <span class="k">if</span> <span class="n">is_transaction</span><span class="p">:</span>
-</span><span id="1-499">            <span class="k">return</span> <span class="kc">True</span>
-</span><span id="1-500">
-</span><span id="1-501">        <span class="n">ignoring_prevents_recursion</span> <span class="o">=</span> <span class="n">scope</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">scope</span><span class="o">.</span><span class="n">_should_capture</span>
-</span><span id="1-502">        <span class="k">if</span> <span class="n">ignoring_prevents_recursion</span><span class="p">:</span>
-</span><span id="1-503">            <span class="k">return</span> <span class="kc">False</span>
-</span><span id="1-504">
-</span><span id="1-505">        <span class="n">ignored_by_config_option</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_is_ignored_error</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">)</span>
-</span><span id="1-506">        <span class="k">if</span> <span class="n">ignored_by_config_option</span><span class="p">:</span>
-</span><span id="1-507">            <span class="k">return</span> <span class="kc">False</span>
-</span><span id="1-508">
-</span><span id="1-509">        <span class="k">return</span> <span class="kc">True</span>
-</span><span id="1-510">
-</span><span id="1-511">    <span class="k">def</span> <span class="nf">_should_sample_error</span><span class="p">(</span>
-</span><span id="1-512">        <span class="bp">self</span><span class="p">,</span>
-</span><span id="1-513">        <span class="n">event</span><span class="p">,</span>  <span class="c1"># type: Event</span>
-</span><span id="1-514">        <span class="n">hint</span><span class="p">,</span>  <span class="c1"># type: Hint</span>
-</span><span id="1-515">    <span class="p">):</span>
-</span><span id="1-516">        <span class="c1"># type: (...) -&gt; bool</span>
-</span><span id="1-517">        <span class="n">error_sampler</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;error_sampler&quot;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-</span><span id="1-518">
-</span><span id="1-519">        <span class="k">if</span> <span class="nb">callable</span><span class="p">(</span><span class="n">error_sampler</span><span class="p">):</span>
-</span><span id="1-520">            <span class="k">with</span> <span class="n">capture_internal_exceptions</span><span class="p">():</span>
-</span><span id="1-521">                <span class="n">sample_rate</span> <span class="o">=</span> <span class="n">error_sampler</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">)</span>
-</span><span id="1-522">        <span class="k">else</span><span class="p">:</span>
-</span><span id="1-523">            <span class="n">sample_rate</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;sample_rate&quot;</span><span class="p">]</span>
-</span><span id="1-524">
-</span><span id="1-525">        <span class="k">try</span><span class="p">:</span>
-</span><span id="1-526">            <span class="n">not_in_sample_rate</span> <span class="o">=</span> <span class="n">sample_rate</span> <span class="o">&lt;</span> <span class="mf">1.0</span> <span class="ow">and</span> <span class="n">random</span><span class="o">.</span><span class="n">random</span><span class="p">()</span> <span class="o">&gt;=</span> <span class="n">sample_rate</span>
-</span><span id="1-527">        <span class="k">except</span> <span class="ne">NameError</span><span class="p">:</span>
-</span><span id="1-528">            <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
-</span><span id="1-529">                <span class="s2">&quot;The provided error_sampler raised an error. Defaulting to sampling the event.&quot;</span>
-</span><span id="1-530">            <span class="p">)</span>
-</span><span id="1-531">
-</span><span id="1-532">            <span class="c1"># If the error_sampler raised an error, we should sample the event, since the default behavior</span>
-</span><span id="1-533">            <span class="c1"># (when no sample_rate or error_sampler is provided) is to sample all events.</span>
-</span><span id="1-534">            <span class="n">not_in_sample_rate</span> <span class="o">=</span> <span class="kc">False</span>
-</span><span id="1-535">        <span class="k">except</span> <span class="ne">TypeError</span><span class="p">:</span>
-</span><span id="1-536">            <span class="n">parameter</span><span class="p">,</span> <span class="n">verb</span> <span class="o">=</span> <span class="p">(</span>
-</span><span id="1-537">                <span class="p">(</span><span class="s2">&quot;error_sampler&quot;</span><span class="p">,</span> <span class="s2">&quot;returned&quot;</span><span class="p">)</span>
-</span><span id="1-538">                <span class="k">if</span> <span class="nb">callable</span><span class="p">(</span><span class="n">error_sampler</span><span class="p">)</span>
-</span><span id="1-539">                <span class="k">else</span> <span class="p">(</span><span class="s2">&quot;sample_rate&quot;</span><span class="p">,</span> <span class="s2">&quot;contains&quot;</span><span class="p">)</span>
-</span><span id="1-540">            <span class="p">)</span>
-</span><span id="1-541">            <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
-</span><span id="1-542">                <span class="s2">&quot;The provided </span><span class="si">%s</span><span class="s2"> </span><span class="si">%s</span><span class="s2"> an invalid value of </span><span class="si">%s</span><span class="s2">. The value should be a float or a bool. Defaulting to sampling the event.&quot;</span>
-</span><span id="1-543">                <span class="o">%</span> <span class="p">(</span><span class="n">parameter</span><span class="p">,</span> <span class="n">verb</span><span class="p">,</span> <span class="nb">repr</span><span class="p">(</span><span class="n">sample_rate</span><span class="p">))</span>
-</span><span id="1-544">            <span class="p">)</span>
-</span><span id="1-545">
-</span><span id="1-546">            <span class="c1"># If the sample_rate has an invalid value, we should sample the event, since the default behavior</span>
-</span><span id="1-547">            <span class="c1"># (when no sample_rate or error_sampler is provided) is to sample all events.</span>
-</span><span id="1-548">            <span class="n">not_in_sample_rate</span> <span class="o">=</span> <span class="kc">False</span>
-</span><span id="1-549">
-</span><span id="1-550">        <span class="k">if</span> <span class="n">not_in_sample_rate</span><span class="p">:</span>
-</span><span id="1-551">            <span class="c1"># because we will not sample this event, record a &quot;lost event&quot;.</span>
-</span><span id="1-552">            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">transport</span><span class="p">:</span>
-</span><span id="1-553">                <span class="bp">self</span><span class="o">.</span><span class="n">transport</span><span class="o">.</span><span class="n">record_lost_event</span><span class="p">(</span><span class="s2">&quot;sample_rate&quot;</span><span class="p">,</span> <span class="n">data_category</span><span class="o">=</span><span class="s2">&quot;error&quot;</span><span class="p">)</span>
-</span><span id="1-554">
-</span><span id="1-555">            <span class="k">return</span> <span class="kc">False</span>
-</span><span id="1-556">
-</span><span id="1-557">        <span class="k">return</span> <span class="kc">True</span>
+</span><span id="1-489">        <span class="k">if</span> <span class="n">event</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-490">            <span class="n">event_scrubber</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;event_scrubber&quot;</span><span class="p">]</span>
+</span><span id="1-491">            <span class="k">if</span> <span class="n">event_scrubber</span> <span class="ow">and</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;send_default_pii&quot;</span><span class="p">]:</span>
+</span><span id="1-492">                <span class="n">event_scrubber</span><span class="o">.</span><span class="n">scrub_event</span><span class="p">(</span><span class="n">event</span><span class="p">)</span>
+</span><span id="1-493">
+</span><span id="1-494">        <span class="c1"># Postprocess the event here so that annotated types do</span>
+</span><span id="1-495">        <span class="c1"># generally not surface in before_send</span>
+</span><span id="1-496">        <span class="k">if</span> <span class="n">event</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-497">            <span class="n">event</span> <span class="o">=</span> <span class="n">serialize</span><span class="p">(</span>
+</span><span id="1-498">                <span class="n">event</span><span class="p">,</span>
+</span><span id="1-499">                <span class="n">max_request_body_size</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;max_request_body_size&quot;</span><span class="p">),</span>
+</span><span id="1-500">                <span class="n">max_value_length</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;max_value_length&quot;</span><span class="p">),</span>
+</span><span id="1-501">            <span class="p">)</span>
+</span><span id="1-502">
+</span><span id="1-503">        <span class="n">before_send</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;before_send&quot;</span><span class="p">]</span>
+</span><span id="1-504">        <span class="k">if</span> <span class="p">(</span>
+</span><span id="1-505">            <span class="n">before_send</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span>
+</span><span id="1-506">            <span class="ow">and</span> <span class="n">event</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span>
+</span><span id="1-507">            <span class="ow">and</span> <span class="n">event</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;type&quot;</span><span class="p">)</span> <span class="o">!=</span> <span class="s2">&quot;transaction&quot;</span>
+</span><span id="1-508">        <span class="p">):</span>
+</span><span id="1-509">            <span class="n">new_event</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="1-510">            <span class="k">with</span> <span class="n">capture_internal_exceptions</span><span class="p">():</span>
+</span><span id="1-511">                <span class="n">new_event</span> <span class="o">=</span> <span class="n">before_send</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span> <span class="ow">or</span> <span class="p">{})</span>
+</span><span id="1-512">            <span class="k">if</span> <span class="n">new_event</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-513">                <span class="n">logger</span><span class="o">.</span><span class="n">info</span><span class="p">(</span><span class="s2">&quot;before send dropped event&quot;</span><span class="p">)</span>
+</span><span id="1-514">                <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">transport</span><span class="p">:</span>
+</span><span id="1-515">                    <span class="bp">self</span><span class="o">.</span><span class="n">transport</span><span class="o">.</span><span class="n">record_lost_event</span><span class="p">(</span>
+</span><span id="1-516">                        <span class="s2">&quot;before_send&quot;</span><span class="p">,</span> <span class="n">data_category</span><span class="o">=</span><span class="s2">&quot;error&quot;</span>
+</span><span id="1-517">                    <span class="p">)</span>
+</span><span id="1-518">            <span class="n">event</span> <span class="o">=</span> <span class="n">new_event</span>  <span class="c1"># type: ignore</span>
+</span><span id="1-519">
+</span><span id="1-520">        <span class="n">before_send_transaction</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;before_send_transaction&quot;</span><span class="p">]</span>
+</span><span id="1-521">        <span class="k">if</span> <span class="p">(</span>
+</span><span id="1-522">            <span class="n">before_send_transaction</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span>
+</span><span id="1-523">            <span class="ow">and</span> <span class="n">event</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span>
+</span><span id="1-524">            <span class="ow">and</span> <span class="n">event</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;type&quot;</span><span class="p">)</span> <span class="o">==</span> <span class="s2">&quot;transaction&quot;</span>
+</span><span id="1-525">        <span class="p">):</span>
+</span><span id="1-526">            <span class="n">new_event</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="1-527">            <span class="k">with</span> <span class="n">capture_internal_exceptions</span><span class="p">():</span>
+</span><span id="1-528">                <span class="n">new_event</span> <span class="o">=</span> <span class="n">before_send_transaction</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span> <span class="ow">or</span> <span class="p">{})</span>
+</span><span id="1-529">            <span class="k">if</span> <span class="n">new_event</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-530">                <span class="n">logger</span><span class="o">.</span><span class="n">info</span><span class="p">(</span><span class="s2">&quot;before send transaction dropped event&quot;</span><span class="p">)</span>
+</span><span id="1-531">                <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">transport</span><span class="p">:</span>
+</span><span id="1-532">                    <span class="bp">self</span><span class="o">.</span><span class="n">transport</span><span class="o">.</span><span class="n">record_lost_event</span><span class="p">(</span>
+</span><span id="1-533">                        <span class="s2">&quot;before_send&quot;</span><span class="p">,</span> <span class="n">data_category</span><span class="o">=</span><span class="s2">&quot;transaction&quot;</span>
+</span><span id="1-534">                    <span class="p">)</span>
+</span><span id="1-535">            <span class="n">event</span> <span class="o">=</span> <span class="n">new_event</span>  <span class="c1"># type: ignore</span>
+</span><span id="1-536">
+</span><span id="1-537">        <span class="k">return</span> <span class="n">event</span>
+</span><span id="1-538">
+</span><span id="1-539">    <span class="k">def</span> <span class="nf">_is_ignored_error</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">):</span>
+</span><span id="1-540">        <span class="c1"># type: (Event, Hint) -&gt; bool</span>
+</span><span id="1-541">        <span class="n">exc_info</span> <span class="o">=</span> <span class="n">hint</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;exc_info&quot;</span><span class="p">)</span>
+</span><span id="1-542">        <span class="k">if</span> <span class="n">exc_info</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-543">            <span class="k">return</span> <span class="kc">False</span>
+</span><span id="1-544">
+</span><span id="1-545">        <span class="n">error</span> <span class="o">=</span> <span class="n">exc_info</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span>
+</span><span id="1-546">        <span class="n">error_type_name</span> <span class="o">=</span> <span class="n">get_type_name</span><span class="p">(</span><span class="n">exc_info</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span>
+</span><span id="1-547">        <span class="n">error_full_name</span> <span class="o">=</span> <span class="s2">&quot;</span><span class="si">%s</span><span class="s2">.</span><span class="si">%s</span><span class="s2">&quot;</span> <span class="o">%</span> <span class="p">(</span><span class="n">exc_info</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="vm">__module__</span><span class="p">,</span> <span class="n">error_type_name</span><span class="p">)</span>
+</span><span id="1-548">
+</span><span id="1-549">        <span class="k">for</span> <span class="n">ignored_error</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;ignore_errors&quot;</span><span class="p">]:</span>
+</span><span id="1-550">            <span class="c1"># String types are matched against the type name in the</span>
+</span><span id="1-551">            <span class="c1"># exception only</span>
+</span><span id="1-552">            <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">ignored_error</span><span class="p">,</span> <span class="nb">str</span><span class="p">):</span>
+</span><span id="1-553">                <span class="k">if</span> <span class="n">ignored_error</span> <span class="o">==</span> <span class="n">error_full_name</span> <span class="ow">or</span> <span class="n">ignored_error</span> <span class="o">==</span> <span class="n">error_type_name</span><span class="p">:</span>
+</span><span id="1-554">                    <span class="k">return</span> <span class="kc">True</span>
+</span><span id="1-555">            <span class="k">else</span><span class="p">:</span>
+</span><span id="1-556">                <span class="k">if</span> <span class="nb">issubclass</span><span class="p">(</span><span class="n">error</span><span class="p">,</span> <span class="n">ignored_error</span><span class="p">):</span>
+</span><span id="1-557">                    <span class="k">return</span> <span class="kc">True</span>
 </span><span id="1-558">
-</span><span id="1-559">    <span class="k">def</span> <span class="nf">_update_session_from_event</span><span class="p">(</span>
-</span><span id="1-560">        <span class="bp">self</span><span class="p">,</span>
-</span><span id="1-561">        <span class="n">session</span><span class="p">,</span>  <span class="c1"># type: Session</span>
-</span><span id="1-562">        <span class="n">event</span><span class="p">,</span>  <span class="c1"># type: Event</span>
-</span><span id="1-563">    <span class="p">):</span>
-</span><span id="1-564">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-565">
-</span><span id="1-566">        <span class="n">crashed</span> <span class="o">=</span> <span class="kc">False</span>
-</span><span id="1-567">        <span class="n">errored</span> <span class="o">=</span> <span class="kc">False</span>
-</span><span id="1-568">        <span class="n">user_agent</span> <span class="o">=</span> <span class="kc">None</span>
-</span><span id="1-569">
-</span><span id="1-570">        <span class="n">exceptions</span> <span class="o">=</span> <span class="p">(</span><span class="n">event</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;exception&quot;</span><span class="p">)</span> <span class="ow">or</span> <span class="p">{})</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;values&quot;</span><span class="p">)</span>
-</span><span id="1-571">        <span class="k">if</span> <span class="n">exceptions</span><span class="p">:</span>
-</span><span id="1-572">            <span class="n">errored</span> <span class="o">=</span> <span class="kc">True</span>
-</span><span id="1-573">            <span class="k">for</span> <span class="n">error</span> <span class="ow">in</span> <span class="n">exceptions</span><span class="p">:</span>
-</span><span id="1-574">                <span class="n">mechanism</span> <span class="o">=</span> <span class="n">error</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;mechanism&quot;</span><span class="p">)</span>
-</span><span id="1-575">                <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">mechanism</span><span class="p">,</span> <span class="n">Mapping</span><span class="p">)</span> <span class="ow">and</span> <span class="n">mechanism</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;handled&quot;</span><span class="p">)</span> <span class="ow">is</span> <span class="kc">False</span><span class="p">:</span>
-</span><span id="1-576">                    <span class="n">crashed</span> <span class="o">=</span> <span class="kc">True</span>
-</span><span id="1-577">                    <span class="k">break</span>
-</span><span id="1-578">
-</span><span id="1-579">        <span class="n">user</span> <span class="o">=</span> <span class="n">event</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;user&quot;</span><span class="p">)</span>
+</span><span id="1-559">        <span class="k">return</span> <span class="kc">False</span>
+</span><span id="1-560">
+</span><span id="1-561">    <span class="k">def</span> <span class="nf">_should_capture</span><span class="p">(</span>
+</span><span id="1-562">        <span class="bp">self</span><span class="p">,</span>
+</span><span id="1-563">        <span class="n">event</span><span class="p">,</span>  <span class="c1"># type: Event</span>
+</span><span id="1-564">        <span class="n">hint</span><span class="p">,</span>  <span class="c1"># type: Hint</span>
+</span><span id="1-565">        <span class="n">scope</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Scope]</span>
+</span><span id="1-566">    <span class="p">):</span>
+</span><span id="1-567">        <span class="c1"># type: (...) -&gt; bool</span>
+</span><span id="1-568">        <span class="c1"># Transactions are sampled independent of error events.</span>
+</span><span id="1-569">        <span class="n">is_transaction</span> <span class="o">=</span> <span class="n">event</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;type&quot;</span><span class="p">)</span> <span class="o">==</span> <span class="s2">&quot;transaction&quot;</span>
+</span><span id="1-570">        <span class="k">if</span> <span class="n">is_transaction</span><span class="p">:</span>
+</span><span id="1-571">            <span class="k">return</span> <span class="kc">True</span>
+</span><span id="1-572">
+</span><span id="1-573">        <span class="n">ignoring_prevents_recursion</span> <span class="o">=</span> <span class="n">scope</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">scope</span><span class="o">.</span><span class="n">_should_capture</span>
+</span><span id="1-574">        <span class="k">if</span> <span class="n">ignoring_prevents_recursion</span><span class="p">:</span>
+</span><span id="1-575">            <span class="k">return</span> <span class="kc">False</span>
+</span><span id="1-576">
+</span><span id="1-577">        <span class="n">ignored_by_config_option</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_is_ignored_error</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">)</span>
+</span><span id="1-578">        <span class="k">if</span> <span class="n">ignored_by_config_option</span><span class="p">:</span>
+</span><span id="1-579">            <span class="k">return</span> <span class="kc">False</span>
 </span><span id="1-580">
-</span><span id="1-581">        <span class="k">if</span> <span class="n">session</span><span class="o">.</span><span class="n">user_agent</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-582">            <span class="n">headers</span> <span class="o">=</span> <span class="p">(</span><span class="n">event</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;request&quot;</span><span class="p">)</span> <span class="ow">or</span> <span class="p">{})</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;headers&quot;</span><span class="p">)</span>
-</span><span id="1-583">            <span class="k">for</span> <span class="n">k</span><span class="p">,</span> <span class="n">v</span> <span class="ow">in</span> <span class="n">iteritems</span><span class="p">(</span><span class="n">headers</span> <span class="ow">or</span> <span class="p">{}):</span>
-</span><span id="1-584">                <span class="k">if</span> <span class="n">k</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span> <span class="o">==</span> <span class="s2">&quot;user-agent&quot;</span><span class="p">:</span>
-</span><span id="1-585">                    <span class="n">user_agent</span> <span class="o">=</span> <span class="n">v</span>
-</span><span id="1-586">                    <span class="k">break</span>
-</span><span id="1-587">
-</span><span id="1-588">        <span class="n">session</span><span class="o">.</span><span class="n">update</span><span class="p">(</span>
-</span><span id="1-589">            <span class="n">status</span><span class="o">=</span><span class="s2">&quot;crashed&quot;</span> <span class="k">if</span> <span class="n">crashed</span> <span class="k">else</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="1-590">            <span class="n">user</span><span class="o">=</span><span class="n">user</span><span class="p">,</span>
-</span><span id="1-591">            <span class="n">user_agent</span><span class="o">=</span><span class="n">user_agent</span><span class="p">,</span>
-</span><span id="1-592">            <span class="n">errors</span><span class="o">=</span><span class="n">session</span><span class="o">.</span><span class="n">errors</span> <span class="o">+</span> <span class="p">(</span><span class="n">errored</span> <span class="ow">or</span> <span class="n">crashed</span><span class="p">),</span>
-</span><span id="1-593">        <span class="p">)</span>
-</span><span id="1-594">
-<div class="viewcode-block" id="_Client.capture_event">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk._Client.capture_event">[docs]</a>
-</span><span id="1-595">    <span class="k">def</span> <span class="nf">capture_event</span><span class="p">(</span>
-</span><span id="1-596">        <span class="bp">self</span><span class="p">,</span>
-</span><span id="1-597">        <span class="n">event</span><span class="p">,</span>  <span class="c1"># type: Event</span>
-</span><span id="1-598">        <span class="n">hint</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Hint]</span>
-</span><span id="1-599">        <span class="n">scope</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Scope]</span>
-</span><span id="1-600">    <span class="p">):</span>
-</span><span id="1-601">        <span class="c1"># type: (...) -&gt; Optional[str]</span>
-</span><span id="1-602"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Captures an event.</span>
+</span><span id="1-581">        <span class="k">return</span> <span class="kc">True</span>
+</span><span id="1-582">
+</span><span id="1-583">    <span class="k">def</span> <span class="nf">_should_sample_error</span><span class="p">(</span>
+</span><span id="1-584">        <span class="bp">self</span><span class="p">,</span>
+</span><span id="1-585">        <span class="n">event</span><span class="p">,</span>  <span class="c1"># type: Event</span>
+</span><span id="1-586">        <span class="n">hint</span><span class="p">,</span>  <span class="c1"># type: Hint</span>
+</span><span id="1-587">    <span class="p">):</span>
+</span><span id="1-588">        <span class="c1"># type: (...) -&gt; bool</span>
+</span><span id="1-589">        <span class="n">error_sampler</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;error_sampler&quot;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
+</span><span id="1-590">
+</span><span id="1-591">        <span class="k">if</span> <span class="nb">callable</span><span class="p">(</span><span class="n">error_sampler</span><span class="p">):</span>
+</span><span id="1-592">            <span class="k">with</span> <span class="n">capture_internal_exceptions</span><span class="p">():</span>
+</span><span id="1-593">                <span class="n">sample_rate</span> <span class="o">=</span> <span class="n">error_sampler</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">)</span>
+</span><span id="1-594">        <span class="k">else</span><span class="p">:</span>
+</span><span id="1-595">            <span class="n">sample_rate</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;sample_rate&quot;</span><span class="p">]</span>
+</span><span id="1-596">
+</span><span id="1-597">        <span class="k">try</span><span class="p">:</span>
+</span><span id="1-598">            <span class="n">not_in_sample_rate</span> <span class="o">=</span> <span class="n">sample_rate</span> <span class="o">&lt;</span> <span class="mf">1.0</span> <span class="ow">and</span> <span class="n">random</span><span class="o">.</span><span class="n">random</span><span class="p">()</span> <span class="o">&gt;=</span> <span class="n">sample_rate</span>
+</span><span id="1-599">        <span class="k">except</span> <span class="ne">NameError</span><span class="p">:</span>
+</span><span id="1-600">            <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
+</span><span id="1-601">                <span class="s2">&quot;The provided error_sampler raised an error. Defaulting to sampling the event.&quot;</span>
+</span><span id="1-602">            <span class="p">)</span>
 </span><span id="1-603">
-</span><span id="1-604"><span class="sd">        :param event: A ready-made event that can be directly sent to Sentry.</span>
-</span><span id="1-605">
-</span><span id="1-606"><span class="sd">        :param hint: Contains metadata about the event that can be read from `before_send`, such as the original exception object or a HTTP request object.</span>
-</span><span id="1-607">
-</span><span id="1-608"><span class="sd">        :param scope: An optional :py:class:`sentry_sdk.Scope` to apply to events.</span>
-</span><span id="1-609"><span class="sd">            The `scope` and `scope_kwargs` parameters are mutually exclusive.</span>
-</span><span id="1-610">
-</span><span id="1-611"><span class="sd">        :returns: An event ID. May be `None` if there is no DSN set or of if the SDK decided to discard the event for other reasons. In such situations setting `debug=True` on `init()` may help.</span>
-</span><span id="1-612"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-613">        <span class="k">if</span> <span class="n">disable_capture_event</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="kc">False</span><span class="p">):</span>
-</span><span id="1-614">            <span class="k">return</span> <span class="kc">None</span>
-</span><span id="1-615">
-</span><span id="1-616">        <span class="k">if</span> <span class="n">hint</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-617">            <span class="n">hint</span> <span class="o">=</span> <span class="p">{}</span>
-</span><span id="1-618">        <span class="n">event_id</span> <span class="o">=</span> <span class="n">event</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;event_id&quot;</span><span class="p">)</span>
-</span><span id="1-619">        <span class="n">hint</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="n">hint</span> <span class="ow">or</span> <span class="p">())</span>  <span class="c1"># type: Hint</span>
-</span><span id="1-620">
-</span><span id="1-621">        <span class="k">if</span> <span class="n">event_id</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-622">            <span class="n">event</span><span class="p">[</span><span class="s2">&quot;event_id&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">event_id</span> <span class="o">=</span> <span class="n">uuid</span><span class="o">.</span><span class="n">uuid4</span><span class="p">()</span><span class="o">.</span><span class="n">hex</span>
-</span><span id="1-623">        <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_should_capture</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">scope</span><span class="p">):</span>
-</span><span id="1-624">            <span class="k">return</span> <span class="kc">None</span>
-</span><span id="1-625">
-</span><span id="1-626">        <span class="n">profile</span> <span class="o">=</span> <span class="n">event</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s2">&quot;profile&quot;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-</span><span id="1-627">
-</span><span id="1-628">        <span class="n">event_opt</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_prepare_event</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">scope</span><span class="p">)</span>
-</span><span id="1-629">        <span class="k">if</span> <span class="n">event_opt</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-630">            <span class="k">return</span> <span class="kc">None</span>
-</span><span id="1-631">
-</span><span id="1-632">        <span class="c1"># whenever we capture an event we also check if the session needs</span>
-</span><span id="1-633">        <span class="c1"># to be updated based on that information.</span>
-</span><span id="1-634">        <span class="n">session</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">_session</span> <span class="k">if</span> <span class="n">scope</span> <span class="k">else</span> <span class="kc">None</span>
-</span><span id="1-635">        <span class="k">if</span> <span class="n">session</span><span class="p">:</span>
-</span><span id="1-636">            <span class="bp">self</span><span class="o">.</span><span class="n">_update_session_from_event</span><span class="p">(</span><span class="n">session</span><span class="p">,</span> <span class="n">event</span><span class="p">)</span>
+</span><span id="1-604">            <span class="c1"># If the error_sampler raised an error, we should sample the event, since the default behavior</span>
+</span><span id="1-605">            <span class="c1"># (when no sample_rate or error_sampler is provided) is to sample all events.</span>
+</span><span id="1-606">            <span class="n">not_in_sample_rate</span> <span class="o">=</span> <span class="kc">False</span>
+</span><span id="1-607">        <span class="k">except</span> <span class="ne">TypeError</span><span class="p">:</span>
+</span><span id="1-608">            <span class="n">parameter</span><span class="p">,</span> <span class="n">verb</span> <span class="o">=</span> <span class="p">(</span>
+</span><span id="1-609">                <span class="p">(</span><span class="s2">&quot;error_sampler&quot;</span><span class="p">,</span> <span class="s2">&quot;returned&quot;</span><span class="p">)</span>
+</span><span id="1-610">                <span class="k">if</span> <span class="nb">callable</span><span class="p">(</span><span class="n">error_sampler</span><span class="p">)</span>
+</span><span id="1-611">                <span class="k">else</span> <span class="p">(</span><span class="s2">&quot;sample_rate&quot;</span><span class="p">,</span> <span class="s2">&quot;contains&quot;</span><span class="p">)</span>
+</span><span id="1-612">            <span class="p">)</span>
+</span><span id="1-613">            <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
+</span><span id="1-614">                <span class="s2">&quot;The provided </span><span class="si">%s</span><span class="s2"> </span><span class="si">%s</span><span class="s2"> an invalid value of </span><span class="si">%s</span><span class="s2">. The value should be a float or a bool. Defaulting to sampling the event.&quot;</span>
+</span><span id="1-615">                <span class="o">%</span> <span class="p">(</span><span class="n">parameter</span><span class="p">,</span> <span class="n">verb</span><span class="p">,</span> <span class="nb">repr</span><span class="p">(</span><span class="n">sample_rate</span><span class="p">))</span>
+</span><span id="1-616">            <span class="p">)</span>
+</span><span id="1-617">
+</span><span id="1-618">            <span class="c1"># If the sample_rate has an invalid value, we should sample the event, since the default behavior</span>
+</span><span id="1-619">            <span class="c1"># (when no sample_rate or error_sampler is provided) is to sample all events.</span>
+</span><span id="1-620">            <span class="n">not_in_sample_rate</span> <span class="o">=</span> <span class="kc">False</span>
+</span><span id="1-621">
+</span><span id="1-622">        <span class="k">if</span> <span class="n">not_in_sample_rate</span><span class="p">:</span>
+</span><span id="1-623">            <span class="c1"># because we will not sample this event, record a &quot;lost event&quot;.</span>
+</span><span id="1-624">            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">transport</span><span class="p">:</span>
+</span><span id="1-625">                <span class="bp">self</span><span class="o">.</span><span class="n">transport</span><span class="o">.</span><span class="n">record_lost_event</span><span class="p">(</span><span class="s2">&quot;sample_rate&quot;</span><span class="p">,</span> <span class="n">data_category</span><span class="o">=</span><span class="s2">&quot;error&quot;</span><span class="p">)</span>
+</span><span id="1-626">
+</span><span id="1-627">            <span class="k">return</span> <span class="kc">False</span>
+</span><span id="1-628">
+</span><span id="1-629">        <span class="k">return</span> <span class="kc">True</span>
+</span><span id="1-630">
+</span><span id="1-631">    <span class="k">def</span> <span class="nf">_update_session_from_event</span><span class="p">(</span>
+</span><span id="1-632">        <span class="bp">self</span><span class="p">,</span>
+</span><span id="1-633">        <span class="n">session</span><span class="p">,</span>  <span class="c1"># type: Session</span>
+</span><span id="1-634">        <span class="n">event</span><span class="p">,</span>  <span class="c1"># type: Event</span>
+</span><span id="1-635">    <span class="p">):</span>
+</span><span id="1-636">        <span class="c1"># type: (...) -&gt; None</span>
 </span><span id="1-637">
-</span><span id="1-638">        <span class="n">is_transaction</span> <span class="o">=</span> <span class="n">event_opt</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;type&quot;</span><span class="p">)</span> <span class="o">==</span> <span class="s2">&quot;transaction&quot;</span>
-</span><span id="1-639">        <span class="n">is_checkin</span> <span class="o">=</span> <span class="n">event_opt</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;type&quot;</span><span class="p">)</span> <span class="o">==</span> <span class="s2">&quot;check_in&quot;</span>
-</span><span id="1-640">
-</span><span id="1-641">        <span class="k">if</span> <span class="p">(</span>
-</span><span id="1-642">            <span class="ow">not</span> <span class="n">is_transaction</span>
-</span><span id="1-643">            <span class="ow">and</span> <span class="ow">not</span> <span class="n">is_checkin</span>
-</span><span id="1-644">            <span class="ow">and</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_should_sample_error</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">)</span>
-</span><span id="1-645">        <span class="p">):</span>
-</span><span id="1-646">            <span class="k">return</span> <span class="kc">None</span>
-</span><span id="1-647">
-</span><span id="1-648">        <span class="n">tracing_enabled</span> <span class="o">=</span> <span class="n">has_tracing_enabled</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">)</span>
-</span><span id="1-649">        <span class="n">attachments</span> <span class="o">=</span> <span class="n">hint</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;attachments&quot;</span><span class="p">)</span>
+</span><span id="1-638">        <span class="n">crashed</span> <span class="o">=</span> <span class="kc">False</span>
+</span><span id="1-639">        <span class="n">errored</span> <span class="o">=</span> <span class="kc">False</span>
+</span><span id="1-640">        <span class="n">user_agent</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="1-641">
+</span><span id="1-642">        <span class="n">exceptions</span> <span class="o">=</span> <span class="p">(</span><span class="n">event</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;exception&quot;</span><span class="p">)</span> <span class="ow">or</span> <span class="p">{})</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;values&quot;</span><span class="p">)</span>
+</span><span id="1-643">        <span class="k">if</span> <span class="n">exceptions</span><span class="p">:</span>
+</span><span id="1-644">            <span class="n">errored</span> <span class="o">=</span> <span class="kc">True</span>
+</span><span id="1-645">            <span class="k">for</span> <span class="n">error</span> <span class="ow">in</span> <span class="n">exceptions</span><span class="p">:</span>
+</span><span id="1-646">                <span class="n">mechanism</span> <span class="o">=</span> <span class="n">error</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;mechanism&quot;</span><span class="p">)</span>
+</span><span id="1-647">                <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">mechanism</span><span class="p">,</span> <span class="n">Mapping</span><span class="p">)</span> <span class="ow">and</span> <span class="n">mechanism</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;handled&quot;</span><span class="p">)</span> <span class="ow">is</span> <span class="kc">False</span><span class="p">:</span>
+</span><span id="1-648">                    <span class="n">crashed</span> <span class="o">=</span> <span class="kc">True</span>
+</span><span id="1-649">                    <span class="k">break</span>
 </span><span id="1-650">
-</span><span id="1-651">        <span class="n">trace_context</span> <span class="o">=</span> <span class="n">event_opt</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;contexts&quot;</span><span class="p">,</span> <span class="p">{})</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;trace&quot;</span><span class="p">)</span> <span class="ow">or</span> <span class="p">{}</span>
-</span><span id="1-652">        <span class="n">dynamic_sampling_context</span> <span class="o">=</span> <span class="n">trace_context</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s2">&quot;dynamic_sampling_context&quot;</span><span class="p">,</span> <span class="p">{})</span>
-</span><span id="1-653">
-</span><span id="1-654">        <span class="c1"># If tracing is enabled all events should go to /envelope endpoint.</span>
-</span><span id="1-655">        <span class="c1"># If no tracing is enabled only transactions, events with attachments, and checkins should go to the /envelope endpoint.</span>
-</span><span id="1-656">        <span class="n">should_use_envelope_endpoint</span> <span class="o">=</span> <span class="p">(</span>
-</span><span id="1-657">            <span class="n">tracing_enabled</span>
-</span><span id="1-658">            <span class="ow">or</span> <span class="n">is_transaction</span>
-</span><span id="1-659">            <span class="ow">or</span> <span class="n">is_checkin</span>
-</span><span id="1-660">            <span class="ow">or</span> <span class="nb">bool</span><span class="p">(</span><span class="n">attachments</span><span class="p">)</span>
-</span><span id="1-661">            <span class="ow">or</span> <span class="nb">bool</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">spotlight</span><span class="p">)</span>
-</span><span id="1-662">        <span class="p">)</span>
-</span><span id="1-663">        <span class="k">if</span> <span class="n">should_use_envelope_endpoint</span><span class="p">:</span>
-</span><span id="1-664">            <span class="n">headers</span> <span class="o">=</span> <span class="p">{</span>
-</span><span id="1-665">                <span class="s2">&quot;event_id&quot;</span><span class="p">:</span> <span class="n">event_opt</span><span class="p">[</span><span class="s2">&quot;event_id&quot;</span><span class="p">],</span>
-</span><span id="1-666">                <span class="s2">&quot;sent_at&quot;</span><span class="p">:</span> <span class="n">format_timestamp</span><span class="p">(</span><span class="n">datetime_utcnow</span><span class="p">()),</span>
-</span><span id="1-667">            <span class="p">}</span>  <span class="c1"># type: dict[str, object]</span>
-</span><span id="1-668">
-</span><span id="1-669">            <span class="k">if</span> <span class="n">dynamic_sampling_context</span><span class="p">:</span>
-</span><span id="1-670">                <span class="n">headers</span><span class="p">[</span><span class="s2">&quot;trace&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">dynamic_sampling_context</span>
-</span><span id="1-671">
-</span><span id="1-672">            <span class="n">envelope</span> <span class="o">=</span> <span class="n">Envelope</span><span class="p">(</span><span class="n">headers</span><span class="o">=</span><span class="n">headers</span><span class="p">)</span>
-</span><span id="1-673">
-</span><span id="1-674">            <span class="k">if</span> <span class="n">is_transaction</span><span class="p">:</span>
-</span><span id="1-675">                <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">profile</span><span class="p">,</span> <span class="n">Profile</span><span class="p">):</span>
-</span><span id="1-676">                    <span class="n">envelope</span><span class="o">.</span><span class="n">add_profile</span><span class="p">(</span><span class="n">profile</span><span class="o">.</span><span class="n">to_json</span><span class="p">(</span><span class="n">event_opt</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">))</span>
-</span><span id="1-677">                <span class="n">envelope</span><span class="o">.</span><span class="n">add_transaction</span><span class="p">(</span><span class="n">event_opt</span><span class="p">)</span>
-</span><span id="1-678">            <span class="k">elif</span> <span class="n">is_checkin</span><span class="p">:</span>
-</span><span id="1-679">                <span class="n">envelope</span><span class="o">.</span><span class="n">add_checkin</span><span class="p">(</span><span class="n">event_opt</span><span class="p">)</span>
-</span><span id="1-680">            <span class="k">else</span><span class="p">:</span>
-</span><span id="1-681">                <span class="n">envelope</span><span class="o">.</span><span class="n">add_event</span><span class="p">(</span><span class="n">event_opt</span><span class="p">)</span>
+</span><span id="1-651">        <span class="n">user</span> <span class="o">=</span> <span class="n">event</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;user&quot;</span><span class="p">)</span>
+</span><span id="1-652">
+</span><span id="1-653">        <span class="k">if</span> <span class="n">session</span><span class="o">.</span><span class="n">user_agent</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-654">            <span class="n">headers</span> <span class="o">=</span> <span class="p">(</span><span class="n">event</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;request&quot;</span><span class="p">)</span> <span class="ow">or</span> <span class="p">{})</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;headers&quot;</span><span class="p">)</span>
+</span><span id="1-655">            <span class="n">headers_dict</span> <span class="o">=</span> <span class="n">headers</span> <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">headers</span><span class="p">,</span> <span class="nb">dict</span><span class="p">)</span> <span class="k">else</span> <span class="p">{}</span>
+</span><span id="1-656">            <span class="k">for</span> <span class="n">k</span><span class="p">,</span> <span class="n">v</span> <span class="ow">in</span> <span class="n">headers_dict</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
+</span><span id="1-657">                <span class="k">if</span> <span class="n">k</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span> <span class="o">==</span> <span class="s2">&quot;user-agent&quot;</span><span class="p">:</span>
+</span><span id="1-658">                    <span class="n">user_agent</span> <span class="o">=</span> <span class="n">v</span>
+</span><span id="1-659">                    <span class="k">break</span>
+</span><span id="1-660">
+</span><span id="1-661">        <span class="n">session</span><span class="o">.</span><span class="n">update</span><span class="p">(</span>
+</span><span id="1-662">            <span class="n">status</span><span class="o">=</span><span class="s2">&quot;crashed&quot;</span> <span class="k">if</span> <span class="n">crashed</span> <span class="k">else</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="1-663">            <span class="n">user</span><span class="o">=</span><span class="n">user</span><span class="p">,</span>
+</span><span id="1-664">            <span class="n">user_agent</span><span class="o">=</span><span class="n">user_agent</span><span class="p">,</span>
+</span><span id="1-665">            <span class="n">errors</span><span class="o">=</span><span class="n">session</span><span class="o">.</span><span class="n">errors</span> <span class="o">+</span> <span class="p">(</span><span class="n">errored</span> <span class="ow">or</span> <span class="n">crashed</span><span class="p">),</span>
+</span><span id="1-666">        <span class="p">)</span>
+</span><span id="1-667">
+<div class="viewcode-block" id="_Client.capture_event">
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk._Client.capture_event">[docs]</a>
+</span><span id="1-668">    <span class="k">def</span> <span class="nf">capture_event</span><span class="p">(</span>
+</span><span id="1-669">        <span class="bp">self</span><span class="p">,</span>
+</span><span id="1-670">        <span class="n">event</span><span class="p">,</span>  <span class="c1"># type: Event</span>
+</span><span id="1-671">        <span class="n">hint</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Hint]</span>
+</span><span id="1-672">        <span class="n">scope</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Scope]</span>
+</span><span id="1-673">    <span class="p">):</span>
+</span><span id="1-674">        <span class="c1"># type: (...) -&gt; Optional[str]</span>
+</span><span id="1-675"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Captures an event.</span>
+</span><span id="1-676">
+</span><span id="1-677"><span class="sd">        :param event: A ready-made event that can be directly sent to Sentry.</span>
+</span><span id="1-678">
+</span><span id="1-679"><span class="sd">        :param hint: Contains metadata about the event that can be read from `before_send`, such as the original exception object or a HTTP request object.</span>
+</span><span id="1-680">
+</span><span id="1-681"><span class="sd">        :param scope: An optional :py:class:`sentry_sdk.Scope` to apply to events.</span>
 </span><span id="1-682">
-</span><span id="1-683">            <span class="k">for</span> <span class="n">attachment</span> <span class="ow">in</span> <span class="n">attachments</span> <span class="ow">or</span> <span class="p">():</span>
-</span><span id="1-684">                <span class="n">envelope</span><span class="o">.</span><span class="n">add_item</span><span class="p">(</span><span class="n">attachment</span><span class="o">.</span><span class="n">to_envelope_item</span><span class="p">())</span>
-</span><span id="1-685">
-</span><span id="1-686">            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">spotlight</span><span class="p">:</span>
-</span><span id="1-687">                <span class="bp">self</span><span class="o">.</span><span class="n">spotlight</span><span class="o">.</span><span class="n">capture_envelope</span><span class="p">(</span><span class="n">envelope</span><span class="p">)</span>
-</span><span id="1-688">
-</span><span id="1-689">            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">transport</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-690">                <span class="k">return</span> <span class="kc">None</span>
-</span><span id="1-691">
-</span><span id="1-692">            <span class="bp">self</span><span class="o">.</span><span class="n">transport</span><span class="o">.</span><span class="n">capture_envelope</span><span class="p">(</span><span class="n">envelope</span><span class="p">)</span>
-</span><span id="1-693">
-</span><span id="1-694">        <span class="k">else</span><span class="p">:</span>
-</span><span id="1-695">            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">transport</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-696">                <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-683"><span class="sd">        :returns: An event ID. May be `None` if there is no DSN set or of if the SDK decided to discard the event for other reasons. In such situations setting `debug=True` on `init()` may help.</span>
+</span><span id="1-684"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-685">        <span class="k">if</span> <span class="n">disable_capture_event</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="kc">False</span><span class="p">):</span>
+</span><span id="1-686">            <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-687">
+</span><span id="1-688">        <span class="k">if</span> <span class="n">hint</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-689">            <span class="n">hint</span> <span class="o">=</span> <span class="p">{}</span>
+</span><span id="1-690">        <span class="n">event_id</span> <span class="o">=</span> <span class="n">event</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;event_id&quot;</span><span class="p">)</span>
+</span><span id="1-691">        <span class="n">hint</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="n">hint</span> <span class="ow">or</span> <span class="p">())</span>  <span class="c1"># type: Hint</span>
+</span><span id="1-692">
+</span><span id="1-693">        <span class="k">if</span> <span class="n">event_id</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-694">            <span class="n">event</span><span class="p">[</span><span class="s2">&quot;event_id&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">event_id</span> <span class="o">=</span> <span class="n">uuid</span><span class="o">.</span><span class="n">uuid4</span><span class="p">()</span><span class="o">.</span><span class="n">hex</span>
+</span><span id="1-695">        <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_should_capture</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">scope</span><span class="p">):</span>
+</span><span id="1-696">            <span class="k">return</span> <span class="kc">None</span>
 </span><span id="1-697">
-</span><span id="1-698">            <span class="c1"># All other events go to the legacy /store/ endpoint (will be removed in the future).</span>
-</span><span id="1-699">            <span class="bp">self</span><span class="o">.</span><span class="n">transport</span><span class="o">.</span><span class="n">capture_event</span><span class="p">(</span><span class="n">event_opt</span><span class="p">)</span>
-</span><span id="1-700">
-</span><span id="1-701">        <span class="k">return</span> <span class="n">event_id</span></div>
+</span><span id="1-698">        <span class="n">profile</span> <span class="o">=</span> <span class="n">event</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s2">&quot;profile&quot;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
+</span><span id="1-699">
+</span><span id="1-700">        <span class="n">event_opt</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_prepare_event</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">scope</span><span class="p">)</span>
+</span><span id="1-701">        <span class="k">if</span> <span class="n">event_opt</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-702">            <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-703">
+</span><span id="1-704">        <span class="c1"># whenever we capture an event we also check if the session needs</span>
+</span><span id="1-705">        <span class="c1"># to be updated based on that information.</span>
+</span><span id="1-706">        <span class="n">session</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">_session</span> <span class="k">if</span> <span class="n">scope</span> <span class="k">else</span> <span class="kc">None</span>
+</span><span id="1-707">        <span class="k">if</span> <span class="n">session</span><span class="p">:</span>
+</span><span id="1-708">            <span class="bp">self</span><span class="o">.</span><span class="n">_update_session_from_event</span><span class="p">(</span><span class="n">session</span><span class="p">,</span> <span class="n">event</span><span class="p">)</span>
+</span><span id="1-709">
+</span><span id="1-710">        <span class="n">is_transaction</span> <span class="o">=</span> <span class="n">event_opt</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;type&quot;</span><span class="p">)</span> <span class="o">==</span> <span class="s2">&quot;transaction&quot;</span>
+</span><span id="1-711">        <span class="n">is_checkin</span> <span class="o">=</span> <span class="n">event_opt</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;type&quot;</span><span class="p">)</span> <span class="o">==</span> <span class="s2">&quot;check_in&quot;</span>
+</span><span id="1-712">
+</span><span id="1-713">        <span class="k">if</span> <span class="p">(</span>
+</span><span id="1-714">            <span class="ow">not</span> <span class="n">is_transaction</span>
+</span><span id="1-715">            <span class="ow">and</span> <span class="ow">not</span> <span class="n">is_checkin</span>
+</span><span id="1-716">            <span class="ow">and</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_should_sample_error</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">)</span>
+</span><span id="1-717">        <span class="p">):</span>
+</span><span id="1-718">            <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-719">
+</span><span id="1-720">        <span class="n">attachments</span> <span class="o">=</span> <span class="n">hint</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;attachments&quot;</span><span class="p">)</span>
+</span><span id="1-721">
+</span><span id="1-722">        <span class="n">trace_context</span> <span class="o">=</span> <span class="n">event_opt</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;contexts&quot;</span><span class="p">,</span> <span class="p">{})</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;trace&quot;</span><span class="p">)</span> <span class="ow">or</span> <span class="p">{}</span>
+</span><span id="1-723">        <span class="n">dynamic_sampling_context</span> <span class="o">=</span> <span class="n">trace_context</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s2">&quot;dynamic_sampling_context&quot;</span><span class="p">,</span> <span class="p">{})</span>
+</span><span id="1-724">
+</span><span id="1-725">        <span class="n">headers</span> <span class="o">=</span> <span class="p">{</span>
+</span><span id="1-726">            <span class="s2">&quot;event_id&quot;</span><span class="p">:</span> <span class="n">event_opt</span><span class="p">[</span><span class="s2">&quot;event_id&quot;</span><span class="p">],</span>
+</span><span id="1-727">            <span class="s2">&quot;sent_at&quot;</span><span class="p">:</span> <span class="n">format_timestamp</span><span class="p">(</span><span class="n">datetime</span><span class="o">.</span><span class="n">now</span><span class="p">(</span><span class="n">timezone</span><span class="o">.</span><span class="n">utc</span><span class="p">)),</span>
+</span><span id="1-728">        <span class="p">}</span>  <span class="c1"># type: dict[str, object]</span>
+</span><span id="1-729">
+</span><span id="1-730">        <span class="k">if</span> <span class="n">dynamic_sampling_context</span><span class="p">:</span>
+</span><span id="1-731">            <span class="n">headers</span><span class="p">[</span><span class="s2">&quot;trace&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">dynamic_sampling_context</span>
+</span><span id="1-732">
+</span><span id="1-733">        <span class="n">envelope</span> <span class="o">=</span> <span class="n">Envelope</span><span class="p">(</span><span class="n">headers</span><span class="o">=</span><span class="n">headers</span><span class="p">)</span>
+</span><span id="1-734">
+</span><span id="1-735">        <span class="k">if</span> <span class="n">is_transaction</span><span class="p">:</span>
+</span><span id="1-736">            <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">profile</span><span class="p">,</span> <span class="n">Profile</span><span class="p">):</span>
+</span><span id="1-737">                <span class="n">envelope</span><span class="o">.</span><span class="n">add_profile</span><span class="p">(</span><span class="n">profile</span><span class="o">.</span><span class="n">to_json</span><span class="p">(</span><span class="n">event_opt</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">))</span>
+</span><span id="1-738">            <span class="n">envelope</span><span class="o">.</span><span class="n">add_transaction</span><span class="p">(</span><span class="n">event_opt</span><span class="p">)</span>
+</span><span id="1-739">        <span class="k">elif</span> <span class="n">is_checkin</span><span class="p">:</span>
+</span><span id="1-740">            <span class="n">envelope</span><span class="o">.</span><span class="n">add_checkin</span><span class="p">(</span><span class="n">event_opt</span><span class="p">)</span>
+</span><span id="1-741">        <span class="k">else</span><span class="p">:</span>
+</span><span id="1-742">            <span class="n">envelope</span><span class="o">.</span><span class="n">add_event</span><span class="p">(</span><span class="n">event_opt</span><span class="p">)</span>
+</span><span id="1-743">
+</span><span id="1-744">        <span class="k">for</span> <span class="n">attachment</span> <span class="ow">in</span> <span class="n">attachments</span> <span class="ow">or</span> <span class="p">():</span>
+</span><span id="1-745">            <span class="n">envelope</span><span class="o">.</span><span class="n">add_item</span><span class="p">(</span><span class="n">attachment</span><span class="o">.</span><span class="n">to_envelope_item</span><span class="p">())</span>
+</span><span id="1-746">
+</span><span id="1-747">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">spotlight</span><span class="p">:</span>
+</span><span id="1-748">            <span class="bp">self</span><span class="o">.</span><span class="n">spotlight</span><span class="o">.</span><span class="n">capture_envelope</span><span class="p">(</span><span class="n">envelope</span><span class="p">)</span>
+</span><span id="1-749">
+</span><span id="1-750">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">transport</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-751">            <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-752">
+</span><span id="1-753">        <span class="bp">self</span><span class="o">.</span><span class="n">transport</span><span class="o">.</span><span class="n">capture_envelope</span><span class="p">(</span><span class="n">envelope</span><span class="p">)</span>
+</span><span id="1-754">
+</span><span id="1-755">        <span class="k">return</span> <span class="n">event_id</span></div>
 
-</span><span id="1-702">
-</span><span id="1-703">    <span class="k">def</span> <span class="nf">capture_session</span><span class="p">(</span>
-</span><span id="1-704">        <span class="bp">self</span><span class="p">,</span> <span class="n">session</span>  <span class="c1"># type: Session</span>
-</span><span id="1-705">    <span class="p">):</span>
-</span><span id="1-706">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-707">        <span class="k">if</span> <span class="ow">not</span> <span class="n">session</span><span class="o">.</span><span class="n">release</span><span class="p">:</span>
-</span><span id="1-708">            <span class="n">logger</span><span class="o">.</span><span class="n">info</span><span class="p">(</span><span class="s2">&quot;Discarded session update because of missing release&quot;</span><span class="p">)</span>
-</span><span id="1-709">        <span class="k">else</span><span class="p">:</span>
-</span><span id="1-710">            <span class="bp">self</span><span class="o">.</span><span class="n">session_flusher</span><span class="o">.</span><span class="n">add_session</span><span class="p">(</span><span class="n">session</span><span class="p">)</span>
-</span><span id="1-711">
+</span><span id="1-756">
+</span><span id="1-757">    <span class="k">def</span> <span class="nf">capture_session</span><span class="p">(</span>
+</span><span id="1-758">        <span class="bp">self</span><span class="p">,</span> <span class="n">session</span>  <span class="c1"># type: Session</span>
+</span><span id="1-759">    <span class="p">):</span>
+</span><span id="1-760">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-761">        <span class="k">if</span> <span class="ow">not</span> <span class="n">session</span><span class="o">.</span><span class="n">release</span><span class="p">:</span>
+</span><span id="1-762">            <span class="n">logger</span><span class="o">.</span><span class="n">info</span><span class="p">(</span><span class="s2">&quot;Discarded session update because of missing release&quot;</span><span class="p">)</span>
+</span><span id="1-763">        <span class="k">else</span><span class="p">:</span>
+</span><span id="1-764">            <span class="bp">self</span><span class="o">.</span><span class="n">session_flusher</span><span class="o">.</span><span class="n">add_session</span><span class="p">(</span><span class="n">session</span><span class="p">)</span>
+</span><span id="1-765">
 <div class="viewcode-block" id="_Client.get_integration">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk._Client.get_integration">[docs]</a>
-</span><span id="1-712">    <span class="k">def</span> <span class="nf">get_integration</span><span class="p">(</span>
-</span><span id="1-713">        <span class="bp">self</span><span class="p">,</span> <span class="n">name_or_class</span>  <span class="c1"># type: Union[str, Type[Integration]]</span>
-</span><span id="1-714">    <span class="p">):</span>
-</span><span id="1-715">        <span class="c1"># type: (...) -&gt; Any</span>
-</span><span id="1-716"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Returns the integration for this client by name or class.</span>
-</span><span id="1-717"><span class="sd">        If the client does not have that integration then `None` is returned.</span>
-</span><span id="1-718"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-719">        <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">name_or_class</span><span class="p">,</span> <span class="nb">str</span><span class="p">):</span>
-</span><span id="1-720">            <span class="n">integration_name</span> <span class="o">=</span> <span class="n">name_or_class</span>
-</span><span id="1-721">        <span class="k">elif</span> <span class="n">name_or_class</span><span class="o">.</span><span class="n">identifier</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-722">            <span class="n">integration_name</span> <span class="o">=</span> <span class="n">name_or_class</span><span class="o">.</span><span class="n">identifier</span>
-</span><span id="1-723">        <span class="k">else</span><span class="p">:</span>
-</span><span id="1-724">            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">&quot;Integration has no name&quot;</span><span class="p">)</span>
-</span><span id="1-725">
-</span><span id="1-726">        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">integrations</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">integration_name</span><span class="p">)</span></div>
+</span><span id="1-766">    <span class="k">def</span> <span class="nf">get_integration</span><span class="p">(</span>
+</span><span id="1-767">        <span class="bp">self</span><span class="p">,</span> <span class="n">name_or_class</span>  <span class="c1"># type: Union[str, Type[Integration]]</span>
+</span><span id="1-768">    <span class="p">):</span>
+</span><span id="1-769">        <span class="c1"># type: (...) -&gt; Any</span>
+</span><span id="1-770"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Returns the integration for this client by name or class.</span>
+</span><span id="1-771"><span class="sd">        If the client does not have that integration then `None` is returned.</span>
+</span><span id="1-772"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-773">        <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">name_or_class</span><span class="p">,</span> <span class="nb">str</span><span class="p">):</span>
+</span><span id="1-774">            <span class="n">integration_name</span> <span class="o">=</span> <span class="n">name_or_class</span>
+</span><span id="1-775">        <span class="k">elif</span> <span class="n">name_or_class</span><span class="o">.</span><span class="n">identifier</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-776">            <span class="n">integration_name</span> <span class="o">=</span> <span class="n">name_or_class</span><span class="o">.</span><span class="n">identifier</span>
+</span><span id="1-777">        <span class="k">else</span><span class="p">:</span>
+</span><span id="1-778">            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">&quot;Integration has no name&quot;</span><span class="p">)</span>
+</span><span id="1-779">
+</span><span id="1-780">        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">integrations</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">integration_name</span><span class="p">)</span></div>
 
-</span><span id="1-727">
+</span><span id="1-781">
 <div class="viewcode-block" id="_Client.close">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk._Client.close">[docs]</a>
-</span><span id="1-728">    <span class="k">def</span> <span class="nf">close</span><span class="p">(</span>
-</span><span id="1-729">        <span class="bp">self</span><span class="p">,</span>
-</span><span id="1-730">        <span class="n">timeout</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[float]</span>
-</span><span id="1-731">        <span class="n">callback</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Callable[[int, float], None]]</span>
-</span><span id="1-732">    <span class="p">):</span>
-</span><span id="1-733">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-734"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-735"><span class="sd">        Close the client and shut down the transport. Arguments have the same</span>
-</span><span id="1-736"><span class="sd">        semantics as :py:meth:`Client.flush`.</span>
-</span><span id="1-737"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-738">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">transport</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-739">            <span class="bp">self</span><span class="o">.</span><span class="n">flush</span><span class="p">(</span><span class="n">timeout</span><span class="o">=</span><span class="n">timeout</span><span class="p">,</span> <span class="n">callback</span><span class="o">=</span><span class="n">callback</span><span class="p">)</span>
-</span><span id="1-740">            <span class="bp">self</span><span class="o">.</span><span class="n">session_flusher</span><span class="o">.</span><span class="n">kill</span><span class="p">()</span>
-</span><span id="1-741">            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">metrics_aggregator</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-742">                <span class="bp">self</span><span class="o">.</span><span class="n">metrics_aggregator</span><span class="o">.</span><span class="n">kill</span><span class="p">()</span>
-</span><span id="1-743">            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">monitor</span><span class="p">:</span>
-</span><span id="1-744">                <span class="bp">self</span><span class="o">.</span><span class="n">monitor</span><span class="o">.</span><span class="n">kill</span><span class="p">()</span>
-</span><span id="1-745">            <span class="bp">self</span><span class="o">.</span><span class="n">transport</span><span class="o">.</span><span class="n">kill</span><span class="p">()</span>
-</span><span id="1-746">            <span class="bp">self</span><span class="o">.</span><span class="n">transport</span> <span class="o">=</span> <span class="kc">None</span></div>
+</span><span id="1-782">    <span class="k">def</span> <span class="nf">close</span><span class="p">(</span>
+</span><span id="1-783">        <span class="bp">self</span><span class="p">,</span>
+</span><span id="1-784">        <span class="n">timeout</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[float]</span>
+</span><span id="1-785">        <span class="n">callback</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Callable[[int, float], None]]</span>
+</span><span id="1-786">    <span class="p">):</span>
+</span><span id="1-787">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-788"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-789"><span class="sd">        Close the client and shut down the transport. Arguments have the same</span>
+</span><span id="1-790"><span class="sd">        semantics as :py:meth:`Client.flush`.</span>
+</span><span id="1-791"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-792">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">transport</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-793">            <span class="bp">self</span><span class="o">.</span><span class="n">flush</span><span class="p">(</span><span class="n">timeout</span><span class="o">=</span><span class="n">timeout</span><span class="p">,</span> <span class="n">callback</span><span class="o">=</span><span class="n">callback</span><span class="p">)</span>
+</span><span id="1-794">            <span class="bp">self</span><span class="o">.</span><span class="n">session_flusher</span><span class="o">.</span><span class="n">kill</span><span class="p">()</span>
+</span><span id="1-795">            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">metrics_aggregator</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-796">                <span class="bp">self</span><span class="o">.</span><span class="n">metrics_aggregator</span><span class="o">.</span><span class="n">kill</span><span class="p">()</span>
+</span><span id="1-797">            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">monitor</span><span class="p">:</span>
+</span><span id="1-798">                <span class="bp">self</span><span class="o">.</span><span class="n">monitor</span><span class="o">.</span><span class="n">kill</span><span class="p">()</span>
+</span><span id="1-799">            <span class="bp">self</span><span class="o">.</span><span class="n">transport</span><span class="o">.</span><span class="n">kill</span><span class="p">()</span>
+</span><span id="1-800">            <span class="bp">self</span><span class="o">.</span><span class="n">transport</span> <span class="o">=</span> <span class="kc">None</span></div>
 
-</span><span id="1-747">
+</span><span id="1-801">
 <div class="viewcode-block" id="_Client.flush">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk._Client.flush">[docs]</a>
-</span><span id="1-748">    <span class="k">def</span> <span class="nf">flush</span><span class="p">(</span>
-</span><span id="1-749">        <span class="bp">self</span><span class="p">,</span>
-</span><span id="1-750">        <span class="n">timeout</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[float]</span>
-</span><span id="1-751">        <span class="n">callback</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Callable[[int, float], None]]</span>
-</span><span id="1-752">    <span class="p">):</span>
-</span><span id="1-753">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-754"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-755"><span class="sd">        Wait for the current events to be sent.</span>
-</span><span id="1-756">
-</span><span id="1-757"><span class="sd">        :param timeout: Wait for at most `timeout` seconds. If no `timeout` is provided, the `shutdown_timeout` option value is used.</span>
-</span><span id="1-758">
-</span><span id="1-759"><span class="sd">        :param callback: Is invoked with the number of pending events and the configured timeout.</span>
-</span><span id="1-760"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-761">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">transport</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-762">            <span class="k">if</span> <span class="n">timeout</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-763">                <span class="n">timeout</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;shutdown_timeout&quot;</span><span class="p">]</span>
-</span><span id="1-764">            <span class="bp">self</span><span class="o">.</span><span class="n">session_flusher</span><span class="o">.</span><span class="n">flush</span><span class="p">()</span>
-</span><span id="1-765">            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">metrics_aggregator</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-766">                <span class="bp">self</span><span class="o">.</span><span class="n">metrics_aggregator</span><span class="o">.</span><span class="n">flush</span><span class="p">()</span>
-</span><span id="1-767">            <span class="bp">self</span><span class="o">.</span><span class="n">transport</span><span class="o">.</span><span class="n">flush</span><span class="p">(</span><span class="n">timeout</span><span class="o">=</span><span class="n">timeout</span><span class="p">,</span> <span class="n">callback</span><span class="o">=</span><span class="n">callback</span><span class="p">)</span></div>
+</span><span id="1-802">    <span class="k">def</span> <span class="nf">flush</span><span class="p">(</span>
+</span><span id="1-803">        <span class="bp">self</span><span class="p">,</span>
+</span><span id="1-804">        <span class="n">timeout</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[float]</span>
+</span><span id="1-805">        <span class="n">callback</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Callable[[int, float], None]]</span>
+</span><span id="1-806">    <span class="p">):</span>
+</span><span id="1-807">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-808"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-809"><span class="sd">        Wait for the current events to be sent.</span>
+</span><span id="1-810">
+</span><span id="1-811"><span class="sd">        :param timeout: Wait for at most `timeout` seconds. If no `timeout` is provided, the `shutdown_timeout` option value is used.</span>
+</span><span id="1-812">
+</span><span id="1-813"><span class="sd">        :param callback: Is invoked with the number of pending events and the configured timeout.</span>
+</span><span id="1-814"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-815">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">transport</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-816">            <span class="k">if</span> <span class="n">timeout</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-817">                <span class="n">timeout</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;shutdown_timeout&quot;</span><span class="p">]</span>
+</span><span id="1-818">            <span class="bp">self</span><span class="o">.</span><span class="n">session_flusher</span><span class="o">.</span><span class="n">flush</span><span class="p">()</span>
+</span><span id="1-819">            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">metrics_aggregator</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-820">                <span class="bp">self</span><span class="o">.</span><span class="n">metrics_aggregator</span><span class="o">.</span><span class="n">flush</span><span class="p">()</span>
+</span><span id="1-821">            <span class="bp">self</span><span class="o">.</span><span class="n">transport</span><span class="o">.</span><span class="n">flush</span><span class="p">(</span><span class="n">timeout</span><span class="o">=</span><span class="n">timeout</span><span class="p">,</span> <span class="n">callback</span><span class="o">=</span><span class="n">callback</span><span class="p">)</span></div>
 
-</span><span id="1-768">
-</span><span id="1-769">    <span class="k">def</span> <span class="fm">__enter__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-770">        <span class="c1"># type: () -&gt; _Client</span>
-</span><span id="1-771">        <span class="k">return</span> <span class="bp">self</span>
-</span><span id="1-772">
-</span><span id="1-773">    <span class="k">def</span> <span class="fm">__exit__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">exc_type</span><span class="p">,</span> <span class="n">exc_value</span><span class="p">,</span> <span class="n">tb</span><span class="p">):</span>
-</span><span id="1-774">        <span class="c1"># type: (Any, Any, Any) -&gt; None</span>
-</span><span id="1-775">        <span class="bp">self</span><span class="o">.</span><span class="n">close</span><span class="p">()</span></div>
+</span><span id="1-822">
+</span><span id="1-823">    <span class="k">def</span> <span class="fm">__enter__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-824">        <span class="c1"># type: () -&gt; _Client</span>
+</span><span id="1-825">        <span class="k">return</span> <span class="bp">self</span>
+</span><span id="1-826">
+</span><span id="1-827">    <span class="k">def</span> <span class="fm">__exit__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">exc_type</span><span class="p">,</span> <span class="n">exc_value</span><span class="p">,</span> <span class="n">tb</span><span class="p">):</span>
+</span><span id="1-828">        <span class="c1"># type: (Any, Any, Any) -&gt; None</span>
+</span><span id="1-829">        <span class="bp">self</span><span class="o">.</span><span class="n">close</span><span class="p">()</span></div>
 
-</span><span id="1-776">
-</span><span id="1-777">
-</span><span id="1-778"><span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="n">TYPE_CHECKING</span>
-</span><span id="1-779">
-</span><span id="1-780"><span class="k">if</span> <span class="n">TYPE_CHECKING</span><span class="p">:</span>
-</span><span id="1-781">    <span class="c1"># Make mypy, PyCharm and other static analyzers think `get_options` is a</span>
-</span><span id="1-782">    <span class="c1"># type to have nicer autocompletion for params.</span>
-</span><span id="1-783">    <span class="c1">#</span>
-</span><span id="1-784">    <span class="c1"># Use `ClientConstructor` to define the argument types of `init` and</span>
-</span><span id="1-785">    <span class="c1"># `Dict[str, Any]` to tell static analyzers about the return type.</span>
-</span><span id="1-786">
-</span><span id="1-787">    <span class="k">class</span> <span class="nc">get_options</span><span class="p">(</span><span class="n">ClientConstructor</span><span class="p">,</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]):</span>  <span class="c1"># noqa: N801</span>
-</span><span id="1-788">        <span class="k">pass</span>
-</span><span id="1-789">
+</span><span id="1-830">
+</span><span id="1-831">
+</span><span id="1-832"><span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="n">TYPE_CHECKING</span>
+</span><span id="1-833">
+</span><span id="1-834"><span class="k">if</span> <span class="n">TYPE_CHECKING</span><span class="p">:</span>
+</span><span id="1-835">    <span class="c1"># Make mypy, PyCharm and other static analyzers think `get_options` is a</span>
+</span><span id="1-836">    <span class="c1"># type to have nicer autocompletion for params.</span>
+</span><span id="1-837">    <span class="c1">#</span>
+</span><span id="1-838">    <span class="c1"># Use `ClientConstructor` to define the argument types of `init` and</span>
+</span><span id="1-839">    <span class="c1"># `Dict[str, Any]` to tell static analyzers about the return type.</span>
+</span><span id="1-840">
+</span><span id="1-841">    <span class="k">class</span> <span class="nc">get_options</span><span class="p">(</span><span class="n">ClientConstructor</span><span class="p">,</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]):</span>  <span class="c1"># noqa: N801</span>
+</span><span id="1-842">        <span class="k">pass</span>
+</span><span id="1-843">
 <div class="viewcode-block" id="Client">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Client">[docs]</a>
-</span><span id="1-790">    <span class="k">class</span> <span class="nc">Client</span><span class="p">(</span><span class="n">ClientConstructor</span><span class="p">,</span> <span class="n">_Client</span><span class="p">):</span>
-</span><span id="1-791">        <span class="k">pass</span></div>
+</span><span id="1-844">    <span class="k">class</span> <span class="nc">Client</span><span class="p">(</span><span class="n">ClientConstructor</span><span class="p">,</span> <span class="n">_Client</span><span class="p">):</span>
+</span><span id="1-845">        <span class="k">pass</span></div>
 
-</span><span id="1-792">
-</span><span id="1-793"><span class="k">else</span><span class="p">:</span>
-</span><span id="1-794">    <span class="c1"># Alias `get_options` for actual usage. Go through the lambda indirection</span>
-</span><span id="1-795">    <span class="c1"># to throw PyCharm off of the weakly typed signature (it would otherwise</span>
-</span><span id="1-796">    <span class="c1"># discover both the weakly typed signature of `_init` and our faked `init`</span>
-</span><span id="1-797">    <span class="c1"># type).</span>
-</span><span id="1-798">
-</span><span id="1-799">    <span class="n">get_options</span> <span class="o">=</span> <span class="p">(</span><span class="k">lambda</span><span class="p">:</span> <span class="n">_get_options</span><span class="p">)()</span>
-</span><span id="1-800">    <span class="n">Client</span> <span class="o">=</span> <span class="p">(</span><span class="k">lambda</span><span class="p">:</span> <span class="n">_Client</span><span class="p">)()</span>
+</span><span id="1-846">
+</span><span id="1-847"><span class="k">else</span><span class="p">:</span>
+</span><span id="1-848">    <span class="c1"># Alias `get_options` for actual usage. Go through the lambda indirection</span>
+</span><span id="1-849">    <span class="c1"># to throw PyCharm off of the weakly typed signature (it would otherwise</span>
+</span><span id="1-850">    <span class="c1"># discover both the weakly typed signature of `_init` and our faked `init`</span>
+</span><span id="1-851">    <span class="c1"># type).</span>
+</span><span id="1-852">
+</span><span id="1-853">    <span class="n">get_options</span> <span class="o">=</span> <span class="p">(</span><span class="k">lambda</span><span class="p">:</span> <span class="n">_get_options</span><span class="p">)()</span>
+</span><span id="1-854">    <span class="n">Client</span> <span class="o">=</span> <span class="p">(</span><span class="k">lambda</span><span class="p">:</span> <span class="n">_Client</span><span class="p">)()</span>
 </span></pre></div>
         </article>
         
@@ -982,7 +1051,7 @@ <h1>Source code for sentry_sdk.client</h1><div class="highlight"><pre>
     </div>
   </div>
 </footer></div>
-      <script src="../../_static/documentation_options.js?v=fca6d697"></script>
+      <script src="../../_static/documentation_options.js?v=aa9da443"></script>
       <script src="../../_static/doctools.js?v=888ff710"></script>
       <script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
       <script src="../../_static/shibuya.js?v=999236dc"></script>
diff --git a/_modules/sentry_sdk/envelope.html b/_modules/sentry_sdk/envelope.html
index 3593c3a5cc..defcb5355e 100644
--- a/_modules/sentry_sdk/envelope.html
+++ b/_modules/sentry_sdk/envelope.html
@@ -4,7 +4,7 @@
 <head>
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-      <title>sentry_sdk.envelope - sentry-python 1.44.1 documentation</title>
+      <title>sentry_sdk.envelope - sentry-python 2.0.0rc4 documentation</title>
     <link rel="index" title="Index" href="../../genindex.html" /><link rel="search" title="Search" href="../../search.html" />
 
   <script>
@@ -136,345 +136,350 @@ <h1>Source code for sentry_sdk.envelope</h1><div class="highlight"><pre>
 </span><span id="1-2"><span class="kn">import</span> <span class="nn">json</span>
 </span><span id="1-3"><span class="kn">import</span> <span class="nn">mimetypes</span>
 </span><span id="1-4">
-</span><span id="1-5"><span class="kn">from</span> <span class="nn">sentry_sdk._compat</span> <span class="kn">import</span> <span class="n">text_type</span><span class="p">,</span> <span class="n">PY2</span>
-</span><span id="1-6"><span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="n">TYPE_CHECKING</span>
-</span><span id="1-7"><span class="kn">from</span> <span class="nn">sentry_sdk.session</span> <span class="kn">import</span> <span class="n">Session</span>
-</span><span id="1-8"><span class="kn">from</span> <span class="nn">sentry_sdk.utils</span> <span class="kn">import</span> <span class="n">json_dumps</span><span class="p">,</span> <span class="n">capture_internal_exceptions</span>
-</span><span id="1-9">
-</span><span id="1-10"><span class="k">if</span> <span class="n">TYPE_CHECKING</span><span class="p">:</span>
-</span><span id="1-11">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Any</span>
-</span><span id="1-12">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Optional</span>
-</span><span id="1-13">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Union</span>
-</span><span id="1-14">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Dict</span>
-</span><span id="1-15">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">List</span>
-</span><span id="1-16">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Iterator</span>
-</span><span id="1-17">
-</span><span id="1-18">    <span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="n">Event</span><span class="p">,</span> <span class="n">EventDataCategory</span>
+</span><span id="1-5"><span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="n">TYPE_CHECKING</span>
+</span><span id="1-6"><span class="kn">from</span> <span class="nn">sentry_sdk.session</span> <span class="kn">import</span> <span class="n">Session</span>
+</span><span id="1-7"><span class="kn">from</span> <span class="nn">sentry_sdk.utils</span> <span class="kn">import</span> <span class="n">json_dumps</span><span class="p">,</span> <span class="n">capture_internal_exceptions</span>
+</span><span id="1-8">
+</span><span id="1-9"><span class="k">if</span> <span class="n">TYPE_CHECKING</span><span class="p">:</span>
+</span><span id="1-10">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Any</span>
+</span><span id="1-11">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Optional</span>
+</span><span id="1-12">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Union</span>
+</span><span id="1-13">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Dict</span>
+</span><span id="1-14">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">List</span>
+</span><span id="1-15">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Iterator</span>
+</span><span id="1-16">
+</span><span id="1-17">    <span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="n">Event</span><span class="p">,</span> <span class="n">EventDataCategory</span>
+</span><span id="1-18">
 </span><span id="1-19">
-</span><span id="1-20">
-</span><span id="1-21"><span class="k">def</span> <span class="nf">parse_json</span><span class="p">(</span><span class="n">data</span><span class="p">):</span>
-</span><span id="1-22">    <span class="c1"># type: (Union[bytes, text_type]) -&gt; Any</span>
-</span><span id="1-23">    <span class="c1"># on some python 3 versions this needs to be bytes</span>
-</span><span id="1-24">    <span class="k">if</span> <span class="ow">not</span> <span class="n">PY2</span> <span class="ow">and</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">data</span><span class="p">,</span> <span class="nb">bytes</span><span class="p">):</span>
-</span><span id="1-25">        <span class="n">data</span> <span class="o">=</span> <span class="n">data</span><span class="o">.</span><span class="n">decode</span><span class="p">(</span><span class="s2">&quot;utf-8&quot;</span><span class="p">,</span> <span class="s2">&quot;replace&quot;</span><span class="p">)</span>
-</span><span id="1-26">    <span class="k">return</span> <span class="n">json</span><span class="o">.</span><span class="n">loads</span><span class="p">(</span><span class="n">data</span><span class="p">)</span>
+</span><span id="1-20"><span class="k">def</span> <span class="nf">parse_json</span><span class="p">(</span><span class="n">data</span><span class="p">):</span>
+</span><span id="1-21">    <span class="c1"># type: (Union[bytes, str]) -&gt; Any</span>
+</span><span id="1-22">    <span class="c1"># on some python 3 versions this needs to be bytes</span>
+</span><span id="1-23">    <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">data</span><span class="p">,</span> <span class="nb">bytes</span><span class="p">):</span>
+</span><span id="1-24">        <span class="n">data</span> <span class="o">=</span> <span class="n">data</span><span class="o">.</span><span class="n">decode</span><span class="p">(</span><span class="s2">&quot;utf-8&quot;</span><span class="p">,</span> <span class="s2">&quot;replace&quot;</span><span class="p">)</span>
+</span><span id="1-25">    <span class="k">return</span> <span class="n">json</span><span class="o">.</span><span class="n">loads</span><span class="p">(</span><span class="n">data</span><span class="p">)</span>
+</span><span id="1-26">
 </span><span id="1-27">
-</span><span id="1-28">
 <div class="viewcode-block" id="Envelope">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.envelope.Envelope">[docs]</a>
-</span><span id="1-29"><span class="k">class</span> <span class="nc">Envelope</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-</span><span id="1-30">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
-</span><span id="1-31">        <span class="bp">self</span><span class="p">,</span>
-</span><span id="1-32">        <span class="n">headers</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Dict[str, Any]]</span>
-</span><span id="1-33">        <span class="n">items</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[List[Item]]</span>
-</span><span id="1-34">    <span class="p">):</span>
-</span><span id="1-35">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-36">        <span class="k">if</span> <span class="n">headers</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-37">            <span class="n">headers</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="n">headers</span><span class="p">)</span>
-</span><span id="1-38">        <span class="bp">self</span><span class="o">.</span><span class="n">headers</span> <span class="o">=</span> <span class="n">headers</span> <span class="ow">or</span> <span class="p">{}</span>
-</span><span id="1-39">        <span class="k">if</span> <span class="n">items</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-40">            <span class="n">items</span> <span class="o">=</span> <span class="p">[]</span>
-</span><span id="1-41">        <span class="k">else</span><span class="p">:</span>
-</span><span id="1-42">            <span class="n">items</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="n">items</span><span class="p">)</span>
-</span><span id="1-43">        <span class="bp">self</span><span class="o">.</span><span class="n">items</span> <span class="o">=</span> <span class="n">items</span>
-</span><span id="1-44">
-</span><span id="1-45">    <span class="nd">@property</span>
-</span><span id="1-46">    <span class="k">def</span> <span class="nf">description</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-47">        <span class="c1"># type: (...) -&gt; str</span>
-</span><span id="1-48">        <span class="k">return</span> <span class="s2">&quot;envelope with </span><span class="si">%s</span><span class="s2"> items (</span><span class="si">%s</span><span class="s2">)&quot;</span> <span class="o">%</span> <span class="p">(</span>
-</span><span id="1-49">            <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">items</span><span class="p">),</span>
-</span><span id="1-50">            <span class="s2">&quot;, &quot;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">x</span><span class="o">.</span><span class="n">data_category</span> <span class="k">for</span> <span class="n">x</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">items</span><span class="p">),</span>
-</span><span id="1-51">        <span class="p">)</span>
-</span><span id="1-52">
-</span><span id="1-53">    <span class="k">def</span> <span class="nf">add_event</span><span class="p">(</span>
-</span><span id="1-54">        <span class="bp">self</span><span class="p">,</span> <span class="n">event</span>  <span class="c1"># type: Event</span>
-</span><span id="1-55">    <span class="p">):</span>
-</span><span id="1-56">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-57">        <span class="bp">self</span><span class="o">.</span><span class="n">add_item</span><span class="p">(</span><span class="n">Item</span><span class="p">(</span><span class="n">payload</span><span class="o">=</span><span class="n">PayloadRef</span><span class="p">(</span><span class="n">json</span><span class="o">=</span><span class="n">event</span><span class="p">),</span> <span class="nb">type</span><span class="o">=</span><span class="s2">&quot;event&quot;</span><span class="p">))</span>
-</span><span id="1-58">
-</span><span id="1-59">    <span class="k">def</span> <span class="nf">add_transaction</span><span class="p">(</span>
-</span><span id="1-60">        <span class="bp">self</span><span class="p">,</span> <span class="n">transaction</span>  <span class="c1"># type: Event</span>
-</span><span id="1-61">    <span class="p">):</span>
-</span><span id="1-62">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-63">        <span class="bp">self</span><span class="o">.</span><span class="n">add_item</span><span class="p">(</span><span class="n">Item</span><span class="p">(</span><span class="n">payload</span><span class="o">=</span><span class="n">PayloadRef</span><span class="p">(</span><span class="n">json</span><span class="o">=</span><span class="n">transaction</span><span class="p">),</span> <span class="nb">type</span><span class="o">=</span><span class="s2">&quot;transaction&quot;</span><span class="p">))</span>
-</span><span id="1-64">
-</span><span id="1-65">    <span class="k">def</span> <span class="nf">add_profile</span><span class="p">(</span>
-</span><span id="1-66">        <span class="bp">self</span><span class="p">,</span> <span class="n">profile</span>  <span class="c1"># type: Any</span>
-</span><span id="1-67">    <span class="p">):</span>
-</span><span id="1-68">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-69">        <span class="bp">self</span><span class="o">.</span><span class="n">add_item</span><span class="p">(</span><span class="n">Item</span><span class="p">(</span><span class="n">payload</span><span class="o">=</span><span class="n">PayloadRef</span><span class="p">(</span><span class="n">json</span><span class="o">=</span><span class="n">profile</span><span class="p">),</span> <span class="nb">type</span><span class="o">=</span><span class="s2">&quot;profile&quot;</span><span class="p">))</span>
-</span><span id="1-70">
-</span><span id="1-71">    <span class="k">def</span> <span class="nf">add_checkin</span><span class="p">(</span>
-</span><span id="1-72">        <span class="bp">self</span><span class="p">,</span> <span class="n">checkin</span>  <span class="c1"># type: Any</span>
-</span><span id="1-73">    <span class="p">):</span>
-</span><span id="1-74">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-75">        <span class="bp">self</span><span class="o">.</span><span class="n">add_item</span><span class="p">(</span><span class="n">Item</span><span class="p">(</span><span class="n">payload</span><span class="o">=</span><span class="n">PayloadRef</span><span class="p">(</span><span class="n">json</span><span class="o">=</span><span class="n">checkin</span><span class="p">),</span> <span class="nb">type</span><span class="o">=</span><span class="s2">&quot;check_in&quot;</span><span class="p">))</span>
-</span><span id="1-76">
-</span><span id="1-77">    <span class="k">def</span> <span class="nf">add_session</span><span class="p">(</span>
-</span><span id="1-78">        <span class="bp">self</span><span class="p">,</span> <span class="n">session</span>  <span class="c1"># type: Union[Session, Any]</span>
-</span><span id="1-79">    <span class="p">):</span>
-</span><span id="1-80">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-81">        <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">session</span><span class="p">,</span> <span class="n">Session</span><span class="p">):</span>
-</span><span id="1-82">            <span class="n">session</span> <span class="o">=</span> <span class="n">session</span><span class="o">.</span><span class="n">to_json</span><span class="p">()</span>
-</span><span id="1-83">        <span class="bp">self</span><span class="o">.</span><span class="n">add_item</span><span class="p">(</span><span class="n">Item</span><span class="p">(</span><span class="n">payload</span><span class="o">=</span><span class="n">PayloadRef</span><span class="p">(</span><span class="n">json</span><span class="o">=</span><span class="n">session</span><span class="p">),</span> <span class="nb">type</span><span class="o">=</span><span class="s2">&quot;session&quot;</span><span class="p">))</span>
-</span><span id="1-84">
-</span><span id="1-85">    <span class="k">def</span> <span class="nf">add_sessions</span><span class="p">(</span>
-</span><span id="1-86">        <span class="bp">self</span><span class="p">,</span> <span class="n">sessions</span>  <span class="c1"># type: Any</span>
-</span><span id="1-87">    <span class="p">):</span>
-</span><span id="1-88">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-89">        <span class="bp">self</span><span class="o">.</span><span class="n">add_item</span><span class="p">(</span><span class="n">Item</span><span class="p">(</span><span class="n">payload</span><span class="o">=</span><span class="n">PayloadRef</span><span class="p">(</span><span class="n">json</span><span class="o">=</span><span class="n">sessions</span><span class="p">),</span> <span class="nb">type</span><span class="o">=</span><span class="s2">&quot;sessions&quot;</span><span class="p">))</span>
-</span><span id="1-90">
-</span><span id="1-91">    <span class="k">def</span> <span class="nf">add_item</span><span class="p">(</span>
-</span><span id="1-92">        <span class="bp">self</span><span class="p">,</span> <span class="n">item</span>  <span class="c1"># type: Item</span>
-</span><span id="1-93">    <span class="p">):</span>
-</span><span id="1-94">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-95">        <span class="bp">self</span><span class="o">.</span><span class="n">items</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">item</span><span class="p">)</span>
-</span><span id="1-96">
-</span><span id="1-97">    <span class="k">def</span> <span class="nf">get_event</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-98">        <span class="c1"># type: (...) -&gt; Optional[Event]</span>
-</span><span id="1-99">        <span class="k">for</span> <span class="n">items</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">items</span><span class="p">:</span>
-</span><span id="1-100">            <span class="n">event</span> <span class="o">=</span> <span class="n">items</span><span class="o">.</span><span class="n">get_event</span><span class="p">()</span>
-</span><span id="1-101">            <span class="k">if</span> <span class="n">event</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-102">                <span class="k">return</span> <span class="n">event</span>
-</span><span id="1-103">        <span class="k">return</span> <span class="kc">None</span>
-</span><span id="1-104">
-</span><span id="1-105">    <span class="k">def</span> <span class="nf">get_transaction_event</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-106">        <span class="c1"># type: (...) -&gt; Optional[Event]</span>
-</span><span id="1-107">        <span class="k">for</span> <span class="n">item</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">items</span><span class="p">:</span>
-</span><span id="1-108">            <span class="n">event</span> <span class="o">=</span> <span class="n">item</span><span class="o">.</span><span class="n">get_transaction_event</span><span class="p">()</span>
-</span><span id="1-109">            <span class="k">if</span> <span class="n">event</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-110">                <span class="k">return</span> <span class="n">event</span>
-</span><span id="1-111">        <span class="k">return</span> <span class="kc">None</span>
-</span><span id="1-112">
-</span><span id="1-113">    <span class="k">def</span> <span class="fm">__iter__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-114">        <span class="c1"># type: (...) -&gt; Iterator[Item]</span>
-</span><span id="1-115">        <span class="k">return</span> <span class="nb">iter</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">items</span><span class="p">)</span>
-</span><span id="1-116">
-</span><span id="1-117">    <span class="k">def</span> <span class="nf">serialize_into</span><span class="p">(</span>
-</span><span id="1-118">        <span class="bp">self</span><span class="p">,</span> <span class="n">f</span>  <span class="c1"># type: Any</span>
-</span><span id="1-119">    <span class="p">):</span>
-</span><span id="1-120">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-121">        <span class="n">f</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">json_dumps</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">headers</span><span class="p">))</span>
-</span><span id="1-122">        <span class="n">f</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="sa">b</span><span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">)</span>
-</span><span id="1-123">        <span class="k">for</span> <span class="n">item</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">items</span><span class="p">:</span>
-</span><span id="1-124">            <span class="n">item</span><span class="o">.</span><span class="n">serialize_into</span><span class="p">(</span><span class="n">f</span><span class="p">)</span>
-</span><span id="1-125">
-</span><span id="1-126">    <span class="k">def</span> <span class="nf">serialize</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-127">        <span class="c1"># type: (...) -&gt; bytes</span>
-</span><span id="1-128">        <span class="n">out</span> <span class="o">=</span> <span class="n">io</span><span class="o">.</span><span class="n">BytesIO</span><span class="p">()</span>
-</span><span id="1-129">        <span class="bp">self</span><span class="o">.</span><span class="n">serialize_into</span><span class="p">(</span><span class="n">out</span><span class="p">)</span>
-</span><span id="1-130">        <span class="k">return</span> <span class="n">out</span><span class="o">.</span><span class="n">getvalue</span><span class="p">()</span>
-</span><span id="1-131">
-</span><span id="1-132">    <span class="nd">@classmethod</span>
-</span><span id="1-133">    <span class="k">def</span> <span class="nf">deserialize_from</span><span class="p">(</span>
-</span><span id="1-134">        <span class="bp">cls</span><span class="p">,</span> <span class="n">f</span>  <span class="c1"># type: Any</span>
-</span><span id="1-135">    <span class="p">):</span>
-</span><span id="1-136">        <span class="c1"># type: (...) -&gt; Envelope</span>
-</span><span id="1-137">        <span class="n">headers</span> <span class="o">=</span> <span class="n">parse_json</span><span class="p">(</span><span class="n">f</span><span class="o">.</span><span class="n">readline</span><span class="p">())</span>
-</span><span id="1-138">        <span class="n">items</span> <span class="o">=</span> <span class="p">[]</span>
-</span><span id="1-139">        <span class="k">while</span> <span class="mi">1</span><span class="p">:</span>
-</span><span id="1-140">            <span class="n">item</span> <span class="o">=</span> <span class="n">Item</span><span class="o">.</span><span class="n">deserialize_from</span><span class="p">(</span><span class="n">f</span><span class="p">)</span>
-</span><span id="1-141">            <span class="k">if</span> <span class="n">item</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-142">                <span class="k">break</span>
-</span><span id="1-143">            <span class="n">items</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">item</span><span class="p">)</span>
-</span><span id="1-144">        <span class="k">return</span> <span class="bp">cls</span><span class="p">(</span><span class="n">headers</span><span class="o">=</span><span class="n">headers</span><span class="p">,</span> <span class="n">items</span><span class="o">=</span><span class="n">items</span><span class="p">)</span>
-</span><span id="1-145">
-</span><span id="1-146">    <span class="nd">@classmethod</span>
-</span><span id="1-147">    <span class="k">def</span> <span class="nf">deserialize</span><span class="p">(</span>
-</span><span id="1-148">        <span class="bp">cls</span><span class="p">,</span> <span class="nb">bytes</span>  <span class="c1"># type: bytes</span>
-</span><span id="1-149">    <span class="p">):</span>
-</span><span id="1-150">        <span class="c1"># type: (...) -&gt; Envelope</span>
-</span><span id="1-151">        <span class="k">return</span> <span class="bp">cls</span><span class="o">.</span><span class="n">deserialize_from</span><span class="p">(</span><span class="n">io</span><span class="o">.</span><span class="n">BytesIO</span><span class="p">(</span><span class="nb">bytes</span><span class="p">))</span>
-</span><span id="1-152">
-</span><span id="1-153">    <span class="k">def</span> <span class="fm">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-154">        <span class="c1"># type: (...) -&gt; str</span>
-</span><span id="1-155">        <span class="k">return</span> <span class="s2">&quot;&lt;Envelope headers=</span><span class="si">%r</span><span class="s2"> items=</span><span class="si">%r</span><span class="s2">&gt;&quot;</span> <span class="o">%</span> <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">headers</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">items</span><span class="p">)</span></div>
-
-</span><span id="1-156">
+</span><span id="1-28"><span class="k">class</span> <span class="nc">Envelope</span><span class="p">:</span>
+</span><span id="1-29"><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-30"><span class="sd">    Represents a Sentry Envelope. The calling code is responsible for adhering to the constraints</span>
+</span><span id="1-31"><span class="sd">    documented in the Sentry docs: https://develop.sentry.dev/sdk/envelopes/#data-model. In particular,</span>
+</span><span id="1-32"><span class="sd">    each envelope may have at most one Item with type &quot;event&quot; or &quot;transaction&quot; (but not both).</span>
+</span><span id="1-33"><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="1-34">
+</span><span id="1-35">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
+</span><span id="1-36">        <span class="bp">self</span><span class="p">,</span>
+</span><span id="1-37">        <span class="n">headers</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Dict[str, Any]]</span>
+</span><span id="1-38">        <span class="n">items</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[List[Item]]</span>
+</span><span id="1-39">    <span class="p">):</span>
+</span><span id="1-40">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-41">        <span class="k">if</span> <span class="n">headers</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-42">            <span class="n">headers</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="n">headers</span><span class="p">)</span>
+</span><span id="1-43">        <span class="bp">self</span><span class="o">.</span><span class="n">headers</span> <span class="o">=</span> <span class="n">headers</span> <span class="ow">or</span> <span class="p">{}</span>
+</span><span id="1-44">        <span class="k">if</span> <span class="n">items</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-45">            <span class="n">items</span> <span class="o">=</span> <span class="p">[]</span>
+</span><span id="1-46">        <span class="k">else</span><span class="p">:</span>
+</span><span id="1-47">            <span class="n">items</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="n">items</span><span class="p">)</span>
+</span><span id="1-48">        <span class="bp">self</span><span class="o">.</span><span class="n">items</span> <span class="o">=</span> <span class="n">items</span>
+</span><span id="1-49">
+</span><span id="1-50">    <span class="nd">@property</span>
+</span><span id="1-51">    <span class="k">def</span> <span class="nf">description</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-52">        <span class="c1"># type: (...) -&gt; str</span>
+</span><span id="1-53">        <span class="k">return</span> <span class="s2">&quot;envelope with </span><span class="si">%s</span><span class="s2"> items (</span><span class="si">%s</span><span class="s2">)&quot;</span> <span class="o">%</span> <span class="p">(</span>
+</span><span id="1-54">            <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">items</span><span class="p">),</span>
+</span><span id="1-55">            <span class="s2">&quot;, &quot;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">x</span><span class="o">.</span><span class="n">data_category</span> <span class="k">for</span> <span class="n">x</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">items</span><span class="p">),</span>
+</span><span id="1-56">        <span class="p">)</span>
+</span><span id="1-57">
+</span><span id="1-58">    <span class="k">def</span> <span class="nf">add_event</span><span class="p">(</span>
+</span><span id="1-59">        <span class="bp">self</span><span class="p">,</span> <span class="n">event</span>  <span class="c1"># type: Event</span>
+</span><span id="1-60">    <span class="p">):</span>
+</span><span id="1-61">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-62">        <span class="bp">self</span><span class="o">.</span><span class="n">add_item</span><span class="p">(</span><span class="n">Item</span><span class="p">(</span><span class="n">payload</span><span class="o">=</span><span class="n">PayloadRef</span><span class="p">(</span><span class="n">json</span><span class="o">=</span><span class="n">event</span><span class="p">),</span> <span class="nb">type</span><span class="o">=</span><span class="s2">&quot;event&quot;</span><span class="p">))</span>
+</span><span id="1-63">
+</span><span id="1-64">    <span class="k">def</span> <span class="nf">add_transaction</span><span class="p">(</span>
+</span><span id="1-65">        <span class="bp">self</span><span class="p">,</span> <span class="n">transaction</span>  <span class="c1"># type: Event</span>
+</span><span id="1-66">    <span class="p">):</span>
+</span><span id="1-67">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-68">        <span class="bp">self</span><span class="o">.</span><span class="n">add_item</span><span class="p">(</span><span class="n">Item</span><span class="p">(</span><span class="n">payload</span><span class="o">=</span><span class="n">PayloadRef</span><span class="p">(</span><span class="n">json</span><span class="o">=</span><span class="n">transaction</span><span class="p">),</span> <span class="nb">type</span><span class="o">=</span><span class="s2">&quot;transaction&quot;</span><span class="p">))</span>
+</span><span id="1-69">
+</span><span id="1-70">    <span class="k">def</span> <span class="nf">add_profile</span><span class="p">(</span>
+</span><span id="1-71">        <span class="bp">self</span><span class="p">,</span> <span class="n">profile</span>  <span class="c1"># type: Any</span>
+</span><span id="1-72">    <span class="p">):</span>
+</span><span id="1-73">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-74">        <span class="bp">self</span><span class="o">.</span><span class="n">add_item</span><span class="p">(</span><span class="n">Item</span><span class="p">(</span><span class="n">payload</span><span class="o">=</span><span class="n">PayloadRef</span><span class="p">(</span><span class="n">json</span><span class="o">=</span><span class="n">profile</span><span class="p">),</span> <span class="nb">type</span><span class="o">=</span><span class="s2">&quot;profile&quot;</span><span class="p">))</span>
+</span><span id="1-75">
+</span><span id="1-76">    <span class="k">def</span> <span class="nf">add_checkin</span><span class="p">(</span>
+</span><span id="1-77">        <span class="bp">self</span><span class="p">,</span> <span class="n">checkin</span>  <span class="c1"># type: Any</span>
+</span><span id="1-78">    <span class="p">):</span>
+</span><span id="1-79">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-80">        <span class="bp">self</span><span class="o">.</span><span class="n">add_item</span><span class="p">(</span><span class="n">Item</span><span class="p">(</span><span class="n">payload</span><span class="o">=</span><span class="n">PayloadRef</span><span class="p">(</span><span class="n">json</span><span class="o">=</span><span class="n">checkin</span><span class="p">),</span> <span class="nb">type</span><span class="o">=</span><span class="s2">&quot;check_in&quot;</span><span class="p">))</span>
+</span><span id="1-81">
+</span><span id="1-82">    <span class="k">def</span> <span class="nf">add_session</span><span class="p">(</span>
+</span><span id="1-83">        <span class="bp">self</span><span class="p">,</span> <span class="n">session</span>  <span class="c1"># type: Union[Session, Any]</span>
+</span><span id="1-84">    <span class="p">):</span>
+</span><span id="1-85">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-86">        <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">session</span><span class="p">,</span> <span class="n">Session</span><span class="p">):</span>
+</span><span id="1-87">            <span class="n">session</span> <span class="o">=</span> <span class="n">session</span><span class="o">.</span><span class="n">to_json</span><span class="p">()</span>
+</span><span id="1-88">        <span class="bp">self</span><span class="o">.</span><span class="n">add_item</span><span class="p">(</span><span class="n">Item</span><span class="p">(</span><span class="n">payload</span><span class="o">=</span><span class="n">PayloadRef</span><span class="p">(</span><span class="n">json</span><span class="o">=</span><span class="n">session</span><span class="p">),</span> <span class="nb">type</span><span class="o">=</span><span class="s2">&quot;session&quot;</span><span class="p">))</span>
+</span><span id="1-89">
+</span><span id="1-90">    <span class="k">def</span> <span class="nf">add_sessions</span><span class="p">(</span>
+</span><span id="1-91">        <span class="bp">self</span><span class="p">,</span> <span class="n">sessions</span>  <span class="c1"># type: Any</span>
+</span><span id="1-92">    <span class="p">):</span>
+</span><span id="1-93">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-94">        <span class="bp">self</span><span class="o">.</span><span class="n">add_item</span><span class="p">(</span><span class="n">Item</span><span class="p">(</span><span class="n">payload</span><span class="o">=</span><span class="n">PayloadRef</span><span class="p">(</span><span class="n">json</span><span class="o">=</span><span class="n">sessions</span><span class="p">),</span> <span class="nb">type</span><span class="o">=</span><span class="s2">&quot;sessions&quot;</span><span class="p">))</span>
+</span><span id="1-95">
+</span><span id="1-96">    <span class="k">def</span> <span class="nf">add_item</span><span class="p">(</span>
+</span><span id="1-97">        <span class="bp">self</span><span class="p">,</span> <span class="n">item</span>  <span class="c1"># type: Item</span>
+</span><span id="1-98">    <span class="p">):</span>
+</span><span id="1-99">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-100">        <span class="bp">self</span><span class="o">.</span><span class="n">items</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">item</span><span class="p">)</span>
+</span><span id="1-101">
+</span><span id="1-102">    <span class="k">def</span> <span class="nf">get_event</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-103">        <span class="c1"># type: (...) -&gt; Optional[Event]</span>
+</span><span id="1-104">        <span class="k">for</span> <span class="n">items</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">items</span><span class="p">:</span>
+</span><span id="1-105">            <span class="n">event</span> <span class="o">=</span> <span class="n">items</span><span class="o">.</span><span class="n">get_event</span><span class="p">()</span>
+</span><span id="1-106">            <span class="k">if</span> <span class="n">event</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-107">                <span class="k">return</span> <span class="n">event</span>
+</span><span id="1-108">        <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-109">
+</span><span id="1-110">    <span class="k">def</span> <span class="nf">get_transaction_event</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-111">        <span class="c1"># type: (...) -&gt; Optional[Event]</span>
+</span><span id="1-112">        <span class="k">for</span> <span class="n">item</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">items</span><span class="p">:</span>
+</span><span id="1-113">            <span class="n">event</span> <span class="o">=</span> <span class="n">item</span><span class="o">.</span><span class="n">get_transaction_event</span><span class="p">()</span>
+</span><span id="1-114">            <span class="k">if</span> <span class="n">event</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-115">                <span class="k">return</span> <span class="n">event</span>
+</span><span id="1-116">        <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-117">
+</span><span id="1-118">    <span class="k">def</span> <span class="fm">__iter__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-119">        <span class="c1"># type: (...) -&gt; Iterator[Item]</span>
+</span><span id="1-120">        <span class="k">return</span> <span class="nb">iter</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">items</span><span class="p">)</span>
+</span><span id="1-121">
+</span><span id="1-122">    <span class="k">def</span> <span class="nf">serialize_into</span><span class="p">(</span>
+</span><span id="1-123">        <span class="bp">self</span><span class="p">,</span> <span class="n">f</span>  <span class="c1"># type: Any</span>
+</span><span id="1-124">    <span class="p">):</span>
+</span><span id="1-125">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-126">        <span class="n">f</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">json_dumps</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">headers</span><span class="p">))</span>
+</span><span id="1-127">        <span class="n">f</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="sa">b</span><span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">)</span>
+</span><span id="1-128">        <span class="k">for</span> <span class="n">item</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">items</span><span class="p">:</span>
+</span><span id="1-129">            <span class="n">item</span><span class="o">.</span><span class="n">serialize_into</span><span class="p">(</span><span class="n">f</span><span class="p">)</span>
+</span><span id="1-130">
+</span><span id="1-131">    <span class="k">def</span> <span class="nf">serialize</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-132">        <span class="c1"># type: (...) -&gt; bytes</span>
+</span><span id="1-133">        <span class="n">out</span> <span class="o">=</span> <span class="n">io</span><span class="o">.</span><span class="n">BytesIO</span><span class="p">()</span>
+</span><span id="1-134">        <span class="bp">self</span><span class="o">.</span><span class="n">serialize_into</span><span class="p">(</span><span class="n">out</span><span class="p">)</span>
+</span><span id="1-135">        <span class="k">return</span> <span class="n">out</span><span class="o">.</span><span class="n">getvalue</span><span class="p">()</span>
+</span><span id="1-136">
+</span><span id="1-137">    <span class="nd">@classmethod</span>
+</span><span id="1-138">    <span class="k">def</span> <span class="nf">deserialize_from</span><span class="p">(</span>
+</span><span id="1-139">        <span class="bp">cls</span><span class="p">,</span> <span class="n">f</span>  <span class="c1"># type: Any</span>
+</span><span id="1-140">    <span class="p">):</span>
+</span><span id="1-141">        <span class="c1"># type: (...) -&gt; Envelope</span>
+</span><span id="1-142">        <span class="n">headers</span> <span class="o">=</span> <span class="n">parse_json</span><span class="p">(</span><span class="n">f</span><span class="o">.</span><span class="n">readline</span><span class="p">())</span>
+</span><span id="1-143">        <span class="n">items</span> <span class="o">=</span> <span class="p">[]</span>
+</span><span id="1-144">        <span class="k">while</span> <span class="mi">1</span><span class="p">:</span>
+</span><span id="1-145">            <span class="n">item</span> <span class="o">=</span> <span class="n">Item</span><span class="o">.</span><span class="n">deserialize_from</span><span class="p">(</span><span class="n">f</span><span class="p">)</span>
+</span><span id="1-146">            <span class="k">if</span> <span class="n">item</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-147">                <span class="k">break</span>
+</span><span id="1-148">            <span class="n">items</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">item</span><span class="p">)</span>
+</span><span id="1-149">        <span class="k">return</span> <span class="bp">cls</span><span class="p">(</span><span class="n">headers</span><span class="o">=</span><span class="n">headers</span><span class="p">,</span> <span class="n">items</span><span class="o">=</span><span class="n">items</span><span class="p">)</span>
+</span><span id="1-150">
+</span><span id="1-151">    <span class="nd">@classmethod</span>
+</span><span id="1-152">    <span class="k">def</span> <span class="nf">deserialize</span><span class="p">(</span>
+</span><span id="1-153">        <span class="bp">cls</span><span class="p">,</span> <span class="nb">bytes</span>  <span class="c1"># type: bytes</span>
+</span><span id="1-154">    <span class="p">):</span>
+</span><span id="1-155">        <span class="c1"># type: (...) -&gt; Envelope</span>
+</span><span id="1-156">        <span class="k">return</span> <span class="bp">cls</span><span class="o">.</span><span class="n">deserialize_from</span><span class="p">(</span><span class="n">io</span><span class="o">.</span><span class="n">BytesIO</span><span class="p">(</span><span class="nb">bytes</span><span class="p">))</span>
 </span><span id="1-157">
-</span><span id="1-158"><span class="k">class</span> <span class="nc">PayloadRef</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-</span><span id="1-159">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
-</span><span id="1-160">        <span class="bp">self</span><span class="p">,</span>
-</span><span id="1-161">        <span class="nb">bytes</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[bytes]</span>
-</span><span id="1-162">        <span class="n">path</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Union[bytes, text_type]]</span>
-</span><span id="1-163">        <span class="n">json</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Any]</span>
-</span><span id="1-164">    <span class="p">):</span>
-</span><span id="1-165">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-166">        <span class="bp">self</span><span class="o">.</span><span class="n">json</span> <span class="o">=</span> <span class="n">json</span>
-</span><span id="1-167">        <span class="bp">self</span><span class="o">.</span><span class="n">bytes</span> <span class="o">=</span> <span class="nb">bytes</span>
-</span><span id="1-168">        <span class="bp">self</span><span class="o">.</span><span class="n">path</span> <span class="o">=</span> <span class="n">path</span>
-</span><span id="1-169">
-</span><span id="1-170">    <span class="k">def</span> <span class="nf">get_bytes</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-171">        <span class="c1"># type: (...) -&gt; bytes</span>
-</span><span id="1-172">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">bytes</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-173">            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">path</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-174">                <span class="k">with</span> <span class="n">capture_internal_exceptions</span><span class="p">():</span>
-</span><span id="1-175">                    <span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">path</span><span class="p">,</span> <span class="s2">&quot;rb&quot;</span><span class="p">)</span> <span class="k">as</span> <span class="n">f</span><span class="p">:</span>
-</span><span id="1-176">                        <span class="bp">self</span><span class="o">.</span><span class="n">bytes</span> <span class="o">=</span> <span class="n">f</span><span class="o">.</span><span class="n">read</span><span class="p">()</span>
-</span><span id="1-177">            <span class="k">elif</span> <span class="bp">self</span><span class="o">.</span><span class="n">json</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-178">                <span class="bp">self</span><span class="o">.</span><span class="n">bytes</span> <span class="o">=</span> <span class="n">json_dumps</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">json</span><span class="p">)</span>
-</span><span id="1-179">            <span class="k">else</span><span class="p">:</span>
-</span><span id="1-180">                <span class="bp">self</span><span class="o">.</span><span class="n">bytes</span> <span class="o">=</span> <span class="sa">b</span><span class="s2">&quot;&quot;</span>
-</span><span id="1-181">        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">bytes</span>
-</span><span id="1-182">
-</span><span id="1-183">    <span class="nd">@property</span>
-</span><span id="1-184">    <span class="k">def</span> <span class="nf">inferred_content_type</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-185">        <span class="c1"># type: (...) -&gt; str</span>
-</span><span id="1-186">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">json</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-187">            <span class="k">return</span> <span class="s2">&quot;application/json&quot;</span>
-</span><span id="1-188">        <span class="k">elif</span> <span class="bp">self</span><span class="o">.</span><span class="n">path</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-189">            <span class="n">path</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">path</span>
-</span><span id="1-190">            <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">path</span><span class="p">,</span> <span class="nb">bytes</span><span class="p">):</span>
-</span><span id="1-191">                <span class="n">path</span> <span class="o">=</span> <span class="n">path</span><span class="o">.</span><span class="n">decode</span><span class="p">(</span><span class="s2">&quot;utf-8&quot;</span><span class="p">,</span> <span class="s2">&quot;replace&quot;</span><span class="p">)</span>
-</span><span id="1-192">            <span class="n">ty</span> <span class="o">=</span> <span class="n">mimetypes</span><span class="o">.</span><span class="n">guess_type</span><span class="p">(</span><span class="n">path</span><span class="p">)[</span><span class="mi">0</span><span class="p">]</span>
-</span><span id="1-193">            <span class="k">if</span> <span class="n">ty</span><span class="p">:</span>
-</span><span id="1-194">                <span class="k">return</span> <span class="n">ty</span>
-</span><span id="1-195">        <span class="k">return</span> <span class="s2">&quot;application/octet-stream&quot;</span>
-</span><span id="1-196">
-</span><span id="1-197">    <span class="k">def</span> <span class="fm">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-198">        <span class="c1"># type: (...) -&gt; str</span>
-</span><span id="1-199">        <span class="k">return</span> <span class="s2">&quot;&lt;Payload </span><span class="si">%r</span><span class="s2">&gt;&quot;</span> <span class="o">%</span> <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">inferred_content_type</span><span class="p">,)</span>
-</span><span id="1-200">
+</span><span id="1-158">    <span class="k">def</span> <span class="fm">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-159">        <span class="c1"># type: (...) -&gt; str</span>
+</span><span id="1-160">        <span class="k">return</span> <span class="s2">&quot;&lt;Envelope headers=</span><span class="si">%r</span><span class="s2"> items=</span><span class="si">%r</span><span class="s2">&gt;&quot;</span> <span class="o">%</span> <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">headers</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">items</span><span class="p">)</span></div>
+
+</span><span id="1-161">
+</span><span id="1-162">
+</span><span id="1-163"><span class="k">class</span> <span class="nc">PayloadRef</span><span class="p">:</span>
+</span><span id="1-164">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
+</span><span id="1-165">        <span class="bp">self</span><span class="p">,</span>
+</span><span id="1-166">        <span class="nb">bytes</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[bytes]</span>
+</span><span id="1-167">        <span class="n">path</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Union[bytes, str]]</span>
+</span><span id="1-168">        <span class="n">json</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Any]</span>
+</span><span id="1-169">    <span class="p">):</span>
+</span><span id="1-170">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-171">        <span class="bp">self</span><span class="o">.</span><span class="n">json</span> <span class="o">=</span> <span class="n">json</span>
+</span><span id="1-172">        <span class="bp">self</span><span class="o">.</span><span class="n">bytes</span> <span class="o">=</span> <span class="nb">bytes</span>
+</span><span id="1-173">        <span class="bp">self</span><span class="o">.</span><span class="n">path</span> <span class="o">=</span> <span class="n">path</span>
+</span><span id="1-174">
+</span><span id="1-175">    <span class="k">def</span> <span class="nf">get_bytes</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-176">        <span class="c1"># type: (...) -&gt; bytes</span>
+</span><span id="1-177">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">bytes</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-178">            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">path</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-179">                <span class="k">with</span> <span class="n">capture_internal_exceptions</span><span class="p">():</span>
+</span><span id="1-180">                    <span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">path</span><span class="p">,</span> <span class="s2">&quot;rb&quot;</span><span class="p">)</span> <span class="k">as</span> <span class="n">f</span><span class="p">:</span>
+</span><span id="1-181">                        <span class="bp">self</span><span class="o">.</span><span class="n">bytes</span> <span class="o">=</span> <span class="n">f</span><span class="o">.</span><span class="n">read</span><span class="p">()</span>
+</span><span id="1-182">            <span class="k">elif</span> <span class="bp">self</span><span class="o">.</span><span class="n">json</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-183">                <span class="bp">self</span><span class="o">.</span><span class="n">bytes</span> <span class="o">=</span> <span class="n">json_dumps</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">json</span><span class="p">)</span>
+</span><span id="1-184">            <span class="k">else</span><span class="p">:</span>
+</span><span id="1-185">                <span class="bp">self</span><span class="o">.</span><span class="n">bytes</span> <span class="o">=</span> <span class="sa">b</span><span class="s2">&quot;&quot;</span>
+</span><span id="1-186">        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">bytes</span>
+</span><span id="1-187">
+</span><span id="1-188">    <span class="nd">@property</span>
+</span><span id="1-189">    <span class="k">def</span> <span class="nf">inferred_content_type</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-190">        <span class="c1"># type: (...) -&gt; str</span>
+</span><span id="1-191">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">json</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-192">            <span class="k">return</span> <span class="s2">&quot;application/json&quot;</span>
+</span><span id="1-193">        <span class="k">elif</span> <span class="bp">self</span><span class="o">.</span><span class="n">path</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-194">            <span class="n">path</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">path</span>
+</span><span id="1-195">            <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">path</span><span class="p">,</span> <span class="nb">bytes</span><span class="p">):</span>
+</span><span id="1-196">                <span class="n">path</span> <span class="o">=</span> <span class="n">path</span><span class="o">.</span><span class="n">decode</span><span class="p">(</span><span class="s2">&quot;utf-8&quot;</span><span class="p">,</span> <span class="s2">&quot;replace&quot;</span><span class="p">)</span>
+</span><span id="1-197">            <span class="n">ty</span> <span class="o">=</span> <span class="n">mimetypes</span><span class="o">.</span><span class="n">guess_type</span><span class="p">(</span><span class="n">path</span><span class="p">)[</span><span class="mi">0</span><span class="p">]</span>
+</span><span id="1-198">            <span class="k">if</span> <span class="n">ty</span><span class="p">:</span>
+</span><span id="1-199">                <span class="k">return</span> <span class="n">ty</span>
+</span><span id="1-200">        <span class="k">return</span> <span class="s2">&quot;application/octet-stream&quot;</span>
 </span><span id="1-201">
+</span><span id="1-202">    <span class="k">def</span> <span class="fm">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-203">        <span class="c1"># type: (...) -&gt; str</span>
+</span><span id="1-204">        <span class="k">return</span> <span class="s2">&quot;&lt;Payload </span><span class="si">%r</span><span class="s2">&gt;&quot;</span> <span class="o">%</span> <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">inferred_content_type</span><span class="p">,)</span>
+</span><span id="1-205">
+</span><span id="1-206">
 <div class="viewcode-block" id="Item">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.envelope.Item">[docs]</a>
-</span><span id="1-202"><span class="k">class</span> <span class="nc">Item</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-</span><span id="1-203">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
-</span><span id="1-204">        <span class="bp">self</span><span class="p">,</span>
-</span><span id="1-205">        <span class="n">payload</span><span class="p">,</span>  <span class="c1"># type: Union[bytes, text_type, PayloadRef]</span>
-</span><span id="1-206">        <span class="n">headers</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Dict[str, Any]]</span>
-</span><span id="1-207">        <span class="nb">type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
-</span><span id="1-208">        <span class="n">content_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
-</span><span id="1-209">        <span class="n">filename</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
-</span><span id="1-210">    <span class="p">):</span>
-</span><span id="1-211">        <span class="k">if</span> <span class="n">headers</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-212">            <span class="n">headers</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="n">headers</span><span class="p">)</span>
-</span><span id="1-213">        <span class="k">elif</span> <span class="n">headers</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-214">            <span class="n">headers</span> <span class="o">=</span> <span class="p">{}</span>
-</span><span id="1-215">        <span class="bp">self</span><span class="o">.</span><span class="n">headers</span> <span class="o">=</span> <span class="n">headers</span>
-</span><span id="1-216">        <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">payload</span><span class="p">,</span> <span class="nb">bytes</span><span class="p">):</span>
-</span><span id="1-217">            <span class="n">payload</span> <span class="o">=</span> <span class="n">PayloadRef</span><span class="p">(</span><span class="nb">bytes</span><span class="o">=</span><span class="n">payload</span><span class="p">)</span>
-</span><span id="1-218">        <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">payload</span><span class="p">,</span> <span class="n">text_type</span><span class="p">):</span>
-</span><span id="1-219">            <span class="n">payload</span> <span class="o">=</span> <span class="n">PayloadRef</span><span class="p">(</span><span class="nb">bytes</span><span class="o">=</span><span class="n">payload</span><span class="o">.</span><span class="n">encode</span><span class="p">(</span><span class="s2">&quot;utf-8&quot;</span><span class="p">))</span>
-</span><span id="1-220">        <span class="k">else</span><span class="p">:</span>
-</span><span id="1-221">            <span class="n">payload</span> <span class="o">=</span> <span class="n">payload</span>
-</span><span id="1-222">
-</span><span id="1-223">        <span class="k">if</span> <span class="n">filename</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-224">            <span class="n">headers</span><span class="p">[</span><span class="s2">&quot;filename&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">filename</span>
-</span><span id="1-225">        <span class="k">if</span> <span class="nb">type</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-226">            <span class="n">headers</span><span class="p">[</span><span class="s2">&quot;type&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="nb">type</span>
-</span><span id="1-227">        <span class="k">if</span> <span class="n">content_type</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-228">            <span class="n">headers</span><span class="p">[</span><span class="s2">&quot;content_type&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">content_type</span>
-</span><span id="1-229">        <span class="k">elif</span> <span class="s2">&quot;content_type&quot;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">headers</span><span class="p">:</span>
-</span><span id="1-230">            <span class="n">headers</span><span class="p">[</span><span class="s2">&quot;content_type&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">payload</span><span class="o">.</span><span class="n">inferred_content_type</span>
-</span><span id="1-231">
-</span><span id="1-232">        <span class="bp">self</span><span class="o">.</span><span class="n">payload</span> <span class="o">=</span> <span class="n">payload</span>
-</span><span id="1-233">
-</span><span id="1-234">    <span class="k">def</span> <span class="fm">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-235">        <span class="c1"># type: (...) -&gt; str</span>
-</span><span id="1-236">        <span class="k">return</span> <span class="s2">&quot;&lt;Item headers=</span><span class="si">%r</span><span class="s2"> payload=</span><span class="si">%r</span><span class="s2"> data_category=</span><span class="si">%r</span><span class="s2">&gt;&quot;</span> <span class="o">%</span> <span class="p">(</span>
-</span><span id="1-237">            <span class="bp">self</span><span class="o">.</span><span class="n">headers</span><span class="p">,</span>
-</span><span id="1-238">            <span class="bp">self</span><span class="o">.</span><span class="n">payload</span><span class="p">,</span>
-</span><span id="1-239">            <span class="bp">self</span><span class="o">.</span><span class="n">data_category</span><span class="p">,</span>
-</span><span id="1-240">        <span class="p">)</span>
-</span><span id="1-241">
-</span><span id="1-242">    <span class="nd">@property</span>
-</span><span id="1-243">    <span class="k">def</span> <span class="nf">type</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-244">        <span class="c1"># type: (...) -&gt; Optional[str]</span>
-</span><span id="1-245">        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">headers</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;type&quot;</span><span class="p">)</span>
+</span><span id="1-207"><span class="k">class</span> <span class="nc">Item</span><span class="p">:</span>
+</span><span id="1-208">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
+</span><span id="1-209">        <span class="bp">self</span><span class="p">,</span>
+</span><span id="1-210">        <span class="n">payload</span><span class="p">,</span>  <span class="c1"># type: Union[bytes, str, PayloadRef]</span>
+</span><span id="1-211">        <span class="n">headers</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Dict[str, Any]]</span>
+</span><span id="1-212">        <span class="nb">type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
+</span><span id="1-213">        <span class="n">content_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
+</span><span id="1-214">        <span class="n">filename</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
+</span><span id="1-215">    <span class="p">):</span>
+</span><span id="1-216">        <span class="k">if</span> <span class="n">headers</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-217">            <span class="n">headers</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="n">headers</span><span class="p">)</span>
+</span><span id="1-218">        <span class="k">elif</span> <span class="n">headers</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-219">            <span class="n">headers</span> <span class="o">=</span> <span class="p">{}</span>
+</span><span id="1-220">        <span class="bp">self</span><span class="o">.</span><span class="n">headers</span> <span class="o">=</span> <span class="n">headers</span>
+</span><span id="1-221">        <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">payload</span><span class="p">,</span> <span class="nb">bytes</span><span class="p">):</span>
+</span><span id="1-222">            <span class="n">payload</span> <span class="o">=</span> <span class="n">PayloadRef</span><span class="p">(</span><span class="nb">bytes</span><span class="o">=</span><span class="n">payload</span><span class="p">)</span>
+</span><span id="1-223">        <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">payload</span><span class="p">,</span> <span class="nb">str</span><span class="p">):</span>
+</span><span id="1-224">            <span class="n">payload</span> <span class="o">=</span> <span class="n">PayloadRef</span><span class="p">(</span><span class="nb">bytes</span><span class="o">=</span><span class="n">payload</span><span class="o">.</span><span class="n">encode</span><span class="p">(</span><span class="s2">&quot;utf-8&quot;</span><span class="p">))</span>
+</span><span id="1-225">        <span class="k">else</span><span class="p">:</span>
+</span><span id="1-226">            <span class="n">payload</span> <span class="o">=</span> <span class="n">payload</span>
+</span><span id="1-227">
+</span><span id="1-228">        <span class="k">if</span> <span class="n">filename</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-229">            <span class="n">headers</span><span class="p">[</span><span class="s2">&quot;filename&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">filename</span>
+</span><span id="1-230">        <span class="k">if</span> <span class="nb">type</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-231">            <span class="n">headers</span><span class="p">[</span><span class="s2">&quot;type&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="nb">type</span>
+</span><span id="1-232">        <span class="k">if</span> <span class="n">content_type</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-233">            <span class="n">headers</span><span class="p">[</span><span class="s2">&quot;content_type&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">content_type</span>
+</span><span id="1-234">        <span class="k">elif</span> <span class="s2">&quot;content_type&quot;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">headers</span><span class="p">:</span>
+</span><span id="1-235">            <span class="n">headers</span><span class="p">[</span><span class="s2">&quot;content_type&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">payload</span><span class="o">.</span><span class="n">inferred_content_type</span>
+</span><span id="1-236">
+</span><span id="1-237">        <span class="bp">self</span><span class="o">.</span><span class="n">payload</span> <span class="o">=</span> <span class="n">payload</span>
+</span><span id="1-238">
+</span><span id="1-239">    <span class="k">def</span> <span class="fm">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-240">        <span class="c1"># type: (...) -&gt; str</span>
+</span><span id="1-241">        <span class="k">return</span> <span class="s2">&quot;&lt;Item headers=</span><span class="si">%r</span><span class="s2"> payload=</span><span class="si">%r</span><span class="s2"> data_category=</span><span class="si">%r</span><span class="s2">&gt;&quot;</span> <span class="o">%</span> <span class="p">(</span>
+</span><span id="1-242">            <span class="bp">self</span><span class="o">.</span><span class="n">headers</span><span class="p">,</span>
+</span><span id="1-243">            <span class="bp">self</span><span class="o">.</span><span class="n">payload</span><span class="p">,</span>
+</span><span id="1-244">            <span class="bp">self</span><span class="o">.</span><span class="n">data_category</span><span class="p">,</span>
+</span><span id="1-245">        <span class="p">)</span>
 </span><span id="1-246">
 </span><span id="1-247">    <span class="nd">@property</span>
-</span><span id="1-248">    <span class="k">def</span> <span class="nf">data_category</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-249">        <span class="c1"># type: (...) -&gt; EventDataCategory</span>
-</span><span id="1-250">        <span class="n">ty</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">headers</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;type&quot;</span><span class="p">)</span>
-</span><span id="1-251">        <span class="k">if</span> <span class="n">ty</span> <span class="o">==</span> <span class="s2">&quot;session&quot;</span><span class="p">:</span>
-</span><span id="1-252">            <span class="k">return</span> <span class="s2">&quot;session&quot;</span>
-</span><span id="1-253">        <span class="k">elif</span> <span class="n">ty</span> <span class="o">==</span> <span class="s2">&quot;attachment&quot;</span><span class="p">:</span>
-</span><span id="1-254">            <span class="k">return</span> <span class="s2">&quot;attachment&quot;</span>
-</span><span id="1-255">        <span class="k">elif</span> <span class="n">ty</span> <span class="o">==</span> <span class="s2">&quot;transaction&quot;</span><span class="p">:</span>
-</span><span id="1-256">            <span class="k">return</span> <span class="s2">&quot;transaction&quot;</span>
-</span><span id="1-257">        <span class="k">elif</span> <span class="n">ty</span> <span class="o">==</span> <span class="s2">&quot;event&quot;</span><span class="p">:</span>
-</span><span id="1-258">            <span class="k">return</span> <span class="s2">&quot;error&quot;</span>
-</span><span id="1-259">        <span class="k">elif</span> <span class="n">ty</span> <span class="o">==</span> <span class="s2">&quot;client_report&quot;</span><span class="p">:</span>
-</span><span id="1-260">            <span class="k">return</span> <span class="s2">&quot;internal&quot;</span>
-</span><span id="1-261">        <span class="k">elif</span> <span class="n">ty</span> <span class="o">==</span> <span class="s2">&quot;profile&quot;</span><span class="p">:</span>
-</span><span id="1-262">            <span class="k">return</span> <span class="s2">&quot;profile&quot;</span>
-</span><span id="1-263">        <span class="k">elif</span> <span class="n">ty</span> <span class="o">==</span> <span class="s2">&quot;statsd&quot;</span><span class="p">:</span>
-</span><span id="1-264">            <span class="k">return</span> <span class="s2">&quot;statsd&quot;</span>
-</span><span id="1-265">        <span class="k">elif</span> <span class="n">ty</span> <span class="o">==</span> <span class="s2">&quot;check_in&quot;</span><span class="p">:</span>
-</span><span id="1-266">            <span class="k">return</span> <span class="s2">&quot;monitor&quot;</span>
-</span><span id="1-267">        <span class="k">else</span><span class="p">:</span>
-</span><span id="1-268">            <span class="k">return</span> <span class="s2">&quot;default&quot;</span>
-</span><span id="1-269">
-</span><span id="1-270">    <span class="k">def</span> <span class="nf">get_bytes</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-271">        <span class="c1"># type: (...) -&gt; bytes</span>
-</span><span id="1-272">        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">payload</span><span class="o">.</span><span class="n">get_bytes</span><span class="p">()</span>
-</span><span id="1-273">
+</span><span id="1-248">    <span class="k">def</span> <span class="nf">type</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-249">        <span class="c1"># type: (...) -&gt; Optional[str]</span>
+</span><span id="1-250">        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">headers</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;type&quot;</span><span class="p">)</span>
+</span><span id="1-251">
+</span><span id="1-252">    <span class="nd">@property</span>
+</span><span id="1-253">    <span class="k">def</span> <span class="nf">data_category</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-254">        <span class="c1"># type: (...) -&gt; EventDataCategory</span>
+</span><span id="1-255">        <span class="n">ty</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">headers</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;type&quot;</span><span class="p">)</span>
+</span><span id="1-256">        <span class="k">if</span> <span class="n">ty</span> <span class="o">==</span> <span class="s2">&quot;session&quot;</span><span class="p">:</span>
+</span><span id="1-257">            <span class="k">return</span> <span class="s2">&quot;session&quot;</span>
+</span><span id="1-258">        <span class="k">elif</span> <span class="n">ty</span> <span class="o">==</span> <span class="s2">&quot;attachment&quot;</span><span class="p">:</span>
+</span><span id="1-259">            <span class="k">return</span> <span class="s2">&quot;attachment&quot;</span>
+</span><span id="1-260">        <span class="k">elif</span> <span class="n">ty</span> <span class="o">==</span> <span class="s2">&quot;transaction&quot;</span><span class="p">:</span>
+</span><span id="1-261">            <span class="k">return</span> <span class="s2">&quot;transaction&quot;</span>
+</span><span id="1-262">        <span class="k">elif</span> <span class="n">ty</span> <span class="o">==</span> <span class="s2">&quot;event&quot;</span><span class="p">:</span>
+</span><span id="1-263">            <span class="k">return</span> <span class="s2">&quot;error&quot;</span>
+</span><span id="1-264">        <span class="k">elif</span> <span class="n">ty</span> <span class="o">==</span> <span class="s2">&quot;client_report&quot;</span><span class="p">:</span>
+</span><span id="1-265">            <span class="k">return</span> <span class="s2">&quot;internal&quot;</span>
+</span><span id="1-266">        <span class="k">elif</span> <span class="n">ty</span> <span class="o">==</span> <span class="s2">&quot;profile&quot;</span><span class="p">:</span>
+</span><span id="1-267">            <span class="k">return</span> <span class="s2">&quot;profile&quot;</span>
+</span><span id="1-268">        <span class="k">elif</span> <span class="n">ty</span> <span class="o">==</span> <span class="s2">&quot;statsd&quot;</span><span class="p">:</span>
+</span><span id="1-269">            <span class="k">return</span> <span class="s2">&quot;statsd&quot;</span>
+</span><span id="1-270">        <span class="k">elif</span> <span class="n">ty</span> <span class="o">==</span> <span class="s2">&quot;check_in&quot;</span><span class="p">:</span>
+</span><span id="1-271">            <span class="k">return</span> <span class="s2">&quot;monitor&quot;</span>
+</span><span id="1-272">        <span class="k">else</span><span class="p">:</span>
+</span><span id="1-273">            <span class="k">return</span> <span class="s2">&quot;default&quot;</span>
+</span><span id="1-274">
+</span><span id="1-275">    <span class="k">def</span> <span class="nf">get_bytes</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-276">        <span class="c1"># type: (...) -&gt; bytes</span>
+</span><span id="1-277">        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">payload</span><span class="o">.</span><span class="n">get_bytes</span><span class="p">()</span>
+</span><span id="1-278">
 <div class="viewcode-block" id="Item.get_event">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.envelope.Item.get_event">[docs]</a>
-</span><span id="1-274">    <span class="k">def</span> <span class="nf">get_event</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-275">        <span class="c1"># type: (...) -&gt; Optional[Event]</span>
-</span><span id="1-276"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-277"><span class="sd">        Returns an error event if there is one.</span>
-</span><span id="1-278"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-279">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">type</span> <span class="o">==</span> <span class="s2">&quot;event&quot;</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">payload</span><span class="o">.</span><span class="n">json</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-280">            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">payload</span><span class="o">.</span><span class="n">json</span>
-</span><span id="1-281">        <span class="k">return</span> <span class="kc">None</span></div>
+</span><span id="1-279">    <span class="k">def</span> <span class="nf">get_event</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-280">        <span class="c1"># type: (...) -&gt; Optional[Event]</span>
+</span><span id="1-281"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-282"><span class="sd">        Returns an error event if there is one.</span>
+</span><span id="1-283"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-284">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">type</span> <span class="o">==</span> <span class="s2">&quot;event&quot;</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">payload</span><span class="o">.</span><span class="n">json</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-285">            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">payload</span><span class="o">.</span><span class="n">json</span>
+</span><span id="1-286">        <span class="k">return</span> <span class="kc">None</span></div>
 
-</span><span id="1-282">
-</span><span id="1-283">    <span class="k">def</span> <span class="nf">get_transaction_event</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-284">        <span class="c1"># type: (...) -&gt; Optional[Event]</span>
-</span><span id="1-285">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">type</span> <span class="o">==</span> <span class="s2">&quot;transaction&quot;</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">payload</span><span class="o">.</span><span class="n">json</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-286">            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">payload</span><span class="o">.</span><span class="n">json</span>
-</span><span id="1-287">        <span class="k">return</span> <span class="kc">None</span>
-</span><span id="1-288">
-</span><span id="1-289">    <span class="k">def</span> <span class="nf">serialize_into</span><span class="p">(</span>
-</span><span id="1-290">        <span class="bp">self</span><span class="p">,</span> <span class="n">f</span>  <span class="c1"># type: Any</span>
-</span><span id="1-291">    <span class="p">):</span>
-</span><span id="1-292">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-293">        <span class="n">headers</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">headers</span><span class="p">)</span>
-</span><span id="1-294">        <span class="nb">bytes</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_bytes</span><span class="p">()</span>
-</span><span id="1-295">        <span class="n">headers</span><span class="p">[</span><span class="s2">&quot;length&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="nb">len</span><span class="p">(</span><span class="nb">bytes</span><span class="p">)</span>
-</span><span id="1-296">        <span class="n">f</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">json_dumps</span><span class="p">(</span><span class="n">headers</span><span class="p">))</span>
-</span><span id="1-297">        <span class="n">f</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="sa">b</span><span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">)</span>
-</span><span id="1-298">        <span class="n">f</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="nb">bytes</span><span class="p">)</span>
-</span><span id="1-299">        <span class="n">f</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="sa">b</span><span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">)</span>
-</span><span id="1-300">
-</span><span id="1-301">    <span class="k">def</span> <span class="nf">serialize</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-302">        <span class="c1"># type: (...) -&gt; bytes</span>
-</span><span id="1-303">        <span class="n">out</span> <span class="o">=</span> <span class="n">io</span><span class="o">.</span><span class="n">BytesIO</span><span class="p">()</span>
-</span><span id="1-304">        <span class="bp">self</span><span class="o">.</span><span class="n">serialize_into</span><span class="p">(</span><span class="n">out</span><span class="p">)</span>
-</span><span id="1-305">        <span class="k">return</span> <span class="n">out</span><span class="o">.</span><span class="n">getvalue</span><span class="p">()</span>
-</span><span id="1-306">
-</span><span id="1-307">    <span class="nd">@classmethod</span>
-</span><span id="1-308">    <span class="k">def</span> <span class="nf">deserialize_from</span><span class="p">(</span>
-</span><span id="1-309">        <span class="bp">cls</span><span class="p">,</span> <span class="n">f</span>  <span class="c1"># type: Any</span>
-</span><span id="1-310">    <span class="p">):</span>
-</span><span id="1-311">        <span class="c1"># type: (...) -&gt; Optional[Item]</span>
-</span><span id="1-312">        <span class="n">line</span> <span class="o">=</span> <span class="n">f</span><span class="o">.</span><span class="n">readline</span><span class="p">()</span><span class="o">.</span><span class="n">rstrip</span><span class="p">()</span>
-</span><span id="1-313">        <span class="k">if</span> <span class="ow">not</span> <span class="n">line</span><span class="p">:</span>
-</span><span id="1-314">            <span class="k">return</span> <span class="kc">None</span>
-</span><span id="1-315">        <span class="n">headers</span> <span class="o">=</span> <span class="n">parse_json</span><span class="p">(</span><span class="n">line</span><span class="p">)</span>
-</span><span id="1-316">        <span class="n">length</span> <span class="o">=</span> <span class="n">headers</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;length&quot;</span><span class="p">)</span>
-</span><span id="1-317">        <span class="k">if</span> <span class="n">length</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-318">            <span class="n">payload</span> <span class="o">=</span> <span class="n">f</span><span class="o">.</span><span class="n">read</span><span class="p">(</span><span class="n">length</span><span class="p">)</span>
-</span><span id="1-319">            <span class="n">f</span><span class="o">.</span><span class="n">readline</span><span class="p">()</span>
-</span><span id="1-320">        <span class="k">else</span><span class="p">:</span>
-</span><span id="1-321">            <span class="c1"># if no length was specified we need to read up to the end of line</span>
-</span><span id="1-322">            <span class="c1"># and remove it (if it is present, i.e. not the very last char in an eof terminated envelope)</span>
-</span><span id="1-323">            <span class="n">payload</span> <span class="o">=</span> <span class="n">f</span><span class="o">.</span><span class="n">readline</span><span class="p">()</span><span class="o">.</span><span class="n">rstrip</span><span class="p">(</span><span class="sa">b</span><span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">)</span>
-</span><span id="1-324">        <span class="k">if</span> <span class="n">headers</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;type&quot;</span><span class="p">)</span> <span class="ow">in</span> <span class="p">(</span><span class="s2">&quot;event&quot;</span><span class="p">,</span> <span class="s2">&quot;transaction&quot;</span><span class="p">,</span> <span class="s2">&quot;metric_buckets&quot;</span><span class="p">):</span>
-</span><span id="1-325">            <span class="n">rv</span> <span class="o">=</span> <span class="bp">cls</span><span class="p">(</span><span class="n">headers</span><span class="o">=</span><span class="n">headers</span><span class="p">,</span> <span class="n">payload</span><span class="o">=</span><span class="n">PayloadRef</span><span class="p">(</span><span class="n">json</span><span class="o">=</span><span class="n">parse_json</span><span class="p">(</span><span class="n">payload</span><span class="p">)))</span>
-</span><span id="1-326">        <span class="k">else</span><span class="p">:</span>
-</span><span id="1-327">            <span class="n">rv</span> <span class="o">=</span> <span class="bp">cls</span><span class="p">(</span><span class="n">headers</span><span class="o">=</span><span class="n">headers</span><span class="p">,</span> <span class="n">payload</span><span class="o">=</span><span class="n">payload</span><span class="p">)</span>
-</span><span id="1-328">        <span class="k">return</span> <span class="n">rv</span>
-</span><span id="1-329">
-</span><span id="1-330">    <span class="nd">@classmethod</span>
-</span><span id="1-331">    <span class="k">def</span> <span class="nf">deserialize</span><span class="p">(</span>
-</span><span id="1-332">        <span class="bp">cls</span><span class="p">,</span> <span class="nb">bytes</span>  <span class="c1"># type: bytes</span>
-</span><span id="1-333">    <span class="p">):</span>
-</span><span id="1-334">        <span class="c1"># type: (...) -&gt; Optional[Item]</span>
-</span><span id="1-335">        <span class="k">return</span> <span class="bp">cls</span><span class="o">.</span><span class="n">deserialize_from</span><span class="p">(</span><span class="n">io</span><span class="o">.</span><span class="n">BytesIO</span><span class="p">(</span><span class="nb">bytes</span><span class="p">))</span></div>
+</span><span id="1-287">
+</span><span id="1-288">    <span class="k">def</span> <span class="nf">get_transaction_event</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-289">        <span class="c1"># type: (...) -&gt; Optional[Event]</span>
+</span><span id="1-290">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">type</span> <span class="o">==</span> <span class="s2">&quot;transaction&quot;</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">payload</span><span class="o">.</span><span class="n">json</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-291">            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">payload</span><span class="o">.</span><span class="n">json</span>
+</span><span id="1-292">        <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-293">
+</span><span id="1-294">    <span class="k">def</span> <span class="nf">serialize_into</span><span class="p">(</span>
+</span><span id="1-295">        <span class="bp">self</span><span class="p">,</span> <span class="n">f</span>  <span class="c1"># type: Any</span>
+</span><span id="1-296">    <span class="p">):</span>
+</span><span id="1-297">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-298">        <span class="n">headers</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">headers</span><span class="p">)</span>
+</span><span id="1-299">        <span class="nb">bytes</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_bytes</span><span class="p">()</span>
+</span><span id="1-300">        <span class="n">headers</span><span class="p">[</span><span class="s2">&quot;length&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="nb">len</span><span class="p">(</span><span class="nb">bytes</span><span class="p">)</span>
+</span><span id="1-301">        <span class="n">f</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">json_dumps</span><span class="p">(</span><span class="n">headers</span><span class="p">))</span>
+</span><span id="1-302">        <span class="n">f</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="sa">b</span><span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">)</span>
+</span><span id="1-303">        <span class="n">f</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="nb">bytes</span><span class="p">)</span>
+</span><span id="1-304">        <span class="n">f</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="sa">b</span><span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">)</span>
+</span><span id="1-305">
+</span><span id="1-306">    <span class="k">def</span> <span class="nf">serialize</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-307">        <span class="c1"># type: (...) -&gt; bytes</span>
+</span><span id="1-308">        <span class="n">out</span> <span class="o">=</span> <span class="n">io</span><span class="o">.</span><span class="n">BytesIO</span><span class="p">()</span>
+</span><span id="1-309">        <span class="bp">self</span><span class="o">.</span><span class="n">serialize_into</span><span class="p">(</span><span class="n">out</span><span class="p">)</span>
+</span><span id="1-310">        <span class="k">return</span> <span class="n">out</span><span class="o">.</span><span class="n">getvalue</span><span class="p">()</span>
+</span><span id="1-311">
+</span><span id="1-312">    <span class="nd">@classmethod</span>
+</span><span id="1-313">    <span class="k">def</span> <span class="nf">deserialize_from</span><span class="p">(</span>
+</span><span id="1-314">        <span class="bp">cls</span><span class="p">,</span> <span class="n">f</span>  <span class="c1"># type: Any</span>
+</span><span id="1-315">    <span class="p">):</span>
+</span><span id="1-316">        <span class="c1"># type: (...) -&gt; Optional[Item]</span>
+</span><span id="1-317">        <span class="n">line</span> <span class="o">=</span> <span class="n">f</span><span class="o">.</span><span class="n">readline</span><span class="p">()</span><span class="o">.</span><span class="n">rstrip</span><span class="p">()</span>
+</span><span id="1-318">        <span class="k">if</span> <span class="ow">not</span> <span class="n">line</span><span class="p">:</span>
+</span><span id="1-319">            <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-320">        <span class="n">headers</span> <span class="o">=</span> <span class="n">parse_json</span><span class="p">(</span><span class="n">line</span><span class="p">)</span>
+</span><span id="1-321">        <span class="n">length</span> <span class="o">=</span> <span class="n">headers</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;length&quot;</span><span class="p">)</span>
+</span><span id="1-322">        <span class="k">if</span> <span class="n">length</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-323">            <span class="n">payload</span> <span class="o">=</span> <span class="n">f</span><span class="o">.</span><span class="n">read</span><span class="p">(</span><span class="n">length</span><span class="p">)</span>
+</span><span id="1-324">            <span class="n">f</span><span class="o">.</span><span class="n">readline</span><span class="p">()</span>
+</span><span id="1-325">        <span class="k">else</span><span class="p">:</span>
+</span><span id="1-326">            <span class="c1"># if no length was specified we need to read up to the end of line</span>
+</span><span id="1-327">            <span class="c1"># and remove it (if it is present, i.e. not the very last char in an eof terminated envelope)</span>
+</span><span id="1-328">            <span class="n">payload</span> <span class="o">=</span> <span class="n">f</span><span class="o">.</span><span class="n">readline</span><span class="p">()</span><span class="o">.</span><span class="n">rstrip</span><span class="p">(</span><span class="sa">b</span><span class="s2">&quot;</span><span class="se">\n</span><span class="s2">&quot;</span><span class="p">)</span>
+</span><span id="1-329">        <span class="k">if</span> <span class="n">headers</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;type&quot;</span><span class="p">)</span> <span class="ow">in</span> <span class="p">(</span><span class="s2">&quot;event&quot;</span><span class="p">,</span> <span class="s2">&quot;transaction&quot;</span><span class="p">,</span> <span class="s2">&quot;metric_buckets&quot;</span><span class="p">):</span>
+</span><span id="1-330">            <span class="n">rv</span> <span class="o">=</span> <span class="bp">cls</span><span class="p">(</span><span class="n">headers</span><span class="o">=</span><span class="n">headers</span><span class="p">,</span> <span class="n">payload</span><span class="o">=</span><span class="n">PayloadRef</span><span class="p">(</span><span class="n">json</span><span class="o">=</span><span class="n">parse_json</span><span class="p">(</span><span class="n">payload</span><span class="p">)))</span>
+</span><span id="1-331">        <span class="k">else</span><span class="p">:</span>
+</span><span id="1-332">            <span class="n">rv</span> <span class="o">=</span> <span class="bp">cls</span><span class="p">(</span><span class="n">headers</span><span class="o">=</span><span class="n">headers</span><span class="p">,</span> <span class="n">payload</span><span class="o">=</span><span class="n">payload</span><span class="p">)</span>
+</span><span id="1-333">        <span class="k">return</span> <span class="n">rv</span>
+</span><span id="1-334">
+</span><span id="1-335">    <span class="nd">@classmethod</span>
+</span><span id="1-336">    <span class="k">def</span> <span class="nf">deserialize</span><span class="p">(</span>
+</span><span id="1-337">        <span class="bp">cls</span><span class="p">,</span> <span class="nb">bytes</span>  <span class="c1"># type: bytes</span>
+</span><span id="1-338">    <span class="p">):</span>
+</span><span id="1-339">        <span class="c1"># type: (...) -&gt; Optional[Item]</span>
+</span><span id="1-340">        <span class="k">return</span> <span class="bp">cls</span><span class="o">.</span><span class="n">deserialize_from</span><span class="p">(</span><span class="n">io</span><span class="o">.</span><span class="n">BytesIO</span><span class="p">(</span><span class="nb">bytes</span><span class="p">))</span></div>
 
 </span></pre></div>
         </article>
@@ -508,7 +513,7 @@ <h1>Source code for sentry_sdk.envelope</h1><div class="highlight"><pre>
     </div>
   </div>
 </footer></div>
-      <script src="../../_static/documentation_options.js?v=fca6d697"></script>
+      <script src="../../_static/documentation_options.js?v=aa9da443"></script>
       <script src="../../_static/doctools.js?v=888ff710"></script>
       <script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
       <script src="../../_static/shibuya.js?v=999236dc"></script>
diff --git a/_modules/sentry_sdk/hub.html b/_modules/sentry_sdk/hub.html
index b9aab9ea9c..a1c8ed2898 100644
--- a/_modules/sentry_sdk/hub.html
+++ b/_modules/sentry_sdk/hub.html
@@ -4,7 +4,7 @@
 <head>
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-      <title>sentry_sdk.hub - sentry-python 1.44.1 documentation</title>
+      <title>sentry_sdk.hub - sentry-python 2.0.0rc4 documentation</title>
     <link rel="index" title="Index" href="../../genindex.html" /><link rel="search" title="Search" href="../../search.html" />
 
   <script>
@@ -132,788 +132,861 @@
       <div class="min-w-0 max-w-6xl px-6 pb-6 pt-8 xl:px-12">
         <article class="yue" role="main">
           <h1>Source code for sentry_sdk.hub</h1><div class="highlight"><pre>
-<span></span><span id="1-1"><span class="kn">import</span> <span class="nn">copy</span>
-</span><span id="1-2"><span class="kn">import</span> <span class="nn">sys</span>
-</span><span id="1-3"><span class="kn">from</span> <span class="nn">contextlib</span> <span class="kn">import</span> <span class="n">contextmanager</span>
-</span><span id="1-4">
-</span><span id="1-5"><span class="kn">from</span> <span class="nn">sentry_sdk._compat</span> <span class="kn">import</span> <span class="n">with_metaclass</span>
-</span><span id="1-6"><span class="kn">from</span> <span class="nn">sentry_sdk.consts</span> <span class="kn">import</span> <span class="n">INSTRUMENTER</span>
-</span><span id="1-7"><span class="kn">from</span> <span class="nn">sentry_sdk.scope</span> <span class="kn">import</span> <span class="n">Scope</span>
-</span><span id="1-8"><span class="kn">from</span> <span class="nn">sentry_sdk.client</span> <span class="kn">import</span> <span class="n">Client</span>
-</span><span id="1-9"><span class="kn">from</span> <span class="nn">sentry_sdk.tracing</span> <span class="kn">import</span> <span class="p">(</span>
-</span><span id="1-10">    <span class="n">NoOpSpan</span><span class="p">,</span>
-</span><span id="1-11">    <span class="n">Span</span><span class="p">,</span>
-</span><span id="1-12">    <span class="n">Transaction</span><span class="p">,</span>
-</span><span id="1-13"><span class="p">)</span>
-</span><span id="1-14">
-</span><span id="1-15"><span class="kn">from</span> <span class="nn">sentry_sdk.utils</span> <span class="kn">import</span> <span class="p">(</span>
-</span><span id="1-16">    <span class="n">logger</span><span class="p">,</span>
-</span><span id="1-17">    <span class="n">ContextVar</span><span class="p">,</span>
-</span><span id="1-18"><span class="p">)</span>
+<span></span><span id="1-1"><span class="kn">from</span> <span class="nn">contextlib</span> <span class="kn">import</span> <span class="n">contextmanager</span>
+</span><span id="1-2">
+</span><span id="1-3"><span class="kn">from</span> <span class="nn">sentry_sdk._compat</span> <span class="kn">import</span> <span class="n">with_metaclass</span>
+</span><span id="1-4"><span class="kn">from</span> <span class="nn">sentry_sdk.consts</span> <span class="kn">import</span> <span class="n">INSTRUMENTER</span>
+</span><span id="1-5"><span class="kn">from</span> <span class="nn">sentry_sdk.scope</span> <span class="kn">import</span> <span class="n">Scope</span><span class="p">,</span> <span class="n">_ScopeManager</span>
+</span><span id="1-6"><span class="kn">from</span> <span class="nn">sentry_sdk.client</span> <span class="kn">import</span> <span class="n">Client</span>
+</span><span id="1-7"><span class="kn">from</span> <span class="nn">sentry_sdk.tracing</span> <span class="kn">import</span> <span class="p">(</span>
+</span><span id="1-8">    <span class="n">NoOpSpan</span><span class="p">,</span>
+</span><span id="1-9">    <span class="n">Span</span><span class="p">,</span>
+</span><span id="1-10">    <span class="n">Transaction</span><span class="p">,</span>
+</span><span id="1-11"><span class="p">)</span>
+</span><span id="1-12">
+</span><span id="1-13"><span class="kn">from</span> <span class="nn">sentry_sdk.utils</span> <span class="kn">import</span> <span class="p">(</span>
+</span><span id="1-14">    <span class="n">logger</span><span class="p">,</span>
+</span><span id="1-15">    <span class="n">ContextVar</span><span class="p">,</span>
+</span><span id="1-16"><span class="p">)</span>
+</span><span id="1-17">
+</span><span id="1-18"><span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="n">TYPE_CHECKING</span>
 </span><span id="1-19">
-</span><span id="1-20"><span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="n">TYPE_CHECKING</span>
-</span><span id="1-21">
-</span><span id="1-22"><span class="k">if</span> <span class="n">TYPE_CHECKING</span><span class="p">:</span>
-</span><span id="1-23">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Any</span>
-</span><span id="1-24">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Callable</span>
-</span><span id="1-25">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">ContextManager</span>
-</span><span id="1-26">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Dict</span>
-</span><span id="1-27">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Generator</span>
-</span><span id="1-28">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">List</span>
-</span><span id="1-29">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Optional</span>
-</span><span id="1-30">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">overload</span>
-</span><span id="1-31">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Tuple</span>
-</span><span id="1-32">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Type</span>
-</span><span id="1-33">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">TypeVar</span>
-</span><span id="1-34">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Union</span>
+</span><span id="1-20"><span class="k">if</span> <span class="n">TYPE_CHECKING</span><span class="p">:</span>
+</span><span id="1-21">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Any</span>
+</span><span id="1-22">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Callable</span>
+</span><span id="1-23">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">ContextManager</span>
+</span><span id="1-24">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Dict</span>
+</span><span id="1-25">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Generator</span>
+</span><span id="1-26">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">List</span>
+</span><span id="1-27">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Optional</span>
+</span><span id="1-28">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">overload</span>
+</span><span id="1-29">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Tuple</span>
+</span><span id="1-30">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Type</span>
+</span><span id="1-31">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">TypeVar</span>
+</span><span id="1-32">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Union</span>
+</span><span id="1-33">
+</span><span id="1-34">    <span class="kn">from</span> <span class="nn">typing_extensions</span> <span class="kn">import</span> <span class="n">Unpack</span>
 </span><span id="1-35">
-</span><span id="1-36">    <span class="kn">from</span> <span class="nn">sentry_sdk.integrations</span> <span class="kn">import</span> <span class="n">Integration</span>
-</span><span id="1-37">    <span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="p">(</span>
-</span><span id="1-38">        <span class="n">Event</span><span class="p">,</span>
-</span><span id="1-39">        <span class="n">Hint</span><span class="p">,</span>
-</span><span id="1-40">        <span class="n">Breadcrumb</span><span class="p">,</span>
-</span><span id="1-41">        <span class="n">BreadcrumbHint</span><span class="p">,</span>
-</span><span id="1-42">        <span class="n">ExcInfo</span><span class="p">,</span>
-</span><span id="1-43">        <span class="n">LogLevelStr</span><span class="p">,</span>
-</span><span id="1-44">    <span class="p">)</span>
-</span><span id="1-45">    <span class="kn">from</span> <span class="nn">sentry_sdk.consts</span> <span class="kn">import</span> <span class="n">ClientConstructor</span>
-</span><span id="1-46">
-</span><span id="1-47">    <span class="n">T</span> <span class="o">=</span> <span class="n">TypeVar</span><span class="p">(</span><span class="s2">&quot;T&quot;</span><span class="p">)</span>
-</span><span id="1-48">
-</span><span id="1-49"><span class="k">else</span><span class="p">:</span>
-</span><span id="1-50">
-</span><span id="1-51">    <span class="k">def</span> <span class="nf">overload</span><span class="p">(</span><span class="n">x</span><span class="p">):</span>
-</span><span id="1-52">        <span class="c1"># type: (T) -&gt; T</span>
-</span><span id="1-53">        <span class="k">return</span> <span class="n">x</span>
-</span><span id="1-54">
-</span><span id="1-55">
-</span><span id="1-56"><span class="n">_local</span> <span class="o">=</span> <span class="n">ContextVar</span><span class="p">(</span><span class="s2">&quot;sentry_current_hub&quot;</span><span class="p">)</span>
+</span><span id="1-36">    <span class="kn">from</span> <span class="nn">sentry_sdk.client</span> <span class="kn">import</span> <span class="n">BaseClient</span>
+</span><span id="1-37">    <span class="kn">from</span> <span class="nn">sentry_sdk.integrations</span> <span class="kn">import</span> <span class="n">Integration</span>
+</span><span id="1-38">    <span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="p">(</span>
+</span><span id="1-39">        <span class="n">Event</span><span class="p">,</span>
+</span><span id="1-40">        <span class="n">Hint</span><span class="p">,</span>
+</span><span id="1-41">        <span class="n">Breadcrumb</span><span class="p">,</span>
+</span><span id="1-42">        <span class="n">BreadcrumbHint</span><span class="p">,</span>
+</span><span id="1-43">        <span class="n">ExcInfo</span><span class="p">,</span>
+</span><span id="1-44">        <span class="n">LogLevelStr</span><span class="p">,</span>
+</span><span id="1-45">        <span class="n">SamplingContext</span><span class="p">,</span>
+</span><span id="1-46">    <span class="p">)</span>
+</span><span id="1-47">    <span class="kn">from</span> <span class="nn">sentry_sdk.consts</span> <span class="kn">import</span> <span class="n">ClientConstructor</span>
+</span><span id="1-48">    <span class="kn">from</span> <span class="nn">sentry_sdk.tracing</span> <span class="kn">import</span> <span class="n">TransactionKwargs</span>
+</span><span id="1-49">
+</span><span id="1-50">    <span class="n">T</span> <span class="o">=</span> <span class="n">TypeVar</span><span class="p">(</span><span class="s2">&quot;T&quot;</span><span class="p">)</span>
+</span><span id="1-51">
+</span><span id="1-52"><span class="k">else</span><span class="p">:</span>
+</span><span id="1-53">
+</span><span id="1-54">    <span class="k">def</span> <span class="nf">overload</span><span class="p">(</span><span class="n">x</span><span class="p">):</span>
+</span><span id="1-55">        <span class="c1"># type: (T) -&gt; T</span>
+</span><span id="1-56">        <span class="k">return</span> <span class="n">x</span>
 </span><span id="1-57">
 </span><span id="1-58">
-</span><span id="1-59"><span class="k">def</span> <span class="nf">_should_send_default_pii</span><span class="p">():</span>
-</span><span id="1-60">    <span class="c1"># type: () -&gt; bool</span>
-</span><span id="1-61">    <span class="n">client</span> <span class="o">=</span> <span class="n">Hub</span><span class="o">.</span><span class="n">current</span><span class="o">.</span><span class="n">client</span>
-</span><span id="1-62">    <span class="k">if</span> <span class="ow">not</span> <span class="n">client</span><span class="p">:</span>
-</span><span id="1-63">        <span class="k">return</span> <span class="kc">False</span>
-</span><span id="1-64">    <span class="k">return</span> <span class="n">client</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;send_default_pii&quot;</span><span class="p">]</span>
-</span><span id="1-65">
-</span><span id="1-66">
-</span><span id="1-67"><span class="k">class</span> <span class="nc">_InitGuard</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-</span><span id="1-68">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">client</span><span class="p">):</span>
-</span><span id="1-69">        <span class="c1"># type: (Client) -&gt; None</span>
-</span><span id="1-70">        <span class="bp">self</span><span class="o">.</span><span class="n">_client</span> <span class="o">=</span> <span class="n">client</span>
+</span><span id="1-59"><span class="n">_local</span> <span class="o">=</span> <span class="n">ContextVar</span><span class="p">(</span><span class="s2">&quot;sentry_current_hub&quot;</span><span class="p">)</span>
+</span><span id="1-60">
+</span><span id="1-61">
+</span><span id="1-62"><span class="k">def</span> <span class="nf">_should_send_default_pii</span><span class="p">():</span>
+</span><span id="1-63">    <span class="c1"># type: () -&gt; bool</span>
+</span><span id="1-64">    <span class="c1"># TODO: Migrate existing code to `scope.should_send_default_pii()` and remove this function.</span>
+</span><span id="1-65">    <span class="c1"># New code should not use this function!</span>
+</span><span id="1-66">    <span class="n">client</span> <span class="o">=</span> <span class="n">Hub</span><span class="o">.</span><span class="n">current</span><span class="o">.</span><span class="n">client</span>
+</span><span id="1-67">    <span class="k">if</span> <span class="ow">not</span> <span class="n">client</span><span class="p">:</span>
+</span><span id="1-68">        <span class="k">return</span> <span class="kc">False</span>
+</span><span id="1-69">    <span class="k">return</span> <span class="n">client</span><span class="o">.</span><span class="n">should_send_default_pii</span><span class="p">()</span>
+</span><span id="1-70">
 </span><span id="1-71">
-</span><span id="1-72">    <span class="k">def</span> <span class="fm">__enter__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-73">        <span class="c1"># type: () -&gt; _InitGuard</span>
-</span><span id="1-74">        <span class="k">return</span> <span class="bp">self</span>
-</span><span id="1-75">
-</span><span id="1-76">    <span class="k">def</span> <span class="fm">__exit__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">exc_type</span><span class="p">,</span> <span class="n">exc_value</span><span class="p">,</span> <span class="n">tb</span><span class="p">):</span>
-</span><span id="1-77">        <span class="c1"># type: (Any, Any, Any) -&gt; None</span>
-</span><span id="1-78">        <span class="n">c</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_client</span>
-</span><span id="1-79">        <span class="k">if</span> <span class="n">c</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-80">            <span class="n">c</span><span class="o">.</span><span class="n">close</span><span class="p">()</span>
-</span><span id="1-81">
-</span><span id="1-82">
-</span><span id="1-83"><span class="k">def</span> <span class="nf">_check_python_deprecations</span><span class="p">():</span>
-</span><span id="1-84">    <span class="c1"># type: () -&gt; None</span>
-</span><span id="1-85">    <span class="n">version</span> <span class="o">=</span> <span class="n">sys</span><span class="o">.</span><span class="n">version_info</span><span class="p">[:</span><span class="mi">2</span><span class="p">]</span>
+</span><span id="1-72"><span class="k">class</span> <span class="nc">_InitGuard</span><span class="p">:</span>
+</span><span id="1-73">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">client</span><span class="p">):</span>
+</span><span id="1-74">        <span class="c1"># type: (Client) -&gt; None</span>
+</span><span id="1-75">        <span class="bp">self</span><span class="o">.</span><span class="n">_client</span> <span class="o">=</span> <span class="n">client</span>
+</span><span id="1-76">
+</span><span id="1-77">    <span class="k">def</span> <span class="fm">__enter__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-78">        <span class="c1"># type: () -&gt; _InitGuard</span>
+</span><span id="1-79">        <span class="k">return</span> <span class="bp">self</span>
+</span><span id="1-80">
+</span><span id="1-81">    <span class="k">def</span> <span class="fm">__exit__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">exc_type</span><span class="p">,</span> <span class="n">exc_value</span><span class="p">,</span> <span class="n">tb</span><span class="p">):</span>
+</span><span id="1-82">        <span class="c1"># type: (Any, Any, Any) -&gt; None</span>
+</span><span id="1-83">        <span class="n">c</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_client</span>
+</span><span id="1-84">        <span class="k">if</span> <span class="n">c</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-85">            <span class="n">c</span><span class="o">.</span><span class="n">close</span><span class="p">()</span>
 </span><span id="1-86">
-</span><span id="1-87">    <span class="k">if</span> <span class="n">version</span> <span class="o">==</span> <span class="p">(</span><span class="mi">3</span><span class="p">,</span> <span class="mi">4</span><span class="p">)</span> <span class="ow">or</span> <span class="n">version</span> <span class="o">==</span> <span class="p">(</span><span class="mi">3</span><span class="p">,</span> <span class="mi">5</span><span class="p">):</span>
-</span><span id="1-88">        <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
-</span><span id="1-89">            <span class="s2">&quot;sentry-sdk 2.0.0 will drop support for Python </span><span class="si">%s</span><span class="s2">.&quot;</span><span class="p">,</span>
-</span><span id="1-90">            <span class="s2">&quot;</span><span class="si">{}</span><span class="s2">.</span><span class="si">{}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="o">*</span><span class="n">version</span><span class="p">),</span>
-</span><span id="1-91">        <span class="p">)</span>
-</span><span id="1-92">        <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
-</span><span id="1-93">            <span class="s2">&quot;Please upgrade to the latest version to continue receiving upgrades and bugfixes.&quot;</span>
-</span><span id="1-94">        <span class="p">)</span>
+</span><span id="1-87">
+</span><span id="1-88"><span class="k">def</span> <span class="nf">_check_python_deprecations</span><span class="p">():</span>
+</span><span id="1-89">    <span class="c1"># type: () -&gt; None</span>
+</span><span id="1-90">    <span class="c1"># Since we&#39;re likely to deprecate Python versions in the future, I&#39;m keeping</span>
+</span><span id="1-91">    <span class="c1"># this handy function around. Use this to detect the Python version used and</span>
+</span><span id="1-92">    <span class="c1"># to output logger.warning()s if it&#39;s deprecated.</span>
+</span><span id="1-93">    <span class="k">pass</span>
+</span><span id="1-94">
 </span><span id="1-95">
-</span><span id="1-96">
-</span><span id="1-97"><span class="k">def</span> <span class="nf">_init</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-</span><span id="1-98">    <span class="c1"># type: (*Optional[str], **Any) -&gt; ContextManager[Any]</span>
-</span><span id="1-99"><span class="w">    </span><span class="sd">&quot;&quot;&quot;Initializes the SDK and optionally integrations.</span>
-</span><span id="1-100">
-</span><span id="1-101"><span class="sd">    This takes the same arguments as the client constructor.</span>
-</span><span id="1-102"><span class="sd">    &quot;&quot;&quot;</span>
-</span><span id="1-103">    <span class="n">client</span> <span class="o">=</span> <span class="n">Client</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>  <span class="c1"># type: ignore</span>
-</span><span id="1-104">    <span class="n">Hub</span><span class="o">.</span><span class="n">current</span><span class="o">.</span><span class="n">bind_client</span><span class="p">(</span><span class="n">client</span><span class="p">)</span>
-</span><span id="1-105">    <span class="n">_check_python_deprecations</span><span class="p">()</span>
-</span><span id="1-106">    <span class="n">rv</span> <span class="o">=</span> <span class="n">_InitGuard</span><span class="p">(</span><span class="n">client</span><span class="p">)</span>
-</span><span id="1-107">    <span class="k">return</span> <span class="n">rv</span>
+</span><span id="1-96"><span class="k">def</span> <span class="nf">_init</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
+</span><span id="1-97">    <span class="c1"># type: (*Optional[str], **Any) -&gt; ContextManager[Any]</span>
+</span><span id="1-98"><span class="w">    </span><span class="sd">&quot;&quot;&quot;Initializes the SDK and optionally integrations.</span>
+</span><span id="1-99">
+</span><span id="1-100"><span class="sd">    This takes the same arguments as the client constructor.</span>
+</span><span id="1-101"><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="1-102">    <span class="n">client</span> <span class="o">=</span> <span class="n">Client</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>  <span class="c1"># type: ignore</span>
+</span><span id="1-103">    <span class="n">Hub</span><span class="o">.</span><span class="n">current</span><span class="o">.</span><span class="n">bind_client</span><span class="p">(</span><span class="n">client</span><span class="p">)</span>
+</span><span id="1-104">    <span class="n">_check_python_deprecations</span><span class="p">()</span>
+</span><span id="1-105">    <span class="n">rv</span> <span class="o">=</span> <span class="n">_InitGuard</span><span class="p">(</span><span class="n">client</span><span class="p">)</span>
+</span><span id="1-106">    <span class="k">return</span> <span class="n">rv</span>
+</span><span id="1-107">
 </span><span id="1-108">
-</span><span id="1-109">
-</span><span id="1-110"><span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="n">TYPE_CHECKING</span>
-</span><span id="1-111">
-</span><span id="1-112"><span class="k">if</span> <span class="n">TYPE_CHECKING</span><span class="p">:</span>
-</span><span id="1-113">    <span class="c1"># Make mypy, PyCharm and other static analyzers think `init` is a type to</span>
-</span><span id="1-114">    <span class="c1"># have nicer autocompletion for params.</span>
-</span><span id="1-115">    <span class="c1">#</span>
-</span><span id="1-116">    <span class="c1"># Use `ClientConstructor` to define the argument types of `init` and</span>
-</span><span id="1-117">    <span class="c1"># `ContextManager[Any]` to tell static analyzers about the return type.</span>
-</span><span id="1-118">
-</span><span id="1-119">    <span class="k">class</span> <span class="nc">init</span><span class="p">(</span><span class="n">ClientConstructor</span><span class="p">,</span> <span class="n">_InitGuard</span><span class="p">):</span>  <span class="c1"># noqa: N801</span>
-</span><span id="1-120">        <span class="k">pass</span>
-</span><span id="1-121">
-</span><span id="1-122"><span class="k">else</span><span class="p">:</span>
-</span><span id="1-123">    <span class="c1"># Alias `init` for actual usage. Go through the lambda indirection to throw</span>
-</span><span id="1-124">    <span class="c1"># PyCharm off of the weakly typed signature (it would otherwise discover</span>
-</span><span id="1-125">    <span class="c1"># both the weakly typed signature of `_init` and our faked `init` type).</span>
-</span><span id="1-126">
-</span><span id="1-127">    <span class="n">init</span> <span class="o">=</span> <span class="p">(</span><span class="k">lambda</span><span class="p">:</span> <span class="n">_init</span><span class="p">)()</span>
+</span><span id="1-109"><span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="n">TYPE_CHECKING</span>
+</span><span id="1-110">
+</span><span id="1-111"><span class="k">if</span> <span class="n">TYPE_CHECKING</span><span class="p">:</span>
+</span><span id="1-112">    <span class="c1"># Make mypy, PyCharm and other static analyzers think `init` is a type to</span>
+</span><span id="1-113">    <span class="c1"># have nicer autocompletion for params.</span>
+</span><span id="1-114">    <span class="c1">#</span>
+</span><span id="1-115">    <span class="c1"># Use `ClientConstructor` to define the argument types of `init` and</span>
+</span><span id="1-116">    <span class="c1"># `ContextManager[Any]` to tell static analyzers about the return type.</span>
+</span><span id="1-117">
+</span><span id="1-118">    <span class="k">class</span> <span class="nc">init</span><span class="p">(</span><span class="n">ClientConstructor</span><span class="p">,</span> <span class="n">_InitGuard</span><span class="p">):</span>  <span class="c1"># noqa: N801</span>
+</span><span id="1-119">        <span class="k">pass</span>
+</span><span id="1-120">
+</span><span id="1-121"><span class="k">else</span><span class="p">:</span>
+</span><span id="1-122">    <span class="c1"># Alias `init` for actual usage. Go through the lambda indirection to throw</span>
+</span><span id="1-123">    <span class="c1"># PyCharm off of the weakly typed signature (it would otherwise discover</span>
+</span><span id="1-124">    <span class="c1"># both the weakly typed signature of `_init` and our faked `init` type).</span>
+</span><span id="1-125">
+</span><span id="1-126">    <span class="n">init</span> <span class="o">=</span> <span class="p">(</span><span class="k">lambda</span><span class="p">:</span> <span class="n">_init</span><span class="p">)()</span>
+</span><span id="1-127">
 </span><span id="1-128">
-</span><span id="1-129">
-</span><span id="1-130"><span class="k">class</span> <span class="nc">HubMeta</span><span class="p">(</span><span class="nb">type</span><span class="p">):</span>
-</span><span id="1-131">    <span class="nd">@property</span>
-</span><span id="1-132">    <span class="k">def</span> <span class="nf">current</span><span class="p">(</span><span class="bp">cls</span><span class="p">):</span>
-</span><span id="1-133">        <span class="c1"># type: () -&gt; Hub</span>
-</span><span id="1-134"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Returns the current instance of the hub.&quot;&quot;&quot;</span>
-</span><span id="1-135">        <span class="n">rv</span> <span class="o">=</span> <span class="n">_local</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="kc">None</span><span class="p">)</span>
-</span><span id="1-136">        <span class="k">if</span> <span class="n">rv</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-137">            <span class="n">rv</span> <span class="o">=</span> <span class="n">Hub</span><span class="p">(</span><span class="n">GLOBAL_HUB</span><span class="p">)</span>
-</span><span id="1-138">            <span class="n">_local</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="n">rv</span><span class="p">)</span>
-</span><span id="1-139">        <span class="k">return</span> <span class="n">rv</span>
-</span><span id="1-140">
-</span><span id="1-141">    <span class="nd">@property</span>
-</span><span id="1-142">    <span class="k">def</span> <span class="nf">main</span><span class="p">(</span><span class="bp">cls</span><span class="p">):</span>
-</span><span id="1-143">        <span class="c1"># type: () -&gt; Hub</span>
-</span><span id="1-144"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Returns the main instance of the hub.&quot;&quot;&quot;</span>
-</span><span id="1-145">        <span class="k">return</span> <span class="n">GLOBAL_HUB</span>
+</span><span id="1-129"><span class="k">class</span> <span class="nc">HubMeta</span><span class="p">(</span><span class="nb">type</span><span class="p">):</span>
+</span><span id="1-130">    <span class="nd">@property</span>
+</span><span id="1-131">    <span class="k">def</span> <span class="nf">current</span><span class="p">(</span><span class="bp">cls</span><span class="p">):</span>
+</span><span id="1-132">        <span class="c1"># type: () -&gt; Hub</span>
+</span><span id="1-133"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Returns the current instance of the hub.&quot;&quot;&quot;</span>
+</span><span id="1-134">        <span class="n">rv</span> <span class="o">=</span> <span class="n">_local</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="kc">None</span><span class="p">)</span>
+</span><span id="1-135">        <span class="k">if</span> <span class="n">rv</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-136">            <span class="n">rv</span> <span class="o">=</span> <span class="n">Hub</span><span class="p">(</span><span class="n">GLOBAL_HUB</span><span class="p">)</span>
+</span><span id="1-137">            <span class="n">_local</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="n">rv</span><span class="p">)</span>
+</span><span id="1-138">        <span class="k">return</span> <span class="n">rv</span>
+</span><span id="1-139">
+</span><span id="1-140">    <span class="nd">@property</span>
+</span><span id="1-141">    <span class="k">def</span> <span class="nf">main</span><span class="p">(</span><span class="bp">cls</span><span class="p">):</span>
+</span><span id="1-142">        <span class="c1"># type: () -&gt; Hub</span>
+</span><span id="1-143"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Returns the main instance of the hub.&quot;&quot;&quot;</span>
+</span><span id="1-144">        <span class="k">return</span> <span class="n">GLOBAL_HUB</span>
+</span><span id="1-145">
 </span><span id="1-146">
-</span><span id="1-147">
-</span><span id="1-148"><span class="k">class</span> <span class="nc">_ScopeManager</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-</span><span id="1-149">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">hub</span><span class="p">):</span>
-</span><span id="1-150">        <span class="c1"># type: (Hub) -&gt; None</span>
-</span><span id="1-151">        <span class="bp">self</span><span class="o">.</span><span class="n">_hub</span> <span class="o">=</span> <span class="n">hub</span>
-</span><span id="1-152">        <span class="bp">self</span><span class="o">.</span><span class="n">_original_len</span> <span class="o">=</span> <span class="nb">len</span><span class="p">(</span><span class="n">hub</span><span class="o">.</span><span class="n">_stack</span><span class="p">)</span>
-</span><span id="1-153">        <span class="bp">self</span><span class="o">.</span><span class="n">_layer</span> <span class="o">=</span> <span class="n">hub</span><span class="o">.</span><span class="n">_stack</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span>
-</span><span id="1-154">
-</span><span id="1-155">    <span class="k">def</span> <span class="fm">__enter__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-156">        <span class="c1"># type: () -&gt; Scope</span>
-</span><span id="1-157">        <span class="n">scope</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_layer</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span>
-</span><span id="1-158">        <span class="k">assert</span> <span class="n">scope</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span>
-</span><span id="1-159">        <span class="k">return</span> <span class="n">scope</span>
-</span><span id="1-160">
-</span><span id="1-161">    <span class="k">def</span> <span class="fm">__exit__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">exc_type</span><span class="p">,</span> <span class="n">exc_value</span><span class="p">,</span> <span class="n">tb</span><span class="p">):</span>
-</span><span id="1-162">        <span class="c1"># type: (Any, Any, Any) -&gt; None</span>
-</span><span id="1-163">        <span class="n">current_len</span> <span class="o">=</span> <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_hub</span><span class="o">.</span><span class="n">_stack</span><span class="p">)</span>
-</span><span id="1-164">        <span class="k">if</span> <span class="n">current_len</span> <span class="o">&lt;</span> <span class="bp">self</span><span class="o">.</span><span class="n">_original_len</span><span class="p">:</span>
-</span><span id="1-165">            <span class="n">logger</span><span class="o">.</span><span class="n">error</span><span class="p">(</span>
-</span><span id="1-166">                <span class="s2">&quot;Scope popped too soon. Popped </span><span class="si">%s</span><span class="s2"> scopes too many.&quot;</span><span class="p">,</span>
-</span><span id="1-167">                <span class="bp">self</span><span class="o">.</span><span class="n">_original_len</span> <span class="o">-</span> <span class="n">current_len</span><span class="p">,</span>
-</span><span id="1-168">            <span class="p">)</span>
-</span><span id="1-169">            <span class="k">return</span>
-</span><span id="1-170">        <span class="k">elif</span> <span class="n">current_len</span> <span class="o">&gt;</span> <span class="bp">self</span><span class="o">.</span><span class="n">_original_len</span><span class="p">:</span>
-</span><span id="1-171">            <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
-</span><span id="1-172">                <span class="s2">&quot;Leaked </span><span class="si">%s</span><span class="s2"> scopes: </span><span class="si">%s</span><span class="s2">&quot;</span><span class="p">,</span>
-</span><span id="1-173">                <span class="n">current_len</span> <span class="o">-</span> <span class="bp">self</span><span class="o">.</span><span class="n">_original_len</span><span class="p">,</span>
-</span><span id="1-174">                <span class="bp">self</span><span class="o">.</span><span class="n">_hub</span><span class="o">.</span><span class="n">_stack</span><span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">_original_len</span> <span class="p">:],</span>
-</span><span id="1-175">            <span class="p">)</span>
-</span><span id="1-176">
-</span><span id="1-177">        <span class="n">layer</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_hub</span><span class="o">.</span><span class="n">_stack</span><span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">_original_len</span> <span class="o">-</span> <span class="mi">1</span><span class="p">]</span>
-</span><span id="1-178">        <span class="k">del</span> <span class="bp">self</span><span class="o">.</span><span class="n">_hub</span><span class="o">.</span><span class="n">_stack</span><span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">_original_len</span> <span class="o">-</span> <span class="mi">1</span> <span class="p">:]</span>
-</span><span id="1-179">
-</span><span id="1-180">        <span class="k">if</span> <span class="n">layer</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span> <span class="o">!=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_layer</span><span class="p">[</span><span class="mi">1</span><span class="p">]:</span>
-</span><span id="1-181">            <span class="n">logger</span><span class="o">.</span><span class="n">error</span><span class="p">(</span>
-</span><span id="1-182">                <span class="s2">&quot;Wrong scope found. Meant to pop </span><span class="si">%s</span><span class="s2">, but popped </span><span class="si">%s</span><span class="s2">.&quot;</span><span class="p">,</span>
-</span><span id="1-183">                <span class="n">layer</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span>
-</span><span id="1-184">                <span class="bp">self</span><span class="o">.</span><span class="n">_layer</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span>
-</span><span id="1-185">            <span class="p">)</span>
-</span><span id="1-186">        <span class="k">elif</span> <span class="n">layer</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">!=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_layer</span><span class="p">[</span><span class="mi">0</span><span class="p">]:</span>
-</span><span id="1-187">            <span class="n">warning</span> <span class="o">=</span> <span class="p">(</span>
-</span><span id="1-188">                <span class="s2">&quot;init() called inside of pushed scope. This might be entirely &quot;</span>
-</span><span id="1-189">                <span class="s2">&quot;legitimate but usually occurs when initializing the SDK inside &quot;</span>
-</span><span id="1-190">                <span class="s2">&quot;a request handler or task/job function. Try to initialize the &quot;</span>
-</span><span id="1-191">                <span class="s2">&quot;SDK as early as possible instead.&quot;</span>
-</span><span id="1-192">            <span class="p">)</span>
-</span><span id="1-193">            <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span><span class="n">warning</span><span class="p">)</span>
-</span><span id="1-194">
-</span><span id="1-195">
 <div class="viewcode-block" id="Hub">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Hub">[docs]</a>
-</span><span id="1-196"><span class="k">class</span> <span class="nc">Hub</span><span class="p">(</span><span class="n">with_metaclass</span><span class="p">(</span><span class="n">HubMeta</span><span class="p">)):</span>  <span class="c1"># type: ignore</span>
-</span><span id="1-197"><span class="w">    </span><span class="sd">&quot;&quot;&quot;The hub wraps the concurrency management of the SDK.  Each thread has</span>
-</span><span id="1-198"><span class="sd">    its own hub but the hub might transfer with the flow of execution if</span>
-</span><span id="1-199"><span class="sd">    context vars are available.</span>
-</span><span id="1-200">
-</span><span id="1-201"><span class="sd">    If the hub is used with a with statement it&#39;s temporarily activated.</span>
-</span><span id="1-202"><span class="sd">    &quot;&quot;&quot;</span>
-</span><span id="1-203">
-</span><span id="1-204">    <span class="n">_stack</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: List[Tuple[Optional[Client], Scope]]</span>
-</span><span id="1-205">
-</span><span id="1-206">    <span class="c1"># Mypy doesn&#39;t pick up on the metaclass.</span>
-</span><span id="1-207">
-</span><span id="1-208">    <span class="k">if</span> <span class="n">TYPE_CHECKING</span><span class="p">:</span>
-</span><span id="1-209">        <span class="n">current</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Hub</span>
-</span><span id="1-210">        <span class="n">main</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Hub</span>
-</span><span id="1-211">
-</span><span id="1-212">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
-</span><span id="1-213">        <span class="bp">self</span><span class="p">,</span>
-</span><span id="1-214">        <span class="n">client_or_hub</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Union[Hub, Client]]</span>
-</span><span id="1-215">        <span class="n">scope</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Any]</span>
-</span><span id="1-216">    <span class="p">):</span>
-</span><span id="1-217">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-218">        <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">client_or_hub</span><span class="p">,</span> <span class="n">Hub</span><span class="p">):</span>
-</span><span id="1-219">            <span class="n">hub</span> <span class="o">=</span> <span class="n">client_or_hub</span>
-</span><span id="1-220">            <span class="n">client</span><span class="p">,</span> <span class="n">other_scope</span> <span class="o">=</span> <span class="n">hub</span><span class="o">.</span><span class="n">_stack</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span>
-</span><span id="1-221">            <span class="k">if</span> <span class="n">scope</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-222">                <span class="n">scope</span> <span class="o">=</span> <span class="n">copy</span><span class="o">.</span><span class="n">copy</span><span class="p">(</span><span class="n">other_scope</span><span class="p">)</span>
-</span><span id="1-223">        <span class="k">else</span><span class="p">:</span>
-</span><span id="1-224">            <span class="n">client</span> <span class="o">=</span> <span class="n">client_or_hub</span>
-</span><span id="1-225">        <span class="k">if</span> <span class="n">scope</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-226">            <span class="n">scope</span> <span class="o">=</span> <span class="n">Scope</span><span class="p">()</span>
-</span><span id="1-227">
-</span><span id="1-228">        <span class="bp">self</span><span class="o">.</span><span class="n">_stack</span> <span class="o">=</span> <span class="p">[(</span><span class="n">client</span><span class="p">,</span> <span class="n">scope</span><span class="p">)]</span>
-</span><span id="1-229">        <span class="bp">self</span><span class="o">.</span><span class="n">_last_event_id</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[str]</span>
-</span><span id="1-230">        <span class="bp">self</span><span class="o">.</span><span class="n">_old_hubs</span> <span class="o">=</span> <span class="p">[]</span>  <span class="c1"># type: List[Hub]</span>
-</span><span id="1-231">
-</span><span id="1-232">    <span class="k">def</span> <span class="fm">__enter__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-233">        <span class="c1"># type: () -&gt; Hub</span>
-</span><span id="1-234">        <span class="bp">self</span><span class="o">.</span><span class="n">_old_hubs</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">Hub</span><span class="o">.</span><span class="n">current</span><span class="p">)</span>
-</span><span id="1-235">        <span class="n">_local</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-</span><span id="1-236">        <span class="k">return</span> <span class="bp">self</span>
-</span><span id="1-237">
-</span><span id="1-238">    <span class="k">def</span> <span class="fm">__exit__</span><span class="p">(</span>
-</span><span id="1-239">        <span class="bp">self</span><span class="p">,</span>
-</span><span id="1-240">        <span class="n">exc_type</span><span class="p">,</span>  <span class="c1"># type: Optional[type]</span>
-</span><span id="1-241">        <span class="n">exc_value</span><span class="p">,</span>  <span class="c1"># type: Optional[BaseException]</span>
-</span><span id="1-242">        <span class="n">tb</span><span class="p">,</span>  <span class="c1"># type: Optional[Any]</span>
-</span><span id="1-243">    <span class="p">):</span>
-</span><span id="1-244">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-245">        <span class="n">old</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_old_hubs</span><span class="o">.</span><span class="n">pop</span><span class="p">()</span>
-</span><span id="1-246">        <span class="n">_local</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="n">old</span><span class="p">)</span>
-</span><span id="1-247">
+</span><span id="1-147"><span class="k">class</span> <span class="nc">Hub</span><span class="p">(</span><span class="n">with_metaclass</span><span class="p">(</span><span class="n">HubMeta</span><span class="p">)):</span>  <span class="c1"># type: ignore</span>
+</span><span id="1-148"><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-149"><span class="sd">    .. deprecated:: 2.0.0</span>
+</span><span id="1-150"><span class="sd">        The Hub is deprecated. Its functionality will be merged into :py:class:`sentry_sdk.scope.Scope`.</span>
+</span><span id="1-151">
+</span><span id="1-152"><span class="sd">    The hub wraps the concurrency management of the SDK.  Each thread has</span>
+</span><span id="1-153"><span class="sd">    its own hub but the hub might transfer with the flow of execution if</span>
+</span><span id="1-154"><span class="sd">    context vars are available.</span>
+</span><span id="1-155">
+</span><span id="1-156"><span class="sd">    If the hub is used with a with statement it&#39;s temporarily activated.</span>
+</span><span id="1-157"><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="1-158">
+</span><span id="1-159">    <span class="n">_stack</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: List[Tuple[Optional[Client], Scope]]</span>
+</span><span id="1-160">    <span class="n">_scope</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[Scope]</span>
+</span><span id="1-161">
+</span><span id="1-162">    <span class="c1"># Mypy doesn&#39;t pick up on the metaclass.</span>
+</span><span id="1-163">
+</span><span id="1-164">    <span class="k">if</span> <span class="n">TYPE_CHECKING</span><span class="p">:</span>
+</span><span id="1-165">        <span class="n">current</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Hub</span>
+</span><span id="1-166">        <span class="n">main</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Hub</span>
+</span><span id="1-167">
+</span><span id="1-168">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
+</span><span id="1-169">        <span class="bp">self</span><span class="p">,</span>
+</span><span id="1-170">        <span class="n">client_or_hub</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Union[Hub, Client]]</span>
+</span><span id="1-171">        <span class="n">scope</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Any]</span>
+</span><span id="1-172">    <span class="p">):</span>
+</span><span id="1-173">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-174">
+</span><span id="1-175">        <span class="n">current_scope</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="1-176">
+</span><span id="1-177">        <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">client_or_hub</span><span class="p">,</span> <span class="n">Hub</span><span class="p">):</span>
+</span><span id="1-178">            <span class="n">client</span> <span class="o">=</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_client</span><span class="p">()</span>
+</span><span id="1-179">            <span class="k">if</span> <span class="n">scope</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-180">                <span class="c1"># hub cloning is going on, we use a fork of the current/isolation scope for context manager</span>
+</span><span id="1-181">                <span class="n">scope</span> <span class="o">=</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_isolation_scope</span><span class="p">()</span><span class="o">.</span><span class="n">fork</span><span class="p">()</span>
+</span><span id="1-182">                <span class="n">current_scope</span> <span class="o">=</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_current_scope</span><span class="p">()</span><span class="o">.</span><span class="n">fork</span><span class="p">()</span>
+</span><span id="1-183">        <span class="k">else</span><span class="p">:</span>
+</span><span id="1-184">            <span class="n">client</span> <span class="o">=</span> <span class="n">client_or_hub</span>  <span class="c1"># type: ignore</span>
+</span><span id="1-185">            <span class="n">Scope</span><span class="o">.</span><span class="n">get_global_scope</span><span class="p">()</span><span class="o">.</span><span class="n">set_client</span><span class="p">(</span><span class="n">client</span><span class="p">)</span>
+</span><span id="1-186">
+</span><span id="1-187">        <span class="k">if</span> <span class="n">scope</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>  <span class="c1"># so there is no Hub cloning going on</span>
+</span><span id="1-188">            <span class="c1"># just the current isolation scope is used for context manager</span>
+</span><span id="1-189">            <span class="n">scope</span> <span class="o">=</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_isolation_scope</span><span class="p">()</span>
+</span><span id="1-190">            <span class="n">current_scope</span> <span class="o">=</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_current_scope</span><span class="p">()</span>
+</span><span id="1-191">
+</span><span id="1-192">        <span class="k">if</span> <span class="n">current_scope</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-193">            <span class="c1"># just the current current scope is used for context manager</span>
+</span><span id="1-194">            <span class="n">current_scope</span> <span class="o">=</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_current_scope</span><span class="p">()</span>
+</span><span id="1-195">
+</span><span id="1-196">        <span class="bp">self</span><span class="o">.</span><span class="n">_stack</span> <span class="o">=</span> <span class="p">[(</span><span class="n">client</span><span class="p">,</span> <span class="n">scope</span><span class="p">)]</span>  <span class="c1"># type: ignore</span>
+</span><span id="1-197">        <span class="bp">self</span><span class="o">.</span><span class="n">_last_event_id</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[str]</span>
+</span><span id="1-198">        <span class="bp">self</span><span class="o">.</span><span class="n">_old_hubs</span> <span class="o">=</span> <span class="p">[]</span>  <span class="c1"># type: List[Hub]</span>
+</span><span id="1-199">
+</span><span id="1-200">        <span class="bp">self</span><span class="o">.</span><span class="n">_old_current_scopes</span> <span class="o">=</span> <span class="p">[]</span>  <span class="c1"># type: List[Scope]</span>
+</span><span id="1-201">        <span class="bp">self</span><span class="o">.</span><span class="n">_old_isolation_scopes</span> <span class="o">=</span> <span class="p">[]</span>  <span class="c1"># type: List[Scope]</span>
+</span><span id="1-202">        <span class="bp">self</span><span class="o">.</span><span class="n">_current_scope</span> <span class="o">=</span> <span class="n">current_scope</span>  <span class="c1"># type: Scope</span>
+</span><span id="1-203">        <span class="bp">self</span><span class="o">.</span><span class="n">_scope</span> <span class="o">=</span> <span class="n">scope</span>  <span class="c1"># type: Scope</span>
+</span><span id="1-204">
+</span><span id="1-205">    <span class="k">def</span> <span class="fm">__enter__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-206">        <span class="c1"># type: () -&gt; Hub</span>
+</span><span id="1-207">        <span class="bp">self</span><span class="o">.</span><span class="n">_old_hubs</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">Hub</span><span class="o">.</span><span class="n">current</span><span class="p">)</span>
+</span><span id="1-208">        <span class="n">_local</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
+</span><span id="1-209">
+</span><span id="1-210">        <span class="n">current_scope</span> <span class="o">=</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_current_scope</span><span class="p">()</span>
+</span><span id="1-211">        <span class="bp">self</span><span class="o">.</span><span class="n">_old_current_scopes</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">current_scope</span><span class="p">)</span>
+</span><span id="1-212">        <span class="n">scope</span><span class="o">.</span><span class="n">_current_scope</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_current_scope</span><span class="p">)</span>
+</span><span id="1-213">
+</span><span id="1-214">        <span class="n">isolation_scope</span> <span class="o">=</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_isolation_scope</span><span class="p">()</span>
+</span><span id="1-215">        <span class="bp">self</span><span class="o">.</span><span class="n">_old_isolation_scopes</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">isolation_scope</span><span class="p">)</span>
+</span><span id="1-216">        <span class="n">scope</span><span class="o">.</span><span class="n">_isolation_scope</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_scope</span><span class="p">)</span>
+</span><span id="1-217">
+</span><span id="1-218">        <span class="k">return</span> <span class="bp">self</span>
+</span><span id="1-219">
+</span><span id="1-220">    <span class="k">def</span> <span class="fm">__exit__</span><span class="p">(</span>
+</span><span id="1-221">        <span class="bp">self</span><span class="p">,</span>
+</span><span id="1-222">        <span class="n">exc_type</span><span class="p">,</span>  <span class="c1"># type: Optional[type]</span>
+</span><span id="1-223">        <span class="n">exc_value</span><span class="p">,</span>  <span class="c1"># type: Optional[BaseException]</span>
+</span><span id="1-224">        <span class="n">tb</span><span class="p">,</span>  <span class="c1"># type: Optional[Any]</span>
+</span><span id="1-225">    <span class="p">):</span>
+</span><span id="1-226">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-227">        <span class="n">old</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_old_hubs</span><span class="o">.</span><span class="n">pop</span><span class="p">()</span>
+</span><span id="1-228">        <span class="n">_local</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="n">old</span><span class="p">)</span>
+</span><span id="1-229">
+</span><span id="1-230">        <span class="n">old_current_scope</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_old_current_scopes</span><span class="o">.</span><span class="n">pop</span><span class="p">()</span>
+</span><span id="1-231">        <span class="n">scope</span><span class="o">.</span><span class="n">_current_scope</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="n">old_current_scope</span><span class="p">)</span>
+</span><span id="1-232">
+</span><span id="1-233">        <span class="n">old_isolation_scope</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_old_isolation_scopes</span><span class="o">.</span><span class="n">pop</span><span class="p">()</span>
+</span><span id="1-234">        <span class="n">scope</span><span class="o">.</span><span class="n">_isolation_scope</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="n">old_isolation_scope</span><span class="p">)</span>
+</span><span id="1-235">
 <div class="viewcode-block" id="Hub.run">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Hub.run">[docs]</a>
-</span><span id="1-248">    <span class="k">def</span> <span class="nf">run</span><span class="p">(</span>
-</span><span id="1-249">        <span class="bp">self</span><span class="p">,</span> <span class="n">callback</span>  <span class="c1"># type: Callable[[], T]</span>
-</span><span id="1-250">    <span class="p">):</span>
-</span><span id="1-251">        <span class="c1"># type: (...) -&gt; T</span>
-</span><span id="1-252"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Runs a callback in the context of the hub.  Alternatively the</span>
-</span><span id="1-253"><span class="sd">        with statement can be used on the hub directly.</span>
-</span><span id="1-254"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-255">        <span class="k">with</span> <span class="bp">self</span><span class="p">:</span>
-</span><span id="1-256">            <span class="k">return</span> <span class="n">callback</span><span class="p">()</span></div>
+</span><span id="1-236">    <span class="k">def</span> <span class="nf">run</span><span class="p">(</span>
+</span><span id="1-237">        <span class="bp">self</span><span class="p">,</span> <span class="n">callback</span>  <span class="c1"># type: Callable[[], T]</span>
+</span><span id="1-238">    <span class="p">):</span>
+</span><span id="1-239">        <span class="c1"># type: (...) -&gt; T</span>
+</span><span id="1-240"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-241"><span class="sd">        .. deprecated:: 2.0.0</span>
+</span><span id="1-242"><span class="sd">            This function is deprecated and will be removed in a future release.</span>
+</span><span id="1-243">
+</span><span id="1-244"><span class="sd">        Runs a callback in the context of the hub.  Alternatively the</span>
+</span><span id="1-245"><span class="sd">        with statement can be used on the hub directly.</span>
+</span><span id="1-246"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-247">        <span class="k">with</span> <span class="bp">self</span><span class="p">:</span>
+</span><span id="1-248">            <span class="k">return</span> <span class="n">callback</span><span class="p">()</span></div>
 
-</span><span id="1-257">
+</span><span id="1-249">
 <div class="viewcode-block" id="Hub.get_integration">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Hub.get_integration">[docs]</a>
-</span><span id="1-258">    <span class="k">def</span> <span class="nf">get_integration</span><span class="p">(</span>
-</span><span id="1-259">        <span class="bp">self</span><span class="p">,</span> <span class="n">name_or_class</span>  <span class="c1"># type: Union[str, Type[Integration]]</span>
-</span><span id="1-260">    <span class="p">):</span>
-</span><span id="1-261">        <span class="c1"># type: (...) -&gt; Any</span>
-</span><span id="1-262"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Returns the integration for this hub by name or class.  If there</span>
-</span><span id="1-263"><span class="sd">        is no client bound or the client does not have that integration</span>
-</span><span id="1-264"><span class="sd">        then `None` is returned.</span>
-</span><span id="1-265">
-</span><span id="1-266"><span class="sd">        If the return value is not `None` the hub is guaranteed to have a</span>
-</span><span id="1-267"><span class="sd">        client attached.</span>
-</span><span id="1-268"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-269">        <span class="n">client</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">client</span>
-</span><span id="1-270">        <span class="k">if</span> <span class="n">client</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-271">            <span class="k">return</span> <span class="n">client</span><span class="o">.</span><span class="n">get_integration</span><span class="p">(</span><span class="n">name_or_class</span><span class="p">)</span></div>
+</span><span id="1-250">    <span class="k">def</span> <span class="nf">get_integration</span><span class="p">(</span>
+</span><span id="1-251">        <span class="bp">self</span><span class="p">,</span> <span class="n">name_or_class</span>  <span class="c1"># type: Union[str, Type[Integration]]</span>
+</span><span id="1-252">    <span class="p">):</span>
+</span><span id="1-253">        <span class="c1"># type: (...) -&gt; Any</span>
+</span><span id="1-254"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-255"><span class="sd">        .. deprecated:: 2.0.0</span>
+</span><span id="1-256"><span class="sd">            This function is deprecated and will be removed in a future release.</span>
+</span><span id="1-257"><span class="sd">            Please use :py:meth:`sentry_sdk.client._Client.get_integration` instead.</span>
+</span><span id="1-258">
+</span><span id="1-259"><span class="sd">        Returns the integration for this hub by name or class.  If there</span>
+</span><span id="1-260"><span class="sd">        is no client bound or the client does not have that integration</span>
+</span><span id="1-261"><span class="sd">        then `None` is returned.</span>
+</span><span id="1-262">
+</span><span id="1-263"><span class="sd">        If the return value is not `None` the hub is guaranteed to have a</span>
+</span><span id="1-264"><span class="sd">        client attached.</span>
+</span><span id="1-265"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-266">        <span class="k">return</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_client</span><span class="p">()</span><span class="o">.</span><span class="n">get_integration</span><span class="p">(</span><span class="n">name_or_class</span><span class="p">)</span></div>
 
-</span><span id="1-272">
-</span><span id="1-273">    <span class="nd">@property</span>
-</span><span id="1-274">    <span class="k">def</span> <span class="nf">client</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-275">        <span class="c1"># type: () -&gt; Optional[Client]</span>
-</span><span id="1-276"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Returns the current client on the hub.&quot;&quot;&quot;</span>
-</span><span id="1-277">        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_stack</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">][</span><span class="mi">0</span><span class="p">]</span>
-</span><span id="1-278">
-</span><span id="1-279">    <span class="nd">@property</span>
-</span><span id="1-280">    <span class="k">def</span> <span class="nf">scope</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-281">        <span class="c1"># type: () -&gt; Scope</span>
-</span><span id="1-282"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Returns the current scope on the hub.&quot;&quot;&quot;</span>
-</span><span id="1-283">        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_stack</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">][</span><span class="mi">1</span><span class="p">]</span>
+</span><span id="1-267">
+</span><span id="1-268">    <span class="nd">@property</span>
+</span><span id="1-269">    <span class="k">def</span> <span class="nf">client</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-270">        <span class="c1"># type: () -&gt; Optional[BaseClient]</span>
+</span><span id="1-271"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-272"><span class="sd">        .. deprecated:: 2.0.0</span>
+</span><span id="1-273"><span class="sd">            This property is deprecated and will be removed in a future release.</span>
+</span><span id="1-274"><span class="sd">            Please use :py:func:`sentry_sdk.api.get_client` instead.</span>
+</span><span id="1-275">
+</span><span id="1-276"><span class="sd">        Returns the current client on the hub.</span>
+</span><span id="1-277"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-278">        <span class="n">client</span> <span class="o">=</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_client</span><span class="p">()</span>
+</span><span id="1-279">
+</span><span id="1-280">        <span class="k">if</span> <span class="ow">not</span> <span class="n">client</span><span class="o">.</span><span class="n">is_active</span><span class="p">():</span>
+</span><span id="1-281">            <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-282">
+</span><span id="1-283">        <span class="k">return</span> <span class="n">client</span>
 </span><span id="1-284">
+</span><span id="1-285">    <span class="nd">@property</span>
+</span><span id="1-286">    <span class="k">def</span> <span class="nf">scope</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-287">        <span class="c1"># type: () -&gt; Scope</span>
+</span><span id="1-288"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-289"><span class="sd">        .. deprecated:: 2.0.0</span>
+</span><span id="1-290"><span class="sd">            This property is deprecated and will be removed in a future release.</span>
+</span><span id="1-291"><span class="sd">            Returns the current scope on the hub.</span>
+</span><span id="1-292"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-293">        <span class="k">return</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_isolation_scope</span><span class="p">()</span>
+</span><span id="1-294">
 <div class="viewcode-block" id="Hub.last_event_id">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Hub.last_event_id">[docs]</a>
-</span><span id="1-285">    <span class="k">def</span> <span class="nf">last_event_id</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-286">        <span class="c1"># type: () -&gt; Optional[str]</span>
-</span><span id="1-287"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-288"><span class="sd">        Returns the last event ID.</span>
-</span><span id="1-289">
-</span><span id="1-290"><span class="sd">        .. deprecated:: 1.40.5</span>
-</span><span id="1-291"><span class="sd">            This function is deprecated and will be removed in a future release. The functions `capture_event`, `capture_message`, and `capture_exception` return the event ID directly.</span>
-</span><span id="1-292"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-293">        <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
-</span><span id="1-294">            <span class="s2">&quot;Deprecated: last_event_id is deprecated. This will be removed in the future. The functions `capture_event`, `capture_message`, and `capture_exception` return the event ID directly.&quot;</span>
-</span><span id="1-295">        <span class="p">)</span>
-</span><span id="1-296">        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_last_event_id</span></div>
+</span><span id="1-295">    <span class="k">def</span> <span class="nf">last_event_id</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-296">        <span class="c1"># type: () -&gt; Optional[str]</span>
+</span><span id="1-297"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-298"><span class="sd">        Returns the last event ID.</span>
+</span><span id="1-299">
+</span><span id="1-300"><span class="sd">        .. deprecated:: 1.40.5</span>
+</span><span id="1-301"><span class="sd">            This function is deprecated and will be removed in a future release. The functions `capture_event`, `capture_message`, and `capture_exception` return the event ID directly.</span>
+</span><span id="1-302"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-303">        <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
+</span><span id="1-304">            <span class="s2">&quot;Deprecated: last_event_id is deprecated. This will be removed in the future. The functions `capture_event`, `capture_message`, and `capture_exception` return the event ID directly.&quot;</span>
+</span><span id="1-305">        <span class="p">)</span>
+</span><span id="1-306">        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_last_event_id</span></div>
 
-</span><span id="1-297">
+</span><span id="1-307">
 <div class="viewcode-block" id="Hub.bind_client">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Hub.bind_client">[docs]</a>
-</span><span id="1-298">    <span class="k">def</span> <span class="nf">bind_client</span><span class="p">(</span>
-</span><span id="1-299">        <span class="bp">self</span><span class="p">,</span> <span class="n">new</span>  <span class="c1"># type: Optional[Client]</span>
-</span><span id="1-300">    <span class="p">):</span>
-</span><span id="1-301">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-302"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Binds a new client to the hub.&quot;&quot;&quot;</span>
-</span><span id="1-303">        <span class="n">top</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_stack</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span>
-</span><span id="1-304">        <span class="bp">self</span><span class="o">.</span><span class="n">_stack</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span> <span class="o">=</span> <span class="p">(</span><span class="n">new</span><span class="p">,</span> <span class="n">top</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span></div>
+</span><span id="1-308">    <span class="k">def</span> <span class="nf">bind_client</span><span class="p">(</span>
+</span><span id="1-309">        <span class="bp">self</span><span class="p">,</span> <span class="n">new</span>  <span class="c1"># type: Optional[BaseClient]</span>
+</span><span id="1-310">    <span class="p">):</span>
+</span><span id="1-311">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-312"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-313"><span class="sd">        .. deprecated:: 2.0.0</span>
+</span><span id="1-314"><span class="sd">            This function is deprecated and will be removed in a future release.</span>
+</span><span id="1-315"><span class="sd">            Please use :py:meth:`sentry_sdk.Scope.set_client` instead.</span>
+</span><span id="1-316">
+</span><span id="1-317"><span class="sd">        Binds a new client to the hub.</span>
+</span><span id="1-318"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-319">        <span class="n">Scope</span><span class="o">.</span><span class="n">get_global_scope</span><span class="p">()</span><span class="o">.</span><span class="n">set_client</span><span class="p">(</span><span class="n">new</span><span class="p">)</span></div>
 
-</span><span id="1-305">
+</span><span id="1-320">
 <div class="viewcode-block" id="Hub.capture_event">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Hub.capture_event">[docs]</a>
-</span><span id="1-306">    <span class="k">def</span> <span class="nf">capture_event</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">scope_kwargs</span><span class="p">):</span>
-</span><span id="1-307">        <span class="c1"># type: (Event, Optional[Hint], Optional[Scope], Any) -&gt; Optional[str]</span>
-</span><span id="1-308"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-309"><span class="sd">        Captures an event.</span>
-</span><span id="1-310">
-</span><span id="1-311"><span class="sd">        Alias of :py:meth:`sentry_sdk.Scope.capture_event`.</span>
-</span><span id="1-312">
-</span><span id="1-313"><span class="sd">        :param event: A ready-made event that can be directly sent to Sentry.</span>
-</span><span id="1-314">
-</span><span id="1-315"><span class="sd">        :param hint: Contains metadata about the event that can be read from `before_send`, such as the original exception object or a HTTP request object.</span>
-</span><span id="1-316">
-</span><span id="1-317"><span class="sd">        :param scope: An optional :py:class:`sentry_sdk.Scope` to apply to events.</span>
-</span><span id="1-318"><span class="sd">            The `scope` and `scope_kwargs` parameters are mutually exclusive.</span>
-</span><span id="1-319">
-</span><span id="1-320"><span class="sd">        :param scope_kwargs: Optional data to apply to event.</span>
-</span><span id="1-321"><span class="sd">            For supported `**scope_kwargs` see :py:meth:`sentry_sdk.Scope.update_from_kwargs`.</span>
-</span><span id="1-322"><span class="sd">            The `scope` and `scope_kwargs` parameters are mutually exclusive.</span>
-</span><span id="1-323"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-324">        <span class="n">client</span><span class="p">,</span> <span class="n">top_scope</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_stack</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span>
-</span><span id="1-325">        <span class="k">if</span> <span class="n">client</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-326">            <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-321">    <span class="k">def</span> <span class="nf">capture_event</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">scope_kwargs</span><span class="p">):</span>
+</span><span id="1-322">        <span class="c1"># type: (Event, Optional[Hint], Optional[Scope], Any) -&gt; Optional[str]</span>
+</span><span id="1-323"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-324"><span class="sd">        .. deprecated:: 2.0.0</span>
+</span><span id="1-325"><span class="sd">            This function is deprecated and will be removed in a future release.</span>
+</span><span id="1-326"><span class="sd">            Please use :py:meth:`sentry_sdk.Scope.capture_event` instead.</span>
 </span><span id="1-327">
-</span><span id="1-328">        <span class="n">last_event_id</span> <span class="o">=</span> <span class="n">top_scope</span><span class="o">.</span><span class="n">capture_event</span><span class="p">(</span>
-</span><span id="1-329">            <span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">client</span><span class="o">=</span><span class="n">client</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="n">scope</span><span class="p">,</span> <span class="o">**</span><span class="n">scope_kwargs</span>
-</span><span id="1-330">        <span class="p">)</span>
+</span><span id="1-328"><span class="sd">        Captures an event.</span>
+</span><span id="1-329">
+</span><span id="1-330"><span class="sd">        Alias of :py:meth:`sentry_sdk.Scope.capture_event`.</span>
 </span><span id="1-331">
-</span><span id="1-332">        <span class="n">is_transaction</span> <span class="o">=</span> <span class="n">event</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;type&quot;</span><span class="p">)</span> <span class="o">==</span> <span class="s2">&quot;transaction&quot;</span>
-</span><span id="1-333">        <span class="k">if</span> <span class="n">last_event_id</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">is_transaction</span><span class="p">:</span>
-</span><span id="1-334">            <span class="bp">self</span><span class="o">.</span><span class="n">_last_event_id</span> <span class="o">=</span> <span class="n">last_event_id</span>
+</span><span id="1-332"><span class="sd">        :param event: A ready-made event that can be directly sent to Sentry.</span>
+</span><span id="1-333">
+</span><span id="1-334"><span class="sd">        :param hint: Contains metadata about the event that can be read from `before_send`, such as the original exception object or a HTTP request object.</span>
 </span><span id="1-335">
-</span><span id="1-336">        <span class="k">return</span> <span class="n">last_event_id</span></div>
+</span><span id="1-336"><span class="sd">        :param scope: An optional :py:class:`sentry_sdk.Scope` to apply to events.</span>
+</span><span id="1-337"><span class="sd">            The `scope` and `scope_kwargs` parameters are mutually exclusive.</span>
+</span><span id="1-338">
+</span><span id="1-339"><span class="sd">        :param scope_kwargs: Optional data to apply to event.</span>
+</span><span id="1-340"><span class="sd">            For supported `**scope_kwargs` see :py:meth:`sentry_sdk.Scope.update_from_kwargs`.</span>
+</span><span id="1-341"><span class="sd">            The `scope` and `scope_kwargs` parameters are mutually exclusive.</span>
+</span><span id="1-342"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-343">        <span class="n">last_event_id</span> <span class="o">=</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_current_scope</span><span class="p">()</span><span class="o">.</span><span class="n">capture_event</span><span class="p">(</span>
+</span><span id="1-344">            <span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="n">scope</span><span class="p">,</span> <span class="o">**</span><span class="n">scope_kwargs</span>
+</span><span id="1-345">        <span class="p">)</span>
+</span><span id="1-346">
+</span><span id="1-347">        <span class="n">is_transaction</span> <span class="o">=</span> <span class="n">event</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;type&quot;</span><span class="p">)</span> <span class="o">==</span> <span class="s2">&quot;transaction&quot;</span>
+</span><span id="1-348">        <span class="k">if</span> <span class="n">last_event_id</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">is_transaction</span><span class="p">:</span>
+</span><span id="1-349">            <span class="bp">self</span><span class="o">.</span><span class="n">_last_event_id</span> <span class="o">=</span> <span class="n">last_event_id</span>
+</span><span id="1-350">
+</span><span id="1-351">        <span class="k">return</span> <span class="n">last_event_id</span></div>
 
-</span><span id="1-337">
+</span><span id="1-352">
 <div class="viewcode-block" id="Hub.capture_message">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Hub.capture_message">[docs]</a>
-</span><span id="1-338">    <span class="k">def</span> <span class="nf">capture_message</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">message</span><span class="p">,</span> <span class="n">level</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">scope_kwargs</span><span class="p">):</span>
-</span><span id="1-339">        <span class="c1"># type: (str, Optional[LogLevelStr], Optional[Scope], Any) -&gt; Optional[str]</span>
-</span><span id="1-340"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-341"><span class="sd">        Captures a message.</span>
-</span><span id="1-342">
-</span><span id="1-343"><span class="sd">        Alias of :py:meth:`sentry_sdk.Scope.capture_message`.</span>
-</span><span id="1-344">
-</span><span id="1-345"><span class="sd">        :param message: The string to send as the message to Sentry.</span>
-</span><span id="1-346">
-</span><span id="1-347"><span class="sd">        :param level: If no level is provided, the default level is `info`.</span>
-</span><span id="1-348">
-</span><span id="1-349"><span class="sd">        :param scope: An optional :py:class:`sentry_sdk.Scope` to apply to events.</span>
-</span><span id="1-350"><span class="sd">            The `scope` and `scope_kwargs` parameters are mutually exclusive.</span>
-</span><span id="1-351">
-</span><span id="1-352"><span class="sd">        :param scope_kwargs: Optional data to apply to event.</span>
-</span><span id="1-353"><span class="sd">            For supported `**scope_kwargs` see :py:meth:`sentry_sdk.Scope.update_from_kwargs`.</span>
-</span><span id="1-354"><span class="sd">            The `scope` and `scope_kwargs` parameters are mutually exclusive.</span>
-</span><span id="1-355">
-</span><span id="1-356"><span class="sd">        :returns: An `event_id` if the SDK decided to send the event (see :py:meth:`sentry_sdk.Client.capture_event`).</span>
-</span><span id="1-357"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-358">        <span class="n">client</span><span class="p">,</span> <span class="n">top_scope</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_stack</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span>
-</span><span id="1-359">        <span class="k">if</span> <span class="n">client</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-360">            <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-353">    <span class="k">def</span> <span class="nf">capture_message</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">message</span><span class="p">,</span> <span class="n">level</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">scope_kwargs</span><span class="p">):</span>
+</span><span id="1-354">        <span class="c1"># type: (str, Optional[LogLevelStr], Optional[Scope], Any) -&gt; Optional[str]</span>
+</span><span id="1-355"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-356"><span class="sd">        .. deprecated:: 2.0.0</span>
+</span><span id="1-357"><span class="sd">            This function is deprecated and will be removed in a future release.</span>
+</span><span id="1-358"><span class="sd">            Please use :py:meth:`sentry_sdk.Scope.capture_message` instead.</span>
+</span><span id="1-359">
+</span><span id="1-360"><span class="sd">        Captures a message.</span>
 </span><span id="1-361">
-</span><span id="1-362">        <span class="n">last_event_id</span> <span class="o">=</span> <span class="n">top_scope</span><span class="o">.</span><span class="n">capture_message</span><span class="p">(</span>
-</span><span id="1-363">            <span class="n">message</span><span class="p">,</span> <span class="n">level</span><span class="o">=</span><span class="n">level</span><span class="p">,</span> <span class="n">client</span><span class="o">=</span><span class="n">client</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="n">scope</span><span class="p">,</span> <span class="o">**</span><span class="n">scope_kwargs</span>
-</span><span id="1-364">        <span class="p">)</span>
+</span><span id="1-362"><span class="sd">        Alias of :py:meth:`sentry_sdk.Scope.capture_message`.</span>
+</span><span id="1-363">
+</span><span id="1-364"><span class="sd">        :param message: The string to send as the message to Sentry.</span>
 </span><span id="1-365">
-</span><span id="1-366">        <span class="k">if</span> <span class="n">last_event_id</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-367">            <span class="bp">self</span><span class="o">.</span><span class="n">_last_event_id</span> <span class="o">=</span> <span class="n">last_event_id</span>
-</span><span id="1-368">
-</span><span id="1-369">        <span class="k">return</span> <span class="n">last_event_id</span></div>
-
+</span><span id="1-366"><span class="sd">        :param level: If no level is provided, the default level is `info`.</span>
+</span><span id="1-367">
+</span><span id="1-368"><span class="sd">        :param scope: An optional :py:class:`sentry_sdk.Scope` to apply to events.</span>
+</span><span id="1-369"><span class="sd">            The `scope` and `scope_kwargs` parameters are mutually exclusive.</span>
 </span><span id="1-370">
-<div class="viewcode-block" id="Hub.capture_exception">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Hub.capture_exception">[docs]</a>
-</span><span id="1-371">    <span class="k">def</span> <span class="nf">capture_exception</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">error</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">scope_kwargs</span><span class="p">):</span>
-</span><span id="1-372">        <span class="c1"># type: (Optional[Union[BaseException, ExcInfo]], Optional[Scope], Any) -&gt; Optional[str]</span>
-</span><span id="1-373"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Captures an exception.</span>
+</span><span id="1-371"><span class="sd">        :param scope_kwargs: Optional data to apply to event.</span>
+</span><span id="1-372"><span class="sd">            For supported `**scope_kwargs` see :py:meth:`sentry_sdk.Scope.update_from_kwargs`.</span>
+</span><span id="1-373"><span class="sd">            The `scope` and `scope_kwargs` parameters are mutually exclusive.</span>
 </span><span id="1-374">
-</span><span id="1-375"><span class="sd">        Alias of :py:meth:`sentry_sdk.Scope.capture_exception`.</span>
-</span><span id="1-376">
-</span><span id="1-377"><span class="sd">        :param error: An exception to capture. If `None`, `sys.exc_info()` will be used.</span>
-</span><span id="1-378">
-</span><span id="1-379"><span class="sd">        :param scope: An optional :py:class:`sentry_sdk.Scope` to apply to events.</span>
-</span><span id="1-380"><span class="sd">            The `scope` and `scope_kwargs` parameters are mutually exclusive.</span>
-</span><span id="1-381">
-</span><span id="1-382"><span class="sd">        :param scope_kwargs: Optional data to apply to event.</span>
-</span><span id="1-383"><span class="sd">            For supported `**scope_kwargs` see :py:meth:`sentry_sdk.Scope.update_from_kwargs`.</span>
-</span><span id="1-384"><span class="sd">            The `scope` and `scope_kwargs` parameters are mutually exclusive.</span>
+</span><span id="1-375"><span class="sd">        :returns: An `event_id` if the SDK decided to send the event (see :py:meth:`sentry_sdk.client._Client.capture_event`).</span>
+</span><span id="1-376"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-377">        <span class="n">last_event_id</span> <span class="o">=</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_current_scope</span><span class="p">()</span><span class="o">.</span><span class="n">capture_message</span><span class="p">(</span>
+</span><span id="1-378">            <span class="n">message</span><span class="p">,</span> <span class="n">level</span><span class="o">=</span><span class="n">level</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="n">scope</span><span class="p">,</span> <span class="o">**</span><span class="n">scope_kwargs</span>
+</span><span id="1-379">        <span class="p">)</span>
+</span><span id="1-380">
+</span><span id="1-381">        <span class="k">if</span> <span class="n">last_event_id</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-382">            <span class="bp">self</span><span class="o">.</span><span class="n">_last_event_id</span> <span class="o">=</span> <span class="n">last_event_id</span>
+</span><span id="1-383">
+</span><span id="1-384">        <span class="k">return</span> <span class="n">last_event_id</span></div>
+
 </span><span id="1-385">
-</span><span id="1-386"><span class="sd">        :returns: An `event_id` if the SDK decided to send the event (see :py:meth:`sentry_sdk.Client.capture_event`).</span>
-</span><span id="1-387"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-388">        <span class="n">client</span><span class="p">,</span> <span class="n">top_scope</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_stack</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span>
-</span><span id="1-389">        <span class="k">if</span> <span class="n">client</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-390">            <span class="k">return</span> <span class="kc">None</span>
-</span><span id="1-391">
-</span><span id="1-392">        <span class="n">last_event_id</span> <span class="o">=</span> <span class="n">top_scope</span><span class="o">.</span><span class="n">capture_exception</span><span class="p">(</span>
-</span><span id="1-393">            <span class="n">error</span><span class="p">,</span> <span class="n">client</span><span class="o">=</span><span class="n">client</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="n">scope</span><span class="p">,</span> <span class="o">**</span><span class="n">scope_kwargs</span>
-</span><span id="1-394">        <span class="p">)</span>
-</span><span id="1-395">
-</span><span id="1-396">        <span class="k">if</span> <span class="n">last_event_id</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-397">            <span class="bp">self</span><span class="o">.</span><span class="n">_last_event_id</span> <span class="o">=</span> <span class="n">last_event_id</span>
+<div class="viewcode-block" id="Hub.capture_exception">
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Hub.capture_exception">[docs]</a>
+</span><span id="1-386">    <span class="k">def</span> <span class="nf">capture_exception</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">error</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">scope_kwargs</span><span class="p">):</span>
+</span><span id="1-387">        <span class="c1"># type: (Optional[Union[BaseException, ExcInfo]], Optional[Scope], Any) -&gt; Optional[str]</span>
+</span><span id="1-388"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-389"><span class="sd">        .. deprecated:: 2.0.0</span>
+</span><span id="1-390"><span class="sd">            This function is deprecated and will be removed in a future release.</span>
+</span><span id="1-391"><span class="sd">            Please use :py:meth:`sentry_sdk.Scope.capture_exception` instead.</span>
+</span><span id="1-392">
+</span><span id="1-393"><span class="sd">        Captures an exception.</span>
+</span><span id="1-394">
+</span><span id="1-395"><span class="sd">        Alias of :py:meth:`sentry_sdk.Scope.capture_exception`.</span>
+</span><span id="1-396">
+</span><span id="1-397"><span class="sd">        :param error: An exception to capture. If `None`, `sys.exc_info()` will be used.</span>
 </span><span id="1-398">
-</span><span id="1-399">        <span class="k">return</span> <span class="n">last_event_id</span></div>
-
-</span><span id="1-400">
-</span><span id="1-401">    <span class="k">def</span> <span class="nf">_capture_internal_exception</span><span class="p">(</span>
-</span><span id="1-402">        <span class="bp">self</span><span class="p">,</span> <span class="n">exc_info</span>  <span class="c1"># type: Any</span>
-</span><span id="1-403">    <span class="p">):</span>
-</span><span id="1-404">        <span class="c1"># type: (...) -&gt; Any</span>
-</span><span id="1-405"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-406"><span class="sd">        Capture an exception that is likely caused by a bug in the SDK</span>
-</span><span id="1-407"><span class="sd">        itself.</span>
-</span><span id="1-408">
-</span><span id="1-409"><span class="sd">        Duplicated in :py:meth:`sentry_sdk.Client._capture_internal_exception`.</span>
-</span><span id="1-410">
-</span><span id="1-411"><span class="sd">        These exceptions do not end up in Sentry and are just logged instead.</span>
-</span><span id="1-412"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-413">        <span class="n">logger</span><span class="o">.</span><span class="n">error</span><span class="p">(</span><span class="s2">&quot;Internal error in sentry_sdk&quot;</span><span class="p">,</span> <span class="n">exc_info</span><span class="o">=</span><span class="n">exc_info</span><span class="p">)</span>
+</span><span id="1-399"><span class="sd">        :param scope: An optional :py:class:`sentry_sdk.Scope` to apply to events.</span>
+</span><span id="1-400"><span class="sd">            The `scope` and `scope_kwargs` parameters are mutually exclusive.</span>
+</span><span id="1-401">
+</span><span id="1-402"><span class="sd">        :param scope_kwargs: Optional data to apply to event.</span>
+</span><span id="1-403"><span class="sd">            For supported `**scope_kwargs` see :py:meth:`sentry_sdk.Scope.update_from_kwargs`.</span>
+</span><span id="1-404"><span class="sd">            The `scope` and `scope_kwargs` parameters are mutually exclusive.</span>
+</span><span id="1-405">
+</span><span id="1-406"><span class="sd">        :returns: An `event_id` if the SDK decided to send the event (see :py:meth:`sentry_sdk.client._Client.capture_event`).</span>
+</span><span id="1-407"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-408">        <span class="n">last_event_id</span> <span class="o">=</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_current_scope</span><span class="p">()</span><span class="o">.</span><span class="n">capture_exception</span><span class="p">(</span>
+</span><span id="1-409">            <span class="n">error</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="n">scope</span><span class="p">,</span> <span class="o">**</span><span class="n">scope_kwargs</span>
+</span><span id="1-410">        <span class="p">)</span>
+</span><span id="1-411">
+</span><span id="1-412">        <span class="k">if</span> <span class="n">last_event_id</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-413">            <span class="bp">self</span><span class="o">.</span><span class="n">_last_event_id</span> <span class="o">=</span> <span class="n">last_event_id</span>
 </span><span id="1-414">
+</span><span id="1-415">        <span class="k">return</span> <span class="n">last_event_id</span></div>
+
+</span><span id="1-416">
+</span><span id="1-417">    <span class="k">def</span> <span class="nf">_capture_internal_exception</span><span class="p">(</span>
+</span><span id="1-418">        <span class="bp">self</span><span class="p">,</span> <span class="n">exc_info</span>  <span class="c1"># type: Any</span>
+</span><span id="1-419">    <span class="p">):</span>
+</span><span id="1-420">        <span class="c1"># type: (...) -&gt; Any</span>
+</span><span id="1-421"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-422"><span class="sd">        .. deprecated:: 2.0.0</span>
+</span><span id="1-423"><span class="sd">            This function is deprecated and will be removed in a future release.</span>
+</span><span id="1-424"><span class="sd">            Please use :py:meth:`sentry_sdk.client._Client._capture_internal_exception` instead.</span>
+</span><span id="1-425">
+</span><span id="1-426"><span class="sd">        Capture an exception that is likely caused by a bug in the SDK</span>
+</span><span id="1-427"><span class="sd">        itself.</span>
+</span><span id="1-428">
+</span><span id="1-429"><span class="sd">        Duplicated in :py:meth:`sentry_sdk.client._Client._capture_internal_exception`.</span>
+</span><span id="1-430">
+</span><span id="1-431"><span class="sd">        These exceptions do not end up in Sentry and are just logged instead.</span>
+</span><span id="1-432"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-433">        <span class="n">logger</span><span class="o">.</span><span class="n">error</span><span class="p">(</span><span class="s2">&quot;Internal error in sentry_sdk&quot;</span><span class="p">,</span> <span class="n">exc_info</span><span class="o">=</span><span class="n">exc_info</span><span class="p">)</span>
+</span><span id="1-434">
 <div class="viewcode-block" id="Hub.add_breadcrumb">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Hub.add_breadcrumb">[docs]</a>
-</span><span id="1-415">    <span class="k">def</span> <span class="nf">add_breadcrumb</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">crumb</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">hint</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-</span><span id="1-416">        <span class="c1"># type: (Optional[Breadcrumb], Optional[BreadcrumbHint], Any) -&gt; None</span>
-</span><span id="1-417"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-418"><span class="sd">        Adds a breadcrumb.</span>
-</span><span id="1-419">
-</span><span id="1-420"><span class="sd">        :param crumb: Dictionary with the data as the sentry v7/v8 protocol expects.</span>
-</span><span id="1-421">
-</span><span id="1-422"><span class="sd">        :param hint: An optional value that can be used by `before_breadcrumb`</span>
-</span><span id="1-423"><span class="sd">            to customize the breadcrumbs that are emitted.</span>
-</span><span id="1-424"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-425">        <span class="n">client</span><span class="p">,</span> <span class="n">scope</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_stack</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span>
-</span><span id="1-426">        <span class="k">if</span> <span class="n">client</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-427">            <span class="n">logger</span><span class="o">.</span><span class="n">info</span><span class="p">(</span><span class="s2">&quot;Dropped breadcrumb because no client bound&quot;</span><span class="p">)</span>
-</span><span id="1-428">            <span class="k">return</span>
-</span><span id="1-429">
-</span><span id="1-430">        <span class="n">kwargs</span><span class="p">[</span><span class="s2">&quot;client&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">client</span>
-</span><span id="1-431">
-</span><span id="1-432">        <span class="n">scope</span><span class="o">.</span><span class="n">add_breadcrumb</span><span class="p">(</span><span class="n">crumb</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></div>
+</span><span id="1-435">    <span class="k">def</span> <span class="nf">add_breadcrumb</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">crumb</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">hint</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
+</span><span id="1-436">        <span class="c1"># type: (Optional[Breadcrumb], Optional[BreadcrumbHint], Any) -&gt; None</span>
+</span><span id="1-437"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-438"><span class="sd">        .. deprecated:: 2.0.0</span>
+</span><span id="1-439"><span class="sd">            This function is deprecated and will be removed in a future release.</span>
+</span><span id="1-440"><span class="sd">            Please use :py:meth:`sentry_sdk.Scope.add_breadcrumb` instead.</span>
+</span><span id="1-441">
+</span><span id="1-442"><span class="sd">        Adds a breadcrumb.</span>
+</span><span id="1-443">
+</span><span id="1-444"><span class="sd">        :param crumb: Dictionary with the data as the sentry v7/v8 protocol expects.</span>
+</span><span id="1-445">
+</span><span id="1-446"><span class="sd">        :param hint: An optional value that can be used by `before_breadcrumb`</span>
+</span><span id="1-447"><span class="sd">            to customize the breadcrumbs that are emitted.</span>
+</span><span id="1-448"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-449">        <span class="n">Scope</span><span class="o">.</span><span class="n">get_isolation_scope</span><span class="p">()</span><span class="o">.</span><span class="n">add_breadcrumb</span><span class="p">(</span><span class="n">crumb</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></div>
 
-</span><span id="1-433">
+</span><span id="1-450">
 <div class="viewcode-block" id="Hub.start_span">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Hub.start_span">[docs]</a>
-</span><span id="1-434">    <span class="k">def</span> <span class="nf">start_span</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">span</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">instrumenter</span><span class="o">=</span><span class="n">INSTRUMENTER</span><span class="o">.</span><span class="n">SENTRY</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-</span><span id="1-435">        <span class="c1"># type: (Optional[Span], str, Any) -&gt; Span</span>
-</span><span id="1-436"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-437"><span class="sd">        Start a span whose parent is the currently active span or transaction, if any.</span>
-</span><span id="1-438">
-</span><span id="1-439"><span class="sd">        The return value is a :py:class:`sentry_sdk.tracing.Span` instance,</span>
-</span><span id="1-440"><span class="sd">        typically used as a context manager to start and stop timing in a `with`</span>
-</span><span id="1-441"><span class="sd">        block.</span>
-</span><span id="1-442">
-</span><span id="1-443"><span class="sd">        Only spans contained in a transaction are sent to Sentry. Most</span>
-</span><span id="1-444"><span class="sd">        integrations start a transaction at the appropriate time, for example</span>
-</span><span id="1-445"><span class="sd">        for every incoming HTTP request. Use</span>
-</span><span id="1-446"><span class="sd">        :py:meth:`sentry_sdk.start_transaction` to start a new transaction when</span>
-</span><span id="1-447"><span class="sd">        one is not already in progress.</span>
-</span><span id="1-448">
-</span><span id="1-449"><span class="sd">        For supported `**kwargs` see :py:class:`sentry_sdk.tracing.Span`.</span>
-</span><span id="1-450"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-451">        <span class="n">client</span><span class="p">,</span> <span class="n">scope</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_stack</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span>
-</span><span id="1-452">
-</span><span id="1-453">        <span class="n">kwargs</span><span class="p">[</span><span class="s2">&quot;hub&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span>
-</span><span id="1-454">        <span class="n">kwargs</span><span class="p">[</span><span class="s2">&quot;client&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">client</span>
-</span><span id="1-455">
-</span><span id="1-456">        <span class="k">return</span> <span class="n">scope</span><span class="o">.</span><span class="n">start_span</span><span class="p">(</span><span class="n">span</span><span class="o">=</span><span class="n">span</span><span class="p">,</span> <span class="n">instrumenter</span><span class="o">=</span><span class="n">instrumenter</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></div>
-
+</span><span id="1-451">    <span class="k">def</span> <span class="nf">start_span</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">instrumenter</span><span class="o">=</span><span class="n">INSTRUMENTER</span><span class="o">.</span><span class="n">SENTRY</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
+</span><span id="1-452">        <span class="c1"># type: (str, Any) -&gt; Span</span>
+</span><span id="1-453"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-454"><span class="sd">        .. deprecated:: 2.0.0</span>
+</span><span id="1-455"><span class="sd">            This function is deprecated and will be removed in a future release.</span>
+</span><span id="1-456"><span class="sd">            Please use :py:meth:`sentry_sdk.Scope.start_span` instead.</span>
 </span><span id="1-457">
+</span><span id="1-458"><span class="sd">        Start a span whose parent is the currently active span or transaction, if any.</span>
+</span><span id="1-459">
+</span><span id="1-460"><span class="sd">        The return value is a :py:class:`sentry_sdk.tracing.Span` instance,</span>
+</span><span id="1-461"><span class="sd">        typically used as a context manager to start and stop timing in a `with`</span>
+</span><span id="1-462"><span class="sd">        block.</span>
+</span><span id="1-463">
+</span><span id="1-464"><span class="sd">        Only spans contained in a transaction are sent to Sentry. Most</span>
+</span><span id="1-465"><span class="sd">        integrations start a transaction at the appropriate time, for example</span>
+</span><span id="1-466"><span class="sd">        for every incoming HTTP request. Use</span>
+</span><span id="1-467"><span class="sd">        :py:meth:`sentry_sdk.start_transaction` to start a new transaction when</span>
+</span><span id="1-468"><span class="sd">        one is not already in progress.</span>
+</span><span id="1-469">
+</span><span id="1-470"><span class="sd">        For supported `**kwargs` see :py:class:`sentry_sdk.tracing.Span`.</span>
+</span><span id="1-471"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-472">        <span class="n">scope</span> <span class="o">=</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_current_scope</span><span class="p">()</span>
+</span><span id="1-473">        <span class="k">return</span> <span class="n">scope</span><span class="o">.</span><span class="n">start_span</span><span class="p">(</span><span class="n">instrumenter</span><span class="o">=</span><span class="n">instrumenter</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></div>
+
+</span><span id="1-474">
 <div class="viewcode-block" id="Hub.start_transaction">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Hub.start_transaction">[docs]</a>
-</span><span id="1-458">    <span class="k">def</span> <span class="nf">start_transaction</span><span class="p">(</span>
-</span><span id="1-459">        <span class="bp">self</span><span class="p">,</span> <span class="n">transaction</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">instrumenter</span><span class="o">=</span><span class="n">INSTRUMENTER</span><span class="o">.</span><span class="n">SENTRY</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span>
-</span><span id="1-460">    <span class="p">):</span>
-</span><span id="1-461">        <span class="c1"># type: (Optional[Transaction], str, Any) -&gt; Union[Transaction, NoOpSpan]</span>
-</span><span id="1-462"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-463"><span class="sd">        Start and return a transaction.</span>
-</span><span id="1-464">
-</span><span id="1-465"><span class="sd">        Start an existing transaction if given, otherwise create and start a new</span>
-</span><span id="1-466"><span class="sd">        transaction with kwargs.</span>
-</span><span id="1-467">
-</span><span id="1-468"><span class="sd">        This is the entry point to manual tracing instrumentation.</span>
-</span><span id="1-469">
-</span><span id="1-470"><span class="sd">        A tree structure can be built by adding child spans to the transaction,</span>
-</span><span id="1-471"><span class="sd">        and child spans to other spans. To start a new child span within the</span>
-</span><span id="1-472"><span class="sd">        transaction or any span, call the respective `.start_child()` method.</span>
-</span><span id="1-473">
-</span><span id="1-474"><span class="sd">        Every child span must be finished before the transaction is finished,</span>
-</span><span id="1-475"><span class="sd">        otherwise the unfinished spans are discarded.</span>
-</span><span id="1-476">
-</span><span id="1-477"><span class="sd">        When used as context managers, spans and transactions are automatically</span>
-</span><span id="1-478"><span class="sd">        finished at the end of the `with` block. If not using context managers,</span>
-</span><span id="1-479"><span class="sd">        call the `.finish()` method.</span>
-</span><span id="1-480">
-</span><span id="1-481"><span class="sd">        When the transaction is finished, it will be sent to Sentry with all its</span>
-</span><span id="1-482"><span class="sd">        finished child spans.</span>
-</span><span id="1-483">
-</span><span id="1-484"><span class="sd">        For supported `**kwargs` see :py:class:`sentry_sdk.tracing.Transaction`.</span>
-</span><span id="1-485"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-486">        <span class="n">client</span><span class="p">,</span> <span class="n">scope</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_stack</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span>
+</span><span id="1-475">    <span class="k">def</span> <span class="nf">start_transaction</span><span class="p">(</span>
+</span><span id="1-476">        <span class="bp">self</span><span class="p">,</span>
+</span><span id="1-477">        <span class="n">transaction</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
+</span><span id="1-478">        <span class="n">instrumenter</span><span class="o">=</span><span class="n">INSTRUMENTER</span><span class="o">.</span><span class="n">SENTRY</span><span class="p">,</span>
+</span><span id="1-479">        <span class="n">custom_sampling_context</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
+</span><span id="1-480">        <span class="o">**</span><span class="n">kwargs</span>
+</span><span id="1-481">    <span class="p">):</span>
+</span><span id="1-482">        <span class="c1"># type: (Optional[Transaction], str, Optional[SamplingContext], Unpack[TransactionKwargs]) -&gt; Union[Transaction, NoOpSpan]</span>
+</span><span id="1-483"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-484"><span class="sd">        .. deprecated:: 2.0.0</span>
+</span><span id="1-485"><span class="sd">            This function is deprecated and will be removed in a future release.</span>
+</span><span id="1-486"><span class="sd">            Please use :py:meth:`sentry_sdk.Scope.start_transaction` instead.</span>
 </span><span id="1-487">
-</span><span id="1-488">        <span class="n">kwargs</span><span class="p">[</span><span class="s2">&quot;hub&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span>
-</span><span id="1-489">        <span class="n">kwargs</span><span class="p">[</span><span class="s2">&quot;client&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">client</span>
-</span><span id="1-490">
-</span><span id="1-491">        <span class="k">return</span> <span class="n">scope</span><span class="o">.</span><span class="n">start_transaction</span><span class="p">(</span>
-</span><span id="1-492">            <span class="n">transaction</span><span class="o">=</span><span class="n">transaction</span><span class="p">,</span> <span class="n">instrumenter</span><span class="o">=</span><span class="n">instrumenter</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span>
-</span><span id="1-493">        <span class="p">)</span></div>
-
+</span><span id="1-488"><span class="sd">        Start and return a transaction.</span>
+</span><span id="1-489">
+</span><span id="1-490"><span class="sd">        Start an existing transaction if given, otherwise create and start a new</span>
+</span><span id="1-491"><span class="sd">        transaction with kwargs.</span>
+</span><span id="1-492">
+</span><span id="1-493"><span class="sd">        This is the entry point to manual tracing instrumentation.</span>
 </span><span id="1-494">
-<div class="viewcode-block" id="Hub.continue_trace">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Hub.continue_trace">[docs]</a>
-</span><span id="1-495">    <span class="k">def</span> <span class="nf">continue_trace</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">environ_or_headers</span><span class="p">,</span> <span class="n">op</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">source</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-</span><span id="1-496">        <span class="c1"># type: (Dict[str, Any], Optional[str], Optional[str], Optional[str]) -&gt; Transaction</span>
-</span><span id="1-497"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-498"><span class="sd">        Sets the propagation context from environment or headers and returns a transaction.</span>
-</span><span id="1-499"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-500">        <span class="n">scope</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_stack</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">][</span><span class="mi">1</span><span class="p">]</span>
+</span><span id="1-495"><span class="sd">        A tree structure can be built by adding child spans to the transaction,</span>
+</span><span id="1-496"><span class="sd">        and child spans to other spans. To start a new child span within the</span>
+</span><span id="1-497"><span class="sd">        transaction or any span, call the respective `.start_child()` method.</span>
+</span><span id="1-498">
+</span><span id="1-499"><span class="sd">        Every child span must be finished before the transaction is finished,</span>
+</span><span id="1-500"><span class="sd">        otherwise the unfinished spans are discarded.</span>
 </span><span id="1-501">
-</span><span id="1-502">        <span class="k">return</span> <span class="n">scope</span><span class="o">.</span><span class="n">continue_trace</span><span class="p">(</span>
-</span><span id="1-503">            <span class="n">environ_or_headers</span><span class="o">=</span><span class="n">environ_or_headers</span><span class="p">,</span> <span class="n">op</span><span class="o">=</span><span class="n">op</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="n">name</span><span class="p">,</span> <span class="n">source</span><span class="o">=</span><span class="n">source</span>
-</span><span id="1-504">        <span class="p">)</span></div>
-
+</span><span id="1-502"><span class="sd">        When used as context managers, spans and transactions are automatically</span>
+</span><span id="1-503"><span class="sd">        finished at the end of the `with` block. If not using context managers,</span>
+</span><span id="1-504"><span class="sd">        call the `.finish()` method.</span>
 </span><span id="1-505">
-</span><span id="1-506">    <span class="nd">@overload</span>
-</span><span id="1-507">    <span class="k">def</span> <span class="nf">push_scope</span><span class="p">(</span>
-</span><span id="1-508">        <span class="bp">self</span><span class="p">,</span> <span class="n">callback</span><span class="o">=</span><span class="kc">None</span>  <span class="c1"># type: Optional[None]</span>
-</span><span id="1-509">    <span class="p">):</span>
-</span><span id="1-510">        <span class="c1"># type: (...) -&gt; ContextManager[Scope]</span>
-</span><span id="1-511">        <span class="k">pass</span>
+</span><span id="1-506"><span class="sd">        When the transaction is finished, it will be sent to Sentry with all its</span>
+</span><span id="1-507"><span class="sd">        finished child spans.</span>
+</span><span id="1-508">
+</span><span id="1-509"><span class="sd">        For supported `**kwargs` see :py:class:`sentry_sdk.tracing.Transaction`.</span>
+</span><span id="1-510"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-511">        <span class="n">scope</span> <span class="o">=</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_current_scope</span><span class="p">()</span>
 </span><span id="1-512">
-</span><span id="1-513">    <span class="nd">@overload</span>
-</span><span id="1-514">    <span class="k">def</span> <span class="nf">push_scope</span><span class="p">(</span>  <span class="c1"># noqa: F811</span>
-</span><span id="1-515">        <span class="bp">self</span><span class="p">,</span> <span class="n">callback</span>  <span class="c1"># type: Callable[[Scope], None]</span>
-</span><span id="1-516">    <span class="p">):</span>
-</span><span id="1-517">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-518">        <span class="k">pass</span>
-</span><span id="1-519">
-<div class="viewcode-block" id="Hub.push_scope">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Hub.push_scope">[docs]</a>
-</span><span id="1-520">    <span class="k">def</span> <span class="nf">push_scope</span><span class="p">(</span>  <span class="c1"># noqa</span>
-</span><span id="1-521">        <span class="bp">self</span><span class="p">,</span>
-</span><span id="1-522">        <span class="n">callback</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Callable[[Scope], None]]</span>
-</span><span id="1-523">        <span class="n">continue_trace</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span>  <span class="c1"># type: bool</span>
-</span><span id="1-524">    <span class="p">):</span>
-</span><span id="1-525">        <span class="c1"># type: (...) -&gt; Optional[ContextManager[Scope]]</span>
-</span><span id="1-526"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-527"><span class="sd">        Pushes a new layer on the scope stack.</span>
+</span><span id="1-513">        <span class="c1"># For backwards compatibility, we allow passing the scope as the hub.</span>
+</span><span id="1-514">        <span class="c1"># We need a major release to make this nice. (if someone searches the code: deprecated)</span>
+</span><span id="1-515">        <span class="c1"># Type checking disabled for this line because deprecated keys are not allowed in the type signature.</span>
+</span><span id="1-516">        <span class="n">kwargs</span><span class="p">[</span><span class="s2">&quot;hub&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">scope</span>  <span class="c1"># type: ignore</span>
+</span><span id="1-517">
+</span><span id="1-518">        <span class="k">return</span> <span class="n">scope</span><span class="o">.</span><span class="n">start_transaction</span><span class="p">(</span>
+</span><span id="1-519">            <span class="n">transaction</span><span class="p">,</span> <span class="n">instrumenter</span><span class="p">,</span> <span class="n">custom_sampling_context</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span>
+</span><span id="1-520">        <span class="p">)</span></div>
+
+</span><span id="1-521">
+<div class="viewcode-block" id="Hub.continue_trace">
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Hub.continue_trace">[docs]</a>
+</span><span id="1-522">    <span class="k">def</span> <span class="nf">continue_trace</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">environ_or_headers</span><span class="p">,</span> <span class="n">op</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">source</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+</span><span id="1-523">        <span class="c1"># type: (Dict[str, Any], Optional[str], Optional[str], Optional[str]) -&gt; Transaction</span>
+</span><span id="1-524"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-525"><span class="sd">        .. deprecated:: 2.0.0</span>
+</span><span id="1-526"><span class="sd">            This function is deprecated and will be removed in a future release.</span>
+</span><span id="1-527"><span class="sd">            Please use :py:meth:`sentry_sdk.Scope.continue_trace` instead.</span>
 </span><span id="1-528">
-</span><span id="1-529"><span class="sd">        :param callback: If provided, this method pushes a scope, calls</span>
-</span><span id="1-530"><span class="sd">            `callback`, and pops the scope again.</span>
-</span><span id="1-531">
-</span><span id="1-532"><span class="sd">        :returns: If no `callback` is provided, a context manager that should</span>
-</span><span id="1-533"><span class="sd">            be used to pop the scope again.</span>
-</span><span id="1-534"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-535">        <span class="k">if</span> <span class="n">callback</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-536">            <span class="k">with</span> <span class="bp">self</span><span class="o">.</span><span class="n">push_scope</span><span class="p">()</span> <span class="k">as</span> <span class="n">scope</span><span class="p">:</span>
-</span><span id="1-537">                <span class="n">callback</span><span class="p">(</span><span class="n">scope</span><span class="p">)</span>
-</span><span id="1-538">            <span class="k">return</span> <span class="kc">None</span>
-</span><span id="1-539">
-</span><span id="1-540">        <span class="n">client</span><span class="p">,</span> <span class="n">scope</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_stack</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span>
+</span><span id="1-529"><span class="sd">        Sets the propagation context from environment or headers and returns a transaction.</span>
+</span><span id="1-530"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-531">        <span class="k">return</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_isolation_scope</span><span class="p">()</span><span class="o">.</span><span class="n">continue_trace</span><span class="p">(</span>
+</span><span id="1-532">            <span class="n">environ_or_headers</span><span class="o">=</span><span class="n">environ_or_headers</span><span class="p">,</span> <span class="n">op</span><span class="o">=</span><span class="n">op</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="n">name</span><span class="p">,</span> <span class="n">source</span><span class="o">=</span><span class="n">source</span>
+</span><span id="1-533">        <span class="p">)</span></div>
+
+</span><span id="1-534">
+</span><span id="1-535">    <span class="nd">@overload</span>
+</span><span id="1-536">    <span class="k">def</span> <span class="nf">push_scope</span><span class="p">(</span>
+</span><span id="1-537">        <span class="bp">self</span><span class="p">,</span> <span class="n">callback</span><span class="o">=</span><span class="kc">None</span>  <span class="c1"># type: Optional[None]</span>
+</span><span id="1-538">    <span class="p">):</span>
+</span><span id="1-539">        <span class="c1"># type: (...) -&gt; ContextManager[Scope]</span>
+</span><span id="1-540">        <span class="k">pass</span>
 </span><span id="1-541">
-</span><span id="1-542">        <span class="n">new_scope</span> <span class="o">=</span> <span class="n">copy</span><span class="o">.</span><span class="n">copy</span><span class="p">(</span><span class="n">scope</span><span class="p">)</span>
-</span><span id="1-543">
-</span><span id="1-544">        <span class="k">if</span> <span class="n">continue_trace</span><span class="p">:</span>
-</span><span id="1-545">            <span class="n">new_scope</span><span class="o">.</span><span class="n">generate_propagation_context</span><span class="p">()</span>
-</span><span id="1-546">
-</span><span id="1-547">        <span class="n">new_layer</span> <span class="o">=</span> <span class="p">(</span><span class="n">client</span><span class="p">,</span> <span class="n">new_scope</span><span class="p">)</span>
-</span><span id="1-548">        <span class="bp">self</span><span class="o">.</span><span class="n">_stack</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">new_layer</span><span class="p">)</span>
-</span><span id="1-549">
-</span><span id="1-550">        <span class="k">return</span> <span class="n">_ScopeManager</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span></div>
+</span><span id="1-542">    <span class="nd">@overload</span>
+</span><span id="1-543">    <span class="k">def</span> <span class="nf">push_scope</span><span class="p">(</span>  <span class="c1"># noqa: F811</span>
+</span><span id="1-544">        <span class="bp">self</span><span class="p">,</span> <span class="n">callback</span>  <span class="c1"># type: Callable[[Scope], None]</span>
+</span><span id="1-545">    <span class="p">):</span>
+</span><span id="1-546">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-547">        <span class="k">pass</span>
+</span><span id="1-548">
+<div class="viewcode-block" id="Hub.push_scope">
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Hub.push_scope">[docs]</a>
+</span><span id="1-549">    <span class="k">def</span> <span class="nf">push_scope</span><span class="p">(</span>  <span class="c1"># noqa</span>
+</span><span id="1-550">        <span class="bp">self</span><span class="p">,</span>
+</span><span id="1-551">        <span class="n">callback</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Callable[[Scope], None]]</span>
+</span><span id="1-552">        <span class="n">continue_trace</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span>  <span class="c1"># type: bool</span>
+</span><span id="1-553">    <span class="p">):</span>
+</span><span id="1-554">        <span class="c1"># type: (...) -&gt; Optional[ContextManager[Scope]]</span>
+</span><span id="1-555"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-556"><span class="sd">        .. deprecated:: 2.0.0</span>
+</span><span id="1-557"><span class="sd">            This function is deprecated and will be removed in a future release.</span>
+</span><span id="1-558">
+</span><span id="1-559"><span class="sd">        Pushes a new layer on the scope stack.</span>
+</span><span id="1-560">
+</span><span id="1-561"><span class="sd">        :param callback: If provided, this method pushes a scope, calls</span>
+</span><span id="1-562"><span class="sd">            `callback`, and pops the scope again.</span>
+</span><span id="1-563">
+</span><span id="1-564"><span class="sd">        :returns: If no `callback` is provided, a context manager that should</span>
+</span><span id="1-565"><span class="sd">            be used to pop the scope again.</span>
+</span><span id="1-566"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-567">        <span class="k">if</span> <span class="n">callback</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-568">            <span class="k">with</span> <span class="bp">self</span><span class="o">.</span><span class="n">push_scope</span><span class="p">()</span> <span class="k">as</span> <span class="n">scope</span><span class="p">:</span>
+</span><span id="1-569">                <span class="n">callback</span><span class="p">(</span><span class="n">scope</span><span class="p">)</span>
+</span><span id="1-570">            <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-571">
+</span><span id="1-572">        <span class="k">return</span> <span class="n">_ScopeManager</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span></div>
 
-</span><span id="1-551">
+</span><span id="1-573">
 <div class="viewcode-block" id="Hub.pop_scope_unsafe">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Hub.pop_scope_unsafe">[docs]</a>
-</span><span id="1-552">    <span class="k">def</span> <span class="nf">pop_scope_unsafe</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-553">        <span class="c1"># type: () -&gt; Tuple[Optional[Client], Scope]</span>
-</span><span id="1-554"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-555"><span class="sd">        Pops a scope layer from the stack.</span>
-</span><span id="1-556">
-</span><span id="1-557"><span class="sd">        Try to use the context manager :py:meth:`push_scope` instead.</span>
-</span><span id="1-558"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-559">        <span class="n">rv</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_stack</span><span class="o">.</span><span class="n">pop</span><span class="p">()</span>
-</span><span id="1-560">        <span class="k">assert</span> <span class="bp">self</span><span class="o">.</span><span class="n">_stack</span><span class="p">,</span> <span class="s2">&quot;stack must have at least one layer&quot;</span>
-</span><span id="1-561">        <span class="k">return</span> <span class="n">rv</span></div>
+</span><span id="1-574">    <span class="k">def</span> <span class="nf">pop_scope_unsafe</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-575">        <span class="c1"># type: () -&gt; Tuple[Optional[Client], Scope]</span>
+</span><span id="1-576"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-577"><span class="sd">        .. deprecated:: 2.0.0</span>
+</span><span id="1-578"><span class="sd">            This function is deprecated and will be removed in a future release.</span>
+</span><span id="1-579">
+</span><span id="1-580"><span class="sd">        Pops a scope layer from the stack.</span>
+</span><span id="1-581">
+</span><span id="1-582"><span class="sd">        Try to use the context manager :py:meth:`push_scope` instead.</span>
+</span><span id="1-583"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-584">        <span class="n">rv</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_stack</span><span class="o">.</span><span class="n">pop</span><span class="p">()</span>
+</span><span id="1-585">        <span class="k">assert</span> <span class="bp">self</span><span class="o">.</span><span class="n">_stack</span><span class="p">,</span> <span class="s2">&quot;stack must have at least one layer&quot;</span>
+</span><span id="1-586">        <span class="k">return</span> <span class="n">rv</span></div>
 
-</span><span id="1-562">
-</span><span id="1-563">    <span class="nd">@overload</span>
-</span><span id="1-564">    <span class="k">def</span> <span class="nf">configure_scope</span><span class="p">(</span>
-</span><span id="1-565">        <span class="bp">self</span><span class="p">,</span> <span class="n">callback</span><span class="o">=</span><span class="kc">None</span>  <span class="c1"># type: Optional[None]</span>
-</span><span id="1-566">    <span class="p">):</span>
-</span><span id="1-567">        <span class="c1"># type: (...) -&gt; ContextManager[Scope]</span>
-</span><span id="1-568">        <span class="k">pass</span>
-</span><span id="1-569">
-</span><span id="1-570">    <span class="nd">@overload</span>
-</span><span id="1-571">    <span class="k">def</span> <span class="nf">configure_scope</span><span class="p">(</span>  <span class="c1"># noqa: F811</span>
-</span><span id="1-572">        <span class="bp">self</span><span class="p">,</span> <span class="n">callback</span>  <span class="c1"># type: Callable[[Scope], None]</span>
-</span><span id="1-573">    <span class="p">):</span>
-</span><span id="1-574">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-575">        <span class="k">pass</span>
-</span><span id="1-576">
+</span><span id="1-587">
+</span><span id="1-588">    <span class="nd">@overload</span>
+</span><span id="1-589">    <span class="k">def</span> <span class="nf">configure_scope</span><span class="p">(</span>
+</span><span id="1-590">        <span class="bp">self</span><span class="p">,</span> <span class="n">callback</span><span class="o">=</span><span class="kc">None</span>  <span class="c1"># type: Optional[None]</span>
+</span><span id="1-591">    <span class="p">):</span>
+</span><span id="1-592">        <span class="c1"># type: (...) -&gt; ContextManager[Scope]</span>
+</span><span id="1-593">        <span class="k">pass</span>
+</span><span id="1-594">
+</span><span id="1-595">    <span class="nd">@overload</span>
+</span><span id="1-596">    <span class="k">def</span> <span class="nf">configure_scope</span><span class="p">(</span>  <span class="c1"># noqa: F811</span>
+</span><span id="1-597">        <span class="bp">self</span><span class="p">,</span> <span class="n">callback</span>  <span class="c1"># type: Callable[[Scope], None]</span>
+</span><span id="1-598">    <span class="p">):</span>
+</span><span id="1-599">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-600">        <span class="k">pass</span>
+</span><span id="1-601">
 <div class="viewcode-block" id="Hub.configure_scope">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Hub.configure_scope">[docs]</a>
-</span><span id="1-577">    <span class="k">def</span> <span class="nf">configure_scope</span><span class="p">(</span>  <span class="c1"># noqa</span>
-</span><span id="1-578">        <span class="bp">self</span><span class="p">,</span>
-</span><span id="1-579">        <span class="n">callback</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Callable[[Scope], None]]</span>
-</span><span id="1-580">        <span class="n">continue_trace</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span>  <span class="c1"># type: bool</span>
-</span><span id="1-581">    <span class="p">):</span>
-</span><span id="1-582">        <span class="c1"># type: (...) -&gt; Optional[ContextManager[Scope]]</span>
-</span><span id="1-583">
-</span><span id="1-584"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-585"><span class="sd">        Reconfigures the scope.</span>
-</span><span id="1-586">
-</span><span id="1-587"><span class="sd">        :param callback: If provided, call the callback with the current scope.</span>
-</span><span id="1-588">
-</span><span id="1-589"><span class="sd">        :returns: If no callback is provided, returns a context manager that returns the scope.</span>
-</span><span id="1-590"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-591">
-</span><span id="1-592">        <span class="n">client</span><span class="p">,</span> <span class="n">scope</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_stack</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span>
-</span><span id="1-593">
-</span><span id="1-594">        <span class="k">if</span> <span class="n">continue_trace</span><span class="p">:</span>
-</span><span id="1-595">            <span class="n">scope</span><span class="o">.</span><span class="n">generate_propagation_context</span><span class="p">()</span>
-</span><span id="1-596">
-</span><span id="1-597">        <span class="k">if</span> <span class="n">callback</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-598">            <span class="k">if</span> <span class="n">client</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-599">                <span class="n">callback</span><span class="p">(</span><span class="n">scope</span><span class="p">)</span>
-</span><span id="1-600">
-</span><span id="1-601">            <span class="k">return</span> <span class="kc">None</span>
-</span><span id="1-602">
-</span><span id="1-603">        <span class="nd">@contextmanager</span>
-</span><span id="1-604">        <span class="k">def</span> <span class="nf">inner</span><span class="p">():</span>
-</span><span id="1-605">            <span class="c1"># type: () -&gt; Generator[Scope, None, None]</span>
-</span><span id="1-606">            <span class="k">if</span> <span class="n">client</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-607">                <span class="k">yield</span> <span class="n">scope</span>
-</span><span id="1-608">            <span class="k">else</span><span class="p">:</span>
-</span><span id="1-609">                <span class="k">yield</span> <span class="n">Scope</span><span class="p">()</span>
-</span><span id="1-610">
-</span><span id="1-611">        <span class="k">return</span> <span class="n">inner</span><span class="p">()</span></div>
+</span><span id="1-602">    <span class="k">def</span> <span class="nf">configure_scope</span><span class="p">(</span>  <span class="c1"># noqa</span>
+</span><span id="1-603">        <span class="bp">self</span><span class="p">,</span>
+</span><span id="1-604">        <span class="n">callback</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Callable[[Scope], None]]</span>
+</span><span id="1-605">        <span class="n">continue_trace</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span>  <span class="c1"># type: bool</span>
+</span><span id="1-606">    <span class="p">):</span>
+</span><span id="1-607">        <span class="c1"># type: (...) -&gt; Optional[ContextManager[Scope]]</span>
+</span><span id="1-608"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-609"><span class="sd">        .. deprecated:: 2.0.0</span>
+</span><span id="1-610"><span class="sd">            This function is deprecated and will be removed in a future release.</span>
+</span><span id="1-611">
+</span><span id="1-612"><span class="sd">        Reconfigures the scope.</span>
+</span><span id="1-613">
+</span><span id="1-614"><span class="sd">        :param callback: If provided, call the callback with the current scope.</span>
+</span><span id="1-615">
+</span><span id="1-616"><span class="sd">        :returns: If no callback is provided, returns a context manager that returns the scope.</span>
+</span><span id="1-617"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-618">        <span class="n">scope</span> <span class="o">=</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_isolation_scope</span><span class="p">()</span>
+</span><span id="1-619">
+</span><span id="1-620">        <span class="k">if</span> <span class="n">continue_trace</span><span class="p">:</span>
+</span><span id="1-621">            <span class="n">scope</span><span class="o">.</span><span class="n">generate_propagation_context</span><span class="p">()</span>
+</span><span id="1-622">
+</span><span id="1-623">        <span class="k">if</span> <span class="n">callback</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-624">            <span class="c1"># TODO: used to return None when client is None. Check if this changes behavior.</span>
+</span><span id="1-625">            <span class="n">callback</span><span class="p">(</span><span class="n">scope</span><span class="p">)</span>
+</span><span id="1-626">
+</span><span id="1-627">            <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-628">
+</span><span id="1-629">        <span class="nd">@contextmanager</span>
+</span><span id="1-630">        <span class="k">def</span> <span class="nf">inner</span><span class="p">():</span>
+</span><span id="1-631">            <span class="c1"># type: () -&gt; Generator[Scope, None, None]</span>
+</span><span id="1-632">            <span class="k">yield</span> <span class="n">scope</span>
+</span><span id="1-633">
+</span><span id="1-634">        <span class="k">return</span> <span class="n">inner</span><span class="p">()</span></div>
 
-</span><span id="1-612">
+</span><span id="1-635">
 <div class="viewcode-block" id="Hub.start_session">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Hub.start_session">[docs]</a>
-</span><span id="1-613">    <span class="k">def</span> <span class="nf">start_session</span><span class="p">(</span>
-</span><span id="1-614">        <span class="bp">self</span><span class="p">,</span> <span class="n">session_mode</span><span class="o">=</span><span class="s2">&quot;application&quot;</span>  <span class="c1"># type: str</span>
-</span><span id="1-615">    <span class="p">):</span>
-</span><span id="1-616">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-617"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Starts a new session.&quot;&quot;&quot;</span>
-</span><span id="1-618">        <span class="n">client</span><span class="p">,</span> <span class="n">scope</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_stack</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span>
-</span><span id="1-619">        <span class="n">scope</span><span class="o">.</span><span class="n">start_session</span><span class="p">(</span>
-</span><span id="1-620">            <span class="n">client</span><span class="o">=</span><span class="n">client</span><span class="p">,</span>
-</span><span id="1-621">            <span class="n">session_mode</span><span class="o">=</span><span class="n">session_mode</span><span class="p">,</span>
-</span><span id="1-622">        <span class="p">)</span></div>
+</span><span id="1-636">    <span class="k">def</span> <span class="nf">start_session</span><span class="p">(</span>
+</span><span id="1-637">        <span class="bp">self</span><span class="p">,</span> <span class="n">session_mode</span><span class="o">=</span><span class="s2">&quot;application&quot;</span>  <span class="c1"># type: str</span>
+</span><span id="1-638">    <span class="p">):</span>
+</span><span id="1-639">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-640"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-641"><span class="sd">        .. deprecated:: 2.0.0</span>
+</span><span id="1-642"><span class="sd">            This function is deprecated and will be removed in a future release.</span>
+</span><span id="1-643"><span class="sd">            Please use :py:meth:`sentry_sdk.Scope.start_session` instead.</span>
+</span><span id="1-644">
+</span><span id="1-645"><span class="sd">        Starts a new session.</span>
+</span><span id="1-646"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-647">        <span class="n">Scope</span><span class="o">.</span><span class="n">get_isolation_scope</span><span class="p">()</span><span class="o">.</span><span class="n">start_session</span><span class="p">(</span>
+</span><span id="1-648">            <span class="n">session_mode</span><span class="o">=</span><span class="n">session_mode</span><span class="p">,</span>
+</span><span id="1-649">        <span class="p">)</span></div>
 
-</span><span id="1-623">
+</span><span id="1-650">
 <div class="viewcode-block" id="Hub.end_session">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Hub.end_session">[docs]</a>
-</span><span id="1-624">    <span class="k">def</span> <span class="nf">end_session</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-625">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-626"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Ends the current session if there is one.&quot;&quot;&quot;</span>
-</span><span id="1-627">        <span class="n">client</span><span class="p">,</span> <span class="n">scope</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_stack</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span>
-</span><span id="1-628">        <span class="n">scope</span><span class="o">.</span><span class="n">end_session</span><span class="p">(</span><span class="n">client</span><span class="o">=</span><span class="n">client</span><span class="p">)</span></div>
+</span><span id="1-651">    <span class="k">def</span> <span class="nf">end_session</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-652">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-653"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-654"><span class="sd">        .. deprecated:: 2.0.0</span>
+</span><span id="1-655"><span class="sd">            This function is deprecated and will be removed in a future release.</span>
+</span><span id="1-656"><span class="sd">            Please use :py:meth:`sentry_sdk.Scope.end_session` instead.</span>
+</span><span id="1-657">
+</span><span id="1-658"><span class="sd">        Ends the current session if there is one.</span>
+</span><span id="1-659"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-660">        <span class="n">Scope</span><span class="o">.</span><span class="n">get_isolation_scope</span><span class="p">()</span><span class="o">.</span><span class="n">end_session</span><span class="p">()</span></div>
 
-</span><span id="1-629">
+</span><span id="1-661">
 <div class="viewcode-block" id="Hub.stop_auto_session_tracking">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Hub.stop_auto_session_tracking">[docs]</a>
-</span><span id="1-630">    <span class="k">def</span> <span class="nf">stop_auto_session_tracking</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-631">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-632"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Stops automatic session tracking.</span>
-</span><span id="1-633">
-</span><span id="1-634"><span class="sd">        This temporarily session tracking for the current scope when called.</span>
-</span><span id="1-635"><span class="sd">        To resume session tracking call `resume_auto_session_tracking`.</span>
-</span><span id="1-636"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-637">        <span class="n">client</span><span class="p">,</span> <span class="n">scope</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_stack</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span>
-</span><span id="1-638">        <span class="n">scope</span><span class="o">.</span><span class="n">stop_auto_session_tracking</span><span class="p">(</span><span class="n">client</span><span class="o">=</span><span class="n">client</span><span class="p">)</span></div>
+</span><span id="1-662">    <span class="k">def</span> <span class="nf">stop_auto_session_tracking</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-663">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-664"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-665"><span class="sd">        .. deprecated:: 2.0.0</span>
+</span><span id="1-666"><span class="sd">            This function is deprecated and will be removed in a future release.</span>
+</span><span id="1-667"><span class="sd">            Please use :py:meth:`sentry_sdk.Scope.stop_auto_session_tracking` instead.</span>
+</span><span id="1-668">
+</span><span id="1-669"><span class="sd">        Stops automatic session tracking.</span>
+</span><span id="1-670">
+</span><span id="1-671"><span class="sd">        This temporarily session tracking for the current scope when called.</span>
+</span><span id="1-672"><span class="sd">        To resume session tracking call `resume_auto_session_tracking`.</span>
+</span><span id="1-673"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-674">        <span class="n">Scope</span><span class="o">.</span><span class="n">get_isolation_scope</span><span class="p">()</span><span class="o">.</span><span class="n">stop_auto_session_tracking</span><span class="p">()</span></div>
 
-</span><span id="1-639">
+</span><span id="1-675">
 <div class="viewcode-block" id="Hub.resume_auto_session_tracking">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Hub.resume_auto_session_tracking">[docs]</a>
-</span><span id="1-640">    <span class="k">def</span> <span class="nf">resume_auto_session_tracking</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-641">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-642"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Resumes automatic session tracking for the current scope if</span>
-</span><span id="1-643"><span class="sd">        disabled earlier.  This requires that generally automatic session</span>
-</span><span id="1-644"><span class="sd">        tracking is enabled.</span>
-</span><span id="1-645"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-646">        <span class="n">scope</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_stack</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">][</span><span class="mi">1</span><span class="p">]</span>
-</span><span id="1-647">        <span class="n">scope</span><span class="o">.</span><span class="n">resume_auto_session_tracking</span><span class="p">()</span></div>
+</span><span id="1-676">    <span class="k">def</span> <span class="nf">resume_auto_session_tracking</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-677">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-678"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-679"><span class="sd">        .. deprecated:: 2.0.0</span>
+</span><span id="1-680"><span class="sd">            This function is deprecated and will be removed in a future release.</span>
+</span><span id="1-681"><span class="sd">            Please use :py:meth:`sentry_sdk.Scope.resume_auto_session_tracking` instead.</span>
+</span><span id="1-682">
+</span><span id="1-683"><span class="sd">        Resumes automatic session tracking for the current scope if</span>
+</span><span id="1-684"><span class="sd">        disabled earlier.  This requires that generally automatic session</span>
+</span><span id="1-685"><span class="sd">        tracking is enabled.</span>
+</span><span id="1-686"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-687">        <span class="n">Scope</span><span class="o">.</span><span class="n">get_isolation_scope</span><span class="p">()</span><span class="o">.</span><span class="n">resume_auto_session_tracking</span><span class="p">()</span></div>
 
-</span><span id="1-648">
+</span><span id="1-688">
 <div class="viewcode-block" id="Hub.flush">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Hub.flush">[docs]</a>
-</span><span id="1-649">    <span class="k">def</span> <span class="nf">flush</span><span class="p">(</span>
-</span><span id="1-650">        <span class="bp">self</span><span class="p">,</span>
-</span><span id="1-651">        <span class="n">timeout</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[float]</span>
-</span><span id="1-652">        <span class="n">callback</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Callable[[int, float], None]]</span>
-</span><span id="1-653">    <span class="p">):</span>
-</span><span id="1-654">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-655"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-656"><span class="sd">        Alias for :py:meth:`sentry_sdk.Client.flush`</span>
-</span><span id="1-657"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-658">        <span class="n">client</span><span class="p">,</span> <span class="n">scope</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_stack</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span>
-</span><span id="1-659">        <span class="k">if</span> <span class="n">client</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-660">            <span class="k">return</span> <span class="n">client</span><span class="o">.</span><span class="n">flush</span><span class="p">(</span><span class="n">timeout</span><span class="o">=</span><span class="n">timeout</span><span class="p">,</span> <span class="n">callback</span><span class="o">=</span><span class="n">callback</span><span class="p">)</span></div>
+</span><span id="1-689">    <span class="k">def</span> <span class="nf">flush</span><span class="p">(</span>
+</span><span id="1-690">        <span class="bp">self</span><span class="p">,</span>
+</span><span id="1-691">        <span class="n">timeout</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[float]</span>
+</span><span id="1-692">        <span class="n">callback</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Callable[[int, float], None]]</span>
+</span><span id="1-693">    <span class="p">):</span>
+</span><span id="1-694">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-695"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-696"><span class="sd">        .. deprecated:: 2.0.0</span>
+</span><span id="1-697"><span class="sd">            This function is deprecated and will be removed in a future release.</span>
+</span><span id="1-698"><span class="sd">            Please use :py:meth:`sentry_sdk.client._Client.flush` instead.</span>
+</span><span id="1-699">
+</span><span id="1-700"><span class="sd">        Alias for :py:meth:`sentry_sdk.client._Client.flush`</span>
+</span><span id="1-701"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-702">        <span class="k">return</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_client</span><span class="p">()</span><span class="o">.</span><span class="n">flush</span><span class="p">(</span><span class="n">timeout</span><span class="o">=</span><span class="n">timeout</span><span class="p">,</span> <span class="n">callback</span><span class="o">=</span><span class="n">callback</span><span class="p">)</span></div>
 
-</span><span id="1-661">
+</span><span id="1-703">
 <div class="viewcode-block" id="Hub.get_traceparent">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Hub.get_traceparent">[docs]</a>
-</span><span id="1-662">    <span class="k">def</span> <span class="nf">get_traceparent</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-663">        <span class="c1"># type: () -&gt; Optional[str]</span>
-</span><span id="1-664"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-665"><span class="sd">        Returns the traceparent either from the active span or from the scope.</span>
-</span><span id="1-666"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-667">        <span class="n">client</span><span class="p">,</span> <span class="n">scope</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_stack</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span>
-</span><span id="1-668">        <span class="k">return</span> <span class="n">scope</span><span class="o">.</span><span class="n">get_traceparent</span><span class="p">(</span><span class="n">client</span><span class="o">=</span><span class="n">client</span><span class="p">)</span></div>
+</span><span id="1-704">    <span class="k">def</span> <span class="nf">get_traceparent</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-705">        <span class="c1"># type: () -&gt; Optional[str]</span>
+</span><span id="1-706"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-707"><span class="sd">        .. deprecated:: 2.0.0</span>
+</span><span id="1-708"><span class="sd">            This function is deprecated and will be removed in a future release.</span>
+</span><span id="1-709"><span class="sd">            Please use :py:meth:`sentry_sdk.Scope.get_traceparent` instead.</span>
+</span><span id="1-710">
+</span><span id="1-711"><span class="sd">        Returns the traceparent either from the active span or from the scope.</span>
+</span><span id="1-712"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-713">        <span class="n">current_scope</span> <span class="o">=</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_current_scope</span><span class="p">()</span>
+</span><span id="1-714">        <span class="n">traceparent</span> <span class="o">=</span> <span class="n">current_scope</span><span class="o">.</span><span class="n">get_traceparent</span><span class="p">()</span>
+</span><span id="1-715">
+</span><span id="1-716">        <span class="k">if</span> <span class="n">traceparent</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-717">            <span class="n">isolation_scope</span> <span class="o">=</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_isolation_scope</span><span class="p">()</span>
+</span><span id="1-718">            <span class="n">traceparent</span> <span class="o">=</span> <span class="n">isolation_scope</span><span class="o">.</span><span class="n">get_traceparent</span><span class="p">()</span>
+</span><span id="1-719">
+</span><span id="1-720">        <span class="k">return</span> <span class="n">traceparent</span></div>
 
-</span><span id="1-669">
+</span><span id="1-721">
 <div class="viewcode-block" id="Hub.get_baggage">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Hub.get_baggage">[docs]</a>
-</span><span id="1-670">    <span class="k">def</span> <span class="nf">get_baggage</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-671">        <span class="c1"># type: () -&gt; Optional[str]</span>
-</span><span id="1-672"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-673"><span class="sd">        Returns Baggage either from the active span or from the scope.</span>
-</span><span id="1-674"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-675">        <span class="n">client</span><span class="p">,</span> <span class="n">scope</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_stack</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span>
-</span><span id="1-676">        <span class="n">baggage</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">get_baggage</span><span class="p">(</span><span class="n">client</span><span class="o">=</span><span class="n">client</span><span class="p">)</span>
-</span><span id="1-677">
-</span><span id="1-678">        <span class="k">if</span> <span class="n">baggage</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-679">            <span class="k">return</span> <span class="n">baggage</span><span class="o">.</span><span class="n">serialize</span><span class="p">()</span>
-</span><span id="1-680">
-</span><span id="1-681">        <span class="k">return</span> <span class="kc">None</span></div>
+</span><span id="1-722">    <span class="k">def</span> <span class="nf">get_baggage</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-723">        <span class="c1"># type: () -&gt; Optional[str]</span>
+</span><span id="1-724"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-725"><span class="sd">        .. deprecated:: 2.0.0</span>
+</span><span id="1-726"><span class="sd">            This function is deprecated and will be removed in a future release.</span>
+</span><span id="1-727"><span class="sd">            Please use :py:meth:`sentry_sdk.Scope.get_baggage` instead.</span>
+</span><span id="1-728">
+</span><span id="1-729"><span class="sd">        Returns Baggage either from the active span or from the scope.</span>
+</span><span id="1-730"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-731">        <span class="n">current_scope</span> <span class="o">=</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_current_scope</span><span class="p">()</span>
+</span><span id="1-732">        <span class="n">baggage</span> <span class="o">=</span> <span class="n">current_scope</span><span class="o">.</span><span class="n">get_baggage</span><span class="p">()</span>
+</span><span id="1-733">
+</span><span id="1-734">        <span class="k">if</span> <span class="n">baggage</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-735">            <span class="n">isolation_scope</span> <span class="o">=</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_isolation_scope</span><span class="p">()</span>
+</span><span id="1-736">            <span class="n">baggage</span> <span class="o">=</span> <span class="n">isolation_scope</span><span class="o">.</span><span class="n">get_baggage</span><span class="p">()</span>
+</span><span id="1-737">
+</span><span id="1-738">        <span class="k">if</span> <span class="n">baggage</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-739">            <span class="k">return</span> <span class="n">baggage</span><span class="o">.</span><span class="n">serialize</span><span class="p">()</span>
+</span><span id="1-740">
+</span><span id="1-741">        <span class="k">return</span> <span class="kc">None</span></div>
 
-</span><span id="1-682">
+</span><span id="1-742">
 <div class="viewcode-block" id="Hub.iter_trace_propagation_headers">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Hub.iter_trace_propagation_headers">[docs]</a>
-</span><span id="1-683">    <span class="k">def</span> <span class="nf">iter_trace_propagation_headers</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">span</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-</span><span id="1-684">        <span class="c1"># type: (Optional[Span]) -&gt; Generator[Tuple[str, str], None, None]</span>
-</span><span id="1-685"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-686"><span class="sd">        Return HTTP headers which allow propagation of trace data. Data taken</span>
-</span><span id="1-687"><span class="sd">        from the span representing the request, if available, or the current</span>
-</span><span id="1-688"><span class="sd">        span on the scope if not.</span>
-</span><span id="1-689"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-690">        <span class="n">client</span><span class="p">,</span> <span class="n">scope</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_stack</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span>
-</span><span id="1-691">
-</span><span id="1-692">        <span class="k">return</span> <span class="n">scope</span><span class="o">.</span><span class="n">iter_trace_propagation_headers</span><span class="p">(</span><span class="n">span</span><span class="o">=</span><span class="n">span</span><span class="p">,</span> <span class="n">client</span><span class="o">=</span><span class="n">client</span><span class="p">)</span></div>
+</span><span id="1-743">    <span class="k">def</span> <span class="nf">iter_trace_propagation_headers</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">span</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+</span><span id="1-744">        <span class="c1"># type: (Optional[Span]) -&gt; Generator[Tuple[str, str], None, None]</span>
+</span><span id="1-745"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-746"><span class="sd">        .. deprecated:: 2.0.0</span>
+</span><span id="1-747"><span class="sd">            This function is deprecated and will be removed in a future release.</span>
+</span><span id="1-748"><span class="sd">            Please use :py:meth:`sentry_sdk.Scope.iter_trace_propagation_headers` instead.</span>
+</span><span id="1-749">
+</span><span id="1-750"><span class="sd">        Return HTTP headers which allow propagation of trace data. Data taken</span>
+</span><span id="1-751"><span class="sd">        from the span representing the request, if available, or the current</span>
+</span><span id="1-752"><span class="sd">        span on the scope if not.</span>
+</span><span id="1-753"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-754">        <span class="k">return</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_current_scope</span><span class="p">()</span><span class="o">.</span><span class="n">iter_trace_propagation_headers</span><span class="p">(</span>
+</span><span id="1-755">            <span class="n">span</span><span class="o">=</span><span class="n">span</span><span class="p">,</span>
+</span><span id="1-756">        <span class="p">)</span></div>
 
-</span><span id="1-693">
+</span><span id="1-757">
 <div class="viewcode-block" id="Hub.trace_propagation_meta">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Hub.trace_propagation_meta">[docs]</a>
-</span><span id="1-694">    <span class="k">def</span> <span class="nf">trace_propagation_meta</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">span</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-</span><span id="1-695">        <span class="c1"># type: (Optional[Span]) -&gt; str</span>
-</span><span id="1-696"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-697"><span class="sd">        Return meta tags which should be injected into HTML templates</span>
-</span><span id="1-698"><span class="sd">        to allow propagation of trace information.</span>
-</span><span id="1-699"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-700">        <span class="k">if</span> <span class="n">span</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-701">            <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
-</span><span id="1-702">                <span class="s2">&quot;The parameter `span` in trace_propagation_meta() is deprecated and will be removed in the future.&quot;</span>
-</span><span id="1-703">            <span class="p">)</span>
-</span><span id="1-704">
-</span><span id="1-705">        <span class="n">client</span><span class="p">,</span> <span class="n">scope</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_stack</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span>
-</span><span id="1-706">        <span class="k">return</span> <span class="n">scope</span><span class="o">.</span><span class="n">trace_propagation_meta</span><span class="p">(</span><span class="n">span</span><span class="o">=</span><span class="n">span</span><span class="p">,</span> <span class="n">client</span><span class="o">=</span><span class="n">client</span><span class="p">)</span></div>
+</span><span id="1-758">    <span class="k">def</span> <span class="nf">trace_propagation_meta</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">span</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+</span><span id="1-759">        <span class="c1"># type: (Optional[Span]) -&gt; str</span>
+</span><span id="1-760"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-761"><span class="sd">        .. deprecated:: 2.0.0</span>
+</span><span id="1-762"><span class="sd">            This function is deprecated and will be removed in a future release.</span>
+</span><span id="1-763"><span class="sd">            Please use :py:meth:`sentry_sdk.Scope.trace_propagation_meta` instead.</span>
+</span><span id="1-764">
+</span><span id="1-765"><span class="sd">        Return meta tags which should be injected into HTML templates</span>
+</span><span id="1-766"><span class="sd">        to allow propagation of trace information.</span>
+</span><span id="1-767"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-768">        <span class="k">if</span> <span class="n">span</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-769">            <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
+</span><span id="1-770">                <span class="s2">&quot;The parameter `span` in trace_propagation_meta() is deprecated and will be removed in the future.&quot;</span>
+</span><span id="1-771">            <span class="p">)</span>
+</span><span id="1-772">
+</span><span id="1-773">        <span class="k">return</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_current_scope</span><span class="p">()</span><span class="o">.</span><span class="n">trace_propagation_meta</span><span class="p">(</span>
+</span><span id="1-774">            <span class="n">span</span><span class="o">=</span><span class="n">span</span><span class="p">,</span>
+</span><span id="1-775">        <span class="p">)</span></div>
 </div>
 
-</span><span id="1-707">
-</span><span id="1-708">
-</span><span id="1-709"><span class="n">GLOBAL_HUB</span> <span class="o">=</span> <span class="n">Hub</span><span class="p">()</span>
-</span><span id="1-710"><span class="n">_local</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="n">GLOBAL_HUB</span><span class="p">)</span>
+</span><span id="1-776">
+</span><span id="1-777">
+</span><span id="1-778"><span class="n">GLOBAL_HUB</span> <span class="o">=</span> <span class="n">Hub</span><span class="p">()</span>
+</span><span id="1-779"><span class="n">_local</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="n">GLOBAL_HUB</span><span class="p">)</span>
+</span><span id="1-780">
+</span><span id="1-781">
+</span><span id="1-782"><span class="c1"># Circular imports</span>
+</span><span id="1-783"><span class="kn">from</span> <span class="nn">sentry_sdk</span> <span class="kn">import</span> <span class="n">scope</span>
 </span></pre></div>
         </article>
         
@@ -946,7 +1019,7 @@ <h1>Source code for sentry_sdk.hub</h1><div class="highlight"><pre>
     </div>
   </div>
 </footer></div>
-      <script src="../../_static/documentation_options.js?v=fca6d697"></script>
+      <script src="../../_static/documentation_options.js?v=aa9da443"></script>
       <script src="../../_static/doctools.js?v=888ff710"></script>
       <script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
       <script src="../../_static/shibuya.js?v=999236dc"></script>
diff --git a/_modules/sentry_sdk/integrations/logging.html b/_modules/sentry_sdk/integrations/logging.html
index 61716251c6..9723c9a297 100644
--- a/_modules/sentry_sdk/integrations/logging.html
+++ b/_modules/sentry_sdk/integrations/logging.html
@@ -4,7 +4,7 @@
 <head>
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-      <title>sentry_sdk.integrations.logging - sentry-python 1.44.1 documentation</title>
+      <title>sentry_sdk.integrations.logging - sentry-python 2.0.0rc4 documentation</title>
     <link rel="index" title="Index" href="../../../genindex.html" /><link rel="search" title="Search" href="../../../search.html" />
 
   <script>
@@ -132,308 +132,307 @@
       <div class="min-w-0 max-w-6xl px-6 pb-6 pt-8 xl:px-12">
         <article class="yue" role="main">
           <h1>Source code for sentry_sdk.integrations.logging</h1><div class="highlight"><pre>
-<span></span><span id="1-1"><span class="kn">from</span> <span class="nn">__future__</span> <span class="kn">import</span> <span class="n">absolute_import</span>
-</span><span id="1-2">
-</span><span id="1-3"><span class="kn">import</span> <span class="nn">logging</span>
-</span><span id="1-4"><span class="kn">from</span> <span class="nn">fnmatch</span> <span class="kn">import</span> <span class="n">fnmatch</span>
-</span><span id="1-5">
-</span><span id="1-6"><span class="kn">from</span> <span class="nn">sentry_sdk.hub</span> <span class="kn">import</span> <span class="n">Hub</span>
-</span><span id="1-7"><span class="kn">from</span> <span class="nn">sentry_sdk.utils</span> <span class="kn">import</span> <span class="p">(</span>
-</span><span id="1-8">    <span class="n">to_string</span><span class="p">,</span>
-</span><span id="1-9">    <span class="n">event_from_exception</span><span class="p">,</span>
-</span><span id="1-10">    <span class="n">current_stacktrace</span><span class="p">,</span>
-</span><span id="1-11">    <span class="n">capture_internal_exceptions</span><span class="p">,</span>
-</span><span id="1-12"><span class="p">)</span>
-</span><span id="1-13"><span class="kn">from</span> <span class="nn">sentry_sdk.integrations</span> <span class="kn">import</span> <span class="n">Integration</span>
-</span><span id="1-14"><span class="kn">from</span> <span class="nn">sentry_sdk._compat</span> <span class="kn">import</span> <span class="n">iteritems</span><span class="p">,</span> <span class="n">utc_from_timestamp</span>
-</span><span id="1-15">
-</span><span id="1-16"><span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="n">TYPE_CHECKING</span>
-</span><span id="1-17">
-</span><span id="1-18"><span class="k">if</span> <span class="n">TYPE_CHECKING</span><span class="p">:</span>
-</span><span id="1-19">    <span class="kn">from</span> <span class="nn">collections.abc</span> <span class="kn">import</span> <span class="n">MutableMapping</span>
-</span><span id="1-20">    <span class="kn">from</span> <span class="nn">logging</span> <span class="kn">import</span> <span class="n">LogRecord</span>
-</span><span id="1-21">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Any</span>
-</span><span id="1-22">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Dict</span>
-</span><span id="1-23">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Optional</span>
-</span><span id="1-24">
-</span><span id="1-25"><span class="n">DEFAULT_LEVEL</span> <span class="o">=</span> <span class="n">logging</span><span class="o">.</span><span class="n">INFO</span>
-</span><span id="1-26"><span class="n">DEFAULT_EVENT_LEVEL</span> <span class="o">=</span> <span class="n">logging</span><span class="o">.</span><span class="n">ERROR</span>
-</span><span id="1-27"><span class="n">LOGGING_TO_EVENT_LEVEL</span> <span class="o">=</span> <span class="p">{</span>
-</span><span id="1-28">    <span class="n">logging</span><span class="o">.</span><span class="n">NOTSET</span><span class="p">:</span> <span class="s2">&quot;notset&quot;</span><span class="p">,</span>
-</span><span id="1-29">    <span class="n">logging</span><span class="o">.</span><span class="n">DEBUG</span><span class="p">:</span> <span class="s2">&quot;debug&quot;</span><span class="p">,</span>
-</span><span id="1-30">    <span class="n">logging</span><span class="o">.</span><span class="n">INFO</span><span class="p">:</span> <span class="s2">&quot;info&quot;</span><span class="p">,</span>
-</span><span id="1-31">    <span class="n">logging</span><span class="o">.</span><span class="n">WARN</span><span class="p">:</span> <span class="s2">&quot;warning&quot;</span><span class="p">,</span>  <span class="c1"># WARN is same a WARNING</span>
-</span><span id="1-32">    <span class="n">logging</span><span class="o">.</span><span class="n">WARNING</span><span class="p">:</span> <span class="s2">&quot;warning&quot;</span><span class="p">,</span>
-</span><span id="1-33">    <span class="n">logging</span><span class="o">.</span><span class="n">ERROR</span><span class="p">:</span> <span class="s2">&quot;error&quot;</span><span class="p">,</span>
-</span><span id="1-34">    <span class="n">logging</span><span class="o">.</span><span class="n">FATAL</span><span class="p">:</span> <span class="s2">&quot;fatal&quot;</span><span class="p">,</span>
-</span><span id="1-35">    <span class="n">logging</span><span class="o">.</span><span class="n">CRITICAL</span><span class="p">:</span> <span class="s2">&quot;fatal&quot;</span><span class="p">,</span>  <span class="c1"># CRITICAL is same as FATAL</span>
-</span><span id="1-36"><span class="p">}</span>
-</span><span id="1-37">
-</span><span id="1-38"><span class="c1"># Capturing events from those loggers causes recursion errors. We cannot allow</span>
-</span><span id="1-39"><span class="c1"># the user to unconditionally create events from those loggers under any</span>
-</span><span id="1-40"><span class="c1"># circumstances.</span>
-</span><span id="1-41"><span class="c1">#</span>
-</span><span id="1-42"><span class="c1"># Note: Ignoring by logger name here is better than mucking with thread-locals.</span>
-</span><span id="1-43"><span class="c1"># We do not necessarily know whether thread-locals work 100% correctly in the user&#39;s environment.</span>
-</span><span id="1-44"><span class="n">_IGNORED_LOGGERS</span> <span class="o">=</span> <span class="nb">set</span><span class="p">(</span>
-</span><span id="1-45">    <span class="p">[</span><span class="s2">&quot;sentry_sdk.errors&quot;</span><span class="p">,</span> <span class="s2">&quot;urllib3.connectionpool&quot;</span><span class="p">,</span> <span class="s2">&quot;urllib3.connection&quot;</span><span class="p">]</span>
-</span><span id="1-46"><span class="p">)</span>
-</span><span id="1-47">
-</span><span id="1-48">
+<span></span><span id="1-1"><span class="kn">import</span> <span class="nn">logging</span>
+</span><span id="1-2"><span class="kn">from</span> <span class="nn">datetime</span> <span class="kn">import</span> <span class="n">datetime</span><span class="p">,</span> <span class="n">timezone</span>
+</span><span id="1-3"><span class="kn">from</span> <span class="nn">fnmatch</span> <span class="kn">import</span> <span class="n">fnmatch</span>
+</span><span id="1-4">
+</span><span id="1-5"><span class="kn">import</span> <span class="nn">sentry_sdk</span>
+</span><span id="1-6"><span class="kn">from</span> <span class="nn">sentry_sdk.utils</span> <span class="kn">import</span> <span class="p">(</span>
+</span><span id="1-7">    <span class="n">to_string</span><span class="p">,</span>
+</span><span id="1-8">    <span class="n">event_from_exception</span><span class="p">,</span>
+</span><span id="1-9">    <span class="n">current_stacktrace</span><span class="p">,</span>
+</span><span id="1-10">    <span class="n">capture_internal_exceptions</span><span class="p">,</span>
+</span><span id="1-11"><span class="p">)</span>
+</span><span id="1-12"><span class="kn">from</span> <span class="nn">sentry_sdk.integrations</span> <span class="kn">import</span> <span class="n">Integration</span>
+</span><span id="1-13"><span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="n">TYPE_CHECKING</span>
+</span><span id="1-14">
+</span><span id="1-15"><span class="k">if</span> <span class="n">TYPE_CHECKING</span><span class="p">:</span>
+</span><span id="1-16">    <span class="kn">from</span> <span class="nn">collections.abc</span> <span class="kn">import</span> <span class="n">MutableMapping</span>
+</span><span id="1-17">    <span class="kn">from</span> <span class="nn">logging</span> <span class="kn">import</span> <span class="n">LogRecord</span>
+</span><span id="1-18">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Any</span>
+</span><span id="1-19">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Dict</span>
+</span><span id="1-20">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Optional</span>
+</span><span id="1-21">
+</span><span id="1-22"><span class="n">DEFAULT_LEVEL</span> <span class="o">=</span> <span class="n">logging</span><span class="o">.</span><span class="n">INFO</span>
+</span><span id="1-23"><span class="n">DEFAULT_EVENT_LEVEL</span> <span class="o">=</span> <span class="n">logging</span><span class="o">.</span><span class="n">ERROR</span>
+</span><span id="1-24"><span class="n">LOGGING_TO_EVENT_LEVEL</span> <span class="o">=</span> <span class="p">{</span>
+</span><span id="1-25">    <span class="n">logging</span><span class="o">.</span><span class="n">NOTSET</span><span class="p">:</span> <span class="s2">&quot;notset&quot;</span><span class="p">,</span>
+</span><span id="1-26">    <span class="n">logging</span><span class="o">.</span><span class="n">DEBUG</span><span class="p">:</span> <span class="s2">&quot;debug&quot;</span><span class="p">,</span>
+</span><span id="1-27">    <span class="n">logging</span><span class="o">.</span><span class="n">INFO</span><span class="p">:</span> <span class="s2">&quot;info&quot;</span><span class="p">,</span>
+</span><span id="1-28">    <span class="n">logging</span><span class="o">.</span><span class="n">WARN</span><span class="p">:</span> <span class="s2">&quot;warning&quot;</span><span class="p">,</span>  <span class="c1"># WARN is same a WARNING</span>
+</span><span id="1-29">    <span class="n">logging</span><span class="o">.</span><span class="n">WARNING</span><span class="p">:</span> <span class="s2">&quot;warning&quot;</span><span class="p">,</span>
+</span><span id="1-30">    <span class="n">logging</span><span class="o">.</span><span class="n">ERROR</span><span class="p">:</span> <span class="s2">&quot;error&quot;</span><span class="p">,</span>
+</span><span id="1-31">    <span class="n">logging</span><span class="o">.</span><span class="n">FATAL</span><span class="p">:</span> <span class="s2">&quot;fatal&quot;</span><span class="p">,</span>
+</span><span id="1-32">    <span class="n">logging</span><span class="o">.</span><span class="n">CRITICAL</span><span class="p">:</span> <span class="s2">&quot;fatal&quot;</span><span class="p">,</span>  <span class="c1"># CRITICAL is same as FATAL</span>
+</span><span id="1-33"><span class="p">}</span>
+</span><span id="1-34">
+</span><span id="1-35"><span class="c1"># Capturing events from those loggers causes recursion errors. We cannot allow</span>
+</span><span id="1-36"><span class="c1"># the user to unconditionally create events from those loggers under any</span>
+</span><span id="1-37"><span class="c1"># circumstances.</span>
+</span><span id="1-38"><span class="c1">#</span>
+</span><span id="1-39"><span class="c1"># Note: Ignoring by logger name here is better than mucking with thread-locals.</span>
+</span><span id="1-40"><span class="c1"># We do not necessarily know whether thread-locals work 100% correctly in the user&#39;s environment.</span>
+</span><span id="1-41"><span class="n">_IGNORED_LOGGERS</span> <span class="o">=</span> <span class="nb">set</span><span class="p">(</span>
+</span><span id="1-42">    <span class="p">[</span><span class="s2">&quot;sentry_sdk.errors&quot;</span><span class="p">,</span> <span class="s2">&quot;urllib3.connectionpool&quot;</span><span class="p">,</span> <span class="s2">&quot;urllib3.connection&quot;</span><span class="p">]</span>
+</span><span id="1-43"><span class="p">)</span>
+</span><span id="1-44">
+</span><span id="1-45">
 <div class="viewcode-block" id="ignore_logger">
 <a class="viewcode-back" href="../../../integrations.html#sentry_sdk.integrations.logging.ignore_logger">[docs]</a>
-</span><span id="1-49"><span class="k">def</span> <span class="nf">ignore_logger</span><span class="p">(</span>
-</span><span id="1-50">    <span class="n">name</span><span class="p">,</span>  <span class="c1"># type: str</span>
-</span><span id="1-51"><span class="p">):</span>
-</span><span id="1-52">    <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-53"><span class="w">    </span><span class="sd">&quot;&quot;&quot;This disables recording (both in breadcrumbs and as events) calls to</span>
-</span><span id="1-54"><span class="sd">    a logger of a specific name.  Among other uses, many of our integrations</span>
-</span><span id="1-55"><span class="sd">    use this to prevent their actions being recorded as breadcrumbs. Exposed</span>
-</span><span id="1-56"><span class="sd">    to users as a way to quiet spammy loggers.</span>
-</span><span id="1-57">
-</span><span id="1-58"><span class="sd">    :param name: The name of the logger to ignore (same string you would pass to ``logging.getLogger``).</span>
-</span><span id="1-59"><span class="sd">    &quot;&quot;&quot;</span>
-</span><span id="1-60">    <span class="n">_IGNORED_LOGGERS</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">name</span><span class="p">)</span></div>
+</span><span id="1-46"><span class="k">def</span> <span class="nf">ignore_logger</span><span class="p">(</span>
+</span><span id="1-47">    <span class="n">name</span><span class="p">,</span>  <span class="c1"># type: str</span>
+</span><span id="1-48"><span class="p">):</span>
+</span><span id="1-49">    <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-50"><span class="w">    </span><span class="sd">&quot;&quot;&quot;This disables recording (both in breadcrumbs and as events) calls to</span>
+</span><span id="1-51"><span class="sd">    a logger of a specific name.  Among other uses, many of our integrations</span>
+</span><span id="1-52"><span class="sd">    use this to prevent their actions being recorded as breadcrumbs. Exposed</span>
+</span><span id="1-53"><span class="sd">    to users as a way to quiet spammy loggers.</span>
+</span><span id="1-54">
+</span><span id="1-55"><span class="sd">    :param name: The name of the logger to ignore (same string you would pass to ``logging.getLogger``).</span>
+</span><span id="1-56"><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="1-57">    <span class="n">_IGNORED_LOGGERS</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">name</span><span class="p">)</span></div>
 
-</span><span id="1-61">
+</span><span id="1-58">
+</span><span id="1-59">
+</span><span id="1-60"><span class="k">class</span> <span class="nc">LoggingIntegration</span><span class="p">(</span><span class="n">Integration</span><span class="p">):</span>
+</span><span id="1-61">    <span class="n">identifier</span> <span class="o">=</span> <span class="s2">&quot;logging&quot;</span>
 </span><span id="1-62">
-</span><span id="1-63"><span class="k">class</span> <span class="nc">LoggingIntegration</span><span class="p">(</span><span class="n">Integration</span><span class="p">):</span>
-</span><span id="1-64">    <span class="n">identifier</span> <span class="o">=</span> <span class="s2">&quot;logging&quot;</span>
-</span><span id="1-65">
-</span><span id="1-66">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">level</span><span class="o">=</span><span class="n">DEFAULT_LEVEL</span><span class="p">,</span> <span class="n">event_level</span><span class="o">=</span><span class="n">DEFAULT_EVENT_LEVEL</span><span class="p">):</span>
-</span><span id="1-67">        <span class="c1"># type: (Optional[int], Optional[int]) -&gt; None</span>
-</span><span id="1-68">        <span class="bp">self</span><span class="o">.</span><span class="n">_handler</span> <span class="o">=</span> <span class="kc">None</span>
-</span><span id="1-69">        <span class="bp">self</span><span class="o">.</span><span class="n">_breadcrumb_handler</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="1-63">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">level</span><span class="o">=</span><span class="n">DEFAULT_LEVEL</span><span class="p">,</span> <span class="n">event_level</span><span class="o">=</span><span class="n">DEFAULT_EVENT_LEVEL</span><span class="p">):</span>
+</span><span id="1-64">        <span class="c1"># type: (Optional[int], Optional[int]) -&gt; None</span>
+</span><span id="1-65">        <span class="bp">self</span><span class="o">.</span><span class="n">_handler</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="1-66">        <span class="bp">self</span><span class="o">.</span><span class="n">_breadcrumb_handler</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="1-67">
+</span><span id="1-68">        <span class="k">if</span> <span class="n">level</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-69">            <span class="bp">self</span><span class="o">.</span><span class="n">_breadcrumb_handler</span> <span class="o">=</span> <span class="n">BreadcrumbHandler</span><span class="p">(</span><span class="n">level</span><span class="o">=</span><span class="n">level</span><span class="p">)</span>
 </span><span id="1-70">
-</span><span id="1-71">        <span class="k">if</span> <span class="n">level</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-72">            <span class="bp">self</span><span class="o">.</span><span class="n">_breadcrumb_handler</span> <span class="o">=</span> <span class="n">BreadcrumbHandler</span><span class="p">(</span><span class="n">level</span><span class="o">=</span><span class="n">level</span><span class="p">)</span>
+</span><span id="1-71">        <span class="k">if</span> <span class="n">event_level</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-72">            <span class="bp">self</span><span class="o">.</span><span class="n">_handler</span> <span class="o">=</span> <span class="n">EventHandler</span><span class="p">(</span><span class="n">level</span><span class="o">=</span><span class="n">event_level</span><span class="p">)</span>
 </span><span id="1-73">
-</span><span id="1-74">        <span class="k">if</span> <span class="n">event_level</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-75">            <span class="bp">self</span><span class="o">.</span><span class="n">_handler</span> <span class="o">=</span> <span class="n">EventHandler</span><span class="p">(</span><span class="n">level</span><span class="o">=</span><span class="n">event_level</span><span class="p">)</span>
-</span><span id="1-76">
-</span><span id="1-77">    <span class="k">def</span> <span class="nf">_handle_record</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">record</span><span class="p">):</span>
-</span><span id="1-78">        <span class="c1"># type: (LogRecord) -&gt; None</span>
-</span><span id="1-79">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_handler</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">record</span><span class="o">.</span><span class="n">levelno</span> <span class="o">&gt;=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_handler</span><span class="o">.</span><span class="n">level</span><span class="p">:</span>
-</span><span id="1-80">            <span class="bp">self</span><span class="o">.</span><span class="n">_handler</span><span class="o">.</span><span class="n">handle</span><span class="p">(</span><span class="n">record</span><span class="p">)</span>
-</span><span id="1-81">
-</span><span id="1-82">        <span class="k">if</span> <span class="p">(</span>
-</span><span id="1-83">            <span class="bp">self</span><span class="o">.</span><span class="n">_breadcrumb_handler</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span>
-</span><span id="1-84">            <span class="ow">and</span> <span class="n">record</span><span class="o">.</span><span class="n">levelno</span> <span class="o">&gt;=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_breadcrumb_handler</span><span class="o">.</span><span class="n">level</span>
-</span><span id="1-85">        <span class="p">):</span>
-</span><span id="1-86">            <span class="bp">self</span><span class="o">.</span><span class="n">_breadcrumb_handler</span><span class="o">.</span><span class="n">handle</span><span class="p">(</span><span class="n">record</span><span class="p">)</span>
-</span><span id="1-87">
-</span><span id="1-88">    <span class="nd">@staticmethod</span>
-</span><span id="1-89">    <span class="k">def</span> <span class="nf">setup_once</span><span class="p">():</span>
-</span><span id="1-90">        <span class="c1"># type: () -&gt; None</span>
-</span><span id="1-91">        <span class="n">old_callhandlers</span> <span class="o">=</span> <span class="n">logging</span><span class="o">.</span><span class="n">Logger</span><span class="o">.</span><span class="n">callHandlers</span>
-</span><span id="1-92">
-</span><span id="1-93">        <span class="k">def</span> <span class="nf">sentry_patched_callhandlers</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">record</span><span class="p">):</span>
-</span><span id="1-94">            <span class="c1"># type: (Any, LogRecord) -&gt; Any</span>
-</span><span id="1-95">            <span class="c1"># keeping a local reference because the</span>
-</span><span id="1-96">            <span class="c1"># global might be discarded on shutdown</span>
-</span><span id="1-97">            <span class="n">ignored_loggers</span> <span class="o">=</span> <span class="n">_IGNORED_LOGGERS</span>
-</span><span id="1-98">
-</span><span id="1-99">            <span class="k">try</span><span class="p">:</span>
-</span><span id="1-100">                <span class="k">return</span> <span class="n">old_callhandlers</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">record</span><span class="p">)</span>
-</span><span id="1-101">            <span class="k">finally</span><span class="p">:</span>
-</span><span id="1-102">                <span class="c1"># This check is done twice, once also here before we even get</span>
-</span><span id="1-103">                <span class="c1"># the integration.  Otherwise we have a high chance of getting</span>
-</span><span id="1-104">                <span class="c1"># into a recursion error when the integration is resolved</span>
-</span><span id="1-105">                <span class="c1"># (this also is slower).</span>
-</span><span id="1-106">                <span class="k">if</span> <span class="n">ignored_loggers</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">record</span><span class="o">.</span><span class="n">name</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">ignored_loggers</span><span class="p">:</span>
-</span><span id="1-107">                    <span class="n">integration</span> <span class="o">=</span> <span class="n">Hub</span><span class="o">.</span><span class="n">current</span><span class="o">.</span><span class="n">get_integration</span><span class="p">(</span><span class="n">LoggingIntegration</span><span class="p">)</span>
-</span><span id="1-108">                    <span class="k">if</span> <span class="n">integration</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-109">                        <span class="n">integration</span><span class="o">.</span><span class="n">_handle_record</span><span class="p">(</span><span class="n">record</span><span class="p">)</span>
-</span><span id="1-110">
-</span><span id="1-111">        <span class="n">logging</span><span class="o">.</span><span class="n">Logger</span><span class="o">.</span><span class="n">callHandlers</span> <span class="o">=</span> <span class="n">sentry_patched_callhandlers</span>  <span class="c1"># type: ignore</span>
+</span><span id="1-74">    <span class="k">def</span> <span class="nf">_handle_record</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">record</span><span class="p">):</span>
+</span><span id="1-75">        <span class="c1"># type: (LogRecord) -&gt; None</span>
+</span><span id="1-76">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_handler</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">record</span><span class="o">.</span><span class="n">levelno</span> <span class="o">&gt;=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_handler</span><span class="o">.</span><span class="n">level</span><span class="p">:</span>
+</span><span id="1-77">            <span class="bp">self</span><span class="o">.</span><span class="n">_handler</span><span class="o">.</span><span class="n">handle</span><span class="p">(</span><span class="n">record</span><span class="p">)</span>
+</span><span id="1-78">
+</span><span id="1-79">        <span class="k">if</span> <span class="p">(</span>
+</span><span id="1-80">            <span class="bp">self</span><span class="o">.</span><span class="n">_breadcrumb_handler</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span>
+</span><span id="1-81">            <span class="ow">and</span> <span class="n">record</span><span class="o">.</span><span class="n">levelno</span> <span class="o">&gt;=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_breadcrumb_handler</span><span class="o">.</span><span class="n">level</span>
+</span><span id="1-82">        <span class="p">):</span>
+</span><span id="1-83">            <span class="bp">self</span><span class="o">.</span><span class="n">_breadcrumb_handler</span><span class="o">.</span><span class="n">handle</span><span class="p">(</span><span class="n">record</span><span class="p">)</span>
+</span><span id="1-84">
+</span><span id="1-85">    <span class="nd">@staticmethod</span>
+</span><span id="1-86">    <span class="k">def</span> <span class="nf">setup_once</span><span class="p">():</span>
+</span><span id="1-87">        <span class="c1"># type: () -&gt; None</span>
+</span><span id="1-88">        <span class="n">old_callhandlers</span> <span class="o">=</span> <span class="n">logging</span><span class="o">.</span><span class="n">Logger</span><span class="o">.</span><span class="n">callHandlers</span>
+</span><span id="1-89">
+</span><span id="1-90">        <span class="k">def</span> <span class="nf">sentry_patched_callhandlers</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">record</span><span class="p">):</span>
+</span><span id="1-91">            <span class="c1"># type: (Any, LogRecord) -&gt; Any</span>
+</span><span id="1-92">            <span class="c1"># keeping a local reference because the</span>
+</span><span id="1-93">            <span class="c1"># global might be discarded on shutdown</span>
+</span><span id="1-94">            <span class="n">ignored_loggers</span> <span class="o">=</span> <span class="n">_IGNORED_LOGGERS</span>
+</span><span id="1-95">
+</span><span id="1-96">            <span class="k">try</span><span class="p">:</span>
+</span><span id="1-97">                <span class="k">return</span> <span class="n">old_callhandlers</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">record</span><span class="p">)</span>
+</span><span id="1-98">            <span class="k">finally</span><span class="p">:</span>
+</span><span id="1-99">                <span class="c1"># This check is done twice, once also here before we even get</span>
+</span><span id="1-100">                <span class="c1"># the integration.  Otherwise we have a high chance of getting</span>
+</span><span id="1-101">                <span class="c1"># into a recursion error when the integration is resolved</span>
+</span><span id="1-102">                <span class="c1"># (this also is slower).</span>
+</span><span id="1-103">                <span class="k">if</span> <span class="n">ignored_loggers</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">record</span><span class="o">.</span><span class="n">name</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">ignored_loggers</span><span class="p">:</span>
+</span><span id="1-104">                    <span class="n">integration</span> <span class="o">=</span> <span class="n">sentry_sdk</span><span class="o">.</span><span class="n">get_client</span><span class="p">()</span><span class="o">.</span><span class="n">get_integration</span><span class="p">(</span>
+</span><span id="1-105">                        <span class="n">LoggingIntegration</span>
+</span><span id="1-106">                    <span class="p">)</span>
+</span><span id="1-107">                    <span class="k">if</span> <span class="n">integration</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-108">                        <span class="n">integration</span><span class="o">.</span><span class="n">_handle_record</span><span class="p">(</span><span class="n">record</span><span class="p">)</span>
+</span><span id="1-109">
+</span><span id="1-110">        <span class="n">logging</span><span class="o">.</span><span class="n">Logger</span><span class="o">.</span><span class="n">callHandlers</span> <span class="o">=</span> <span class="n">sentry_patched_callhandlers</span>  <span class="c1"># type: ignore</span>
+</span><span id="1-111">
 </span><span id="1-112">
-</span><span id="1-113">
-</span><span id="1-114"><span class="k">class</span> <span class="nc">_BaseHandler</span><span class="p">(</span><span class="n">logging</span><span class="o">.</span><span class="n">Handler</span><span class="p">,</span> <span class="nb">object</span><span class="p">):</span>
-</span><span id="1-115">    <span class="n">COMMON_RECORD_ATTRS</span> <span class="o">=</span> <span class="nb">frozenset</span><span class="p">(</span>
-</span><span id="1-116">        <span class="p">(</span>
-</span><span id="1-117">            <span class="s2">&quot;args&quot;</span><span class="p">,</span>
-</span><span id="1-118">            <span class="s2">&quot;created&quot;</span><span class="p">,</span>
-</span><span id="1-119">            <span class="s2">&quot;exc_info&quot;</span><span class="p">,</span>
-</span><span id="1-120">            <span class="s2">&quot;exc_text&quot;</span><span class="p">,</span>
-</span><span id="1-121">            <span class="s2">&quot;filename&quot;</span><span class="p">,</span>
-</span><span id="1-122">            <span class="s2">&quot;funcName&quot;</span><span class="p">,</span>
-</span><span id="1-123">            <span class="s2">&quot;levelname&quot;</span><span class="p">,</span>
-</span><span id="1-124">            <span class="s2">&quot;levelno&quot;</span><span class="p">,</span>
-</span><span id="1-125">            <span class="s2">&quot;linenno&quot;</span><span class="p">,</span>
-</span><span id="1-126">            <span class="s2">&quot;lineno&quot;</span><span class="p">,</span>
-</span><span id="1-127">            <span class="s2">&quot;message&quot;</span><span class="p">,</span>
-</span><span id="1-128">            <span class="s2">&quot;module&quot;</span><span class="p">,</span>
-</span><span id="1-129">            <span class="s2">&quot;msecs&quot;</span><span class="p">,</span>
-</span><span id="1-130">            <span class="s2">&quot;msg&quot;</span><span class="p">,</span>
-</span><span id="1-131">            <span class="s2">&quot;name&quot;</span><span class="p">,</span>
-</span><span id="1-132">            <span class="s2">&quot;pathname&quot;</span><span class="p">,</span>
-</span><span id="1-133">            <span class="s2">&quot;process&quot;</span><span class="p">,</span>
-</span><span id="1-134">            <span class="s2">&quot;processName&quot;</span><span class="p">,</span>
-</span><span id="1-135">            <span class="s2">&quot;relativeCreated&quot;</span><span class="p">,</span>
-</span><span id="1-136">            <span class="s2">&quot;stack&quot;</span><span class="p">,</span>
-</span><span id="1-137">            <span class="s2">&quot;tags&quot;</span><span class="p">,</span>
-</span><span id="1-138">            <span class="s2">&quot;taskName&quot;</span><span class="p">,</span>
-</span><span id="1-139">            <span class="s2">&quot;thread&quot;</span><span class="p">,</span>
-</span><span id="1-140">            <span class="s2">&quot;threadName&quot;</span><span class="p">,</span>
-</span><span id="1-141">            <span class="s2">&quot;stack_info&quot;</span><span class="p">,</span>
-</span><span id="1-142">        <span class="p">)</span>
-</span><span id="1-143">    <span class="p">)</span>
-</span><span id="1-144">
-</span><span id="1-145">    <span class="k">def</span> <span class="nf">_can_record</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">record</span><span class="p">):</span>
-</span><span id="1-146">        <span class="c1"># type: (LogRecord) -&gt; bool</span>
-</span><span id="1-147"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Prevents ignored loggers from recording&quot;&quot;&quot;</span>
-</span><span id="1-148">        <span class="k">for</span> <span class="n">logger</span> <span class="ow">in</span> <span class="n">_IGNORED_LOGGERS</span><span class="p">:</span>
-</span><span id="1-149">            <span class="k">if</span> <span class="n">fnmatch</span><span class="p">(</span><span class="n">record</span><span class="o">.</span><span class="n">name</span><span class="p">,</span> <span class="n">logger</span><span class="p">):</span>
-</span><span id="1-150">                <span class="k">return</span> <span class="kc">False</span>
-</span><span id="1-151">        <span class="k">return</span> <span class="kc">True</span>
-</span><span id="1-152">
-</span><span id="1-153">    <span class="k">def</span> <span class="nf">_logging_to_event_level</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">record</span><span class="p">):</span>
-</span><span id="1-154">        <span class="c1"># type: (LogRecord) -&gt; str</span>
-</span><span id="1-155">        <span class="k">return</span> <span class="n">LOGGING_TO_EVENT_LEVEL</span><span class="o">.</span><span class="n">get</span><span class="p">(</span>
-</span><span id="1-156">            <span class="n">record</span><span class="o">.</span><span class="n">levelno</span><span class="p">,</span> <span class="n">record</span><span class="o">.</span><span class="n">levelname</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span> <span class="k">if</span> <span class="n">record</span><span class="o">.</span><span class="n">levelname</span> <span class="k">else</span> <span class="s2">&quot;&quot;</span>
-</span><span id="1-157">        <span class="p">)</span>
-</span><span id="1-158">
-</span><span id="1-159">    <span class="k">def</span> <span class="nf">_extra_from_record</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">record</span><span class="p">):</span>
-</span><span id="1-160">        <span class="c1"># type: (LogRecord) -&gt; MutableMapping[str, object]</span>
-</span><span id="1-161">        <span class="k">return</span> <span class="p">{</span>
-</span><span id="1-162">            <span class="n">k</span><span class="p">:</span> <span class="n">v</span>
-</span><span id="1-163">            <span class="k">for</span> <span class="n">k</span><span class="p">,</span> <span class="n">v</span> <span class="ow">in</span> <span class="n">iteritems</span><span class="p">(</span><span class="nb">vars</span><span class="p">(</span><span class="n">record</span><span class="p">))</span>
-</span><span id="1-164">            <span class="k">if</span> <span class="n">k</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">COMMON_RECORD_ATTRS</span>
-</span><span id="1-165">            <span class="ow">and</span> <span class="p">(</span><span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">k</span><span class="p">,</span> <span class="nb">str</span><span class="p">)</span> <span class="ow">or</span> <span class="ow">not</span> <span class="n">k</span><span class="o">.</span><span class="n">startswith</span><span class="p">(</span><span class="s2">&quot;_&quot;</span><span class="p">))</span>
-</span><span id="1-166">        <span class="p">}</span>
+</span><span id="1-113"><span class="k">class</span> <span class="nc">_BaseHandler</span><span class="p">(</span><span class="n">logging</span><span class="o">.</span><span class="n">Handler</span><span class="p">,</span> <span class="nb">object</span><span class="p">):</span>
+</span><span id="1-114">    <span class="n">COMMON_RECORD_ATTRS</span> <span class="o">=</span> <span class="nb">frozenset</span><span class="p">(</span>
+</span><span id="1-115">        <span class="p">(</span>
+</span><span id="1-116">            <span class="s2">&quot;args&quot;</span><span class="p">,</span>
+</span><span id="1-117">            <span class="s2">&quot;created&quot;</span><span class="p">,</span>
+</span><span id="1-118">            <span class="s2">&quot;exc_info&quot;</span><span class="p">,</span>
+</span><span id="1-119">            <span class="s2">&quot;exc_text&quot;</span><span class="p">,</span>
+</span><span id="1-120">            <span class="s2">&quot;filename&quot;</span><span class="p">,</span>
+</span><span id="1-121">            <span class="s2">&quot;funcName&quot;</span><span class="p">,</span>
+</span><span id="1-122">            <span class="s2">&quot;levelname&quot;</span><span class="p">,</span>
+</span><span id="1-123">            <span class="s2">&quot;levelno&quot;</span><span class="p">,</span>
+</span><span id="1-124">            <span class="s2">&quot;linenno&quot;</span><span class="p">,</span>
+</span><span id="1-125">            <span class="s2">&quot;lineno&quot;</span><span class="p">,</span>
+</span><span id="1-126">            <span class="s2">&quot;message&quot;</span><span class="p">,</span>
+</span><span id="1-127">            <span class="s2">&quot;module&quot;</span><span class="p">,</span>
+</span><span id="1-128">            <span class="s2">&quot;msecs&quot;</span><span class="p">,</span>
+</span><span id="1-129">            <span class="s2">&quot;msg&quot;</span><span class="p">,</span>
+</span><span id="1-130">            <span class="s2">&quot;name&quot;</span><span class="p">,</span>
+</span><span id="1-131">            <span class="s2">&quot;pathname&quot;</span><span class="p">,</span>
+</span><span id="1-132">            <span class="s2">&quot;process&quot;</span><span class="p">,</span>
+</span><span id="1-133">            <span class="s2">&quot;processName&quot;</span><span class="p">,</span>
+</span><span id="1-134">            <span class="s2">&quot;relativeCreated&quot;</span><span class="p">,</span>
+</span><span id="1-135">            <span class="s2">&quot;stack&quot;</span><span class="p">,</span>
+</span><span id="1-136">            <span class="s2">&quot;tags&quot;</span><span class="p">,</span>
+</span><span id="1-137">            <span class="s2">&quot;taskName&quot;</span><span class="p">,</span>
+</span><span id="1-138">            <span class="s2">&quot;thread&quot;</span><span class="p">,</span>
+</span><span id="1-139">            <span class="s2">&quot;threadName&quot;</span><span class="p">,</span>
+</span><span id="1-140">            <span class="s2">&quot;stack_info&quot;</span><span class="p">,</span>
+</span><span id="1-141">        <span class="p">)</span>
+</span><span id="1-142">    <span class="p">)</span>
+</span><span id="1-143">
+</span><span id="1-144">    <span class="k">def</span> <span class="nf">_can_record</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">record</span><span class="p">):</span>
+</span><span id="1-145">        <span class="c1"># type: (LogRecord) -&gt; bool</span>
+</span><span id="1-146"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Prevents ignored loggers from recording&quot;&quot;&quot;</span>
+</span><span id="1-147">        <span class="k">for</span> <span class="n">logger</span> <span class="ow">in</span> <span class="n">_IGNORED_LOGGERS</span><span class="p">:</span>
+</span><span id="1-148">            <span class="k">if</span> <span class="n">fnmatch</span><span class="p">(</span><span class="n">record</span><span class="o">.</span><span class="n">name</span><span class="p">,</span> <span class="n">logger</span><span class="p">):</span>
+</span><span id="1-149">                <span class="k">return</span> <span class="kc">False</span>
+</span><span id="1-150">        <span class="k">return</span> <span class="kc">True</span>
+</span><span id="1-151">
+</span><span id="1-152">    <span class="k">def</span> <span class="nf">_logging_to_event_level</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">record</span><span class="p">):</span>
+</span><span id="1-153">        <span class="c1"># type: (LogRecord) -&gt; str</span>
+</span><span id="1-154">        <span class="k">return</span> <span class="n">LOGGING_TO_EVENT_LEVEL</span><span class="o">.</span><span class="n">get</span><span class="p">(</span>
+</span><span id="1-155">            <span class="n">record</span><span class="o">.</span><span class="n">levelno</span><span class="p">,</span> <span class="n">record</span><span class="o">.</span><span class="n">levelname</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span> <span class="k">if</span> <span class="n">record</span><span class="o">.</span><span class="n">levelname</span> <span class="k">else</span> <span class="s2">&quot;&quot;</span>
+</span><span id="1-156">        <span class="p">)</span>
+</span><span id="1-157">
+</span><span id="1-158">    <span class="k">def</span> <span class="nf">_extra_from_record</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">record</span><span class="p">):</span>
+</span><span id="1-159">        <span class="c1"># type: (LogRecord) -&gt; MutableMapping[str, object]</span>
+</span><span id="1-160">        <span class="k">return</span> <span class="p">{</span>
+</span><span id="1-161">            <span class="n">k</span><span class="p">:</span> <span class="n">v</span>
+</span><span id="1-162">            <span class="k">for</span> <span class="n">k</span><span class="p">,</span> <span class="n">v</span> <span class="ow">in</span> <span class="nb">vars</span><span class="p">(</span><span class="n">record</span><span class="p">)</span><span class="o">.</span><span class="n">items</span><span class="p">()</span>
+</span><span id="1-163">            <span class="k">if</span> <span class="n">k</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">COMMON_RECORD_ATTRS</span>
+</span><span id="1-164">            <span class="ow">and</span> <span class="p">(</span><span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">k</span><span class="p">,</span> <span class="nb">str</span><span class="p">)</span> <span class="ow">or</span> <span class="ow">not</span> <span class="n">k</span><span class="o">.</span><span class="n">startswith</span><span class="p">(</span><span class="s2">&quot;_&quot;</span><span class="p">))</span>
+</span><span id="1-165">        <span class="p">}</span>
+</span><span id="1-166">
 </span><span id="1-167">
-</span><span id="1-168">
 <div class="viewcode-block" id="EventHandler">
 <a class="viewcode-back" href="../../../integrations.html#sentry_sdk.integrations.logging.EventHandler">[docs]</a>
-</span><span id="1-169"><span class="k">class</span> <span class="nc">EventHandler</span><span class="p">(</span><span class="n">_BaseHandler</span><span class="p">):</span>
-</span><span id="1-170"><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-171"><span class="sd">    A logging handler that emits Sentry events for each log record</span>
-</span><span id="1-172">
-</span><span id="1-173"><span class="sd">    Note that you do not have to use this class if the logging integration is enabled, which it is by default.</span>
-</span><span id="1-174"><span class="sd">    &quot;&quot;&quot;</span>
-</span><span id="1-175">
-</span><span id="1-176">    <span class="k">def</span> <span class="nf">emit</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">record</span><span class="p">):</span>
-</span><span id="1-177">        <span class="c1"># type: (LogRecord) -&gt; Any</span>
-</span><span id="1-178">        <span class="k">with</span> <span class="n">capture_internal_exceptions</span><span class="p">():</span>
-</span><span id="1-179">            <span class="bp">self</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">record</span><span class="p">)</span>
-</span><span id="1-180">            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_emit</span><span class="p">(</span><span class="n">record</span><span class="p">)</span>
-</span><span id="1-181">
-</span><span id="1-182">    <span class="k">def</span> <span class="nf">_emit</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">record</span><span class="p">):</span>
-</span><span id="1-183">        <span class="c1"># type: (LogRecord) -&gt; None</span>
-</span><span id="1-184">        <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_can_record</span><span class="p">(</span><span class="n">record</span><span class="p">):</span>
-</span><span id="1-185">            <span class="k">return</span>
-</span><span id="1-186">
-</span><span id="1-187">        <span class="n">hub</span> <span class="o">=</span> <span class="n">Hub</span><span class="o">.</span><span class="n">current</span>
-</span><span id="1-188">        <span class="k">if</span> <span class="n">hub</span><span class="o">.</span><span class="n">client</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-189">            <span class="k">return</span>
-</span><span id="1-190">
-</span><span id="1-191">        <span class="n">client_options</span> <span class="o">=</span> <span class="n">hub</span><span class="o">.</span><span class="n">client</span><span class="o">.</span><span class="n">options</span>
-</span><span id="1-192">
-</span><span id="1-193">        <span class="c1"># exc_info might be None or (None, None, None)</span>
-</span><span id="1-194">        <span class="c1">#</span>
-</span><span id="1-195">        <span class="c1"># exc_info may also be any falsy value due to Python stdlib being</span>
-</span><span id="1-196">        <span class="c1"># liberal with what it receives and Celery&#39;s billiard being &quot;liberal&quot;</span>
-</span><span id="1-197">        <span class="c1"># with what it sends. See</span>
-</span><span id="1-198">        <span class="c1"># https://github.com/getsentry/sentry-python/issues/904</span>
-</span><span id="1-199">        <span class="k">if</span> <span class="n">record</span><span class="o">.</span><span class="n">exc_info</span> <span class="ow">and</span> <span class="n">record</span><span class="o">.</span><span class="n">exc_info</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-200">            <span class="n">event</span><span class="p">,</span> <span class="n">hint</span> <span class="o">=</span> <span class="n">event_from_exception</span><span class="p">(</span>
-</span><span id="1-201">                <span class="n">record</span><span class="o">.</span><span class="n">exc_info</span><span class="p">,</span>
-</span><span id="1-202">                <span class="n">client_options</span><span class="o">=</span><span class="n">client_options</span><span class="p">,</span>
-</span><span id="1-203">                <span class="n">mechanism</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;type&quot;</span><span class="p">:</span> <span class="s2">&quot;logging&quot;</span><span class="p">,</span> <span class="s2">&quot;handled&quot;</span><span class="p">:</span> <span class="kc">True</span><span class="p">},</span>
-</span><span id="1-204">            <span class="p">)</span>
-</span><span id="1-205">        <span class="k">elif</span> <span class="n">record</span><span class="o">.</span><span class="n">exc_info</span> <span class="ow">and</span> <span class="n">record</span><span class="o">.</span><span class="n">exc_info</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-206">            <span class="n">event</span> <span class="o">=</span> <span class="p">{}</span>
-</span><span id="1-207">            <span class="n">hint</span> <span class="o">=</span> <span class="p">{}</span>
-</span><span id="1-208">            <span class="k">with</span> <span class="n">capture_internal_exceptions</span><span class="p">():</span>
-</span><span id="1-209">                <span class="n">event</span><span class="p">[</span><span class="s2">&quot;threads&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="p">{</span>
-</span><span id="1-210">                    <span class="s2">&quot;values&quot;</span><span class="p">:</span> <span class="p">[</span>
-</span><span id="1-211">                        <span class="p">{</span>
-</span><span id="1-212">                            <span class="s2">&quot;stacktrace&quot;</span><span class="p">:</span> <span class="n">current_stacktrace</span><span class="p">(</span>
-</span><span id="1-213">                                <span class="n">include_local_variables</span><span class="o">=</span><span class="n">client_options</span><span class="p">[</span>
-</span><span id="1-214">                                    <span class="s2">&quot;include_local_variables&quot;</span>
-</span><span id="1-215">                                <span class="p">],</span>
-</span><span id="1-216">                                <span class="n">max_value_length</span><span class="o">=</span><span class="n">client_options</span><span class="p">[</span><span class="s2">&quot;max_value_length&quot;</span><span class="p">],</span>
-</span><span id="1-217">                            <span class="p">),</span>
-</span><span id="1-218">                            <span class="s2">&quot;crashed&quot;</span><span class="p">:</span> <span class="kc">False</span><span class="p">,</span>
-</span><span id="1-219">                            <span class="s2">&quot;current&quot;</span><span class="p">:</span> <span class="kc">True</span><span class="p">,</span>
-</span><span id="1-220">                        <span class="p">}</span>
-</span><span id="1-221">                    <span class="p">]</span>
-</span><span id="1-222">                <span class="p">}</span>
-</span><span id="1-223">        <span class="k">else</span><span class="p">:</span>
-</span><span id="1-224">            <span class="n">event</span> <span class="o">=</span> <span class="p">{}</span>
-</span><span id="1-225">            <span class="n">hint</span> <span class="o">=</span> <span class="p">{}</span>
-</span><span id="1-226">
-</span><span id="1-227">        <span class="n">hint</span><span class="p">[</span><span class="s2">&quot;log_record&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">record</span>
-</span><span id="1-228">
-</span><span id="1-229">        <span class="n">level</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_logging_to_event_level</span><span class="p">(</span><span class="n">record</span><span class="p">)</span>
-</span><span id="1-230">        <span class="k">if</span> <span class="n">level</span> <span class="ow">in</span> <span class="p">{</span><span class="s2">&quot;debug&quot;</span><span class="p">,</span> <span class="s2">&quot;info&quot;</span><span class="p">,</span> <span class="s2">&quot;warning&quot;</span><span class="p">,</span> <span class="s2">&quot;error&quot;</span><span class="p">,</span> <span class="s2">&quot;critical&quot;</span><span class="p">,</span> <span class="s2">&quot;fatal&quot;</span><span class="p">}:</span>
-</span><span id="1-231">            <span class="n">event</span><span class="p">[</span><span class="s2">&quot;level&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">level</span>  <span class="c1"># type: ignore[typeddict-item]</span>
-</span><span id="1-232">        <span class="n">event</span><span class="p">[</span><span class="s2">&quot;logger&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">record</span><span class="o">.</span><span class="n">name</span>
-</span><span id="1-233">
-</span><span id="1-234">        <span class="c1"># Log records from `warnings` module as separate issues</span>
-</span><span id="1-235">        <span class="n">record_caputured_from_warnings_module</span> <span class="o">=</span> <span class="p">(</span>
-</span><span id="1-236">            <span class="n">record</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s2">&quot;py.warnings&quot;</span> <span class="ow">and</span> <span class="n">record</span><span class="o">.</span><span class="n">msg</span> <span class="o">==</span> <span class="s2">&quot;</span><span class="si">%s</span><span class="s2">&quot;</span>
-</span><span id="1-237">        <span class="p">)</span>
-</span><span id="1-238">        <span class="k">if</span> <span class="n">record_caputured_from_warnings_module</span><span class="p">:</span>
-</span><span id="1-239">            <span class="c1"># use the actual message and not &quot;%s&quot; as the message</span>
-</span><span id="1-240">            <span class="c1"># this prevents grouping all warnings under one &quot;%s&quot; issue</span>
-</span><span id="1-241">            <span class="n">msg</span> <span class="o">=</span> <span class="n">record</span><span class="o">.</span><span class="n">args</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span>  <span class="c1"># type: ignore</span>
-</span><span id="1-242">
-</span><span id="1-243">            <span class="n">event</span><span class="p">[</span><span class="s2">&quot;logentry&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="p">{</span>
-</span><span id="1-244">                <span class="s2">&quot;message&quot;</span><span class="p">:</span> <span class="n">msg</span><span class="p">,</span>
-</span><span id="1-245">                <span class="s2">&quot;params&quot;</span><span class="p">:</span> <span class="p">(),</span>
-</span><span id="1-246">            <span class="p">}</span>
-</span><span id="1-247">
-</span><span id="1-248">        <span class="k">else</span><span class="p">:</span>
-</span><span id="1-249">            <span class="n">event</span><span class="p">[</span><span class="s2">&quot;logentry&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="p">{</span>
-</span><span id="1-250">                <span class="s2">&quot;message&quot;</span><span class="p">:</span> <span class="n">to_string</span><span class="p">(</span><span class="n">record</span><span class="o">.</span><span class="n">msg</span><span class="p">),</span>
-</span><span id="1-251">                <span class="s2">&quot;params&quot;</span><span class="p">:</span> <span class="n">record</span><span class="o">.</span><span class="n">args</span><span class="p">,</span>
-</span><span id="1-252">            <span class="p">}</span>
-</span><span id="1-253">
-</span><span id="1-254">        <span class="n">event</span><span class="p">[</span><span class="s2">&quot;extra&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_extra_from_record</span><span class="p">(</span><span class="n">record</span><span class="p">)</span>
-</span><span id="1-255">
-</span><span id="1-256">        <span class="n">hub</span><span class="o">.</span><span class="n">capture_event</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="o">=</span><span class="n">hint</span><span class="p">)</span></div>
+</span><span id="1-168"><span class="k">class</span> <span class="nc">EventHandler</span><span class="p">(</span><span class="n">_BaseHandler</span><span class="p">):</span>
+</span><span id="1-169"><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-170"><span class="sd">    A logging handler that emits Sentry events for each log record</span>
+</span><span id="1-171">
+</span><span id="1-172"><span class="sd">    Note that you do not have to use this class if the logging integration is enabled, which it is by default.</span>
+</span><span id="1-173"><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="1-174">
+</span><span id="1-175">    <span class="k">def</span> <span class="nf">emit</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">record</span><span class="p">):</span>
+</span><span id="1-176">        <span class="c1"># type: (LogRecord) -&gt; Any</span>
+</span><span id="1-177">        <span class="k">with</span> <span class="n">capture_internal_exceptions</span><span class="p">():</span>
+</span><span id="1-178">            <span class="bp">self</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">record</span><span class="p">)</span>
+</span><span id="1-179">            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_emit</span><span class="p">(</span><span class="n">record</span><span class="p">)</span>
+</span><span id="1-180">
+</span><span id="1-181">    <span class="k">def</span> <span class="nf">_emit</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">record</span><span class="p">):</span>
+</span><span id="1-182">        <span class="c1"># type: (LogRecord) -&gt; None</span>
+</span><span id="1-183">        <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_can_record</span><span class="p">(</span><span class="n">record</span><span class="p">):</span>
+</span><span id="1-184">            <span class="k">return</span>
+</span><span id="1-185">
+</span><span id="1-186">        <span class="n">client</span> <span class="o">=</span> <span class="n">sentry_sdk</span><span class="o">.</span><span class="n">get_client</span><span class="p">()</span>
+</span><span id="1-187">        <span class="k">if</span> <span class="ow">not</span> <span class="n">client</span><span class="o">.</span><span class="n">is_active</span><span class="p">():</span>
+</span><span id="1-188">            <span class="k">return</span>
+</span><span id="1-189">
+</span><span id="1-190">        <span class="n">client_options</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="n">options</span>
+</span><span id="1-191">
+</span><span id="1-192">        <span class="c1"># exc_info might be None or (None, None, None)</span>
+</span><span id="1-193">        <span class="c1">#</span>
+</span><span id="1-194">        <span class="c1"># exc_info may also be any falsy value due to Python stdlib being</span>
+</span><span id="1-195">        <span class="c1"># liberal with what it receives and Celery&#39;s billiard being &quot;liberal&quot;</span>
+</span><span id="1-196">        <span class="c1"># with what it sends. See</span>
+</span><span id="1-197">        <span class="c1"># https://github.com/getsentry/sentry-python/issues/904</span>
+</span><span id="1-198">        <span class="k">if</span> <span class="n">record</span><span class="o">.</span><span class="n">exc_info</span> <span class="ow">and</span> <span class="n">record</span><span class="o">.</span><span class="n">exc_info</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-199">            <span class="n">event</span><span class="p">,</span> <span class="n">hint</span> <span class="o">=</span> <span class="n">event_from_exception</span><span class="p">(</span>
+</span><span id="1-200">                <span class="n">record</span><span class="o">.</span><span class="n">exc_info</span><span class="p">,</span>
+</span><span id="1-201">                <span class="n">client_options</span><span class="o">=</span><span class="n">client_options</span><span class="p">,</span>
+</span><span id="1-202">                <span class="n">mechanism</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;type&quot;</span><span class="p">:</span> <span class="s2">&quot;logging&quot;</span><span class="p">,</span> <span class="s2">&quot;handled&quot;</span><span class="p">:</span> <span class="kc">True</span><span class="p">},</span>
+</span><span id="1-203">            <span class="p">)</span>
+</span><span id="1-204">        <span class="k">elif</span> <span class="n">record</span><span class="o">.</span><span class="n">exc_info</span> <span class="ow">and</span> <span class="n">record</span><span class="o">.</span><span class="n">exc_info</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-205">            <span class="n">event</span> <span class="o">=</span> <span class="p">{}</span>
+</span><span id="1-206">            <span class="n">hint</span> <span class="o">=</span> <span class="p">{}</span>
+</span><span id="1-207">            <span class="k">with</span> <span class="n">capture_internal_exceptions</span><span class="p">():</span>
+</span><span id="1-208">                <span class="n">event</span><span class="p">[</span><span class="s2">&quot;threads&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="p">{</span>
+</span><span id="1-209">                    <span class="s2">&quot;values&quot;</span><span class="p">:</span> <span class="p">[</span>
+</span><span id="1-210">                        <span class="p">{</span>
+</span><span id="1-211">                            <span class="s2">&quot;stacktrace&quot;</span><span class="p">:</span> <span class="n">current_stacktrace</span><span class="p">(</span>
+</span><span id="1-212">                                <span class="n">include_local_variables</span><span class="o">=</span><span class="n">client_options</span><span class="p">[</span>
+</span><span id="1-213">                                    <span class="s2">&quot;include_local_variables&quot;</span>
+</span><span id="1-214">                                <span class="p">],</span>
+</span><span id="1-215">                                <span class="n">max_value_length</span><span class="o">=</span><span class="n">client_options</span><span class="p">[</span><span class="s2">&quot;max_value_length&quot;</span><span class="p">],</span>
+</span><span id="1-216">                            <span class="p">),</span>
+</span><span id="1-217">                            <span class="s2">&quot;crashed&quot;</span><span class="p">:</span> <span class="kc">False</span><span class="p">,</span>
+</span><span id="1-218">                            <span class="s2">&quot;current&quot;</span><span class="p">:</span> <span class="kc">True</span><span class="p">,</span>
+</span><span id="1-219">                        <span class="p">}</span>
+</span><span id="1-220">                    <span class="p">]</span>
+</span><span id="1-221">                <span class="p">}</span>
+</span><span id="1-222">        <span class="k">else</span><span class="p">:</span>
+</span><span id="1-223">            <span class="n">event</span> <span class="o">=</span> <span class="p">{}</span>
+</span><span id="1-224">            <span class="n">hint</span> <span class="o">=</span> <span class="p">{}</span>
+</span><span id="1-225">
+</span><span id="1-226">        <span class="n">hint</span><span class="p">[</span><span class="s2">&quot;log_record&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">record</span>
+</span><span id="1-227">
+</span><span id="1-228">        <span class="n">level</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_logging_to_event_level</span><span class="p">(</span><span class="n">record</span><span class="p">)</span>
+</span><span id="1-229">        <span class="k">if</span> <span class="n">level</span> <span class="ow">in</span> <span class="p">{</span><span class="s2">&quot;debug&quot;</span><span class="p">,</span> <span class="s2">&quot;info&quot;</span><span class="p">,</span> <span class="s2">&quot;warning&quot;</span><span class="p">,</span> <span class="s2">&quot;error&quot;</span><span class="p">,</span> <span class="s2">&quot;critical&quot;</span><span class="p">,</span> <span class="s2">&quot;fatal&quot;</span><span class="p">}:</span>
+</span><span id="1-230">            <span class="n">event</span><span class="p">[</span><span class="s2">&quot;level&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">level</span>  <span class="c1"># type: ignore[typeddict-item]</span>
+</span><span id="1-231">        <span class="n">event</span><span class="p">[</span><span class="s2">&quot;logger&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">record</span><span class="o">.</span><span class="n">name</span>
+</span><span id="1-232">
+</span><span id="1-233">        <span class="c1"># Log records from `warnings` module as separate issues</span>
+</span><span id="1-234">        <span class="n">record_caputured_from_warnings_module</span> <span class="o">=</span> <span class="p">(</span>
+</span><span id="1-235">            <span class="n">record</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s2">&quot;py.warnings&quot;</span> <span class="ow">and</span> <span class="n">record</span><span class="o">.</span><span class="n">msg</span> <span class="o">==</span> <span class="s2">&quot;</span><span class="si">%s</span><span class="s2">&quot;</span>
+</span><span id="1-236">        <span class="p">)</span>
+</span><span id="1-237">        <span class="k">if</span> <span class="n">record_caputured_from_warnings_module</span><span class="p">:</span>
+</span><span id="1-238">            <span class="c1"># use the actual message and not &quot;%s&quot; as the message</span>
+</span><span id="1-239">            <span class="c1"># this prevents grouping all warnings under one &quot;%s&quot; issue</span>
+</span><span id="1-240">            <span class="n">msg</span> <span class="o">=</span> <span class="n">record</span><span class="o">.</span><span class="n">args</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span>  <span class="c1"># type: ignore</span>
+</span><span id="1-241">
+</span><span id="1-242">            <span class="n">event</span><span class="p">[</span><span class="s2">&quot;logentry&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="p">{</span>
+</span><span id="1-243">                <span class="s2">&quot;message&quot;</span><span class="p">:</span> <span class="n">msg</span><span class="p">,</span>
+</span><span id="1-244">                <span class="s2">&quot;params&quot;</span><span class="p">:</span> <span class="p">(),</span>
+</span><span id="1-245">            <span class="p">}</span>
+</span><span id="1-246">
+</span><span id="1-247">        <span class="k">else</span><span class="p">:</span>
+</span><span id="1-248">            <span class="n">event</span><span class="p">[</span><span class="s2">&quot;logentry&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="p">{</span>
+</span><span id="1-249">                <span class="s2">&quot;message&quot;</span><span class="p">:</span> <span class="n">to_string</span><span class="p">(</span><span class="n">record</span><span class="o">.</span><span class="n">msg</span><span class="p">),</span>
+</span><span id="1-250">                <span class="s2">&quot;params&quot;</span><span class="p">:</span> <span class="n">record</span><span class="o">.</span><span class="n">args</span><span class="p">,</span>
+</span><span id="1-251">            <span class="p">}</span>
+</span><span id="1-252">
+</span><span id="1-253">        <span class="n">event</span><span class="p">[</span><span class="s2">&quot;extra&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_extra_from_record</span><span class="p">(</span><span class="n">record</span><span class="p">)</span>
+</span><span id="1-254">
+</span><span id="1-255">        <span class="n">sentry_sdk</span><span class="o">.</span><span class="n">capture_event</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="o">=</span><span class="n">hint</span><span class="p">)</span></div>
 
+</span><span id="1-256">
 </span><span id="1-257">
-</span><span id="1-258">
-</span><span id="1-259"><span class="c1"># Legacy name</span>
-</span><span id="1-260"><span class="n">SentryHandler</span> <span class="o">=</span> <span class="n">EventHandler</span>
+</span><span id="1-258"><span class="c1"># Legacy name</span>
+</span><span id="1-259"><span class="n">SentryHandler</span> <span class="o">=</span> <span class="n">EventHandler</span>
+</span><span id="1-260">
 </span><span id="1-261">
-</span><span id="1-262">
 <div class="viewcode-block" id="BreadcrumbHandler">
 <a class="viewcode-back" href="../../../integrations.html#sentry_sdk.integrations.logging.BreadcrumbHandler">[docs]</a>
-</span><span id="1-263"><span class="k">class</span> <span class="nc">BreadcrumbHandler</span><span class="p">(</span><span class="n">_BaseHandler</span><span class="p">):</span>
-</span><span id="1-264"><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-265"><span class="sd">    A logging handler that records breadcrumbs for each log record.</span>
-</span><span id="1-266">
-</span><span id="1-267"><span class="sd">    Note that you do not have to use this class if the logging integration is enabled, which it is by default.</span>
-</span><span id="1-268"><span class="sd">    &quot;&quot;&quot;</span>
-</span><span id="1-269">
-</span><span id="1-270">    <span class="k">def</span> <span class="nf">emit</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">record</span><span class="p">):</span>
-</span><span id="1-271">        <span class="c1"># type: (LogRecord) -&gt; Any</span>
-</span><span id="1-272">        <span class="k">with</span> <span class="n">capture_internal_exceptions</span><span class="p">():</span>
-</span><span id="1-273">            <span class="bp">self</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">record</span><span class="p">)</span>
-</span><span id="1-274">            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_emit</span><span class="p">(</span><span class="n">record</span><span class="p">)</span>
-</span><span id="1-275">
-</span><span id="1-276">    <span class="k">def</span> <span class="nf">_emit</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">record</span><span class="p">):</span>
-</span><span id="1-277">        <span class="c1"># type: (LogRecord) -&gt; None</span>
-</span><span id="1-278">        <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_can_record</span><span class="p">(</span><span class="n">record</span><span class="p">):</span>
-</span><span id="1-279">            <span class="k">return</span>
-</span><span id="1-280">
-</span><span id="1-281">        <span class="n">Hub</span><span class="o">.</span><span class="n">current</span><span class="o">.</span><span class="n">add_breadcrumb</span><span class="p">(</span>
-</span><span id="1-282">            <span class="bp">self</span><span class="o">.</span><span class="n">_breadcrumb_from_record</span><span class="p">(</span><span class="n">record</span><span class="p">),</span> <span class="n">hint</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;log_record&quot;</span><span class="p">:</span> <span class="n">record</span><span class="p">}</span>
-</span><span id="1-283">        <span class="p">)</span>
-</span><span id="1-284">
-</span><span id="1-285">    <span class="k">def</span> <span class="nf">_breadcrumb_from_record</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">record</span><span class="p">):</span>
-</span><span id="1-286">        <span class="c1"># type: (LogRecord) -&gt; Dict[str, Any]</span>
-</span><span id="1-287">        <span class="k">return</span> <span class="p">{</span>
-</span><span id="1-288">            <span class="s2">&quot;type&quot;</span><span class="p">:</span> <span class="s2">&quot;log&quot;</span><span class="p">,</span>
-</span><span id="1-289">            <span class="s2">&quot;level&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">_logging_to_event_level</span><span class="p">(</span><span class="n">record</span><span class="p">),</span>
-</span><span id="1-290">            <span class="s2">&quot;category&quot;</span><span class="p">:</span> <span class="n">record</span><span class="o">.</span><span class="n">name</span><span class="p">,</span>
-</span><span id="1-291">            <span class="s2">&quot;message&quot;</span><span class="p">:</span> <span class="n">record</span><span class="o">.</span><span class="n">message</span><span class="p">,</span>
-</span><span id="1-292">            <span class="s2">&quot;timestamp&quot;</span><span class="p">:</span> <span class="n">utc_from_timestamp</span><span class="p">(</span><span class="n">record</span><span class="o">.</span><span class="n">created</span><span class="p">),</span>
-</span><span id="1-293">            <span class="s2">&quot;data&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">_extra_from_record</span><span class="p">(</span><span class="n">record</span><span class="p">),</span>
-</span><span id="1-294">        <span class="p">}</span></div>
+</span><span id="1-262"><span class="k">class</span> <span class="nc">BreadcrumbHandler</span><span class="p">(</span><span class="n">_BaseHandler</span><span class="p">):</span>
+</span><span id="1-263"><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-264"><span class="sd">    A logging handler that records breadcrumbs for each log record.</span>
+</span><span id="1-265">
+</span><span id="1-266"><span class="sd">    Note that you do not have to use this class if the logging integration is enabled, which it is by default.</span>
+</span><span id="1-267"><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="1-268">
+</span><span id="1-269">    <span class="k">def</span> <span class="nf">emit</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">record</span><span class="p">):</span>
+</span><span id="1-270">        <span class="c1"># type: (LogRecord) -&gt; Any</span>
+</span><span id="1-271">        <span class="k">with</span> <span class="n">capture_internal_exceptions</span><span class="p">():</span>
+</span><span id="1-272">            <span class="bp">self</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">record</span><span class="p">)</span>
+</span><span id="1-273">            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_emit</span><span class="p">(</span><span class="n">record</span><span class="p">)</span>
+</span><span id="1-274">
+</span><span id="1-275">    <span class="k">def</span> <span class="nf">_emit</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">record</span><span class="p">):</span>
+</span><span id="1-276">        <span class="c1"># type: (LogRecord) -&gt; None</span>
+</span><span id="1-277">        <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_can_record</span><span class="p">(</span><span class="n">record</span><span class="p">):</span>
+</span><span id="1-278">            <span class="k">return</span>
+</span><span id="1-279">
+</span><span id="1-280">        <span class="n">sentry_sdk</span><span class="o">.</span><span class="n">add_breadcrumb</span><span class="p">(</span>
+</span><span id="1-281">            <span class="bp">self</span><span class="o">.</span><span class="n">_breadcrumb_from_record</span><span class="p">(</span><span class="n">record</span><span class="p">),</span> <span class="n">hint</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;log_record&quot;</span><span class="p">:</span> <span class="n">record</span><span class="p">}</span>
+</span><span id="1-282">        <span class="p">)</span>
+</span><span id="1-283">
+</span><span id="1-284">    <span class="k">def</span> <span class="nf">_breadcrumb_from_record</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">record</span><span class="p">):</span>
+</span><span id="1-285">        <span class="c1"># type: (LogRecord) -&gt; Dict[str, Any]</span>
+</span><span id="1-286">        <span class="k">return</span> <span class="p">{</span>
+</span><span id="1-287">            <span class="s2">&quot;type&quot;</span><span class="p">:</span> <span class="s2">&quot;log&quot;</span><span class="p">,</span>
+</span><span id="1-288">            <span class="s2">&quot;level&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">_logging_to_event_level</span><span class="p">(</span><span class="n">record</span><span class="p">),</span>
+</span><span id="1-289">            <span class="s2">&quot;category&quot;</span><span class="p">:</span> <span class="n">record</span><span class="o">.</span><span class="n">name</span><span class="p">,</span>
+</span><span id="1-290">            <span class="s2">&quot;message&quot;</span><span class="p">:</span> <span class="n">record</span><span class="o">.</span><span class="n">message</span><span class="p">,</span>
+</span><span id="1-291">            <span class="s2">&quot;timestamp&quot;</span><span class="p">:</span> <span class="n">datetime</span><span class="o">.</span><span class="n">fromtimestamp</span><span class="p">(</span><span class="n">record</span><span class="o">.</span><span class="n">created</span><span class="p">,</span> <span class="n">timezone</span><span class="o">.</span><span class="n">utc</span><span class="p">),</span>
+</span><span id="1-292">            <span class="s2">&quot;data&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">_extra_from_record</span><span class="p">(</span><span class="n">record</span><span class="p">),</span>
+</span><span id="1-293">        <span class="p">}</span></div>
 
 </span></pre></div>
         </article>
@@ -467,7 +466,7 @@ <h1>Source code for sentry_sdk.integrations.logging</h1><div class="highlight"><
     </div>
   </div>
 </footer></div>
-      <script src="../../../_static/documentation_options.js?v=fca6d697"></script>
+      <script src="../../../_static/documentation_options.js?v=aa9da443"></script>
       <script src="../../../_static/doctools.js?v=888ff710"></script>
       <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
       <script src="../../../_static/shibuya.js?v=999236dc"></script>
diff --git a/_modules/sentry_sdk/monitor.html b/_modules/sentry_sdk/monitor.html
index ade8616d3d..07b97dc890 100644
--- a/_modules/sentry_sdk/monitor.html
+++ b/_modules/sentry_sdk/monitor.html
@@ -4,7 +4,7 @@
 <head>
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-      <title>sentry_sdk.monitor - sentry-python 1.44.1 documentation</title>
+      <title>sentry_sdk.monitor - sentry-python 2.0.0rc4 documentation</title>
     <link rel="index" title="Index" href="../../genindex.html" /><link rel="search" title="Search" href="../../search.html" />
 
   <script>
@@ -149,7 +149,7 @@ <h1>Source code for sentry_sdk.monitor</h1><div class="highlight"><pre>
 </span><span id="1-15">
 <div class="viewcode-block" id="Monitor">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.monitor.Monitor">[docs]</a>
-</span><span id="1-16"><span class="k">class</span> <span class="nc">Monitor</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
+</span><span id="1-16"><span class="k">class</span> <span class="nc">Monitor</span><span class="p">:</span>
 </span><span id="1-17"><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 </span><span id="1-18"><span class="sd">    Performs health checks in a separate thread once every interval seconds</span>
 </span><span id="1-19"><span class="sd">    and updates the internal state. Other parts of the SDK only read this state</span>
@@ -293,7 +293,7 @@ <h1>Source code for sentry_sdk.monitor</h1><div class="highlight"><pre>
     </div>
   </div>
 </footer></div>
-      <script src="../../_static/documentation_options.js?v=fca6d697"></script>
+      <script src="../../_static/documentation_options.js?v=aa9da443"></script>
       <script src="../../_static/doctools.js?v=888ff710"></script>
       <script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
       <script src="../../_static/shibuya.js?v=999236dc"></script>
diff --git a/_modules/sentry_sdk/profiler.html b/_modules/sentry_sdk/profiler.html
index 2e38f492a9..c4376a6565 100644
--- a/_modules/sentry_sdk/profiler.html
+++ b/_modules/sentry_sdk/profiler.html
@@ -4,7 +4,7 @@
 <head>
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-      <title>sentry_sdk.profiler - sentry-python 1.44.1 documentation</title>
+      <title>sentry_sdk.profiler - sentry-python 2.0.0rc4 documentation</title>
     <link rel="index" title="Index" href="../../genindex.html" /><link rel="search" title="Search" href="../../search.html" />
 
   <script>
@@ -167,509 +167,509 @@ <h1>Source code for sentry_sdk.profiler</h1><div class="highlight"><pre>
 </span><span id="1-33"><span class="kn">import</span> <span class="nn">threading</span>
 </span><span id="1-34"><span class="kn">import</span> <span class="nn">time</span>
 </span><span id="1-35"><span class="kn">import</span> <span class="nn">uuid</span>
-</span><span id="1-36"><span class="kn">from</span> <span class="nn">collections</span> <span class="kn">import</span> <span class="n">deque</span>
-</span><span id="1-37">
-</span><span id="1-38"><span class="kn">import</span> <span class="nn">sentry_sdk</span>
-</span><span id="1-39"><span class="kn">from</span> <span class="nn">sentry_sdk._compat</span> <span class="kn">import</span> <span class="n">PY33</span><span class="p">,</span> <span class="n">PY311</span>
-</span><span id="1-40"><span class="kn">from</span> <span class="nn">sentry_sdk._lru_cache</span> <span class="kn">import</span> <span class="n">LRUCache</span>
-</span><span id="1-41"><span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="n">TYPE_CHECKING</span>
-</span><span id="1-42"><span class="kn">from</span> <span class="nn">sentry_sdk.utils</span> <span class="kn">import</span> <span class="p">(</span>
-</span><span id="1-43">    <span class="n">capture_internal_exception</span><span class="p">,</span>
-</span><span id="1-44">    <span class="n">filename_for_module</span><span class="p">,</span>
-</span><span id="1-45">    <span class="n">get_current_thread_meta</span><span class="p">,</span>
-</span><span id="1-46">    <span class="n">is_gevent</span><span class="p">,</span>
-</span><span id="1-47">    <span class="n">is_valid_sample_rate</span><span class="p">,</span>
-</span><span id="1-48">    <span class="n">logger</span><span class="p">,</span>
-</span><span id="1-49">    <span class="n">nanosecond_time</span><span class="p">,</span>
-</span><span id="1-50">    <span class="n">set_in_app_in_frames</span><span class="p">,</span>
-</span><span id="1-51"><span class="p">)</span>
-</span><span id="1-52">
-</span><span id="1-53"><span class="k">if</span> <span class="n">TYPE_CHECKING</span><span class="p">:</span>
-</span><span id="1-54">    <span class="kn">from</span> <span class="nn">types</span> <span class="kn">import</span> <span class="n">FrameType</span>
-</span><span id="1-55">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Any</span>
-</span><span id="1-56">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Callable</span>
-</span><span id="1-57">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Deque</span>
-</span><span id="1-58">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Dict</span>
-</span><span id="1-59">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">List</span>
-</span><span id="1-60">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Optional</span>
-</span><span id="1-61">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Set</span>
-</span><span id="1-62">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Sequence</span>
-</span><span id="1-63">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Tuple</span>
-</span><span id="1-64">    <span class="kn">from</span> <span class="nn">typing_extensions</span> <span class="kn">import</span> <span class="n">TypedDict</span>
-</span><span id="1-65">
-</span><span id="1-66">    <span class="kn">import</span> <span class="nn">sentry_sdk.tracing</span>
-</span><span id="1-67">    <span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="n">Event</span><span class="p">,</span> <span class="n">SamplingContext</span><span class="p">,</span> <span class="n">ProfilerMode</span>
-</span><span id="1-68">
-</span><span id="1-69">    <span class="n">ThreadId</span> <span class="o">=</span> <span class="nb">str</span>
-</span><span id="1-70">
-</span><span id="1-71">    <span class="n">ProcessedSample</span> <span class="o">=</span> <span class="n">TypedDict</span><span class="p">(</span>
-</span><span id="1-72">        <span class="s2">&quot;ProcessedSample&quot;</span><span class="p">,</span>
-</span><span id="1-73">        <span class="p">{</span>
-</span><span id="1-74">            <span class="s2">&quot;elapsed_since_start_ns&quot;</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>
-</span><span id="1-75">            <span class="s2">&quot;thread_id&quot;</span><span class="p">:</span> <span class="n">ThreadId</span><span class="p">,</span>
-</span><span id="1-76">            <span class="s2">&quot;stack_id&quot;</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
-</span><span id="1-77">        <span class="p">},</span>
-</span><span id="1-78">    <span class="p">)</span>
-</span><span id="1-79">
-</span><span id="1-80">    <span class="n">ProcessedStack</span> <span class="o">=</span> <span class="n">List</span><span class="p">[</span><span class="nb">int</span><span class="p">]</span>
-</span><span id="1-81">
-</span><span id="1-82">    <span class="n">ProcessedFrame</span> <span class="o">=</span> <span class="n">TypedDict</span><span class="p">(</span>
-</span><span id="1-83">        <span class="s2">&quot;ProcessedFrame&quot;</span><span class="p">,</span>
-</span><span id="1-84">        <span class="p">{</span>
-</span><span id="1-85">            <span class="s2">&quot;abs_path&quot;</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>
-</span><span id="1-86">            <span class="s2">&quot;filename&quot;</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span>
-</span><span id="1-87">            <span class="s2">&quot;function&quot;</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>
-</span><span id="1-88">            <span class="s2">&quot;lineno&quot;</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
-</span><span id="1-89">            <span class="s2">&quot;module&quot;</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span>
-</span><span id="1-90">        <span class="p">},</span>
-</span><span id="1-91">    <span class="p">)</span>
-</span><span id="1-92">
-</span><span id="1-93">    <span class="n">ProcessedThreadMetadata</span> <span class="o">=</span> <span class="n">TypedDict</span><span class="p">(</span>
-</span><span id="1-94">        <span class="s2">&quot;ProcessedThreadMetadata&quot;</span><span class="p">,</span>
-</span><span id="1-95">        <span class="p">{</span><span class="s2">&quot;name&quot;</span><span class="p">:</span> <span class="nb">str</span><span class="p">},</span>
-</span><span id="1-96">    <span class="p">)</span>
-</span><span id="1-97">
-</span><span id="1-98">    <span class="n">ProcessedProfile</span> <span class="o">=</span> <span class="n">TypedDict</span><span class="p">(</span>
-</span><span id="1-99">        <span class="s2">&quot;ProcessedProfile&quot;</span><span class="p">,</span>
-</span><span id="1-100">        <span class="p">{</span>
-</span><span id="1-101">            <span class="s2">&quot;frames&quot;</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="n">ProcessedFrame</span><span class="p">],</span>
-</span><span id="1-102">            <span class="s2">&quot;stacks&quot;</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="n">ProcessedStack</span><span class="p">],</span>
-</span><span id="1-103">            <span class="s2">&quot;samples&quot;</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="n">ProcessedSample</span><span class="p">],</span>
-</span><span id="1-104">            <span class="s2">&quot;thread_metadata&quot;</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="n">ThreadId</span><span class="p">,</span> <span class="n">ProcessedThreadMetadata</span><span class="p">],</span>
-</span><span id="1-105">        <span class="p">},</span>
-</span><span id="1-106">    <span class="p">)</span>
-</span><span id="1-107">
-</span><span id="1-108">    <span class="n">ProfileContext</span> <span class="o">=</span> <span class="n">TypedDict</span><span class="p">(</span>
-</span><span id="1-109">        <span class="s2">&quot;ProfileContext&quot;</span><span class="p">,</span>
-</span><span id="1-110">        <span class="p">{</span><span class="s2">&quot;profile_id&quot;</span><span class="p">:</span> <span class="nb">str</span><span class="p">},</span>
-</span><span id="1-111">    <span class="p">)</span>
-</span><span id="1-112">
-</span><span id="1-113">    <span class="n">FrameId</span> <span class="o">=</span> <span class="n">Tuple</span><span class="p">[</span>
-</span><span id="1-114">        <span class="nb">str</span><span class="p">,</span>  <span class="c1"># abs_path</span>
-</span><span id="1-115">        <span class="nb">int</span><span class="p">,</span>  <span class="c1"># lineno</span>
-</span><span id="1-116">        <span class="nb">str</span><span class="p">,</span>  <span class="c1"># function</span>
-</span><span id="1-117">    <span class="p">]</span>
-</span><span id="1-118">    <span class="n">FrameIds</span> <span class="o">=</span> <span class="n">Tuple</span><span class="p">[</span><span class="n">FrameId</span><span class="p">,</span> <span class="o">...</span><span class="p">]</span>
-</span><span id="1-119">
-</span><span id="1-120">    <span class="c1"># The exact value of this id is not very meaningful. The purpose</span>
-</span><span id="1-121">    <span class="c1"># of this id is to give us a compact and unique identifier for a</span>
-</span><span id="1-122">    <span class="c1"># raw stack that can be used as a key to a dictionary so that it</span>
-</span><span id="1-123">    <span class="c1"># can be used during the sampled format generation.</span>
-</span><span id="1-124">    <span class="n">StackId</span> <span class="o">=</span> <span class="n">Tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">]</span>
-</span><span id="1-125">
-</span><span id="1-126">    <span class="n">ExtractedStack</span> <span class="o">=</span> <span class="n">Tuple</span><span class="p">[</span><span class="n">StackId</span><span class="p">,</span> <span class="n">FrameIds</span><span class="p">,</span> <span class="n">List</span><span class="p">[</span><span class="n">ProcessedFrame</span><span class="p">]]</span>
-</span><span id="1-127">    <span class="n">ExtractedSample</span> <span class="o">=</span> <span class="n">Sequence</span><span class="p">[</span><span class="n">Tuple</span><span class="p">[</span><span class="n">ThreadId</span><span class="p">,</span> <span class="n">ExtractedStack</span><span class="p">]]</span>
-</span><span id="1-128">
+</span><span id="1-36"><span class="kn">from</span> <span class="nn">abc</span> <span class="kn">import</span> <span class="n">ABC</span><span class="p">,</span> <span class="n">abstractmethod</span>
+</span><span id="1-37"><span class="kn">from</span> <span class="nn">collections</span> <span class="kn">import</span> <span class="n">deque</span>
+</span><span id="1-38">
+</span><span id="1-39"><span class="kn">import</span> <span class="nn">sentry_sdk</span>
+</span><span id="1-40"><span class="kn">from</span> <span class="nn">sentry_sdk._compat</span> <span class="kn">import</span> <span class="n">PY311</span>
+</span><span id="1-41"><span class="kn">from</span> <span class="nn">sentry_sdk._lru_cache</span> <span class="kn">import</span> <span class="n">LRUCache</span>
+</span><span id="1-42"><span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="n">TYPE_CHECKING</span>
+</span><span id="1-43"><span class="kn">from</span> <span class="nn">sentry_sdk.utils</span> <span class="kn">import</span> <span class="p">(</span>
+</span><span id="1-44">    <span class="n">capture_internal_exception</span><span class="p">,</span>
+</span><span id="1-45">    <span class="n">filename_for_module</span><span class="p">,</span>
+</span><span id="1-46">    <span class="n">get_current_thread_meta</span><span class="p">,</span>
+</span><span id="1-47">    <span class="n">is_gevent</span><span class="p">,</span>
+</span><span id="1-48">    <span class="n">is_valid_sample_rate</span><span class="p">,</span>
+</span><span id="1-49">    <span class="n">logger</span><span class="p">,</span>
+</span><span id="1-50">    <span class="n">nanosecond_time</span><span class="p">,</span>
+</span><span id="1-51">    <span class="n">set_in_app_in_frames</span><span class="p">,</span>
+</span><span id="1-52"><span class="p">)</span>
+</span><span id="1-53">
+</span><span id="1-54"><span class="k">if</span> <span class="n">TYPE_CHECKING</span><span class="p">:</span>
+</span><span id="1-55">    <span class="kn">from</span> <span class="nn">types</span> <span class="kn">import</span> <span class="n">FrameType</span>
+</span><span id="1-56">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Any</span>
+</span><span id="1-57">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Callable</span>
+</span><span id="1-58">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Deque</span>
+</span><span id="1-59">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Dict</span>
+</span><span id="1-60">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">List</span>
+</span><span id="1-61">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Optional</span>
+</span><span id="1-62">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Set</span>
+</span><span id="1-63">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Sequence</span>
+</span><span id="1-64">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Tuple</span>
+</span><span id="1-65">    <span class="kn">from</span> <span class="nn">typing_extensions</span> <span class="kn">import</span> <span class="n">TypedDict</span>
+</span><span id="1-66">
+</span><span id="1-67">    <span class="kn">import</span> <span class="nn">sentry_sdk.tracing</span>
+</span><span id="1-68">    <span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="n">Event</span><span class="p">,</span> <span class="n">SamplingContext</span><span class="p">,</span> <span class="n">ProfilerMode</span>
+</span><span id="1-69">
+</span><span id="1-70">    <span class="n">ThreadId</span> <span class="o">=</span> <span class="nb">str</span>
+</span><span id="1-71">
+</span><span id="1-72">    <span class="n">ProcessedSample</span> <span class="o">=</span> <span class="n">TypedDict</span><span class="p">(</span>
+</span><span id="1-73">        <span class="s2">&quot;ProcessedSample&quot;</span><span class="p">,</span>
+</span><span id="1-74">        <span class="p">{</span>
+</span><span id="1-75">            <span class="s2">&quot;elapsed_since_start_ns&quot;</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>
+</span><span id="1-76">            <span class="s2">&quot;thread_id&quot;</span><span class="p">:</span> <span class="n">ThreadId</span><span class="p">,</span>
+</span><span id="1-77">            <span class="s2">&quot;stack_id&quot;</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
+</span><span id="1-78">        <span class="p">},</span>
+</span><span id="1-79">    <span class="p">)</span>
+</span><span id="1-80">
+</span><span id="1-81">    <span class="n">ProcessedStack</span> <span class="o">=</span> <span class="n">List</span><span class="p">[</span><span class="nb">int</span><span class="p">]</span>
+</span><span id="1-82">
+</span><span id="1-83">    <span class="n">ProcessedFrame</span> <span class="o">=</span> <span class="n">TypedDict</span><span class="p">(</span>
+</span><span id="1-84">        <span class="s2">&quot;ProcessedFrame&quot;</span><span class="p">,</span>
+</span><span id="1-85">        <span class="p">{</span>
+</span><span id="1-86">            <span class="s2">&quot;abs_path&quot;</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>
+</span><span id="1-87">            <span class="s2">&quot;filename&quot;</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span>
+</span><span id="1-88">            <span class="s2">&quot;function&quot;</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>
+</span><span id="1-89">            <span class="s2">&quot;lineno&quot;</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
+</span><span id="1-90">            <span class="s2">&quot;module&quot;</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span>
+</span><span id="1-91">        <span class="p">},</span>
+</span><span id="1-92">    <span class="p">)</span>
+</span><span id="1-93">
+</span><span id="1-94">    <span class="n">ProcessedThreadMetadata</span> <span class="o">=</span> <span class="n">TypedDict</span><span class="p">(</span>
+</span><span id="1-95">        <span class="s2">&quot;ProcessedThreadMetadata&quot;</span><span class="p">,</span>
+</span><span id="1-96">        <span class="p">{</span><span class="s2">&quot;name&quot;</span><span class="p">:</span> <span class="nb">str</span><span class="p">},</span>
+</span><span id="1-97">    <span class="p">)</span>
+</span><span id="1-98">
+</span><span id="1-99">    <span class="n">ProcessedProfile</span> <span class="o">=</span> <span class="n">TypedDict</span><span class="p">(</span>
+</span><span id="1-100">        <span class="s2">&quot;ProcessedProfile&quot;</span><span class="p">,</span>
+</span><span id="1-101">        <span class="p">{</span>
+</span><span id="1-102">            <span class="s2">&quot;frames&quot;</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="n">ProcessedFrame</span><span class="p">],</span>
+</span><span id="1-103">            <span class="s2">&quot;stacks&quot;</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="n">ProcessedStack</span><span class="p">],</span>
+</span><span id="1-104">            <span class="s2">&quot;samples&quot;</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="n">ProcessedSample</span><span class="p">],</span>
+</span><span id="1-105">            <span class="s2">&quot;thread_metadata&quot;</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="n">ThreadId</span><span class="p">,</span> <span class="n">ProcessedThreadMetadata</span><span class="p">],</span>
+</span><span id="1-106">        <span class="p">},</span>
+</span><span id="1-107">    <span class="p">)</span>
+</span><span id="1-108">
+</span><span id="1-109">    <span class="n">ProfileContext</span> <span class="o">=</span> <span class="n">TypedDict</span><span class="p">(</span>
+</span><span id="1-110">        <span class="s2">&quot;ProfileContext&quot;</span><span class="p">,</span>
+</span><span id="1-111">        <span class="p">{</span><span class="s2">&quot;profile_id&quot;</span><span class="p">:</span> <span class="nb">str</span><span class="p">},</span>
+</span><span id="1-112">    <span class="p">)</span>
+</span><span id="1-113">
+</span><span id="1-114">    <span class="n">FrameId</span> <span class="o">=</span> <span class="n">Tuple</span><span class="p">[</span>
+</span><span id="1-115">        <span class="nb">str</span><span class="p">,</span>  <span class="c1"># abs_path</span>
+</span><span id="1-116">        <span class="nb">int</span><span class="p">,</span>  <span class="c1"># lineno</span>
+</span><span id="1-117">        <span class="nb">str</span><span class="p">,</span>  <span class="c1"># function</span>
+</span><span id="1-118">    <span class="p">]</span>
+</span><span id="1-119">    <span class="n">FrameIds</span> <span class="o">=</span> <span class="n">Tuple</span><span class="p">[</span><span class="n">FrameId</span><span class="p">,</span> <span class="o">...</span><span class="p">]</span>
+</span><span id="1-120">
+</span><span id="1-121">    <span class="c1"># The exact value of this id is not very meaningful. The purpose</span>
+</span><span id="1-122">    <span class="c1"># of this id is to give us a compact and unique identifier for a</span>
+</span><span id="1-123">    <span class="c1"># raw stack that can be used as a key to a dictionary so that it</span>
+</span><span id="1-124">    <span class="c1"># can be used during the sampled format generation.</span>
+</span><span id="1-125">    <span class="n">StackId</span> <span class="o">=</span> <span class="n">Tuple</span><span class="p">[</span><span class="nb">int</span><span class="p">,</span> <span class="nb">int</span><span class="p">]</span>
+</span><span id="1-126">
+</span><span id="1-127">    <span class="n">ExtractedStack</span> <span class="o">=</span> <span class="n">Tuple</span><span class="p">[</span><span class="n">StackId</span><span class="p">,</span> <span class="n">FrameIds</span><span class="p">,</span> <span class="n">List</span><span class="p">[</span><span class="n">ProcessedFrame</span><span class="p">]]</span>
+</span><span id="1-128">    <span class="n">ExtractedSample</span> <span class="o">=</span> <span class="n">Sequence</span><span class="p">[</span><span class="n">Tuple</span><span class="p">[</span><span class="n">ThreadId</span><span class="p">,</span> <span class="n">ExtractedStack</span><span class="p">]]</span>
 </span><span id="1-129">
-</span><span id="1-130"><span class="k">try</span><span class="p">:</span>
-</span><span id="1-131">    <span class="kn">from</span> <span class="nn">gevent.monkey</span> <span class="kn">import</span> <span class="n">get_original</span>  <span class="c1"># type: ignore</span>
-</span><span id="1-132">    <span class="kn">from</span> <span class="nn">gevent.threadpool</span> <span class="kn">import</span> <span class="n">ThreadPool</span>  <span class="c1"># type: ignore</span>
-</span><span id="1-133">
-</span><span id="1-134">    <span class="n">thread_sleep</span> <span class="o">=</span> <span class="n">get_original</span><span class="p">(</span><span class="s2">&quot;time&quot;</span><span class="p">,</span> <span class="s2">&quot;sleep&quot;</span><span class="p">)</span>
-</span><span id="1-135"><span class="k">except</span> <span class="ne">ImportError</span><span class="p">:</span>
-</span><span id="1-136">    <span class="n">thread_sleep</span> <span class="o">=</span> <span class="n">time</span><span class="o">.</span><span class="n">sleep</span>
-</span><span id="1-137">
-</span><span id="1-138">    <span class="n">ThreadPool</span> <span class="o">=</span> <span class="kc">None</span>
-</span><span id="1-139">
+</span><span id="1-130">
+</span><span id="1-131"><span class="k">try</span><span class="p">:</span>
+</span><span id="1-132">    <span class="kn">from</span> <span class="nn">gevent.monkey</span> <span class="kn">import</span> <span class="n">get_original</span>  <span class="c1"># type: ignore</span>
+</span><span id="1-133">    <span class="kn">from</span> <span class="nn">gevent.threadpool</span> <span class="kn">import</span> <span class="n">ThreadPool</span>  <span class="c1"># type: ignore</span>
+</span><span id="1-134">
+</span><span id="1-135">    <span class="n">thread_sleep</span> <span class="o">=</span> <span class="n">get_original</span><span class="p">(</span><span class="s2">&quot;time&quot;</span><span class="p">,</span> <span class="s2">&quot;sleep&quot;</span><span class="p">)</span>
+</span><span id="1-136"><span class="k">except</span> <span class="ne">ImportError</span><span class="p">:</span>
+</span><span id="1-137">    <span class="n">thread_sleep</span> <span class="o">=</span> <span class="n">time</span><span class="o">.</span><span class="n">sleep</span>
+</span><span id="1-138">
+</span><span id="1-139">    <span class="n">ThreadPool</span> <span class="o">=</span> <span class="kc">None</span>
 </span><span id="1-140">
-</span><span id="1-141"><span class="n">_scheduler</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[Scheduler]</span>
-</span><span id="1-142">
-</span><span id="1-143"><span class="c1"># The default sampling frequency to use. This is set at 101 in order to</span>
-</span><span id="1-144"><span class="c1"># mitigate the effects of lockstep sampling.</span>
-</span><span id="1-145"><span class="n">DEFAULT_SAMPLING_FREQUENCY</span> <span class="o">=</span> <span class="mi">101</span>
-</span><span id="1-146">
+</span><span id="1-141">
+</span><span id="1-142"><span class="n">_scheduler</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[Scheduler]</span>
+</span><span id="1-143">
+</span><span id="1-144"><span class="c1"># The default sampling frequency to use. This is set at 101 in order to</span>
+</span><span id="1-145"><span class="c1"># mitigate the effects of lockstep sampling.</span>
+</span><span id="1-146"><span class="n">DEFAULT_SAMPLING_FREQUENCY</span> <span class="o">=</span> <span class="mi">101</span>
 </span><span id="1-147">
-</span><span id="1-148"><span class="c1"># The minimum number of unique samples that must exist in a profile to be</span>
-</span><span id="1-149"><span class="c1"># considered valid.</span>
-</span><span id="1-150"><span class="n">PROFILE_MINIMUM_SAMPLES</span> <span class="o">=</span> <span class="mi">2</span>
-</span><span id="1-151">
+</span><span id="1-148">
+</span><span id="1-149"><span class="c1"># The minimum number of unique samples that must exist in a profile to be</span>
+</span><span id="1-150"><span class="c1"># considered valid.</span>
+</span><span id="1-151"><span class="n">PROFILE_MINIMUM_SAMPLES</span> <span class="o">=</span> <span class="mi">2</span>
 </span><span id="1-152">
-</span><span id="1-153"><span class="k">def</span> <span class="nf">has_profiling_enabled</span><span class="p">(</span><span class="n">options</span><span class="p">):</span>
-</span><span id="1-154">    <span class="c1"># type: (Dict[str, Any]) -&gt; bool</span>
-</span><span id="1-155">    <span class="n">profiles_sampler</span> <span class="o">=</span> <span class="n">options</span><span class="p">[</span><span class="s2">&quot;profiles_sampler&quot;</span><span class="p">]</span>
-</span><span id="1-156">    <span class="k">if</span> <span class="n">profiles_sampler</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-157">        <span class="k">return</span> <span class="kc">True</span>
-</span><span id="1-158">
-</span><span id="1-159">    <span class="n">profiles_sample_rate</span> <span class="o">=</span> <span class="n">options</span><span class="p">[</span><span class="s2">&quot;profiles_sample_rate&quot;</span><span class="p">]</span>
-</span><span id="1-160">    <span class="k">if</span> <span class="n">profiles_sample_rate</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">profiles_sample_rate</span> <span class="o">&gt;</span> <span class="mi">0</span><span class="p">:</span>
-</span><span id="1-161">        <span class="k">return</span> <span class="kc">True</span>
-</span><span id="1-162">
-</span><span id="1-163">    <span class="n">profiles_sample_rate</span> <span class="o">=</span> <span class="n">options</span><span class="p">[</span><span class="s2">&quot;_experiments&quot;</span><span class="p">]</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;profiles_sample_rate&quot;</span><span class="p">)</span>
-</span><span id="1-164">    <span class="k">if</span> <span class="n">profiles_sample_rate</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">profiles_sample_rate</span> <span class="o">&gt;</span> <span class="mi">0</span><span class="p">:</span>
-</span><span id="1-165">        <span class="k">return</span> <span class="kc">True</span>
-</span><span id="1-166">
-</span><span id="1-167">    <span class="k">return</span> <span class="kc">False</span>
-</span><span id="1-168">
-</span><span id="1-169">
-</span><span id="1-170"><span class="k">def</span> <span class="nf">setup_profiler</span><span class="p">(</span><span class="n">options</span><span class="p">):</span>
-</span><span id="1-171">    <span class="c1"># type: (Dict[str, Any]) -&gt; bool</span>
-</span><span id="1-172">    <span class="k">global</span> <span class="n">_scheduler</span>
+</span><span id="1-153">
+</span><span id="1-154"><span class="k">def</span> <span class="nf">has_profiling_enabled</span><span class="p">(</span><span class="n">options</span><span class="p">):</span>
+</span><span id="1-155">    <span class="c1"># type: (Dict[str, Any]) -&gt; bool</span>
+</span><span id="1-156">    <span class="n">profiles_sampler</span> <span class="o">=</span> <span class="n">options</span><span class="p">[</span><span class="s2">&quot;profiles_sampler&quot;</span><span class="p">]</span>
+</span><span id="1-157">    <span class="k">if</span> <span class="n">profiles_sampler</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-158">        <span class="k">return</span> <span class="kc">True</span>
+</span><span id="1-159">
+</span><span id="1-160">    <span class="n">profiles_sample_rate</span> <span class="o">=</span> <span class="n">options</span><span class="p">[</span><span class="s2">&quot;profiles_sample_rate&quot;</span><span class="p">]</span>
+</span><span id="1-161">    <span class="k">if</span> <span class="n">profiles_sample_rate</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">profiles_sample_rate</span> <span class="o">&gt;</span> <span class="mi">0</span><span class="p">:</span>
+</span><span id="1-162">        <span class="k">return</span> <span class="kc">True</span>
+</span><span id="1-163">
+</span><span id="1-164">    <span class="n">profiles_sample_rate</span> <span class="o">=</span> <span class="n">options</span><span class="p">[</span><span class="s2">&quot;_experiments&quot;</span><span class="p">]</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;profiles_sample_rate&quot;</span><span class="p">)</span>
+</span><span id="1-165">    <span class="k">if</span> <span class="n">profiles_sample_rate</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-166">        <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
+</span><span id="1-167">            <span class="s2">&quot;_experiments[&#39;profiles_sample_rate&#39;] is deprecated. &quot;</span>
+</span><span id="1-168">            <span class="s2">&quot;Please use the non-experimental profiles_sample_rate option &quot;</span>
+</span><span id="1-169">            <span class="s2">&quot;directly.&quot;</span>
+</span><span id="1-170">        <span class="p">)</span>
+</span><span id="1-171">        <span class="k">if</span> <span class="n">profiles_sample_rate</span> <span class="o">&gt;</span> <span class="mi">0</span><span class="p">:</span>
+</span><span id="1-172">            <span class="k">return</span> <span class="kc">True</span>
 </span><span id="1-173">
-</span><span id="1-174">    <span class="k">if</span> <span class="n">_scheduler</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-175">        <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;[Profiling] Profiler is already setup&quot;</span><span class="p">)</span>
-</span><span id="1-176">        <span class="k">return</span> <span class="kc">False</span>
-</span><span id="1-177">
-</span><span id="1-178">    <span class="k">if</span> <span class="ow">not</span> <span class="n">PY33</span><span class="p">:</span>
-</span><span id="1-179">        <span class="n">logger</span><span class="o">.</span><span class="n">warn</span><span class="p">(</span><span class="s2">&quot;[Profiling] Profiler requires Python &gt;= 3.3&quot;</span><span class="p">)</span>
-</span><span id="1-180">        <span class="k">return</span> <span class="kc">False</span>
-</span><span id="1-181">
-</span><span id="1-182">    <span class="n">frequency</span> <span class="o">=</span> <span class="n">DEFAULT_SAMPLING_FREQUENCY</span>
-</span><span id="1-183">
-</span><span id="1-184">    <span class="k">if</span> <span class="n">is_gevent</span><span class="p">():</span>
-</span><span id="1-185">        <span class="c1"># If gevent has patched the threading modules then we cannot rely on</span>
-</span><span id="1-186">        <span class="c1"># them to spawn a native thread for sampling.</span>
-</span><span id="1-187">        <span class="c1"># Instead we default to the GeventScheduler which is capable of</span>
-</span><span id="1-188">        <span class="c1"># spawning native threads within gevent.</span>
-</span><span id="1-189">        <span class="n">default_profiler_mode</span> <span class="o">=</span> <span class="n">GeventScheduler</span><span class="o">.</span><span class="n">mode</span>
-</span><span id="1-190">    <span class="k">else</span><span class="p">:</span>
-</span><span id="1-191">        <span class="n">default_profiler_mode</span> <span class="o">=</span> <span class="n">ThreadScheduler</span><span class="o">.</span><span class="n">mode</span>
-</span><span id="1-192">
-</span><span id="1-193">    <span class="k">if</span> <span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;profiler_mode&quot;</span><span class="p">)</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-194">        <span class="n">profiler_mode</span> <span class="o">=</span> <span class="n">options</span><span class="p">[</span><span class="s2">&quot;profiler_mode&quot;</span><span class="p">]</span>
-</span><span id="1-195">    <span class="k">else</span><span class="p">:</span>
-</span><span id="1-196">        <span class="n">profiler_mode</span> <span class="o">=</span> <span class="p">(</span>
-</span><span id="1-197">            <span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;_experiments&quot;</span><span class="p">,</span> <span class="p">{})</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;profiler_mode&quot;</span><span class="p">)</span>
-</span><span id="1-198">            <span class="ow">or</span> <span class="n">default_profiler_mode</span>
-</span><span id="1-199">        <span class="p">)</span>
-</span><span id="1-200">
-</span><span id="1-201">    <span class="k">if</span> <span class="p">(</span>
-</span><span id="1-202">        <span class="n">profiler_mode</span> <span class="o">==</span> <span class="n">ThreadScheduler</span><span class="o">.</span><span class="n">mode</span>
-</span><span id="1-203">        <span class="c1"># for legacy reasons, we&#39;ll keep supporting sleep mode for this scheduler</span>
-</span><span id="1-204">        <span class="ow">or</span> <span class="n">profiler_mode</span> <span class="o">==</span> <span class="s2">&quot;sleep&quot;</span>
-</span><span id="1-205">    <span class="p">):</span>
-</span><span id="1-206">        <span class="n">_scheduler</span> <span class="o">=</span> <span class="n">ThreadScheduler</span><span class="p">(</span><span class="n">frequency</span><span class="o">=</span><span class="n">frequency</span><span class="p">)</span>
-</span><span id="1-207">    <span class="k">elif</span> <span class="n">profiler_mode</span> <span class="o">==</span> <span class="n">GeventScheduler</span><span class="o">.</span><span class="n">mode</span><span class="p">:</span>
-</span><span id="1-208">        <span class="n">_scheduler</span> <span class="o">=</span> <span class="n">GeventScheduler</span><span class="p">(</span><span class="n">frequency</span><span class="o">=</span><span class="n">frequency</span><span class="p">)</span>
-</span><span id="1-209">    <span class="k">else</span><span class="p">:</span>
-</span><span id="1-210">        <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">&quot;Unknown profiler mode: </span><span class="si">{}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">profiler_mode</span><span class="p">))</span>
-</span><span id="1-211">
-</span><span id="1-212">    <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span>
-</span><span id="1-213">        <span class="s2">&quot;[Profiling] Setting up profiler in </span><span class="si">{mode}</span><span class="s2"> mode&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">mode</span><span class="o">=</span><span class="n">_scheduler</span><span class="o">.</span><span class="n">mode</span><span class="p">)</span>
-</span><span id="1-214">    <span class="p">)</span>
-</span><span id="1-215">    <span class="n">_scheduler</span><span class="o">.</span><span class="n">setup</span><span class="p">()</span>
-</span><span id="1-216">
-</span><span id="1-217">    <span class="n">atexit</span><span class="o">.</span><span class="n">register</span><span class="p">(</span><span class="n">teardown_profiler</span><span class="p">)</span>
-</span><span id="1-218">
-</span><span id="1-219">    <span class="k">return</span> <span class="kc">True</span>
-</span><span id="1-220">
-</span><span id="1-221">
-</span><span id="1-222"><span class="k">def</span> <span class="nf">teardown_profiler</span><span class="p">():</span>
-</span><span id="1-223">    <span class="c1"># type: () -&gt; None</span>
+</span><span id="1-174">    <span class="k">return</span> <span class="kc">False</span>
+</span><span id="1-175">
+</span><span id="1-176">
+</span><span id="1-177"><span class="k">def</span> <span class="nf">setup_profiler</span><span class="p">(</span><span class="n">options</span><span class="p">):</span>
+</span><span id="1-178">    <span class="c1"># type: (Dict[str, Any]) -&gt; bool</span>
+</span><span id="1-179">    <span class="k">global</span> <span class="n">_scheduler</span>
+</span><span id="1-180">
+</span><span id="1-181">    <span class="k">if</span> <span class="n">_scheduler</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-182">        <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;[Profiling] Profiler is already setup&quot;</span><span class="p">)</span>
+</span><span id="1-183">        <span class="k">return</span> <span class="kc">False</span>
+</span><span id="1-184">
+</span><span id="1-185">    <span class="n">frequency</span> <span class="o">=</span> <span class="n">DEFAULT_SAMPLING_FREQUENCY</span>
+</span><span id="1-186">
+</span><span id="1-187">    <span class="k">if</span> <span class="n">is_gevent</span><span class="p">():</span>
+</span><span id="1-188">        <span class="c1"># If gevent has patched the threading modules then we cannot rely on</span>
+</span><span id="1-189">        <span class="c1"># them to spawn a native thread for sampling.</span>
+</span><span id="1-190">        <span class="c1"># Instead we default to the GeventScheduler which is capable of</span>
+</span><span id="1-191">        <span class="c1"># spawning native threads within gevent.</span>
+</span><span id="1-192">        <span class="n">default_profiler_mode</span> <span class="o">=</span> <span class="n">GeventScheduler</span><span class="o">.</span><span class="n">mode</span>
+</span><span id="1-193">    <span class="k">else</span><span class="p">:</span>
+</span><span id="1-194">        <span class="n">default_profiler_mode</span> <span class="o">=</span> <span class="n">ThreadScheduler</span><span class="o">.</span><span class="n">mode</span>
+</span><span id="1-195">
+</span><span id="1-196">    <span class="k">if</span> <span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;profiler_mode&quot;</span><span class="p">)</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-197">        <span class="n">profiler_mode</span> <span class="o">=</span> <span class="n">options</span><span class="p">[</span><span class="s2">&quot;profiler_mode&quot;</span><span class="p">]</span>
+</span><span id="1-198">    <span class="k">else</span><span class="p">:</span>
+</span><span id="1-199">        <span class="n">profiler_mode</span> <span class="o">=</span> <span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;_experiments&quot;</span><span class="p">,</span> <span class="p">{})</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;profiler_mode&quot;</span><span class="p">)</span>
+</span><span id="1-200">        <span class="k">if</span> <span class="n">profiler_mode</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-201">            <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
+</span><span id="1-202">                <span class="s2">&quot;_experiments[&#39;profiler_mode&#39;] is deprecated. Please use the &quot;</span>
+</span><span id="1-203">                <span class="s2">&quot;non-experimental profiler_mode option directly.&quot;</span>
+</span><span id="1-204">            <span class="p">)</span>
+</span><span id="1-205">        <span class="n">profiler_mode</span> <span class="o">=</span> <span class="n">profiler_mode</span> <span class="ow">or</span> <span class="n">default_profiler_mode</span>
+</span><span id="1-206">
+</span><span id="1-207">    <span class="k">if</span> <span class="p">(</span>
+</span><span id="1-208">        <span class="n">profiler_mode</span> <span class="o">==</span> <span class="n">ThreadScheduler</span><span class="o">.</span><span class="n">mode</span>
+</span><span id="1-209">        <span class="c1"># for legacy reasons, we&#39;ll keep supporting sleep mode for this scheduler</span>
+</span><span id="1-210">        <span class="ow">or</span> <span class="n">profiler_mode</span> <span class="o">==</span> <span class="s2">&quot;sleep&quot;</span>
+</span><span id="1-211">    <span class="p">):</span>
+</span><span id="1-212">        <span class="n">_scheduler</span> <span class="o">=</span> <span class="n">ThreadScheduler</span><span class="p">(</span><span class="n">frequency</span><span class="o">=</span><span class="n">frequency</span><span class="p">)</span>
+</span><span id="1-213">    <span class="k">elif</span> <span class="n">profiler_mode</span> <span class="o">==</span> <span class="n">GeventScheduler</span><span class="o">.</span><span class="n">mode</span><span class="p">:</span>
+</span><span id="1-214">        <span class="n">_scheduler</span> <span class="o">=</span> <span class="n">GeventScheduler</span><span class="p">(</span><span class="n">frequency</span><span class="o">=</span><span class="n">frequency</span><span class="p">)</span>
+</span><span id="1-215">    <span class="k">else</span><span class="p">:</span>
+</span><span id="1-216">        <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">&quot;Unknown profiler mode: </span><span class="si">{}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">profiler_mode</span><span class="p">))</span>
+</span><span id="1-217">
+</span><span id="1-218">    <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span>
+</span><span id="1-219">        <span class="s2">&quot;[Profiling] Setting up profiler in </span><span class="si">{mode}</span><span class="s2"> mode&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">mode</span><span class="o">=</span><span class="n">_scheduler</span><span class="o">.</span><span class="n">mode</span><span class="p">)</span>
+</span><span id="1-220">    <span class="p">)</span>
+</span><span id="1-221">    <span class="n">_scheduler</span><span class="o">.</span><span class="n">setup</span><span class="p">()</span>
+</span><span id="1-222">
+</span><span id="1-223">    <span class="n">atexit</span><span class="o">.</span><span class="n">register</span><span class="p">(</span><span class="n">teardown_profiler</span><span class="p">)</span>
 </span><span id="1-224">
-</span><span id="1-225">    <span class="k">global</span> <span class="n">_scheduler</span>
+</span><span id="1-225">    <span class="k">return</span> <span class="kc">True</span>
 </span><span id="1-226">
-</span><span id="1-227">    <span class="k">if</span> <span class="n">_scheduler</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-228">        <span class="n">_scheduler</span><span class="o">.</span><span class="n">teardown</span><span class="p">()</span>
-</span><span id="1-229">
-</span><span id="1-230">    <span class="n">_scheduler</span> <span class="o">=</span> <span class="kc">None</span>
-</span><span id="1-231">
+</span><span id="1-227">
+</span><span id="1-228"><span class="k">def</span> <span class="nf">teardown_profiler</span><span class="p">():</span>
+</span><span id="1-229">    <span class="c1"># type: () -&gt; None</span>
+</span><span id="1-230">
+</span><span id="1-231">    <span class="k">global</span> <span class="n">_scheduler</span>
 </span><span id="1-232">
-</span><span id="1-233"><span class="c1"># We want to impose a stack depth limit so that samples aren&#39;t too large.</span>
-</span><span id="1-234"><span class="n">MAX_STACK_DEPTH</span> <span class="o">=</span> <span class="mi">128</span>
+</span><span id="1-233">    <span class="k">if</span> <span class="n">_scheduler</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-234">        <span class="n">_scheduler</span><span class="o">.</span><span class="n">teardown</span><span class="p">()</span>
 </span><span id="1-235">
-</span><span id="1-236">
-</span><span id="1-237"><span class="k">def</span> <span class="nf">extract_stack</span><span class="p">(</span>
-</span><span id="1-238">    <span class="n">raw_frame</span><span class="p">,</span>  <span class="c1"># type: Optional[FrameType]</span>
-</span><span id="1-239">    <span class="n">cache</span><span class="p">,</span>  <span class="c1"># type: LRUCache</span>
-</span><span id="1-240">    <span class="n">cwd</span><span class="p">,</span>  <span class="c1"># type: str</span>
-</span><span id="1-241">    <span class="n">max_stack_depth</span><span class="o">=</span><span class="n">MAX_STACK_DEPTH</span><span class="p">,</span>  <span class="c1"># type: int</span>
-</span><span id="1-242"><span class="p">):</span>
-</span><span id="1-243">    <span class="c1"># type: (...) -&gt; ExtractedStack</span>
-</span><span id="1-244"><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-245"><span class="sd">    Extracts the stack starting the specified frame. The extracted stack</span>
-</span><span id="1-246"><span class="sd">    assumes the specified frame is the top of the stack, and works back</span>
-</span><span id="1-247"><span class="sd">    to the bottom of the stack.</span>
-</span><span id="1-248">
-</span><span id="1-249"><span class="sd">    In the event that the stack is more than `MAX_STACK_DEPTH` frames deep,</span>
-</span><span id="1-250"><span class="sd">    only the first `MAX_STACK_DEPTH` frames will be returned.</span>
-</span><span id="1-251"><span class="sd">    &quot;&quot;&quot;</span>
-</span><span id="1-252">
-</span><span id="1-253">    <span class="n">raw_frames</span> <span class="o">=</span> <span class="n">deque</span><span class="p">(</span><span class="n">maxlen</span><span class="o">=</span><span class="n">max_stack_depth</span><span class="p">)</span>  <span class="c1"># type: Deque[FrameType]</span>
+</span><span id="1-236">    <span class="n">_scheduler</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="1-237">
+</span><span id="1-238">
+</span><span id="1-239"><span class="c1"># We want to impose a stack depth limit so that samples aren&#39;t too large.</span>
+</span><span id="1-240"><span class="n">MAX_STACK_DEPTH</span> <span class="o">=</span> <span class="mi">128</span>
+</span><span id="1-241">
+</span><span id="1-242">
+</span><span id="1-243"><span class="k">def</span> <span class="nf">extract_stack</span><span class="p">(</span>
+</span><span id="1-244">    <span class="n">raw_frame</span><span class="p">,</span>  <span class="c1"># type: Optional[FrameType]</span>
+</span><span id="1-245">    <span class="n">cache</span><span class="p">,</span>  <span class="c1"># type: LRUCache</span>
+</span><span id="1-246">    <span class="n">cwd</span><span class="p">,</span>  <span class="c1"># type: str</span>
+</span><span id="1-247">    <span class="n">max_stack_depth</span><span class="o">=</span><span class="n">MAX_STACK_DEPTH</span><span class="p">,</span>  <span class="c1"># type: int</span>
+</span><span id="1-248"><span class="p">):</span>
+</span><span id="1-249">    <span class="c1"># type: (...) -&gt; ExtractedStack</span>
+</span><span id="1-250"><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-251"><span class="sd">    Extracts the stack starting the specified frame. The extracted stack</span>
+</span><span id="1-252"><span class="sd">    assumes the specified frame is the top of the stack, and works back</span>
+</span><span id="1-253"><span class="sd">    to the bottom of the stack.</span>
 </span><span id="1-254">
-</span><span id="1-255">    <span class="k">while</span> <span class="n">raw_frame</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-256">        <span class="n">f_back</span> <span class="o">=</span> <span class="n">raw_frame</span><span class="o">.</span><span class="n">f_back</span>
-</span><span id="1-257">        <span class="n">raw_frames</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">raw_frame</span><span class="p">)</span>
-</span><span id="1-258">        <span class="n">raw_frame</span> <span class="o">=</span> <span class="n">f_back</span>
-</span><span id="1-259">
-</span><span id="1-260">    <span class="n">frame_ids</span> <span class="o">=</span> <span class="nb">tuple</span><span class="p">(</span><span class="n">frame_id</span><span class="p">(</span><span class="n">raw_frame</span><span class="p">)</span> <span class="k">for</span> <span class="n">raw_frame</span> <span class="ow">in</span> <span class="n">raw_frames</span><span class="p">)</span>
-</span><span id="1-261">    <span class="n">frames</span> <span class="o">=</span> <span class="p">[]</span>
-</span><span id="1-262">    <span class="k">for</span> <span class="n">i</span><span class="p">,</span> <span class="n">fid</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">frame_ids</span><span class="p">):</span>
-</span><span id="1-263">        <span class="n">frame</span> <span class="o">=</span> <span class="n">cache</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">fid</span><span class="p">)</span>
-</span><span id="1-264">        <span class="k">if</span> <span class="n">frame</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-265">            <span class="n">frame</span> <span class="o">=</span> <span class="n">extract_frame</span><span class="p">(</span><span class="n">fid</span><span class="p">,</span> <span class="n">raw_frames</span><span class="p">[</span><span class="n">i</span><span class="p">],</span> <span class="n">cwd</span><span class="p">)</span>
-</span><span id="1-266">            <span class="n">cache</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="n">fid</span><span class="p">,</span> <span class="n">frame</span><span class="p">)</span>
-</span><span id="1-267">        <span class="n">frames</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">frame</span><span class="p">)</span>
-</span><span id="1-268">
-</span><span id="1-269">    <span class="c1"># Instead of mapping the stack into frame ids and hashing</span>
-</span><span id="1-270">    <span class="c1"># that as a tuple, we can directly hash the stack.</span>
-</span><span id="1-271">    <span class="c1"># This saves us from having to generate yet another list.</span>
-</span><span id="1-272">    <span class="c1"># Additionally, using the stack as the key directly is</span>
-</span><span id="1-273">    <span class="c1"># costly because the stack can be large, so we pre-hash</span>
-</span><span id="1-274">    <span class="c1"># the stack, and use the hash as the key as this will be</span>
-</span><span id="1-275">    <span class="c1"># needed a few times to improve performance.</span>
-</span><span id="1-276">    <span class="c1">#</span>
-</span><span id="1-277">    <span class="c1"># To Reduce the likelihood of hash collisions, we include</span>
-</span><span id="1-278">    <span class="c1"># the stack depth. This means that only stacks of the same</span>
-</span><span id="1-279">    <span class="c1"># depth can suffer from hash collisions.</span>
-</span><span id="1-280">    <span class="n">stack_id</span> <span class="o">=</span> <span class="nb">len</span><span class="p">(</span><span class="n">raw_frames</span><span class="p">),</span> <span class="nb">hash</span><span class="p">(</span><span class="n">frame_ids</span><span class="p">)</span>
-</span><span id="1-281">
-</span><span id="1-282">    <span class="k">return</span> <span class="n">stack_id</span><span class="p">,</span> <span class="n">frame_ids</span><span class="p">,</span> <span class="n">frames</span>
-</span><span id="1-283">
-</span><span id="1-284">
-</span><span id="1-285"><span class="k">def</span> <span class="nf">frame_id</span><span class="p">(</span><span class="n">raw_frame</span><span class="p">):</span>
-</span><span id="1-286">    <span class="c1"># type: (FrameType) -&gt; FrameId</span>
-</span><span id="1-287">    <span class="k">return</span> <span class="p">(</span><span class="n">raw_frame</span><span class="o">.</span><span class="n">f_code</span><span class="o">.</span><span class="n">co_filename</span><span class="p">,</span> <span class="n">raw_frame</span><span class="o">.</span><span class="n">f_lineno</span><span class="p">,</span> <span class="n">get_frame_name</span><span class="p">(</span><span class="n">raw_frame</span><span class="p">))</span>
-</span><span id="1-288">
+</span><span id="1-255"><span class="sd">    In the event that the stack is more than `MAX_STACK_DEPTH` frames deep,</span>
+</span><span id="1-256"><span class="sd">    only the first `MAX_STACK_DEPTH` frames will be returned.</span>
+</span><span id="1-257"><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="1-258">
+</span><span id="1-259">    <span class="n">raw_frames</span> <span class="o">=</span> <span class="n">deque</span><span class="p">(</span><span class="n">maxlen</span><span class="o">=</span><span class="n">max_stack_depth</span><span class="p">)</span>  <span class="c1"># type: Deque[FrameType]</span>
+</span><span id="1-260">
+</span><span id="1-261">    <span class="k">while</span> <span class="n">raw_frame</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-262">        <span class="n">f_back</span> <span class="o">=</span> <span class="n">raw_frame</span><span class="o">.</span><span class="n">f_back</span>
+</span><span id="1-263">        <span class="n">raw_frames</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">raw_frame</span><span class="p">)</span>
+</span><span id="1-264">        <span class="n">raw_frame</span> <span class="o">=</span> <span class="n">f_back</span>
+</span><span id="1-265">
+</span><span id="1-266">    <span class="n">frame_ids</span> <span class="o">=</span> <span class="nb">tuple</span><span class="p">(</span><span class="n">frame_id</span><span class="p">(</span><span class="n">raw_frame</span><span class="p">)</span> <span class="k">for</span> <span class="n">raw_frame</span> <span class="ow">in</span> <span class="n">raw_frames</span><span class="p">)</span>
+</span><span id="1-267">    <span class="n">frames</span> <span class="o">=</span> <span class="p">[]</span>
+</span><span id="1-268">    <span class="k">for</span> <span class="n">i</span><span class="p">,</span> <span class="n">fid</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">frame_ids</span><span class="p">):</span>
+</span><span id="1-269">        <span class="n">frame</span> <span class="o">=</span> <span class="n">cache</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">fid</span><span class="p">)</span>
+</span><span id="1-270">        <span class="k">if</span> <span class="n">frame</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-271">            <span class="n">frame</span> <span class="o">=</span> <span class="n">extract_frame</span><span class="p">(</span><span class="n">fid</span><span class="p">,</span> <span class="n">raw_frames</span><span class="p">[</span><span class="n">i</span><span class="p">],</span> <span class="n">cwd</span><span class="p">)</span>
+</span><span id="1-272">            <span class="n">cache</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="n">fid</span><span class="p">,</span> <span class="n">frame</span><span class="p">)</span>
+</span><span id="1-273">        <span class="n">frames</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">frame</span><span class="p">)</span>
+</span><span id="1-274">
+</span><span id="1-275">    <span class="c1"># Instead of mapping the stack into frame ids and hashing</span>
+</span><span id="1-276">    <span class="c1"># that as a tuple, we can directly hash the stack.</span>
+</span><span id="1-277">    <span class="c1"># This saves us from having to generate yet another list.</span>
+</span><span id="1-278">    <span class="c1"># Additionally, using the stack as the key directly is</span>
+</span><span id="1-279">    <span class="c1"># costly because the stack can be large, so we pre-hash</span>
+</span><span id="1-280">    <span class="c1"># the stack, and use the hash as the key as this will be</span>
+</span><span id="1-281">    <span class="c1"># needed a few times to improve performance.</span>
+</span><span id="1-282">    <span class="c1">#</span>
+</span><span id="1-283">    <span class="c1"># To Reduce the likelihood of hash collisions, we include</span>
+</span><span id="1-284">    <span class="c1"># the stack depth. This means that only stacks of the same</span>
+</span><span id="1-285">    <span class="c1"># depth can suffer from hash collisions.</span>
+</span><span id="1-286">    <span class="n">stack_id</span> <span class="o">=</span> <span class="nb">len</span><span class="p">(</span><span class="n">raw_frames</span><span class="p">),</span> <span class="nb">hash</span><span class="p">(</span><span class="n">frame_ids</span><span class="p">)</span>
+</span><span id="1-287">
+</span><span id="1-288">    <span class="k">return</span> <span class="n">stack_id</span><span class="p">,</span> <span class="n">frame_ids</span><span class="p">,</span> <span class="n">frames</span>
 </span><span id="1-289">
-</span><span id="1-290"><span class="k">def</span> <span class="nf">extract_frame</span><span class="p">(</span><span class="n">fid</span><span class="p">,</span> <span class="n">raw_frame</span><span class="p">,</span> <span class="n">cwd</span><span class="p">):</span>
-</span><span id="1-291">    <span class="c1"># type: (FrameId, FrameType, str) -&gt; ProcessedFrame</span>
-</span><span id="1-292">    <span class="n">abs_path</span> <span class="o">=</span> <span class="n">raw_frame</span><span class="o">.</span><span class="n">f_code</span><span class="o">.</span><span class="n">co_filename</span>
-</span><span id="1-293">
-</span><span id="1-294">    <span class="k">try</span><span class="p">:</span>
-</span><span id="1-295">        <span class="n">module</span> <span class="o">=</span> <span class="n">raw_frame</span><span class="o">.</span><span class="n">f_globals</span><span class="p">[</span><span class="s2">&quot;__name__&quot;</span><span class="p">]</span>
-</span><span id="1-296">    <span class="k">except</span> <span class="ne">Exception</span><span class="p">:</span>
-</span><span id="1-297">        <span class="n">module</span> <span class="o">=</span> <span class="kc">None</span>
-</span><span id="1-298">
-</span><span id="1-299">    <span class="c1"># namedtuples can be many times slower when initialing</span>
-</span><span id="1-300">    <span class="c1"># and accessing attribute so we opt to use a tuple here instead</span>
-</span><span id="1-301">    <span class="k">return</span> <span class="p">{</span>
-</span><span id="1-302">        <span class="c1"># This originally was `os.path.abspath(abs_path)` but that had</span>
-</span><span id="1-303">        <span class="c1"># a large performance overhead.</span>
-</span><span id="1-304">        <span class="c1">#</span>
-</span><span id="1-305">        <span class="c1"># According to docs, this is equivalent to</span>
-</span><span id="1-306">        <span class="c1"># `os.path.normpath(os.path.join(os.getcwd(), path))`.</span>
-</span><span id="1-307">        <span class="c1"># The `os.getcwd()` call is slow here, so we precompute it.</span>
-</span><span id="1-308">        <span class="c1">#</span>
-</span><span id="1-309">        <span class="c1"># Additionally, since we are using normalized path already,</span>
-</span><span id="1-310">        <span class="c1"># we skip calling `os.path.normpath` entirely.</span>
-</span><span id="1-311">        <span class="s2">&quot;abs_path&quot;</span><span class="p">:</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">cwd</span><span class="p">,</span> <span class="n">abs_path</span><span class="p">),</span>
-</span><span id="1-312">        <span class="s2">&quot;module&quot;</span><span class="p">:</span> <span class="n">module</span><span class="p">,</span>
-</span><span id="1-313">        <span class="s2">&quot;filename&quot;</span><span class="p">:</span> <span class="n">filename_for_module</span><span class="p">(</span><span class="n">module</span><span class="p">,</span> <span class="n">abs_path</span><span class="p">)</span> <span class="ow">or</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="1-314">        <span class="s2">&quot;function&quot;</span><span class="p">:</span> <span class="n">fid</span><span class="p">[</span><span class="mi">2</span><span class="p">],</span>
-</span><span id="1-315">        <span class="s2">&quot;lineno&quot;</span><span class="p">:</span> <span class="n">raw_frame</span><span class="o">.</span><span class="n">f_lineno</span><span class="p">,</span>
-</span><span id="1-316">    <span class="p">}</span>
-</span><span id="1-317">
-</span><span id="1-318">
-</span><span id="1-319"><span class="k">if</span> <span class="n">PY311</span><span class="p">:</span>
-</span><span id="1-320">
-</span><span id="1-321">    <span class="k">def</span> <span class="nf">get_frame_name</span><span class="p">(</span><span class="n">frame</span><span class="p">):</span>
-</span><span id="1-322">        <span class="c1"># type: (FrameType) -&gt; str</span>
-</span><span id="1-323">        <span class="k">return</span> <span class="n">frame</span><span class="o">.</span><span class="n">f_code</span><span class="o">.</span><span class="n">co_qualname</span>
+</span><span id="1-290">
+</span><span id="1-291"><span class="k">def</span> <span class="nf">frame_id</span><span class="p">(</span><span class="n">raw_frame</span><span class="p">):</span>
+</span><span id="1-292">    <span class="c1"># type: (FrameType) -&gt; FrameId</span>
+</span><span id="1-293">    <span class="k">return</span> <span class="p">(</span><span class="n">raw_frame</span><span class="o">.</span><span class="n">f_code</span><span class="o">.</span><span class="n">co_filename</span><span class="p">,</span> <span class="n">raw_frame</span><span class="o">.</span><span class="n">f_lineno</span><span class="p">,</span> <span class="n">get_frame_name</span><span class="p">(</span><span class="n">raw_frame</span><span class="p">))</span>
+</span><span id="1-294">
+</span><span id="1-295">
+</span><span id="1-296"><span class="k">def</span> <span class="nf">extract_frame</span><span class="p">(</span><span class="n">fid</span><span class="p">,</span> <span class="n">raw_frame</span><span class="p">,</span> <span class="n">cwd</span><span class="p">):</span>
+</span><span id="1-297">    <span class="c1"># type: (FrameId, FrameType, str) -&gt; ProcessedFrame</span>
+</span><span id="1-298">    <span class="n">abs_path</span> <span class="o">=</span> <span class="n">raw_frame</span><span class="o">.</span><span class="n">f_code</span><span class="o">.</span><span class="n">co_filename</span>
+</span><span id="1-299">
+</span><span id="1-300">    <span class="k">try</span><span class="p">:</span>
+</span><span id="1-301">        <span class="n">module</span> <span class="o">=</span> <span class="n">raw_frame</span><span class="o">.</span><span class="n">f_globals</span><span class="p">[</span><span class="s2">&quot;__name__&quot;</span><span class="p">]</span>
+</span><span id="1-302">    <span class="k">except</span> <span class="ne">Exception</span><span class="p">:</span>
+</span><span id="1-303">        <span class="n">module</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="1-304">
+</span><span id="1-305">    <span class="c1"># namedtuples can be many times slower when initialing</span>
+</span><span id="1-306">    <span class="c1"># and accessing attribute so we opt to use a tuple here instead</span>
+</span><span id="1-307">    <span class="k">return</span> <span class="p">{</span>
+</span><span id="1-308">        <span class="c1"># This originally was `os.path.abspath(abs_path)` but that had</span>
+</span><span id="1-309">        <span class="c1"># a large performance overhead.</span>
+</span><span id="1-310">        <span class="c1">#</span>
+</span><span id="1-311">        <span class="c1"># According to docs, this is equivalent to</span>
+</span><span id="1-312">        <span class="c1"># `os.path.normpath(os.path.join(os.getcwd(), path))`.</span>
+</span><span id="1-313">        <span class="c1"># The `os.getcwd()` call is slow here, so we precompute it.</span>
+</span><span id="1-314">        <span class="c1">#</span>
+</span><span id="1-315">        <span class="c1"># Additionally, since we are using normalized path already,</span>
+</span><span id="1-316">        <span class="c1"># we skip calling `os.path.normpath` entirely.</span>
+</span><span id="1-317">        <span class="s2">&quot;abs_path&quot;</span><span class="p">:</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">cwd</span><span class="p">,</span> <span class="n">abs_path</span><span class="p">),</span>
+</span><span id="1-318">        <span class="s2">&quot;module&quot;</span><span class="p">:</span> <span class="n">module</span><span class="p">,</span>
+</span><span id="1-319">        <span class="s2">&quot;filename&quot;</span><span class="p">:</span> <span class="n">filename_for_module</span><span class="p">(</span><span class="n">module</span><span class="p">,</span> <span class="n">abs_path</span><span class="p">)</span> <span class="ow">or</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="1-320">        <span class="s2">&quot;function&quot;</span><span class="p">:</span> <span class="n">fid</span><span class="p">[</span><span class="mi">2</span><span class="p">],</span>
+</span><span id="1-321">        <span class="s2">&quot;lineno&quot;</span><span class="p">:</span> <span class="n">raw_frame</span><span class="o">.</span><span class="n">f_lineno</span><span class="p">,</span>
+</span><span id="1-322">    <span class="p">}</span>
+</span><span id="1-323">
 </span><span id="1-324">
-</span><span id="1-325"><span class="k">else</span><span class="p">:</span>
+</span><span id="1-325"><span class="k">if</span> <span class="n">PY311</span><span class="p">:</span>
 </span><span id="1-326">
 </span><span id="1-327">    <span class="k">def</span> <span class="nf">get_frame_name</span><span class="p">(</span><span class="n">frame</span><span class="p">):</span>
 </span><span id="1-328">        <span class="c1"># type: (FrameType) -&gt; str</span>
-</span><span id="1-329">
-</span><span id="1-330">        <span class="n">f_code</span> <span class="o">=</span> <span class="n">frame</span><span class="o">.</span><span class="n">f_code</span>
-</span><span id="1-331">        <span class="n">co_varnames</span> <span class="o">=</span> <span class="n">f_code</span><span class="o">.</span><span class="n">co_varnames</span>
+</span><span id="1-329">        <span class="k">return</span> <span class="n">frame</span><span class="o">.</span><span class="n">f_code</span><span class="o">.</span><span class="n">co_qualname</span>
+</span><span id="1-330">
+</span><span id="1-331"><span class="k">else</span><span class="p">:</span>
 </span><span id="1-332">
-</span><span id="1-333">        <span class="c1"># co_name only contains the frame name.  If the frame was a method,</span>
-</span><span id="1-334">        <span class="c1"># the class name will NOT be included.</span>
-</span><span id="1-335">        <span class="n">name</span> <span class="o">=</span> <span class="n">f_code</span><span class="o">.</span><span class="n">co_name</span>
-</span><span id="1-336">
-</span><span id="1-337">        <span class="c1"># if it was a method, we can get the class name by inspecting</span>
-</span><span id="1-338">        <span class="c1"># the f_locals for the `self` argument</span>
-</span><span id="1-339">        <span class="k">try</span><span class="p">:</span>
-</span><span id="1-340">            <span class="k">if</span> <span class="p">(</span>
-</span><span id="1-341">                <span class="c1"># the co_varnames start with the frame&#39;s positional arguments</span>
-</span><span id="1-342">                <span class="c1"># and we expect the first to be `self` if its an instance method</span>
-</span><span id="1-343">                <span class="n">co_varnames</span>
-</span><span id="1-344">                <span class="ow">and</span> <span class="n">co_varnames</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">==</span> <span class="s2">&quot;self&quot;</span>
-</span><span id="1-345">                <span class="ow">and</span> <span class="s2">&quot;self&quot;</span> <span class="ow">in</span> <span class="n">frame</span><span class="o">.</span><span class="n">f_locals</span>
-</span><span id="1-346">            <span class="p">):</span>
-</span><span id="1-347">                <span class="k">for</span> <span class="bp">cls</span> <span class="ow">in</span> <span class="n">frame</span><span class="o">.</span><span class="n">f_locals</span><span class="p">[</span><span class="s2">&quot;self&quot;</span><span class="p">]</span><span class="o">.</span><span class="vm">__class__</span><span class="o">.</span><span class="vm">__mro__</span><span class="p">:</span>
-</span><span id="1-348">                    <span class="k">if</span> <span class="n">name</span> <span class="ow">in</span> <span class="bp">cls</span><span class="o">.</span><span class="vm">__dict__</span><span class="p">:</span>
-</span><span id="1-349">                        <span class="k">return</span> <span class="s2">&quot;</span><span class="si">{}</span><span class="s2">.</span><span class="si">{}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="bp">cls</span><span class="o">.</span><span class="vm">__name__</span><span class="p">,</span> <span class="n">name</span><span class="p">)</span>
-</span><span id="1-350">        <span class="k">except</span> <span class="ne">AttributeError</span><span class="p">:</span>
-</span><span id="1-351">            <span class="k">pass</span>
-</span><span id="1-352">
-</span><span id="1-353">        <span class="c1"># if it was a class method, (decorated with `@classmethod`)</span>
-</span><span id="1-354">        <span class="c1"># we can get the class name by inspecting the f_locals for the `cls` argument</span>
-</span><span id="1-355">        <span class="k">try</span><span class="p">:</span>
-</span><span id="1-356">            <span class="k">if</span> <span class="p">(</span>
-</span><span id="1-357">                <span class="c1"># the co_varnames start with the frame&#39;s positional arguments</span>
-</span><span id="1-358">                <span class="c1"># and we expect the first to be `cls` if its a class method</span>
-</span><span id="1-359">                <span class="n">co_varnames</span>
-</span><span id="1-360">                <span class="ow">and</span> <span class="n">co_varnames</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">==</span> <span class="s2">&quot;cls&quot;</span>
-</span><span id="1-361">                <span class="ow">and</span> <span class="s2">&quot;cls&quot;</span> <span class="ow">in</span> <span class="n">frame</span><span class="o">.</span><span class="n">f_locals</span>
-</span><span id="1-362">            <span class="p">):</span>
-</span><span id="1-363">                <span class="k">for</span> <span class="bp">cls</span> <span class="ow">in</span> <span class="n">frame</span><span class="o">.</span><span class="n">f_locals</span><span class="p">[</span><span class="s2">&quot;cls&quot;</span><span class="p">]</span><span class="o">.</span><span class="vm">__mro__</span><span class="p">:</span>
-</span><span id="1-364">                    <span class="k">if</span> <span class="n">name</span> <span class="ow">in</span> <span class="bp">cls</span><span class="o">.</span><span class="vm">__dict__</span><span class="p">:</span>
-</span><span id="1-365">                        <span class="k">return</span> <span class="s2">&quot;</span><span class="si">{}</span><span class="s2">.</span><span class="si">{}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="bp">cls</span><span class="o">.</span><span class="vm">__name__</span><span class="p">,</span> <span class="n">name</span><span class="p">)</span>
-</span><span id="1-366">        <span class="k">except</span> <span class="ne">AttributeError</span><span class="p">:</span>
-</span><span id="1-367">            <span class="k">pass</span>
-</span><span id="1-368">
-</span><span id="1-369">        <span class="c1"># nothing we can do if it is a staticmethod (decorated with @staticmethod)</span>
-</span><span id="1-370">
-</span><span id="1-371">        <span class="c1"># we&#39;ve done all we can, time to give up and return what we have</span>
-</span><span id="1-372">        <span class="k">return</span> <span class="n">name</span>
-</span><span id="1-373">
+</span><span id="1-333">    <span class="k">def</span> <span class="nf">get_frame_name</span><span class="p">(</span><span class="n">frame</span><span class="p">):</span>
+</span><span id="1-334">        <span class="c1"># type: (FrameType) -&gt; str</span>
+</span><span id="1-335">
+</span><span id="1-336">        <span class="n">f_code</span> <span class="o">=</span> <span class="n">frame</span><span class="o">.</span><span class="n">f_code</span>
+</span><span id="1-337">        <span class="n">co_varnames</span> <span class="o">=</span> <span class="n">f_code</span><span class="o">.</span><span class="n">co_varnames</span>
+</span><span id="1-338">
+</span><span id="1-339">        <span class="c1"># co_name only contains the frame name.  If the frame was a method,</span>
+</span><span id="1-340">        <span class="c1"># the class name will NOT be included.</span>
+</span><span id="1-341">        <span class="n">name</span> <span class="o">=</span> <span class="n">f_code</span><span class="o">.</span><span class="n">co_name</span>
+</span><span id="1-342">
+</span><span id="1-343">        <span class="c1"># if it was a method, we can get the class name by inspecting</span>
+</span><span id="1-344">        <span class="c1"># the f_locals for the `self` argument</span>
+</span><span id="1-345">        <span class="k">try</span><span class="p">:</span>
+</span><span id="1-346">            <span class="k">if</span> <span class="p">(</span>
+</span><span id="1-347">                <span class="c1"># the co_varnames start with the frame&#39;s positional arguments</span>
+</span><span id="1-348">                <span class="c1"># and we expect the first to be `self` if its an instance method</span>
+</span><span id="1-349">                <span class="n">co_varnames</span>
+</span><span id="1-350">                <span class="ow">and</span> <span class="n">co_varnames</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">==</span> <span class="s2">&quot;self&quot;</span>
+</span><span id="1-351">                <span class="ow">and</span> <span class="s2">&quot;self&quot;</span> <span class="ow">in</span> <span class="n">frame</span><span class="o">.</span><span class="n">f_locals</span>
+</span><span id="1-352">            <span class="p">):</span>
+</span><span id="1-353">                <span class="k">for</span> <span class="bp">cls</span> <span class="ow">in</span> <span class="n">frame</span><span class="o">.</span><span class="n">f_locals</span><span class="p">[</span><span class="s2">&quot;self&quot;</span><span class="p">]</span><span class="o">.</span><span class="vm">__class__</span><span class="o">.</span><span class="vm">__mro__</span><span class="p">:</span>
+</span><span id="1-354">                    <span class="k">if</span> <span class="n">name</span> <span class="ow">in</span> <span class="bp">cls</span><span class="o">.</span><span class="vm">__dict__</span><span class="p">:</span>
+</span><span id="1-355">                        <span class="k">return</span> <span class="s2">&quot;</span><span class="si">{}</span><span class="s2">.</span><span class="si">{}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="bp">cls</span><span class="o">.</span><span class="vm">__name__</span><span class="p">,</span> <span class="n">name</span><span class="p">)</span>
+</span><span id="1-356">        <span class="k">except</span> <span class="ne">AttributeError</span><span class="p">:</span>
+</span><span id="1-357">            <span class="k">pass</span>
+</span><span id="1-358">
+</span><span id="1-359">        <span class="c1"># if it was a class method, (decorated with `@classmethod`)</span>
+</span><span id="1-360">        <span class="c1"># we can get the class name by inspecting the f_locals for the `cls` argument</span>
+</span><span id="1-361">        <span class="k">try</span><span class="p">:</span>
+</span><span id="1-362">            <span class="k">if</span> <span class="p">(</span>
+</span><span id="1-363">                <span class="c1"># the co_varnames start with the frame&#39;s positional arguments</span>
+</span><span id="1-364">                <span class="c1"># and we expect the first to be `cls` if its a class method</span>
+</span><span id="1-365">                <span class="n">co_varnames</span>
+</span><span id="1-366">                <span class="ow">and</span> <span class="n">co_varnames</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="o">==</span> <span class="s2">&quot;cls&quot;</span>
+</span><span id="1-367">                <span class="ow">and</span> <span class="s2">&quot;cls&quot;</span> <span class="ow">in</span> <span class="n">frame</span><span class="o">.</span><span class="n">f_locals</span>
+</span><span id="1-368">            <span class="p">):</span>
+</span><span id="1-369">                <span class="k">for</span> <span class="bp">cls</span> <span class="ow">in</span> <span class="n">frame</span><span class="o">.</span><span class="n">f_locals</span><span class="p">[</span><span class="s2">&quot;cls&quot;</span><span class="p">]</span><span class="o">.</span><span class="vm">__mro__</span><span class="p">:</span>
+</span><span id="1-370">                    <span class="k">if</span> <span class="n">name</span> <span class="ow">in</span> <span class="bp">cls</span><span class="o">.</span><span class="vm">__dict__</span><span class="p">:</span>
+</span><span id="1-371">                        <span class="k">return</span> <span class="s2">&quot;</span><span class="si">{}</span><span class="s2">.</span><span class="si">{}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="bp">cls</span><span class="o">.</span><span class="vm">__name__</span><span class="p">,</span> <span class="n">name</span><span class="p">)</span>
+</span><span id="1-372">        <span class="k">except</span> <span class="ne">AttributeError</span><span class="p">:</span>
+</span><span id="1-373">            <span class="k">pass</span>
 </span><span id="1-374">
-</span><span id="1-375"><span class="n">MAX_PROFILE_DURATION_NS</span> <span class="o">=</span> <span class="nb">int</span><span class="p">(</span><span class="mf">3e10</span><span class="p">)</span>  <span class="c1"># 30 seconds</span>
+</span><span id="1-375">        <span class="c1"># nothing we can do if it is a staticmethod (decorated with @staticmethod)</span>
 </span><span id="1-376">
-</span><span id="1-377">
+</span><span id="1-377">        <span class="c1"># we&#39;ve done all we can, time to give up and return what we have</span>
+</span><span id="1-378">        <span class="k">return</span> <span class="n">name</span>
+</span><span id="1-379">
+</span><span id="1-380">
+</span><span id="1-381"><span class="n">MAX_PROFILE_DURATION_NS</span> <span class="o">=</span> <span class="nb">int</span><span class="p">(</span><span class="mf">3e10</span><span class="p">)</span>  <span class="c1"># 30 seconds</span>
+</span><span id="1-382">
+</span><span id="1-383">
 <div class="viewcode-block" id="Profile">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.profiler.Profile">[docs]</a>
-</span><span id="1-378"><span class="k">class</span> <span class="nc">Profile</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-</span><span id="1-379">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
-</span><span id="1-380">        <span class="bp">self</span><span class="p">,</span>
-</span><span id="1-381">        <span class="n">transaction</span><span class="p">,</span>  <span class="c1"># type: sentry_sdk.tracing.Transaction</span>
-</span><span id="1-382">        <span class="n">hub</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[sentry_sdk.Hub]</span>
-</span><span id="1-383">        <span class="n">scheduler</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Scheduler]</span>
-</span><span id="1-384">    <span class="p">):</span>
-</span><span id="1-385">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-386">        <span class="bp">self</span><span class="o">.</span><span class="n">scheduler</span> <span class="o">=</span> <span class="n">_scheduler</span> <span class="k">if</span> <span class="n">scheduler</span> <span class="ow">is</span> <span class="kc">None</span> <span class="k">else</span> <span class="n">scheduler</span>
-</span><span id="1-387">        <span class="bp">self</span><span class="o">.</span><span class="n">hub</span> <span class="o">=</span> <span class="n">hub</span>
-</span><span id="1-388">
-</span><span id="1-389">        <span class="bp">self</span><span class="o">.</span><span class="n">event_id</span> <span class="o">=</span> <span class="n">uuid</span><span class="o">.</span><span class="n">uuid4</span><span class="p">()</span><span class="o">.</span><span class="n">hex</span>  <span class="c1"># type: str</span>
-</span><span id="1-390">
-</span><span id="1-391">        <span class="c1"># Here, we assume that the sampling decision on the transaction has been finalized.</span>
-</span><span id="1-392">        <span class="c1">#</span>
-</span><span id="1-393">        <span class="c1"># We cannot keep a reference to the transaction around here because it&#39;ll create</span>
-</span><span id="1-394">        <span class="c1"># a reference cycle. So we opt to pull out just the necessary attributes.</span>
-</span><span id="1-395">        <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span> <span class="o">=</span> <span class="n">transaction</span><span class="o">.</span><span class="n">sampled</span>  <span class="c1"># type: Optional[bool]</span>
+</span><span id="1-384"><span class="k">class</span> <span class="nc">Profile</span><span class="p">:</span>
+</span><span id="1-385">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
+</span><span id="1-386">        <span class="bp">self</span><span class="p">,</span>
+</span><span id="1-387">        <span class="n">transaction</span><span class="p">,</span>  <span class="c1"># type: sentry_sdk.tracing.Transaction</span>
+</span><span id="1-388">        <span class="n">hub</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[sentry_sdk.Hub]</span>
+</span><span id="1-389">        <span class="n">scheduler</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Scheduler]</span>
+</span><span id="1-390">    <span class="p">):</span>
+</span><span id="1-391">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-392">        <span class="bp">self</span><span class="o">.</span><span class="n">scheduler</span> <span class="o">=</span> <span class="n">_scheduler</span> <span class="k">if</span> <span class="n">scheduler</span> <span class="ow">is</span> <span class="kc">None</span> <span class="k">else</span> <span class="n">scheduler</span>
+</span><span id="1-393">        <span class="bp">self</span><span class="o">.</span><span class="n">hub</span> <span class="o">=</span> <span class="n">hub</span>
+</span><span id="1-394">
+</span><span id="1-395">        <span class="bp">self</span><span class="o">.</span><span class="n">event_id</span> <span class="o">=</span> <span class="n">uuid</span><span class="o">.</span><span class="n">uuid4</span><span class="p">()</span><span class="o">.</span><span class="n">hex</span>  <span class="c1"># type: str</span>
 </span><span id="1-396">
-</span><span id="1-397">        <span class="c1"># Various framework integrations are capable of overwriting the active thread id.</span>
-</span><span id="1-398">        <span class="c1"># If it is set to `None` at the end of the profile, we fall back to the default.</span>
-</span><span id="1-399">        <span class="bp">self</span><span class="o">.</span><span class="n">_default_active_thread_id</span> <span class="o">=</span> <span class="n">get_current_thread_meta</span><span class="p">()[</span><span class="mi">0</span><span class="p">]</span> <span class="ow">or</span> <span class="mi">0</span>  <span class="c1"># type: int</span>
-</span><span id="1-400">        <span class="bp">self</span><span class="o">.</span><span class="n">active_thread_id</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[int]</span>
-</span><span id="1-401">
-</span><span id="1-402">        <span class="k">try</span><span class="p">:</span>
-</span><span id="1-403">            <span class="bp">self</span><span class="o">.</span><span class="n">start_ns</span> <span class="o">=</span> <span class="n">transaction</span><span class="o">.</span><span class="n">_start_timestamp_monotonic_ns</span>  <span class="c1"># type: int</span>
-</span><span id="1-404">        <span class="k">except</span> <span class="ne">AttributeError</span><span class="p">:</span>
-</span><span id="1-405">            <span class="bp">self</span><span class="o">.</span><span class="n">start_ns</span> <span class="o">=</span> <span class="mi">0</span>
-</span><span id="1-406">
-</span><span id="1-407">        <span class="bp">self</span><span class="o">.</span><span class="n">stop_ns</span> <span class="o">=</span> <span class="mi">0</span>  <span class="c1"># type: int</span>
-</span><span id="1-408">        <span class="bp">self</span><span class="o">.</span><span class="n">active</span> <span class="o">=</span> <span class="kc">False</span>  <span class="c1"># type: bool</span>
-</span><span id="1-409">
-</span><span id="1-410">        <span class="bp">self</span><span class="o">.</span><span class="n">indexed_frames</span> <span class="o">=</span> <span class="p">{}</span>  <span class="c1"># type: Dict[FrameId, int]</span>
-</span><span id="1-411">        <span class="bp">self</span><span class="o">.</span><span class="n">indexed_stacks</span> <span class="o">=</span> <span class="p">{}</span>  <span class="c1"># type: Dict[StackId, int]</span>
-</span><span id="1-412">        <span class="bp">self</span><span class="o">.</span><span class="n">frames</span> <span class="o">=</span> <span class="p">[]</span>  <span class="c1"># type: List[ProcessedFrame]</span>
-</span><span id="1-413">        <span class="bp">self</span><span class="o">.</span><span class="n">stacks</span> <span class="o">=</span> <span class="p">[]</span>  <span class="c1"># type: List[ProcessedStack]</span>
-</span><span id="1-414">        <span class="bp">self</span><span class="o">.</span><span class="n">samples</span> <span class="o">=</span> <span class="p">[]</span>  <span class="c1"># type: List[ProcessedSample]</span>
+</span><span id="1-397">        <span class="c1"># Here, we assume that the sampling decision on the transaction has been finalized.</span>
+</span><span id="1-398">        <span class="c1">#</span>
+</span><span id="1-399">        <span class="c1"># We cannot keep a reference to the transaction around here because it&#39;ll create</span>
+</span><span id="1-400">        <span class="c1"># a reference cycle. So we opt to pull out just the necessary attributes.</span>
+</span><span id="1-401">        <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span> <span class="o">=</span> <span class="n">transaction</span><span class="o">.</span><span class="n">sampled</span>  <span class="c1"># type: Optional[bool]</span>
+</span><span id="1-402">
+</span><span id="1-403">        <span class="c1"># Various framework integrations are capable of overwriting the active thread id.</span>
+</span><span id="1-404">        <span class="c1"># If it is set to `None` at the end of the profile, we fall back to the default.</span>
+</span><span id="1-405">        <span class="bp">self</span><span class="o">.</span><span class="n">_default_active_thread_id</span> <span class="o">=</span> <span class="n">get_current_thread_meta</span><span class="p">()[</span><span class="mi">0</span><span class="p">]</span> <span class="ow">or</span> <span class="mi">0</span>  <span class="c1"># type: int</span>
+</span><span id="1-406">        <span class="bp">self</span><span class="o">.</span><span class="n">active_thread_id</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[int]</span>
+</span><span id="1-407">
+</span><span id="1-408">        <span class="k">try</span><span class="p">:</span>
+</span><span id="1-409">            <span class="bp">self</span><span class="o">.</span><span class="n">start_ns</span> <span class="o">=</span> <span class="n">transaction</span><span class="o">.</span><span class="n">_start_timestamp_monotonic_ns</span>  <span class="c1"># type: int</span>
+</span><span id="1-410">        <span class="k">except</span> <span class="ne">AttributeError</span><span class="p">:</span>
+</span><span id="1-411">            <span class="bp">self</span><span class="o">.</span><span class="n">start_ns</span> <span class="o">=</span> <span class="mi">0</span>
+</span><span id="1-412">
+</span><span id="1-413">        <span class="bp">self</span><span class="o">.</span><span class="n">stop_ns</span> <span class="o">=</span> <span class="mi">0</span>  <span class="c1"># type: int</span>
+</span><span id="1-414">        <span class="bp">self</span><span class="o">.</span><span class="n">active</span> <span class="o">=</span> <span class="kc">False</span>  <span class="c1"># type: bool</span>
 </span><span id="1-415">
-</span><span id="1-416">        <span class="bp">self</span><span class="o">.</span><span class="n">unique_samples</span> <span class="o">=</span> <span class="mi">0</span>
-</span><span id="1-417">
-</span><span id="1-418">        <span class="n">transaction</span><span class="o">.</span><span class="n">_profile</span> <span class="o">=</span> <span class="bp">self</span>
-</span><span id="1-419">
-</span><span id="1-420">    <span class="k">def</span> <span class="nf">update_active_thread_id</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-421">        <span class="c1"># type: () -&gt; None</span>
-</span><span id="1-422">        <span class="bp">self</span><span class="o">.</span><span class="n">active_thread_id</span> <span class="o">=</span> <span class="n">get_current_thread_meta</span><span class="p">()[</span><span class="mi">0</span><span class="p">]</span>
-</span><span id="1-423">        <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span>
-</span><span id="1-424">            <span class="s2">&quot;[Profiling] updating active thread id to </span><span class="si">{tid}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span>
-</span><span id="1-425">                <span class="n">tid</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">active_thread_id</span>
-</span><span id="1-426">            <span class="p">)</span>
-</span><span id="1-427">        <span class="p">)</span>
-</span><span id="1-428">
-</span><span id="1-429">    <span class="k">def</span> <span class="nf">_set_initial_sampling_decision</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">sampling_context</span><span class="p">):</span>
-</span><span id="1-430">        <span class="c1"># type: (SamplingContext) -&gt; None</span>
-</span><span id="1-431"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-432"><span class="sd">        Sets the profile&#39;s sampling decision according to the following</span>
-</span><span id="1-433"><span class="sd">        precedence rules:</span>
+</span><span id="1-416">        <span class="bp">self</span><span class="o">.</span><span class="n">indexed_frames</span> <span class="o">=</span> <span class="p">{}</span>  <span class="c1"># type: Dict[FrameId, int]</span>
+</span><span id="1-417">        <span class="bp">self</span><span class="o">.</span><span class="n">indexed_stacks</span> <span class="o">=</span> <span class="p">{}</span>  <span class="c1"># type: Dict[StackId, int]</span>
+</span><span id="1-418">        <span class="bp">self</span><span class="o">.</span><span class="n">frames</span> <span class="o">=</span> <span class="p">[]</span>  <span class="c1"># type: List[ProcessedFrame]</span>
+</span><span id="1-419">        <span class="bp">self</span><span class="o">.</span><span class="n">stacks</span> <span class="o">=</span> <span class="p">[]</span>  <span class="c1"># type: List[ProcessedStack]</span>
+</span><span id="1-420">        <span class="bp">self</span><span class="o">.</span><span class="n">samples</span> <span class="o">=</span> <span class="p">[]</span>  <span class="c1"># type: List[ProcessedSample]</span>
+</span><span id="1-421">
+</span><span id="1-422">        <span class="bp">self</span><span class="o">.</span><span class="n">unique_samples</span> <span class="o">=</span> <span class="mi">0</span>
+</span><span id="1-423">
+</span><span id="1-424">        <span class="n">transaction</span><span class="o">.</span><span class="n">_profile</span> <span class="o">=</span> <span class="bp">self</span>
+</span><span id="1-425">
+</span><span id="1-426">    <span class="k">def</span> <span class="nf">update_active_thread_id</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-427">        <span class="c1"># type: () -&gt; None</span>
+</span><span id="1-428">        <span class="bp">self</span><span class="o">.</span><span class="n">active_thread_id</span> <span class="o">=</span> <span class="n">get_current_thread_meta</span><span class="p">()[</span><span class="mi">0</span><span class="p">]</span>
+</span><span id="1-429">        <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span>
+</span><span id="1-430">            <span class="s2">&quot;[Profiling] updating active thread id to </span><span class="si">{tid}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span>
+</span><span id="1-431">                <span class="n">tid</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">active_thread_id</span>
+</span><span id="1-432">            <span class="p">)</span>
+</span><span id="1-433">        <span class="p">)</span>
 </span><span id="1-434">
-</span><span id="1-435"><span class="sd">        1. If the transaction to be profiled is not sampled, that decision</span>
-</span><span id="1-436"><span class="sd">        will be used, regardless of anything else.</span>
-</span><span id="1-437">
-</span><span id="1-438"><span class="sd">        2. Use `profiles_sample_rate` to decide.</span>
-</span><span id="1-439"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-435">    <span class="k">def</span> <span class="nf">_set_initial_sampling_decision</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">sampling_context</span><span class="p">):</span>
+</span><span id="1-436">        <span class="c1"># type: (SamplingContext) -&gt; None</span>
+</span><span id="1-437"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-438"><span class="sd">        Sets the profile&#39;s sampling decision according to the following</span>
+</span><span id="1-439"><span class="sd">        precedence rules:</span>
 </span><span id="1-440">
-</span><span id="1-441">        <span class="c1"># The corresponding transaction was not sampled,</span>
-</span><span id="1-442">        <span class="c1"># so don&#39;t generate a profile for it.</span>
-</span><span id="1-443">        <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span><span class="p">:</span>
-</span><span id="1-444">            <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span>
-</span><span id="1-445">                <span class="s2">&quot;[Profiling] Discarding profile because transaction is discarded.&quot;</span>
-</span><span id="1-446">            <span class="p">)</span>
-</span><span id="1-447">            <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span> <span class="o">=</span> <span class="kc">False</span>
-</span><span id="1-448">            <span class="k">return</span>
-</span><span id="1-449">
-</span><span id="1-450">        <span class="c1"># The profiler hasn&#39;t been properly initialized.</span>
-</span><span id="1-451">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">scheduler</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-452">            <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span>
-</span><span id="1-453">                <span class="s2">&quot;[Profiling] Discarding profile because profiler was not started.&quot;</span>
-</span><span id="1-454">            <span class="p">)</span>
-</span><span id="1-455">            <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span> <span class="o">=</span> <span class="kc">False</span>
-</span><span id="1-456">            <span class="k">return</span>
-</span><span id="1-457">
-</span><span id="1-458">        <span class="n">hub</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">hub</span> <span class="ow">or</span> <span class="n">sentry_sdk</span><span class="o">.</span><span class="n">Hub</span><span class="o">.</span><span class="n">current</span>
-</span><span id="1-459">        <span class="n">client</span> <span class="o">=</span> <span class="n">hub</span><span class="o">.</span><span class="n">client</span>
-</span><span id="1-460">
-</span><span id="1-461">        <span class="c1"># The client is None, so we can&#39;t get the sample rate.</span>
-</span><span id="1-462">        <span class="k">if</span> <span class="n">client</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-463">            <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span> <span class="o">=</span> <span class="kc">False</span>
-</span><span id="1-464">            <span class="k">return</span>
-</span><span id="1-465">
-</span><span id="1-466">        <span class="n">options</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="n">options</span>
-</span><span id="1-467">
-</span><span id="1-468">        <span class="k">if</span> <span class="nb">callable</span><span class="p">(</span><span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;profiles_sampler&quot;</span><span class="p">)):</span>
-</span><span id="1-469">            <span class="n">sample_rate</span> <span class="o">=</span> <span class="n">options</span><span class="p">[</span><span class="s2">&quot;profiles_sampler&quot;</span><span class="p">](</span><span class="n">sampling_context</span><span class="p">)</span>
-</span><span id="1-470">        <span class="k">elif</span> <span class="n">options</span><span class="p">[</span><span class="s2">&quot;profiles_sample_rate&quot;</span><span class="p">]</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-471">            <span class="n">sample_rate</span> <span class="o">=</span> <span class="n">options</span><span class="p">[</span><span class="s2">&quot;profiles_sample_rate&quot;</span><span class="p">]</span>
-</span><span id="1-472">        <span class="k">else</span><span class="p">:</span>
-</span><span id="1-473">            <span class="n">sample_rate</span> <span class="o">=</span> <span class="n">options</span><span class="p">[</span><span class="s2">&quot;_experiments&quot;</span><span class="p">]</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;profiles_sample_rate&quot;</span><span class="p">)</span>
-</span><span id="1-474">
-</span><span id="1-475">        <span class="c1"># The profiles_sample_rate option was not set, so profiling</span>
-</span><span id="1-476">        <span class="c1"># was never enabled.</span>
-</span><span id="1-477">        <span class="k">if</span> <span class="n">sample_rate</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-478">            <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span>
-</span><span id="1-479">                <span class="s2">&quot;[Profiling] Discarding profile because profiling was not enabled.&quot;</span>
-</span><span id="1-480">            <span class="p">)</span>
-</span><span id="1-481">            <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span> <span class="o">=</span> <span class="kc">False</span>
-</span><span id="1-482">            <span class="k">return</span>
-</span><span id="1-483">
-</span><span id="1-484">        <span class="k">if</span> <span class="ow">not</span> <span class="n">is_valid_sample_rate</span><span class="p">(</span><span class="n">sample_rate</span><span class="p">,</span> <span class="n">source</span><span class="o">=</span><span class="s2">&quot;Profiling&quot;</span><span class="p">):</span>
-</span><span id="1-485">            <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
-</span><span id="1-486">                <span class="s2">&quot;[Profiling] Discarding profile because of invalid sample rate.&quot;</span>
-</span><span id="1-487">            <span class="p">)</span>
-</span><span id="1-488">            <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span> <span class="o">=</span> <span class="kc">False</span>
-</span><span id="1-489">            <span class="k">return</span>
-</span><span id="1-490">
-</span><span id="1-491">        <span class="c1"># Now we roll the dice. random.random is inclusive of 0, but not of 1,</span>
-</span><span id="1-492">        <span class="c1"># so strict &lt; is safe here. In case sample_rate is a boolean, cast it</span>
-</span><span id="1-493">        <span class="c1"># to a float (True becomes 1.0 and False becomes 0.0)</span>
-</span><span id="1-494">        <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span> <span class="o">=</span> <span class="n">random</span><span class="o">.</span><span class="n">random</span><span class="p">()</span> <span class="o">&lt;</span> <span class="nb">float</span><span class="p">(</span><span class="n">sample_rate</span><span class="p">)</span>
-</span><span id="1-495">
-</span><span id="1-496">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span><span class="p">:</span>
-</span><span id="1-497">            <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;[Profiling] Initializing profile&quot;</span><span class="p">)</span>
-</span><span id="1-498">        <span class="k">else</span><span class="p">:</span>
-</span><span id="1-499">            <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span>
-</span><span id="1-500">                <span class="s2">&quot;[Profiling] Discarding profile because it&#39;s not included in the random sample (sample rate = </span><span class="si">{sample_rate}</span><span class="s2">)&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span>
-</span><span id="1-501">                    <span class="n">sample_rate</span><span class="o">=</span><span class="nb">float</span><span class="p">(</span><span class="n">sample_rate</span><span class="p">)</span>
-</span><span id="1-502">                <span class="p">)</span>
-</span><span id="1-503">            <span class="p">)</span>
-</span><span id="1-504">
-</span><span id="1-505">    <span class="k">def</span> <span class="nf">start</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-506">        <span class="c1"># type: () -&gt; None</span>
-</span><span id="1-507">        <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">active</span><span class="p">:</span>
-</span><span id="1-508">            <span class="k">return</span>
-</span><span id="1-509">
-</span><span id="1-510">        <span class="k">assert</span> <span class="bp">self</span><span class="o">.</span><span class="n">scheduler</span><span class="p">,</span> <span class="s2">&quot;No scheduler specified&quot;</span>
-</span><span id="1-511">        <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;[Profiling] Starting profile&quot;</span><span class="p">)</span>
-</span><span id="1-512">        <span class="bp">self</span><span class="o">.</span><span class="n">active</span> <span class="o">=</span> <span class="kc">True</span>
-</span><span id="1-513">        <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">start_ns</span><span class="p">:</span>
-</span><span id="1-514">            <span class="bp">self</span><span class="o">.</span><span class="n">start_ns</span> <span class="o">=</span> <span class="n">nanosecond_time</span><span class="p">()</span>
-</span><span id="1-515">        <span class="bp">self</span><span class="o">.</span><span class="n">scheduler</span><span class="o">.</span><span class="n">start_profiling</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-</span><span id="1-516">
-</span><span id="1-517">    <span class="k">def</span> <span class="nf">stop</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-518">        <span class="c1"># type: () -&gt; None</span>
-</span><span id="1-519">        <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span> <span class="ow">or</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">active</span><span class="p">:</span>
-</span><span id="1-520">            <span class="k">return</span>
-</span><span id="1-521">
-</span><span id="1-522">        <span class="k">assert</span> <span class="bp">self</span><span class="o">.</span><span class="n">scheduler</span><span class="p">,</span> <span class="s2">&quot;No scheduler specified&quot;</span>
-</span><span id="1-523">        <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;[Profiling] Stopping profile&quot;</span><span class="p">)</span>
-</span><span id="1-524">        <span class="bp">self</span><span class="o">.</span><span class="n">active</span> <span class="o">=</span> <span class="kc">False</span>
-</span><span id="1-525">        <span class="bp">self</span><span class="o">.</span><span class="n">scheduler</span><span class="o">.</span><span class="n">stop_profiling</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-</span><span id="1-526">        <span class="bp">self</span><span class="o">.</span><span class="n">stop_ns</span> <span class="o">=</span> <span class="n">nanosecond_time</span><span class="p">()</span>
-</span><span id="1-527">
-</span><span id="1-528">    <span class="k">def</span> <span class="fm">__enter__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-529">        <span class="c1"># type: () -&gt; Profile</span>
-</span><span id="1-530">        <span class="n">hub</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">hub</span> <span class="ow">or</span> <span class="n">sentry_sdk</span><span class="o">.</span><span class="n">Hub</span><span class="o">.</span><span class="n">current</span>
-</span><span id="1-531">
-</span><span id="1-532">        <span class="n">_</span><span class="p">,</span> <span class="n">scope</span> <span class="o">=</span> <span class="n">hub</span><span class="o">.</span><span class="n">_stack</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span>
+</span><span id="1-441"><span class="sd">        1. If the transaction to be profiled is not sampled, that decision</span>
+</span><span id="1-442"><span class="sd">        will be used, regardless of anything else.</span>
+</span><span id="1-443">
+</span><span id="1-444"><span class="sd">        2. Use `profiles_sample_rate` to decide.</span>
+</span><span id="1-445"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-446">
+</span><span id="1-447">        <span class="c1"># The corresponding transaction was not sampled,</span>
+</span><span id="1-448">        <span class="c1"># so don&#39;t generate a profile for it.</span>
+</span><span id="1-449">        <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span><span class="p">:</span>
+</span><span id="1-450">            <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span>
+</span><span id="1-451">                <span class="s2">&quot;[Profiling] Discarding profile because transaction is discarded.&quot;</span>
+</span><span id="1-452">            <span class="p">)</span>
+</span><span id="1-453">            <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span> <span class="o">=</span> <span class="kc">False</span>
+</span><span id="1-454">            <span class="k">return</span>
+</span><span id="1-455">
+</span><span id="1-456">        <span class="c1"># The profiler hasn&#39;t been properly initialized.</span>
+</span><span id="1-457">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">scheduler</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-458">            <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span>
+</span><span id="1-459">                <span class="s2">&quot;[Profiling] Discarding profile because profiler was not started.&quot;</span>
+</span><span id="1-460">            <span class="p">)</span>
+</span><span id="1-461">            <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span> <span class="o">=</span> <span class="kc">False</span>
+</span><span id="1-462">            <span class="k">return</span>
+</span><span id="1-463">
+</span><span id="1-464">        <span class="n">client</span> <span class="o">=</span> <span class="n">sentry_sdk</span><span class="o">.</span><span class="n">Scope</span><span class="o">.</span><span class="n">get_client</span><span class="p">()</span>
+</span><span id="1-465">        <span class="k">if</span> <span class="ow">not</span> <span class="n">client</span><span class="o">.</span><span class="n">is_active</span><span class="p">():</span>
+</span><span id="1-466">            <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span> <span class="o">=</span> <span class="kc">False</span>
+</span><span id="1-467">            <span class="k">return</span>
+</span><span id="1-468">
+</span><span id="1-469">        <span class="n">options</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="n">options</span>
+</span><span id="1-470">
+</span><span id="1-471">        <span class="k">if</span> <span class="nb">callable</span><span class="p">(</span><span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;profiles_sampler&quot;</span><span class="p">)):</span>
+</span><span id="1-472">            <span class="n">sample_rate</span> <span class="o">=</span> <span class="n">options</span><span class="p">[</span><span class="s2">&quot;profiles_sampler&quot;</span><span class="p">](</span><span class="n">sampling_context</span><span class="p">)</span>
+</span><span id="1-473">        <span class="k">elif</span> <span class="n">options</span><span class="p">[</span><span class="s2">&quot;profiles_sample_rate&quot;</span><span class="p">]</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-474">            <span class="n">sample_rate</span> <span class="o">=</span> <span class="n">options</span><span class="p">[</span><span class="s2">&quot;profiles_sample_rate&quot;</span><span class="p">]</span>
+</span><span id="1-475">        <span class="k">else</span><span class="p">:</span>
+</span><span id="1-476">            <span class="n">sample_rate</span> <span class="o">=</span> <span class="n">options</span><span class="p">[</span><span class="s2">&quot;_experiments&quot;</span><span class="p">]</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;profiles_sample_rate&quot;</span><span class="p">)</span>
+</span><span id="1-477">
+</span><span id="1-478">        <span class="c1"># The profiles_sample_rate option was not set, so profiling</span>
+</span><span id="1-479">        <span class="c1"># was never enabled.</span>
+</span><span id="1-480">        <span class="k">if</span> <span class="n">sample_rate</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-481">            <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span>
+</span><span id="1-482">                <span class="s2">&quot;[Profiling] Discarding profile because profiling was not enabled.&quot;</span>
+</span><span id="1-483">            <span class="p">)</span>
+</span><span id="1-484">            <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span> <span class="o">=</span> <span class="kc">False</span>
+</span><span id="1-485">            <span class="k">return</span>
+</span><span id="1-486">
+</span><span id="1-487">        <span class="k">if</span> <span class="ow">not</span> <span class="n">is_valid_sample_rate</span><span class="p">(</span><span class="n">sample_rate</span><span class="p">,</span> <span class="n">source</span><span class="o">=</span><span class="s2">&quot;Profiling&quot;</span><span class="p">):</span>
+</span><span id="1-488">            <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
+</span><span id="1-489">                <span class="s2">&quot;[Profiling] Discarding profile because of invalid sample rate.&quot;</span>
+</span><span id="1-490">            <span class="p">)</span>
+</span><span id="1-491">            <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span> <span class="o">=</span> <span class="kc">False</span>
+</span><span id="1-492">            <span class="k">return</span>
+</span><span id="1-493">
+</span><span id="1-494">        <span class="c1"># Now we roll the dice. random.random is inclusive of 0, but not of 1,</span>
+</span><span id="1-495">        <span class="c1"># so strict &lt; is safe here. In case sample_rate is a boolean, cast it</span>
+</span><span id="1-496">        <span class="c1"># to a float (True becomes 1.0 and False becomes 0.0)</span>
+</span><span id="1-497">        <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span> <span class="o">=</span> <span class="n">random</span><span class="o">.</span><span class="n">random</span><span class="p">()</span> <span class="o">&lt;</span> <span class="nb">float</span><span class="p">(</span><span class="n">sample_rate</span><span class="p">)</span>
+</span><span id="1-498">
+</span><span id="1-499">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span><span class="p">:</span>
+</span><span id="1-500">            <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;[Profiling] Initializing profile&quot;</span><span class="p">)</span>
+</span><span id="1-501">        <span class="k">else</span><span class="p">:</span>
+</span><span id="1-502">            <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span>
+</span><span id="1-503">                <span class="s2">&quot;[Profiling] Discarding profile because it&#39;s not included in the random sample (sample rate = </span><span class="si">{sample_rate}</span><span class="s2">)&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span>
+</span><span id="1-504">                    <span class="n">sample_rate</span><span class="o">=</span><span class="nb">float</span><span class="p">(</span><span class="n">sample_rate</span><span class="p">)</span>
+</span><span id="1-505">                <span class="p">)</span>
+</span><span id="1-506">            <span class="p">)</span>
+</span><span id="1-507">
+</span><span id="1-508">    <span class="k">def</span> <span class="nf">start</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-509">        <span class="c1"># type: () -&gt; None</span>
+</span><span id="1-510">        <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">active</span><span class="p">:</span>
+</span><span id="1-511">            <span class="k">return</span>
+</span><span id="1-512">
+</span><span id="1-513">        <span class="k">assert</span> <span class="bp">self</span><span class="o">.</span><span class="n">scheduler</span><span class="p">,</span> <span class="s2">&quot;No scheduler specified&quot;</span>
+</span><span id="1-514">        <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;[Profiling] Starting profile&quot;</span><span class="p">)</span>
+</span><span id="1-515">        <span class="bp">self</span><span class="o">.</span><span class="n">active</span> <span class="o">=</span> <span class="kc">True</span>
+</span><span id="1-516">        <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">start_ns</span><span class="p">:</span>
+</span><span id="1-517">            <span class="bp">self</span><span class="o">.</span><span class="n">start_ns</span> <span class="o">=</span> <span class="n">nanosecond_time</span><span class="p">()</span>
+</span><span id="1-518">        <span class="bp">self</span><span class="o">.</span><span class="n">scheduler</span><span class="o">.</span><span class="n">start_profiling</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
+</span><span id="1-519">
+</span><span id="1-520">    <span class="k">def</span> <span class="nf">stop</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-521">        <span class="c1"># type: () -&gt; None</span>
+</span><span id="1-522">        <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span> <span class="ow">or</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">active</span><span class="p">:</span>
+</span><span id="1-523">            <span class="k">return</span>
+</span><span id="1-524">
+</span><span id="1-525">        <span class="k">assert</span> <span class="bp">self</span><span class="o">.</span><span class="n">scheduler</span><span class="p">,</span> <span class="s2">&quot;No scheduler specified&quot;</span>
+</span><span id="1-526">        <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;[Profiling] Stopping profile&quot;</span><span class="p">)</span>
+</span><span id="1-527">        <span class="bp">self</span><span class="o">.</span><span class="n">active</span> <span class="o">=</span> <span class="kc">False</span>
+</span><span id="1-528">        <span class="bp">self</span><span class="o">.</span><span class="n">stop_ns</span> <span class="o">=</span> <span class="n">nanosecond_time</span><span class="p">()</span>
+</span><span id="1-529">
+</span><span id="1-530">    <span class="k">def</span> <span class="fm">__enter__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-531">        <span class="c1"># type: () -&gt; Profile</span>
+</span><span id="1-532">        <span class="n">scope</span> <span class="o">=</span> <span class="n">sentry_sdk</span><span class="o">.</span><span class="n">scope</span><span class="o">.</span><span class="n">Scope</span><span class="o">.</span><span class="n">get_isolation_scope</span><span class="p">()</span>
 </span><span id="1-533">        <span class="n">old_profile</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">profile</span>
 </span><span id="1-534">        <span class="n">scope</span><span class="o">.</span><span class="n">profile</span> <span class="o">=</span> <span class="bp">self</span>
 </span><span id="1-535">
-</span><span id="1-536">        <span class="bp">self</span><span class="o">.</span><span class="n">_context_manager_state</span> <span class="o">=</span> <span class="p">(</span><span class="n">hub</span><span class="p">,</span> <span class="n">scope</span><span class="p">,</span> <span class="n">old_profile</span><span class="p">)</span>
+</span><span id="1-536">        <span class="bp">self</span><span class="o">.</span><span class="n">_context_manager_state</span> <span class="o">=</span> <span class="p">(</span><span class="n">scope</span><span class="p">,</span> <span class="n">old_profile</span><span class="p">)</span>
 </span><span id="1-537">
 </span><span id="1-538">        <span class="bp">self</span><span class="o">.</span><span class="n">start</span><span class="p">()</span>
 </span><span id="1-539">
@@ -679,7 +679,7 @@ <h1>Source code for sentry_sdk.profiler</h1><div class="highlight"><pre>
 </span><span id="1-543">        <span class="c1"># type: (Optional[Any], Optional[Any], Optional[Any]) -&gt; None</span>
 </span><span id="1-544">        <span class="bp">self</span><span class="o">.</span><span class="n">stop</span><span class="p">()</span>
 </span><span id="1-545">
-</span><span id="1-546">        <span class="n">_</span><span class="p">,</span> <span class="n">scope</span><span class="p">,</span> <span class="n">old_profile</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_context_manager_state</span>
+</span><span id="1-546">        <span class="n">scope</span><span class="p">,</span> <span class="n">old_profile</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_context_manager_state</span>
 </span><span id="1-547">        <span class="k">del</span> <span class="bp">self</span><span class="o">.</span><span class="n">_context_manager_state</span>
 </span><span id="1-548">
 </span><span id="1-549">        <span class="n">scope</span><span class="o">.</span><span class="n">profile</span> <span class="o">=</span> <span class="n">old_profile</span>
@@ -801,327 +801,329 @@ <h1>Source code for sentry_sdk.profiler</h1><div class="highlight"><pre>
 </span><span id="1-665">
 </span><span id="1-666">    <span class="k">def</span> <span class="nf">valid</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 </span><span id="1-667">        <span class="c1"># type: () -&gt; bool</span>
-</span><span id="1-668">        <span class="n">hub</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">hub</span> <span class="ow">or</span> <span class="n">sentry_sdk</span><span class="o">.</span><span class="n">Hub</span><span class="o">.</span><span class="n">current</span>
-</span><span id="1-669">        <span class="n">client</span> <span class="o">=</span> <span class="n">hub</span><span class="o">.</span><span class="n">client</span>
-</span><span id="1-670">        <span class="k">if</span> <span class="n">client</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-671">            <span class="k">return</span> <span class="kc">False</span>
-</span><span id="1-672">
-</span><span id="1-673">        <span class="k">if</span> <span class="ow">not</span> <span class="n">has_profiling_enabled</span><span class="p">(</span><span class="n">client</span><span class="o">.</span><span class="n">options</span><span class="p">):</span>
-</span><span id="1-674">            <span class="k">return</span> <span class="kc">False</span>
-</span><span id="1-675">
-</span><span id="1-676">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span> <span class="ow">is</span> <span class="kc">None</span> <span class="ow">or</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span><span class="p">:</span>
-</span><span id="1-677">            <span class="k">if</span> <span class="n">client</span><span class="o">.</span><span class="n">transport</span><span class="p">:</span>
-</span><span id="1-678">                <span class="n">client</span><span class="o">.</span><span class="n">transport</span><span class="o">.</span><span class="n">record_lost_event</span><span class="p">(</span>
-</span><span id="1-679">                    <span class="s2">&quot;sample_rate&quot;</span><span class="p">,</span> <span class="n">data_category</span><span class="o">=</span><span class="s2">&quot;profile&quot;</span>
-</span><span id="1-680">                <span class="p">)</span>
-</span><span id="1-681">            <span class="k">return</span> <span class="kc">False</span>
-</span><span id="1-682">
-</span><span id="1-683">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">unique_samples</span> <span class="o">&lt;</span> <span class="n">PROFILE_MINIMUM_SAMPLES</span><span class="p">:</span>
-</span><span id="1-684">            <span class="k">if</span> <span class="n">client</span><span class="o">.</span><span class="n">transport</span><span class="p">:</span>
-</span><span id="1-685">                <span class="n">client</span><span class="o">.</span><span class="n">transport</span><span class="o">.</span><span class="n">record_lost_event</span><span class="p">(</span>
-</span><span id="1-686">                    <span class="s2">&quot;insufficient_data&quot;</span><span class="p">,</span> <span class="n">data_category</span><span class="o">=</span><span class="s2">&quot;profile&quot;</span>
-</span><span id="1-687">                <span class="p">)</span>
-</span><span id="1-688">            <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;[Profiling] Discarding profile because insufficient samples.&quot;</span><span class="p">)</span>
-</span><span id="1-689">            <span class="k">return</span> <span class="kc">False</span>
-</span><span id="1-690">
-</span><span id="1-691">        <span class="k">return</span> <span class="kc">True</span></div>
+</span><span id="1-668">        <span class="n">client</span> <span class="o">=</span> <span class="n">sentry_sdk</span><span class="o">.</span><span class="n">Scope</span><span class="o">.</span><span class="n">get_client</span><span class="p">()</span>
+</span><span id="1-669">        <span class="k">if</span> <span class="ow">not</span> <span class="n">client</span><span class="o">.</span><span class="n">is_active</span><span class="p">():</span>
+</span><span id="1-670">            <span class="k">return</span> <span class="kc">False</span>
+</span><span id="1-671">
+</span><span id="1-672">        <span class="k">if</span> <span class="ow">not</span> <span class="n">has_profiling_enabled</span><span class="p">(</span><span class="n">client</span><span class="o">.</span><span class="n">options</span><span class="p">):</span>
+</span><span id="1-673">            <span class="k">return</span> <span class="kc">False</span>
+</span><span id="1-674">
+</span><span id="1-675">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span> <span class="ow">is</span> <span class="kc">None</span> <span class="ow">or</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span><span class="p">:</span>
+</span><span id="1-676">            <span class="k">if</span> <span class="n">client</span><span class="o">.</span><span class="n">transport</span><span class="p">:</span>
+</span><span id="1-677">                <span class="n">client</span><span class="o">.</span><span class="n">transport</span><span class="o">.</span><span class="n">record_lost_event</span><span class="p">(</span>
+</span><span id="1-678">                    <span class="s2">&quot;sample_rate&quot;</span><span class="p">,</span> <span class="n">data_category</span><span class="o">=</span><span class="s2">&quot;profile&quot;</span>
+</span><span id="1-679">                <span class="p">)</span>
+</span><span id="1-680">            <span class="k">return</span> <span class="kc">False</span>
+</span><span id="1-681">
+</span><span id="1-682">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">unique_samples</span> <span class="o">&lt;</span> <span class="n">PROFILE_MINIMUM_SAMPLES</span><span class="p">:</span>
+</span><span id="1-683">            <span class="k">if</span> <span class="n">client</span><span class="o">.</span><span class="n">transport</span><span class="p">:</span>
+</span><span id="1-684">                <span class="n">client</span><span class="o">.</span><span class="n">transport</span><span class="o">.</span><span class="n">record_lost_event</span><span class="p">(</span>
+</span><span id="1-685">                    <span class="s2">&quot;insufficient_data&quot;</span><span class="p">,</span> <span class="n">data_category</span><span class="o">=</span><span class="s2">&quot;profile&quot;</span>
+</span><span id="1-686">                <span class="p">)</span>
+</span><span id="1-687">            <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;[Profiling] Discarding profile because insufficient samples.&quot;</span><span class="p">)</span>
+</span><span id="1-688">            <span class="k">return</span> <span class="kc">False</span>
+</span><span id="1-689">
+</span><span id="1-690">        <span class="k">return</span> <span class="kc">True</span></div>
 
+</span><span id="1-691">
 </span><span id="1-692">
-</span><span id="1-693">
-</span><span id="1-694"><span class="k">class</span> <span class="nc">Scheduler</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-</span><span id="1-695">    <span class="n">mode</span> <span class="o">=</span> <span class="s2">&quot;unknown&quot;</span>  <span class="c1"># type: ProfilerMode</span>
-</span><span id="1-696">
-</span><span id="1-697">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">frequency</span><span class="p">):</span>
-</span><span id="1-698">        <span class="c1"># type: (int) -&gt; None</span>
-</span><span id="1-699">        <span class="bp">self</span><span class="o">.</span><span class="n">interval</span> <span class="o">=</span> <span class="mf">1.0</span> <span class="o">/</span> <span class="n">frequency</span>
-</span><span id="1-700">
-</span><span id="1-701">        <span class="bp">self</span><span class="o">.</span><span class="n">sampler</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">make_sampler</span><span class="p">()</span>
-</span><span id="1-702">
-</span><span id="1-703">        <span class="c1"># cap the number of new profiles at any time so it does not grow infinitely</span>
-</span><span id="1-704">        <span class="bp">self</span><span class="o">.</span><span class="n">new_profiles</span> <span class="o">=</span> <span class="n">deque</span><span class="p">(</span><span class="n">maxlen</span><span class="o">=</span><span class="mi">128</span><span class="p">)</span>  <span class="c1"># type: Deque[Profile]</span>
-</span><span id="1-705">        <span class="bp">self</span><span class="o">.</span><span class="n">active_profiles</span> <span class="o">=</span> <span class="nb">set</span><span class="p">()</span>  <span class="c1"># type: Set[Profile]</span>
-</span><span id="1-706">
-</span><span id="1-707">    <span class="k">def</span> <span class="fm">__enter__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-708">        <span class="c1"># type: () -&gt; Scheduler</span>
-</span><span id="1-709">        <span class="bp">self</span><span class="o">.</span><span class="n">setup</span><span class="p">()</span>
-</span><span id="1-710">        <span class="k">return</span> <span class="bp">self</span>
-</span><span id="1-711">
-</span><span id="1-712">    <span class="k">def</span> <span class="fm">__exit__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">ty</span><span class="p">,</span> <span class="n">value</span><span class="p">,</span> <span class="n">tb</span><span class="p">):</span>
-</span><span id="1-713">        <span class="c1"># type: (Optional[Any], Optional[Any], Optional[Any]) -&gt; None</span>
-</span><span id="1-714">        <span class="bp">self</span><span class="o">.</span><span class="n">teardown</span><span class="p">()</span>
-</span><span id="1-715">
+</span><span id="1-693"><span class="k">class</span> <span class="nc">Scheduler</span><span class="p">(</span><span class="n">ABC</span><span class="p">):</span>
+</span><span id="1-694">    <span class="n">mode</span> <span class="o">=</span> <span class="s2">&quot;unknown&quot;</span>  <span class="c1"># type: ProfilerMode</span>
+</span><span id="1-695">
+</span><span id="1-696">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">frequency</span><span class="p">):</span>
+</span><span id="1-697">        <span class="c1"># type: (int) -&gt; None</span>
+</span><span id="1-698">        <span class="bp">self</span><span class="o">.</span><span class="n">interval</span> <span class="o">=</span> <span class="mf">1.0</span> <span class="o">/</span> <span class="n">frequency</span>
+</span><span id="1-699">
+</span><span id="1-700">        <span class="bp">self</span><span class="o">.</span><span class="n">sampler</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">make_sampler</span><span class="p">()</span>
+</span><span id="1-701">
+</span><span id="1-702">        <span class="c1"># cap the number of new profiles at any time so it does not grow infinitely</span>
+</span><span id="1-703">        <span class="bp">self</span><span class="o">.</span><span class="n">new_profiles</span> <span class="o">=</span> <span class="n">deque</span><span class="p">(</span><span class="n">maxlen</span><span class="o">=</span><span class="mi">128</span><span class="p">)</span>  <span class="c1"># type: Deque[Profile]</span>
+</span><span id="1-704">        <span class="bp">self</span><span class="o">.</span><span class="n">active_profiles</span> <span class="o">=</span> <span class="nb">set</span><span class="p">()</span>  <span class="c1"># type: Set[Profile]</span>
+</span><span id="1-705">
+</span><span id="1-706">    <span class="k">def</span> <span class="fm">__enter__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-707">        <span class="c1"># type: () -&gt; Scheduler</span>
+</span><span id="1-708">        <span class="bp">self</span><span class="o">.</span><span class="n">setup</span><span class="p">()</span>
+</span><span id="1-709">        <span class="k">return</span> <span class="bp">self</span>
+</span><span id="1-710">
+</span><span id="1-711">    <span class="k">def</span> <span class="fm">__exit__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">ty</span><span class="p">,</span> <span class="n">value</span><span class="p">,</span> <span class="n">tb</span><span class="p">):</span>
+</span><span id="1-712">        <span class="c1"># type: (Optional[Any], Optional[Any], Optional[Any]) -&gt; None</span>
+</span><span id="1-713">        <span class="bp">self</span><span class="o">.</span><span class="n">teardown</span><span class="p">()</span>
+</span><span id="1-714">
+</span><span id="1-715">    <span class="nd">@abstractmethod</span>
 </span><span id="1-716">    <span class="k">def</span> <span class="nf">setup</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
 </span><span id="1-717">        <span class="c1"># type: () -&gt; None</span>
-</span><span id="1-718">        <span class="k">raise</span> <span class="ne">NotImplementedError</span>
+</span><span id="1-718">        <span class="k">pass</span>
 </span><span id="1-719">
-</span><span id="1-720">    <span class="k">def</span> <span class="nf">teardown</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-721">        <span class="c1"># type: () -&gt; None</span>
-</span><span id="1-722">        <span class="k">raise</span> <span class="ne">NotImplementedError</span>
-</span><span id="1-723">
-</span><span id="1-724">    <span class="k">def</span> <span class="nf">ensure_running</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-725">        <span class="c1"># type: () -&gt; None</span>
-</span><span id="1-726">        <span class="k">raise</span> <span class="ne">NotImplementedError</span>
-</span><span id="1-727">
-</span><span id="1-728">    <span class="k">def</span> <span class="nf">start_profiling</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">profile</span><span class="p">):</span>
-</span><span id="1-729">        <span class="c1"># type: (Profile) -&gt; None</span>
-</span><span id="1-730">        <span class="bp">self</span><span class="o">.</span><span class="n">ensure_running</span><span class="p">()</span>
-</span><span id="1-731">        <span class="bp">self</span><span class="o">.</span><span class="n">new_profiles</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">profile</span><span class="p">)</span>
-</span><span id="1-732">
-</span><span id="1-733">    <span class="k">def</span> <span class="nf">stop_profiling</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">profile</span><span class="p">):</span>
-</span><span id="1-734">        <span class="c1"># type: (Profile) -&gt; None</span>
-</span><span id="1-735">        <span class="k">pass</span>
-</span><span id="1-736">
-</span><span id="1-737">    <span class="k">def</span> <span class="nf">make_sampler</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-738">        <span class="c1"># type: () -&gt; Callable[..., None]</span>
-</span><span id="1-739">        <span class="n">cwd</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">getcwd</span><span class="p">()</span>
-</span><span id="1-740">
-</span><span id="1-741">        <span class="n">cache</span> <span class="o">=</span> <span class="n">LRUCache</span><span class="p">(</span><span class="n">max_size</span><span class="o">=</span><span class="mi">256</span><span class="p">)</span>
+</span><span id="1-720">    <span class="nd">@abstractmethod</span>
+</span><span id="1-721">    <span class="k">def</span> <span class="nf">teardown</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-722">        <span class="c1"># type: () -&gt; None</span>
+</span><span id="1-723">        <span class="k">pass</span>
+</span><span id="1-724">
+</span><span id="1-725">    <span class="k">def</span> <span class="nf">ensure_running</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-726">        <span class="c1"># type: () -&gt; None</span>
+</span><span id="1-727"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-728"><span class="sd">        Ensure the scheduler is running. By default, this method is a no-op.</span>
+</span><span id="1-729"><span class="sd">        The method should be overridden by any implementation for which it is</span>
+</span><span id="1-730"><span class="sd">        relevant.</span>
+</span><span id="1-731"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-732">        <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-733">
+</span><span id="1-734">    <span class="k">def</span> <span class="nf">start_profiling</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">profile</span><span class="p">):</span>
+</span><span id="1-735">        <span class="c1"># type: (Profile) -&gt; None</span>
+</span><span id="1-736">        <span class="bp">self</span><span class="o">.</span><span class="n">ensure_running</span><span class="p">()</span>
+</span><span id="1-737">        <span class="bp">self</span><span class="o">.</span><span class="n">new_profiles</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">profile</span><span class="p">)</span>
+</span><span id="1-738">
+</span><span id="1-739">    <span class="k">def</span> <span class="nf">make_sampler</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-740">        <span class="c1"># type: () -&gt; Callable[..., None]</span>
+</span><span id="1-741">        <span class="n">cwd</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">getcwd</span><span class="p">()</span>
 </span><span id="1-742">
-</span><span id="1-743">        <span class="k">def</span> <span class="nf">_sample_stack</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-</span><span id="1-744">            <span class="c1"># type: (*Any, **Any) -&gt; None</span>
-</span><span id="1-745"><span class="w">            </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-746"><span class="sd">            Take a sample of the stack on all the threads in the process.</span>
-</span><span id="1-747"><span class="sd">            This should be called at a regular interval to collect samples.</span>
-</span><span id="1-748"><span class="sd">            &quot;&quot;&quot;</span>
-</span><span id="1-749">            <span class="c1"># no profiles taking place, so we can stop early</span>
-</span><span id="1-750">            <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">new_profiles</span> <span class="ow">and</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">active_profiles</span><span class="p">:</span>
-</span><span id="1-751">                <span class="c1"># make sure to clear the cache if we&#39;re not profiling so we dont</span>
-</span><span id="1-752">                <span class="c1"># keep a reference to the last stack of frames around</span>
-</span><span id="1-753">                <span class="k">return</span>
-</span><span id="1-754">
-</span><span id="1-755">            <span class="c1"># This is the number of profiles we want to pop off.</span>
-</span><span id="1-756">            <span class="c1"># It&#39;s possible another thread adds a new profile to</span>
-</span><span id="1-757">            <span class="c1"># the list and we spend longer than we want inside</span>
-</span><span id="1-758">            <span class="c1"># the loop below.</span>
-</span><span id="1-759">            <span class="c1">#</span>
-</span><span id="1-760">            <span class="c1"># Also make sure to set this value before extracting</span>
-</span><span id="1-761">            <span class="c1"># frames so we do not write to any new profiles that</span>
-</span><span id="1-762">            <span class="c1"># were started after this point.</span>
-</span><span id="1-763">            <span class="n">new_profiles</span> <span class="o">=</span> <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">new_profiles</span><span class="p">)</span>
-</span><span id="1-764">
-</span><span id="1-765">            <span class="n">now</span> <span class="o">=</span> <span class="n">nanosecond_time</span><span class="p">()</span>
+</span><span id="1-743">        <span class="n">cache</span> <span class="o">=</span> <span class="n">LRUCache</span><span class="p">(</span><span class="n">max_size</span><span class="o">=</span><span class="mi">256</span><span class="p">)</span>
+</span><span id="1-744">
+</span><span id="1-745">        <span class="k">def</span> <span class="nf">_sample_stack</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
+</span><span id="1-746">            <span class="c1"># type: (*Any, **Any) -&gt; None</span>
+</span><span id="1-747"><span class="w">            </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-748"><span class="sd">            Take a sample of the stack on all the threads in the process.</span>
+</span><span id="1-749"><span class="sd">            This should be called at a regular interval to collect samples.</span>
+</span><span id="1-750"><span class="sd">            &quot;&quot;&quot;</span>
+</span><span id="1-751">            <span class="c1"># no profiles taking place, so we can stop early</span>
+</span><span id="1-752">            <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">new_profiles</span> <span class="ow">and</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">active_profiles</span><span class="p">:</span>
+</span><span id="1-753">                <span class="c1"># make sure to clear the cache if we&#39;re not profiling so we dont</span>
+</span><span id="1-754">                <span class="c1"># keep a reference to the last stack of frames around</span>
+</span><span id="1-755">                <span class="k">return</span>
+</span><span id="1-756">
+</span><span id="1-757">            <span class="c1"># This is the number of profiles we want to pop off.</span>
+</span><span id="1-758">            <span class="c1"># It&#39;s possible another thread adds a new profile to</span>
+</span><span id="1-759">            <span class="c1"># the list and we spend longer than we want inside</span>
+</span><span id="1-760">            <span class="c1"># the loop below.</span>
+</span><span id="1-761">            <span class="c1">#</span>
+</span><span id="1-762">            <span class="c1"># Also make sure to set this value before extracting</span>
+</span><span id="1-763">            <span class="c1"># frames so we do not write to any new profiles that</span>
+</span><span id="1-764">            <span class="c1"># were started after this point.</span>
+</span><span id="1-765">            <span class="n">new_profiles</span> <span class="o">=</span> <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">new_profiles</span><span class="p">)</span>
 </span><span id="1-766">
-</span><span id="1-767">            <span class="k">try</span><span class="p">:</span>
-</span><span id="1-768">                <span class="n">sample</span> <span class="o">=</span> <span class="p">[</span>
-</span><span id="1-769">                    <span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">tid</span><span class="p">),</span> <span class="n">extract_stack</span><span class="p">(</span><span class="n">frame</span><span class="p">,</span> <span class="n">cache</span><span class="p">,</span> <span class="n">cwd</span><span class="p">))</span>
-</span><span id="1-770">                    <span class="k">for</span> <span class="n">tid</span><span class="p">,</span> <span class="n">frame</span> <span class="ow">in</span> <span class="n">sys</span><span class="o">.</span><span class="n">_current_frames</span><span class="p">()</span><span class="o">.</span><span class="n">items</span><span class="p">()</span>
-</span><span id="1-771">                <span class="p">]</span>
-</span><span id="1-772">            <span class="k">except</span> <span class="ne">AttributeError</span><span class="p">:</span>
-</span><span id="1-773">                <span class="c1"># For some reason, the frame we get doesn&#39;t have certain attributes.</span>
-</span><span id="1-774">                <span class="c1"># When this happens, we abandon the current sample as it&#39;s bad.</span>
-</span><span id="1-775">                <span class="n">capture_internal_exception</span><span class="p">(</span><span class="n">sys</span><span class="o">.</span><span class="n">exc_info</span><span class="p">())</span>
-</span><span id="1-776">                <span class="k">return</span>
-</span><span id="1-777">
-</span><span id="1-778">            <span class="c1"># Move the new profiles into the active_profiles set.</span>
-</span><span id="1-779">            <span class="c1">#</span>
-</span><span id="1-780">            <span class="c1"># We cannot directly add the to active_profiles set</span>
-</span><span id="1-781">            <span class="c1"># in `start_profiling` because it is called from other</span>
-</span><span id="1-782">            <span class="c1"># threads which can cause a RuntimeError when it the</span>
-</span><span id="1-783">            <span class="c1"># set sizes changes during iteration without a lock.</span>
-</span><span id="1-784">            <span class="c1">#</span>
-</span><span id="1-785">            <span class="c1"># We also want to avoid using a lock here so threads</span>
-</span><span id="1-786">            <span class="c1"># that are starting profiles are not blocked until it</span>
-</span><span id="1-787">            <span class="c1"># can acquire the lock.</span>
-</span><span id="1-788">            <span class="k">for</span> <span class="n">_</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">new_profiles</span><span class="p">):</span>
-</span><span id="1-789">                <span class="bp">self</span><span class="o">.</span><span class="n">active_profiles</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">new_profiles</span><span class="o">.</span><span class="n">popleft</span><span class="p">())</span>
-</span><span id="1-790">
-</span><span id="1-791">            <span class="n">inactive_profiles</span> <span class="o">=</span> <span class="p">[]</span>
+</span><span id="1-767">            <span class="n">now</span> <span class="o">=</span> <span class="n">nanosecond_time</span><span class="p">()</span>
+</span><span id="1-768">
+</span><span id="1-769">            <span class="k">try</span><span class="p">:</span>
+</span><span id="1-770">                <span class="n">sample</span> <span class="o">=</span> <span class="p">[</span>
+</span><span id="1-771">                    <span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">tid</span><span class="p">),</span> <span class="n">extract_stack</span><span class="p">(</span><span class="n">frame</span><span class="p">,</span> <span class="n">cache</span><span class="p">,</span> <span class="n">cwd</span><span class="p">))</span>
+</span><span id="1-772">                    <span class="k">for</span> <span class="n">tid</span><span class="p">,</span> <span class="n">frame</span> <span class="ow">in</span> <span class="n">sys</span><span class="o">.</span><span class="n">_current_frames</span><span class="p">()</span><span class="o">.</span><span class="n">items</span><span class="p">()</span>
+</span><span id="1-773">                <span class="p">]</span>
+</span><span id="1-774">            <span class="k">except</span> <span class="ne">AttributeError</span><span class="p">:</span>
+</span><span id="1-775">                <span class="c1"># For some reason, the frame we get doesn&#39;t have certain attributes.</span>
+</span><span id="1-776">                <span class="c1"># When this happens, we abandon the current sample as it&#39;s bad.</span>
+</span><span id="1-777">                <span class="n">capture_internal_exception</span><span class="p">(</span><span class="n">sys</span><span class="o">.</span><span class="n">exc_info</span><span class="p">())</span>
+</span><span id="1-778">                <span class="k">return</span>
+</span><span id="1-779">
+</span><span id="1-780">            <span class="c1"># Move the new profiles into the active_profiles set.</span>
+</span><span id="1-781">            <span class="c1">#</span>
+</span><span id="1-782">            <span class="c1"># We cannot directly add the to active_profiles set</span>
+</span><span id="1-783">            <span class="c1"># in `start_profiling` because it is called from other</span>
+</span><span id="1-784">            <span class="c1"># threads which can cause a RuntimeError when it the</span>
+</span><span id="1-785">            <span class="c1"># set sizes changes during iteration without a lock.</span>
+</span><span id="1-786">            <span class="c1">#</span>
+</span><span id="1-787">            <span class="c1"># We also want to avoid using a lock here so threads</span>
+</span><span id="1-788">            <span class="c1"># that are starting profiles are not blocked until it</span>
+</span><span id="1-789">            <span class="c1"># can acquire the lock.</span>
+</span><span id="1-790">            <span class="k">for</span> <span class="n">_</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="n">new_profiles</span><span class="p">):</span>
+</span><span id="1-791">                <span class="bp">self</span><span class="o">.</span><span class="n">active_profiles</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">new_profiles</span><span class="o">.</span><span class="n">popleft</span><span class="p">())</span>
 </span><span id="1-792">
-</span><span id="1-793">            <span class="k">for</span> <span class="n">profile</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">active_profiles</span><span class="p">:</span>
-</span><span id="1-794">                <span class="k">if</span> <span class="n">profile</span><span class="o">.</span><span class="n">active</span><span class="p">:</span>
-</span><span id="1-795">                    <span class="n">profile</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">now</span><span class="p">,</span> <span class="n">sample</span><span class="p">)</span>
-</span><span id="1-796">                <span class="k">else</span><span class="p">:</span>
-</span><span id="1-797">                    <span class="c1"># If a thread is marked inactive, we buffer it</span>
-</span><span id="1-798">                    <span class="c1"># to `inactive_profiles` so it can be removed.</span>
-</span><span id="1-799">                    <span class="c1"># We cannot remove it here as it would result</span>
-</span><span id="1-800">                    <span class="c1"># in a RuntimeError.</span>
-</span><span id="1-801">                    <span class="n">inactive_profiles</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">profile</span><span class="p">)</span>
-</span><span id="1-802">
-</span><span id="1-803">            <span class="k">for</span> <span class="n">profile</span> <span class="ow">in</span> <span class="n">inactive_profiles</span><span class="p">:</span>
-</span><span id="1-804">                <span class="bp">self</span><span class="o">.</span><span class="n">active_profiles</span><span class="o">.</span><span class="n">remove</span><span class="p">(</span><span class="n">profile</span><span class="p">)</span>
-</span><span id="1-805">
-</span><span id="1-806">        <span class="k">return</span> <span class="n">_sample_stack</span>
+</span><span id="1-793">            <span class="n">inactive_profiles</span> <span class="o">=</span> <span class="p">[]</span>
+</span><span id="1-794">
+</span><span id="1-795">            <span class="k">for</span> <span class="n">profile</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">active_profiles</span><span class="p">:</span>
+</span><span id="1-796">                <span class="k">if</span> <span class="n">profile</span><span class="o">.</span><span class="n">active</span><span class="p">:</span>
+</span><span id="1-797">                    <span class="n">profile</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">now</span><span class="p">,</span> <span class="n">sample</span><span class="p">)</span>
+</span><span id="1-798">                <span class="k">else</span><span class="p">:</span>
+</span><span id="1-799">                    <span class="c1"># If a thread is marked inactive, we buffer it</span>
+</span><span id="1-800">                    <span class="c1"># to `inactive_profiles` so it can be removed.</span>
+</span><span id="1-801">                    <span class="c1"># We cannot remove it here as it would result</span>
+</span><span id="1-802">                    <span class="c1"># in a RuntimeError.</span>
+</span><span id="1-803">                    <span class="n">inactive_profiles</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">profile</span><span class="p">)</span>
+</span><span id="1-804">
+</span><span id="1-805">            <span class="k">for</span> <span class="n">profile</span> <span class="ow">in</span> <span class="n">inactive_profiles</span><span class="p">:</span>
+</span><span id="1-806">                <span class="bp">self</span><span class="o">.</span><span class="n">active_profiles</span><span class="o">.</span><span class="n">remove</span><span class="p">(</span><span class="n">profile</span><span class="p">)</span>
 </span><span id="1-807">
-</span><span id="1-808">
-</span><span id="1-809"><span class="k">class</span> <span class="nc">ThreadScheduler</span><span class="p">(</span><span class="n">Scheduler</span><span class="p">):</span>
-</span><span id="1-810"><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-811"><span class="sd">    This scheduler is based on running a daemon thread that will call</span>
-</span><span id="1-812"><span class="sd">    the sampler at a regular interval.</span>
-</span><span id="1-813"><span class="sd">    &quot;&quot;&quot;</span>
-</span><span id="1-814">
-</span><span id="1-815">    <span class="n">mode</span> <span class="o">=</span> <span class="s2">&quot;thread&quot;</span>  <span class="c1"># type: ProfilerMode</span>
-</span><span id="1-816">    <span class="n">name</span> <span class="o">=</span> <span class="s2">&quot;sentry.profiler.ThreadScheduler&quot;</span>
-</span><span id="1-817">
-</span><span id="1-818">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">frequency</span><span class="p">):</span>
-</span><span id="1-819">        <span class="c1"># type: (int) -&gt; None</span>
-</span><span id="1-820">        <span class="nb">super</span><span class="p">(</span><span class="n">ThreadScheduler</span><span class="p">,</span> <span class="bp">self</span><span class="p">)</span><span class="o">.</span><span class="fm">__init__</span><span class="p">(</span><span class="n">frequency</span><span class="o">=</span><span class="n">frequency</span><span class="p">)</span>
-</span><span id="1-821">
-</span><span id="1-822">        <span class="c1"># used to signal to the thread that it should stop</span>
-</span><span id="1-823">        <span class="bp">self</span><span class="o">.</span><span class="n">running</span> <span class="o">=</span> <span class="kc">False</span>
-</span><span id="1-824">        <span class="bp">self</span><span class="o">.</span><span class="n">thread</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[threading.Thread]</span>
-</span><span id="1-825">        <span class="bp">self</span><span class="o">.</span><span class="n">pid</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[int]</span>
-</span><span id="1-826">        <span class="bp">self</span><span class="o">.</span><span class="n">lock</span> <span class="o">=</span> <span class="n">threading</span><span class="o">.</span><span class="n">Lock</span><span class="p">()</span>
-</span><span id="1-827">
-</span><span id="1-828">    <span class="k">def</span> <span class="nf">setup</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-829">        <span class="c1"># type: () -&gt; None</span>
-</span><span id="1-830">        <span class="k">pass</span>
-</span><span id="1-831">
-</span><span id="1-832">    <span class="k">def</span> <span class="nf">teardown</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-833">        <span class="c1"># type: () -&gt; None</span>
-</span><span id="1-834">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">running</span><span class="p">:</span>
-</span><span id="1-835">            <span class="bp">self</span><span class="o">.</span><span class="n">running</span> <span class="o">=</span> <span class="kc">False</span>
-</span><span id="1-836">            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">thread</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-837">                <span class="bp">self</span><span class="o">.</span><span class="n">thread</span><span class="o">.</span><span class="n">join</span><span class="p">()</span>
-</span><span id="1-838">
-</span><span id="1-839">    <span class="k">def</span> <span class="nf">ensure_running</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-840">        <span class="c1"># type: () -&gt; None</span>
-</span><span id="1-841"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-842"><span class="sd">        Check that the profiler has an active thread to run in, and start one if</span>
-</span><span id="1-843"><span class="sd">        that&#39;s not the case.</span>
-</span><span id="1-844">
-</span><span id="1-845"><span class="sd">        Note that this might fail (e.g. in Python 3.12 it&#39;s not possible to</span>
-</span><span id="1-846"><span class="sd">        spawn new threads at interpreter shutdown). In that case self.running</span>
-</span><span id="1-847"><span class="sd">        will be False after running this function.</span>
-</span><span id="1-848"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-849">        <span class="n">pid</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">getpid</span><span class="p">()</span>
-</span><span id="1-850">
-</span><span id="1-851">        <span class="c1"># is running on the right process</span>
-</span><span id="1-852">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">running</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">pid</span> <span class="o">==</span> <span class="n">pid</span><span class="p">:</span>
-</span><span id="1-853">            <span class="k">return</span>
-</span><span id="1-854">
-</span><span id="1-855">        <span class="k">with</span> <span class="bp">self</span><span class="o">.</span><span class="n">lock</span><span class="p">:</span>
-</span><span id="1-856">            <span class="c1"># another thread may have tried to acquire the lock</span>
-</span><span id="1-857">            <span class="c1"># at the same time so it may start another thread</span>
-</span><span id="1-858">            <span class="c1"># make sure to check again before proceeding</span>
-</span><span id="1-859">            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">running</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">pid</span> <span class="o">==</span> <span class="n">pid</span><span class="p">:</span>
-</span><span id="1-860">                <span class="k">return</span>
-</span><span id="1-861">
-</span><span id="1-862">            <span class="bp">self</span><span class="o">.</span><span class="n">pid</span> <span class="o">=</span> <span class="n">pid</span>
-</span><span id="1-863">            <span class="bp">self</span><span class="o">.</span><span class="n">running</span> <span class="o">=</span> <span class="kc">True</span>
-</span><span id="1-864">
-</span><span id="1-865">            <span class="c1"># make sure the thread is a daemon here otherwise this</span>
-</span><span id="1-866">            <span class="c1"># can keep the application running after other threads</span>
-</span><span id="1-867">            <span class="c1"># have exited</span>
-</span><span id="1-868">            <span class="bp">self</span><span class="o">.</span><span class="n">thread</span> <span class="o">=</span> <span class="n">threading</span><span class="o">.</span><span class="n">Thread</span><span class="p">(</span><span class="n">name</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">name</span><span class="p">,</span> <span class="n">target</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">run</span><span class="p">,</span> <span class="n">daemon</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
-</span><span id="1-869">            <span class="k">try</span><span class="p">:</span>
-</span><span id="1-870">                <span class="bp">self</span><span class="o">.</span><span class="n">thread</span><span class="o">.</span><span class="n">start</span><span class="p">()</span>
-</span><span id="1-871">            <span class="k">except</span> <span class="ne">RuntimeError</span><span class="p">:</span>
-</span><span id="1-872">                <span class="c1"># Unfortunately at this point the interpreter is in a state that no</span>
-</span><span id="1-873">                <span class="c1"># longer allows us to spawn a thread and we have to bail.</span>
-</span><span id="1-874">                <span class="bp">self</span><span class="o">.</span><span class="n">running</span> <span class="o">=</span> <span class="kc">False</span>
-</span><span id="1-875">                <span class="bp">self</span><span class="o">.</span><span class="n">thread</span> <span class="o">=</span> <span class="kc">None</span>
-</span><span id="1-876">                <span class="k">return</span>
-</span><span id="1-877">
-</span><span id="1-878">    <span class="k">def</span> <span class="nf">run</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-879">        <span class="c1"># type: () -&gt; None</span>
-</span><span id="1-880">        <span class="n">last</span> <span class="o">=</span> <span class="n">time</span><span class="o">.</span><span class="n">perf_counter</span><span class="p">()</span>
-</span><span id="1-881">
-</span><span id="1-882">        <span class="k">while</span> <span class="bp">self</span><span class="o">.</span><span class="n">running</span><span class="p">:</span>
-</span><span id="1-883">            <span class="bp">self</span><span class="o">.</span><span class="n">sampler</span><span class="p">()</span>
-</span><span id="1-884">
-</span><span id="1-885">            <span class="c1"># some time may have elapsed since the last time</span>
-</span><span id="1-886">            <span class="c1"># we sampled, so we need to account for that and</span>
-</span><span id="1-887">            <span class="c1"># not sleep for too long</span>
-</span><span id="1-888">            <span class="n">elapsed</span> <span class="o">=</span> <span class="n">time</span><span class="o">.</span><span class="n">perf_counter</span><span class="p">()</span> <span class="o">-</span> <span class="n">last</span>
-</span><span id="1-889">            <span class="k">if</span> <span class="n">elapsed</span> <span class="o">&lt;</span> <span class="bp">self</span><span class="o">.</span><span class="n">interval</span><span class="p">:</span>
-</span><span id="1-890">                <span class="n">thread_sleep</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">interval</span> <span class="o">-</span> <span class="n">elapsed</span><span class="p">)</span>
-</span><span id="1-891">
-</span><span id="1-892">            <span class="c1"># after sleeping, make sure to take the current</span>
-</span><span id="1-893">            <span class="c1"># timestamp so we can use it next iteration</span>
-</span><span id="1-894">            <span class="n">last</span> <span class="o">=</span> <span class="n">time</span><span class="o">.</span><span class="n">perf_counter</span><span class="p">()</span>
-</span><span id="1-895">
-</span><span id="1-896">
-</span><span id="1-897"><span class="k">class</span> <span class="nc">GeventScheduler</span><span class="p">(</span><span class="n">Scheduler</span><span class="p">):</span>
-</span><span id="1-898"><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-899"><span class="sd">    This scheduler is based on the thread scheduler but adapted to work with</span>
-</span><span id="1-900"><span class="sd">    gevent. When using gevent, it may monkey patch the threading modules</span>
-</span><span id="1-901"><span class="sd">    (`threading` and `_thread`). This results in the use of greenlets instead</span>
-</span><span id="1-902"><span class="sd">    of native threads.</span>
-</span><span id="1-903">
-</span><span id="1-904"><span class="sd">    This is an issue because the sampler CANNOT run in a greenlet because</span>
-</span><span id="1-905"><span class="sd">    1. Other greenlets doing sync work will prevent the sampler from running</span>
-</span><span id="1-906"><span class="sd">    2. The greenlet runs in the same thread as other greenlets so when taking</span>
-</span><span id="1-907"><span class="sd">       a sample, other greenlets will have been evicted from the thread. This</span>
-</span><span id="1-908"><span class="sd">       results in a sample containing only the sampler&#39;s code.</span>
-</span><span id="1-909"><span class="sd">    &quot;&quot;&quot;</span>
-</span><span id="1-910">
-</span><span id="1-911">    <span class="n">mode</span> <span class="o">=</span> <span class="s2">&quot;gevent&quot;</span>  <span class="c1"># type: ProfilerMode</span>
-</span><span id="1-912">    <span class="n">name</span> <span class="o">=</span> <span class="s2">&quot;sentry.profiler.GeventScheduler&quot;</span>
-</span><span id="1-913">
-</span><span id="1-914">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">frequency</span><span class="p">):</span>
-</span><span id="1-915">        <span class="c1"># type: (int) -&gt; None</span>
-</span><span id="1-916">
-</span><span id="1-917">        <span class="k">if</span> <span class="n">ThreadPool</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-918">            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">&quot;Profiler mode: </span><span class="si">{}</span><span class="s2"> is not available&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">mode</span><span class="p">))</span>
-</span><span id="1-919">
-</span><span id="1-920">        <span class="nb">super</span><span class="p">(</span><span class="n">GeventScheduler</span><span class="p">,</span> <span class="bp">self</span><span class="p">)</span><span class="o">.</span><span class="fm">__init__</span><span class="p">(</span><span class="n">frequency</span><span class="o">=</span><span class="n">frequency</span><span class="p">)</span>
+</span><span id="1-808">        <span class="k">return</span> <span class="n">_sample_stack</span>
+</span><span id="1-809">
+</span><span id="1-810">
+</span><span id="1-811"><span class="k">class</span> <span class="nc">ThreadScheduler</span><span class="p">(</span><span class="n">Scheduler</span><span class="p">):</span>
+</span><span id="1-812"><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-813"><span class="sd">    This scheduler is based on running a daemon thread that will call</span>
+</span><span id="1-814"><span class="sd">    the sampler at a regular interval.</span>
+</span><span id="1-815"><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="1-816">
+</span><span id="1-817">    <span class="n">mode</span> <span class="o">=</span> <span class="s2">&quot;thread&quot;</span>  <span class="c1"># type: ProfilerMode</span>
+</span><span id="1-818">    <span class="n">name</span> <span class="o">=</span> <span class="s2">&quot;sentry.profiler.ThreadScheduler&quot;</span>
+</span><span id="1-819">
+</span><span id="1-820">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">frequency</span><span class="p">):</span>
+</span><span id="1-821">        <span class="c1"># type: (int) -&gt; None</span>
+</span><span id="1-822">        <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="fm">__init__</span><span class="p">(</span><span class="n">frequency</span><span class="o">=</span><span class="n">frequency</span><span class="p">)</span>
+</span><span id="1-823">
+</span><span id="1-824">        <span class="c1"># used to signal to the thread that it should stop</span>
+</span><span id="1-825">        <span class="bp">self</span><span class="o">.</span><span class="n">running</span> <span class="o">=</span> <span class="kc">False</span>
+</span><span id="1-826">        <span class="bp">self</span><span class="o">.</span><span class="n">thread</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[threading.Thread]</span>
+</span><span id="1-827">        <span class="bp">self</span><span class="o">.</span><span class="n">pid</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[int]</span>
+</span><span id="1-828">        <span class="bp">self</span><span class="o">.</span><span class="n">lock</span> <span class="o">=</span> <span class="n">threading</span><span class="o">.</span><span class="n">Lock</span><span class="p">()</span>
+</span><span id="1-829">
+</span><span id="1-830">    <span class="k">def</span> <span class="nf">setup</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-831">        <span class="c1"># type: () -&gt; None</span>
+</span><span id="1-832">        <span class="k">pass</span>
+</span><span id="1-833">
+</span><span id="1-834">    <span class="k">def</span> <span class="nf">teardown</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-835">        <span class="c1"># type: () -&gt; None</span>
+</span><span id="1-836">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">running</span><span class="p">:</span>
+</span><span id="1-837">            <span class="bp">self</span><span class="o">.</span><span class="n">running</span> <span class="o">=</span> <span class="kc">False</span>
+</span><span id="1-838">            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">thread</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-839">                <span class="bp">self</span><span class="o">.</span><span class="n">thread</span><span class="o">.</span><span class="n">join</span><span class="p">()</span>
+</span><span id="1-840">
+</span><span id="1-841">    <span class="k">def</span> <span class="nf">ensure_running</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-842">        <span class="c1"># type: () -&gt; None</span>
+</span><span id="1-843"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-844"><span class="sd">        Check that the profiler has an active thread to run in, and start one if</span>
+</span><span id="1-845"><span class="sd">        that&#39;s not the case.</span>
+</span><span id="1-846">
+</span><span id="1-847"><span class="sd">        Note that this might fail (e.g. in Python 3.12 it&#39;s not possible to</span>
+</span><span id="1-848"><span class="sd">        spawn new threads at interpreter shutdown). In that case self.running</span>
+</span><span id="1-849"><span class="sd">        will be False after running this function.</span>
+</span><span id="1-850"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-851">        <span class="n">pid</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">getpid</span><span class="p">()</span>
+</span><span id="1-852">
+</span><span id="1-853">        <span class="c1"># is running on the right process</span>
+</span><span id="1-854">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">running</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">pid</span> <span class="o">==</span> <span class="n">pid</span><span class="p">:</span>
+</span><span id="1-855">            <span class="k">return</span>
+</span><span id="1-856">
+</span><span id="1-857">        <span class="k">with</span> <span class="bp">self</span><span class="o">.</span><span class="n">lock</span><span class="p">:</span>
+</span><span id="1-858">            <span class="c1"># another thread may have tried to acquire the lock</span>
+</span><span id="1-859">            <span class="c1"># at the same time so it may start another thread</span>
+</span><span id="1-860">            <span class="c1"># make sure to check again before proceeding</span>
+</span><span id="1-861">            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">running</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">pid</span> <span class="o">==</span> <span class="n">pid</span><span class="p">:</span>
+</span><span id="1-862">                <span class="k">return</span>
+</span><span id="1-863">
+</span><span id="1-864">            <span class="bp">self</span><span class="o">.</span><span class="n">pid</span> <span class="o">=</span> <span class="n">pid</span>
+</span><span id="1-865">            <span class="bp">self</span><span class="o">.</span><span class="n">running</span> <span class="o">=</span> <span class="kc">True</span>
+</span><span id="1-866">
+</span><span id="1-867">            <span class="c1"># make sure the thread is a daemon here otherwise this</span>
+</span><span id="1-868">            <span class="c1"># can keep the application running after other threads</span>
+</span><span id="1-869">            <span class="c1"># have exited</span>
+</span><span id="1-870">            <span class="bp">self</span><span class="o">.</span><span class="n">thread</span> <span class="o">=</span> <span class="n">threading</span><span class="o">.</span><span class="n">Thread</span><span class="p">(</span><span class="n">name</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">name</span><span class="p">,</span> <span class="n">target</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">run</span><span class="p">,</span> <span class="n">daemon</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
+</span><span id="1-871">            <span class="k">try</span><span class="p">:</span>
+</span><span id="1-872">                <span class="bp">self</span><span class="o">.</span><span class="n">thread</span><span class="o">.</span><span class="n">start</span><span class="p">()</span>
+</span><span id="1-873">            <span class="k">except</span> <span class="ne">RuntimeError</span><span class="p">:</span>
+</span><span id="1-874">                <span class="c1"># Unfortunately at this point the interpreter is in a state that no</span>
+</span><span id="1-875">                <span class="c1"># longer allows us to spawn a thread and we have to bail.</span>
+</span><span id="1-876">                <span class="bp">self</span><span class="o">.</span><span class="n">running</span> <span class="o">=</span> <span class="kc">False</span>
+</span><span id="1-877">                <span class="bp">self</span><span class="o">.</span><span class="n">thread</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="1-878">                <span class="k">return</span>
+</span><span id="1-879">
+</span><span id="1-880">    <span class="k">def</span> <span class="nf">run</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-881">        <span class="c1"># type: () -&gt; None</span>
+</span><span id="1-882">        <span class="n">last</span> <span class="o">=</span> <span class="n">time</span><span class="o">.</span><span class="n">perf_counter</span><span class="p">()</span>
+</span><span id="1-883">
+</span><span id="1-884">        <span class="k">while</span> <span class="bp">self</span><span class="o">.</span><span class="n">running</span><span class="p">:</span>
+</span><span id="1-885">            <span class="bp">self</span><span class="o">.</span><span class="n">sampler</span><span class="p">()</span>
+</span><span id="1-886">
+</span><span id="1-887">            <span class="c1"># some time may have elapsed since the last time</span>
+</span><span id="1-888">            <span class="c1"># we sampled, so we need to account for that and</span>
+</span><span id="1-889">            <span class="c1"># not sleep for too long</span>
+</span><span id="1-890">            <span class="n">elapsed</span> <span class="o">=</span> <span class="n">time</span><span class="o">.</span><span class="n">perf_counter</span><span class="p">()</span> <span class="o">-</span> <span class="n">last</span>
+</span><span id="1-891">            <span class="k">if</span> <span class="n">elapsed</span> <span class="o">&lt;</span> <span class="bp">self</span><span class="o">.</span><span class="n">interval</span><span class="p">:</span>
+</span><span id="1-892">                <span class="n">thread_sleep</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">interval</span> <span class="o">-</span> <span class="n">elapsed</span><span class="p">)</span>
+</span><span id="1-893">
+</span><span id="1-894">            <span class="c1"># after sleeping, make sure to take the current</span>
+</span><span id="1-895">            <span class="c1"># timestamp so we can use it next iteration</span>
+</span><span id="1-896">            <span class="n">last</span> <span class="o">=</span> <span class="n">time</span><span class="o">.</span><span class="n">perf_counter</span><span class="p">()</span>
+</span><span id="1-897">
+</span><span id="1-898">
+</span><span id="1-899"><span class="k">class</span> <span class="nc">GeventScheduler</span><span class="p">(</span><span class="n">Scheduler</span><span class="p">):</span>
+</span><span id="1-900"><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-901"><span class="sd">    This scheduler is based on the thread scheduler but adapted to work with</span>
+</span><span id="1-902"><span class="sd">    gevent. When using gevent, it may monkey patch the threading modules</span>
+</span><span id="1-903"><span class="sd">    (`threading` and `_thread`). This results in the use of greenlets instead</span>
+</span><span id="1-904"><span class="sd">    of native threads.</span>
+</span><span id="1-905">
+</span><span id="1-906"><span class="sd">    This is an issue because the sampler CANNOT run in a greenlet because</span>
+</span><span id="1-907"><span class="sd">    1. Other greenlets doing sync work will prevent the sampler from running</span>
+</span><span id="1-908"><span class="sd">    2. The greenlet runs in the same thread as other greenlets so when taking</span>
+</span><span id="1-909"><span class="sd">       a sample, other greenlets will have been evicted from the thread. This</span>
+</span><span id="1-910"><span class="sd">       results in a sample containing only the sampler&#39;s code.</span>
+</span><span id="1-911"><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="1-912">
+</span><span id="1-913">    <span class="n">mode</span> <span class="o">=</span> <span class="s2">&quot;gevent&quot;</span>  <span class="c1"># type: ProfilerMode</span>
+</span><span id="1-914">    <span class="n">name</span> <span class="o">=</span> <span class="s2">&quot;sentry.profiler.GeventScheduler&quot;</span>
+</span><span id="1-915">
+</span><span id="1-916">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">frequency</span><span class="p">):</span>
+</span><span id="1-917">        <span class="c1"># type: (int) -&gt; None</span>
+</span><span id="1-918">
+</span><span id="1-919">        <span class="k">if</span> <span class="n">ThreadPool</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-920">            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">&quot;Profiler mode: </span><span class="si">{}</span><span class="s2"> is not available&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">mode</span><span class="p">))</span>
 </span><span id="1-921">
-</span><span id="1-922">        <span class="c1"># used to signal to the thread that it should stop</span>
-</span><span id="1-923">        <span class="bp">self</span><span class="o">.</span><span class="n">running</span> <span class="o">=</span> <span class="kc">False</span>
-</span><span id="1-924">        <span class="bp">self</span><span class="o">.</span><span class="n">thread</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[ThreadPool]</span>
-</span><span id="1-925">        <span class="bp">self</span><span class="o">.</span><span class="n">pid</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[int]</span>
-</span><span id="1-926">
-</span><span id="1-927">        <span class="c1"># This intentionally uses the gevent patched threading.Lock.</span>
-</span><span id="1-928">        <span class="c1"># The lock will be required when first trying to start profiles</span>
-</span><span id="1-929">        <span class="c1"># as we need to spawn the profiler thread from the greenlets.</span>
-</span><span id="1-930">        <span class="bp">self</span><span class="o">.</span><span class="n">lock</span> <span class="o">=</span> <span class="n">threading</span><span class="o">.</span><span class="n">Lock</span><span class="p">()</span>
-</span><span id="1-931">
-</span><span id="1-932">    <span class="k">def</span> <span class="nf">setup</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-933">        <span class="c1"># type: () -&gt; None</span>
-</span><span id="1-934">        <span class="k">pass</span>
-</span><span id="1-935">
-</span><span id="1-936">    <span class="k">def</span> <span class="nf">teardown</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-937">        <span class="c1"># type: () -&gt; None</span>
-</span><span id="1-938">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">running</span><span class="p">:</span>
-</span><span id="1-939">            <span class="bp">self</span><span class="o">.</span><span class="n">running</span> <span class="o">=</span> <span class="kc">False</span>
-</span><span id="1-940">            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">thread</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-941">                <span class="bp">self</span><span class="o">.</span><span class="n">thread</span><span class="o">.</span><span class="n">join</span><span class="p">()</span>
-</span><span id="1-942">
-</span><span id="1-943">    <span class="k">def</span> <span class="nf">ensure_running</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-944">        <span class="c1"># type: () -&gt; None</span>
-</span><span id="1-945">        <span class="n">pid</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">getpid</span><span class="p">()</span>
-</span><span id="1-946">
-</span><span id="1-947">        <span class="c1"># is running on the right process</span>
-</span><span id="1-948">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">running</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">pid</span> <span class="o">==</span> <span class="n">pid</span><span class="p">:</span>
-</span><span id="1-949">            <span class="k">return</span>
-</span><span id="1-950">
-</span><span id="1-951">        <span class="k">with</span> <span class="bp">self</span><span class="o">.</span><span class="n">lock</span><span class="p">:</span>
-</span><span id="1-952">            <span class="c1"># another thread may have tried to acquire the lock</span>
-</span><span id="1-953">            <span class="c1"># at the same time so it may start another thread</span>
-</span><span id="1-954">            <span class="c1"># make sure to check again before proceeding</span>
-</span><span id="1-955">            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">running</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">pid</span> <span class="o">==</span> <span class="n">pid</span><span class="p">:</span>
-</span><span id="1-956">                <span class="k">return</span>
-</span><span id="1-957">
-</span><span id="1-958">            <span class="bp">self</span><span class="o">.</span><span class="n">pid</span> <span class="o">=</span> <span class="n">pid</span>
-</span><span id="1-959">            <span class="bp">self</span><span class="o">.</span><span class="n">running</span> <span class="o">=</span> <span class="kc">True</span>
-</span><span id="1-960">
-</span><span id="1-961">            <span class="bp">self</span><span class="o">.</span><span class="n">thread</span> <span class="o">=</span> <span class="n">ThreadPool</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span>
-</span><span id="1-962">            <span class="k">try</span><span class="p">:</span>
-</span><span id="1-963">                <span class="bp">self</span><span class="o">.</span><span class="n">thread</span><span class="o">.</span><span class="n">spawn</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">run</span><span class="p">)</span>
-</span><span id="1-964">            <span class="k">except</span> <span class="ne">RuntimeError</span><span class="p">:</span>
-</span><span id="1-965">                <span class="c1"># Unfortunately at this point the interpreter is in a state that no</span>
-</span><span id="1-966">                <span class="c1"># longer allows us to spawn a thread and we have to bail.</span>
-</span><span id="1-967">                <span class="bp">self</span><span class="o">.</span><span class="n">running</span> <span class="o">=</span> <span class="kc">False</span>
-</span><span id="1-968">                <span class="bp">self</span><span class="o">.</span><span class="n">thread</span> <span class="o">=</span> <span class="kc">None</span>
-</span><span id="1-969">                <span class="k">return</span>
-</span><span id="1-970">
-</span><span id="1-971">    <span class="k">def</span> <span class="nf">run</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-972">        <span class="c1"># type: () -&gt; None</span>
-</span><span id="1-973">        <span class="n">last</span> <span class="o">=</span> <span class="n">time</span><span class="o">.</span><span class="n">perf_counter</span><span class="p">()</span>
-</span><span id="1-974">
-</span><span id="1-975">        <span class="k">while</span> <span class="bp">self</span><span class="o">.</span><span class="n">running</span><span class="p">:</span>
-</span><span id="1-976">            <span class="bp">self</span><span class="o">.</span><span class="n">sampler</span><span class="p">()</span>
-</span><span id="1-977">
-</span><span id="1-978">            <span class="c1"># some time may have elapsed since the last time</span>
-</span><span id="1-979">            <span class="c1"># we sampled, so we need to account for that and</span>
-</span><span id="1-980">            <span class="c1"># not sleep for too long</span>
-</span><span id="1-981">            <span class="n">elapsed</span> <span class="o">=</span> <span class="n">time</span><span class="o">.</span><span class="n">perf_counter</span><span class="p">()</span> <span class="o">-</span> <span class="n">last</span>
-</span><span id="1-982">            <span class="k">if</span> <span class="n">elapsed</span> <span class="o">&lt;</span> <span class="bp">self</span><span class="o">.</span><span class="n">interval</span><span class="p">:</span>
-</span><span id="1-983">                <span class="n">thread_sleep</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">interval</span> <span class="o">-</span> <span class="n">elapsed</span><span class="p">)</span>
-</span><span id="1-984">
-</span><span id="1-985">            <span class="c1"># after sleeping, make sure to take the current</span>
-</span><span id="1-986">            <span class="c1"># timestamp so we can use it next iteration</span>
-</span><span id="1-987">            <span class="n">last</span> <span class="o">=</span> <span class="n">time</span><span class="o">.</span><span class="n">perf_counter</span><span class="p">()</span>
+</span><span id="1-922">        <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="fm">__init__</span><span class="p">(</span><span class="n">frequency</span><span class="o">=</span><span class="n">frequency</span><span class="p">)</span>
+</span><span id="1-923">
+</span><span id="1-924">        <span class="c1"># used to signal to the thread that it should stop</span>
+</span><span id="1-925">        <span class="bp">self</span><span class="o">.</span><span class="n">running</span> <span class="o">=</span> <span class="kc">False</span>
+</span><span id="1-926">        <span class="bp">self</span><span class="o">.</span><span class="n">thread</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[ThreadPool]</span>
+</span><span id="1-927">        <span class="bp">self</span><span class="o">.</span><span class="n">pid</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[int]</span>
+</span><span id="1-928">
+</span><span id="1-929">        <span class="c1"># This intentionally uses the gevent patched threading.Lock.</span>
+</span><span id="1-930">        <span class="c1"># The lock will be required when first trying to start profiles</span>
+</span><span id="1-931">        <span class="c1"># as we need to spawn the profiler thread from the greenlets.</span>
+</span><span id="1-932">        <span class="bp">self</span><span class="o">.</span><span class="n">lock</span> <span class="o">=</span> <span class="n">threading</span><span class="o">.</span><span class="n">Lock</span><span class="p">()</span>
+</span><span id="1-933">
+</span><span id="1-934">    <span class="k">def</span> <span class="nf">setup</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-935">        <span class="c1"># type: () -&gt; None</span>
+</span><span id="1-936">        <span class="k">pass</span>
+</span><span id="1-937">
+</span><span id="1-938">    <span class="k">def</span> <span class="nf">teardown</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-939">        <span class="c1"># type: () -&gt; None</span>
+</span><span id="1-940">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">running</span><span class="p">:</span>
+</span><span id="1-941">            <span class="bp">self</span><span class="o">.</span><span class="n">running</span> <span class="o">=</span> <span class="kc">False</span>
+</span><span id="1-942">            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">thread</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-943">                <span class="bp">self</span><span class="o">.</span><span class="n">thread</span><span class="o">.</span><span class="n">join</span><span class="p">()</span>
+</span><span id="1-944">
+</span><span id="1-945">    <span class="k">def</span> <span class="nf">ensure_running</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-946">        <span class="c1"># type: () -&gt; None</span>
+</span><span id="1-947">        <span class="n">pid</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">getpid</span><span class="p">()</span>
+</span><span id="1-948">
+</span><span id="1-949">        <span class="c1"># is running on the right process</span>
+</span><span id="1-950">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">running</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">pid</span> <span class="o">==</span> <span class="n">pid</span><span class="p">:</span>
+</span><span id="1-951">            <span class="k">return</span>
+</span><span id="1-952">
+</span><span id="1-953">        <span class="k">with</span> <span class="bp">self</span><span class="o">.</span><span class="n">lock</span><span class="p">:</span>
+</span><span id="1-954">            <span class="c1"># another thread may have tried to acquire the lock</span>
+</span><span id="1-955">            <span class="c1"># at the same time so it may start another thread</span>
+</span><span id="1-956">            <span class="c1"># make sure to check again before proceeding</span>
+</span><span id="1-957">            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">running</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">pid</span> <span class="o">==</span> <span class="n">pid</span><span class="p">:</span>
+</span><span id="1-958">                <span class="k">return</span>
+</span><span id="1-959">
+</span><span id="1-960">            <span class="bp">self</span><span class="o">.</span><span class="n">pid</span> <span class="o">=</span> <span class="n">pid</span>
+</span><span id="1-961">            <span class="bp">self</span><span class="o">.</span><span class="n">running</span> <span class="o">=</span> <span class="kc">True</span>
+</span><span id="1-962">
+</span><span id="1-963">            <span class="bp">self</span><span class="o">.</span><span class="n">thread</span> <span class="o">=</span> <span class="n">ThreadPool</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span>
+</span><span id="1-964">            <span class="k">try</span><span class="p">:</span>
+</span><span id="1-965">                <span class="bp">self</span><span class="o">.</span><span class="n">thread</span><span class="o">.</span><span class="n">spawn</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">run</span><span class="p">)</span>
+</span><span id="1-966">            <span class="k">except</span> <span class="ne">RuntimeError</span><span class="p">:</span>
+</span><span id="1-967">                <span class="c1"># Unfortunately at this point the interpreter is in a state that no</span>
+</span><span id="1-968">                <span class="c1"># longer allows us to spawn a thread and we have to bail.</span>
+</span><span id="1-969">                <span class="bp">self</span><span class="o">.</span><span class="n">running</span> <span class="o">=</span> <span class="kc">False</span>
+</span><span id="1-970">                <span class="bp">self</span><span class="o">.</span><span class="n">thread</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="1-971">                <span class="k">return</span>
+</span><span id="1-972">
+</span><span id="1-973">    <span class="k">def</span> <span class="nf">run</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-974">        <span class="c1"># type: () -&gt; None</span>
+</span><span id="1-975">        <span class="n">last</span> <span class="o">=</span> <span class="n">time</span><span class="o">.</span><span class="n">perf_counter</span><span class="p">()</span>
+</span><span id="1-976">
+</span><span id="1-977">        <span class="k">while</span> <span class="bp">self</span><span class="o">.</span><span class="n">running</span><span class="p">:</span>
+</span><span id="1-978">            <span class="bp">self</span><span class="o">.</span><span class="n">sampler</span><span class="p">()</span>
+</span><span id="1-979">
+</span><span id="1-980">            <span class="c1"># some time may have elapsed since the last time</span>
+</span><span id="1-981">            <span class="c1"># we sampled, so we need to account for that and</span>
+</span><span id="1-982">            <span class="c1"># not sleep for too long</span>
+</span><span id="1-983">            <span class="n">elapsed</span> <span class="o">=</span> <span class="n">time</span><span class="o">.</span><span class="n">perf_counter</span><span class="p">()</span> <span class="o">-</span> <span class="n">last</span>
+</span><span id="1-984">            <span class="k">if</span> <span class="n">elapsed</span> <span class="o">&lt;</span> <span class="bp">self</span><span class="o">.</span><span class="n">interval</span><span class="p">:</span>
+</span><span id="1-985">                <span class="n">thread_sleep</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">interval</span> <span class="o">-</span> <span class="n">elapsed</span><span class="p">)</span>
+</span><span id="1-986">
+</span><span id="1-987">            <span class="c1"># after sleeping, make sure to take the current</span>
+</span><span id="1-988">            <span class="c1"># timestamp so we can use it next iteration</span>
+</span><span id="1-989">            <span class="n">last</span> <span class="o">=</span> <span class="n">time</span><span class="o">.</span><span class="n">perf_counter</span><span class="p">()</span>
 </span></pre></div>
         </article>
         
@@ -1154,7 +1156,7 @@ <h1>Source code for sentry_sdk.profiler</h1><div class="highlight"><pre>
     </div>
   </div>
 </footer></div>
-      <script src="../../_static/documentation_options.js?v=fca6d697"></script>
+      <script src="../../_static/documentation_options.js?v=aa9da443"></script>
       <script src="../../_static/doctools.js?v=888ff710"></script>
       <script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
       <script src="../../_static/shibuya.js?v=999236dc"></script>
diff --git a/_modules/sentry_sdk/scope.html b/_modules/sentry_sdk/scope.html
index bda128436f..c7f82d0742 100644
--- a/_modules/sentry_sdk/scope.html
+++ b/_modules/sentry_sdk/scope.html
@@ -4,7 +4,7 @@
 <head>
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-      <title>sentry_sdk.scope - sentry-python 1.44.1 documentation</title>
+      <title>sentry_sdk.scope - sentry-python 2.0.0rc4 documentation</title>
     <link rel="index" title="Index" href="../../genindex.html" /><link rel="search" title="Search" href="../../search.html" />
 
   <script>
@@ -132,1393 +132,1827 @@
       <div class="min-w-0 max-w-6xl px-6 pb-6 pt-8 xl:px-12">
         <article class="yue" role="main">
           <h1>Source code for sentry_sdk.scope</h1><div class="highlight"><pre>
-<span></span><span id="1-1"><span class="kn">from</span> <span class="nn">copy</span> <span class="kn">import</span> <span class="n">copy</span>
-</span><span id="1-2"><span class="kn">from</span> <span class="nn">collections</span> <span class="kn">import</span> <span class="n">deque</span>
-</span><span id="1-3"><span class="kn">from</span> <span class="nn">itertools</span> <span class="kn">import</span> <span class="n">chain</span>
-</span><span id="1-4"><span class="kn">import</span> <span class="nn">os</span>
-</span><span id="1-5"><span class="kn">import</span> <span class="nn">sys</span>
-</span><span id="1-6"><span class="kn">import</span> <span class="nn">uuid</span>
-</span><span id="1-7">
-</span><span id="1-8"><span class="kn">from</span> <span class="nn">sentry_sdk.attachments</span> <span class="kn">import</span> <span class="n">Attachment</span>
-</span><span id="1-9"><span class="kn">from</span> <span class="nn">sentry_sdk._compat</span> <span class="kn">import</span> <span class="n">datetime_utcnow</span>
-</span><span id="1-10"><span class="kn">from</span> <span class="nn">sentry_sdk.consts</span> <span class="kn">import</span> <span class="n">FALSE_VALUES</span><span class="p">,</span> <span class="n">INSTRUMENTER</span>
-</span><span id="1-11"><span class="kn">from</span> <span class="nn">sentry_sdk._functools</span> <span class="kn">import</span> <span class="n">wraps</span>
-</span><span id="1-12"><span class="kn">from</span> <span class="nn">sentry_sdk.profiler</span> <span class="kn">import</span> <span class="n">Profile</span>
-</span><span id="1-13"><span class="kn">from</span> <span class="nn">sentry_sdk.session</span> <span class="kn">import</span> <span class="n">Session</span>
-</span><span id="1-14"><span class="kn">from</span> <span class="nn">sentry_sdk.tracing_utils</span> <span class="kn">import</span> <span class="p">(</span>
-</span><span id="1-15">    <span class="n">Baggage</span><span class="p">,</span>
-</span><span id="1-16">    <span class="n">extract_sentrytrace_data</span><span class="p">,</span>
-</span><span id="1-17">    <span class="n">has_tracing_enabled</span><span class="p">,</span>
-</span><span id="1-18">    <span class="n">normalize_incoming_data</span><span class="p">,</span>
-</span><span id="1-19"><span class="p">)</span>
-</span><span id="1-20"><span class="kn">from</span> <span class="nn">sentry_sdk.tracing</span> <span class="kn">import</span> <span class="p">(</span>
-</span><span id="1-21">    <span class="n">BAGGAGE_HEADER_NAME</span><span class="p">,</span>
-</span><span id="1-22">    <span class="n">SENTRY_TRACE_HEADER_NAME</span><span class="p">,</span>
-</span><span id="1-23">    <span class="n">NoOpSpan</span><span class="p">,</span>
-</span><span id="1-24">    <span class="n">Span</span><span class="p">,</span>
-</span><span id="1-25">    <span class="n">Transaction</span><span class="p">,</span>
-</span><span id="1-26"><span class="p">)</span>
-</span><span id="1-27"><span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="n">TYPE_CHECKING</span>
-</span><span id="1-28"><span class="kn">from</span> <span class="nn">sentry_sdk.utils</span> <span class="kn">import</span> <span class="p">(</span>
-</span><span id="1-29">    <span class="n">event_from_exception</span><span class="p">,</span>
-</span><span id="1-30">    <span class="n">exc_info_from_error</span><span class="p">,</span>
-</span><span id="1-31">    <span class="n">logger</span><span class="p">,</span>
-</span><span id="1-32">    <span class="n">capture_internal_exceptions</span><span class="p">,</span>
-</span><span id="1-33"><span class="p">)</span>
-</span><span id="1-34">
-</span><span id="1-35"><span class="k">if</span> <span class="n">TYPE_CHECKING</span><span class="p">:</span>
-</span><span id="1-36">    <span class="kn">from</span> <span class="nn">collections.abc</span> <span class="kn">import</span> <span class="n">MutableMapping</span>
+<span></span><span id="1-1"><span class="kn">import</span> <span class="nn">os</span>
+</span><span id="1-2"><span class="kn">import</span> <span class="nn">sys</span>
+</span><span id="1-3"><span class="kn">import</span> <span class="nn">uuid</span>
+</span><span id="1-4"><span class="kn">from</span> <span class="nn">copy</span> <span class="kn">import</span> <span class="n">copy</span>
+</span><span id="1-5"><span class="kn">from</span> <span class="nn">collections</span> <span class="kn">import</span> <span class="n">deque</span>
+</span><span id="1-6"><span class="kn">from</span> <span class="nn">contextlib</span> <span class="kn">import</span> <span class="n">contextmanager</span>
+</span><span id="1-7"><span class="kn">from</span> <span class="nn">enum</span> <span class="kn">import</span> <span class="n">Enum</span>
+</span><span id="1-8"><span class="kn">from</span> <span class="nn">datetime</span> <span class="kn">import</span> <span class="n">datetime</span><span class="p">,</span> <span class="n">timezone</span>
+</span><span id="1-9"><span class="kn">from</span> <span class="nn">functools</span> <span class="kn">import</span> <span class="n">wraps</span>
+</span><span id="1-10"><span class="kn">from</span> <span class="nn">itertools</span> <span class="kn">import</span> <span class="n">chain</span>
+</span><span id="1-11">
+</span><span id="1-12"><span class="kn">from</span> <span class="nn">sentry_sdk.attachments</span> <span class="kn">import</span> <span class="n">Attachment</span>
+</span><span id="1-13"><span class="kn">from</span> <span class="nn">sentry_sdk.consts</span> <span class="kn">import</span> <span class="n">DEFAULT_MAX_BREADCRUMBS</span><span class="p">,</span> <span class="n">FALSE_VALUES</span><span class="p">,</span> <span class="n">INSTRUMENTER</span>
+</span><span id="1-14"><span class="kn">from</span> <span class="nn">sentry_sdk.profiler</span> <span class="kn">import</span> <span class="n">Profile</span>
+</span><span id="1-15"><span class="kn">from</span> <span class="nn">sentry_sdk.session</span> <span class="kn">import</span> <span class="n">Session</span>
+</span><span id="1-16"><span class="kn">from</span> <span class="nn">sentry_sdk.tracing_utils</span> <span class="kn">import</span> <span class="p">(</span>
+</span><span id="1-17">    <span class="n">Baggage</span><span class="p">,</span>
+</span><span id="1-18">    <span class="n">extract_sentrytrace_data</span><span class="p">,</span>
+</span><span id="1-19">    <span class="n">has_tracing_enabled</span><span class="p">,</span>
+</span><span id="1-20">    <span class="n">normalize_incoming_data</span><span class="p">,</span>
+</span><span id="1-21"><span class="p">)</span>
+</span><span id="1-22"><span class="kn">from</span> <span class="nn">sentry_sdk.tracing</span> <span class="kn">import</span> <span class="p">(</span>
+</span><span id="1-23">    <span class="n">BAGGAGE_HEADER_NAME</span><span class="p">,</span>
+</span><span id="1-24">    <span class="n">SENTRY_TRACE_HEADER_NAME</span><span class="p">,</span>
+</span><span id="1-25">    <span class="n">NoOpSpan</span><span class="p">,</span>
+</span><span id="1-26">    <span class="n">Span</span><span class="p">,</span>
+</span><span id="1-27">    <span class="n">Transaction</span><span class="p">,</span>
+</span><span id="1-28"><span class="p">)</span>
+</span><span id="1-29"><span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="n">TYPE_CHECKING</span>
+</span><span id="1-30"><span class="kn">from</span> <span class="nn">sentry_sdk.utils</span> <span class="kn">import</span> <span class="p">(</span>
+</span><span id="1-31">    <span class="n">capture_internal_exceptions</span><span class="p">,</span>
+</span><span id="1-32">    <span class="n">ContextVar</span><span class="p">,</span>
+</span><span id="1-33">    <span class="n">event_from_exception</span><span class="p">,</span>
+</span><span id="1-34">    <span class="n">exc_info_from_error</span><span class="p">,</span>
+</span><span id="1-35">    <span class="n">logger</span><span class="p">,</span>
+</span><span id="1-36"><span class="p">)</span>
 </span><span id="1-37">
-</span><span id="1-38">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Any</span>
-</span><span id="1-39">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Callable</span>
-</span><span id="1-40">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Deque</span>
-</span><span id="1-41">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Dict</span>
-</span><span id="1-42">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Generator</span>
-</span><span id="1-43">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Iterator</span>
-</span><span id="1-44">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">List</span>
-</span><span id="1-45">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Optional</span>
-</span><span id="1-46">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Tuple</span>
-</span><span id="1-47">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">TypeVar</span>
-</span><span id="1-48">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Union</span>
-</span><span id="1-49">
-</span><span id="1-50">    <span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="p">(</span>
-</span><span id="1-51">        <span class="n">Breadcrumb</span><span class="p">,</span>
-</span><span id="1-52">        <span class="n">BreadcrumbHint</span><span class="p">,</span>
-</span><span id="1-53">        <span class="n">ErrorProcessor</span><span class="p">,</span>
-</span><span id="1-54">        <span class="n">Event</span><span class="p">,</span>
-</span><span id="1-55">        <span class="n">EventProcessor</span><span class="p">,</span>
-</span><span id="1-56">        <span class="n">ExcInfo</span><span class="p">,</span>
-</span><span id="1-57">        <span class="n">Hint</span><span class="p">,</span>
-</span><span id="1-58">        <span class="n">LogLevelStr</span><span class="p">,</span>
-</span><span id="1-59">        <span class="n">Type</span><span class="p">,</span>
-</span><span id="1-60">    <span class="p">)</span>
-</span><span id="1-61">
-</span><span id="1-62">    <span class="kn">import</span> <span class="nn">sentry_sdk</span>
-</span><span id="1-63">
-</span><span id="1-64">    <span class="n">F</span> <span class="o">=</span> <span class="n">TypeVar</span><span class="p">(</span><span class="s2">&quot;F&quot;</span><span class="p">,</span> <span class="n">bound</span><span class="o">=</span><span class="n">Callable</span><span class="p">[</span><span class="o">...</span><span class="p">,</span> <span class="n">Any</span><span class="p">])</span>
-</span><span id="1-65">    <span class="n">T</span> <span class="o">=</span> <span class="n">TypeVar</span><span class="p">(</span><span class="s2">&quot;T&quot;</span><span class="p">)</span>
-</span><span id="1-66">
-</span><span id="1-67">
-</span><span id="1-68"><span class="n">global_event_processors</span> <span class="o">=</span> <span class="p">[]</span>  <span class="c1"># type: List[EventProcessor]</span>
-</span><span id="1-69">
+</span><span id="1-38"><span class="k">if</span> <span class="n">TYPE_CHECKING</span><span class="p">:</span>
+</span><span id="1-39">    <span class="kn">from</span> <span class="nn">collections.abc</span> <span class="kn">import</span> <span class="n">MutableMapping</span>
+</span><span id="1-40">
+</span><span id="1-41">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Any</span>
+</span><span id="1-42">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Callable</span>
+</span><span id="1-43">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Deque</span>
+</span><span id="1-44">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Dict</span>
+</span><span id="1-45">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Generator</span>
+</span><span id="1-46">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Iterator</span>
+</span><span id="1-47">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">List</span>
+</span><span id="1-48">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Optional</span>
+</span><span id="1-49">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">ParamSpec</span>
+</span><span id="1-50">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Tuple</span>
+</span><span id="1-51">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">TypeVar</span>
+</span><span id="1-52">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Union</span>
+</span><span id="1-53">
+</span><span id="1-54">    <span class="kn">from</span> <span class="nn">typing_extensions</span> <span class="kn">import</span> <span class="n">Unpack</span>
+</span><span id="1-55">
+</span><span id="1-56">    <span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="p">(</span>
+</span><span id="1-57">        <span class="n">Breadcrumb</span><span class="p">,</span>
+</span><span id="1-58">        <span class="n">BreadcrumbHint</span><span class="p">,</span>
+</span><span id="1-59">        <span class="n">ErrorProcessor</span><span class="p">,</span>
+</span><span id="1-60">        <span class="n">Event</span><span class="p">,</span>
+</span><span id="1-61">        <span class="n">EventProcessor</span><span class="p">,</span>
+</span><span id="1-62">        <span class="n">ExcInfo</span><span class="p">,</span>
+</span><span id="1-63">        <span class="n">Hint</span><span class="p">,</span>
+</span><span id="1-64">        <span class="n">LogLevelStr</span><span class="p">,</span>
+</span><span id="1-65">        <span class="n">SamplingContext</span><span class="p">,</span>
+</span><span id="1-66">        <span class="n">Type</span><span class="p">,</span>
+</span><span id="1-67">    <span class="p">)</span>
+</span><span id="1-68">
+</span><span id="1-69">    <span class="kn">from</span> <span class="nn">sentry_sdk.tracing</span> <span class="kn">import</span> <span class="n">TransactionKwargs</span>
 </span><span id="1-70">
-</span><span id="1-71"><span class="k">def</span> <span class="nf">add_global_event_processor</span><span class="p">(</span><span class="n">processor</span><span class="p">):</span>
-</span><span id="1-72">    <span class="c1"># type: (EventProcessor) -&gt; None</span>
-</span><span id="1-73">    <span class="n">global_event_processors</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">processor</span><span class="p">)</span>
-</span><span id="1-74">
+</span><span id="1-71">    <span class="kn">import</span> <span class="nn">sentry_sdk</span>
+</span><span id="1-72">
+</span><span id="1-73">    <span class="n">P</span> <span class="o">=</span> <span class="n">ParamSpec</span><span class="p">(</span><span class="s2">&quot;P&quot;</span><span class="p">)</span>
+</span><span id="1-74">    <span class="n">R</span> <span class="o">=</span> <span class="n">TypeVar</span><span class="p">(</span><span class="s2">&quot;R&quot;</span><span class="p">)</span>
 </span><span id="1-75">
-</span><span id="1-76"><span class="k">def</span> <span class="nf">_attr_setter</span><span class="p">(</span><span class="n">fn</span><span class="p">):</span>
-</span><span id="1-77">    <span class="c1"># type: (Any) -&gt; Any</span>
-</span><span id="1-78">    <span class="k">return</span> <span class="nb">property</span><span class="p">(</span><span class="n">fset</span><span class="o">=</span><span class="n">fn</span><span class="p">,</span> <span class="n">doc</span><span class="o">=</span><span class="n">fn</span><span class="o">.</span><span class="vm">__doc__</span><span class="p">)</span>
+</span><span id="1-76">    <span class="n">F</span> <span class="o">=</span> <span class="n">TypeVar</span><span class="p">(</span><span class="s2">&quot;F&quot;</span><span class="p">,</span> <span class="n">bound</span><span class="o">=</span><span class="n">Callable</span><span class="p">[</span><span class="o">...</span><span class="p">,</span> <span class="n">Any</span><span class="p">])</span>
+</span><span id="1-77">    <span class="n">T</span> <span class="o">=</span> <span class="n">TypeVar</span><span class="p">(</span><span class="s2">&quot;T&quot;</span><span class="p">)</span>
+</span><span id="1-78">
 </span><span id="1-79">
-</span><span id="1-80">
-</span><span id="1-81"><span class="k">def</span> <span class="nf">_disable_capture</span><span class="p">(</span><span class="n">fn</span><span class="p">):</span>
-</span><span id="1-82">    <span class="c1"># type: (F) -&gt; F</span>
-</span><span id="1-83">    <span class="nd">@wraps</span><span class="p">(</span><span class="n">fn</span><span class="p">)</span>
-</span><span id="1-84">    <span class="k">def</span> <span class="nf">wrapper</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-</span><span id="1-85">        <span class="c1"># type: (Any, *Dict[str, Any], **Any) -&gt; Any</span>
-</span><span id="1-86">        <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_should_capture</span><span class="p">:</span>
-</span><span id="1-87">            <span class="k">return</span>
-</span><span id="1-88">        <span class="k">try</span><span class="p">:</span>
-</span><span id="1-89">            <span class="bp">self</span><span class="o">.</span><span class="n">_should_capture</span> <span class="o">=</span> <span class="kc">False</span>
-</span><span id="1-90">            <span class="k">return</span> <span class="n">fn</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-</span><span id="1-91">        <span class="k">finally</span><span class="p">:</span>
-</span><span id="1-92">            <span class="bp">self</span><span class="o">.</span><span class="n">_should_capture</span> <span class="o">=</span> <span class="kc">True</span>
-</span><span id="1-93">
-</span><span id="1-94">    <span class="k">return</span> <span class="n">wrapper</span>  <span class="c1"># type: ignore</span>
+</span><span id="1-80"><span class="c1"># Holds data that will be added to **all** events sent by this process.</span>
+</span><span id="1-81"><span class="c1"># In case this is a http server (think web framework) with multiple users</span>
+</span><span id="1-82"><span class="c1"># the data will be added to events of all users.</span>
+</span><span id="1-83"><span class="c1"># Typically this is used for process wide data such as the release.</span>
+</span><span id="1-84"><span class="n">_global_scope</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[Scope]</span>
+</span><span id="1-85">
+</span><span id="1-86"><span class="c1"># Holds data for the active request.</span>
+</span><span id="1-87"><span class="c1"># This is used to isolate data for different requests or users.</span>
+</span><span id="1-88"><span class="c1"># The isolation scope is usually created by integrations, but may also</span>
+</span><span id="1-89"><span class="c1"># be created manually</span>
+</span><span id="1-90"><span class="n">_isolation_scope</span> <span class="o">=</span> <span class="n">ContextVar</span><span class="p">(</span><span class="s2">&quot;isolation_scope&quot;</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span>
+</span><span id="1-91">
+</span><span id="1-92"><span class="c1"># Holds data for the active span.</span>
+</span><span id="1-93"><span class="c1"># This can be used to manually add additional data to a span.</span>
+</span><span id="1-94"><span class="n">_current_scope</span> <span class="o">=</span> <span class="n">ContextVar</span><span class="p">(</span><span class="s2">&quot;current_scope&quot;</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="kc">None</span><span class="p">)</span>
 </span><span id="1-95">
-</span><span id="1-96">
-</span><span id="1-97"><span class="k">def</span> <span class="nf">_merge_scopes</span><span class="p">(</span><span class="n">base</span><span class="p">,</span> <span class="n">scope_change</span><span class="p">,</span> <span class="n">scope_kwargs</span><span class="p">):</span>
-</span><span id="1-98">    <span class="c1"># type: (Scope, Optional[Any], Dict[str, Any]) -&gt; Scope</span>
-</span><span id="1-99">    <span class="k">if</span> <span class="n">scope_change</span> <span class="ow">and</span> <span class="n">scope_kwargs</span><span class="p">:</span>
-</span><span id="1-100">        <span class="k">raise</span> <span class="ne">TypeError</span><span class="p">(</span><span class="s2">&quot;cannot provide scope and kwargs&quot;</span><span class="p">)</span>
-</span><span id="1-101">
-</span><span id="1-102">    <span class="k">if</span> <span class="n">scope_change</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-103">        <span class="n">final_scope</span> <span class="o">=</span> <span class="n">copy</span><span class="p">(</span><span class="n">base</span><span class="p">)</span>
-</span><span id="1-104">        <span class="k">if</span> <span class="nb">callable</span><span class="p">(</span><span class="n">scope_change</span><span class="p">):</span>
-</span><span id="1-105">            <span class="n">scope_change</span><span class="p">(</span><span class="n">final_scope</span><span class="p">)</span>
-</span><span id="1-106">        <span class="k">else</span><span class="p">:</span>
-</span><span id="1-107">            <span class="n">final_scope</span><span class="o">.</span><span class="n">update_from_scope</span><span class="p">(</span><span class="n">scope_change</span><span class="p">)</span>
-</span><span id="1-108">
-</span><span id="1-109">    <span class="k">elif</span> <span class="n">scope_kwargs</span><span class="p">:</span>
-</span><span id="1-110">        <span class="n">final_scope</span> <span class="o">=</span> <span class="n">copy</span><span class="p">(</span><span class="n">base</span><span class="p">)</span>
-</span><span id="1-111">        <span class="n">final_scope</span><span class="o">.</span><span class="n">update_from_kwargs</span><span class="p">(</span><span class="o">**</span><span class="n">scope_kwargs</span><span class="p">)</span>
-</span><span id="1-112">
-</span><span id="1-113">    <span class="k">else</span><span class="p">:</span>
-</span><span id="1-114">        <span class="n">final_scope</span> <span class="o">=</span> <span class="n">base</span>
-</span><span id="1-115">
-</span><span id="1-116">    <span class="k">return</span> <span class="n">final_scope</span>
-</span><span id="1-117">
-</span><span id="1-118">
-<div class="viewcode-block" id="Scope">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Scope">[docs]</a>
-</span><span id="1-119"><span class="k">class</span> <span class="nc">Scope</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-</span><span id="1-120"><span class="w">    </span><span class="sd">&quot;&quot;&quot;The scope holds extra information that should be sent with all</span>
-</span><span id="1-121"><span class="sd">    events that belong to it.</span>
-</span><span id="1-122"><span class="sd">    &quot;&quot;&quot;</span>
-</span><span id="1-123">
-</span><span id="1-124">    <span class="c1"># NOTE: Even though it should not happen, the scope needs to not crash when</span>
-</span><span id="1-125">    <span class="c1"># accessed by multiple threads. It&#39;s fine if it&#39;s full of races, but those</span>
-</span><span id="1-126">    <span class="c1"># races should never make the user application crash.</span>
-</span><span id="1-127">    <span class="c1">#</span>
-</span><span id="1-128">    <span class="c1"># The same needs to hold for any accesses of the scope the SDK makes.</span>
-</span><span id="1-129">
-</span><span id="1-130">    <span class="vm">__slots__</span> <span class="o">=</span> <span class="p">(</span>
-</span><span id="1-131">        <span class="s2">&quot;_level&quot;</span><span class="p">,</span>
-</span><span id="1-132">        <span class="s2">&quot;_name&quot;</span><span class="p">,</span>
-</span><span id="1-133">        <span class="s2">&quot;_fingerprint&quot;</span><span class="p">,</span>
-</span><span id="1-134">        <span class="c1"># note that for legacy reasons, _transaction is the transaction *name*,</span>
-</span><span id="1-135">        <span class="c1"># not a Transaction object (the object is stored in _span)</span>
-</span><span id="1-136">        <span class="s2">&quot;_transaction&quot;</span><span class="p">,</span>
-</span><span id="1-137">        <span class="s2">&quot;_transaction_info&quot;</span><span class="p">,</span>
-</span><span id="1-138">        <span class="s2">&quot;_user&quot;</span><span class="p">,</span>
-</span><span id="1-139">        <span class="s2">&quot;_tags&quot;</span><span class="p">,</span>
-</span><span id="1-140">        <span class="s2">&quot;_contexts&quot;</span><span class="p">,</span>
-</span><span id="1-141">        <span class="s2">&quot;_extras&quot;</span><span class="p">,</span>
-</span><span id="1-142">        <span class="s2">&quot;_breadcrumbs&quot;</span><span class="p">,</span>
-</span><span id="1-143">        <span class="s2">&quot;_event_processors&quot;</span><span class="p">,</span>
-</span><span id="1-144">        <span class="s2">&quot;_error_processors&quot;</span><span class="p">,</span>
-</span><span id="1-145">        <span class="s2">&quot;_should_capture&quot;</span><span class="p">,</span>
-</span><span id="1-146">        <span class="s2">&quot;_span&quot;</span><span class="p">,</span>
-</span><span id="1-147">        <span class="s2">&quot;_session&quot;</span><span class="p">,</span>
-</span><span id="1-148">        <span class="s2">&quot;_attachments&quot;</span><span class="p">,</span>
-</span><span id="1-149">        <span class="s2">&quot;_force_auto_session_tracking&quot;</span><span class="p">,</span>
-</span><span id="1-150">        <span class="s2">&quot;_profile&quot;</span><span class="p">,</span>
-</span><span id="1-151">        <span class="s2">&quot;_propagation_context&quot;</span><span class="p">,</span>
-</span><span id="1-152">    <span class="p">)</span>
+</span><span id="1-96"><span class="n">global_event_processors</span> <span class="o">=</span> <span class="p">[]</span>  <span class="c1"># type: List[EventProcessor]</span>
+</span><span id="1-97">
+</span><span id="1-98">
+</span><span id="1-99"><span class="k">class</span> <span class="nc">ScopeType</span><span class="p">(</span><span class="n">Enum</span><span class="p">):</span>
+</span><span id="1-100">    <span class="n">CURRENT</span> <span class="o">=</span> <span class="s2">&quot;current&quot;</span>
+</span><span id="1-101">    <span class="n">ISOLATION</span> <span class="o">=</span> <span class="s2">&quot;isolation&quot;</span>
+</span><span id="1-102">    <span class="n">GLOBAL</span> <span class="o">=</span> <span class="s2">&quot;global&quot;</span>
+</span><span id="1-103">    <span class="n">MERGED</span> <span class="o">=</span> <span class="s2">&quot;merged&quot;</span>
+</span><span id="1-104">
+</span><span id="1-105">
+</span><span id="1-106"><span class="k">class</span> <span class="nc">_ScopeManager</span><span class="p">:</span>
+</span><span id="1-107">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">hub</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+</span><span id="1-108">        <span class="c1"># type: (Optional[Any]) -&gt; None</span>
+</span><span id="1-109">        <span class="bp">self</span><span class="o">.</span><span class="n">_old_scopes</span> <span class="o">=</span> <span class="p">[]</span>  <span class="c1"># type: List[Scope]</span>
+</span><span id="1-110">
+</span><span id="1-111">    <span class="k">def</span> <span class="fm">__enter__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-112">        <span class="c1"># type: () -&gt; Scope</span>
+</span><span id="1-113">        <span class="n">isolation_scope</span> <span class="o">=</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_isolation_scope</span><span class="p">()</span>
+</span><span id="1-114">
+</span><span id="1-115">        <span class="bp">self</span><span class="o">.</span><span class="n">_old_scopes</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">isolation_scope</span><span class="p">)</span>
+</span><span id="1-116">
+</span><span id="1-117">        <span class="n">forked_scope</span> <span class="o">=</span> <span class="n">isolation_scope</span><span class="o">.</span><span class="n">fork</span><span class="p">()</span>
+</span><span id="1-118">        <span class="n">_isolation_scope</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="n">forked_scope</span><span class="p">)</span>
+</span><span id="1-119">
+</span><span id="1-120">        <span class="k">return</span> <span class="n">forked_scope</span>
+</span><span id="1-121">
+</span><span id="1-122">    <span class="k">def</span> <span class="fm">__exit__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">exc_type</span><span class="p">,</span> <span class="n">exc_value</span><span class="p">,</span> <span class="n">tb</span><span class="p">):</span>
+</span><span id="1-123">        <span class="c1"># type: (Any, Any, Any) -&gt; None</span>
+</span><span id="1-124">        <span class="n">old_scope</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_old_scopes</span><span class="o">.</span><span class="n">pop</span><span class="p">()</span>
+</span><span id="1-125">        <span class="n">_isolation_scope</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="n">old_scope</span><span class="p">)</span>
+</span><span id="1-126">
+</span><span id="1-127">
+</span><span id="1-128"><span class="k">def</span> <span class="nf">add_global_event_processor</span><span class="p">(</span><span class="n">processor</span><span class="p">):</span>
+</span><span id="1-129">    <span class="c1"># type: (EventProcessor) -&gt; None</span>
+</span><span id="1-130">    <span class="n">global_event_processors</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">processor</span><span class="p">)</span>
+</span><span id="1-131">
+</span><span id="1-132">
+</span><span id="1-133"><span class="k">def</span> <span class="nf">_attr_setter</span><span class="p">(</span><span class="n">fn</span><span class="p">):</span>
+</span><span id="1-134">    <span class="c1"># type: (Any) -&gt; Any</span>
+</span><span id="1-135">    <span class="k">return</span> <span class="nb">property</span><span class="p">(</span><span class="n">fset</span><span class="o">=</span><span class="n">fn</span><span class="p">,</span> <span class="n">doc</span><span class="o">=</span><span class="n">fn</span><span class="o">.</span><span class="vm">__doc__</span><span class="p">)</span>
+</span><span id="1-136">
+</span><span id="1-137">
+</span><span id="1-138"><span class="k">def</span> <span class="nf">_disable_capture</span><span class="p">(</span><span class="n">fn</span><span class="p">):</span>
+</span><span id="1-139">    <span class="c1"># type: (F) -&gt; F</span>
+</span><span id="1-140">    <span class="nd">@wraps</span><span class="p">(</span><span class="n">fn</span><span class="p">)</span>
+</span><span id="1-141">    <span class="k">def</span> <span class="nf">wrapper</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
+</span><span id="1-142">        <span class="c1"># type: (Any, *Dict[str, Any], **Any) -&gt; Any</span>
+</span><span id="1-143">        <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_should_capture</span><span class="p">:</span>
+</span><span id="1-144">            <span class="k">return</span>
+</span><span id="1-145">        <span class="k">try</span><span class="p">:</span>
+</span><span id="1-146">            <span class="bp">self</span><span class="o">.</span><span class="n">_should_capture</span> <span class="o">=</span> <span class="kc">False</span>
+</span><span id="1-147">            <span class="k">return</span> <span class="n">fn</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+</span><span id="1-148">        <span class="k">finally</span><span class="p">:</span>
+</span><span id="1-149">            <span class="bp">self</span><span class="o">.</span><span class="n">_should_capture</span> <span class="o">=</span> <span class="kc">True</span>
+</span><span id="1-150">
+</span><span id="1-151">    <span class="k">return</span> <span class="n">wrapper</span>  <span class="c1"># type: ignore</span>
+</span><span id="1-152">
 </span><span id="1-153">
-</span><span id="1-154">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-155">        <span class="c1"># type: () -&gt; None</span>
-</span><span id="1-156">        <span class="bp">self</span><span class="o">.</span><span class="n">_event_processors</span> <span class="o">=</span> <span class="p">[]</span>  <span class="c1"># type: List[EventProcessor]</span>
-</span><span id="1-157">        <span class="bp">self</span><span class="o">.</span><span class="n">_error_processors</span> <span class="o">=</span> <span class="p">[]</span>  <span class="c1"># type: List[ErrorProcessor]</span>
+<div class="viewcode-block" id="Scope">
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope">[docs]</a>
+</span><span id="1-154"><span class="k">class</span> <span class="nc">Scope</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
+</span><span id="1-155"><span class="w">    </span><span class="sd">&quot;&quot;&quot;The scope holds extra information that should be sent with all</span>
+</span><span id="1-156"><span class="sd">    events that belong to it.</span>
+</span><span id="1-157"><span class="sd">    &quot;&quot;&quot;</span>
 </span><span id="1-158">
-</span><span id="1-159">        <span class="bp">self</span><span class="o">.</span><span class="n">_name</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[str]</span>
-</span><span id="1-160">        <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[Dict[str, Any]]</span>
-</span><span id="1-161">
-</span><span id="1-162">        <span class="bp">self</span><span class="o">.</span><span class="n">clear</span><span class="p">()</span>
-</span><span id="1-163">
-</span><span id="1-164">        <span class="n">incoming_trace_information</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_load_trace_data_from_env</span><span class="p">()</span>
-</span><span id="1-165">        <span class="bp">self</span><span class="o">.</span><span class="n">generate_propagation_context</span><span class="p">(</span><span class="n">incoming_data</span><span class="o">=</span><span class="n">incoming_trace_information</span><span class="p">)</span>
-</span><span id="1-166">
-</span><span id="1-167">    <span class="k">def</span> <span class="nf">_load_trace_data_from_env</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-168">        <span class="c1"># type: () -&gt; Optional[Dict[str, str]]</span>
-</span><span id="1-169"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-170"><span class="sd">        Load Sentry trace id and baggage from environment variables.</span>
-</span><span id="1-171"><span class="sd">        Can be disabled by setting SENTRY_USE_ENVIRONMENT to &quot;false&quot;.</span>
-</span><span id="1-172"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-173">        <span class="n">incoming_trace_information</span> <span class="o">=</span> <span class="kc">None</span>
-</span><span id="1-174">
-</span><span id="1-175">        <span class="n">sentry_use_environment</span> <span class="o">=</span> <span class="p">(</span>
-</span><span id="1-176">            <span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;SENTRY_USE_ENVIRONMENT&quot;</span><span class="p">)</span> <span class="ow">or</span> <span class="s2">&quot;&quot;</span>
-</span><span id="1-177">        <span class="p">)</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span>
-</span><span id="1-178">        <span class="n">use_environment</span> <span class="o">=</span> <span class="n">sentry_use_environment</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">FALSE_VALUES</span>
-</span><span id="1-179">        <span class="k">if</span> <span class="n">use_environment</span><span class="p">:</span>
-</span><span id="1-180">            <span class="n">incoming_trace_information</span> <span class="o">=</span> <span class="p">{}</span>
-</span><span id="1-181">
-</span><span id="1-182">            <span class="k">if</span> <span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;SENTRY_TRACE&quot;</span><span class="p">):</span>
-</span><span id="1-183">                <span class="n">incoming_trace_information</span><span class="p">[</span><span class="n">SENTRY_TRACE_HEADER_NAME</span><span class="p">]</span> <span class="o">=</span> <span class="p">(</span>
-</span><span id="1-184">                    <span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;SENTRY_TRACE&quot;</span><span class="p">)</span> <span class="ow">or</span> <span class="s2">&quot;&quot;</span>
-</span><span id="1-185">                <span class="p">)</span>
-</span><span id="1-186">
-</span><span id="1-187">            <span class="k">if</span> <span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;SENTRY_BAGGAGE&quot;</span><span class="p">):</span>
-</span><span id="1-188">                <span class="n">incoming_trace_information</span><span class="p">[</span><span class="n">BAGGAGE_HEADER_NAME</span><span class="p">]</span> <span class="o">=</span> <span class="p">(</span>
-</span><span id="1-189">                    <span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;SENTRY_BAGGAGE&quot;</span><span class="p">)</span> <span class="ow">or</span> <span class="s2">&quot;&quot;</span>
-</span><span id="1-190">                <span class="p">)</span>
-</span><span id="1-191">
-</span><span id="1-192">        <span class="k">return</span> <span class="n">incoming_trace_information</span> <span class="ow">or</span> <span class="kc">None</span>
-</span><span id="1-193">
-</span><span id="1-194">    <span class="k">def</span> <span class="nf">_extract_propagation_context</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">data</span><span class="p">):</span>
-</span><span id="1-195">        <span class="c1"># type: (Dict[str, Any]) -&gt; Optional[Dict[str, Any]]</span>
-</span><span id="1-196">        <span class="n">context</span> <span class="o">=</span> <span class="p">{}</span>  <span class="c1"># type: Dict[str, Any]</span>
-</span><span id="1-197">        <span class="n">normalized_data</span> <span class="o">=</span> <span class="n">normalize_incoming_data</span><span class="p">(</span><span class="n">data</span><span class="p">)</span>
-</span><span id="1-198">
-</span><span id="1-199">        <span class="n">baggage_header</span> <span class="o">=</span> <span class="n">normalized_data</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">BAGGAGE_HEADER_NAME</span><span class="p">)</span>
-</span><span id="1-200">        <span class="k">if</span> <span class="n">baggage_header</span><span class="p">:</span>
-</span><span id="1-201">            <span class="n">context</span><span class="p">[</span><span class="s2">&quot;dynamic_sampling_context&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">Baggage</span><span class="o">.</span><span class="n">from_incoming_header</span><span class="p">(</span>
-</span><span id="1-202">                <span class="n">baggage_header</span>
-</span><span id="1-203">            <span class="p">)</span><span class="o">.</span><span class="n">dynamic_sampling_context</span><span class="p">()</span>
-</span><span id="1-204">
-</span><span id="1-205">        <span class="n">sentry_trace_header</span> <span class="o">=</span> <span class="n">normalized_data</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">SENTRY_TRACE_HEADER_NAME</span><span class="p">)</span>
-</span><span id="1-206">        <span class="k">if</span> <span class="n">sentry_trace_header</span><span class="p">:</span>
-</span><span id="1-207">            <span class="n">sentrytrace_data</span> <span class="o">=</span> <span class="n">extract_sentrytrace_data</span><span class="p">(</span><span class="n">sentry_trace_header</span><span class="p">)</span>
-</span><span id="1-208">            <span class="k">if</span> <span class="n">sentrytrace_data</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-209">                <span class="n">context</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">sentrytrace_data</span><span class="p">)</span>
+</span><span id="1-159">    <span class="c1"># NOTE: Even though it should not happen, the scope needs to not crash when</span>
+</span><span id="1-160">    <span class="c1"># accessed by multiple threads. It&#39;s fine if it&#39;s full of races, but those</span>
+</span><span id="1-161">    <span class="c1"># races should never make the user application crash.</span>
+</span><span id="1-162">    <span class="c1">#</span>
+</span><span id="1-163">    <span class="c1"># The same needs to hold for any accesses of the scope the SDK makes.</span>
+</span><span id="1-164">
+</span><span id="1-165">    <span class="vm">__slots__</span> <span class="o">=</span> <span class="p">(</span>
+</span><span id="1-166">        <span class="s2">&quot;_level&quot;</span><span class="p">,</span>
+</span><span id="1-167">        <span class="s2">&quot;_name&quot;</span><span class="p">,</span>
+</span><span id="1-168">        <span class="s2">&quot;_fingerprint&quot;</span><span class="p">,</span>
+</span><span id="1-169">        <span class="c1"># note that for legacy reasons, _transaction is the transaction *name*,</span>
+</span><span id="1-170">        <span class="c1"># not a Transaction object (the object is stored in _span)</span>
+</span><span id="1-171">        <span class="s2">&quot;_transaction&quot;</span><span class="p">,</span>
+</span><span id="1-172">        <span class="s2">&quot;_transaction_info&quot;</span><span class="p">,</span>
+</span><span id="1-173">        <span class="s2">&quot;_user&quot;</span><span class="p">,</span>
+</span><span id="1-174">        <span class="s2">&quot;_tags&quot;</span><span class="p">,</span>
+</span><span id="1-175">        <span class="s2">&quot;_contexts&quot;</span><span class="p">,</span>
+</span><span id="1-176">        <span class="s2">&quot;_extras&quot;</span><span class="p">,</span>
+</span><span id="1-177">        <span class="s2">&quot;_breadcrumbs&quot;</span><span class="p">,</span>
+</span><span id="1-178">        <span class="s2">&quot;_event_processors&quot;</span><span class="p">,</span>
+</span><span id="1-179">        <span class="s2">&quot;_error_processors&quot;</span><span class="p">,</span>
+</span><span id="1-180">        <span class="s2">&quot;_should_capture&quot;</span><span class="p">,</span>
+</span><span id="1-181">        <span class="s2">&quot;_span&quot;</span><span class="p">,</span>
+</span><span id="1-182">        <span class="s2">&quot;_session&quot;</span><span class="p">,</span>
+</span><span id="1-183">        <span class="s2">&quot;_attachments&quot;</span><span class="p">,</span>
+</span><span id="1-184">        <span class="s2">&quot;_force_auto_session_tracking&quot;</span><span class="p">,</span>
+</span><span id="1-185">        <span class="s2">&quot;_profile&quot;</span><span class="p">,</span>
+</span><span id="1-186">        <span class="s2">&quot;_propagation_context&quot;</span><span class="p">,</span>
+</span><span id="1-187">        <span class="s2">&quot;client&quot;</span><span class="p">,</span>
+</span><span id="1-188">        <span class="s2">&quot;_type&quot;</span><span class="p">,</span>
+</span><span id="1-189">    <span class="p">)</span>
+</span><span id="1-190">
+</span><span id="1-191">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">ty</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">client</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+</span><span id="1-192">        <span class="c1"># type: (Optional[ScopeType], Optional[sentry_sdk.Client]) -&gt; None</span>
+</span><span id="1-193">        <span class="bp">self</span><span class="o">.</span><span class="n">_type</span> <span class="o">=</span> <span class="n">ty</span>
+</span><span id="1-194">
+</span><span id="1-195">        <span class="bp">self</span><span class="o">.</span><span class="n">_event_processors</span> <span class="o">=</span> <span class="p">[]</span>  <span class="c1"># type: List[EventProcessor]</span>
+</span><span id="1-196">        <span class="bp">self</span><span class="o">.</span><span class="n">_error_processors</span> <span class="o">=</span> <span class="p">[]</span>  <span class="c1"># type: List[ErrorProcessor]</span>
+</span><span id="1-197">
+</span><span id="1-198">        <span class="bp">self</span><span class="o">.</span><span class="n">_name</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[str]</span>
+</span><span id="1-199">        <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[Dict[str, Any]]</span>
+</span><span id="1-200">
+</span><span id="1-201">        <span class="bp">self</span><span class="o">.</span><span class="n">client</span> <span class="o">=</span> <span class="n">NonRecordingClient</span><span class="p">()</span>  <span class="c1"># type: sentry_sdk.client.BaseClient</span>
+</span><span id="1-202">
+</span><span id="1-203">        <span class="k">if</span> <span class="n">client</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-204">            <span class="bp">self</span><span class="o">.</span><span class="n">set_client</span><span class="p">(</span><span class="n">client</span><span class="p">)</span>
+</span><span id="1-205">
+</span><span id="1-206">        <span class="bp">self</span><span class="o">.</span><span class="n">clear</span><span class="p">()</span>
+</span><span id="1-207">
+</span><span id="1-208">        <span class="n">incoming_trace_information</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_load_trace_data_from_env</span><span class="p">()</span>
+</span><span id="1-209">        <span class="bp">self</span><span class="o">.</span><span class="n">generate_propagation_context</span><span class="p">(</span><span class="n">incoming_data</span><span class="o">=</span><span class="n">incoming_trace_information</span><span class="p">)</span>
 </span><span id="1-210">
-</span><span id="1-211">        <span class="n">only_baggage_no_sentry_trace</span> <span class="o">=</span> <span class="p">(</span>
-</span><span id="1-212">            <span class="s2">&quot;dynamic_sampling_context&quot;</span> <span class="ow">in</span> <span class="n">context</span> <span class="ow">and</span> <span class="s2">&quot;trace_id&quot;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">context</span>
-</span><span id="1-213">        <span class="p">)</span>
-</span><span id="1-214">        <span class="k">if</span> <span class="n">only_baggage_no_sentry_trace</span><span class="p">:</span>
-</span><span id="1-215">            <span class="n">context</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_create_new_propagation_context</span><span class="p">())</span>
-</span><span id="1-216">
-</span><span id="1-217">        <span class="k">if</span> <span class="n">context</span><span class="p">:</span>
-</span><span id="1-218">            <span class="k">if</span> <span class="ow">not</span> <span class="n">context</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;span_id&quot;</span><span class="p">):</span>
-</span><span id="1-219">                <span class="n">context</span><span class="p">[</span><span class="s2">&quot;span_id&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">uuid</span><span class="o">.</span><span class="n">uuid4</span><span class="p">()</span><span class="o">.</span><span class="n">hex</span><span class="p">[</span><span class="mi">16</span><span class="p">:]</span>
-</span><span id="1-220">
-</span><span id="1-221">            <span class="k">return</span> <span class="n">context</span>
-</span><span id="1-222">
-</span><span id="1-223">        <span class="k">return</span> <span class="kc">None</span>
-</span><span id="1-224">
-</span><span id="1-225">    <span class="k">def</span> <span class="nf">_create_new_propagation_context</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-226">        <span class="c1"># type: () -&gt; Dict[str, Any]</span>
-</span><span id="1-227">        <span class="k">return</span> <span class="p">{</span>
-</span><span id="1-228">            <span class="s2">&quot;trace_id&quot;</span><span class="p">:</span> <span class="n">uuid</span><span class="o">.</span><span class="n">uuid4</span><span class="p">()</span><span class="o">.</span><span class="n">hex</span><span class="p">,</span>
-</span><span id="1-229">            <span class="s2">&quot;span_id&quot;</span><span class="p">:</span> <span class="n">uuid</span><span class="o">.</span><span class="n">uuid4</span><span class="p">()</span><span class="o">.</span><span class="n">hex</span><span class="p">[</span><span class="mi">16</span><span class="p">:],</span>
-</span><span id="1-230">            <span class="s2">&quot;parent_span_id&quot;</span><span class="p">:</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="1-231">            <span class="s2">&quot;dynamic_sampling_context&quot;</span><span class="p">:</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="1-232">        <span class="p">}</span>
-</span><span id="1-233">
+</span><span id="1-211">    <span class="k">def</span> <span class="nf">__copy__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-212">        <span class="c1"># type: () -&gt; Scope</span>
+</span><span id="1-213"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-214"><span class="sd">        Returns a copy of this scope.</span>
+</span><span id="1-215"><span class="sd">        This also creates a copy of all referenced data structures.</span>
+</span><span id="1-216"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-217">        <span class="n">rv</span> <span class="o">=</span> <span class="nb">object</span><span class="o">.</span><span class="fm">__new__</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="vm">__class__</span><span class="p">)</span>  <span class="c1"># type: Scope</span>
+</span><span id="1-218">
+</span><span id="1-219">        <span class="n">rv</span><span class="o">.</span><span class="n">_type</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_type</span>
+</span><span id="1-220">        <span class="n">rv</span><span class="o">.</span><span class="n">_level</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_level</span>
+</span><span id="1-221">        <span class="n">rv</span><span class="o">.</span><span class="n">_name</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_name</span>
+</span><span id="1-222">        <span class="n">rv</span><span class="o">.</span><span class="n">_fingerprint</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_fingerprint</span>
+</span><span id="1-223">        <span class="n">rv</span><span class="o">.</span><span class="n">_transaction</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_transaction</span>
+</span><span id="1-224">        <span class="n">rv</span><span class="o">.</span><span class="n">_transaction_info</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_transaction_info</span><span class="p">)</span>
+</span><span id="1-225">        <span class="n">rv</span><span class="o">.</span><span class="n">_user</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_user</span>
+</span><span id="1-226">
+</span><span id="1-227">        <span class="n">rv</span><span class="o">.</span><span class="n">_tags</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_tags</span><span class="p">)</span>
+</span><span id="1-228">        <span class="n">rv</span><span class="o">.</span><span class="n">_contexts</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_contexts</span><span class="p">)</span>
+</span><span id="1-229">        <span class="n">rv</span><span class="o">.</span><span class="n">_extras</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_extras</span><span class="p">)</span>
+</span><span id="1-230">
+</span><span id="1-231">        <span class="n">rv</span><span class="o">.</span><span class="n">_breadcrumbs</span> <span class="o">=</span> <span class="n">copy</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_breadcrumbs</span><span class="p">)</span>
+</span><span id="1-232">        <span class="n">rv</span><span class="o">.</span><span class="n">_event_processors</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_event_processors</span><span class="p">)</span>
+</span><span id="1-233">        <span class="n">rv</span><span class="o">.</span><span class="n">_error_processors</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_error_processors</span><span class="p">)</span>
+</span><span id="1-234">        <span class="n">rv</span><span class="o">.</span><span class="n">_propagation_context</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span>
+</span><span id="1-235">
+</span><span id="1-236">        <span class="n">rv</span><span class="o">.</span><span class="n">_should_capture</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_should_capture</span>
+</span><span id="1-237">        <span class="n">rv</span><span class="o">.</span><span class="n">_span</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_span</span>
+</span><span id="1-238">        <span class="n">rv</span><span class="o">.</span><span class="n">_session</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_session</span>
+</span><span id="1-239">        <span class="n">rv</span><span class="o">.</span><span class="n">_force_auto_session_tracking</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_force_auto_session_tracking</span>
+</span><span id="1-240">        <span class="n">rv</span><span class="o">.</span><span class="n">_attachments</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_attachments</span><span class="p">)</span>
+</span><span id="1-241">
+</span><span id="1-242">        <span class="n">rv</span><span class="o">.</span><span class="n">_profile</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_profile</span>
+</span><span id="1-243">
+</span><span id="1-244">        <span class="k">return</span> <span class="n">rv</span>
+</span><span id="1-245">
+<div class="viewcode-block" id="Scope.get_current_scope">
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.get_current_scope">[docs]</a>
+</span><span id="1-246">    <span class="nd">@classmethod</span>
+</span><span id="1-247">    <span class="k">def</span> <span class="nf">get_current_scope</span><span class="p">(</span><span class="bp">cls</span><span class="p">):</span>
+</span><span id="1-248">        <span class="c1"># type: () -&gt; Scope</span>
+</span><span id="1-249"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-250"><span class="sd">        .. versionadded:: 2.0.0</span>
+</span><span id="1-251">
+</span><span id="1-252"><span class="sd">        Returns the current scope.</span>
+</span><span id="1-253"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-254">        <span class="n">current_scope</span> <span class="o">=</span> <span class="n">_current_scope</span><span class="o">.</span><span class="n">get</span><span class="p">()</span>
+</span><span id="1-255">        <span class="k">if</span> <span class="n">current_scope</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-256">            <span class="n">current_scope</span> <span class="o">=</span> <span class="n">Scope</span><span class="p">(</span><span class="n">ty</span><span class="o">=</span><span class="n">ScopeType</span><span class="o">.</span><span class="n">CURRENT</span><span class="p">)</span>
+</span><span id="1-257">            <span class="n">_current_scope</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="n">current_scope</span><span class="p">)</span>
+</span><span id="1-258">
+</span><span id="1-259">        <span class="k">return</span> <span class="n">current_scope</span></div>
+
+</span><span id="1-260">
+<div class="viewcode-block" id="Scope.set_current_scope">
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.set_current_scope">[docs]</a>
+</span><span id="1-261">    <span class="nd">@classmethod</span>
+</span><span id="1-262">    <span class="k">def</span> <span class="nf">set_current_scope</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">new_current_scope</span><span class="p">):</span>
+</span><span id="1-263">        <span class="c1"># type: (Scope) -&gt; None</span>
+</span><span id="1-264"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-265"><span class="sd">        .. versionadded:: 2.0.0</span>
+</span><span id="1-266">
+</span><span id="1-267"><span class="sd">        Sets the given scope as the new current scope overwriting the existing current scope.</span>
+</span><span id="1-268"><span class="sd">        :param new_current_scope: The scope to set as the new current scope.</span>
+</span><span id="1-269"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-270">        <span class="n">_current_scope</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="n">new_current_scope</span><span class="p">)</span></div>
+
+</span><span id="1-271">
+<div class="viewcode-block" id="Scope.get_isolation_scope">
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.get_isolation_scope">[docs]</a>
+</span><span id="1-272">    <span class="nd">@classmethod</span>
+</span><span id="1-273">    <span class="k">def</span> <span class="nf">get_isolation_scope</span><span class="p">(</span><span class="bp">cls</span><span class="p">):</span>
+</span><span id="1-274">        <span class="c1"># type: () -&gt; Scope</span>
+</span><span id="1-275"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-276"><span class="sd">        .. versionadded:: 2.0.0</span>
+</span><span id="1-277">
+</span><span id="1-278"><span class="sd">        Returns the isolation scope.</span>
+</span><span id="1-279"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-280">        <span class="n">isolation_scope</span> <span class="o">=</span> <span class="n">_isolation_scope</span><span class="o">.</span><span class="n">get</span><span class="p">()</span>
+</span><span id="1-281">        <span class="k">if</span> <span class="n">isolation_scope</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-282">            <span class="n">isolation_scope</span> <span class="o">=</span> <span class="n">Scope</span><span class="p">(</span><span class="n">ty</span><span class="o">=</span><span class="n">ScopeType</span><span class="o">.</span><span class="n">ISOLATION</span><span class="p">)</span>
+</span><span id="1-283">            <span class="n">_isolation_scope</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="n">isolation_scope</span><span class="p">)</span>
+</span><span id="1-284">
+</span><span id="1-285">        <span class="k">return</span> <span class="n">isolation_scope</span></div>
+
+</span><span id="1-286">
+<div class="viewcode-block" id="Scope.set_isolation_scope">
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.set_isolation_scope">[docs]</a>
+</span><span id="1-287">    <span class="nd">@classmethod</span>
+</span><span id="1-288">    <span class="k">def</span> <span class="nf">set_isolation_scope</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">new_isolation_scope</span><span class="p">):</span>
+</span><span id="1-289">        <span class="c1"># type: (Scope) -&gt; None</span>
+</span><span id="1-290"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-291"><span class="sd">        .. versionadded:: 2.0.0</span>
+</span><span id="1-292">
+</span><span id="1-293"><span class="sd">        Sets the given scope as the new isolation scope overwriting the existing isolation scope.</span>
+</span><span id="1-294"><span class="sd">        :param new_isolation_scope: The scope to set as the new isolation scope.</span>
+</span><span id="1-295"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-296">        <span class="n">_isolation_scope</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="n">new_isolation_scope</span><span class="p">)</span></div>
+
+</span><span id="1-297">
+<div class="viewcode-block" id="Scope.get_global_scope">
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.get_global_scope">[docs]</a>
+</span><span id="1-298">    <span class="nd">@classmethod</span>
+</span><span id="1-299">    <span class="k">def</span> <span class="nf">get_global_scope</span><span class="p">(</span><span class="bp">cls</span><span class="p">):</span>
+</span><span id="1-300">        <span class="c1"># type: () -&gt; Scope</span>
+</span><span id="1-301"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-302"><span class="sd">        .. versionadded:: 2.0.0</span>
+</span><span id="1-303">
+</span><span id="1-304"><span class="sd">        Returns the global scope.</span>
+</span><span id="1-305"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-306">        <span class="k">global</span> <span class="n">_global_scope</span>
+</span><span id="1-307">        <span class="k">if</span> <span class="n">_global_scope</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-308">            <span class="n">_global_scope</span> <span class="o">=</span> <span class="n">Scope</span><span class="p">(</span><span class="n">ty</span><span class="o">=</span><span class="n">ScopeType</span><span class="o">.</span><span class="n">GLOBAL</span><span class="p">)</span>
+</span><span id="1-309">
+</span><span id="1-310">        <span class="k">return</span> <span class="n">_global_scope</span></div>
+
+</span><span id="1-311">
+</span><span id="1-312">    <span class="k">def</span> <span class="nf">_merge_scopes</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">additional_scope</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">additional_scope_kwargs</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+</span><span id="1-313">        <span class="c1"># type: (Optional[Scope], Optional[Dict[str, Any]]) -&gt; Scope</span>
+</span><span id="1-314"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-315"><span class="sd">        Merges global, isolation and current scope into a new scope and</span>
+</span><span id="1-316"><span class="sd">        adds the given additional scope or additional scope kwargs to it.</span>
+</span><span id="1-317"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-318">        <span class="k">if</span> <span class="n">additional_scope</span> <span class="ow">and</span> <span class="n">additional_scope_kwargs</span><span class="p">:</span>
+</span><span id="1-319">            <span class="k">raise</span> <span class="ne">TypeError</span><span class="p">(</span><span class="s2">&quot;cannot provide scope and kwargs&quot;</span><span class="p">)</span>
+</span><span id="1-320">
+</span><span id="1-321">        <span class="n">final_scope</span> <span class="o">=</span> <span class="n">copy</span><span class="p">(</span><span class="n">_global_scope</span><span class="p">)</span> <span class="k">if</span> <span class="n">_global_scope</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="k">else</span> <span class="n">Scope</span><span class="p">()</span>
+</span><span id="1-322">        <span class="n">final_scope</span><span class="o">.</span><span class="n">_type</span> <span class="o">=</span> <span class="n">ScopeType</span><span class="o">.</span><span class="n">MERGED</span>
+</span><span id="1-323">
+</span><span id="1-324">        <span class="n">isolation_scope</span> <span class="o">=</span> <span class="n">_isolation_scope</span><span class="o">.</span><span class="n">get</span><span class="p">()</span>
+</span><span id="1-325">        <span class="k">if</span> <span class="n">isolation_scope</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-326">            <span class="n">final_scope</span><span class="o">.</span><span class="n">update_from_scope</span><span class="p">(</span><span class="n">isolation_scope</span><span class="p">)</span>
+</span><span id="1-327">
+</span><span id="1-328">        <span class="n">current_scope</span> <span class="o">=</span> <span class="n">_current_scope</span><span class="o">.</span><span class="n">get</span><span class="p">()</span>
+</span><span id="1-329">        <span class="k">if</span> <span class="n">current_scope</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-330">            <span class="n">final_scope</span><span class="o">.</span><span class="n">update_from_scope</span><span class="p">(</span><span class="n">current_scope</span><span class="p">)</span>
+</span><span id="1-331">
+</span><span id="1-332">        <span class="k">if</span> <span class="bp">self</span> <span class="o">!=</span> <span class="n">current_scope</span> <span class="ow">and</span> <span class="bp">self</span> <span class="o">!=</span> <span class="n">isolation_scope</span><span class="p">:</span>
+</span><span id="1-333">            <span class="n">final_scope</span><span class="o">.</span><span class="n">update_from_scope</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
+</span><span id="1-334">
+</span><span id="1-335">        <span class="k">if</span> <span class="n">additional_scope</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-336">            <span class="k">if</span> <span class="nb">callable</span><span class="p">(</span><span class="n">additional_scope</span><span class="p">):</span>
+</span><span id="1-337">                <span class="n">additional_scope</span><span class="p">(</span><span class="n">final_scope</span><span class="p">)</span>
+</span><span id="1-338">            <span class="k">else</span><span class="p">:</span>
+</span><span id="1-339">                <span class="n">final_scope</span><span class="o">.</span><span class="n">update_from_scope</span><span class="p">(</span><span class="n">additional_scope</span><span class="p">)</span>
+</span><span id="1-340">
+</span><span id="1-341">        <span class="k">elif</span> <span class="n">additional_scope_kwargs</span><span class="p">:</span>
+</span><span id="1-342">            <span class="n">final_scope</span><span class="o">.</span><span class="n">update_from_kwargs</span><span class="p">(</span><span class="o">**</span><span class="n">additional_scope_kwargs</span><span class="p">)</span>
+</span><span id="1-343">
+</span><span id="1-344">        <span class="k">return</span> <span class="n">final_scope</span>
+</span><span id="1-345">
+<div class="viewcode-block" id="Scope.get_client">
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.get_client">[docs]</a>
+</span><span id="1-346">    <span class="nd">@classmethod</span>
+</span><span id="1-347">    <span class="k">def</span> <span class="nf">get_client</span><span class="p">(</span><span class="bp">cls</span><span class="p">):</span>
+</span><span id="1-348">        <span class="c1"># type: () -&gt; sentry_sdk.client.BaseClient</span>
+</span><span id="1-349"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-350"><span class="sd">        .. versionadded:: 2.0.0</span>
+</span><span id="1-351">
+</span><span id="1-352"><span class="sd">        Returns the currently used :py:class:`sentry_sdk.Client`.</span>
+</span><span id="1-353"><span class="sd">        This checks the current scope, the isolation scope and the global scope for a client.</span>
+</span><span id="1-354"><span class="sd">        If no client is available a :py:class:`sentry_sdk.client.NonRecordingClient` is returned.</span>
+</span><span id="1-355"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-356">        <span class="n">current_scope</span> <span class="o">=</span> <span class="n">_current_scope</span><span class="o">.</span><span class="n">get</span><span class="p">()</span>
+</span><span id="1-357">        <span class="k">try</span><span class="p">:</span>
+</span><span id="1-358">            <span class="n">client</span> <span class="o">=</span> <span class="n">current_scope</span><span class="o">.</span><span class="n">client</span>
+</span><span id="1-359">        <span class="k">except</span> <span class="ne">AttributeError</span><span class="p">:</span>
+</span><span id="1-360">            <span class="n">client</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="1-361">
+</span><span id="1-362">        <span class="k">if</span> <span class="n">client</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">client</span><span class="o">.</span><span class="n">is_active</span><span class="p">():</span>
+</span><span id="1-363">            <span class="k">return</span> <span class="n">client</span>
+</span><span id="1-364">
+</span><span id="1-365">        <span class="n">isolation_scope</span> <span class="o">=</span> <span class="n">_isolation_scope</span><span class="o">.</span><span class="n">get</span><span class="p">()</span>
+</span><span id="1-366">        <span class="k">try</span><span class="p">:</span>
+</span><span id="1-367">            <span class="n">client</span> <span class="o">=</span> <span class="n">isolation_scope</span><span class="o">.</span><span class="n">client</span>
+</span><span id="1-368">        <span class="k">except</span> <span class="ne">AttributeError</span><span class="p">:</span>
+</span><span id="1-369">            <span class="n">client</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="1-370">
+</span><span id="1-371">        <span class="k">if</span> <span class="n">client</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">client</span><span class="o">.</span><span class="n">is_active</span><span class="p">():</span>
+</span><span id="1-372">            <span class="k">return</span> <span class="n">client</span>
+</span><span id="1-373">
+</span><span id="1-374">        <span class="k">try</span><span class="p">:</span>
+</span><span id="1-375">            <span class="n">client</span> <span class="o">=</span> <span class="n">_global_scope</span><span class="o">.</span><span class="n">client</span>  <span class="c1"># type: ignore</span>
+</span><span id="1-376">        <span class="k">except</span> <span class="ne">AttributeError</span><span class="p">:</span>
+</span><span id="1-377">            <span class="n">client</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="1-378">
+</span><span id="1-379">        <span class="k">if</span> <span class="n">client</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">client</span><span class="o">.</span><span class="n">is_active</span><span class="p">():</span>
+</span><span id="1-380">            <span class="k">return</span> <span class="n">client</span>
+</span><span id="1-381">
+</span><span id="1-382">        <span class="k">return</span> <span class="n">NonRecordingClient</span><span class="p">()</span></div>
+
+</span><span id="1-383">
+<div class="viewcode-block" id="Scope.set_client">
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.set_client">[docs]</a>
+</span><span id="1-384">    <span class="k">def</span> <span class="nf">set_client</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">client</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+</span><span id="1-385">        <span class="c1"># type: (Optional[sentry_sdk.client.BaseClient]) -&gt; None</span>
+</span><span id="1-386"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-387"><span class="sd">        .. versionadded:: 2.0.0</span>
+</span><span id="1-388">
+</span><span id="1-389"><span class="sd">        Sets the client for this scope.</span>
+</span><span id="1-390">
+</span><span id="1-391"><span class="sd">        :param client: The client to use in this scope.</span>
+</span><span id="1-392"><span class="sd">            If `None` the client of the scope will be replaced by a :py:class:`sentry_sdk.NonRecordingClient`.</span>
+</span><span id="1-393">
+</span><span id="1-394"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-395">        <span class="bp">self</span><span class="o">.</span><span class="n">client</span> <span class="o">=</span> <span class="n">client</span> <span class="k">if</span> <span class="n">client</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="k">else</span> <span class="n">NonRecordingClient</span><span class="p">()</span></div>
+
+</span><span id="1-396">
+<div class="viewcode-block" id="Scope.fork">
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.fork">[docs]</a>
+</span><span id="1-397">    <span class="k">def</span> <span class="nf">fork</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-398">        <span class="c1"># type: () -&gt; Scope</span>
+</span><span id="1-399"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-400"><span class="sd">        .. versionadded:: 2.0.0</span>
+</span><span id="1-401">
+</span><span id="1-402"><span class="sd">        Returns a fork of this scope.</span>
+</span><span id="1-403"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-404">        <span class="n">forked_scope</span> <span class="o">=</span> <span class="n">copy</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
+</span><span id="1-405">        <span class="k">return</span> <span class="n">forked_scope</span></div>
+
+</span><span id="1-406">
+</span><span id="1-407">    <span class="k">def</span> <span class="nf">_load_trace_data_from_env</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-408">        <span class="c1"># type: () -&gt; Optional[Dict[str, str]]</span>
+</span><span id="1-409"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-410"><span class="sd">        Load Sentry trace id and baggage from environment variables.</span>
+</span><span id="1-411"><span class="sd">        Can be disabled by setting SENTRY_USE_ENVIRONMENT to &quot;false&quot;.</span>
+</span><span id="1-412"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-413">        <span class="n">incoming_trace_information</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="1-414">
+</span><span id="1-415">        <span class="n">sentry_use_environment</span> <span class="o">=</span> <span class="p">(</span>
+</span><span id="1-416">            <span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;SENTRY_USE_ENVIRONMENT&quot;</span><span class="p">)</span> <span class="ow">or</span> <span class="s2">&quot;&quot;</span>
+</span><span id="1-417">        <span class="p">)</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span>
+</span><span id="1-418">        <span class="n">use_environment</span> <span class="o">=</span> <span class="n">sentry_use_environment</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">FALSE_VALUES</span>
+</span><span id="1-419">        <span class="k">if</span> <span class="n">use_environment</span><span class="p">:</span>
+</span><span id="1-420">            <span class="n">incoming_trace_information</span> <span class="o">=</span> <span class="p">{}</span>
+</span><span id="1-421">
+</span><span id="1-422">            <span class="k">if</span> <span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;SENTRY_TRACE&quot;</span><span class="p">):</span>
+</span><span id="1-423">                <span class="n">incoming_trace_information</span><span class="p">[</span><span class="n">SENTRY_TRACE_HEADER_NAME</span><span class="p">]</span> <span class="o">=</span> <span class="p">(</span>
+</span><span id="1-424">                    <span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;SENTRY_TRACE&quot;</span><span class="p">)</span> <span class="ow">or</span> <span class="s2">&quot;&quot;</span>
+</span><span id="1-425">                <span class="p">)</span>
+</span><span id="1-426">
+</span><span id="1-427">            <span class="k">if</span> <span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;SENTRY_BAGGAGE&quot;</span><span class="p">):</span>
+</span><span id="1-428">                <span class="n">incoming_trace_information</span><span class="p">[</span><span class="n">BAGGAGE_HEADER_NAME</span><span class="p">]</span> <span class="o">=</span> <span class="p">(</span>
+</span><span id="1-429">                    <span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;SENTRY_BAGGAGE&quot;</span><span class="p">)</span> <span class="ow">or</span> <span class="s2">&quot;&quot;</span>
+</span><span id="1-430">                <span class="p">)</span>
+</span><span id="1-431">
+</span><span id="1-432">        <span class="k">return</span> <span class="n">incoming_trace_information</span> <span class="ow">or</span> <span class="kc">None</span>
+</span><span id="1-433">
+</span><span id="1-434">    <span class="k">def</span> <span class="nf">_extract_propagation_context</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">data</span><span class="p">):</span>
+</span><span id="1-435">        <span class="c1"># type: (Dict[str, Any]) -&gt; Optional[Dict[str, Any]]</span>
+</span><span id="1-436">        <span class="n">context</span> <span class="o">=</span> <span class="p">{}</span>  <span class="c1"># type: Dict[str, Any]</span>
+</span><span id="1-437">        <span class="n">normalized_data</span> <span class="o">=</span> <span class="n">normalize_incoming_data</span><span class="p">(</span><span class="n">data</span><span class="p">)</span>
+</span><span id="1-438">
+</span><span id="1-439">        <span class="n">baggage_header</span> <span class="o">=</span> <span class="n">normalized_data</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">BAGGAGE_HEADER_NAME</span><span class="p">)</span>
+</span><span id="1-440">        <span class="k">if</span> <span class="n">baggage_header</span><span class="p">:</span>
+</span><span id="1-441">            <span class="n">context</span><span class="p">[</span><span class="s2">&quot;dynamic_sampling_context&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">Baggage</span><span class="o">.</span><span class="n">from_incoming_header</span><span class="p">(</span>
+</span><span id="1-442">                <span class="n">baggage_header</span>
+</span><span id="1-443">            <span class="p">)</span><span class="o">.</span><span class="n">dynamic_sampling_context</span><span class="p">()</span>
+</span><span id="1-444">
+</span><span id="1-445">        <span class="n">sentry_trace_header</span> <span class="o">=</span> <span class="n">normalized_data</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">SENTRY_TRACE_HEADER_NAME</span><span class="p">)</span>
+</span><span id="1-446">        <span class="k">if</span> <span class="n">sentry_trace_header</span><span class="p">:</span>
+</span><span id="1-447">            <span class="n">sentrytrace_data</span> <span class="o">=</span> <span class="n">extract_sentrytrace_data</span><span class="p">(</span><span class="n">sentry_trace_header</span><span class="p">)</span>
+</span><span id="1-448">            <span class="k">if</span> <span class="n">sentrytrace_data</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-449">                <span class="n">context</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">sentrytrace_data</span><span class="p">)</span>
+</span><span id="1-450">
+</span><span id="1-451">        <span class="n">only_baggage_no_sentry_trace</span> <span class="o">=</span> <span class="p">(</span>
+</span><span id="1-452">            <span class="s2">&quot;dynamic_sampling_context&quot;</span> <span class="ow">in</span> <span class="n">context</span> <span class="ow">and</span> <span class="s2">&quot;trace_id&quot;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">context</span>
+</span><span id="1-453">        <span class="p">)</span>
+</span><span id="1-454">        <span class="k">if</span> <span class="n">only_baggage_no_sentry_trace</span><span class="p">:</span>
+</span><span id="1-455">            <span class="n">context</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_create_new_propagation_context</span><span class="p">())</span>
+</span><span id="1-456">
+</span><span id="1-457">        <span class="k">if</span> <span class="n">context</span><span class="p">:</span>
+</span><span id="1-458">            <span class="k">if</span> <span class="ow">not</span> <span class="n">context</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;span_id&quot;</span><span class="p">):</span>
+</span><span id="1-459">                <span class="n">context</span><span class="p">[</span><span class="s2">&quot;span_id&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">uuid</span><span class="o">.</span><span class="n">uuid4</span><span class="p">()</span><span class="o">.</span><span class="n">hex</span><span class="p">[</span><span class="mi">16</span><span class="p">:]</span>
+</span><span id="1-460">
+</span><span id="1-461">            <span class="k">return</span> <span class="n">context</span>
+</span><span id="1-462">
+</span><span id="1-463">        <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-464">
+</span><span id="1-465">    <span class="k">def</span> <span class="nf">_create_new_propagation_context</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-466">        <span class="c1"># type: () -&gt; Dict[str, Any]</span>
+</span><span id="1-467">        <span class="k">return</span> <span class="p">{</span>
+</span><span id="1-468">            <span class="s2">&quot;trace_id&quot;</span><span class="p">:</span> <span class="n">uuid</span><span class="o">.</span><span class="n">uuid4</span><span class="p">()</span><span class="o">.</span><span class="n">hex</span><span class="p">,</span>
+</span><span id="1-469">            <span class="s2">&quot;span_id&quot;</span><span class="p">:</span> <span class="n">uuid</span><span class="o">.</span><span class="n">uuid4</span><span class="p">()</span><span class="o">.</span><span class="n">hex</span><span class="p">[</span><span class="mi">16</span><span class="p">:],</span>
+</span><span id="1-470">            <span class="s2">&quot;parent_span_id&quot;</span><span class="p">:</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="1-471">            <span class="s2">&quot;dynamic_sampling_context&quot;</span><span class="p">:</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="1-472">        <span class="p">}</span>
+</span><span id="1-473">
 <div class="viewcode-block" id="Scope.set_new_propagation_context">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Scope.set_new_propagation_context">[docs]</a>
-</span><span id="1-234">    <span class="k">def</span> <span class="nf">set_new_propagation_context</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-235">        <span class="c1"># type: () -&gt; None</span>
-</span><span id="1-236"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-237"><span class="sd">        Creates a new propagation context and sets it as `_propagation_context`. Overwriting existing one.</span>
-</span><span id="1-238"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-239">        <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_create_new_propagation_context</span><span class="p">()</span>
-</span><span id="1-240">        <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span>
-</span><span id="1-241">            <span class="s2">&quot;[Tracing] Create new propagation context: </span><span class="si">%s</span><span class="s2">&quot;</span><span class="p">,</span>
-</span><span id="1-242">            <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span><span class="p">,</span>
-</span><span id="1-243">        <span class="p">)</span></div>
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.set_new_propagation_context">[docs]</a>
+</span><span id="1-474">    <span class="k">def</span> <span class="nf">set_new_propagation_context</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-475">        <span class="c1"># type: () -&gt; None</span>
+</span><span id="1-476"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-477"><span class="sd">        Creates a new propagation context and sets it as `_propagation_context`. Overwriting existing one.</span>
+</span><span id="1-478"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-479">        <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_create_new_propagation_context</span><span class="p">()</span>
+</span><span id="1-480">        <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span>
+</span><span id="1-481">            <span class="s2">&quot;[Tracing] Create new propagation context: </span><span class="si">%s</span><span class="s2">&quot;</span><span class="p">,</span>
+</span><span id="1-482">            <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span><span class="p">,</span>
+</span><span id="1-483">        <span class="p">)</span></div>
 
-</span><span id="1-244">
+</span><span id="1-484">
 <div class="viewcode-block" id="Scope.generate_propagation_context">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Scope.generate_propagation_context">[docs]</a>
-</span><span id="1-245">    <span class="k">def</span> <span class="nf">generate_propagation_context</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">incoming_data</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-</span><span id="1-246">        <span class="c1"># type: (Optional[Dict[str, str]]) -&gt; None</span>
-</span><span id="1-247"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-248"><span class="sd">        Makes sure `_propagation_context` is set.</span>
-</span><span id="1-249"><span class="sd">        If there is `incoming_data` overwrite existing `_propagation_context`.</span>
-</span><span id="1-250"><span class="sd">        if there is no `incoming_data` create new `_propagation_context`, but do NOT overwrite if already existing.</span>
-</span><span id="1-251"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-252">        <span class="k">if</span> <span class="n">incoming_data</span><span class="p">:</span>
-</span><span id="1-253">            <span class="n">context</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_extract_propagation_context</span><span class="p">(</span><span class="n">incoming_data</span><span class="p">)</span>
-</span><span id="1-254">
-</span><span id="1-255">            <span class="k">if</span> <span class="n">context</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-256">                <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span> <span class="o">=</span> <span class="n">context</span>
-</span><span id="1-257">                <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span>
-</span><span id="1-258">                    <span class="s2">&quot;[Tracing] Extracted propagation context from incoming data: </span><span class="si">%s</span><span class="s2">&quot;</span><span class="p">,</span>
-</span><span id="1-259">                    <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span><span class="p">,</span>
-</span><span id="1-260">                <span class="p">)</span>
-</span><span id="1-261">
-</span><span id="1-262">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-263">            <span class="bp">self</span><span class="o">.</span><span class="n">set_new_propagation_context</span><span class="p">()</span></div>
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.generate_propagation_context">[docs]</a>
+</span><span id="1-485">    <span class="k">def</span> <span class="nf">generate_propagation_context</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">incoming_data</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+</span><span id="1-486">        <span class="c1"># type: (Optional[Dict[str, str]]) -&gt; None</span>
+</span><span id="1-487"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-488"><span class="sd">        Makes sure the propagation context (`_propagation_context`) is set.</span>
+</span><span id="1-489"><span class="sd">        The propagation context only lives on the current scope.</span>
+</span><span id="1-490"><span class="sd">        If there is `incoming_data` overwrite existing `_propagation_context`.</span>
+</span><span id="1-491"><span class="sd">        if there is no `incoming_data` create new `_propagation_context`, but do NOT overwrite if already existing.</span>
+</span><span id="1-492"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-493">        <span class="k">if</span> <span class="n">incoming_data</span><span class="p">:</span>
+</span><span id="1-494">            <span class="n">context</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_extract_propagation_context</span><span class="p">(</span><span class="n">incoming_data</span><span class="p">)</span>
+</span><span id="1-495">
+</span><span id="1-496">            <span class="k">if</span> <span class="n">context</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-497">                <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span> <span class="o">=</span> <span class="n">context</span>
+</span><span id="1-498">                <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span>
+</span><span id="1-499">                    <span class="s2">&quot;[Tracing] Extracted propagation context from incoming data: </span><span class="si">%s</span><span class="s2">&quot;</span><span class="p">,</span>
+</span><span id="1-500">                    <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span><span class="p">,</span>
+</span><span id="1-501">                <span class="p">)</span>
+</span><span id="1-502">
+</span><span id="1-503">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span> <span class="ow">is</span> <span class="kc">None</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">_type</span> <span class="o">!=</span> <span class="n">ScopeType</span><span class="o">.</span><span class="n">CURRENT</span><span class="p">:</span>
+</span><span id="1-504">            <span class="bp">self</span><span class="o">.</span><span class="n">set_new_propagation_context</span><span class="p">()</span></div>
 
-</span><span id="1-264">
+</span><span id="1-505">
 <div class="viewcode-block" id="Scope.get_dynamic_sampling_context">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Scope.get_dynamic_sampling_context">[docs]</a>
-</span><span id="1-265">    <span class="k">def</span> <span class="nf">get_dynamic_sampling_context</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-266">        <span class="c1"># type: () -&gt; Optional[Dict[str, str]]</span>
-</span><span id="1-267"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-268"><span class="sd">        Returns the Dynamic Sampling Context from the Propagation Context.</span>
-</span><span id="1-269"><span class="sd">        If not existing, creates a new one.</span>
-</span><span id="1-270"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-271">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-272">            <span class="k">return</span> <span class="kc">None</span>
-</span><span id="1-273">
-</span><span id="1-274">        <span class="n">baggage</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_baggage</span><span class="p">()</span>
-</span><span id="1-275">        <span class="k">if</span> <span class="n">baggage</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-276">            <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span><span class="p">[</span><span class="s2">&quot;dynamic_sampling_context&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="p">(</span>
-</span><span id="1-277">                <span class="n">baggage</span><span class="o">.</span><span class="n">dynamic_sampling_context</span><span class="p">()</span>
-</span><span id="1-278">            <span class="p">)</span>
-</span><span id="1-279">
-</span><span id="1-280">        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span><span class="p">[</span><span class="s2">&quot;dynamic_sampling_context&quot;</span><span class="p">]</span></div>
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.get_dynamic_sampling_context">[docs]</a>
+</span><span id="1-506">    <span class="k">def</span> <span class="nf">get_dynamic_sampling_context</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-507">        <span class="c1"># type: () -&gt; Optional[Dict[str, str]]</span>
+</span><span id="1-508"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-509"><span class="sd">        Returns the Dynamic Sampling Context from the Propagation Context.</span>
+</span><span id="1-510"><span class="sd">        If not existing, creates a new one.</span>
+</span><span id="1-511"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-512">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-513">            <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-514">
+</span><span id="1-515">        <span class="n">baggage</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_baggage</span><span class="p">()</span>
+</span><span id="1-516">        <span class="k">if</span> <span class="n">baggage</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-517">            <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span><span class="p">[</span><span class="s2">&quot;dynamic_sampling_context&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="p">(</span>
+</span><span id="1-518">                <span class="n">baggage</span><span class="o">.</span><span class="n">dynamic_sampling_context</span><span class="p">()</span>
+</span><span id="1-519">            <span class="p">)</span>
+</span><span id="1-520">
+</span><span id="1-521">        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span><span class="p">[</span><span class="s2">&quot;dynamic_sampling_context&quot;</span><span class="p">]</span></div>
 
-</span><span id="1-281">
+</span><span id="1-522">
 <div class="viewcode-block" id="Scope.get_traceparent">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Scope.get_traceparent">[docs]</a>
-</span><span id="1-282">    <span class="k">def</span> <span class="nf">get_traceparent</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-</span><span id="1-283">        <span class="c1"># type: (Any, Any) -&gt; Optional[str]</span>
-</span><span id="1-284"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-285"><span class="sd">        Returns the Sentry &quot;sentry-trace&quot; header (aka the traceparent) from the</span>
-</span><span id="1-286"><span class="sd">        currently active span or the scopes Propagation Context.</span>
-</span><span id="1-287"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-288">        <span class="n">client</span> <span class="o">=</span> <span class="n">kwargs</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s2">&quot;client&quot;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-</span><span id="1-289">
-</span><span id="1-290">        <span class="c1"># If we have an active span, return traceparent from there</span>
-</span><span id="1-291">        <span class="k">if</span> <span class="p">(</span>
-</span><span id="1-292">            <span class="n">client</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span>
-</span><span id="1-293">            <span class="ow">and</span> <span class="n">has_tracing_enabled</span><span class="p">(</span><span class="n">client</span><span class="o">.</span><span class="n">options</span><span class="p">)</span>
-</span><span id="1-294">            <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">span</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span>
-</span><span id="1-295">        <span class="p">):</span>
-</span><span id="1-296">            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">span</span><span class="o">.</span><span class="n">to_traceparent</span><span class="p">()</span>
-</span><span id="1-297">
-</span><span id="1-298">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-299">            <span class="k">return</span> <span class="kc">None</span>
-</span><span id="1-300">
-</span><span id="1-301">        <span class="n">traceparent</span> <span class="o">=</span> <span class="s2">&quot;</span><span class="si">%s</span><span class="s2">-</span><span class="si">%s</span><span class="s2">&quot;</span> <span class="o">%</span> <span class="p">(</span>
-</span><span id="1-302">            <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span><span class="p">[</span><span class="s2">&quot;trace_id&quot;</span><span class="p">],</span>
-</span><span id="1-303">            <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span><span class="p">[</span><span class="s2">&quot;span_id&quot;</span><span class="p">],</span>
-</span><span id="1-304">        <span class="p">)</span>
-</span><span id="1-305">        <span class="k">return</span> <span class="n">traceparent</span></div>
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.get_traceparent">[docs]</a>
+</span><span id="1-523">    <span class="k">def</span> <span class="nf">get_traceparent</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
+</span><span id="1-524">        <span class="c1"># type: (Any, Any) -&gt; Optional[str]</span>
+</span><span id="1-525"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-526"><span class="sd">        Returns the Sentry &quot;sentry-trace&quot; header (aka the traceparent) from the</span>
+</span><span id="1-527"><span class="sd">        currently active span or the scopes Propagation Context.</span>
+</span><span id="1-528"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-529">        <span class="n">client</span> <span class="o">=</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_client</span><span class="p">()</span>
+</span><span id="1-530">
+</span><span id="1-531">        <span class="c1"># If we have an active span, return traceparent from there</span>
+</span><span id="1-532">        <span class="k">if</span> <span class="n">has_tracing_enabled</span><span class="p">(</span><span class="n">client</span><span class="o">.</span><span class="n">options</span><span class="p">)</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">span</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-533">            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">span</span><span class="o">.</span><span class="n">to_traceparent</span><span class="p">()</span>
+</span><span id="1-534">
+</span><span id="1-535">        <span class="c1"># If this scope has a propagation context, return traceparent from there</span>
+</span><span id="1-536">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-537">            <span class="n">traceparent</span> <span class="o">=</span> <span class="s2">&quot;</span><span class="si">%s</span><span class="s2">-</span><span class="si">%s</span><span class="s2">&quot;</span> <span class="o">%</span> <span class="p">(</span>
+</span><span id="1-538">                <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span><span class="p">[</span><span class="s2">&quot;trace_id&quot;</span><span class="p">],</span>
+</span><span id="1-539">                <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span><span class="p">[</span><span class="s2">&quot;span_id&quot;</span><span class="p">],</span>
+</span><span id="1-540">            <span class="p">)</span>
+</span><span id="1-541">            <span class="k">return</span> <span class="n">traceparent</span>
+</span><span id="1-542">
+</span><span id="1-543">        <span class="c1"># Fall back to isolation scope&#39;s traceparent. It always has one</span>
+</span><span id="1-544">        <span class="k">return</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_isolation_scope</span><span class="p">()</span><span class="o">.</span><span class="n">get_traceparent</span><span class="p">()</span></div>
 
-</span><span id="1-306">
-</span><span id="1-307">    <span class="k">def</span> <span class="nf">get_baggage</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-</span><span id="1-308">        <span class="c1"># type: (Any, Any) -&gt; Optional[Baggage]</span>
-</span><span id="1-309">        <span class="n">client</span> <span class="o">=</span> <span class="n">kwargs</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s2">&quot;client&quot;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-</span><span id="1-310">
-</span><span id="1-311">        <span class="c1"># If we have an active span, return baggage from there</span>
-</span><span id="1-312">        <span class="k">if</span> <span class="p">(</span>
-</span><span id="1-313">            <span class="n">client</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span>
-</span><span id="1-314">            <span class="ow">and</span> <span class="n">has_tracing_enabled</span><span class="p">(</span><span class="n">client</span><span class="o">.</span><span class="n">options</span><span class="p">)</span>
-</span><span id="1-315">            <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">span</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span>
-</span><span id="1-316">        <span class="p">):</span>
-</span><span id="1-317">            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">span</span><span class="o">.</span><span class="n">to_baggage</span><span class="p">()</span>
-</span><span id="1-318">
-</span><span id="1-319">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-320">            <span class="k">return</span> <span class="kc">None</span>
-</span><span id="1-321">
-</span><span id="1-322">        <span class="n">dynamic_sampling_context</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span><span class="o">.</span><span class="n">get</span><span class="p">(</span>
-</span><span id="1-323">            <span class="s2">&quot;dynamic_sampling_context&quot;</span>
-</span><span id="1-324">        <span class="p">)</span>
-</span><span id="1-325">        <span class="k">if</span> <span class="n">dynamic_sampling_context</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-326">            <span class="k">return</span> <span class="n">Baggage</span><span class="o">.</span><span class="n">from_options</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-</span><span id="1-327">        <span class="k">else</span><span class="p">:</span>
-</span><span id="1-328">            <span class="k">return</span> <span class="n">Baggage</span><span class="p">(</span><span class="n">dynamic_sampling_context</span><span class="p">)</span>
-</span><span id="1-329">
+</span><span id="1-545">
+<div class="viewcode-block" id="Scope.get_baggage">
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.get_baggage">[docs]</a>
+</span><span id="1-546">    <span class="k">def</span> <span class="nf">get_baggage</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
+</span><span id="1-547">        <span class="c1"># type: (Any, Any) -&gt; Optional[Baggage]</span>
+</span><span id="1-548"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-549"><span class="sd">        Returns the Sentry &quot;baggage&quot; header containing trace information from the</span>
+</span><span id="1-550"><span class="sd">        currently active span or the scopes Propagation Context.</span>
+</span><span id="1-551"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-552">        <span class="n">client</span> <span class="o">=</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_client</span><span class="p">()</span>
+</span><span id="1-553">
+</span><span id="1-554">        <span class="c1"># If we have an active span, return baggage from there</span>
+</span><span id="1-555">        <span class="k">if</span> <span class="n">has_tracing_enabled</span><span class="p">(</span><span class="n">client</span><span class="o">.</span><span class="n">options</span><span class="p">)</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">span</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-556">            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">span</span><span class="o">.</span><span class="n">to_baggage</span><span class="p">()</span>
+</span><span id="1-557">
+</span><span id="1-558">        <span class="c1"># If this scope has a propagation context, return baggage from there</span>
+</span><span id="1-559">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-560">            <span class="n">dynamic_sampling_context</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span><span class="o">.</span><span class="n">get</span><span class="p">(</span>
+</span><span id="1-561">                <span class="s2">&quot;dynamic_sampling_context&quot;</span>
+</span><span id="1-562">            <span class="p">)</span>
+</span><span id="1-563">            <span class="k">if</span> <span class="n">dynamic_sampling_context</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-564">                <span class="k">return</span> <span class="n">Baggage</span><span class="o">.</span><span class="n">from_options</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
+</span><span id="1-565">            <span class="k">else</span><span class="p">:</span>
+</span><span id="1-566">                <span class="k">return</span> <span class="n">Baggage</span><span class="p">(</span><span class="n">dynamic_sampling_context</span><span class="p">)</span>
+</span><span id="1-567">
+</span><span id="1-568">        <span class="c1"># Fall back to isolation scope&#39;s baggage. It always has one</span>
+</span><span id="1-569">        <span class="k">return</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_isolation_scope</span><span class="p">()</span><span class="o">.</span><span class="n">get_baggage</span><span class="p">()</span></div>
+
+</span><span id="1-570">
 <div class="viewcode-block" id="Scope.get_trace_context">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Scope.get_trace_context">[docs]</a>
-</span><span id="1-330">    <span class="k">def</span> <span class="nf">get_trace_context</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-331">        <span class="c1"># type: () -&gt; Any</span>
-</span><span id="1-332"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-333"><span class="sd">        Returns the Sentry &quot;trace&quot; context from the Propagation Context.</span>
-</span><span id="1-334"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-335">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-336">            <span class="k">return</span> <span class="kc">None</span>
-</span><span id="1-337">
-</span><span id="1-338">        <span class="n">trace_context</span> <span class="o">=</span> <span class="p">{</span>
-</span><span id="1-339">            <span class="s2">&quot;trace_id&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span><span class="p">[</span><span class="s2">&quot;trace_id&quot;</span><span class="p">],</span>
-</span><span id="1-340">            <span class="s2">&quot;span_id&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span><span class="p">[</span><span class="s2">&quot;span_id&quot;</span><span class="p">],</span>
-</span><span id="1-341">            <span class="s2">&quot;parent_span_id&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span><span class="p">[</span><span class="s2">&quot;parent_span_id&quot;</span><span class="p">],</span>
-</span><span id="1-342">            <span class="s2">&quot;dynamic_sampling_context&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_dynamic_sampling_context</span><span class="p">(),</span>
-</span><span id="1-343">        <span class="p">}</span>  <span class="c1"># type: Dict[str, Any]</span>
-</span><span id="1-344">
-</span><span id="1-345">        <span class="k">return</span> <span class="n">trace_context</span></div>
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.get_trace_context">[docs]</a>
+</span><span id="1-571">    <span class="k">def</span> <span class="nf">get_trace_context</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-572">        <span class="c1"># type: () -&gt; Any</span>
+</span><span id="1-573"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-574"><span class="sd">        Returns the Sentry &quot;trace&quot; context from the Propagation Context.</span>
+</span><span id="1-575"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-576">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-577">            <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-578">
+</span><span id="1-579">        <span class="n">trace_context</span> <span class="o">=</span> <span class="p">{</span>
+</span><span id="1-580">            <span class="s2">&quot;trace_id&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span><span class="p">[</span><span class="s2">&quot;trace_id&quot;</span><span class="p">],</span>
+</span><span id="1-581">            <span class="s2">&quot;span_id&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span><span class="p">[</span><span class="s2">&quot;span_id&quot;</span><span class="p">],</span>
+</span><span id="1-582">            <span class="s2">&quot;parent_span_id&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span><span class="p">[</span><span class="s2">&quot;parent_span_id&quot;</span><span class="p">],</span>
+</span><span id="1-583">            <span class="s2">&quot;dynamic_sampling_context&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_dynamic_sampling_context</span><span class="p">(),</span>
+</span><span id="1-584">        <span class="p">}</span>  <span class="c1"># type: Dict[str, Any]</span>
+</span><span id="1-585">
+</span><span id="1-586">        <span class="k">return</span> <span class="n">trace_context</span></div>
 
-</span><span id="1-346">
+</span><span id="1-587">
 <div class="viewcode-block" id="Scope.trace_propagation_meta">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Scope.trace_propagation_meta">[docs]</a>
-</span><span id="1-347">    <span class="k">def</span> <span class="nf">trace_propagation_meta</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-</span><span id="1-348">        <span class="c1"># type: (*Any, **Any) -&gt; str</span>
-</span><span id="1-349"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-350"><span class="sd">        Return meta tags which should be injected into HTML templates</span>
-</span><span id="1-351"><span class="sd">        to allow propagation of trace information.</span>
-</span><span id="1-352"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-353">        <span class="n">span</span> <span class="o">=</span> <span class="n">kwargs</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s2">&quot;span&quot;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-</span><span id="1-354">        <span class="k">if</span> <span class="n">span</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-355">            <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
-</span><span id="1-356">                <span class="s2">&quot;The parameter `span` in trace_propagation_meta() is deprecated and will be removed in the future.&quot;</span>
-</span><span id="1-357">            <span class="p">)</span>
-</span><span id="1-358">
-</span><span id="1-359">        <span class="n">client</span> <span class="o">=</span> <span class="n">kwargs</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s2">&quot;client&quot;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-</span><span id="1-360">
-</span><span id="1-361">        <span class="n">meta</span> <span class="o">=</span> <span class="s2">&quot;&quot;</span>
-</span><span id="1-362">
-</span><span id="1-363">        <span class="n">sentry_trace</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_traceparent</span><span class="p">(</span><span class="n">client</span><span class="o">=</span><span class="n">client</span><span class="p">)</span>
-</span><span id="1-364">        <span class="k">if</span> <span class="n">sentry_trace</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-365">            <span class="n">meta</span> <span class="o">+=</span> <span class="s1">&#39;&lt;meta name=&quot;</span><span class="si">%s</span><span class="s1">&quot; content=&quot;</span><span class="si">%s</span><span class="s1">&quot;&gt;&#39;</span> <span class="o">%</span> <span class="p">(</span>
-</span><span id="1-366">                <span class="n">SENTRY_TRACE_HEADER_NAME</span><span class="p">,</span>
-</span><span id="1-367">                <span class="n">sentry_trace</span><span class="p">,</span>
-</span><span id="1-368">            <span class="p">)</span>
-</span><span id="1-369">
-</span><span id="1-370">        <span class="n">baggage</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_baggage</span><span class="p">(</span><span class="n">client</span><span class="o">=</span><span class="n">client</span><span class="p">)</span>
-</span><span id="1-371">        <span class="k">if</span> <span class="n">baggage</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-372">            <span class="n">meta</span> <span class="o">+=</span> <span class="s1">&#39;&lt;meta name=&quot;</span><span class="si">%s</span><span class="s1">&quot; content=&quot;</span><span class="si">%s</span><span class="s1">&quot;&gt;&#39;</span> <span class="o">%</span> <span class="p">(</span>
-</span><span id="1-373">                <span class="n">BAGGAGE_HEADER_NAME</span><span class="p">,</span>
-</span><span id="1-374">                <span class="n">baggage</span><span class="o">.</span><span class="n">serialize</span><span class="p">(),</span>
-</span><span id="1-375">            <span class="p">)</span>
-</span><span id="1-376">
-</span><span id="1-377">        <span class="k">return</span> <span class="n">meta</span></div>
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.trace_propagation_meta">[docs]</a>
+</span><span id="1-588">    <span class="k">def</span> <span class="nf">trace_propagation_meta</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
+</span><span id="1-589">        <span class="c1"># type: (*Any, **Any) -&gt; str</span>
+</span><span id="1-590"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-591"><span class="sd">        Return meta tags which should be injected into HTML templates</span>
+</span><span id="1-592"><span class="sd">        to allow propagation of trace information.</span>
+</span><span id="1-593"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-594">        <span class="n">span</span> <span class="o">=</span> <span class="n">kwargs</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s2">&quot;span&quot;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
+</span><span id="1-595">        <span class="k">if</span> <span class="n">span</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-596">            <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
+</span><span id="1-597">                <span class="s2">&quot;The parameter `span` in trace_propagation_meta() is deprecated and will be removed in the future.&quot;</span>
+</span><span id="1-598">            <span class="p">)</span>
+</span><span id="1-599">
+</span><span id="1-600">        <span class="n">meta</span> <span class="o">=</span> <span class="s2">&quot;&quot;</span>
+</span><span id="1-601">
+</span><span id="1-602">        <span class="n">sentry_trace</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_traceparent</span><span class="p">()</span>
+</span><span id="1-603">        <span class="k">if</span> <span class="n">sentry_trace</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-604">            <span class="n">meta</span> <span class="o">+=</span> <span class="s1">&#39;&lt;meta name=&quot;</span><span class="si">%s</span><span class="s1">&quot; content=&quot;</span><span class="si">%s</span><span class="s1">&quot;&gt;&#39;</span> <span class="o">%</span> <span class="p">(</span>
+</span><span id="1-605">                <span class="n">SENTRY_TRACE_HEADER_NAME</span><span class="p">,</span>
+</span><span id="1-606">                <span class="n">sentry_trace</span><span class="p">,</span>
+</span><span id="1-607">            <span class="p">)</span>
+</span><span id="1-608">
+</span><span id="1-609">        <span class="n">baggage</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_baggage</span><span class="p">()</span>
+</span><span id="1-610">        <span class="k">if</span> <span class="n">baggage</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-611">            <span class="n">meta</span> <span class="o">+=</span> <span class="s1">&#39;&lt;meta name=&quot;</span><span class="si">%s</span><span class="s1">&quot; content=&quot;</span><span class="si">%s</span><span class="s1">&quot;&gt;&#39;</span> <span class="o">%</span> <span class="p">(</span>
+</span><span id="1-612">                <span class="n">BAGGAGE_HEADER_NAME</span><span class="p">,</span>
+</span><span id="1-613">                <span class="n">baggage</span><span class="o">.</span><span class="n">serialize</span><span class="p">(),</span>
+</span><span id="1-614">            <span class="p">)</span>
+</span><span id="1-615">
+</span><span id="1-616">        <span class="k">return</span> <span class="n">meta</span></div>
 
-</span><span id="1-378">
+</span><span id="1-617">
 <div class="viewcode-block" id="Scope.iter_headers">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Scope.iter_headers">[docs]</a>
-</span><span id="1-379">    <span class="k">def</span> <span class="nf">iter_headers</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-380">        <span class="c1"># type: () -&gt; Iterator[Tuple[str, str]]</span>
-</span><span id="1-381"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-382"><span class="sd">        Creates a generator which returns the `sentry-trace` and `baggage` headers from the Propagation Context.</span>
-</span><span id="1-383"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-384">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-385">            <span class="n">traceparent</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_traceparent</span><span class="p">()</span>
-</span><span id="1-386">            <span class="k">if</span> <span class="n">traceparent</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-387">                <span class="k">yield</span> <span class="n">SENTRY_TRACE_HEADER_NAME</span><span class="p">,</span> <span class="n">traceparent</span>
-</span><span id="1-388">
-</span><span id="1-389">            <span class="n">dsc</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_dynamic_sampling_context</span><span class="p">()</span>
-</span><span id="1-390">            <span class="k">if</span> <span class="n">dsc</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-391">                <span class="n">baggage</span> <span class="o">=</span> <span class="n">Baggage</span><span class="p">(</span><span class="n">dsc</span><span class="p">)</span><span class="o">.</span><span class="n">serialize</span><span class="p">()</span>
-</span><span id="1-392">                <span class="k">yield</span> <span class="n">BAGGAGE_HEADER_NAME</span><span class="p">,</span> <span class="n">baggage</span></div>
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.iter_headers">[docs]</a>
+</span><span id="1-618">    <span class="k">def</span> <span class="nf">iter_headers</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-619">        <span class="c1"># type: () -&gt; Iterator[Tuple[str, str]]</span>
+</span><span id="1-620"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-621"><span class="sd">        Creates a generator which returns the `sentry-trace` and `baggage` headers from the Propagation Context.</span>
+</span><span id="1-622"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-623">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-624">            <span class="n">traceparent</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_traceparent</span><span class="p">()</span>
+</span><span id="1-625">            <span class="k">if</span> <span class="n">traceparent</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-626">                <span class="k">yield</span> <span class="n">SENTRY_TRACE_HEADER_NAME</span><span class="p">,</span> <span class="n">traceparent</span>
+</span><span id="1-627">
+</span><span id="1-628">            <span class="n">dsc</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_dynamic_sampling_context</span><span class="p">()</span>
+</span><span id="1-629">            <span class="k">if</span> <span class="n">dsc</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-630">                <span class="n">baggage</span> <span class="o">=</span> <span class="n">Baggage</span><span class="p">(</span><span class="n">dsc</span><span class="p">)</span><span class="o">.</span><span class="n">serialize</span><span class="p">()</span>
+</span><span id="1-631">                <span class="k">yield</span> <span class="n">BAGGAGE_HEADER_NAME</span><span class="p">,</span> <span class="n">baggage</span></div>
 
-</span><span id="1-393">
+</span><span id="1-632">
 <div class="viewcode-block" id="Scope.iter_trace_propagation_headers">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Scope.iter_trace_propagation_headers">[docs]</a>
-</span><span id="1-394">    <span class="k">def</span> <span class="nf">iter_trace_propagation_headers</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-</span><span id="1-395">        <span class="c1"># type: (Any, Any) -&gt; Generator[Tuple[str, str], None, None]</span>
-</span><span id="1-396"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-397"><span class="sd">        Return HTTP headers which allow propagation of trace data. Data taken</span>
-</span><span id="1-398"><span class="sd">        from the span representing the request, if available, or the current</span>
-</span><span id="1-399"><span class="sd">        span on the scope if not.</span>
-</span><span id="1-400"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-401">        <span class="n">span</span> <span class="o">=</span> <span class="n">kwargs</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s2">&quot;span&quot;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-</span><span id="1-402">        <span class="n">client</span> <span class="o">=</span> <span class="n">kwargs</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s2">&quot;client&quot;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-</span><span id="1-403">
-</span><span id="1-404">        <span class="n">propagate_traces</span> <span class="o">=</span> <span class="n">client</span> <span class="ow">and</span> <span class="n">client</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;propagate_traces&quot;</span><span class="p">]</span>
-</span><span id="1-405">        <span class="k">if</span> <span class="ow">not</span> <span class="n">propagate_traces</span><span class="p">:</span>
-</span><span id="1-406">            <span class="k">return</span>
-</span><span id="1-407">
-</span><span id="1-408">        <span class="n">span</span> <span class="o">=</span> <span class="n">span</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">span</span>
-</span><span id="1-409">
-</span><span id="1-410">        <span class="k">if</span> <span class="n">client</span> <span class="ow">and</span> <span class="n">has_tracing_enabled</span><span class="p">(</span><span class="n">client</span><span class="o">.</span><span class="n">options</span><span class="p">)</span> <span class="ow">and</span> <span class="n">span</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-411">            <span class="k">for</span> <span class="n">header</span> <span class="ow">in</span> <span class="n">span</span><span class="o">.</span><span class="n">iter_headers</span><span class="p">():</span>
-</span><span id="1-412">                <span class="k">yield</span> <span class="n">header</span>
-</span><span id="1-413">        <span class="k">else</span><span class="p">:</span>
-</span><span id="1-414">            <span class="k">for</span> <span class="n">header</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">iter_headers</span><span class="p">():</span>
-</span><span id="1-415">                <span class="k">yield</span> <span class="n">header</span></div>
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.iter_trace_propagation_headers">[docs]</a>
+</span><span id="1-633">    <span class="k">def</span> <span class="nf">iter_trace_propagation_headers</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
+</span><span id="1-634">        <span class="c1"># type: (Any, Any) -&gt; Generator[Tuple[str, str], None, None]</span>
+</span><span id="1-635"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-636"><span class="sd">        Return HTTP headers which allow propagation of trace data. Data taken</span>
+</span><span id="1-637"><span class="sd">        from the span representing the request, if available, or the current</span>
+</span><span id="1-638"><span class="sd">        span on the scope if not.</span>
+</span><span id="1-639"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-640">        <span class="n">client</span> <span class="o">=</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_client</span><span class="p">()</span>
+</span><span id="1-641">        <span class="k">if</span> <span class="ow">not</span> <span class="n">client</span><span class="o">.</span><span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;propagate_traces&quot;</span><span class="p">):</span>
+</span><span id="1-642">            <span class="k">return</span>
+</span><span id="1-643">
+</span><span id="1-644">        <span class="n">span</span> <span class="o">=</span> <span class="n">kwargs</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s2">&quot;span&quot;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
+</span><span id="1-645">        <span class="n">span</span> <span class="o">=</span> <span class="n">span</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">span</span>
+</span><span id="1-646">
+</span><span id="1-647">        <span class="k">if</span> <span class="n">has_tracing_enabled</span><span class="p">(</span><span class="n">client</span><span class="o">.</span><span class="n">options</span><span class="p">)</span> <span class="ow">and</span> <span class="n">span</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-648">            <span class="k">for</span> <span class="n">header</span> <span class="ow">in</span> <span class="n">span</span><span class="o">.</span><span class="n">iter_headers</span><span class="p">():</span>
+</span><span id="1-649">                <span class="k">yield</span> <span class="n">header</span>
+</span><span id="1-650">        <span class="k">else</span><span class="p">:</span>
+</span><span id="1-651">            <span class="c1"># If this scope has a propagation context, return headers from there</span>
+</span><span id="1-652">            <span class="c1"># (it could be that self is not the current scope nor the isolation scope)</span>
+</span><span id="1-653">            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-654">                <span class="k">for</span> <span class="n">header</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">iter_headers</span><span class="p">():</span>
+</span><span id="1-655">                    <span class="k">yield</span> <span class="n">header</span>
+</span><span id="1-656">            <span class="k">else</span><span class="p">:</span>
+</span><span id="1-657">                <span class="c1"># otherwise try headers from current scope</span>
+</span><span id="1-658">                <span class="n">current_scope</span> <span class="o">=</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_current_scope</span><span class="p">()</span>
+</span><span id="1-659">                <span class="k">if</span> <span class="n">current_scope</span><span class="o">.</span><span class="n">_propagation_context</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-660">                    <span class="k">for</span> <span class="n">header</span> <span class="ow">in</span> <span class="n">current_scope</span><span class="o">.</span><span class="n">iter_headers</span><span class="p">():</span>
+</span><span id="1-661">                        <span class="k">yield</span> <span class="n">header</span>
+</span><span id="1-662">                <span class="k">else</span><span class="p">:</span>
+</span><span id="1-663">                    <span class="c1"># otherwise fall back to headers from isolation scope</span>
+</span><span id="1-664">                    <span class="n">isolation_scope</span> <span class="o">=</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_isolation_scope</span><span class="p">()</span>
+</span><span id="1-665">                    <span class="k">if</span> <span class="n">isolation_scope</span><span class="o">.</span><span class="n">_propagation_context</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-666">                        <span class="k">for</span> <span class="n">header</span> <span class="ow">in</span> <span class="n">isolation_scope</span><span class="o">.</span><span class="n">iter_headers</span><span class="p">():</span>
+</span><span id="1-667">                            <span class="k">yield</span> <span class="n">header</span></div>
 
-</span><span id="1-416">
+</span><span id="1-668">
+</span><span id="1-669">    <span class="k">def</span> <span class="nf">get_active_propagation_context</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-670">        <span class="c1"># type: () -&gt; Dict[str, Any]</span>
+</span><span id="1-671">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-672">            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span>
+</span><span id="1-673">
+</span><span id="1-674">        <span class="n">current_scope</span> <span class="o">=</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_current_scope</span><span class="p">()</span>
+</span><span id="1-675">        <span class="k">if</span> <span class="n">current_scope</span><span class="o">.</span><span class="n">_propagation_context</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-676">            <span class="k">return</span> <span class="n">current_scope</span><span class="o">.</span><span class="n">_propagation_context</span>
+</span><span id="1-677">
+</span><span id="1-678">        <span class="n">isolation_scope</span> <span class="o">=</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_isolation_scope</span><span class="p">()</span>
+</span><span id="1-679">        <span class="k">if</span> <span class="n">isolation_scope</span><span class="o">.</span><span class="n">_propagation_context</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-680">            <span class="k">return</span> <span class="n">isolation_scope</span><span class="o">.</span><span class="n">_propagation_context</span>
+</span><span id="1-681">
+</span><span id="1-682">        <span class="k">return</span> <span class="p">{}</span>
+</span><span id="1-683">
 <div class="viewcode-block" id="Scope.clear">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Scope.clear">[docs]</a>
-</span><span id="1-417">    <span class="k">def</span> <span class="nf">clear</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-418">        <span class="c1"># type: () -&gt; None</span>
-</span><span id="1-419"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Clears the entire scope.&quot;&quot;&quot;</span>
-</span><span id="1-420">        <span class="bp">self</span><span class="o">.</span><span class="n">_level</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[LogLevelStr]</span>
-</span><span id="1-421">        <span class="bp">self</span><span class="o">.</span><span class="n">_fingerprint</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[List[str]]</span>
-</span><span id="1-422">        <span class="bp">self</span><span class="o">.</span><span class="n">_transaction</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[str]</span>
-</span><span id="1-423">        <span class="bp">self</span><span class="o">.</span><span class="n">_transaction_info</span> <span class="o">=</span> <span class="p">{}</span>  <span class="c1"># type: MutableMapping[str, str]</span>
-</span><span id="1-424">        <span class="bp">self</span><span class="o">.</span><span class="n">_user</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[Dict[str, Any]]</span>
-</span><span id="1-425">
-</span><span id="1-426">        <span class="bp">self</span><span class="o">.</span><span class="n">_tags</span> <span class="o">=</span> <span class="p">{}</span>  <span class="c1"># type: Dict[str, Any]</span>
-</span><span id="1-427">        <span class="bp">self</span><span class="o">.</span><span class="n">_contexts</span> <span class="o">=</span> <span class="p">{}</span>  <span class="c1"># type: Dict[str, Dict[str, Any]]</span>
-</span><span id="1-428">        <span class="bp">self</span><span class="o">.</span><span class="n">_extras</span> <span class="o">=</span> <span class="p">{}</span>  <span class="c1"># type: MutableMapping[str, Any]</span>
-</span><span id="1-429">        <span class="bp">self</span><span class="o">.</span><span class="n">_attachments</span> <span class="o">=</span> <span class="p">[]</span>  <span class="c1"># type: List[Attachment]</span>
-</span><span id="1-430">
-</span><span id="1-431">        <span class="bp">self</span><span class="o">.</span><span class="n">clear_breadcrumbs</span><span class="p">()</span>
-</span><span id="1-432">        <span class="bp">self</span><span class="o">.</span><span class="n">_should_capture</span> <span class="o">=</span> <span class="kc">True</span>
-</span><span id="1-433">
-</span><span id="1-434">        <span class="bp">self</span><span class="o">.</span><span class="n">_span</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[Span]</span>
-</span><span id="1-435">        <span class="bp">self</span><span class="o">.</span><span class="n">_session</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[Session]</span>
-</span><span id="1-436">        <span class="bp">self</span><span class="o">.</span><span class="n">_force_auto_session_tracking</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[bool]</span>
-</span><span id="1-437">
-</span><span id="1-438">        <span class="bp">self</span><span class="o">.</span><span class="n">_profile</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[Profile]</span>
-</span><span id="1-439">
-</span><span id="1-440">        <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span> <span class="o">=</span> <span class="kc">None</span></div>
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.clear">[docs]</a>
+</span><span id="1-684">    <span class="k">def</span> <span class="nf">clear</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-685">        <span class="c1"># type: () -&gt; None</span>
+</span><span id="1-686"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Clears the entire scope.&quot;&quot;&quot;</span>
+</span><span id="1-687">        <span class="bp">self</span><span class="o">.</span><span class="n">_level</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[LogLevelStr]</span>
+</span><span id="1-688">        <span class="bp">self</span><span class="o">.</span><span class="n">_fingerprint</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[List[str]]</span>
+</span><span id="1-689">        <span class="bp">self</span><span class="o">.</span><span class="n">_transaction</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[str]</span>
+</span><span id="1-690">        <span class="bp">self</span><span class="o">.</span><span class="n">_transaction_info</span> <span class="o">=</span> <span class="p">{}</span>  <span class="c1"># type: MutableMapping[str, str]</span>
+</span><span id="1-691">        <span class="bp">self</span><span class="o">.</span><span class="n">_user</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[Dict[str, Any]]</span>
+</span><span id="1-692">
+</span><span id="1-693">        <span class="bp">self</span><span class="o">.</span><span class="n">_tags</span> <span class="o">=</span> <span class="p">{}</span>  <span class="c1"># type: Dict[str, Any]</span>
+</span><span id="1-694">        <span class="bp">self</span><span class="o">.</span><span class="n">_contexts</span> <span class="o">=</span> <span class="p">{}</span>  <span class="c1"># type: Dict[str, Dict[str, Any]]</span>
+</span><span id="1-695">        <span class="bp">self</span><span class="o">.</span><span class="n">_extras</span> <span class="o">=</span> <span class="p">{}</span>  <span class="c1"># type: MutableMapping[str, Any]</span>
+</span><span id="1-696">        <span class="bp">self</span><span class="o">.</span><span class="n">_attachments</span> <span class="o">=</span> <span class="p">[]</span>  <span class="c1"># type: List[Attachment]</span>
+</span><span id="1-697">
+</span><span id="1-698">        <span class="bp">self</span><span class="o">.</span><span class="n">clear_breadcrumbs</span><span class="p">()</span>
+</span><span id="1-699">        <span class="bp">self</span><span class="o">.</span><span class="n">_should_capture</span> <span class="o">=</span> <span class="kc">True</span>  <span class="c1"># type: bool</span>
+</span><span id="1-700">
+</span><span id="1-701">        <span class="bp">self</span><span class="o">.</span><span class="n">_span</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[Span]</span>
+</span><span id="1-702">        <span class="bp">self</span><span class="o">.</span><span class="n">_session</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[Session]</span>
+</span><span id="1-703">        <span class="bp">self</span><span class="o">.</span><span class="n">_force_auto_session_tracking</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[bool]</span>
+</span><span id="1-704">
+</span><span id="1-705">        <span class="bp">self</span><span class="o">.</span><span class="n">_profile</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[Profile]</span>
+</span><span id="1-706">
+</span><span id="1-707">        <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span> <span class="o">=</span> <span class="kc">None</span></div>
 
-</span><span id="1-441">
-</span><span id="1-442">    <span class="nd">@_attr_setter</span>
-</span><span id="1-443">    <span class="k">def</span> <span class="nf">level</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-</span><span id="1-444">        <span class="c1"># type: (LogLevelStr) -&gt; None</span>
-</span><span id="1-445"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-446"><span class="sd">        When set this overrides the level.</span>
-</span><span id="1-447">
-</span><span id="1-448"><span class="sd">        .. deprecated:: 1.0.0</span>
-</span><span id="1-449"><span class="sd">            Use :func:`set_level` instead.</span>
-</span><span id="1-450">
-</span><span id="1-451"><span class="sd">        :param value: The level to set.</span>
-</span><span id="1-452"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-453">        <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
-</span><span id="1-454">            <span class="s2">&quot;Deprecated: use .set_level() instead. This will be removed in the future.&quot;</span>
-</span><span id="1-455">        <span class="p">)</span>
-</span><span id="1-456">
-</span><span id="1-457">        <span class="bp">self</span><span class="o">.</span><span class="n">_level</span> <span class="o">=</span> <span class="n">value</span>
-</span><span id="1-458">
+</span><span id="1-708">
+</span><span id="1-709">    <span class="nd">@_attr_setter</span>
+</span><span id="1-710">    <span class="k">def</span> <span class="nf">level</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
+</span><span id="1-711">        <span class="c1"># type: (LogLevelStr) -&gt; None</span>
+</span><span id="1-712"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-713"><span class="sd">        When set this overrides the level.</span>
+</span><span id="1-714">
+</span><span id="1-715"><span class="sd">        .. deprecated:: 1.0.0</span>
+</span><span id="1-716"><span class="sd">            Use :func:`set_level` instead.</span>
+</span><span id="1-717">
+</span><span id="1-718"><span class="sd">        :param value: The level to set.</span>
+</span><span id="1-719"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-720">        <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
+</span><span id="1-721">            <span class="s2">&quot;Deprecated: use .set_level() instead. This will be removed in the future.&quot;</span>
+</span><span id="1-722">        <span class="p">)</span>
+</span><span id="1-723">
+</span><span id="1-724">        <span class="bp">self</span><span class="o">.</span><span class="n">_level</span> <span class="o">=</span> <span class="n">value</span>
+</span><span id="1-725">
 <div class="viewcode-block" id="Scope.set_level">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Scope.set_level">[docs]</a>
-</span><span id="1-459">    <span class="k">def</span> <span class="nf">set_level</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-</span><span id="1-460">        <span class="c1"># type: (LogLevelStr) -&gt; None</span>
-</span><span id="1-461"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-462"><span class="sd">        Sets the level for the scope.</span>
-</span><span id="1-463">
-</span><span id="1-464"><span class="sd">        :param value: The level to set.</span>
-</span><span id="1-465"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-466">        <span class="bp">self</span><span class="o">.</span><span class="n">_level</span> <span class="o">=</span> <span class="n">value</span></div>
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.set_level">[docs]</a>
+</span><span id="1-726">    <span class="k">def</span> <span class="nf">set_level</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
+</span><span id="1-727">        <span class="c1"># type: (LogLevelStr) -&gt; None</span>
+</span><span id="1-728"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-729"><span class="sd">        Sets the level for the scope.</span>
+</span><span id="1-730">
+</span><span id="1-731"><span class="sd">        :param value: The level to set.</span>
+</span><span id="1-732"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-733">        <span class="bp">self</span><span class="o">.</span><span class="n">_level</span> <span class="o">=</span> <span class="n">value</span></div>
 
-</span><span id="1-467">
-</span><span id="1-468">    <span class="nd">@_attr_setter</span>
-</span><span id="1-469">    <span class="k">def</span> <span class="nf">fingerprint</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-</span><span id="1-470">        <span class="c1"># type: (Optional[List[str]]) -&gt; None</span>
-</span><span id="1-471"><span class="w">        </span><span class="sd">&quot;&quot;&quot;When set this overrides the default fingerprint.&quot;&quot;&quot;</span>
-</span><span id="1-472">        <span class="bp">self</span><span class="o">.</span><span class="n">_fingerprint</span> <span class="o">=</span> <span class="n">value</span>
-</span><span id="1-473">
-</span><span id="1-474">    <span class="nd">@property</span>
-</span><span id="1-475">    <span class="k">def</span> <span class="nf">transaction</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-476">        <span class="c1"># type: () -&gt; Any</span>
-</span><span id="1-477">        <span class="c1"># would be type: () -&gt; Optional[Transaction], see https://github.com/python/mypy/issues/3004</span>
-</span><span id="1-478"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Return the transaction (root span) in the scope, if any.&quot;&quot;&quot;</span>
-</span><span id="1-479">
-</span><span id="1-480">        <span class="c1"># there is no span/transaction on the scope</span>
-</span><span id="1-481">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_span</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-482">            <span class="k">return</span> <span class="kc">None</span>
-</span><span id="1-483">
-</span><span id="1-484">        <span class="c1"># there is an orphan span on the scope</span>
-</span><span id="1-485">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_span</span><span class="o">.</span><span class="n">containing_transaction</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-486">            <span class="k">return</span> <span class="kc">None</span>
-</span><span id="1-487">
-</span><span id="1-488">        <span class="c1"># there is either a transaction (which is its own containing</span>
-</span><span id="1-489">        <span class="c1"># transaction) or a non-orphan span on the scope</span>
-</span><span id="1-490">        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_span</span><span class="o">.</span><span class="n">containing_transaction</span>
-</span><span id="1-491">
-</span><span id="1-492">    <span class="nd">@transaction</span><span class="o">.</span><span class="n">setter</span>
-</span><span id="1-493">    <span class="k">def</span> <span class="nf">transaction</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-</span><span id="1-494">        <span class="c1"># type: (Any) -&gt; None</span>
-</span><span id="1-495">        <span class="c1"># would be type: (Optional[str]) -&gt; None, see https://github.com/python/mypy/issues/3004</span>
-</span><span id="1-496"><span class="w">        </span><span class="sd">&quot;&quot;&quot;When set this forces a specific transaction name to be set.</span>
-</span><span id="1-497">
-</span><span id="1-498"><span class="sd">        Deprecated: use set_transaction_name instead.&quot;&quot;&quot;</span>
-</span><span id="1-499">
-</span><span id="1-500">        <span class="c1"># XXX: the docstring above is misleading. The implementation of</span>
-</span><span id="1-501">        <span class="c1"># apply_to_event prefers an existing value of event.transaction over</span>
-</span><span id="1-502">        <span class="c1"># anything set in the scope.</span>
-</span><span id="1-503">        <span class="c1"># XXX: note that with the introduction of the Scope.transaction getter,</span>
-</span><span id="1-504">        <span class="c1"># there is a semantic and type mismatch between getter and setter. The</span>
-</span><span id="1-505">        <span class="c1"># getter returns a Transaction, the setter sets a transaction name.</span>
-</span><span id="1-506">        <span class="c1"># Without breaking version compatibility, we could make the setter set a</span>
-</span><span id="1-507">        <span class="c1"># transaction name or transaction (self._span) depending on the type of</span>
-</span><span id="1-508">        <span class="c1"># the value argument.</span>
-</span><span id="1-509">
-</span><span id="1-510">        <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
-</span><span id="1-511">            <span class="s2">&quot;Assigning to scope.transaction directly is deprecated: use scope.set_transaction_name() instead.&quot;</span>
-</span><span id="1-512">        <span class="p">)</span>
-</span><span id="1-513">        <span class="bp">self</span><span class="o">.</span><span class="n">_transaction</span> <span class="o">=</span> <span class="n">value</span>
-</span><span id="1-514">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_span</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">_span</span><span class="o">.</span><span class="n">containing_transaction</span><span class="p">:</span>
-</span><span id="1-515">            <span class="bp">self</span><span class="o">.</span><span class="n">_span</span><span class="o">.</span><span class="n">containing_transaction</span><span class="o">.</span><span class="n">name</span> <span class="o">=</span> <span class="n">value</span>
-</span><span id="1-516">
+</span><span id="1-734">
+</span><span id="1-735">    <span class="nd">@_attr_setter</span>
+</span><span id="1-736">    <span class="k">def</span> <span class="nf">fingerprint</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
+</span><span id="1-737">        <span class="c1"># type: (Optional[List[str]]) -&gt; None</span>
+</span><span id="1-738"><span class="w">        </span><span class="sd">&quot;&quot;&quot;When set this overrides the default fingerprint.&quot;&quot;&quot;</span>
+</span><span id="1-739">        <span class="bp">self</span><span class="o">.</span><span class="n">_fingerprint</span> <span class="o">=</span> <span class="n">value</span>
+</span><span id="1-740">
+</span><span id="1-741">    <span class="nd">@property</span>
+</span><span id="1-742">    <span class="k">def</span> <span class="nf">transaction</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-743">        <span class="c1"># type: () -&gt; Any</span>
+</span><span id="1-744">        <span class="c1"># would be type: () -&gt; Optional[Transaction], see https://github.com/python/mypy/issues/3004</span>
+</span><span id="1-745"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Return the transaction (root span) in the scope, if any.&quot;&quot;&quot;</span>
+</span><span id="1-746">
+</span><span id="1-747">        <span class="c1"># there is no span/transaction on the scope</span>
+</span><span id="1-748">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_span</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-749">            <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-750">
+</span><span id="1-751">        <span class="c1"># there is an orphan span on the scope</span>
+</span><span id="1-752">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_span</span><span class="o">.</span><span class="n">containing_transaction</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-753">            <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-754">
+</span><span id="1-755">        <span class="c1"># there is either a transaction (which is its own containing</span>
+</span><span id="1-756">        <span class="c1"># transaction) or a non-orphan span on the scope</span>
+</span><span id="1-757">        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_span</span><span class="o">.</span><span class="n">containing_transaction</span>
+</span><span id="1-758">
+</span><span id="1-759">    <span class="nd">@transaction</span><span class="o">.</span><span class="n">setter</span>
+</span><span id="1-760">    <span class="k">def</span> <span class="nf">transaction</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
+</span><span id="1-761">        <span class="c1"># type: (Any) -&gt; None</span>
+</span><span id="1-762">        <span class="c1"># would be type: (Optional[str]) -&gt; None, see https://github.com/python/mypy/issues/3004</span>
+</span><span id="1-763"><span class="w">        </span><span class="sd">&quot;&quot;&quot;When set this forces a specific transaction name to be set.</span>
+</span><span id="1-764">
+</span><span id="1-765"><span class="sd">        Deprecated: use set_transaction_name instead.&quot;&quot;&quot;</span>
+</span><span id="1-766">
+</span><span id="1-767">        <span class="c1"># XXX: the docstring above is misleading. The implementation of</span>
+</span><span id="1-768">        <span class="c1"># apply_to_event prefers an existing value of event.transaction over</span>
+</span><span id="1-769">        <span class="c1"># anything set in the scope.</span>
+</span><span id="1-770">        <span class="c1"># XXX: note that with the introduction of the Scope.transaction getter,</span>
+</span><span id="1-771">        <span class="c1"># there is a semantic and type mismatch between getter and setter. The</span>
+</span><span id="1-772">        <span class="c1"># getter returns a Transaction, the setter sets a transaction name.</span>
+</span><span id="1-773">        <span class="c1"># Without breaking version compatibility, we could make the setter set a</span>
+</span><span id="1-774">        <span class="c1"># transaction name or transaction (self._span) depending on the type of</span>
+</span><span id="1-775">        <span class="c1"># the value argument.</span>
+</span><span id="1-776">
+</span><span id="1-777">        <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
+</span><span id="1-778">            <span class="s2">&quot;Assigning to scope.transaction directly is deprecated: use scope.set_transaction_name() instead.&quot;</span>
+</span><span id="1-779">        <span class="p">)</span>
+</span><span id="1-780">        <span class="bp">self</span><span class="o">.</span><span class="n">_transaction</span> <span class="o">=</span> <span class="n">value</span>
+</span><span id="1-781">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_span</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">_span</span><span class="o">.</span><span class="n">containing_transaction</span><span class="p">:</span>
+</span><span id="1-782">            <span class="bp">self</span><span class="o">.</span><span class="n">_span</span><span class="o">.</span><span class="n">containing_transaction</span><span class="o">.</span><span class="n">name</span> <span class="o">=</span> <span class="n">value</span>
+</span><span id="1-783">
 <div class="viewcode-block" id="Scope.set_transaction_name">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Scope.set_transaction_name">[docs]</a>
-</span><span id="1-517">    <span class="k">def</span> <span class="nf">set_transaction_name</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">source</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-</span><span id="1-518">        <span class="c1"># type: (str, Optional[str]) -&gt; None</span>
-</span><span id="1-519"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Set the transaction name and optionally the transaction source.&quot;&quot;&quot;</span>
-</span><span id="1-520">        <span class="bp">self</span><span class="o">.</span><span class="n">_transaction</span> <span class="o">=</span> <span class="n">name</span>
-</span><span id="1-521">
-</span><span id="1-522">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_span</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">_span</span><span class="o">.</span><span class="n">containing_transaction</span><span class="p">:</span>
-</span><span id="1-523">            <span class="bp">self</span><span class="o">.</span><span class="n">_span</span><span class="o">.</span><span class="n">containing_transaction</span><span class="o">.</span><span class="n">name</span> <span class="o">=</span> <span class="n">name</span>
-</span><span id="1-524">            <span class="k">if</span> <span class="n">source</span><span class="p">:</span>
-</span><span id="1-525">                <span class="bp">self</span><span class="o">.</span><span class="n">_span</span><span class="o">.</span><span class="n">containing_transaction</span><span class="o">.</span><span class="n">source</span> <span class="o">=</span> <span class="n">source</span>
-</span><span id="1-526">
-</span><span id="1-527">        <span class="k">if</span> <span class="n">source</span><span class="p">:</span>
-</span><span id="1-528">            <span class="bp">self</span><span class="o">.</span><span class="n">_transaction_info</span><span class="p">[</span><span class="s2">&quot;source&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">source</span></div>
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.set_transaction_name">[docs]</a>
+</span><span id="1-784">    <span class="k">def</span> <span class="nf">set_transaction_name</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">source</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+</span><span id="1-785">        <span class="c1"># type: (str, Optional[str]) -&gt; None</span>
+</span><span id="1-786"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Set the transaction name and optionally the transaction source.&quot;&quot;&quot;</span>
+</span><span id="1-787">        <span class="bp">self</span><span class="o">.</span><span class="n">_transaction</span> <span class="o">=</span> <span class="n">name</span>
+</span><span id="1-788">
+</span><span id="1-789">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_span</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">_span</span><span class="o">.</span><span class="n">containing_transaction</span><span class="p">:</span>
+</span><span id="1-790">            <span class="bp">self</span><span class="o">.</span><span class="n">_span</span><span class="o">.</span><span class="n">containing_transaction</span><span class="o">.</span><span class="n">name</span> <span class="o">=</span> <span class="n">name</span>
+</span><span id="1-791">            <span class="k">if</span> <span class="n">source</span><span class="p">:</span>
+</span><span id="1-792">                <span class="bp">self</span><span class="o">.</span><span class="n">_span</span><span class="o">.</span><span class="n">containing_transaction</span><span class="o">.</span><span class="n">source</span> <span class="o">=</span> <span class="n">source</span>
+</span><span id="1-793">
+</span><span id="1-794">        <span class="k">if</span> <span class="n">source</span><span class="p">:</span>
+</span><span id="1-795">            <span class="bp">self</span><span class="o">.</span><span class="n">_transaction_info</span><span class="p">[</span><span class="s2">&quot;source&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">source</span></div>
 
-</span><span id="1-529">
-</span><span id="1-530">    <span class="nd">@_attr_setter</span>
-</span><span id="1-531">    <span class="k">def</span> <span class="nf">user</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-</span><span id="1-532">        <span class="c1"># type: (Optional[Dict[str, Any]]) -&gt; None</span>
-</span><span id="1-533"><span class="w">        </span><span class="sd">&quot;&quot;&quot;When set a specific user is bound to the scope. Deprecated in favor of set_user.&quot;&quot;&quot;</span>
-</span><span id="1-534">        <span class="bp">self</span><span class="o">.</span><span class="n">set_user</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
-</span><span id="1-535">
+</span><span id="1-796">
+</span><span id="1-797">    <span class="nd">@_attr_setter</span>
+</span><span id="1-798">    <span class="k">def</span> <span class="nf">user</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
+</span><span id="1-799">        <span class="c1"># type: (Optional[Dict[str, Any]]) -&gt; None</span>
+</span><span id="1-800"><span class="w">        </span><span class="sd">&quot;&quot;&quot;When set a specific user is bound to the scope. Deprecated in favor of set_user.&quot;&quot;&quot;</span>
+</span><span id="1-801">        <span class="bp">self</span><span class="o">.</span><span class="n">set_user</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
+</span><span id="1-802">
 <div class="viewcode-block" id="Scope.set_user">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Scope.set_user">[docs]</a>
-</span><span id="1-536">    <span class="k">def</span> <span class="nf">set_user</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-</span><span id="1-537">        <span class="c1"># type: (Optional[Dict[str, Any]]) -&gt; None</span>
-</span><span id="1-538"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Sets a user for the scope.&quot;&quot;&quot;</span>
-</span><span id="1-539">        <span class="bp">self</span><span class="o">.</span><span class="n">_user</span> <span class="o">=</span> <span class="n">value</span>
-</span><span id="1-540">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_session</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-541">            <span class="bp">self</span><span class="o">.</span><span class="n">_session</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">user</span><span class="o">=</span><span class="n">value</span><span class="p">)</span></div>
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.set_user">[docs]</a>
+</span><span id="1-803">    <span class="k">def</span> <span class="nf">set_user</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
+</span><span id="1-804">        <span class="c1"># type: (Optional[Dict[str, Any]]) -&gt; None</span>
+</span><span id="1-805"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Sets a user for the scope.&quot;&quot;&quot;</span>
+</span><span id="1-806">        <span class="bp">self</span><span class="o">.</span><span class="n">_user</span> <span class="o">=</span> <span class="n">value</span>
+</span><span id="1-807">        <span class="n">session</span> <span class="o">=</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_isolation_scope</span><span class="p">()</span><span class="o">.</span><span class="n">_session</span>
+</span><span id="1-808">        <span class="k">if</span> <span class="n">session</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-809">            <span class="n">session</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">user</span><span class="o">=</span><span class="n">value</span><span class="p">)</span></div>
 
-</span><span id="1-542">
-</span><span id="1-543">    <span class="nd">@property</span>
-</span><span id="1-544">    <span class="k">def</span> <span class="nf">span</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-545">        <span class="c1"># type: () -&gt; Optional[Span]</span>
-</span><span id="1-546"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Get/set current tracing span or transaction.&quot;&quot;&quot;</span>
-</span><span id="1-547">        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_span</span>
-</span><span id="1-548">
-</span><span id="1-549">    <span class="nd">@span</span><span class="o">.</span><span class="n">setter</span>
-</span><span id="1-550">    <span class="k">def</span> <span class="nf">span</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">span</span><span class="p">):</span>
-</span><span id="1-551">        <span class="c1"># type: (Optional[Span]) -&gt; None</span>
-</span><span id="1-552">        <span class="bp">self</span><span class="o">.</span><span class="n">_span</span> <span class="o">=</span> <span class="n">span</span>
-</span><span id="1-553">        <span class="c1"># XXX: this differs from the implementation in JS, there Scope.setSpan</span>
-</span><span id="1-554">        <span class="c1"># does not set Scope._transactionName.</span>
-</span><span id="1-555">        <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">span</span><span class="p">,</span> <span class="n">Transaction</span><span class="p">):</span>
-</span><span id="1-556">            <span class="n">transaction</span> <span class="o">=</span> <span class="n">span</span>
-</span><span id="1-557">            <span class="k">if</span> <span class="n">transaction</span><span class="o">.</span><span class="n">name</span><span class="p">:</span>
-</span><span id="1-558">                <span class="bp">self</span><span class="o">.</span><span class="n">_transaction</span> <span class="o">=</span> <span class="n">transaction</span><span class="o">.</span><span class="n">name</span>
-</span><span id="1-559">                <span class="k">if</span> <span class="n">transaction</span><span class="o">.</span><span class="n">source</span><span class="p">:</span>
-</span><span id="1-560">                    <span class="bp">self</span><span class="o">.</span><span class="n">_transaction_info</span><span class="p">[</span><span class="s2">&quot;source&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">transaction</span><span class="o">.</span><span class="n">source</span>
-</span><span id="1-561">
-</span><span id="1-562">    <span class="nd">@property</span>
-</span><span id="1-563">    <span class="k">def</span> <span class="nf">profile</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-564">        <span class="c1"># type: () -&gt; Optional[Profile]</span>
-</span><span id="1-565">        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_profile</span>
-</span><span id="1-566">
-</span><span id="1-567">    <span class="nd">@profile</span><span class="o">.</span><span class="n">setter</span>
-</span><span id="1-568">    <span class="k">def</span> <span class="nf">profile</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">profile</span><span class="p">):</span>
-</span><span id="1-569">        <span class="c1"># type: (Optional[Profile]) -&gt; None</span>
-</span><span id="1-570">
-</span><span id="1-571">        <span class="bp">self</span><span class="o">.</span><span class="n">_profile</span> <span class="o">=</span> <span class="n">profile</span>
-</span><span id="1-572">
+</span><span id="1-810">
+</span><span id="1-811">    <span class="nd">@property</span>
+</span><span id="1-812">    <span class="k">def</span> <span class="nf">span</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-813">        <span class="c1"># type: () -&gt; Optional[Span]</span>
+</span><span id="1-814"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Get/set current tracing span or transaction.&quot;&quot;&quot;</span>
+</span><span id="1-815">        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_span</span>
+</span><span id="1-816">
+</span><span id="1-817">    <span class="nd">@span</span><span class="o">.</span><span class="n">setter</span>
+</span><span id="1-818">    <span class="k">def</span> <span class="nf">span</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">span</span><span class="p">):</span>
+</span><span id="1-819">        <span class="c1"># type: (Optional[Span]) -&gt; None</span>
+</span><span id="1-820">        <span class="bp">self</span><span class="o">.</span><span class="n">_span</span> <span class="o">=</span> <span class="n">span</span>
+</span><span id="1-821">        <span class="c1"># XXX: this differs from the implementation in JS, there Scope.setSpan</span>
+</span><span id="1-822">        <span class="c1"># does not set Scope._transactionName.</span>
+</span><span id="1-823">        <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">span</span><span class="p">,</span> <span class="n">Transaction</span><span class="p">):</span>
+</span><span id="1-824">            <span class="n">transaction</span> <span class="o">=</span> <span class="n">span</span>
+</span><span id="1-825">            <span class="k">if</span> <span class="n">transaction</span><span class="o">.</span><span class="n">name</span><span class="p">:</span>
+</span><span id="1-826">                <span class="bp">self</span><span class="o">.</span><span class="n">_transaction</span> <span class="o">=</span> <span class="n">transaction</span><span class="o">.</span><span class="n">name</span>
+</span><span id="1-827">                <span class="k">if</span> <span class="n">transaction</span><span class="o">.</span><span class="n">source</span><span class="p">:</span>
+</span><span id="1-828">                    <span class="bp">self</span><span class="o">.</span><span class="n">_transaction_info</span><span class="p">[</span><span class="s2">&quot;source&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">transaction</span><span class="o">.</span><span class="n">source</span>
+</span><span id="1-829">
+</span><span id="1-830">    <span class="nd">@property</span>
+</span><span id="1-831">    <span class="k">def</span> <span class="nf">profile</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-832">        <span class="c1"># type: () -&gt; Optional[Profile]</span>
+</span><span id="1-833">        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_profile</span>
+</span><span id="1-834">
+</span><span id="1-835">    <span class="nd">@profile</span><span class="o">.</span><span class="n">setter</span>
+</span><span id="1-836">    <span class="k">def</span> <span class="nf">profile</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">profile</span><span class="p">):</span>
+</span><span id="1-837">        <span class="c1"># type: (Optional[Profile]) -&gt; None</span>
+</span><span id="1-838">
+</span><span id="1-839">        <span class="bp">self</span><span class="o">.</span><span class="n">_profile</span> <span class="o">=</span> <span class="n">profile</span>
+</span><span id="1-840">
 <div class="viewcode-block" id="Scope.set_tag">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Scope.set_tag">[docs]</a>
-</span><span id="1-573">    <span class="k">def</span> <span class="nf">set_tag</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-</span><span id="1-574">        <span class="c1"># type: (str, Any) -&gt; None</span>
-</span><span id="1-575"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-576"><span class="sd">        Sets a tag for a key to a specific value.</span>
-</span><span id="1-577">
-</span><span id="1-578"><span class="sd">        :param key: Key of the tag to set.</span>
-</span><span id="1-579">
-</span><span id="1-580"><span class="sd">        :param value: Value of the tag to set.</span>
-</span><span id="1-581"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-582">        <span class="bp">self</span><span class="o">.</span><span class="n">_tags</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="o">=</span> <span class="n">value</span></div>
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.set_tag">[docs]</a>
+</span><span id="1-841">    <span class="k">def</span> <span class="nf">set_tag</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
+</span><span id="1-842">        <span class="c1"># type: (str, Any) -&gt; None</span>
+</span><span id="1-843"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-844"><span class="sd">        Sets a tag for a key to a specific value.</span>
+</span><span id="1-845">
+</span><span id="1-846"><span class="sd">        :param key: Key of the tag to set.</span>
+</span><span id="1-847">
+</span><span id="1-848"><span class="sd">        :param value: Value of the tag to set.</span>
+</span><span id="1-849"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-850">        <span class="bp">self</span><span class="o">.</span><span class="n">_tags</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="o">=</span> <span class="n">value</span></div>
 
-</span><span id="1-583">
+</span><span id="1-851">
 <div class="viewcode-block" id="Scope.remove_tag">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Scope.remove_tag">[docs]</a>
-</span><span id="1-584">    <span class="k">def</span> <span class="nf">remove_tag</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">):</span>
-</span><span id="1-585">        <span class="c1"># type: (str) -&gt; None</span>
-</span><span id="1-586"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-587"><span class="sd">        Removes a specific tag.</span>
-</span><span id="1-588">
-</span><span id="1-589"><span class="sd">        :param key: Key of the tag to remove.</span>
-</span><span id="1-590"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-591">        <span class="bp">self</span><span class="o">.</span><span class="n">_tags</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span></div>
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.remove_tag">[docs]</a>
+</span><span id="1-852">    <span class="k">def</span> <span class="nf">remove_tag</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">):</span>
+</span><span id="1-853">        <span class="c1"># type: (str) -&gt; None</span>
+</span><span id="1-854"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-855"><span class="sd">        Removes a specific tag.</span>
+</span><span id="1-856">
+</span><span id="1-857"><span class="sd">        :param key: Key of the tag to remove.</span>
+</span><span id="1-858"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-859">        <span class="bp">self</span><span class="o">.</span><span class="n">_tags</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span></div>
 
-</span><span id="1-592">
+</span><span id="1-860">
 <div class="viewcode-block" id="Scope.set_context">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Scope.set_context">[docs]</a>
-</span><span id="1-593">    <span class="k">def</span> <span class="nf">set_context</span><span class="p">(</span>
-</span><span id="1-594">        <span class="bp">self</span><span class="p">,</span>
-</span><span id="1-595">        <span class="n">key</span><span class="p">,</span>  <span class="c1"># type: str</span>
-</span><span id="1-596">        <span class="n">value</span><span class="p">,</span>  <span class="c1"># type: Dict[str, Any]</span>
-</span><span id="1-597">    <span class="p">):</span>
-</span><span id="1-598">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-599"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-600"><span class="sd">        Binds a context at a certain key to a specific value.</span>
-</span><span id="1-601"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-602">        <span class="bp">self</span><span class="o">.</span><span class="n">_contexts</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="o">=</span> <span class="n">value</span></div>
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.set_context">[docs]</a>
+</span><span id="1-861">    <span class="k">def</span> <span class="nf">set_context</span><span class="p">(</span>
+</span><span id="1-862">        <span class="bp">self</span><span class="p">,</span>
+</span><span id="1-863">        <span class="n">key</span><span class="p">,</span>  <span class="c1"># type: str</span>
+</span><span id="1-864">        <span class="n">value</span><span class="p">,</span>  <span class="c1"># type: Dict[str, Any]</span>
+</span><span id="1-865">    <span class="p">):</span>
+</span><span id="1-866">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-867"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-868"><span class="sd">        Binds a context at a certain key to a specific value.</span>
+</span><span id="1-869"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-870">        <span class="bp">self</span><span class="o">.</span><span class="n">_contexts</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="o">=</span> <span class="n">value</span></div>
 
-</span><span id="1-603">
+</span><span id="1-871">
 <div class="viewcode-block" id="Scope.remove_context">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Scope.remove_context">[docs]</a>
-</span><span id="1-604">    <span class="k">def</span> <span class="nf">remove_context</span><span class="p">(</span>
-</span><span id="1-605">        <span class="bp">self</span><span class="p">,</span> <span class="n">key</span>  <span class="c1"># type: str</span>
-</span><span id="1-606">    <span class="p">):</span>
-</span><span id="1-607">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-608"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Removes a context.&quot;&quot;&quot;</span>
-</span><span id="1-609">        <span class="bp">self</span><span class="o">.</span><span class="n">_contexts</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span></div>
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.remove_context">[docs]</a>
+</span><span id="1-872">    <span class="k">def</span> <span class="nf">remove_context</span><span class="p">(</span>
+</span><span id="1-873">        <span class="bp">self</span><span class="p">,</span> <span class="n">key</span>  <span class="c1"># type: str</span>
+</span><span id="1-874">    <span class="p">):</span>
+</span><span id="1-875">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-876"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Removes a context.&quot;&quot;&quot;</span>
+</span><span id="1-877">        <span class="bp">self</span><span class="o">.</span><span class="n">_contexts</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span></div>
 
-</span><span id="1-610">
+</span><span id="1-878">
 <div class="viewcode-block" id="Scope.set_extra">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Scope.set_extra">[docs]</a>
-</span><span id="1-611">    <span class="k">def</span> <span class="nf">set_extra</span><span class="p">(</span>
-</span><span id="1-612">        <span class="bp">self</span><span class="p">,</span>
-</span><span id="1-613">        <span class="n">key</span><span class="p">,</span>  <span class="c1"># type: str</span>
-</span><span id="1-614">        <span class="n">value</span><span class="p">,</span>  <span class="c1"># type: Any</span>
-</span><span id="1-615">    <span class="p">):</span>
-</span><span id="1-616">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-617"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Sets an extra key to a specific value.&quot;&quot;&quot;</span>
-</span><span id="1-618">        <span class="bp">self</span><span class="o">.</span><span class="n">_extras</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="o">=</span> <span class="n">value</span></div>
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.set_extra">[docs]</a>
+</span><span id="1-879">    <span class="k">def</span> <span class="nf">set_extra</span><span class="p">(</span>
+</span><span id="1-880">        <span class="bp">self</span><span class="p">,</span>
+</span><span id="1-881">        <span class="n">key</span><span class="p">,</span>  <span class="c1"># type: str</span>
+</span><span id="1-882">        <span class="n">value</span><span class="p">,</span>  <span class="c1"># type: Any</span>
+</span><span id="1-883">    <span class="p">):</span>
+</span><span id="1-884">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-885"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Sets an extra key to a specific value.&quot;&quot;&quot;</span>
+</span><span id="1-886">        <span class="bp">self</span><span class="o">.</span><span class="n">_extras</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="o">=</span> <span class="n">value</span></div>
 
-</span><span id="1-619">
+</span><span id="1-887">
 <div class="viewcode-block" id="Scope.remove_extra">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Scope.remove_extra">[docs]</a>
-</span><span id="1-620">    <span class="k">def</span> <span class="nf">remove_extra</span><span class="p">(</span>
-</span><span id="1-621">        <span class="bp">self</span><span class="p">,</span> <span class="n">key</span>  <span class="c1"># type: str</span>
-</span><span id="1-622">    <span class="p">):</span>
-</span><span id="1-623">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-624"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Removes a specific extra key.&quot;&quot;&quot;</span>
-</span><span id="1-625">        <span class="bp">self</span><span class="o">.</span><span class="n">_extras</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span></div>
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.remove_extra">[docs]</a>
+</span><span id="1-888">    <span class="k">def</span> <span class="nf">remove_extra</span><span class="p">(</span>
+</span><span id="1-889">        <span class="bp">self</span><span class="p">,</span> <span class="n">key</span>  <span class="c1"># type: str</span>
+</span><span id="1-890">    <span class="p">):</span>
+</span><span id="1-891">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-892"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Removes a specific extra key.&quot;&quot;&quot;</span>
+</span><span id="1-893">        <span class="bp">self</span><span class="o">.</span><span class="n">_extras</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="n">key</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span></div>
 
-</span><span id="1-626">
+</span><span id="1-894">
 <div class="viewcode-block" id="Scope.clear_breadcrumbs">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Scope.clear_breadcrumbs">[docs]</a>
-</span><span id="1-627">    <span class="k">def</span> <span class="nf">clear_breadcrumbs</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-628">        <span class="c1"># type: () -&gt; None</span>
-</span><span id="1-629"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Clears breadcrumb buffer.&quot;&quot;&quot;</span>
-</span><span id="1-630">        <span class="bp">self</span><span class="o">.</span><span class="n">_breadcrumbs</span> <span class="o">=</span> <span class="n">deque</span><span class="p">()</span>  <span class="c1"># type: Deque[Breadcrumb]</span></div>
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.clear_breadcrumbs">[docs]</a>
+</span><span id="1-895">    <span class="k">def</span> <span class="nf">clear_breadcrumbs</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-896">        <span class="c1"># type: () -&gt; None</span>
+</span><span id="1-897"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Clears breadcrumb buffer.&quot;&quot;&quot;</span>
+</span><span id="1-898">        <span class="bp">self</span><span class="o">.</span><span class="n">_breadcrumbs</span> <span class="o">=</span> <span class="n">deque</span><span class="p">()</span>  <span class="c1"># type: Deque[Breadcrumb]</span></div>
 
-</span><span id="1-631">
+</span><span id="1-899">
 <div class="viewcode-block" id="Scope.add_attachment">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Scope.add_attachment">[docs]</a>
-</span><span id="1-632">    <span class="k">def</span> <span class="nf">add_attachment</span><span class="p">(</span>
-</span><span id="1-633">        <span class="bp">self</span><span class="p">,</span>
-</span><span id="1-634">        <span class="nb">bytes</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[bytes]</span>
-</span><span id="1-635">        <span class="n">filename</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
-</span><span id="1-636">        <span class="n">path</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
-</span><span id="1-637">        <span class="n">content_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
-</span><span id="1-638">        <span class="n">add_to_transactions</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>  <span class="c1"># type: bool</span>
-</span><span id="1-639">    <span class="p">):</span>
-</span><span id="1-640">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-641"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Adds an attachment to future events sent.&quot;&quot;&quot;</span>
-</span><span id="1-642">        <span class="bp">self</span><span class="o">.</span><span class="n">_attachments</span><span class="o">.</span><span class="n">append</span><span class="p">(</span>
-</span><span id="1-643">            <span class="n">Attachment</span><span class="p">(</span>
-</span><span id="1-644">                <span class="nb">bytes</span><span class="o">=</span><span class="nb">bytes</span><span class="p">,</span>
-</span><span id="1-645">                <span class="n">path</span><span class="o">=</span><span class="n">path</span><span class="p">,</span>
-</span><span id="1-646">                <span class="n">filename</span><span class="o">=</span><span class="n">filename</span><span class="p">,</span>
-</span><span id="1-647">                <span class="n">content_type</span><span class="o">=</span><span class="n">content_type</span><span class="p">,</span>
-</span><span id="1-648">                <span class="n">add_to_transactions</span><span class="o">=</span><span class="n">add_to_transactions</span><span class="p">,</span>
-</span><span id="1-649">            <span class="p">)</span>
-</span><span id="1-650">        <span class="p">)</span></div>
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.add_attachment">[docs]</a>
+</span><span id="1-900">    <span class="k">def</span> <span class="nf">add_attachment</span><span class="p">(</span>
+</span><span id="1-901">        <span class="bp">self</span><span class="p">,</span>
+</span><span id="1-902">        <span class="nb">bytes</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[bytes]</span>
+</span><span id="1-903">        <span class="n">filename</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
+</span><span id="1-904">        <span class="n">path</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
+</span><span id="1-905">        <span class="n">content_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
+</span><span id="1-906">        <span class="n">add_to_transactions</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>  <span class="c1"># type: bool</span>
+</span><span id="1-907">    <span class="p">):</span>
+</span><span id="1-908">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-909"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Adds an attachment to future events sent.&quot;&quot;&quot;</span>
+</span><span id="1-910">        <span class="bp">self</span><span class="o">.</span><span class="n">_attachments</span><span class="o">.</span><span class="n">append</span><span class="p">(</span>
+</span><span id="1-911">            <span class="n">Attachment</span><span class="p">(</span>
+</span><span id="1-912">                <span class="nb">bytes</span><span class="o">=</span><span class="nb">bytes</span><span class="p">,</span>
+</span><span id="1-913">                <span class="n">path</span><span class="o">=</span><span class="n">path</span><span class="p">,</span>
+</span><span id="1-914">                <span class="n">filename</span><span class="o">=</span><span class="n">filename</span><span class="p">,</span>
+</span><span id="1-915">                <span class="n">content_type</span><span class="o">=</span><span class="n">content_type</span><span class="p">,</span>
+</span><span id="1-916">                <span class="n">add_to_transactions</span><span class="o">=</span><span class="n">add_to_transactions</span><span class="p">,</span>
+</span><span id="1-917">            <span class="p">)</span>
+</span><span id="1-918">        <span class="p">)</span></div>
 
-</span><span id="1-651">
+</span><span id="1-919">
 <div class="viewcode-block" id="Scope.add_breadcrumb">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Scope.add_breadcrumb">[docs]</a>
-</span><span id="1-652">    <span class="k">def</span> <span class="nf">add_breadcrumb</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">crumb</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">hint</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-</span><span id="1-653">        <span class="c1"># type: (Optional[Breadcrumb], Optional[BreadcrumbHint], Any) -&gt; None</span>
-</span><span id="1-654"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-655"><span class="sd">        Adds a breadcrumb.</span>
-</span><span id="1-656">
-</span><span id="1-657"><span class="sd">        :param crumb: Dictionary with the data as the sentry v7/v8 protocol expects.</span>
-</span><span id="1-658">
-</span><span id="1-659"><span class="sd">        :param hint: An optional value that can be used by `before_breadcrumb`</span>
-</span><span id="1-660"><span class="sd">            to customize the breadcrumbs that are emitted.</span>
-</span><span id="1-661"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-662">        <span class="n">client</span> <span class="o">=</span> <span class="n">kwargs</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s2">&quot;client&quot;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-</span><span id="1-663">        <span class="k">if</span> <span class="n">client</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-664">            <span class="k">return</span>
-</span><span id="1-665">
-</span><span id="1-666">        <span class="n">before_breadcrumb</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;before_breadcrumb&quot;</span><span class="p">)</span>
-</span><span id="1-667">        <span class="n">max_breadcrumbs</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;max_breadcrumbs&quot;</span><span class="p">)</span>
-</span><span id="1-668">
-</span><span id="1-669">        <span class="n">crumb</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="n">crumb</span> <span class="ow">or</span> <span class="p">())</span>  <span class="c1"># type: Breadcrumb</span>
-</span><span id="1-670">        <span class="n">crumb</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">kwargs</span><span class="p">)</span>
-</span><span id="1-671">        <span class="k">if</span> <span class="ow">not</span> <span class="n">crumb</span><span class="p">:</span>
-</span><span id="1-672">            <span class="k">return</span>
-</span><span id="1-673">
-</span><span id="1-674">        <span class="n">hint</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="n">hint</span> <span class="ow">or</span> <span class="p">())</span>  <span class="c1"># type: Hint</span>
-</span><span id="1-675">
-</span><span id="1-676">        <span class="k">if</span> <span class="n">crumb</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;timestamp&quot;</span><span class="p">)</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-677">            <span class="n">crumb</span><span class="p">[</span><span class="s2">&quot;timestamp&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">datetime_utcnow</span><span class="p">()</span>
-</span><span id="1-678">        <span class="k">if</span> <span class="n">crumb</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;type&quot;</span><span class="p">)</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-679">            <span class="n">crumb</span><span class="p">[</span><span class="s2">&quot;type&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="s2">&quot;default&quot;</span>
-</span><span id="1-680">
-</span><span id="1-681">        <span class="k">if</span> <span class="n">before_breadcrumb</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-682">            <span class="n">new_crumb</span> <span class="o">=</span> <span class="n">before_breadcrumb</span><span class="p">(</span><span class="n">crumb</span><span class="p">,</span> <span class="n">hint</span><span class="p">)</span>
-</span><span id="1-683">        <span class="k">else</span><span class="p">:</span>
-</span><span id="1-684">            <span class="n">new_crumb</span> <span class="o">=</span> <span class="n">crumb</span>
-</span><span id="1-685">
-</span><span id="1-686">        <span class="k">if</span> <span class="n">new_crumb</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-687">            <span class="bp">self</span><span class="o">.</span><span class="n">_breadcrumbs</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">new_crumb</span><span class="p">)</span>
-</span><span id="1-688">        <span class="k">else</span><span class="p">:</span>
-</span><span id="1-689">            <span class="n">logger</span><span class="o">.</span><span class="n">info</span><span class="p">(</span><span class="s2">&quot;before breadcrumb dropped breadcrumb (</span><span class="si">%s</span><span class="s2">)&quot;</span><span class="p">,</span> <span class="n">crumb</span><span class="p">)</span>
-</span><span id="1-690">
-</span><span id="1-691">        <span class="k">while</span> <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_breadcrumbs</span><span class="p">)</span> <span class="o">&gt;</span> <span class="n">max_breadcrumbs</span><span class="p">:</span>
-</span><span id="1-692">            <span class="bp">self</span><span class="o">.</span><span class="n">_breadcrumbs</span><span class="o">.</span><span class="n">popleft</span><span class="p">()</span></div>
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.add_breadcrumb">[docs]</a>
+</span><span id="1-920">    <span class="k">def</span> <span class="nf">add_breadcrumb</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">crumb</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">hint</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
+</span><span id="1-921">        <span class="c1"># type: (Optional[Breadcrumb], Optional[BreadcrumbHint], Any) -&gt; None</span>
+</span><span id="1-922"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-923"><span class="sd">        Adds a breadcrumb.</span>
+</span><span id="1-924">
+</span><span id="1-925"><span class="sd">        :param crumb: Dictionary with the data as the sentry v7/v8 protocol expects.</span>
+</span><span id="1-926">
+</span><span id="1-927"><span class="sd">        :param hint: An optional value that can be used by `before_breadcrumb`</span>
+</span><span id="1-928"><span class="sd">            to customize the breadcrumbs that are emitted.</span>
+</span><span id="1-929"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-930">        <span class="n">client</span> <span class="o">=</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_client</span><span class="p">()</span>
+</span><span id="1-931">
+</span><span id="1-932">        <span class="k">if</span> <span class="ow">not</span> <span class="n">client</span><span class="o">.</span><span class="n">is_active</span><span class="p">():</span>
+</span><span id="1-933">            <span class="n">logger</span><span class="o">.</span><span class="n">info</span><span class="p">(</span><span class="s2">&quot;Dropped breadcrumb because no client bound&quot;</span><span class="p">)</span>
+</span><span id="1-934">            <span class="k">return</span>
+</span><span id="1-935">
+</span><span id="1-936">        <span class="n">before_breadcrumb</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;before_breadcrumb&quot;</span><span class="p">)</span>
+</span><span id="1-937">        <span class="n">max_breadcrumbs</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;max_breadcrumbs&quot;</span><span class="p">,</span> <span class="n">DEFAULT_MAX_BREADCRUMBS</span><span class="p">)</span>
+</span><span id="1-938">
+</span><span id="1-939">        <span class="n">crumb</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="n">crumb</span> <span class="ow">or</span> <span class="p">())</span>  <span class="c1"># type: Breadcrumb</span>
+</span><span id="1-940">        <span class="n">crumb</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">kwargs</span><span class="p">)</span>
+</span><span id="1-941">        <span class="k">if</span> <span class="ow">not</span> <span class="n">crumb</span><span class="p">:</span>
+</span><span id="1-942">            <span class="k">return</span>
+</span><span id="1-943">
+</span><span id="1-944">        <span class="n">hint</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="n">hint</span> <span class="ow">or</span> <span class="p">())</span>  <span class="c1"># type: Hint</span>
+</span><span id="1-945">
+</span><span id="1-946">        <span class="k">if</span> <span class="n">crumb</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;timestamp&quot;</span><span class="p">)</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-947">            <span class="n">crumb</span><span class="p">[</span><span class="s2">&quot;timestamp&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">datetime</span><span class="o">.</span><span class="n">now</span><span class="p">(</span><span class="n">timezone</span><span class="o">.</span><span class="n">utc</span><span class="p">)</span>
+</span><span id="1-948">        <span class="k">if</span> <span class="n">crumb</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;type&quot;</span><span class="p">)</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-949">            <span class="n">crumb</span><span class="p">[</span><span class="s2">&quot;type&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="s2">&quot;default&quot;</span>
+</span><span id="1-950">
+</span><span id="1-951">        <span class="k">if</span> <span class="n">before_breadcrumb</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-952">            <span class="n">new_crumb</span> <span class="o">=</span> <span class="n">before_breadcrumb</span><span class="p">(</span><span class="n">crumb</span><span class="p">,</span> <span class="n">hint</span><span class="p">)</span>
+</span><span id="1-953">        <span class="k">else</span><span class="p">:</span>
+</span><span id="1-954">            <span class="n">new_crumb</span> <span class="o">=</span> <span class="n">crumb</span>
+</span><span id="1-955">
+</span><span id="1-956">        <span class="k">if</span> <span class="n">new_crumb</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-957">            <span class="bp">self</span><span class="o">.</span><span class="n">_breadcrumbs</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">new_crumb</span><span class="p">)</span>
+</span><span id="1-958">        <span class="k">else</span><span class="p">:</span>
+</span><span id="1-959">            <span class="n">logger</span><span class="o">.</span><span class="n">info</span><span class="p">(</span><span class="s2">&quot;before breadcrumb dropped breadcrumb (</span><span class="si">%s</span><span class="s2">)&quot;</span><span class="p">,</span> <span class="n">crumb</span><span class="p">)</span>
+</span><span id="1-960">
+</span><span id="1-961">        <span class="k">while</span> <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_breadcrumbs</span><span class="p">)</span> <span class="o">&gt;</span> <span class="n">max_breadcrumbs</span><span class="p">:</span>
+</span><span id="1-962">            <span class="bp">self</span><span class="o">.</span><span class="n">_breadcrumbs</span><span class="o">.</span><span class="n">popleft</span><span class="p">()</span></div>
 
-</span><span id="1-693">
+</span><span id="1-963">
 <div class="viewcode-block" id="Scope.start_transaction">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Scope.start_transaction">[docs]</a>
-</span><span id="1-694">    <span class="k">def</span> <span class="nf">start_transaction</span><span class="p">(</span>
-</span><span id="1-695">        <span class="bp">self</span><span class="p">,</span> <span class="n">transaction</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">instrumenter</span><span class="o">=</span><span class="n">INSTRUMENTER</span><span class="o">.</span><span class="n">SENTRY</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span>
-</span><span id="1-696">    <span class="p">):</span>
-</span><span id="1-697">        <span class="c1"># type: (Optional[Transaction], str, Any) -&gt; Union[Transaction, NoOpSpan]</span>
-</span><span id="1-698"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-699"><span class="sd">        Start and return a transaction.</span>
-</span><span id="1-700">
-</span><span id="1-701"><span class="sd">        Start an existing transaction if given, otherwise create and start a new</span>
-</span><span id="1-702"><span class="sd">        transaction with kwargs.</span>
-</span><span id="1-703">
-</span><span id="1-704"><span class="sd">        This is the entry point to manual tracing instrumentation.</span>
-</span><span id="1-705">
-</span><span id="1-706"><span class="sd">        A tree structure can be built by adding child spans to the transaction,</span>
-</span><span id="1-707"><span class="sd">        and child spans to other spans. To start a new child span within the</span>
-</span><span id="1-708"><span class="sd">        transaction or any span, call the respective `.start_child()` method.</span>
-</span><span id="1-709">
-</span><span id="1-710"><span class="sd">        Every child span must be finished before the transaction is finished,</span>
-</span><span id="1-711"><span class="sd">        otherwise the unfinished spans are discarded.</span>
-</span><span id="1-712">
-</span><span id="1-713"><span class="sd">        When used as context managers, spans and transactions are automatically</span>
-</span><span id="1-714"><span class="sd">        finished at the end of the `with` block. If not using context managers,</span>
-</span><span id="1-715"><span class="sd">        call the `.finish()` method.</span>
-</span><span id="1-716">
-</span><span id="1-717"><span class="sd">        When the transaction is finished, it will be sent to Sentry with all its</span>
-</span><span id="1-718"><span class="sd">        finished child spans.</span>
-</span><span id="1-719">
-</span><span id="1-720"><span class="sd">        For supported `**kwargs` see :py:class:`sentry_sdk.tracing.Transaction`.</span>
-</span><span id="1-721"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-722">        <span class="n">hub</span> <span class="o">=</span> <span class="n">kwargs</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s2">&quot;hub&quot;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-</span><span id="1-723">        <span class="n">client</span> <span class="o">=</span> <span class="n">kwargs</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s2">&quot;client&quot;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-</span><span id="1-724">
-</span><span id="1-725">        <span class="n">configuration_instrumenter</span> <span class="o">=</span> <span class="n">client</span> <span class="ow">and</span> <span class="n">client</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;instrumenter&quot;</span><span class="p">]</span>
-</span><span id="1-726">
-</span><span id="1-727">        <span class="k">if</span> <span class="n">instrumenter</span> <span class="o">!=</span> <span class="n">configuration_instrumenter</span><span class="p">:</span>
-</span><span id="1-728">            <span class="k">return</span> <span class="n">NoOpSpan</span><span class="p">()</span>
-</span><span id="1-729">
-</span><span id="1-730">        <span class="n">custom_sampling_context</span> <span class="o">=</span> <span class="n">kwargs</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s2">&quot;custom_sampling_context&quot;</span><span class="p">,</span> <span class="p">{})</span>
-</span><span id="1-731">
-</span><span id="1-732">        <span class="c1"># if we haven&#39;t been given a transaction, make one</span>
-</span><span id="1-733">        <span class="k">if</span> <span class="n">transaction</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-734">            <span class="n">kwargs</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="s2">&quot;hub&quot;</span><span class="p">,</span> <span class="n">hub</span><span class="p">)</span>
-</span><span id="1-735">            <span class="n">transaction</span> <span class="o">=</span> <span class="n">Transaction</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-</span><span id="1-736">
-</span><span id="1-737">        <span class="c1"># use traces_sample_rate, traces_sampler, and/or inheritance to make a</span>
-</span><span id="1-738">        <span class="c1"># sampling decision</span>
-</span><span id="1-739">        <span class="n">sampling_context</span> <span class="o">=</span> <span class="p">{</span>
-</span><span id="1-740">            <span class="s2">&quot;transaction_context&quot;</span><span class="p">:</span> <span class="n">transaction</span><span class="o">.</span><span class="n">to_json</span><span class="p">(),</span>
-</span><span id="1-741">            <span class="s2">&quot;parent_sampled&quot;</span><span class="p">:</span> <span class="n">transaction</span><span class="o">.</span><span class="n">parent_sampled</span><span class="p">,</span>
-</span><span id="1-742">        <span class="p">}</span>
-</span><span id="1-743">        <span class="n">sampling_context</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">custom_sampling_context</span><span class="p">)</span>
-</span><span id="1-744">        <span class="n">transaction</span><span class="o">.</span><span class="n">_set_initial_sampling_decision</span><span class="p">(</span><span class="n">sampling_context</span><span class="o">=</span><span class="n">sampling_context</span><span class="p">)</span>
-</span><span id="1-745">
-</span><span id="1-746">        <span class="n">profile</span> <span class="o">=</span> <span class="n">Profile</span><span class="p">(</span><span class="n">transaction</span><span class="p">,</span> <span class="n">hub</span><span class="o">=</span><span class="n">hub</span><span class="p">)</span>
-</span><span id="1-747">        <span class="n">profile</span><span class="o">.</span><span class="n">_set_initial_sampling_decision</span><span class="p">(</span><span class="n">sampling_context</span><span class="o">=</span><span class="n">sampling_context</span><span class="p">)</span>
-</span><span id="1-748">
-</span><span id="1-749">        <span class="c1"># we don&#39;t bother to keep spans if we already know we&#39;re not going to</span>
-</span><span id="1-750">        <span class="c1"># send the transaction</span>
-</span><span id="1-751">        <span class="k">if</span> <span class="n">transaction</span><span class="o">.</span><span class="n">sampled</span><span class="p">:</span>
-</span><span id="1-752">            <span class="n">max_spans</span> <span class="o">=</span> <span class="p">(</span>
-</span><span id="1-753">                <span class="n">client</span> <span class="ow">and</span> <span class="n">client</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;_experiments&quot;</span><span class="p">]</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;max_spans&quot;</span><span class="p">)</span>
-</span><span id="1-754">            <span class="p">)</span> <span class="ow">or</span> <span class="mi">1000</span>
-</span><span id="1-755">            <span class="n">transaction</span><span class="o">.</span><span class="n">init_span_recorder</span><span class="p">(</span><span class="n">maxlen</span><span class="o">=</span><span class="n">max_spans</span><span class="p">)</span>
-</span><span id="1-756">
-</span><span id="1-757">        <span class="k">return</span> <span class="n">transaction</span></div>
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.start_transaction">[docs]</a>
+</span><span id="1-964">    <span class="k">def</span> <span class="nf">start_transaction</span><span class="p">(</span>
+</span><span id="1-965">        <span class="bp">self</span><span class="p">,</span>
+</span><span id="1-966">        <span class="n">transaction</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
+</span><span id="1-967">        <span class="n">instrumenter</span><span class="o">=</span><span class="n">INSTRUMENTER</span><span class="o">.</span><span class="n">SENTRY</span><span class="p">,</span>
+</span><span id="1-968">        <span class="n">custom_sampling_context</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>
+</span><span id="1-969">        <span class="o">**</span><span class="n">kwargs</span>
+</span><span id="1-970">    <span class="p">):</span>
+</span><span id="1-971">        <span class="c1"># type: (Optional[Transaction], str, Optional[SamplingContext], Unpack[TransactionKwargs]) -&gt; Union[Transaction, NoOpSpan]</span>
+</span><span id="1-972"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-973"><span class="sd">        Start and return a transaction.</span>
+</span><span id="1-974">
+</span><span id="1-975"><span class="sd">        Start an existing transaction if given, otherwise create and start a new</span>
+</span><span id="1-976"><span class="sd">        transaction with kwargs.</span>
+</span><span id="1-977">
+</span><span id="1-978"><span class="sd">        This is the entry point to manual tracing instrumentation.</span>
+</span><span id="1-979">
+</span><span id="1-980"><span class="sd">        A tree structure can be built by adding child spans to the transaction,</span>
+</span><span id="1-981"><span class="sd">        and child spans to other spans. To start a new child span within the</span>
+</span><span id="1-982"><span class="sd">        transaction or any span, call the respective `.start_child()` method.</span>
+</span><span id="1-983">
+</span><span id="1-984"><span class="sd">        Every child span must be finished before the transaction is finished,</span>
+</span><span id="1-985"><span class="sd">        otherwise the unfinished spans are discarded.</span>
+</span><span id="1-986">
+</span><span id="1-987"><span class="sd">        When used as context managers, spans and transactions are automatically</span>
+</span><span id="1-988"><span class="sd">        finished at the end of the `with` block. If not using context managers,</span>
+</span><span id="1-989"><span class="sd">        call the `.finish()` method.</span>
+</span><span id="1-990">
+</span><span id="1-991"><span class="sd">        When the transaction is finished, it will be sent to Sentry with all its</span>
+</span><span id="1-992"><span class="sd">        finished child spans.</span>
+</span><span id="1-993">
+</span><span id="1-994"><span class="sd">        :param transaction: The transaction to start. If omitted, we create and</span>
+</span><span id="1-995"><span class="sd">            start a new transaction.</span>
+</span><span id="1-996"><span class="sd">        :param instrumenter: This parameter is meant for internal use only.</span>
+</span><span id="1-997"><span class="sd">        :param custom_sampling_context: The transaction&#39;s custom sampling context.</span>
+</span><span id="1-998"><span class="sd">        :param kwargs: Optional keyword arguments to be passed to the Transaction</span>
+</span><span id="1-999"><span class="sd">            constructor. See :py:class:`sentry_sdk.tracing.Transaction` for</span>
+</span><span id="1-1000"><span class="sd">            available arguments.</span>
+</span><span id="1-1001"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-1002">        <span class="n">kwargs</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="s2">&quot;scope&quot;</span><span class="p">,</span> <span class="bp">self</span><span class="p">)</span>
+</span><span id="1-1003">
+</span><span id="1-1004">        <span class="n">client</span> <span class="o">=</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_client</span><span class="p">()</span>
+</span><span id="1-1005">
+</span><span id="1-1006">        <span class="n">configuration_instrumenter</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;instrumenter&quot;</span><span class="p">]</span>
+</span><span id="1-1007">
+</span><span id="1-1008">        <span class="k">if</span> <span class="n">instrumenter</span> <span class="o">!=</span> <span class="n">configuration_instrumenter</span><span class="p">:</span>
+</span><span id="1-1009">            <span class="k">return</span> <span class="n">NoOpSpan</span><span class="p">()</span>
+</span><span id="1-1010">
+</span><span id="1-1011">        <span class="n">custom_sampling_context</span> <span class="o">=</span> <span class="n">custom_sampling_context</span> <span class="ow">or</span> <span class="p">{}</span>
+</span><span id="1-1012">
+</span><span id="1-1013">        <span class="c1"># kwargs at this point has type TransactionKwargs, since we have removed</span>
+</span><span id="1-1014">        <span class="c1"># the client and custom_sampling_context from it.</span>
+</span><span id="1-1015">        <span class="n">transaction_kwargs</span> <span class="o">=</span> <span class="n">kwargs</span>  <span class="c1"># type: TransactionKwargs</span>
+</span><span id="1-1016">
+</span><span id="1-1017">        <span class="c1"># if we haven&#39;t been given a transaction, make one</span>
+</span><span id="1-1018">        <span class="k">if</span> <span class="n">transaction</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-1019">            <span class="n">transaction</span> <span class="o">=</span> <span class="n">Transaction</span><span class="p">(</span><span class="o">**</span><span class="n">transaction_kwargs</span><span class="p">)</span>
+</span><span id="1-1020">
+</span><span id="1-1021">        <span class="c1"># use traces_sample_rate, traces_sampler, and/or inheritance to make a</span>
+</span><span id="1-1022">        <span class="c1"># sampling decision</span>
+</span><span id="1-1023">        <span class="n">sampling_context</span> <span class="o">=</span> <span class="p">{</span>
+</span><span id="1-1024">            <span class="s2">&quot;transaction_context&quot;</span><span class="p">:</span> <span class="n">transaction</span><span class="o">.</span><span class="n">to_json</span><span class="p">(),</span>
+</span><span id="1-1025">            <span class="s2">&quot;parent_sampled&quot;</span><span class="p">:</span> <span class="n">transaction</span><span class="o">.</span><span class="n">parent_sampled</span><span class="p">,</span>
+</span><span id="1-1026">        <span class="p">}</span>
+</span><span id="1-1027">        <span class="n">sampling_context</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">custom_sampling_context</span><span class="p">)</span>
+</span><span id="1-1028">        <span class="n">transaction</span><span class="o">.</span><span class="n">_set_initial_sampling_decision</span><span class="p">(</span><span class="n">sampling_context</span><span class="o">=</span><span class="n">sampling_context</span><span class="p">)</span>
+</span><span id="1-1029">
+</span><span id="1-1030">        <span class="n">profile</span> <span class="o">=</span> <span class="n">Profile</span><span class="p">(</span><span class="n">transaction</span><span class="p">)</span>
+</span><span id="1-1031">        <span class="n">profile</span><span class="o">.</span><span class="n">_set_initial_sampling_decision</span><span class="p">(</span><span class="n">sampling_context</span><span class="o">=</span><span class="n">sampling_context</span><span class="p">)</span>
+</span><span id="1-1032">
+</span><span id="1-1033">        <span class="c1"># we don&#39;t bother to keep spans if we already know we&#39;re not going to</span>
+</span><span id="1-1034">        <span class="c1"># send the transaction</span>
+</span><span id="1-1035">        <span class="k">if</span> <span class="n">transaction</span><span class="o">.</span><span class="n">sampled</span><span class="p">:</span>
+</span><span id="1-1036">            <span class="n">max_spans</span> <span class="o">=</span> <span class="p">(</span><span class="n">client</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;_experiments&quot;</span><span class="p">]</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;max_spans&quot;</span><span class="p">))</span> <span class="ow">or</span> <span class="mi">1000</span>
+</span><span id="1-1037">            <span class="n">transaction</span><span class="o">.</span><span class="n">init_span_recorder</span><span class="p">(</span><span class="n">maxlen</span><span class="o">=</span><span class="n">max_spans</span><span class="p">)</span>
+</span><span id="1-1038">
+</span><span id="1-1039">        <span class="k">return</span> <span class="n">transaction</span></div>
 
-</span><span id="1-758">
+</span><span id="1-1040">
 <div class="viewcode-block" id="Scope.start_span">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Scope.start_span">[docs]</a>
-</span><span id="1-759">    <span class="k">def</span> <span class="nf">start_span</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">span</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">instrumenter</span><span class="o">=</span><span class="n">INSTRUMENTER</span><span class="o">.</span><span class="n">SENTRY</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-</span><span id="1-760">        <span class="c1"># type: (Optional[Span], str, Any) -&gt; Span</span>
-</span><span id="1-761"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-762"><span class="sd">        Start a span whose parent is the currently active span or transaction, if any.</span>
-</span><span id="1-763">
-</span><span id="1-764"><span class="sd">        The return value is a :py:class:`sentry_sdk.tracing.Span` instance,</span>
-</span><span id="1-765"><span class="sd">        typically used as a context manager to start and stop timing in a `with`</span>
-</span><span id="1-766"><span class="sd">        block.</span>
-</span><span id="1-767">
-</span><span id="1-768"><span class="sd">        Only spans contained in a transaction are sent to Sentry. Most</span>
-</span><span id="1-769"><span class="sd">        integrations start a transaction at the appropriate time, for example</span>
-</span><span id="1-770"><span class="sd">        for every incoming HTTP request. Use</span>
-</span><span id="1-771"><span class="sd">        :py:meth:`sentry_sdk.start_transaction` to start a new transaction when</span>
-</span><span id="1-772"><span class="sd">        one is not already in progress.</span>
-</span><span id="1-773">
-</span><span id="1-774"><span class="sd">        For supported `**kwargs` see :py:class:`sentry_sdk.tracing.Span`.</span>
-</span><span id="1-775"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-776">        <span class="n">client</span> <span class="o">=</span> <span class="n">kwargs</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;client&quot;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-</span><span id="1-777">
-</span><span id="1-778">        <span class="n">configuration_instrumenter</span> <span class="o">=</span> <span class="n">client</span> <span class="ow">and</span> <span class="n">client</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;instrumenter&quot;</span><span class="p">]</span>
-</span><span id="1-779">
-</span><span id="1-780">        <span class="k">if</span> <span class="n">instrumenter</span> <span class="o">!=</span> <span class="n">configuration_instrumenter</span><span class="p">:</span>
-</span><span id="1-781">            <span class="k">return</span> <span class="n">NoOpSpan</span><span class="p">()</span>
-</span><span id="1-782">
-</span><span id="1-783">        <span class="c1"># THIS BLOCK IS DEPRECATED</span>
-</span><span id="1-784">        <span class="c1"># TODO: consider removing this in a future release.</span>
-</span><span id="1-785">        <span class="c1"># This is for backwards compatibility with releases before</span>
-</span><span id="1-786">        <span class="c1"># start_transaction existed, to allow for a smoother transition.</span>
-</span><span id="1-787">        <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">span</span><span class="p">,</span> <span class="n">Transaction</span><span class="p">)</span> <span class="ow">or</span> <span class="s2">&quot;transaction&quot;</span> <span class="ow">in</span> <span class="n">kwargs</span><span class="p">:</span>
-</span><span id="1-788">            <span class="n">deprecation_msg</span> <span class="o">=</span> <span class="p">(</span>
-</span><span id="1-789">                <span class="s2">&quot;Deprecated: use start_transaction to start transactions and &quot;</span>
-</span><span id="1-790">                <span class="s2">&quot;Transaction.start_child to start spans.&quot;</span>
-</span><span id="1-791">            <span class="p">)</span>
-</span><span id="1-792">
-</span><span id="1-793">            <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">span</span><span class="p">,</span> <span class="n">Transaction</span><span class="p">):</span>
-</span><span id="1-794">                <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span><span class="n">deprecation_msg</span><span class="p">)</span>
-</span><span id="1-795">                <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">start_transaction</span><span class="p">(</span><span class="n">span</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-</span><span id="1-796">
-</span><span id="1-797">            <span class="k">if</span> <span class="s2">&quot;transaction&quot;</span> <span class="ow">in</span> <span class="n">kwargs</span><span class="p">:</span>
-</span><span id="1-798">                <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span><span class="n">deprecation_msg</span><span class="p">)</span>
-</span><span id="1-799">                <span class="n">name</span> <span class="o">=</span> <span class="n">kwargs</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s2">&quot;transaction&quot;</span><span class="p">)</span>
-</span><span id="1-800">                <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">start_transaction</span><span class="p">(</span><span class="n">name</span><span class="o">=</span><span class="n">name</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-</span><span id="1-801">
-</span><span id="1-802">        <span class="c1"># THIS BLOCK IS DEPRECATED</span>
-</span><span id="1-803">        <span class="c1"># We do not pass a span into start_span in our code base, so I deprecate this.</span>
-</span><span id="1-804">        <span class="k">if</span> <span class="n">span</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-805">            <span class="n">deprecation_msg</span> <span class="o">=</span> <span class="s2">&quot;Deprecated: passing a span into `start_span` is deprecated and will be removed in the future.&quot;</span>
-</span><span id="1-806">            <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span><span class="n">deprecation_msg</span><span class="p">)</span>
-</span><span id="1-807">            <span class="k">return</span> <span class="n">span</span>
-</span><span id="1-808">
-</span><span id="1-809">        <span class="n">kwargs</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s2">&quot;client&quot;</span><span class="p">)</span>
-</span><span id="1-810">
-</span><span id="1-811">        <span class="n">active_span</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">span</span>
-</span><span id="1-812">        <span class="k">if</span> <span class="n">active_span</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-813">            <span class="n">new_child_span</span> <span class="o">=</span> <span class="n">active_span</span><span class="o">.</span><span class="n">start_child</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-</span><span id="1-814">            <span class="k">return</span> <span class="n">new_child_span</span>
-</span><span id="1-815">
-</span><span id="1-816">        <span class="c1"># If there is already a trace_id in the propagation context, use it.</span>
-</span><span id="1-817">        <span class="c1"># This does not need to be done for `start_child` above because it takes</span>
-</span><span id="1-818">        <span class="c1"># the trace_id from the parent span.</span>
-</span><span id="1-819">        <span class="k">if</span> <span class="s2">&quot;trace_id&quot;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">kwargs</span><span class="p">:</span>
-</span><span id="1-820">            <span class="n">traceparent</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_traceparent</span><span class="p">()</span>
-</span><span id="1-821">            <span class="n">trace_id</span> <span class="o">=</span> <span class="n">traceparent</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s2">&quot;-&quot;</span><span class="p">)[</span><span class="mi">0</span><span class="p">]</span> <span class="k">if</span> <span class="n">traceparent</span> <span class="k">else</span> <span class="kc">None</span>
-</span><span id="1-822">            <span class="k">if</span> <span class="n">trace_id</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-823">                <span class="n">kwargs</span><span class="p">[</span><span class="s2">&quot;trace_id&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">trace_id</span>
-</span><span id="1-824">
-</span><span id="1-825">        <span class="k">return</span> <span class="n">Span</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></div>
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.start_span">[docs]</a>
+</span><span id="1-1041">    <span class="k">def</span> <span class="nf">start_span</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">instrumenter</span><span class="o">=</span><span class="n">INSTRUMENTER</span><span class="o">.</span><span class="n">SENTRY</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
+</span><span id="1-1042">        <span class="c1"># type: (str, Any) -&gt; Span</span>
+</span><span id="1-1043"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-1044"><span class="sd">        Start a span whose parent is the currently active span or transaction, if any.</span>
+</span><span id="1-1045">
+</span><span id="1-1046"><span class="sd">        The return value is a :py:class:`sentry_sdk.tracing.Span` instance,</span>
+</span><span id="1-1047"><span class="sd">        typically used as a context manager to start and stop timing in a `with`</span>
+</span><span id="1-1048"><span class="sd">        block.</span>
+</span><span id="1-1049">
+</span><span id="1-1050"><span class="sd">        Only spans contained in a transaction are sent to Sentry. Most</span>
+</span><span id="1-1051"><span class="sd">        integrations start a transaction at the appropriate time, for example</span>
+</span><span id="1-1052"><span class="sd">        for every incoming HTTP request. Use</span>
+</span><span id="1-1053"><span class="sd">        :py:meth:`sentry_sdk.start_transaction` to start a new transaction when</span>
+</span><span id="1-1054"><span class="sd">        one is not already in progress.</span>
+</span><span id="1-1055">
+</span><span id="1-1056"><span class="sd">        For supported `**kwargs` see :py:class:`sentry_sdk.tracing.Span`.</span>
+</span><span id="1-1057"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-1058">        <span class="k">with</span> <span class="n">new_scope</span><span class="p">():</span>
+</span><span id="1-1059">            <span class="n">kwargs</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="s2">&quot;scope&quot;</span><span class="p">,</span> <span class="bp">self</span><span class="p">)</span>
+</span><span id="1-1060">
+</span><span id="1-1061">            <span class="n">client</span> <span class="o">=</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_client</span><span class="p">()</span>
+</span><span id="1-1062">
+</span><span id="1-1063">            <span class="n">configuration_instrumenter</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;instrumenter&quot;</span><span class="p">]</span>
+</span><span id="1-1064">
+</span><span id="1-1065">            <span class="k">if</span> <span class="n">instrumenter</span> <span class="o">!=</span> <span class="n">configuration_instrumenter</span><span class="p">:</span>
+</span><span id="1-1066">                <span class="k">return</span> <span class="n">NoOpSpan</span><span class="p">()</span>
+</span><span id="1-1067">
+</span><span id="1-1068">            <span class="c1"># get current span or transaction</span>
+</span><span id="1-1069">            <span class="n">span</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">span</span> <span class="ow">or</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_isolation_scope</span><span class="p">()</span><span class="o">.</span><span class="n">span</span>
+</span><span id="1-1070">
+</span><span id="1-1071">            <span class="k">if</span> <span class="n">span</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-1072">                <span class="c1"># New spans get the `trace_id`` from the scope</span>
+</span><span id="1-1073">                <span class="k">if</span> <span class="s2">&quot;trace_id&quot;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">kwargs</span><span class="p">:</span>
+</span><span id="1-1074">
+</span><span id="1-1075">                    <span class="n">trace_id</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_active_propagation_context</span><span class="p">()</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;trace_id&quot;</span><span class="p">)</span>
+</span><span id="1-1076">                    <span class="k">if</span> <span class="n">trace_id</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-1077">                        <span class="n">kwargs</span><span class="p">[</span><span class="s2">&quot;trace_id&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">trace_id</span>
+</span><span id="1-1078">
+</span><span id="1-1079">                <span class="n">span</span> <span class="o">=</span> <span class="n">Span</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+</span><span id="1-1080">            <span class="k">else</span><span class="p">:</span>
+</span><span id="1-1081">                <span class="c1"># Children take `trace_id`` from the parent span.</span>
+</span><span id="1-1082">                <span class="n">span</span> <span class="o">=</span> <span class="n">span</span><span class="o">.</span><span class="n">start_child</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+</span><span id="1-1083">
+</span><span id="1-1084">            <span class="k">return</span> <span class="n">span</span></div>
 
-</span><span id="1-826">
+</span><span id="1-1085">
 <div class="viewcode-block" id="Scope.continue_trace">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Scope.continue_trace">[docs]</a>
-</span><span id="1-827">    <span class="k">def</span> <span class="nf">continue_trace</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">environ_or_headers</span><span class="p">,</span> <span class="n">op</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">source</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-</span><span id="1-828">        <span class="c1"># type: (Dict[str, Any], Optional[str], Optional[str], Optional[str]) -&gt; Transaction</span>
-</span><span id="1-829"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-830"><span class="sd">        Sets the propagation context from environment or headers and returns a transaction.</span>
-</span><span id="1-831"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-832">        <span class="bp">self</span><span class="o">.</span><span class="n">generate_propagation_context</span><span class="p">(</span><span class="n">environ_or_headers</span><span class="p">)</span>
-</span><span id="1-833">
-</span><span id="1-834">        <span class="n">transaction</span> <span class="o">=</span> <span class="n">Transaction</span><span class="o">.</span><span class="n">continue_from_headers</span><span class="p">(</span>
-</span><span id="1-835">            <span class="n">normalize_incoming_data</span><span class="p">(</span><span class="n">environ_or_headers</span><span class="p">),</span>
-</span><span id="1-836">            <span class="n">op</span><span class="o">=</span><span class="n">op</span><span class="p">,</span>
-</span><span id="1-837">            <span class="n">name</span><span class="o">=</span><span class="n">name</span><span class="p">,</span>
-</span><span id="1-838">            <span class="n">source</span><span class="o">=</span><span class="n">source</span><span class="p">,</span>
-</span><span id="1-839">        <span class="p">)</span>
-</span><span id="1-840">
-</span><span id="1-841">        <span class="k">return</span> <span class="n">transaction</span></div>
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.continue_trace">[docs]</a>
+</span><span id="1-1086">    <span class="k">def</span> <span class="nf">continue_trace</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">environ_or_headers</span><span class="p">,</span> <span class="n">op</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">name</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">source</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+</span><span id="1-1087">        <span class="c1"># type: (Dict[str, Any], Optional[str], Optional[str], Optional[str]) -&gt; Transaction</span>
+</span><span id="1-1088"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-1089"><span class="sd">        Sets the propagation context from environment or headers and returns a transaction.</span>
+</span><span id="1-1090"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-1091">        <span class="bp">self</span><span class="o">.</span><span class="n">generate_propagation_context</span><span class="p">(</span><span class="n">environ_or_headers</span><span class="p">)</span>
+</span><span id="1-1092">
+</span><span id="1-1093">        <span class="n">transaction</span> <span class="o">=</span> <span class="n">Transaction</span><span class="o">.</span><span class="n">continue_from_headers</span><span class="p">(</span>
+</span><span id="1-1094">            <span class="n">normalize_incoming_data</span><span class="p">(</span><span class="n">environ_or_headers</span><span class="p">),</span>
+</span><span id="1-1095">            <span class="n">op</span><span class="o">=</span><span class="n">op</span><span class="p">,</span>
+</span><span id="1-1096">            <span class="n">name</span><span class="o">=</span><span class="n">name</span><span class="p">,</span>
+</span><span id="1-1097">            <span class="n">source</span><span class="o">=</span><span class="n">source</span><span class="p">,</span>
+</span><span id="1-1098">        <span class="p">)</span>
+</span><span id="1-1099">
+</span><span id="1-1100">        <span class="k">return</span> <span class="n">transaction</span></div>
 
-</span><span id="1-842">
+</span><span id="1-1101">
 <div class="viewcode-block" id="Scope.capture_event">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Scope.capture_event">[docs]</a>
-</span><span id="1-843">    <span class="k">def</span> <span class="nf">capture_event</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">client</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">scope_kwargs</span><span class="p">):</span>
-</span><span id="1-844">        <span class="c1"># type: (Event, Optional[Hint], Optional[sentry_sdk.Client], Optional[Scope], Any) -&gt; Optional[str]</span>
-</span><span id="1-845"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-846"><span class="sd">        Captures an event.</span>
-</span><span id="1-847">
-</span><span id="1-848"><span class="sd">        Merges given scope data and calls :py:meth:`sentry_sdk.Client.capture_event`.</span>
-</span><span id="1-849">
-</span><span id="1-850"><span class="sd">        :param event: A ready-made event that can be directly sent to Sentry.</span>
-</span><span id="1-851">
-</span><span id="1-852"><span class="sd">        :param hint: Contains metadata about the event that can be read from `before_send`, such as the original exception object or a HTTP request object.</span>
-</span><span id="1-853">
-</span><span id="1-854"><span class="sd">        :param client: The client to use for sending the event to Sentry.</span>
-</span><span id="1-855">
-</span><span id="1-856"><span class="sd">        :param scope: An optional :py:class:`sentry_sdk.Scope` to apply to events.</span>
-</span><span id="1-857"><span class="sd">            The `scope` and `scope_kwargs` parameters are mutually exclusive.</span>
-</span><span id="1-858">
-</span><span id="1-859"><span class="sd">        :param scope_kwargs: Optional data to apply to event.</span>
-</span><span id="1-860"><span class="sd">            For supported `**scope_kwargs` see :py:meth:`sentry_sdk.Scope.update_from_kwargs`.</span>
-</span><span id="1-861"><span class="sd">            The `scope` and `scope_kwargs` parameters are mutually exclusive.</span>
-</span><span id="1-862">
-</span><span id="1-863"><span class="sd">        :returns: An `event_id` if the SDK decided to send the event (see :py:meth:`sentry_sdk.Client.capture_event`).</span>
-</span><span id="1-864"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-865">        <span class="k">if</span> <span class="n">client</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-866">            <span class="k">return</span> <span class="kc">None</span>
-</span><span id="1-867">
-</span><span id="1-868">        <span class="n">scope</span> <span class="o">=</span> <span class="n">_merge_scopes</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">scope</span><span class="p">,</span> <span class="n">scope_kwargs</span><span class="p">)</span>
-</span><span id="1-869">
-</span><span id="1-870">        <span class="k">return</span> <span class="n">client</span><span class="o">.</span><span class="n">capture_event</span><span class="p">(</span><span class="n">event</span><span class="o">=</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="o">=</span><span class="n">hint</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="n">scope</span><span class="p">)</span></div>
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.capture_event">[docs]</a>
+</span><span id="1-1102">    <span class="k">def</span> <span class="nf">capture_event</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">scope_kwargs</span><span class="p">):</span>
+</span><span id="1-1103">        <span class="c1"># type: (Event, Optional[Hint], Optional[Scope], Any) -&gt; Optional[str]</span>
+</span><span id="1-1104"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-1105"><span class="sd">        Captures an event.</span>
+</span><span id="1-1106">
+</span><span id="1-1107"><span class="sd">        Merges given scope data and calls :py:meth:`sentry_sdk.client._Client.capture_event`.</span>
+</span><span id="1-1108">
+</span><span id="1-1109"><span class="sd">        :param event: A ready-made event that can be directly sent to Sentry.</span>
+</span><span id="1-1110">
+</span><span id="1-1111"><span class="sd">        :param hint: Contains metadata about the event that can be read from `before_send`, such as the original exception object or a HTTP request object.</span>
+</span><span id="1-1112">
+</span><span id="1-1113"><span class="sd">        :param scope: An optional :py:class:`sentry_sdk.Scope` to apply to events.</span>
+</span><span id="1-1114"><span class="sd">            The `scope` and `scope_kwargs` parameters are mutually exclusive.</span>
+</span><span id="1-1115">
+</span><span id="1-1116"><span class="sd">        :param scope_kwargs: Optional data to apply to event.</span>
+</span><span id="1-1117"><span class="sd">            For supported `**scope_kwargs` see :py:meth:`sentry_sdk.Scope.update_from_kwargs`.</span>
+</span><span id="1-1118"><span class="sd">            The `scope` and `scope_kwargs` parameters are mutually exclusive.</span>
+</span><span id="1-1119">
+</span><span id="1-1120"><span class="sd">        :returns: An `event_id` if the SDK decided to send the event (see :py:meth:`sentry_sdk.client._Client.capture_event`).</span>
+</span><span id="1-1121"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-1122">        <span class="n">scope</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_merge_scopes</span><span class="p">(</span><span class="n">scope</span><span class="p">,</span> <span class="n">scope_kwargs</span><span class="p">)</span>
+</span><span id="1-1123">
+</span><span id="1-1124">        <span class="k">return</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_client</span><span class="p">()</span><span class="o">.</span><span class="n">capture_event</span><span class="p">(</span><span class="n">event</span><span class="o">=</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="o">=</span><span class="n">hint</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="n">scope</span><span class="p">)</span></div>
 
-</span><span id="1-871">
+</span><span id="1-1125">
 <div class="viewcode-block" id="Scope.capture_message">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Scope.capture_message">[docs]</a>
-</span><span id="1-872">    <span class="k">def</span> <span class="nf">capture_message</span><span class="p">(</span>
-</span><span id="1-873">        <span class="bp">self</span><span class="p">,</span> <span class="n">message</span><span class="p">,</span> <span class="n">level</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">client</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">scope_kwargs</span>
-</span><span id="1-874">    <span class="p">):</span>
-</span><span id="1-875">        <span class="c1"># type: (str, Optional[LogLevelStr], Optional[sentry_sdk.Client], Optional[Scope], Any) -&gt; Optional[str]</span>
-</span><span id="1-876"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-877"><span class="sd">        Captures a message.</span>
-</span><span id="1-878">
-</span><span id="1-879"><span class="sd">        :param message: The string to send as the message.</span>
-</span><span id="1-880">
-</span><span id="1-881"><span class="sd">        :param level: If no level is provided, the default level is `info`.</span>
-</span><span id="1-882">
-</span><span id="1-883"><span class="sd">        :param client: The client to use for sending the event to Sentry.</span>
-</span><span id="1-884">
-</span><span id="1-885"><span class="sd">        :param scope: An optional :py:class:`sentry_sdk.Scope` to apply to events.</span>
-</span><span id="1-886"><span class="sd">            The `scope` and `scope_kwargs` parameters are mutually exclusive.</span>
-</span><span id="1-887">
-</span><span id="1-888"><span class="sd">        :param scope_kwargs: Optional data to apply to event.</span>
-</span><span id="1-889"><span class="sd">            For supported `**scope_kwargs` see :py:meth:`sentry_sdk.Scope.update_from_kwargs`.</span>
-</span><span id="1-890"><span class="sd">            The `scope` and `scope_kwargs` parameters are mutually exclusive.</span>
-</span><span id="1-891">
-</span><span id="1-892"><span class="sd">        :returns: An `event_id` if the SDK decided to send the event (see :py:meth:`sentry_sdk.Client.capture_event`).</span>
-</span><span id="1-893"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-894">        <span class="k">if</span> <span class="n">client</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-895">            <span class="k">return</span> <span class="kc">None</span>
-</span><span id="1-896">
-</span><span id="1-897">        <span class="k">if</span> <span class="n">level</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-898">            <span class="n">level</span> <span class="o">=</span> <span class="s2">&quot;info&quot;</span>
-</span><span id="1-899">
-</span><span id="1-900">        <span class="n">event</span> <span class="o">=</span> <span class="p">{</span>
-</span><span id="1-901">            <span class="s2">&quot;message&quot;</span><span class="p">:</span> <span class="n">message</span><span class="p">,</span>
-</span><span id="1-902">            <span class="s2">&quot;level&quot;</span><span class="p">:</span> <span class="n">level</span><span class="p">,</span>
-</span><span id="1-903">        <span class="p">}</span>  <span class="c1"># type: Event</span>
-</span><span id="1-904">
-</span><span id="1-905">        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">capture_event</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">client</span><span class="o">=</span><span class="n">client</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="n">scope</span><span class="p">,</span> <span class="o">**</span><span class="n">scope_kwargs</span><span class="p">)</span></div>
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.capture_message">[docs]</a>
+</span><span id="1-1126">    <span class="k">def</span> <span class="nf">capture_message</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">message</span><span class="p">,</span> <span class="n">level</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">scope_kwargs</span><span class="p">):</span>
+</span><span id="1-1127">        <span class="c1"># type: (str, Optional[LogLevelStr], Optional[Scope], Any) -&gt; Optional[str]</span>
+</span><span id="1-1128"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-1129"><span class="sd">        Captures a message.</span>
+</span><span id="1-1130">
+</span><span id="1-1131"><span class="sd">        :param message: The string to send as the message.</span>
+</span><span id="1-1132">
+</span><span id="1-1133"><span class="sd">        :param level: If no level is provided, the default level is `info`.</span>
+</span><span id="1-1134">
+</span><span id="1-1135"><span class="sd">        :param scope: An optional :py:class:`sentry_sdk.Scope` to apply to events.</span>
+</span><span id="1-1136"><span class="sd">            The `scope` and `scope_kwargs` parameters are mutually exclusive.</span>
+</span><span id="1-1137">
+</span><span id="1-1138"><span class="sd">        :param scope_kwargs: Optional data to apply to event.</span>
+</span><span id="1-1139"><span class="sd">            For supported `**scope_kwargs` see :py:meth:`sentry_sdk.Scope.update_from_kwargs`.</span>
+</span><span id="1-1140"><span class="sd">            The `scope` and `scope_kwargs` parameters are mutually exclusive.</span>
+</span><span id="1-1141">
+</span><span id="1-1142"><span class="sd">        :returns: An `event_id` if the SDK decided to send the event (see :py:meth:`sentry_sdk.client._Client.capture_event`).</span>
+</span><span id="1-1143"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-1144">        <span class="k">if</span> <span class="n">level</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-1145">            <span class="n">level</span> <span class="o">=</span> <span class="s2">&quot;info&quot;</span>
+</span><span id="1-1146">
+</span><span id="1-1147">        <span class="n">event</span> <span class="o">=</span> <span class="p">{</span>
+</span><span id="1-1148">            <span class="s2">&quot;message&quot;</span><span class="p">:</span> <span class="n">message</span><span class="p">,</span>
+</span><span id="1-1149">            <span class="s2">&quot;level&quot;</span><span class="p">:</span> <span class="n">level</span><span class="p">,</span>
+</span><span id="1-1150">        <span class="p">}</span>  <span class="c1"># type: Event</span>
+</span><span id="1-1151">
+</span><span id="1-1152">        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">capture_event</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="n">scope</span><span class="p">,</span> <span class="o">**</span><span class="n">scope_kwargs</span><span class="p">)</span></div>
 
-</span><span id="1-906">
+</span><span id="1-1153">
 <div class="viewcode-block" id="Scope.capture_exception">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Scope.capture_exception">[docs]</a>
-</span><span id="1-907">    <span class="k">def</span> <span class="nf">capture_exception</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">error</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">client</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">scope_kwargs</span><span class="p">):</span>
-</span><span id="1-908">        <span class="c1"># type: (Optional[Union[BaseException, ExcInfo]], Optional[sentry_sdk.Client], Optional[Scope], Any) -&gt; Optional[str]</span>
-</span><span id="1-909"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Captures an exception.</span>
-</span><span id="1-910">
-</span><span id="1-911"><span class="sd">        :param error: An exception to capture. If `None`, `sys.exc_info()` will be used.</span>
-</span><span id="1-912">
-</span><span id="1-913"><span class="sd">        :param client: The client to use for sending the event to Sentry.</span>
-</span><span id="1-914">
-</span><span id="1-915"><span class="sd">        :param scope: An optional :py:class:`sentry_sdk.Scope` to apply to events.</span>
-</span><span id="1-916"><span class="sd">            The `scope` and `scope_kwargs` parameters are mutually exclusive.</span>
-</span><span id="1-917">
-</span><span id="1-918"><span class="sd">        :param scope_kwargs: Optional data to apply to event.</span>
-</span><span id="1-919"><span class="sd">            For supported `**scope_kwargs` see :py:meth:`sentry_sdk.Scope.update_from_kwargs`.</span>
-</span><span id="1-920"><span class="sd">            The `scope` and `scope_kwargs` parameters are mutually exclusive.</span>
-</span><span id="1-921">
-</span><span id="1-922"><span class="sd">        :returns: An `event_id` if the SDK decided to send the event (see :py:meth:`sentry_sdk.Client.capture_event`).</span>
-</span><span id="1-923"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-924">        <span class="k">if</span> <span class="n">client</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-925">            <span class="k">return</span> <span class="kc">None</span>
-</span><span id="1-926">
-</span><span id="1-927">        <span class="k">if</span> <span class="n">error</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-928">            <span class="n">exc_info</span> <span class="o">=</span> <span class="n">exc_info_from_error</span><span class="p">(</span><span class="n">error</span><span class="p">)</span>
-</span><span id="1-929">        <span class="k">else</span><span class="p">:</span>
-</span><span id="1-930">            <span class="n">exc_info</span> <span class="o">=</span> <span class="n">sys</span><span class="o">.</span><span class="n">exc_info</span><span class="p">()</span>
-</span><span id="1-931">
-</span><span id="1-932">        <span class="n">event</span><span class="p">,</span> <span class="n">hint</span> <span class="o">=</span> <span class="n">event_from_exception</span><span class="p">(</span><span class="n">exc_info</span><span class="p">,</span> <span class="n">client_options</span><span class="o">=</span><span class="n">client</span><span class="o">.</span><span class="n">options</span><span class="p">)</span>
-</span><span id="1-933">
-</span><span id="1-934">        <span class="k">try</span><span class="p">:</span>
-</span><span id="1-935">            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">capture_event</span><span class="p">(</span>
-</span><span id="1-936">                <span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="o">=</span><span class="n">hint</span><span class="p">,</span> <span class="n">client</span><span class="o">=</span><span class="n">client</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="n">scope</span><span class="p">,</span> <span class="o">**</span><span class="n">scope_kwargs</span>
-</span><span id="1-937">            <span class="p">)</span>
-</span><span id="1-938">        <span class="k">except</span> <span class="ne">Exception</span><span class="p">:</span>
-</span><span id="1-939">            <span class="bp">self</span><span class="o">.</span><span class="n">_capture_internal_exception</span><span class="p">(</span><span class="n">sys</span><span class="o">.</span><span class="n">exc_info</span><span class="p">())</span>
-</span><span id="1-940">
-</span><span id="1-941">        <span class="k">return</span> <span class="kc">None</span></div>
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.capture_exception">[docs]</a>
+</span><span id="1-1154">    <span class="k">def</span> <span class="nf">capture_exception</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">error</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">scope_kwargs</span><span class="p">):</span>
+</span><span id="1-1155">        <span class="c1"># type: (Optional[Union[BaseException, ExcInfo]], Optional[Scope], Any) -&gt; Optional[str]</span>
+</span><span id="1-1156"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Captures an exception.</span>
+</span><span id="1-1157">
+</span><span id="1-1158"><span class="sd">        :param error: An exception to capture. If `None`, `sys.exc_info()` will be used.</span>
+</span><span id="1-1159">
+</span><span id="1-1160"><span class="sd">        :param scope: An optional :py:class:`sentry_sdk.Scope` to apply to events.</span>
+</span><span id="1-1161"><span class="sd">            The `scope` and `scope_kwargs` parameters are mutually exclusive.</span>
+</span><span id="1-1162">
+</span><span id="1-1163"><span class="sd">        :param scope_kwargs: Optional data to apply to event.</span>
+</span><span id="1-1164"><span class="sd">            For supported `**scope_kwargs` see :py:meth:`sentry_sdk.Scope.update_from_kwargs`.</span>
+</span><span id="1-1165"><span class="sd">            The `scope` and `scope_kwargs` parameters are mutually exclusive.</span>
+</span><span id="1-1166">
+</span><span id="1-1167"><span class="sd">        :returns: An `event_id` if the SDK decided to send the event (see :py:meth:`sentry_sdk.client._Client.capture_event`).</span>
+</span><span id="1-1168"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-1169">        <span class="k">if</span> <span class="n">error</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-1170">            <span class="n">exc_info</span> <span class="o">=</span> <span class="n">exc_info_from_error</span><span class="p">(</span><span class="n">error</span><span class="p">)</span>
+</span><span id="1-1171">        <span class="k">else</span><span class="p">:</span>
+</span><span id="1-1172">            <span class="n">exc_info</span> <span class="o">=</span> <span class="n">sys</span><span class="o">.</span><span class="n">exc_info</span><span class="p">()</span>
+</span><span id="1-1173">
+</span><span id="1-1174">        <span class="n">event</span><span class="p">,</span> <span class="n">hint</span> <span class="o">=</span> <span class="n">event_from_exception</span><span class="p">(</span>
+</span><span id="1-1175">            <span class="n">exc_info</span><span class="p">,</span> <span class="n">client_options</span><span class="o">=</span><span class="n">Scope</span><span class="o">.</span><span class="n">get_client</span><span class="p">()</span><span class="o">.</span><span class="n">options</span>
+</span><span id="1-1176">        <span class="p">)</span>
+</span><span id="1-1177">
+</span><span id="1-1178">        <span class="k">try</span><span class="p">:</span>
+</span><span id="1-1179">            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">capture_event</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="o">=</span><span class="n">hint</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="n">scope</span><span class="p">,</span> <span class="o">**</span><span class="n">scope_kwargs</span><span class="p">)</span>
+</span><span id="1-1180">        <span class="k">except</span> <span class="ne">Exception</span><span class="p">:</span>
+</span><span id="1-1181">            <span class="bp">self</span><span class="o">.</span><span class="n">_capture_internal_exception</span><span class="p">(</span><span class="n">sys</span><span class="o">.</span><span class="n">exc_info</span><span class="p">())</span>
+</span><span id="1-1182">
+</span><span id="1-1183">        <span class="k">return</span> <span class="kc">None</span></div>
 
-</span><span id="1-942">
-</span><span id="1-943">    <span class="k">def</span> <span class="nf">_capture_internal_exception</span><span class="p">(</span>
-</span><span id="1-944">        <span class="bp">self</span><span class="p">,</span> <span class="n">exc_info</span>  <span class="c1"># type: Any</span>
-</span><span id="1-945">    <span class="p">):</span>
-</span><span id="1-946">        <span class="c1"># type: (...) -&gt; Any</span>
-</span><span id="1-947"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-948"><span class="sd">        Capture an exception that is likely caused by a bug in the SDK</span>
-</span><span id="1-949"><span class="sd">        itself.</span>
-</span><span id="1-950">
-</span><span id="1-951"><span class="sd">        These exceptions do not end up in Sentry and are just logged instead.</span>
-</span><span id="1-952"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-953">        <span class="n">logger</span><span class="o">.</span><span class="n">error</span><span class="p">(</span><span class="s2">&quot;Internal error in sentry_sdk&quot;</span><span class="p">,</span> <span class="n">exc_info</span><span class="o">=</span><span class="n">exc_info</span><span class="p">)</span>
-</span><span id="1-954">
+</span><span id="1-1184">
+</span><span id="1-1185">    <span class="k">def</span> <span class="nf">_capture_internal_exception</span><span class="p">(</span>
+</span><span id="1-1186">        <span class="bp">self</span><span class="p">,</span> <span class="n">exc_info</span>  <span class="c1"># type: Any</span>
+</span><span id="1-1187">    <span class="p">):</span>
+</span><span id="1-1188">        <span class="c1"># type: (...) -&gt; Any</span>
+</span><span id="1-1189"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-1190"><span class="sd">        Capture an exception that is likely caused by a bug in the SDK</span>
+</span><span id="1-1191"><span class="sd">        itself.</span>
+</span><span id="1-1192">
+</span><span id="1-1193"><span class="sd">        These exceptions do not end up in Sentry and are just logged instead.</span>
+</span><span id="1-1194"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-1195">        <span class="n">logger</span><span class="o">.</span><span class="n">error</span><span class="p">(</span><span class="s2">&quot;Internal error in sentry_sdk&quot;</span><span class="p">,</span> <span class="n">exc_info</span><span class="o">=</span><span class="n">exc_info</span><span class="p">)</span>
+</span><span id="1-1196">
 <div class="viewcode-block" id="Scope.start_session">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Scope.start_session">[docs]</a>
-</span><span id="1-955">    <span class="k">def</span> <span class="nf">start_session</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-</span><span id="1-956">        <span class="c1"># type: (*Any, **Any) -&gt; None</span>
-</span><span id="1-957"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Starts a new session.&quot;&quot;&quot;</span>
-</span><span id="1-958">        <span class="n">client</span> <span class="o">=</span> <span class="n">kwargs</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s2">&quot;client&quot;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-</span><span id="1-959">        <span class="n">session_mode</span> <span class="o">=</span> <span class="n">kwargs</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s2">&quot;session_mode&quot;</span><span class="p">,</span> <span class="s2">&quot;application&quot;</span><span class="p">)</span>
-</span><span id="1-960">
-</span><span id="1-961">        <span class="bp">self</span><span class="o">.</span><span class="n">end_session</span><span class="p">(</span><span class="n">client</span><span class="o">=</span><span class="n">client</span><span class="p">)</span>
-</span><span id="1-962">
-</span><span id="1-963">        <span class="bp">self</span><span class="o">.</span><span class="n">_session</span> <span class="o">=</span> <span class="n">Session</span><span class="p">(</span>
-</span><span id="1-964">            <span class="n">release</span><span class="o">=</span><span class="n">client</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;release&quot;</span><span class="p">]</span> <span class="k">if</span> <span class="n">client</span> <span class="k">else</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="1-965">            <span class="n">environment</span><span class="o">=</span><span class="n">client</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;environment&quot;</span><span class="p">]</span> <span class="k">if</span> <span class="n">client</span> <span class="k">else</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="1-966">            <span class="n">user</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">_user</span><span class="p">,</span>
-</span><span id="1-967">            <span class="n">session_mode</span><span class="o">=</span><span class="n">session_mode</span><span class="p">,</span>
-</span><span id="1-968">        <span class="p">)</span></div>
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.start_session">[docs]</a>
+</span><span id="1-1197">    <span class="k">def</span> <span class="nf">start_session</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
+</span><span id="1-1198">        <span class="c1"># type: (*Any, **Any) -&gt; None</span>
+</span><span id="1-1199"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Starts a new session.&quot;&quot;&quot;</span>
+</span><span id="1-1200">        <span class="n">session_mode</span> <span class="o">=</span> <span class="n">kwargs</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s2">&quot;session_mode&quot;</span><span class="p">,</span> <span class="s2">&quot;application&quot;</span><span class="p">)</span>
+</span><span id="1-1201">
+</span><span id="1-1202">        <span class="bp">self</span><span class="o">.</span><span class="n">end_session</span><span class="p">()</span>
+</span><span id="1-1203">
+</span><span id="1-1204">        <span class="n">client</span> <span class="o">=</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_client</span><span class="p">()</span>
+</span><span id="1-1205">        <span class="bp">self</span><span class="o">.</span><span class="n">_session</span> <span class="o">=</span> <span class="n">Session</span><span class="p">(</span>
+</span><span id="1-1206">            <span class="n">release</span><span class="o">=</span><span class="n">client</span><span class="o">.</span><span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;release&quot;</span><span class="p">),</span>
+</span><span id="1-1207">            <span class="n">environment</span><span class="o">=</span><span class="n">client</span><span class="o">.</span><span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;environment&quot;</span><span class="p">),</span>
+</span><span id="1-1208">            <span class="n">user</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">_user</span><span class="p">,</span>
+</span><span id="1-1209">            <span class="n">session_mode</span><span class="o">=</span><span class="n">session_mode</span><span class="p">,</span>
+</span><span id="1-1210">        <span class="p">)</span></div>
 
-</span><span id="1-969">
+</span><span id="1-1211">
 <div class="viewcode-block" id="Scope.end_session">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Scope.end_session">[docs]</a>
-</span><span id="1-970">    <span class="k">def</span> <span class="nf">end_session</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-</span><span id="1-971">        <span class="c1"># type: (*Any, **Any) -&gt; None</span>
-</span><span id="1-972"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Ends the current session if there is one.&quot;&quot;&quot;</span>
-</span><span id="1-973">        <span class="n">client</span> <span class="o">=</span> <span class="n">kwargs</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s2">&quot;client&quot;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-</span><span id="1-974">
-</span><span id="1-975">        <span class="n">session</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_session</span>
-</span><span id="1-976">        <span class="bp">self</span><span class="o">.</span><span class="n">_session</span> <span class="o">=</span> <span class="kc">None</span>
-</span><span id="1-977">
-</span><span id="1-978">        <span class="k">if</span> <span class="n">session</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-979">            <span class="n">session</span><span class="o">.</span><span class="n">close</span><span class="p">()</span>
-</span><span id="1-980">            <span class="k">if</span> <span class="n">client</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-981">                <span class="n">client</span><span class="o">.</span><span class="n">capture_session</span><span class="p">(</span><span class="n">session</span><span class="p">)</span></div>
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.end_session">[docs]</a>
+</span><span id="1-1212">    <span class="k">def</span> <span class="nf">end_session</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
+</span><span id="1-1213">        <span class="c1"># type: (*Any, **Any) -&gt; None</span>
+</span><span id="1-1214"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Ends the current session if there is one.&quot;&quot;&quot;</span>
+</span><span id="1-1215">        <span class="n">session</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_session</span>
+</span><span id="1-1216">        <span class="bp">self</span><span class="o">.</span><span class="n">_session</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="1-1217">
+</span><span id="1-1218">        <span class="k">if</span> <span class="n">session</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-1219">            <span class="n">session</span><span class="o">.</span><span class="n">close</span><span class="p">()</span>
+</span><span id="1-1220">            <span class="n">Scope</span><span class="o">.</span><span class="n">get_client</span><span class="p">()</span><span class="o">.</span><span class="n">capture_session</span><span class="p">(</span><span class="n">session</span><span class="p">)</span></div>
 
-</span><span id="1-982">
+</span><span id="1-1221">
 <div class="viewcode-block" id="Scope.stop_auto_session_tracking">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Scope.stop_auto_session_tracking">[docs]</a>
-</span><span id="1-983">    <span class="k">def</span> <span class="nf">stop_auto_session_tracking</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-</span><span id="1-984">        <span class="c1"># type: (*Any, **Any) -&gt; None</span>
-</span><span id="1-985"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Stops automatic session tracking.</span>
-</span><span id="1-986">
-</span><span id="1-987"><span class="sd">        This temporarily session tracking for the current scope when called.</span>
-</span><span id="1-988"><span class="sd">        To resume session tracking call `resume_auto_session_tracking`.</span>
-</span><span id="1-989"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-990">        <span class="n">client</span> <span class="o">=</span> <span class="n">kwargs</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s2">&quot;client&quot;</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-</span><span id="1-991">
-</span><span id="1-992">        <span class="bp">self</span><span class="o">.</span><span class="n">end_session</span><span class="p">(</span><span class="n">client</span><span class="o">=</span><span class="n">client</span><span class="p">)</span>
-</span><span id="1-993">
-</span><span id="1-994">        <span class="bp">self</span><span class="o">.</span><span class="n">_force_auto_session_tracking</span> <span class="o">=</span> <span class="kc">False</span></div>
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.stop_auto_session_tracking">[docs]</a>
+</span><span id="1-1222">    <span class="k">def</span> <span class="nf">stop_auto_session_tracking</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
+</span><span id="1-1223">        <span class="c1"># type: (*Any, **Any) -&gt; None</span>
+</span><span id="1-1224"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Stops automatic session tracking.</span>
+</span><span id="1-1225">
+</span><span id="1-1226"><span class="sd">        This temporarily session tracking for the current scope when called.</span>
+</span><span id="1-1227"><span class="sd">        To resume session tracking call `resume_auto_session_tracking`.</span>
+</span><span id="1-1228"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-1229">        <span class="bp">self</span><span class="o">.</span><span class="n">end_session</span><span class="p">()</span>
+</span><span id="1-1230">        <span class="bp">self</span><span class="o">.</span><span class="n">_force_auto_session_tracking</span> <span class="o">=</span> <span class="kc">False</span></div>
 
-</span><span id="1-995">
+</span><span id="1-1231">
 <div class="viewcode-block" id="Scope.resume_auto_session_tracking">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Scope.resume_auto_session_tracking">[docs]</a>
-</span><span id="1-996">    <span class="k">def</span> <span class="nf">resume_auto_session_tracking</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-997">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-998"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Resumes automatic session tracking for the current scope if</span>
-</span><span id="1-999"><span class="sd">        disabled earlier.  This requires that generally automatic session</span>
-</span><span id="1-1000"><span class="sd">        tracking is enabled.</span>
-</span><span id="1-1001"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-1002">        <span class="bp">self</span><span class="o">.</span><span class="n">_force_auto_session_tracking</span> <span class="o">=</span> <span class="kc">None</span></div>
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.resume_auto_session_tracking">[docs]</a>
+</span><span id="1-1232">    <span class="k">def</span> <span class="nf">resume_auto_session_tracking</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-1233">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-1234"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Resumes automatic session tracking for the current scope if</span>
+</span><span id="1-1235"><span class="sd">        disabled earlier.  This requires that generally automatic session</span>
+</span><span id="1-1236"><span class="sd">        tracking is enabled.</span>
+</span><span id="1-1237"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-1238">        <span class="bp">self</span><span class="o">.</span><span class="n">_force_auto_session_tracking</span> <span class="o">=</span> <span class="kc">None</span></div>
 
-</span><span id="1-1003">
+</span><span id="1-1239">
 <div class="viewcode-block" id="Scope.add_event_processor">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Scope.add_event_processor">[docs]</a>
-</span><span id="1-1004">    <span class="k">def</span> <span class="nf">add_event_processor</span><span class="p">(</span>
-</span><span id="1-1005">        <span class="bp">self</span><span class="p">,</span> <span class="n">func</span>  <span class="c1"># type: EventProcessor</span>
-</span><span id="1-1006">    <span class="p">):</span>
-</span><span id="1-1007">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-1008"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Register a scope local event processor on the scope.</span>
-</span><span id="1-1009">
-</span><span id="1-1010"><span class="sd">        :param func: This function behaves like `before_send.`</span>
-</span><span id="1-1011"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-1012">        <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_event_processors</span><span class="p">)</span> <span class="o">&gt;</span> <span class="mi">20</span><span class="p">:</span>
-</span><span id="1-1013">            <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
-</span><span id="1-1014">                <span class="s2">&quot;Too many event processors on scope! Clearing list to free up some memory: </span><span class="si">%r</span><span class="s2">&quot;</span><span class="p">,</span>
-</span><span id="1-1015">                <span class="bp">self</span><span class="o">.</span><span class="n">_event_processors</span><span class="p">,</span>
-</span><span id="1-1016">            <span class="p">)</span>
-</span><span id="1-1017">            <span class="k">del</span> <span class="bp">self</span><span class="o">.</span><span class="n">_event_processors</span><span class="p">[:]</span>
-</span><span id="1-1018">
-</span><span id="1-1019">        <span class="bp">self</span><span class="o">.</span><span class="n">_event_processors</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">func</span><span class="p">)</span></div>
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.add_event_processor">[docs]</a>
+</span><span id="1-1240">    <span class="k">def</span> <span class="nf">add_event_processor</span><span class="p">(</span>
+</span><span id="1-1241">        <span class="bp">self</span><span class="p">,</span> <span class="n">func</span>  <span class="c1"># type: EventProcessor</span>
+</span><span id="1-1242">    <span class="p">):</span>
+</span><span id="1-1243">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-1244"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Register a scope local event processor on the scope.</span>
+</span><span id="1-1245">
+</span><span id="1-1246"><span class="sd">        :param func: This function behaves like `before_send.`</span>
+</span><span id="1-1247"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-1248">        <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_event_processors</span><span class="p">)</span> <span class="o">&gt;</span> <span class="mi">20</span><span class="p">:</span>
+</span><span id="1-1249">            <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
+</span><span id="1-1250">                <span class="s2">&quot;Too many event processors on scope! Clearing list to free up some memory: </span><span class="si">%r</span><span class="s2">&quot;</span><span class="p">,</span>
+</span><span id="1-1251">                <span class="bp">self</span><span class="o">.</span><span class="n">_event_processors</span><span class="p">,</span>
+</span><span id="1-1252">            <span class="p">)</span>
+</span><span id="1-1253">            <span class="k">del</span> <span class="bp">self</span><span class="o">.</span><span class="n">_event_processors</span><span class="p">[:]</span>
+</span><span id="1-1254">
+</span><span id="1-1255">        <span class="bp">self</span><span class="o">.</span><span class="n">_event_processors</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">func</span><span class="p">)</span></div>
 
-</span><span id="1-1020">
+</span><span id="1-1256">
 <div class="viewcode-block" id="Scope.add_error_processor">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Scope.add_error_processor">[docs]</a>
-</span><span id="1-1021">    <span class="k">def</span> <span class="nf">add_error_processor</span><span class="p">(</span>
-</span><span id="1-1022">        <span class="bp">self</span><span class="p">,</span>
-</span><span id="1-1023">        <span class="n">func</span><span class="p">,</span>  <span class="c1"># type: ErrorProcessor</span>
-</span><span id="1-1024">        <span class="bp">cls</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Type[BaseException]]</span>
-</span><span id="1-1025">    <span class="p">):</span>
-</span><span id="1-1026">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-1027"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Register a scope local error processor on the scope.</span>
-</span><span id="1-1028">
-</span><span id="1-1029"><span class="sd">        :param func: A callback that works similar to an event processor but is invoked with the original exception info triple as second argument.</span>
-</span><span id="1-1030">
-</span><span id="1-1031"><span class="sd">        :param cls: Optionally, only process exceptions of this type.</span>
-</span><span id="1-1032"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-1033">        <span class="k">if</span> <span class="bp">cls</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-1034">            <span class="n">cls_</span> <span class="o">=</span> <span class="bp">cls</span>  <span class="c1"># For mypy.</span>
-</span><span id="1-1035">            <span class="n">real_func</span> <span class="o">=</span> <span class="n">func</span>
-</span><span id="1-1036">
-</span><span id="1-1037">            <span class="k">def</span> <span class="nf">func</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">exc_info</span><span class="p">):</span>
-</span><span id="1-1038">                <span class="c1"># type: (Event, ExcInfo) -&gt; Optional[Event]</span>
-</span><span id="1-1039">                <span class="k">try</span><span class="p">:</span>
-</span><span id="1-1040">                    <span class="n">is_inst</span> <span class="o">=</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">exc_info</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="n">cls_</span><span class="p">)</span>
-</span><span id="1-1041">                <span class="k">except</span> <span class="ne">Exception</span><span class="p">:</span>
-</span><span id="1-1042">                    <span class="n">is_inst</span> <span class="o">=</span> <span class="kc">False</span>
-</span><span id="1-1043">                <span class="k">if</span> <span class="n">is_inst</span><span class="p">:</span>
-</span><span id="1-1044">                    <span class="k">return</span> <span class="n">real_func</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">exc_info</span><span class="p">)</span>
-</span><span id="1-1045">                <span class="k">return</span> <span class="n">event</span>
-</span><span id="1-1046">
-</span><span id="1-1047">        <span class="bp">self</span><span class="o">.</span><span class="n">_error_processors</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">func</span><span class="p">)</span></div>
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.add_error_processor">[docs]</a>
+</span><span id="1-1257">    <span class="k">def</span> <span class="nf">add_error_processor</span><span class="p">(</span>
+</span><span id="1-1258">        <span class="bp">self</span><span class="p">,</span>
+</span><span id="1-1259">        <span class="n">func</span><span class="p">,</span>  <span class="c1"># type: ErrorProcessor</span>
+</span><span id="1-1260">        <span class="bp">cls</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Type[BaseException]]</span>
+</span><span id="1-1261">    <span class="p">):</span>
+</span><span id="1-1262">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-1263"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Register a scope local error processor on the scope.</span>
+</span><span id="1-1264">
+</span><span id="1-1265"><span class="sd">        :param func: A callback that works similar to an event processor but is invoked with the original exception info triple as second argument.</span>
+</span><span id="1-1266">
+</span><span id="1-1267"><span class="sd">        :param cls: Optionally, only process exceptions of this type.</span>
+</span><span id="1-1268"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-1269">        <span class="k">if</span> <span class="bp">cls</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-1270">            <span class="n">cls_</span> <span class="o">=</span> <span class="bp">cls</span>  <span class="c1"># For mypy.</span>
+</span><span id="1-1271">            <span class="n">real_func</span> <span class="o">=</span> <span class="n">func</span>
+</span><span id="1-1272">
+</span><span id="1-1273">            <span class="k">def</span> <span class="nf">func</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">exc_info</span><span class="p">):</span>
+</span><span id="1-1274">                <span class="c1"># type: (Event, ExcInfo) -&gt; Optional[Event]</span>
+</span><span id="1-1275">                <span class="k">try</span><span class="p">:</span>
+</span><span id="1-1276">                    <span class="n">is_inst</span> <span class="o">=</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">exc_info</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="n">cls_</span><span class="p">)</span>
+</span><span id="1-1277">                <span class="k">except</span> <span class="ne">Exception</span><span class="p">:</span>
+</span><span id="1-1278">                    <span class="n">is_inst</span> <span class="o">=</span> <span class="kc">False</span>
+</span><span id="1-1279">                <span class="k">if</span> <span class="n">is_inst</span><span class="p">:</span>
+</span><span id="1-1280">                    <span class="k">return</span> <span class="n">real_func</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">exc_info</span><span class="p">)</span>
+</span><span id="1-1281">                <span class="k">return</span> <span class="n">event</span>
+</span><span id="1-1282">
+</span><span id="1-1283">        <span class="bp">self</span><span class="o">.</span><span class="n">_error_processors</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">func</span><span class="p">)</span></div>
 
-</span><span id="1-1048">
-</span><span id="1-1049">    <span class="k">def</span> <span class="nf">_apply_level_to_event</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">options</span><span class="p">):</span>
-</span><span id="1-1050">        <span class="c1"># type: (Event, Hint, Optional[Dict[str, Any]]) -&gt; None</span>
-</span><span id="1-1051">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_level</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-1052">            <span class="n">event</span><span class="p">[</span><span class="s2">&quot;level&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_level</span>
-</span><span id="1-1053">
-</span><span id="1-1054">    <span class="k">def</span> <span class="nf">_apply_breadcrumbs_to_event</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">options</span><span class="p">):</span>
-</span><span id="1-1055">        <span class="c1"># type: (Event, Hint, Optional[Dict[str, Any]]) -&gt; None</span>
-</span><span id="1-1056">        <span class="n">event</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="s2">&quot;breadcrumbs&quot;</span><span class="p">,</span> <span class="p">{})</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="s2">&quot;values&quot;</span><span class="p">,</span> <span class="p">[])</span><span class="o">.</span><span class="n">extend</span><span class="p">(</span>
-</span><span id="1-1057">            <span class="bp">self</span><span class="o">.</span><span class="n">_breadcrumbs</span>
-</span><span id="1-1058">        <span class="p">)</span>
-</span><span id="1-1059">
-</span><span id="1-1060">    <span class="k">def</span> <span class="nf">_apply_user_to_event</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">options</span><span class="p">):</span>
-</span><span id="1-1061">        <span class="c1"># type: (Event, Hint, Optional[Dict[str, Any]]) -&gt; None</span>
-</span><span id="1-1062">        <span class="k">if</span> <span class="n">event</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;user&quot;</span><span class="p">)</span> <span class="ow">is</span> <span class="kc">None</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">_user</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-1063">            <span class="n">event</span><span class="p">[</span><span class="s2">&quot;user&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_user</span>
-</span><span id="1-1064">
-</span><span id="1-1065">    <span class="k">def</span> <span class="nf">_apply_transaction_name_to_event</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">options</span><span class="p">):</span>
-</span><span id="1-1066">        <span class="c1"># type: (Event, Hint, Optional[Dict[str, Any]]) -&gt; None</span>
-</span><span id="1-1067">        <span class="k">if</span> <span class="n">event</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;transaction&quot;</span><span class="p">)</span> <span class="ow">is</span> <span class="kc">None</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">_transaction</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-1068">            <span class="n">event</span><span class="p">[</span><span class="s2">&quot;transaction&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_transaction</span>
-</span><span id="1-1069">
-</span><span id="1-1070">    <span class="k">def</span> <span class="nf">_apply_transaction_info_to_event</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">options</span><span class="p">):</span>
-</span><span id="1-1071">        <span class="c1"># type: (Event, Hint, Optional[Dict[str, Any]]) -&gt; None</span>
-</span><span id="1-1072">        <span class="k">if</span> <span class="n">event</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;transaction_info&quot;</span><span class="p">)</span> <span class="ow">is</span> <span class="kc">None</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">_transaction_info</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-1073">            <span class="n">event</span><span class="p">[</span><span class="s2">&quot;transaction_info&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_transaction_info</span>
-</span><span id="1-1074">
-</span><span id="1-1075">    <span class="k">def</span> <span class="nf">_apply_fingerprint_to_event</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">options</span><span class="p">):</span>
-</span><span id="1-1076">        <span class="c1"># type: (Event, Hint, Optional[Dict[str, Any]]) -&gt; None</span>
-</span><span id="1-1077">        <span class="k">if</span> <span class="n">event</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;fingerprint&quot;</span><span class="p">)</span> <span class="ow">is</span> <span class="kc">None</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">_fingerprint</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-1078">            <span class="n">event</span><span class="p">[</span><span class="s2">&quot;fingerprint&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_fingerprint</span>
-</span><span id="1-1079">
-</span><span id="1-1080">    <span class="k">def</span> <span class="nf">_apply_extra_to_event</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">options</span><span class="p">):</span>
-</span><span id="1-1081">        <span class="c1"># type: (Event, Hint, Optional[Dict[str, Any]]) -&gt; None</span>
-</span><span id="1-1082">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_extras</span><span class="p">:</span>
-</span><span id="1-1083">            <span class="n">event</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="s2">&quot;extra&quot;</span><span class="p">,</span> <span class="p">{})</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_extras</span><span class="p">)</span>
-</span><span id="1-1084">
-</span><span id="1-1085">    <span class="k">def</span> <span class="nf">_apply_tags_to_event</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">options</span><span class="p">):</span>
-</span><span id="1-1086">        <span class="c1"># type: (Event, Hint, Optional[Dict[str, Any]]) -&gt; None</span>
-</span><span id="1-1087">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_tags</span><span class="p">:</span>
-</span><span id="1-1088">            <span class="n">event</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="s2">&quot;tags&quot;</span><span class="p">,</span> <span class="p">{})</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_tags</span><span class="p">)</span>
-</span><span id="1-1089">
-</span><span id="1-1090">    <span class="k">def</span> <span class="nf">_apply_contexts_to_event</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">options</span><span class="p">):</span>
-</span><span id="1-1091">        <span class="c1"># type: (Event, Hint, Optional[Dict[str, Any]]) -&gt; None</span>
-</span><span id="1-1092">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_contexts</span><span class="p">:</span>
-</span><span id="1-1093">            <span class="n">event</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="s2">&quot;contexts&quot;</span><span class="p">,</span> <span class="p">{})</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_contexts</span><span class="p">)</span>
-</span><span id="1-1094">
-</span><span id="1-1095">        <span class="n">contexts</span> <span class="o">=</span> <span class="n">event</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="s2">&quot;contexts&quot;</span><span class="p">,</span> <span class="p">{})</span>
-</span><span id="1-1096">
-</span><span id="1-1097">        <span class="c1"># Add &quot;trace&quot; context</span>
-</span><span id="1-1098">        <span class="k">if</span> <span class="n">contexts</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;trace&quot;</span><span class="p">)</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-1099">            <span class="k">if</span> <span class="n">has_tracing_enabled</span><span class="p">(</span><span class="n">options</span><span class="p">)</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">_span</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-1100">                <span class="n">contexts</span><span class="p">[</span><span class="s2">&quot;trace&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_span</span><span class="o">.</span><span class="n">get_trace_context</span><span class="p">()</span>
-</span><span id="1-1101">            <span class="k">else</span><span class="p">:</span>
-</span><span id="1-1102">                <span class="n">contexts</span><span class="p">[</span><span class="s2">&quot;trace&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_trace_context</span><span class="p">()</span>
-</span><span id="1-1103">
-</span><span id="1-1104">        <span class="c1"># Add &quot;reply_id&quot; context</span>
-</span><span id="1-1105">        <span class="k">try</span><span class="p">:</span>
-</span><span id="1-1106">            <span class="n">replay_id</span> <span class="o">=</span> <span class="n">contexts</span><span class="p">[</span><span class="s2">&quot;trace&quot;</span><span class="p">][</span><span class="s2">&quot;dynamic_sampling_context&quot;</span><span class="p">][</span><span class="s2">&quot;replay_id&quot;</span><span class="p">]</span>  <span class="c1"># type: ignore</span>
-</span><span id="1-1107">        <span class="k">except</span> <span class="p">(</span><span class="ne">KeyError</span><span class="p">,</span> <span class="ne">TypeError</span><span class="p">):</span>
-</span><span id="1-1108">            <span class="n">replay_id</span> <span class="o">=</span> <span class="kc">None</span>
-</span><span id="1-1109">
-</span><span id="1-1110">        <span class="k">if</span> <span class="n">replay_id</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-1111">            <span class="n">contexts</span><span class="p">[</span><span class="s2">&quot;replay&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="p">{</span>
-</span><span id="1-1112">                <span class="s2">&quot;replay_id&quot;</span><span class="p">:</span> <span class="n">replay_id</span><span class="p">,</span>
-</span><span id="1-1113">            <span class="p">}</span>
-</span><span id="1-1114">
+</span><span id="1-1284">
+</span><span id="1-1285">    <span class="k">def</span> <span class="nf">_apply_level_to_event</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">options</span><span class="p">):</span>
+</span><span id="1-1286">        <span class="c1"># type: (Event, Hint, Optional[Dict[str, Any]]) -&gt; None</span>
+</span><span id="1-1287">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_level</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-1288">            <span class="n">event</span><span class="p">[</span><span class="s2">&quot;level&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_level</span>
+</span><span id="1-1289">
+</span><span id="1-1290">    <span class="k">def</span> <span class="nf">_apply_breadcrumbs_to_event</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">options</span><span class="p">):</span>
+</span><span id="1-1291">        <span class="c1"># type: (Event, Hint, Optional[Dict[str, Any]]) -&gt; None</span>
+</span><span id="1-1292">        <span class="n">event</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="s2">&quot;breadcrumbs&quot;</span><span class="p">,</span> <span class="p">{})</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="s2">&quot;values&quot;</span><span class="p">,</span> <span class="p">[])</span><span class="o">.</span><span class="n">extend</span><span class="p">(</span>
+</span><span id="1-1293">            <span class="bp">self</span><span class="o">.</span><span class="n">_breadcrumbs</span>
+</span><span id="1-1294">        <span class="p">)</span>
+</span><span id="1-1295">
+</span><span id="1-1296">    <span class="k">def</span> <span class="nf">_apply_user_to_event</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">options</span><span class="p">):</span>
+</span><span id="1-1297">        <span class="c1"># type: (Event, Hint, Optional[Dict[str, Any]]) -&gt; None</span>
+</span><span id="1-1298">        <span class="k">if</span> <span class="n">event</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;user&quot;</span><span class="p">)</span> <span class="ow">is</span> <span class="kc">None</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">_user</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-1299">            <span class="n">event</span><span class="p">[</span><span class="s2">&quot;user&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_user</span>
+</span><span id="1-1300">
+</span><span id="1-1301">    <span class="k">def</span> <span class="nf">_apply_transaction_name_to_event</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">options</span><span class="p">):</span>
+</span><span id="1-1302">        <span class="c1"># type: (Event, Hint, Optional[Dict[str, Any]]) -&gt; None</span>
+</span><span id="1-1303">        <span class="k">if</span> <span class="n">event</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;transaction&quot;</span><span class="p">)</span> <span class="ow">is</span> <span class="kc">None</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">_transaction</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-1304">            <span class="n">event</span><span class="p">[</span><span class="s2">&quot;transaction&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_transaction</span>
+</span><span id="1-1305">
+</span><span id="1-1306">    <span class="k">def</span> <span class="nf">_apply_transaction_info_to_event</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">options</span><span class="p">):</span>
+</span><span id="1-1307">        <span class="c1"># type: (Event, Hint, Optional[Dict[str, Any]]) -&gt; None</span>
+</span><span id="1-1308">        <span class="k">if</span> <span class="n">event</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;transaction_info&quot;</span><span class="p">)</span> <span class="ow">is</span> <span class="kc">None</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">_transaction_info</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-1309">            <span class="n">event</span><span class="p">[</span><span class="s2">&quot;transaction_info&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_transaction_info</span>
+</span><span id="1-1310">
+</span><span id="1-1311">    <span class="k">def</span> <span class="nf">_apply_fingerprint_to_event</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">options</span><span class="p">):</span>
+</span><span id="1-1312">        <span class="c1"># type: (Event, Hint, Optional[Dict[str, Any]]) -&gt; None</span>
+</span><span id="1-1313">        <span class="k">if</span> <span class="n">event</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;fingerprint&quot;</span><span class="p">)</span> <span class="ow">is</span> <span class="kc">None</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">_fingerprint</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-1314">            <span class="n">event</span><span class="p">[</span><span class="s2">&quot;fingerprint&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_fingerprint</span>
+</span><span id="1-1315">
+</span><span id="1-1316">    <span class="k">def</span> <span class="nf">_apply_extra_to_event</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">options</span><span class="p">):</span>
+</span><span id="1-1317">        <span class="c1"># type: (Event, Hint, Optional[Dict[str, Any]]) -&gt; None</span>
+</span><span id="1-1318">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_extras</span><span class="p">:</span>
+</span><span id="1-1319">            <span class="n">event</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="s2">&quot;extra&quot;</span><span class="p">,</span> <span class="p">{})</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_extras</span><span class="p">)</span>
+</span><span id="1-1320">
+</span><span id="1-1321">    <span class="k">def</span> <span class="nf">_apply_tags_to_event</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">options</span><span class="p">):</span>
+</span><span id="1-1322">        <span class="c1"># type: (Event, Hint, Optional[Dict[str, Any]]) -&gt; None</span>
+</span><span id="1-1323">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_tags</span><span class="p">:</span>
+</span><span id="1-1324">            <span class="n">event</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="s2">&quot;tags&quot;</span><span class="p">,</span> <span class="p">{})</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_tags</span><span class="p">)</span>
+</span><span id="1-1325">
+</span><span id="1-1326">    <span class="k">def</span> <span class="nf">_apply_contexts_to_event</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">options</span><span class="p">):</span>
+</span><span id="1-1327">        <span class="c1"># type: (Event, Hint, Optional[Dict[str, Any]]) -&gt; None</span>
+</span><span id="1-1328">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_contexts</span><span class="p">:</span>
+</span><span id="1-1329">            <span class="n">event</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="s2">&quot;contexts&quot;</span><span class="p">,</span> <span class="p">{})</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_contexts</span><span class="p">)</span>
+</span><span id="1-1330">
+</span><span id="1-1331">        <span class="n">contexts</span> <span class="o">=</span> <span class="n">event</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="s2">&quot;contexts&quot;</span><span class="p">,</span> <span class="p">{})</span>
+</span><span id="1-1332">
+</span><span id="1-1333">        <span class="c1"># Add &quot;trace&quot; context</span>
+</span><span id="1-1334">        <span class="k">if</span> <span class="n">contexts</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;trace&quot;</span><span class="p">)</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-1335">            <span class="k">if</span> <span class="n">has_tracing_enabled</span><span class="p">(</span><span class="n">options</span><span class="p">)</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">_span</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-1336">                <span class="n">contexts</span><span class="p">[</span><span class="s2">&quot;trace&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_span</span><span class="o">.</span><span class="n">get_trace_context</span><span class="p">()</span>
+</span><span id="1-1337">            <span class="k">else</span><span class="p">:</span>
+</span><span id="1-1338">                <span class="n">contexts</span><span class="p">[</span><span class="s2">&quot;trace&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_trace_context</span><span class="p">()</span>
+</span><span id="1-1339">
+</span><span id="1-1340">    <span class="k">def</span> <span class="nf">_drop</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">cause</span><span class="p">,</span> <span class="n">ty</span><span class="p">):</span>
+</span><span id="1-1341">        <span class="c1"># type: (Any, str) -&gt; Optional[Any]</span>
+</span><span id="1-1342">        <span class="n">logger</span><span class="o">.</span><span class="n">info</span><span class="p">(</span><span class="s2">&quot;</span><span class="si">%s</span><span class="s2"> (</span><span class="si">%s</span><span class="s2">) dropped event&quot;</span><span class="p">,</span> <span class="n">ty</span><span class="p">,</span> <span class="n">cause</span><span class="p">)</span>
+</span><span id="1-1343">        <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-1344">
+<div class="viewcode-block" id="Scope.run_error_processors">
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.run_error_processors">[docs]</a>
+</span><span id="1-1345">    <span class="k">def</span> <span class="nf">run_error_processors</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">):</span>
+</span><span id="1-1346">        <span class="c1"># type: (Event, Hint) -&gt; Optional[Event]</span>
+</span><span id="1-1347"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-1348"><span class="sd">        Runs the error processors on the event and returns the modified event.</span>
+</span><span id="1-1349"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-1350">        <span class="n">exc_info</span> <span class="o">=</span> <span class="n">hint</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;exc_info&quot;</span><span class="p">)</span>
+</span><span id="1-1351">        <span class="k">if</span> <span class="n">exc_info</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-1352">            <span class="n">error_processors</span> <span class="o">=</span> <span class="n">chain</span><span class="p">(</span>
+</span><span id="1-1353">                <span class="n">Scope</span><span class="o">.</span><span class="n">get_global_scope</span><span class="p">()</span><span class="o">.</span><span class="n">_error_processors</span><span class="p">,</span>
+</span><span id="1-1354">                <span class="n">Scope</span><span class="o">.</span><span class="n">get_isolation_scope</span><span class="p">()</span><span class="o">.</span><span class="n">_error_processors</span><span class="p">,</span>
+</span><span id="1-1355">                <span class="n">Scope</span><span class="o">.</span><span class="n">get_current_scope</span><span class="p">()</span><span class="o">.</span><span class="n">_error_processors</span><span class="p">,</span>
+</span><span id="1-1356">            <span class="p">)</span>
+</span><span id="1-1357">
+</span><span id="1-1358">            <span class="k">for</span> <span class="n">error_processor</span> <span class="ow">in</span> <span class="n">error_processors</span><span class="p">:</span>
+</span><span id="1-1359">                <span class="n">new_event</span> <span class="o">=</span> <span class="n">error_processor</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">exc_info</span><span class="p">)</span>
+</span><span id="1-1360">                <span class="k">if</span> <span class="n">new_event</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-1361">                    <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_drop</span><span class="p">(</span><span class="n">error_processor</span><span class="p">,</span> <span class="s2">&quot;error processor&quot;</span><span class="p">)</span>
+</span><span id="1-1362">
+</span><span id="1-1363">                <span class="n">event</span> <span class="o">=</span> <span class="n">new_event</span>
+</span><span id="1-1364">
+</span><span id="1-1365">        <span class="k">return</span> <span class="n">event</span></div>
+
+</span><span id="1-1366">
+<div class="viewcode-block" id="Scope.run_event_processors">
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.run_event_processors">[docs]</a>
+</span><span id="1-1367">    <span class="k">def</span> <span class="nf">run_event_processors</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">):</span>
+</span><span id="1-1368">        <span class="c1"># type: (Event, Hint) -&gt; Optional[Event]</span>
+</span><span id="1-1369"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-1370"><span class="sd">        Runs the event processors on the event and returns the modified event.</span>
+</span><span id="1-1371"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-1372">        <span class="n">ty</span> <span class="o">=</span> <span class="n">event</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;type&quot;</span><span class="p">)</span>
+</span><span id="1-1373">        <span class="n">is_check_in</span> <span class="o">=</span> <span class="n">ty</span> <span class="o">==</span> <span class="s2">&quot;check_in&quot;</span>
+</span><span id="1-1374">
+</span><span id="1-1375">        <span class="k">if</span> <span class="ow">not</span> <span class="n">is_check_in</span><span class="p">:</span>
+</span><span id="1-1376">            <span class="c1"># Get scopes without creating them to prevent infinite recursion</span>
+</span><span id="1-1377">            <span class="n">isolation_scope</span> <span class="o">=</span> <span class="n">_isolation_scope</span><span class="o">.</span><span class="n">get</span><span class="p">()</span>
+</span><span id="1-1378">            <span class="n">current_scope</span> <span class="o">=</span> <span class="n">_current_scope</span><span class="o">.</span><span class="n">get</span><span class="p">()</span>
+</span><span id="1-1379">
+</span><span id="1-1380">            <span class="n">event_processors</span> <span class="o">=</span> <span class="n">chain</span><span class="p">(</span>
+</span><span id="1-1381">                <span class="n">global_event_processors</span><span class="p">,</span>
+</span><span id="1-1382">                <span class="n">_global_scope</span> <span class="ow">and</span> <span class="n">_global_scope</span><span class="o">.</span><span class="n">_event_processors</span> <span class="ow">or</span> <span class="p">[],</span>
+</span><span id="1-1383">                <span class="n">isolation_scope</span> <span class="ow">and</span> <span class="n">isolation_scope</span><span class="o">.</span><span class="n">_event_processors</span> <span class="ow">or</span> <span class="p">[],</span>
+</span><span id="1-1384">                <span class="n">current_scope</span> <span class="ow">and</span> <span class="n">current_scope</span><span class="o">.</span><span class="n">_event_processors</span> <span class="ow">or</span> <span class="p">[],</span>
+</span><span id="1-1385">            <span class="p">)</span>
+</span><span id="1-1386">
+</span><span id="1-1387">            <span class="k">for</span> <span class="n">event_processor</span> <span class="ow">in</span> <span class="n">event_processors</span><span class="p">:</span>
+</span><span id="1-1388">                <span class="n">new_event</span> <span class="o">=</span> <span class="n">event</span>
+</span><span id="1-1389">                <span class="k">with</span> <span class="n">capture_internal_exceptions</span><span class="p">():</span>
+</span><span id="1-1390">                    <span class="n">new_event</span> <span class="o">=</span> <span class="n">event_processor</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">)</span>
+</span><span id="1-1391">                <span class="k">if</span> <span class="n">new_event</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-1392">                    <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_drop</span><span class="p">(</span><span class="n">event_processor</span><span class="p">,</span> <span class="s2">&quot;event processor&quot;</span><span class="p">)</span>
+</span><span id="1-1393">                <span class="n">event</span> <span class="o">=</span> <span class="n">new_event</span>
+</span><span id="1-1394">
+</span><span id="1-1395">        <span class="k">return</span> <span class="n">event</span></div>
+
+</span><span id="1-1396">
 <div class="viewcode-block" id="Scope.apply_to_event">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Scope.apply_to_event">[docs]</a>
-</span><span id="1-1115">    <span class="nd">@_disable_capture</span>
-</span><span id="1-1116">    <span class="k">def</span> <span class="nf">apply_to_event</span><span class="p">(</span>
-</span><span id="1-1117">        <span class="bp">self</span><span class="p">,</span>
-</span><span id="1-1118">        <span class="n">event</span><span class="p">,</span>  <span class="c1"># type: Event</span>
-</span><span id="1-1119">        <span class="n">hint</span><span class="p">,</span>  <span class="c1"># type: Hint</span>
-</span><span id="1-1120">        <span class="n">options</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Dict[str, Any]]</span>
-</span><span id="1-1121">    <span class="p">):</span>
-</span><span id="1-1122">        <span class="c1"># type: (...) -&gt; Optional[Event]</span>
-</span><span id="1-1123"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Applies the information contained on the scope to the given event.&quot;&quot;&quot;</span>
-</span><span id="1-1124">        <span class="n">ty</span> <span class="o">=</span> <span class="n">event</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;type&quot;</span><span class="p">)</span>
-</span><span id="1-1125">        <span class="n">is_transaction</span> <span class="o">=</span> <span class="n">ty</span> <span class="o">==</span> <span class="s2">&quot;transaction&quot;</span>
-</span><span id="1-1126">        <span class="n">is_check_in</span> <span class="o">=</span> <span class="n">ty</span> <span class="o">==</span> <span class="s2">&quot;check_in&quot;</span>
-</span><span id="1-1127">
-</span><span id="1-1128">        <span class="c1"># put all attachments into the hint. This lets callbacks play around</span>
-</span><span id="1-1129">        <span class="c1"># with attachments. We also later pull this out of the hint when we</span>
-</span><span id="1-1130">        <span class="c1"># create the envelope.</span>
-</span><span id="1-1131">        <span class="n">attachments_to_send</span> <span class="o">=</span> <span class="n">hint</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;attachments&quot;</span><span class="p">)</span> <span class="ow">or</span> <span class="p">[]</span>
-</span><span id="1-1132">        <span class="k">for</span> <span class="n">attachment</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_attachments</span><span class="p">:</span>
-</span><span id="1-1133">            <span class="k">if</span> <span class="ow">not</span> <span class="n">is_transaction</span> <span class="ow">or</span> <span class="n">attachment</span><span class="o">.</span><span class="n">add_to_transactions</span><span class="p">:</span>
-</span><span id="1-1134">                <span class="n">attachments_to_send</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">attachment</span><span class="p">)</span>
-</span><span id="1-1135">        <span class="n">hint</span><span class="p">[</span><span class="s2">&quot;attachments&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">attachments_to_send</span>
-</span><span id="1-1136">
-</span><span id="1-1137">        <span class="bp">self</span><span class="o">.</span><span class="n">_apply_contexts_to_event</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">options</span><span class="p">)</span>
-</span><span id="1-1138">
-</span><span id="1-1139">        <span class="k">if</span> <span class="n">is_check_in</span><span class="p">:</span>
-</span><span id="1-1140">            <span class="c1"># Check-ins only support the trace context, strip all others</span>
-</span><span id="1-1141">            <span class="n">event</span><span class="p">[</span><span class="s2">&quot;contexts&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="p">{</span>
-</span><span id="1-1142">                <span class="s2">&quot;trace&quot;</span><span class="p">:</span> <span class="n">event</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="s2">&quot;contexts&quot;</span><span class="p">,</span> <span class="p">{})</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;trace&quot;</span><span class="p">,</span> <span class="p">{})</span>
-</span><span id="1-1143">            <span class="p">}</span>
-</span><span id="1-1144">
-</span><span id="1-1145">        <span class="k">if</span> <span class="ow">not</span> <span class="n">is_check_in</span><span class="p">:</span>
-</span><span id="1-1146">            <span class="bp">self</span><span class="o">.</span><span class="n">_apply_level_to_event</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">options</span><span class="p">)</span>
-</span><span id="1-1147">            <span class="bp">self</span><span class="o">.</span><span class="n">_apply_fingerprint_to_event</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">options</span><span class="p">)</span>
-</span><span id="1-1148">            <span class="bp">self</span><span class="o">.</span><span class="n">_apply_user_to_event</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">options</span><span class="p">)</span>
-</span><span id="1-1149">            <span class="bp">self</span><span class="o">.</span><span class="n">_apply_transaction_name_to_event</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">options</span><span class="p">)</span>
-</span><span id="1-1150">            <span class="bp">self</span><span class="o">.</span><span class="n">_apply_transaction_info_to_event</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">options</span><span class="p">)</span>
-</span><span id="1-1151">            <span class="bp">self</span><span class="o">.</span><span class="n">_apply_tags_to_event</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">options</span><span class="p">)</span>
-</span><span id="1-1152">            <span class="bp">self</span><span class="o">.</span><span class="n">_apply_extra_to_event</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">options</span><span class="p">)</span>
-</span><span id="1-1153">
-</span><span id="1-1154">        <span class="k">if</span> <span class="ow">not</span> <span class="n">is_transaction</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">is_check_in</span><span class="p">:</span>
-</span><span id="1-1155">            <span class="bp">self</span><span class="o">.</span><span class="n">_apply_breadcrumbs_to_event</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">options</span><span class="p">)</span>
-</span><span id="1-1156">
-</span><span id="1-1157">        <span class="k">def</span> <span class="nf">_drop</span><span class="p">(</span><span class="n">cause</span><span class="p">,</span> <span class="n">ty</span><span class="p">):</span>
-</span><span id="1-1158">            <span class="c1"># type: (Any, str) -&gt; Optional[Any]</span>
-</span><span id="1-1159">            <span class="n">logger</span><span class="o">.</span><span class="n">info</span><span class="p">(</span><span class="s2">&quot;</span><span class="si">%s</span><span class="s2"> (</span><span class="si">%s</span><span class="s2">) dropped event&quot;</span><span class="p">,</span> <span class="n">ty</span><span class="p">,</span> <span class="n">cause</span><span class="p">)</span>
-</span><span id="1-1160">            <span class="k">return</span> <span class="kc">None</span>
-</span><span id="1-1161">
-</span><span id="1-1162">        <span class="c1"># run error processors</span>
-</span><span id="1-1163">        <span class="n">exc_info</span> <span class="o">=</span> <span class="n">hint</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;exc_info&quot;</span><span class="p">)</span>
-</span><span id="1-1164">        <span class="k">if</span> <span class="n">exc_info</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-1165">            <span class="k">for</span> <span class="n">error_processor</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_error_processors</span><span class="p">:</span>
-</span><span id="1-1166">                <span class="n">new_event</span> <span class="o">=</span> <span class="n">error_processor</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">exc_info</span><span class="p">)</span>
-</span><span id="1-1167">                <span class="k">if</span> <span class="n">new_event</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-1168">                    <span class="k">return</span> <span class="n">_drop</span><span class="p">(</span><span class="n">error_processor</span><span class="p">,</span> <span class="s2">&quot;error processor&quot;</span><span class="p">)</span>
-</span><span id="1-1169">
-</span><span id="1-1170">                <span class="n">event</span> <span class="o">=</span> <span class="n">new_event</span>
-</span><span id="1-1171">
-</span><span id="1-1172">        <span class="c1"># run event processors</span>
-</span><span id="1-1173">        <span class="k">if</span> <span class="ow">not</span> <span class="n">is_check_in</span><span class="p">:</span>
-</span><span id="1-1174">            <span class="k">for</span> <span class="n">event_processor</span> <span class="ow">in</span> <span class="n">chain</span><span class="p">(</span>
-</span><span id="1-1175">                <span class="n">global_event_processors</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">_event_processors</span>
-</span><span id="1-1176">            <span class="p">):</span>
-</span><span id="1-1177">                <span class="n">new_event</span> <span class="o">=</span> <span class="n">event</span>
-</span><span id="1-1178">                <span class="k">with</span> <span class="n">capture_internal_exceptions</span><span class="p">():</span>
-</span><span id="1-1179">                    <span class="n">new_event</span> <span class="o">=</span> <span class="n">event_processor</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">)</span>
-</span><span id="1-1180">                <span class="k">if</span> <span class="n">new_event</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-1181">                    <span class="k">return</span> <span class="n">_drop</span><span class="p">(</span><span class="n">event_processor</span><span class="p">,</span> <span class="s2">&quot;event processor&quot;</span><span class="p">)</span>
-</span><span id="1-1182">                <span class="n">event</span> <span class="o">=</span> <span class="n">new_event</span>
-</span><span id="1-1183">
-</span><span id="1-1184">        <span class="k">return</span> <span class="n">event</span></div>
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.apply_to_event">[docs]</a>
+</span><span id="1-1397">    <span class="nd">@_disable_capture</span>
+</span><span id="1-1398">    <span class="k">def</span> <span class="nf">apply_to_event</span><span class="p">(</span>
+</span><span id="1-1399">        <span class="bp">self</span><span class="p">,</span>
+</span><span id="1-1400">        <span class="n">event</span><span class="p">,</span>  <span class="c1"># type: Event</span>
+</span><span id="1-1401">        <span class="n">hint</span><span class="p">,</span>  <span class="c1"># type: Hint</span>
+</span><span id="1-1402">        <span class="n">options</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Dict[str, Any]]</span>
+</span><span id="1-1403">    <span class="p">):</span>
+</span><span id="1-1404">        <span class="c1"># type: (...) -&gt; Optional[Event]</span>
+</span><span id="1-1405"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Applies the information contained on the scope to the given event.&quot;&quot;&quot;</span>
+</span><span id="1-1406">        <span class="n">ty</span> <span class="o">=</span> <span class="n">event</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;type&quot;</span><span class="p">)</span>
+</span><span id="1-1407">        <span class="n">is_transaction</span> <span class="o">=</span> <span class="n">ty</span> <span class="o">==</span> <span class="s2">&quot;transaction&quot;</span>
+</span><span id="1-1408">        <span class="n">is_check_in</span> <span class="o">=</span> <span class="n">ty</span> <span class="o">==</span> <span class="s2">&quot;check_in&quot;</span>
+</span><span id="1-1409">
+</span><span id="1-1410">        <span class="c1"># put all attachments into the hint. This lets callbacks play around</span>
+</span><span id="1-1411">        <span class="c1"># with attachments. We also later pull this out of the hint when we</span>
+</span><span id="1-1412">        <span class="c1"># create the envelope.</span>
+</span><span id="1-1413">        <span class="n">attachments_to_send</span> <span class="o">=</span> <span class="n">hint</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;attachments&quot;</span><span class="p">)</span> <span class="ow">or</span> <span class="p">[]</span>
+</span><span id="1-1414">        <span class="k">for</span> <span class="n">attachment</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_attachments</span><span class="p">:</span>
+</span><span id="1-1415">            <span class="k">if</span> <span class="ow">not</span> <span class="n">is_transaction</span> <span class="ow">or</span> <span class="n">attachment</span><span class="o">.</span><span class="n">add_to_transactions</span><span class="p">:</span>
+</span><span id="1-1416">                <span class="n">attachments_to_send</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">attachment</span><span class="p">)</span>
+</span><span id="1-1417">        <span class="n">hint</span><span class="p">[</span><span class="s2">&quot;attachments&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">attachments_to_send</span>
+</span><span id="1-1418">
+</span><span id="1-1419">        <span class="bp">self</span><span class="o">.</span><span class="n">_apply_contexts_to_event</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">options</span><span class="p">)</span>
+</span><span id="1-1420">
+</span><span id="1-1421">        <span class="k">if</span> <span class="n">is_check_in</span><span class="p">:</span>
+</span><span id="1-1422">            <span class="c1"># Check-ins only support the trace context, strip all others</span>
+</span><span id="1-1423">            <span class="n">event</span><span class="p">[</span><span class="s2">&quot;contexts&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="p">{</span>
+</span><span id="1-1424">                <span class="s2">&quot;trace&quot;</span><span class="p">:</span> <span class="n">event</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="s2">&quot;contexts&quot;</span><span class="p">,</span> <span class="p">{})</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;trace&quot;</span><span class="p">,</span> <span class="p">{})</span>
+</span><span id="1-1425">            <span class="p">}</span>
+</span><span id="1-1426">
+</span><span id="1-1427">        <span class="k">if</span> <span class="ow">not</span> <span class="n">is_check_in</span><span class="p">:</span>
+</span><span id="1-1428">            <span class="bp">self</span><span class="o">.</span><span class="n">_apply_level_to_event</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">options</span><span class="p">)</span>
+</span><span id="1-1429">            <span class="bp">self</span><span class="o">.</span><span class="n">_apply_fingerprint_to_event</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">options</span><span class="p">)</span>
+</span><span id="1-1430">            <span class="bp">self</span><span class="o">.</span><span class="n">_apply_user_to_event</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">options</span><span class="p">)</span>
+</span><span id="1-1431">            <span class="bp">self</span><span class="o">.</span><span class="n">_apply_transaction_name_to_event</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">options</span><span class="p">)</span>
+</span><span id="1-1432">            <span class="bp">self</span><span class="o">.</span><span class="n">_apply_transaction_info_to_event</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">options</span><span class="p">)</span>
+</span><span id="1-1433">            <span class="bp">self</span><span class="o">.</span><span class="n">_apply_tags_to_event</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">options</span><span class="p">)</span>
+</span><span id="1-1434">            <span class="bp">self</span><span class="o">.</span><span class="n">_apply_extra_to_event</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">options</span><span class="p">)</span>
+</span><span id="1-1435">
+</span><span id="1-1436">        <span class="k">if</span> <span class="ow">not</span> <span class="n">is_transaction</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">is_check_in</span><span class="p">:</span>
+</span><span id="1-1437">            <span class="bp">self</span><span class="o">.</span><span class="n">_apply_breadcrumbs_to_event</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">,</span> <span class="n">options</span><span class="p">)</span>
+</span><span id="1-1438">
+</span><span id="1-1439">        <span class="n">event</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">run_error_processors</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">)</span>
+</span><span id="1-1440">        <span class="k">if</span> <span class="n">event</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-1441">            <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-1442">
+</span><span id="1-1443">        <span class="n">event</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">run_event_processors</span><span class="p">(</span><span class="n">event</span><span class="p">,</span> <span class="n">hint</span><span class="p">)</span>
+</span><span id="1-1444">        <span class="k">if</span> <span class="n">event</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-1445">            <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-1446">
+</span><span id="1-1447">        <span class="k">return</span> <span class="n">event</span></div>
 
-</span><span id="1-1185">
+</span><span id="1-1448">
 <div class="viewcode-block" id="Scope.update_from_scope">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Scope.update_from_scope">[docs]</a>
-</span><span id="1-1186">    <span class="k">def</span> <span class="nf">update_from_scope</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">scope</span><span class="p">):</span>
-</span><span id="1-1187">        <span class="c1"># type: (Scope) -&gt; None</span>
-</span><span id="1-1188"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Update the scope with another scope&#39;s data.&quot;&quot;&quot;</span>
-</span><span id="1-1189">        <span class="k">if</span> <span class="n">scope</span><span class="o">.</span><span class="n">_level</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-1190">            <span class="bp">self</span><span class="o">.</span><span class="n">_level</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">_level</span>
-</span><span id="1-1191">        <span class="k">if</span> <span class="n">scope</span><span class="o">.</span><span class="n">_fingerprint</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-1192">            <span class="bp">self</span><span class="o">.</span><span class="n">_fingerprint</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">_fingerprint</span>
-</span><span id="1-1193">        <span class="k">if</span> <span class="n">scope</span><span class="o">.</span><span class="n">_transaction</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-1194">            <span class="bp">self</span><span class="o">.</span><span class="n">_transaction</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">_transaction</span>
-</span><span id="1-1195">        <span class="k">if</span> <span class="n">scope</span><span class="o">.</span><span class="n">_transaction_info</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-1196">            <span class="bp">self</span><span class="o">.</span><span class="n">_transaction_info</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">_transaction_info</span><span class="p">)</span>
-</span><span id="1-1197">        <span class="k">if</span> <span class="n">scope</span><span class="o">.</span><span class="n">_user</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-1198">            <span class="bp">self</span><span class="o">.</span><span class="n">_user</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">_user</span>
-</span><span id="1-1199">        <span class="k">if</span> <span class="n">scope</span><span class="o">.</span><span class="n">_tags</span><span class="p">:</span>
-</span><span id="1-1200">            <span class="bp">self</span><span class="o">.</span><span class="n">_tags</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">_tags</span><span class="p">)</span>
-</span><span id="1-1201">        <span class="k">if</span> <span class="n">scope</span><span class="o">.</span><span class="n">_contexts</span><span class="p">:</span>
-</span><span id="1-1202">            <span class="bp">self</span><span class="o">.</span><span class="n">_contexts</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">_contexts</span><span class="p">)</span>
-</span><span id="1-1203">        <span class="k">if</span> <span class="n">scope</span><span class="o">.</span><span class="n">_extras</span><span class="p">:</span>
-</span><span id="1-1204">            <span class="bp">self</span><span class="o">.</span><span class="n">_extras</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">_extras</span><span class="p">)</span>
-</span><span id="1-1205">        <span class="k">if</span> <span class="n">scope</span><span class="o">.</span><span class="n">_breadcrumbs</span><span class="p">:</span>
-</span><span id="1-1206">            <span class="bp">self</span><span class="o">.</span><span class="n">_breadcrumbs</span><span class="o">.</span><span class="n">extend</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">_breadcrumbs</span><span class="p">)</span>
-</span><span id="1-1207">        <span class="k">if</span> <span class="n">scope</span><span class="o">.</span><span class="n">_span</span><span class="p">:</span>
-</span><span id="1-1208">            <span class="bp">self</span><span class="o">.</span><span class="n">_span</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">_span</span>
-</span><span id="1-1209">        <span class="k">if</span> <span class="n">scope</span><span class="o">.</span><span class="n">_attachments</span><span class="p">:</span>
-</span><span id="1-1210">            <span class="bp">self</span><span class="o">.</span><span class="n">_attachments</span><span class="o">.</span><span class="n">extend</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">_attachments</span><span class="p">)</span>
-</span><span id="1-1211">        <span class="k">if</span> <span class="n">scope</span><span class="o">.</span><span class="n">_profile</span><span class="p">:</span>
-</span><span id="1-1212">            <span class="bp">self</span><span class="o">.</span><span class="n">_profile</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">_profile</span>
-</span><span id="1-1213">        <span class="k">if</span> <span class="n">scope</span><span class="o">.</span><span class="n">_propagation_context</span><span class="p">:</span>
-</span><span id="1-1214">            <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">_propagation_context</span></div>
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.update_from_scope">[docs]</a>
+</span><span id="1-1449">    <span class="k">def</span> <span class="nf">update_from_scope</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">scope</span><span class="p">):</span>
+</span><span id="1-1450">        <span class="c1"># type: (Scope) -&gt; None</span>
+</span><span id="1-1451"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Update the scope with another scope&#39;s data.&quot;&quot;&quot;</span>
+</span><span id="1-1452">        <span class="k">if</span> <span class="n">scope</span><span class="o">.</span><span class="n">_level</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-1453">            <span class="bp">self</span><span class="o">.</span><span class="n">_level</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">_level</span>
+</span><span id="1-1454">        <span class="k">if</span> <span class="n">scope</span><span class="o">.</span><span class="n">_fingerprint</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-1455">            <span class="bp">self</span><span class="o">.</span><span class="n">_fingerprint</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">_fingerprint</span>
+</span><span id="1-1456">        <span class="k">if</span> <span class="n">scope</span><span class="o">.</span><span class="n">_transaction</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-1457">            <span class="bp">self</span><span class="o">.</span><span class="n">_transaction</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">_transaction</span>
+</span><span id="1-1458">        <span class="k">if</span> <span class="n">scope</span><span class="o">.</span><span class="n">_transaction_info</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-1459">            <span class="bp">self</span><span class="o">.</span><span class="n">_transaction_info</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">_transaction_info</span><span class="p">)</span>
+</span><span id="1-1460">        <span class="k">if</span> <span class="n">scope</span><span class="o">.</span><span class="n">_user</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-1461">            <span class="bp">self</span><span class="o">.</span><span class="n">_user</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">_user</span>
+</span><span id="1-1462">        <span class="k">if</span> <span class="n">scope</span><span class="o">.</span><span class="n">_tags</span><span class="p">:</span>
+</span><span id="1-1463">            <span class="bp">self</span><span class="o">.</span><span class="n">_tags</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">_tags</span><span class="p">)</span>
+</span><span id="1-1464">        <span class="k">if</span> <span class="n">scope</span><span class="o">.</span><span class="n">_contexts</span><span class="p">:</span>
+</span><span id="1-1465">            <span class="bp">self</span><span class="o">.</span><span class="n">_contexts</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">_contexts</span><span class="p">)</span>
+</span><span id="1-1466">        <span class="k">if</span> <span class="n">scope</span><span class="o">.</span><span class="n">_extras</span><span class="p">:</span>
+</span><span id="1-1467">            <span class="bp">self</span><span class="o">.</span><span class="n">_extras</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">_extras</span><span class="p">)</span>
+</span><span id="1-1468">        <span class="k">if</span> <span class="n">scope</span><span class="o">.</span><span class="n">_breadcrumbs</span><span class="p">:</span>
+</span><span id="1-1469">            <span class="bp">self</span><span class="o">.</span><span class="n">_breadcrumbs</span><span class="o">.</span><span class="n">extend</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">_breadcrumbs</span><span class="p">)</span>
+</span><span id="1-1470">        <span class="k">if</span> <span class="n">scope</span><span class="o">.</span><span class="n">_span</span><span class="p">:</span>
+</span><span id="1-1471">            <span class="bp">self</span><span class="o">.</span><span class="n">_span</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">_span</span>
+</span><span id="1-1472">        <span class="k">if</span> <span class="n">scope</span><span class="o">.</span><span class="n">_attachments</span><span class="p">:</span>
+</span><span id="1-1473">            <span class="bp">self</span><span class="o">.</span><span class="n">_attachments</span><span class="o">.</span><span class="n">extend</span><span class="p">(</span><span class="n">scope</span><span class="o">.</span><span class="n">_attachments</span><span class="p">)</span>
+</span><span id="1-1474">        <span class="k">if</span> <span class="n">scope</span><span class="o">.</span><span class="n">_profile</span><span class="p">:</span>
+</span><span id="1-1475">            <span class="bp">self</span><span class="o">.</span><span class="n">_profile</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">_profile</span>
+</span><span id="1-1476">        <span class="k">if</span> <span class="n">scope</span><span class="o">.</span><span class="n">_propagation_context</span><span class="p">:</span>
+</span><span id="1-1477">            <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">_propagation_context</span>
+</span><span id="1-1478">        <span class="k">if</span> <span class="n">scope</span><span class="o">.</span><span class="n">_session</span><span class="p">:</span>
+</span><span id="1-1479">            <span class="bp">self</span><span class="o">.</span><span class="n">_session</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">_session</span></div>
 
-</span><span id="1-1215">
+</span><span id="1-1480">
 <div class="viewcode-block" id="Scope.update_from_kwargs">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Scope.update_from_kwargs">[docs]</a>
-</span><span id="1-1216">    <span class="k">def</span> <span class="nf">update_from_kwargs</span><span class="p">(</span>
-</span><span id="1-1217">        <span class="bp">self</span><span class="p">,</span>
-</span><span id="1-1218">        <span class="n">user</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Any]</span>
-</span><span id="1-1219">        <span class="n">level</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[LogLevelStr]</span>
-</span><span id="1-1220">        <span class="n">extras</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Dict[str, Any]]</span>
-</span><span id="1-1221">        <span class="n">contexts</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Dict[str, Any]]</span>
-</span><span id="1-1222">        <span class="n">tags</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Dict[str, str]]</span>
-</span><span id="1-1223">        <span class="n">fingerprint</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[List[str]]</span>
-</span><span id="1-1224">    <span class="p">):</span>
-</span><span id="1-1225">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-1226"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Update the scope&#39;s attributes.&quot;&quot;&quot;</span>
-</span><span id="1-1227">        <span class="k">if</span> <span class="n">level</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-1228">            <span class="bp">self</span><span class="o">.</span><span class="n">_level</span> <span class="o">=</span> <span class="n">level</span>
-</span><span id="1-1229">        <span class="k">if</span> <span class="n">user</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-1230">            <span class="bp">self</span><span class="o">.</span><span class="n">_user</span> <span class="o">=</span> <span class="n">user</span>
-</span><span id="1-1231">        <span class="k">if</span> <span class="n">extras</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-1232">            <span class="bp">self</span><span class="o">.</span><span class="n">_extras</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">extras</span><span class="p">)</span>
-</span><span id="1-1233">        <span class="k">if</span> <span class="n">contexts</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-1234">            <span class="bp">self</span><span class="o">.</span><span class="n">_contexts</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">contexts</span><span class="p">)</span>
-</span><span id="1-1235">        <span class="k">if</span> <span class="n">tags</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-1236">            <span class="bp">self</span><span class="o">.</span><span class="n">_tags</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">tags</span><span class="p">)</span>
-</span><span id="1-1237">        <span class="k">if</span> <span class="n">fingerprint</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-1238">            <span class="bp">self</span><span class="o">.</span><span class="n">_fingerprint</span> <span class="o">=</span> <span class="n">fingerprint</span></div>
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.api.Scope.update_from_kwargs">[docs]</a>
+</span><span id="1-1481">    <span class="k">def</span> <span class="nf">update_from_kwargs</span><span class="p">(</span>
+</span><span id="1-1482">        <span class="bp">self</span><span class="p">,</span>
+</span><span id="1-1483">        <span class="n">user</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Any]</span>
+</span><span id="1-1484">        <span class="n">level</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[LogLevelStr]</span>
+</span><span id="1-1485">        <span class="n">extras</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Dict[str, Any]]</span>
+</span><span id="1-1486">        <span class="n">contexts</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Dict[str, Any]]</span>
+</span><span id="1-1487">        <span class="n">tags</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Dict[str, str]]</span>
+</span><span id="1-1488">        <span class="n">fingerprint</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[List[str]]</span>
+</span><span id="1-1489">    <span class="p">):</span>
+</span><span id="1-1490">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-1491"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Update the scope&#39;s attributes.&quot;&quot;&quot;</span>
+</span><span id="1-1492">        <span class="k">if</span> <span class="n">level</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-1493">            <span class="bp">self</span><span class="o">.</span><span class="n">_level</span> <span class="o">=</span> <span class="n">level</span>
+</span><span id="1-1494">        <span class="k">if</span> <span class="n">user</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-1495">            <span class="bp">self</span><span class="o">.</span><span class="n">_user</span> <span class="o">=</span> <span class="n">user</span>
+</span><span id="1-1496">        <span class="k">if</span> <span class="n">extras</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-1497">            <span class="bp">self</span><span class="o">.</span><span class="n">_extras</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">extras</span><span class="p">)</span>
+</span><span id="1-1498">        <span class="k">if</span> <span class="n">contexts</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-1499">            <span class="bp">self</span><span class="o">.</span><span class="n">_contexts</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">contexts</span><span class="p">)</span>
+</span><span id="1-1500">        <span class="k">if</span> <span class="n">tags</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-1501">            <span class="bp">self</span><span class="o">.</span><span class="n">_tags</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">tags</span><span class="p">)</span>
+</span><span id="1-1502">        <span class="k">if</span> <span class="n">fingerprint</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-1503">            <span class="bp">self</span><span class="o">.</span><span class="n">_fingerprint</span> <span class="o">=</span> <span class="n">fingerprint</span></div>
 
-</span><span id="1-1239">
-</span><span id="1-1240">    <span class="k">def</span> <span class="nf">__copy__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-1241">        <span class="c1"># type: () -&gt; Scope</span>
-</span><span id="1-1242">        <span class="n">rv</span> <span class="o">=</span> <span class="nb">object</span><span class="o">.</span><span class="fm">__new__</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="vm">__class__</span><span class="p">)</span>  <span class="c1"># type: Scope</span>
-</span><span id="1-1243">
-</span><span id="1-1244">        <span class="n">rv</span><span class="o">.</span><span class="n">_level</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_level</span>
-</span><span id="1-1245">        <span class="n">rv</span><span class="o">.</span><span class="n">_name</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_name</span>
-</span><span id="1-1246">        <span class="n">rv</span><span class="o">.</span><span class="n">_fingerprint</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_fingerprint</span>
-</span><span id="1-1247">        <span class="n">rv</span><span class="o">.</span><span class="n">_transaction</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_transaction</span>
-</span><span id="1-1248">        <span class="n">rv</span><span class="o">.</span><span class="n">_transaction_info</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_transaction_info</span><span class="p">)</span>
-</span><span id="1-1249">        <span class="n">rv</span><span class="o">.</span><span class="n">_user</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_user</span>
-</span><span id="1-1250">
-</span><span id="1-1251">        <span class="n">rv</span><span class="o">.</span><span class="n">_tags</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_tags</span><span class="p">)</span>
-</span><span id="1-1252">        <span class="n">rv</span><span class="o">.</span><span class="n">_contexts</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_contexts</span><span class="p">)</span>
-</span><span id="1-1253">        <span class="n">rv</span><span class="o">.</span><span class="n">_extras</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_extras</span><span class="p">)</span>
-</span><span id="1-1254">
-</span><span id="1-1255">        <span class="n">rv</span><span class="o">.</span><span class="n">_breadcrumbs</span> <span class="o">=</span> <span class="n">copy</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_breadcrumbs</span><span class="p">)</span>
-</span><span id="1-1256">        <span class="n">rv</span><span class="o">.</span><span class="n">_event_processors</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_event_processors</span><span class="p">)</span>
-</span><span id="1-1257">        <span class="n">rv</span><span class="o">.</span><span class="n">_error_processors</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_error_processors</span><span class="p">)</span>
-</span><span id="1-1258">        <span class="n">rv</span><span class="o">.</span><span class="n">_propagation_context</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_propagation_context</span>
-</span><span id="1-1259">
-</span><span id="1-1260">        <span class="n">rv</span><span class="o">.</span><span class="n">_should_capture</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_should_capture</span>
-</span><span id="1-1261">        <span class="n">rv</span><span class="o">.</span><span class="n">_span</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_span</span>
-</span><span id="1-1262">        <span class="n">rv</span><span class="o">.</span><span class="n">_session</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_session</span>
-</span><span id="1-1263">        <span class="n">rv</span><span class="o">.</span><span class="n">_force_auto_session_tracking</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_force_auto_session_tracking</span>
-</span><span id="1-1264">        <span class="n">rv</span><span class="o">.</span><span class="n">_attachments</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_attachments</span><span class="p">)</span>
-</span><span id="1-1265">
-</span><span id="1-1266">        <span class="n">rv</span><span class="o">.</span><span class="n">_profile</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_profile</span>
-</span><span id="1-1267">
-</span><span id="1-1268">        <span class="k">return</span> <span class="n">rv</span>
-</span><span id="1-1269">
-</span><span id="1-1270">    <span class="k">def</span> <span class="fm">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-1271">        <span class="c1"># type: () -&gt; str</span>
-</span><span id="1-1272">        <span class="k">return</span> <span class="s2">&quot;&lt;</span><span class="si">%s</span><span class="s2"> id=</span><span class="si">%s</span><span class="s2"> name=</span><span class="si">%s</span><span class="s2">&gt;&quot;</span> <span class="o">%</span> <span class="p">(</span>
-</span><span id="1-1273">            <span class="bp">self</span><span class="o">.</span><span class="vm">__class__</span><span class="o">.</span><span class="vm">__name__</span><span class="p">,</span>
-</span><span id="1-1274">            <span class="nb">hex</span><span class="p">(</span><span class="nb">id</span><span class="p">(</span><span class="bp">self</span><span class="p">)),</span>
-</span><span id="1-1275">            <span class="bp">self</span><span class="o">.</span><span class="n">_name</span><span class="p">,</span>
-</span><span id="1-1276">        <span class="p">)</span></div>
+</span><span id="1-1504">
+</span><span id="1-1505">    <span class="k">def</span> <span class="fm">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-1506">        <span class="c1"># type: () -&gt; str</span>
+</span><span id="1-1507">        <span class="k">return</span> <span class="s2">&quot;&lt;</span><span class="si">%s</span><span class="s2"> id=</span><span class="si">%s</span><span class="s2"> name=</span><span class="si">%s</span><span class="s2"> type=</span><span class="si">%s</span><span class="s2">&gt;&quot;</span> <span class="o">%</span> <span class="p">(</span>
+</span><span id="1-1508">            <span class="bp">self</span><span class="o">.</span><span class="vm">__class__</span><span class="o">.</span><span class="vm">__name__</span><span class="p">,</span>
+</span><span id="1-1509">            <span class="nb">hex</span><span class="p">(</span><span class="nb">id</span><span class="p">(</span><span class="bp">self</span><span class="p">)),</span>
+</span><span id="1-1510">            <span class="bp">self</span><span class="o">.</span><span class="n">_name</span><span class="p">,</span>
+</span><span id="1-1511">            <span class="bp">self</span><span class="o">.</span><span class="n">_type</span><span class="p">,</span>
+</span><span id="1-1512">        <span class="p">)</span></div>
+
+</span><span id="1-1513">
+</span><span id="1-1514">
+<div class="viewcode-block" id="new_scope">
+<a class="viewcode-back" href="../../api.html#sentry_sdk.api.new_scope">[docs]</a>
+</span><span id="1-1515"><span class="nd">@contextmanager</span>
+</span><span id="1-1516"><span class="k">def</span> <span class="nf">new_scope</span><span class="p">():</span>
+</span><span id="1-1517">    <span class="c1"># type: () -&gt; Generator[Scope, None, None]</span>
+</span><span id="1-1518"><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-1519"><span class="sd">    .. versionadded:: 2.0.0</span>
+</span><span id="1-1520">
+</span><span id="1-1521"><span class="sd">    Context manager that forks the current scope and runs the wrapped code in it.</span>
+</span><span id="1-1522"><span class="sd">    After the wrapped code is executed, the original scope is restored.</span>
+</span><span id="1-1523">
+</span><span id="1-1524"><span class="sd">    Example Usage:</span>
+</span><span id="1-1525">
+</span><span id="1-1526"><span class="sd">    .. code-block:: python</span>
+</span><span id="1-1527">
+</span><span id="1-1528"><span class="sd">        import sentry_sdk</span>
+</span><span id="1-1529">
+</span><span id="1-1530"><span class="sd">        with sentry_sdk.new_scope() as scope:</span>
+</span><span id="1-1531"><span class="sd">            scope.set_tag(&quot;color&quot;, &quot;green&quot;)</span>
+</span><span id="1-1532"><span class="sd">            sentry_sdk.capture_message(&quot;hello&quot;) # will include `color` tag.</span>
+</span><span id="1-1533">
+</span><span id="1-1534"><span class="sd">        sentry_sdk.capture_message(&quot;hello, again&quot;) # will NOT include `color` tag.</span>
+</span><span id="1-1535">
+</span><span id="1-1536"><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="1-1537">    <span class="c1"># fork current scope</span>
+</span><span id="1-1538">    <span class="n">current_scope</span> <span class="o">=</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_current_scope</span><span class="p">()</span>
+</span><span id="1-1539">    <span class="n">new_scope</span> <span class="o">=</span> <span class="n">current_scope</span><span class="o">.</span><span class="n">fork</span><span class="p">()</span>
+</span><span id="1-1540">    <span class="n">token</span> <span class="o">=</span> <span class="n">_current_scope</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="n">new_scope</span><span class="p">)</span>
+</span><span id="1-1541">
+</span><span id="1-1542">    <span class="k">try</span><span class="p">:</span>
+</span><span id="1-1543">        <span class="k">yield</span> <span class="n">new_scope</span>
+</span><span id="1-1544">
+</span><span id="1-1545">    <span class="k">finally</span><span class="p">:</span>
+</span><span id="1-1546">        <span class="c1"># restore original scope</span>
+</span><span id="1-1547">        <span class="n">_current_scope</span><span class="o">.</span><span class="n">reset</span><span class="p">(</span><span class="n">token</span><span class="p">)</span></div>
 
+</span><span id="1-1548">
+</span><span id="1-1549">
+</span><span id="1-1550"><span class="nd">@contextmanager</span>
+</span><span id="1-1551"><span class="k">def</span> <span class="nf">use_scope</span><span class="p">(</span><span class="n">scope</span><span class="p">):</span>
+</span><span id="1-1552">    <span class="c1"># type: (Scope) -&gt; Generator[Scope, None, None]</span>
+</span><span id="1-1553"><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-1554"><span class="sd">    .. versionadded:: 2.0.0</span>
+</span><span id="1-1555">
+</span><span id="1-1556"><span class="sd">    Context manager that uses the given `scope` and runs the wrapped code in it.</span>
+</span><span id="1-1557"><span class="sd">    After the wrapped code is executed, the original scope is restored.</span>
+</span><span id="1-1558">
+</span><span id="1-1559"><span class="sd">    Example Usage:</span>
+</span><span id="1-1560"><span class="sd">    Suppose the variable `scope` contains a `Scope` object, which is not currently</span>
+</span><span id="1-1561"><span class="sd">    the active scope.</span>
+</span><span id="1-1562">
+</span><span id="1-1563"><span class="sd">    .. code-block:: python</span>
+</span><span id="1-1564">
+</span><span id="1-1565"><span class="sd">        import sentry_sdk</span>
+</span><span id="1-1566">
+</span><span id="1-1567"><span class="sd">        with sentry_sdk.use_scope(scope):</span>
+</span><span id="1-1568"><span class="sd">            scope.set_tag(&quot;color&quot;, &quot;green&quot;)</span>
+</span><span id="1-1569"><span class="sd">            sentry_sdk.capture_message(&quot;hello&quot;) # will include `color` tag.</span>
+</span><span id="1-1570">
+</span><span id="1-1571"><span class="sd">        sentry_sdk.capture_message(&quot;hello, again&quot;) # will NOT include `color` tag.</span>
+</span><span id="1-1572">
+</span><span id="1-1573"><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="1-1574">    <span class="c1"># set given scope as current scope</span>
+</span><span id="1-1575">    <span class="n">token</span> <span class="o">=</span> <span class="n">_current_scope</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="n">scope</span><span class="p">)</span>
+</span><span id="1-1576">
+</span><span id="1-1577">    <span class="k">try</span><span class="p">:</span>
+</span><span id="1-1578">        <span class="k">yield</span> <span class="n">scope</span>
+</span><span id="1-1579">
+</span><span id="1-1580">    <span class="k">finally</span><span class="p">:</span>
+</span><span id="1-1581">        <span class="c1"># restore original scope</span>
+</span><span id="1-1582">        <span class="n">_current_scope</span><span class="o">.</span><span class="n">reset</span><span class="p">(</span><span class="n">token</span><span class="p">)</span>
+</span><span id="1-1583">
+</span><span id="1-1584">
+</span><span id="1-1585"><span class="nd">@contextmanager</span>
+</span><span id="1-1586"><span class="k">def</span> <span class="nf">isolation_scope</span><span class="p">():</span>
+</span><span id="1-1587">    <span class="c1"># type: () -&gt; Generator[Scope, None, None]</span>
+</span><span id="1-1588"><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-1589"><span class="sd">    .. versionadded:: 2.0.0</span>
+</span><span id="1-1590">
+</span><span id="1-1591"><span class="sd">    Context manager that forks the current isolation scope and runs the wrapped code in it.</span>
+</span><span id="1-1592"><span class="sd">    The current scope is also forked to not bleed data into the existing current scope.</span>
+</span><span id="1-1593"><span class="sd">    After the wrapped code is executed, the original scopes are restored.</span>
+</span><span id="1-1594">
+</span><span id="1-1595"><span class="sd">    Example Usage:</span>
+</span><span id="1-1596">
+</span><span id="1-1597"><span class="sd">    .. code-block:: python</span>
+</span><span id="1-1598">
+</span><span id="1-1599"><span class="sd">        import sentry_sdk</span>
+</span><span id="1-1600">
+</span><span id="1-1601"><span class="sd">        with sentry_sdk.isolation_scope() as scope:</span>
+</span><span id="1-1602"><span class="sd">            scope.set_tag(&quot;color&quot;, &quot;green&quot;)</span>
+</span><span id="1-1603"><span class="sd">            sentry_sdk.capture_message(&quot;hello&quot;) # will include `color` tag.</span>
+</span><span id="1-1604">
+</span><span id="1-1605"><span class="sd">        sentry_sdk.capture_message(&quot;hello, again&quot;) # will NOT include `color` tag.</span>
+</span><span id="1-1606">
+</span><span id="1-1607"><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="1-1608">    <span class="c1"># fork current scope</span>
+</span><span id="1-1609">    <span class="n">current_scope</span> <span class="o">=</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_current_scope</span><span class="p">()</span>
+</span><span id="1-1610">    <span class="n">forked_current_scope</span> <span class="o">=</span> <span class="n">current_scope</span><span class="o">.</span><span class="n">fork</span><span class="p">()</span>
+</span><span id="1-1611">    <span class="n">current_token</span> <span class="o">=</span> <span class="n">_current_scope</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="n">forked_current_scope</span><span class="p">)</span>
+</span><span id="1-1612">
+</span><span id="1-1613">    <span class="c1"># fork isolation scope</span>
+</span><span id="1-1614">    <span class="n">isolation_scope</span> <span class="o">=</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_isolation_scope</span><span class="p">()</span>
+</span><span id="1-1615">    <span class="n">new_isolation_scope</span> <span class="o">=</span> <span class="n">isolation_scope</span><span class="o">.</span><span class="n">fork</span><span class="p">()</span>
+</span><span id="1-1616">    <span class="n">isolation_token</span> <span class="o">=</span> <span class="n">_isolation_scope</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="n">new_isolation_scope</span><span class="p">)</span>
+</span><span id="1-1617">
+</span><span id="1-1618">    <span class="k">try</span><span class="p">:</span>
+</span><span id="1-1619">        <span class="k">yield</span> <span class="n">new_isolation_scope</span>
+</span><span id="1-1620">
+</span><span id="1-1621">    <span class="k">finally</span><span class="p">:</span>
+</span><span id="1-1622">        <span class="c1"># restore original scopes</span>
+</span><span id="1-1623">        <span class="n">_current_scope</span><span class="o">.</span><span class="n">reset</span><span class="p">(</span><span class="n">current_token</span><span class="p">)</span>
+</span><span id="1-1624">        <span class="n">_isolation_scope</span><span class="o">.</span><span class="n">reset</span><span class="p">(</span><span class="n">isolation_token</span><span class="p">)</span>
+</span><span id="1-1625">
+</span><span id="1-1626">
+</span><span id="1-1627"><span class="nd">@contextmanager</span>
+</span><span id="1-1628"><span class="k">def</span> <span class="nf">use_isolation_scope</span><span class="p">(</span><span class="n">isolation_scope</span><span class="p">):</span>
+</span><span id="1-1629">    <span class="c1"># type: (Scope) -&gt; Generator[Scope, None, None]</span>
+</span><span id="1-1630"><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-1631"><span class="sd">    .. versionadded:: 2.0.0</span>
+</span><span id="1-1632">
+</span><span id="1-1633"><span class="sd">    Context manager that uses the given `isolation_scope` and runs the wrapped code in it.</span>
+</span><span id="1-1634"><span class="sd">    The current scope is also forked to not bleed data into the existing current scope.</span>
+</span><span id="1-1635"><span class="sd">    After the wrapped code is executed, the original scopes are restored.</span>
+</span><span id="1-1636">
+</span><span id="1-1637"><span class="sd">    Example Usage:</span>
+</span><span id="1-1638">
+</span><span id="1-1639"><span class="sd">    .. code-block:: python</span>
+</span><span id="1-1640">
+</span><span id="1-1641"><span class="sd">        import sentry_sdk</span>
+</span><span id="1-1642">
+</span><span id="1-1643"><span class="sd">        with sentry_sdk.isolation_scope() as scope:</span>
+</span><span id="1-1644"><span class="sd">            scope.set_tag(&quot;color&quot;, &quot;green&quot;)</span>
+</span><span id="1-1645"><span class="sd">            sentry_sdk.capture_message(&quot;hello&quot;) # will include `color` tag.</span>
+</span><span id="1-1646">
+</span><span id="1-1647"><span class="sd">        sentry_sdk.capture_message(&quot;hello, again&quot;) # will NOT include `color` tag.</span>
+</span><span id="1-1648">
+</span><span id="1-1649"><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="1-1650">    <span class="c1"># fork current scope</span>
+</span><span id="1-1651">    <span class="n">current_scope</span> <span class="o">=</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_current_scope</span><span class="p">()</span>
+</span><span id="1-1652">    <span class="n">forked_current_scope</span> <span class="o">=</span> <span class="n">current_scope</span><span class="o">.</span><span class="n">fork</span><span class="p">()</span>
+</span><span id="1-1653">    <span class="n">current_token</span> <span class="o">=</span> <span class="n">_current_scope</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="n">forked_current_scope</span><span class="p">)</span>
+</span><span id="1-1654">
+</span><span id="1-1655">    <span class="c1"># set given scope as isolation scope</span>
+</span><span id="1-1656">    <span class="n">isolation_token</span> <span class="o">=</span> <span class="n">_isolation_scope</span><span class="o">.</span><span class="n">set</span><span class="p">(</span><span class="n">isolation_scope</span><span class="p">)</span>
+</span><span id="1-1657">
+</span><span id="1-1658">    <span class="k">try</span><span class="p">:</span>
+</span><span id="1-1659">        <span class="k">yield</span> <span class="n">isolation_scope</span>
+</span><span id="1-1660">
+</span><span id="1-1661">    <span class="k">finally</span><span class="p">:</span>
+</span><span id="1-1662">        <span class="c1"># restore original scopes</span>
+</span><span id="1-1663">        <span class="n">_current_scope</span><span class="o">.</span><span class="n">reset</span><span class="p">(</span><span class="n">current_token</span><span class="p">)</span>
+</span><span id="1-1664">        <span class="n">_isolation_scope</span><span class="o">.</span><span class="n">reset</span><span class="p">(</span><span class="n">isolation_token</span><span class="p">)</span>
+</span><span id="1-1665">
+</span><span id="1-1666">
+</span><span id="1-1667"><span class="k">def</span> <span class="nf">should_send_default_pii</span><span class="p">():</span>
+</span><span id="1-1668">    <span class="c1"># type: () -&gt; bool</span>
+</span><span id="1-1669"><span class="w">    </span><span class="sd">&quot;&quot;&quot;Shortcut for `Scope.get_client().should_send_default_pii()`.&quot;&quot;&quot;</span>
+</span><span id="1-1670">    <span class="k">return</span> <span class="n">Scope</span><span class="o">.</span><span class="n">get_client</span><span class="p">()</span><span class="o">.</span><span class="n">should_send_default_pii</span><span class="p">()</span>
+</span><span id="1-1671">
+</span><span id="1-1672">
+</span><span id="1-1673"><span class="c1"># Circular imports</span>
+</span><span id="1-1674"><span class="kn">from</span> <span class="nn">sentry_sdk.client</span> <span class="kn">import</span> <span class="n">NonRecordingClient</span>
 </span></pre></div>
         </article>
         
@@ -1551,7 +1985,7 @@ <h1>Source code for sentry_sdk.scope</h1><div class="highlight"><pre>
     </div>
   </div>
 </footer></div>
-      <script src="../../_static/documentation_options.js?v=fca6d697"></script>
+      <script src="../../_static/documentation_options.js?v=aa9da443"></script>
       <script src="../../_static/doctools.js?v=888ff710"></script>
       <script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
       <script src="../../_static/shibuya.js?v=999236dc"></script>
diff --git a/_modules/sentry_sdk/scrubber.html b/_modules/sentry_sdk/scrubber.html
index 1d4b9e8f21..7d79c413ed 100644
--- a/_modules/sentry_sdk/scrubber.html
+++ b/_modules/sentry_sdk/scrubber.html
@@ -4,7 +4,7 @@
 <head>
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-      <title>sentry_sdk.scrubber - sentry-python 1.44.1 documentation</title>
+      <title>sentry_sdk.scrubber - sentry-python 2.0.0rc4 documentation</title>
     <link rel="index" title="Index" href="../../genindex.html" /><link rel="search" title="Search" href="../../search.html" />
 
   <script>
@@ -132,174 +132,168 @@
       <div class="min-w-0 max-w-6xl px-6 pb-6 pt-8 xl:px-12">
         <article class="yue" role="main">
           <h1>Source code for sentry_sdk.scrubber</h1><div class="highlight"><pre>
-<span></span><span id="1-1"><span class="k">try</span><span class="p">:</span>
-</span><span id="1-2">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">cast</span>
-</span><span id="1-3"><span class="k">except</span> <span class="ne">ImportError</span><span class="p">:</span>
-</span><span id="1-4">    <span class="n">cast</span> <span class="o">=</span> <span class="k">lambda</span> <span class="n">_</span><span class="p">,</span> <span class="n">obj</span><span class="p">:</span> <span class="n">obj</span>
-</span><span id="1-5">
-</span><span id="1-6"><span class="kn">from</span> <span class="nn">sentry_sdk.utils</span> <span class="kn">import</span> <span class="p">(</span>
-</span><span id="1-7">    <span class="n">capture_internal_exceptions</span><span class="p">,</span>
-</span><span id="1-8">    <span class="n">AnnotatedValue</span><span class="p">,</span>
-</span><span id="1-9">    <span class="n">iter_event_frames</span><span class="p">,</span>
-</span><span id="1-10"><span class="p">)</span>
-</span><span id="1-11"><span class="kn">from</span> <span class="nn">sentry_sdk._compat</span> <span class="kn">import</span> <span class="n">string_types</span>
-</span><span id="1-12"><span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="n">TYPE_CHECKING</span>
+<span></span><span id="1-1"><span class="kn">from</span> <span class="nn">sentry_sdk.utils</span> <span class="kn">import</span> <span class="p">(</span>
+</span><span id="1-2">    <span class="n">capture_internal_exceptions</span><span class="p">,</span>
+</span><span id="1-3">    <span class="n">AnnotatedValue</span><span class="p">,</span>
+</span><span id="1-4">    <span class="n">iter_event_frames</span><span class="p">,</span>
+</span><span id="1-5"><span class="p">)</span>
+</span><span id="1-6"><span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="n">TYPE_CHECKING</span>
+</span><span id="1-7">
+</span><span id="1-8"><span class="k">if</span> <span class="n">TYPE_CHECKING</span><span class="p">:</span>
+</span><span id="1-9">    <span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="n">Event</span>
+</span><span id="1-10">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">List</span>
+</span><span id="1-11">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Optional</span>
+</span><span id="1-12">
 </span><span id="1-13">
-</span><span id="1-14"><span class="k">if</span> <span class="n">TYPE_CHECKING</span><span class="p">:</span>
-</span><span id="1-15">    <span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="n">Event</span>
-</span><span id="1-16">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">List</span>
-</span><span id="1-17">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Optional</span>
-</span><span id="1-18">
-</span><span id="1-19">
-</span><span id="1-20"><span class="n">DEFAULT_DENYLIST</span> <span class="o">=</span> <span class="p">[</span>
-</span><span id="1-21">    <span class="c1"># stolen from relay</span>
-</span><span id="1-22">    <span class="s2">&quot;password&quot;</span><span class="p">,</span>
-</span><span id="1-23">    <span class="s2">&quot;passwd&quot;</span><span class="p">,</span>
-</span><span id="1-24">    <span class="s2">&quot;secret&quot;</span><span class="p">,</span>
-</span><span id="1-25">    <span class="s2">&quot;api_key&quot;</span><span class="p">,</span>
-</span><span id="1-26">    <span class="s2">&quot;apikey&quot;</span><span class="p">,</span>
-</span><span id="1-27">    <span class="s2">&quot;auth&quot;</span><span class="p">,</span>
-</span><span id="1-28">    <span class="s2">&quot;credentials&quot;</span><span class="p">,</span>
-</span><span id="1-29">    <span class="s2">&quot;mysql_pwd&quot;</span><span class="p">,</span>
-</span><span id="1-30">    <span class="s2">&quot;privatekey&quot;</span><span class="p">,</span>
-</span><span id="1-31">    <span class="s2">&quot;private_key&quot;</span><span class="p">,</span>
-</span><span id="1-32">    <span class="s2">&quot;token&quot;</span><span class="p">,</span>
-</span><span id="1-33">    <span class="s2">&quot;ip_address&quot;</span><span class="p">,</span>
-</span><span id="1-34">    <span class="s2">&quot;session&quot;</span><span class="p">,</span>
-</span><span id="1-35">    <span class="c1"># django</span>
-</span><span id="1-36">    <span class="s2">&quot;csrftoken&quot;</span><span class="p">,</span>
-</span><span id="1-37">    <span class="s2">&quot;sessionid&quot;</span><span class="p">,</span>
-</span><span id="1-38">    <span class="c1"># wsgi</span>
-</span><span id="1-39">    <span class="s2">&quot;remote_addr&quot;</span><span class="p">,</span>
-</span><span id="1-40">    <span class="s2">&quot;x_csrftoken&quot;</span><span class="p">,</span>
-</span><span id="1-41">    <span class="s2">&quot;x_forwarded_for&quot;</span><span class="p">,</span>
-</span><span id="1-42">    <span class="s2">&quot;set_cookie&quot;</span><span class="p">,</span>
-</span><span id="1-43">    <span class="s2">&quot;cookie&quot;</span><span class="p">,</span>
-</span><span id="1-44">    <span class="s2">&quot;authorization&quot;</span><span class="p">,</span>
-</span><span id="1-45">    <span class="s2">&quot;x_api_key&quot;</span><span class="p">,</span>
-</span><span id="1-46">    <span class="s2">&quot;x_forwarded_for&quot;</span><span class="p">,</span>
-</span><span id="1-47">    <span class="s2">&quot;x_real_ip&quot;</span><span class="p">,</span>
-</span><span id="1-48">    <span class="c1"># other common names used in the wild</span>
-</span><span id="1-49">    <span class="s2">&quot;aiohttp_session&quot;</span><span class="p">,</span>  <span class="c1"># aiohttp</span>
-</span><span id="1-50">    <span class="s2">&quot;connect.sid&quot;</span><span class="p">,</span>  <span class="c1"># Express</span>
-</span><span id="1-51">    <span class="s2">&quot;csrf_token&quot;</span><span class="p">,</span>  <span class="c1"># Pyramid</span>
-</span><span id="1-52">    <span class="s2">&quot;csrf&quot;</span><span class="p">,</span>  <span class="c1"># (this is a cookie name used in accepted answers on stack overflow)</span>
-</span><span id="1-53">    <span class="s2">&quot;_csrf&quot;</span><span class="p">,</span>  <span class="c1"># Express</span>
-</span><span id="1-54">    <span class="s2">&quot;_csrf_token&quot;</span><span class="p">,</span>  <span class="c1"># Bottle</span>
-</span><span id="1-55">    <span class="s2">&quot;PHPSESSID&quot;</span><span class="p">,</span>  <span class="c1"># PHP</span>
-</span><span id="1-56">    <span class="s2">&quot;_session&quot;</span><span class="p">,</span>  <span class="c1"># Sanic</span>
-</span><span id="1-57">    <span class="s2">&quot;symfony&quot;</span><span class="p">,</span>  <span class="c1"># Symfony</span>
-</span><span id="1-58">    <span class="s2">&quot;user_session&quot;</span><span class="p">,</span>  <span class="c1"># Vue</span>
-</span><span id="1-59">    <span class="s2">&quot;_xsrf&quot;</span><span class="p">,</span>  <span class="c1"># Tornado</span>
-</span><span id="1-60">    <span class="s2">&quot;XSRF-TOKEN&quot;</span><span class="p">,</span>  <span class="c1"># Angular, Laravel</span>
-</span><span id="1-61"><span class="p">]</span>
-</span><span id="1-62">
-</span><span id="1-63">
+</span><span id="1-14"><span class="n">DEFAULT_DENYLIST</span> <span class="o">=</span> <span class="p">[</span>
+</span><span id="1-15">    <span class="c1"># stolen from relay</span>
+</span><span id="1-16">    <span class="s2">&quot;password&quot;</span><span class="p">,</span>
+</span><span id="1-17">    <span class="s2">&quot;passwd&quot;</span><span class="p">,</span>
+</span><span id="1-18">    <span class="s2">&quot;secret&quot;</span><span class="p">,</span>
+</span><span id="1-19">    <span class="s2">&quot;api_key&quot;</span><span class="p">,</span>
+</span><span id="1-20">    <span class="s2">&quot;apikey&quot;</span><span class="p">,</span>
+</span><span id="1-21">    <span class="s2">&quot;auth&quot;</span><span class="p">,</span>
+</span><span id="1-22">    <span class="s2">&quot;credentials&quot;</span><span class="p">,</span>
+</span><span id="1-23">    <span class="s2">&quot;mysql_pwd&quot;</span><span class="p">,</span>
+</span><span id="1-24">    <span class="s2">&quot;privatekey&quot;</span><span class="p">,</span>
+</span><span id="1-25">    <span class="s2">&quot;private_key&quot;</span><span class="p">,</span>
+</span><span id="1-26">    <span class="s2">&quot;token&quot;</span><span class="p">,</span>
+</span><span id="1-27">    <span class="s2">&quot;ip_address&quot;</span><span class="p">,</span>
+</span><span id="1-28">    <span class="s2">&quot;session&quot;</span><span class="p">,</span>
+</span><span id="1-29">    <span class="c1"># django</span>
+</span><span id="1-30">    <span class="s2">&quot;csrftoken&quot;</span><span class="p">,</span>
+</span><span id="1-31">    <span class="s2">&quot;sessionid&quot;</span><span class="p">,</span>
+</span><span id="1-32">    <span class="c1"># wsgi</span>
+</span><span id="1-33">    <span class="s2">&quot;remote_addr&quot;</span><span class="p">,</span>
+</span><span id="1-34">    <span class="s2">&quot;x_csrftoken&quot;</span><span class="p">,</span>
+</span><span id="1-35">    <span class="s2">&quot;x_forwarded_for&quot;</span><span class="p">,</span>
+</span><span id="1-36">    <span class="s2">&quot;set_cookie&quot;</span><span class="p">,</span>
+</span><span id="1-37">    <span class="s2">&quot;cookie&quot;</span><span class="p">,</span>
+</span><span id="1-38">    <span class="s2">&quot;authorization&quot;</span><span class="p">,</span>
+</span><span id="1-39">    <span class="s2">&quot;x_api_key&quot;</span><span class="p">,</span>
+</span><span id="1-40">    <span class="s2">&quot;x_forwarded_for&quot;</span><span class="p">,</span>
+</span><span id="1-41">    <span class="s2">&quot;x_real_ip&quot;</span><span class="p">,</span>
+</span><span id="1-42">    <span class="c1"># other common names used in the wild</span>
+</span><span id="1-43">    <span class="s2">&quot;aiohttp_session&quot;</span><span class="p">,</span>  <span class="c1"># aiohttp</span>
+</span><span id="1-44">    <span class="s2">&quot;connect.sid&quot;</span><span class="p">,</span>  <span class="c1"># Express</span>
+</span><span id="1-45">    <span class="s2">&quot;csrf_token&quot;</span><span class="p">,</span>  <span class="c1"># Pyramid</span>
+</span><span id="1-46">    <span class="s2">&quot;csrf&quot;</span><span class="p">,</span>  <span class="c1"># (this is a cookie name used in accepted answers on stack overflow)</span>
+</span><span id="1-47">    <span class="s2">&quot;_csrf&quot;</span><span class="p">,</span>  <span class="c1"># Express</span>
+</span><span id="1-48">    <span class="s2">&quot;_csrf_token&quot;</span><span class="p">,</span>  <span class="c1"># Bottle</span>
+</span><span id="1-49">    <span class="s2">&quot;PHPSESSID&quot;</span><span class="p">,</span>  <span class="c1"># PHP</span>
+</span><span id="1-50">    <span class="s2">&quot;_session&quot;</span><span class="p">,</span>  <span class="c1"># Sanic</span>
+</span><span id="1-51">    <span class="s2">&quot;symfony&quot;</span><span class="p">,</span>  <span class="c1"># Symfony</span>
+</span><span id="1-52">    <span class="s2">&quot;user_session&quot;</span><span class="p">,</span>  <span class="c1"># Vue</span>
+</span><span id="1-53">    <span class="s2">&quot;_xsrf&quot;</span><span class="p">,</span>  <span class="c1"># Tornado</span>
+</span><span id="1-54">    <span class="s2">&quot;XSRF-TOKEN&quot;</span><span class="p">,</span>  <span class="c1"># Angular, Laravel</span>
+</span><span id="1-55"><span class="p">]</span>
+</span><span id="1-56">
+</span><span id="1-57">
 <div class="viewcode-block" id="EventScrubber">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.scrubber.EventScrubber">[docs]</a>
-</span><span id="1-64"><span class="k">class</span> <span class="nc">EventScrubber</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-</span><span id="1-65">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">denylist</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">recursive</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
-</span><span id="1-66">        <span class="c1"># type: (Optional[List[str]], bool) -&gt; None</span>
-</span><span id="1-67">        <span class="bp">self</span><span class="o">.</span><span class="n">denylist</span> <span class="o">=</span> <span class="n">DEFAULT_DENYLIST</span> <span class="k">if</span> <span class="n">denylist</span> <span class="ow">is</span> <span class="kc">None</span> <span class="k">else</span> <span class="n">denylist</span>
-</span><span id="1-68">        <span class="bp">self</span><span class="o">.</span><span class="n">denylist</span> <span class="o">=</span> <span class="p">[</span><span class="n">x</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span> <span class="k">for</span> <span class="n">x</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">denylist</span><span class="p">]</span>
-</span><span id="1-69">        <span class="bp">self</span><span class="o">.</span><span class="n">recursive</span> <span class="o">=</span> <span class="n">recursive</span>
-</span><span id="1-70">
+</span><span id="1-58"><span class="k">class</span> <span class="nc">EventScrubber</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
+</span><span id="1-59">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">denylist</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">recursive</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
+</span><span id="1-60">        <span class="c1"># type: (Optional[List[str]], bool) -&gt; None</span>
+</span><span id="1-61">        <span class="bp">self</span><span class="o">.</span><span class="n">denylist</span> <span class="o">=</span> <span class="n">DEFAULT_DENYLIST</span> <span class="k">if</span> <span class="n">denylist</span> <span class="ow">is</span> <span class="kc">None</span> <span class="k">else</span> <span class="n">denylist</span>
+</span><span id="1-62">        <span class="bp">self</span><span class="o">.</span><span class="n">denylist</span> <span class="o">=</span> <span class="p">[</span><span class="n">x</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span> <span class="k">for</span> <span class="n">x</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">denylist</span><span class="p">]</span>
+</span><span id="1-63">        <span class="bp">self</span><span class="o">.</span><span class="n">recursive</span> <span class="o">=</span> <span class="n">recursive</span>
+</span><span id="1-64">
 <div class="viewcode-block" id="EventScrubber.scrub_list">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.scrubber.EventScrubber.scrub_list">[docs]</a>
-</span><span id="1-71">    <span class="k">def</span> <span class="nf">scrub_list</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">lst</span><span class="p">):</span>
-</span><span id="1-72">        <span class="c1"># type: (object) -&gt; None</span>
-</span><span id="1-73"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-74"><span class="sd">        If a list is passed to this method, the method recursively searches the list and any</span>
-</span><span id="1-75"><span class="sd">        nested lists for any dictionaries. The method calls scrub_dict on all dictionaries</span>
-</span><span id="1-76"><span class="sd">        it finds.</span>
-</span><span id="1-77"><span class="sd">        If the parameter passed to this method is not a list, the method does nothing.</span>
-</span><span id="1-78"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-79">        <span class="k">if</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">lst</span><span class="p">,</span> <span class="nb">list</span><span class="p">):</span>
-</span><span id="1-80">            <span class="k">return</span>
-</span><span id="1-81">
-</span><span id="1-82">        <span class="k">for</span> <span class="n">v</span> <span class="ow">in</span> <span class="n">lst</span><span class="p">:</span>
-</span><span id="1-83">            <span class="bp">self</span><span class="o">.</span><span class="n">scrub_dict</span><span class="p">(</span><span class="n">v</span><span class="p">)</span>  <span class="c1"># no-op unless v is a dict</span>
-</span><span id="1-84">            <span class="bp">self</span><span class="o">.</span><span class="n">scrub_list</span><span class="p">(</span><span class="n">v</span><span class="p">)</span>  <span class="c1"># no-op unless v is a list</span></div>
+</span><span id="1-65">    <span class="k">def</span> <span class="nf">scrub_list</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">lst</span><span class="p">):</span>
+</span><span id="1-66">        <span class="c1"># type: (object) -&gt; None</span>
+</span><span id="1-67"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-68"><span class="sd">        If a list is passed to this method, the method recursively searches the list and any</span>
+</span><span id="1-69"><span class="sd">        nested lists for any dictionaries. The method calls scrub_dict on all dictionaries</span>
+</span><span id="1-70"><span class="sd">        it finds.</span>
+</span><span id="1-71"><span class="sd">        If the parameter passed to this method is not a list, the method does nothing.</span>
+</span><span id="1-72"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-73">        <span class="k">if</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">lst</span><span class="p">,</span> <span class="nb">list</span><span class="p">):</span>
+</span><span id="1-74">            <span class="k">return</span>
+</span><span id="1-75">
+</span><span id="1-76">        <span class="k">for</span> <span class="n">v</span> <span class="ow">in</span> <span class="n">lst</span><span class="p">:</span>
+</span><span id="1-77">            <span class="bp">self</span><span class="o">.</span><span class="n">scrub_dict</span><span class="p">(</span><span class="n">v</span><span class="p">)</span>  <span class="c1"># no-op unless v is a dict</span>
+</span><span id="1-78">            <span class="bp">self</span><span class="o">.</span><span class="n">scrub_list</span><span class="p">(</span><span class="n">v</span><span class="p">)</span>  <span class="c1"># no-op unless v is a list</span></div>
 
-</span><span id="1-85">
+</span><span id="1-79">
 <div class="viewcode-block" id="EventScrubber.scrub_dict">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.scrubber.EventScrubber.scrub_dict">[docs]</a>
-</span><span id="1-86">    <span class="k">def</span> <span class="nf">scrub_dict</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">d</span><span class="p">):</span>
-</span><span id="1-87">        <span class="c1"># type: (object) -&gt; None</span>
-</span><span id="1-88"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-89"><span class="sd">        If a dictionary is passed to this method, the method scrubs the dictionary of any</span>
-</span><span id="1-90"><span class="sd">        sensitive data. The method calls itself recursively on any nested dictionaries (</span>
-</span><span id="1-91"><span class="sd">        including dictionaries nested in lists) if self.recursive is True.</span>
-</span><span id="1-92"><span class="sd">        This method does nothing if the parameter passed to it is not a dictionary.</span>
-</span><span id="1-93"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-94">        <span class="k">if</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">d</span><span class="p">,</span> <span class="nb">dict</span><span class="p">):</span>
-</span><span id="1-95">            <span class="k">return</span>
-</span><span id="1-96">
-</span><span id="1-97">        <span class="k">for</span> <span class="n">k</span><span class="p">,</span> <span class="n">v</span> <span class="ow">in</span> <span class="n">d</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
-</span><span id="1-98">            <span class="c1"># The cast is needed because mypy is not smart enough to figure out that k must be a</span>
-</span><span id="1-99">            <span class="c1"># string after the isinstance check.</span>
-</span><span id="1-100">            <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">k</span><span class="p">,</span> <span class="n">string_types</span><span class="p">)</span> <span class="ow">and</span> <span class="n">cast</span><span class="p">(</span><span class="nb">str</span><span class="p">,</span> <span class="n">k</span><span class="p">)</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">denylist</span><span class="p">:</span>
-</span><span id="1-101">                <span class="n">d</span><span class="p">[</span><span class="n">k</span><span class="p">]</span> <span class="o">=</span> <span class="n">AnnotatedValue</span><span class="o">.</span><span class="n">substituted_because_contains_sensitive_data</span><span class="p">()</span>
-</span><span id="1-102">            <span class="k">elif</span> <span class="bp">self</span><span class="o">.</span><span class="n">recursive</span><span class="p">:</span>
-</span><span id="1-103">                <span class="bp">self</span><span class="o">.</span><span class="n">scrub_dict</span><span class="p">(</span><span class="n">v</span><span class="p">)</span>  <span class="c1"># no-op unless v is a dict</span>
-</span><span id="1-104">                <span class="bp">self</span><span class="o">.</span><span class="n">scrub_list</span><span class="p">(</span><span class="n">v</span><span class="p">)</span>  <span class="c1"># no-op unless v is a list</span></div>
+</span><span id="1-80">    <span class="k">def</span> <span class="nf">scrub_dict</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">d</span><span class="p">):</span>
+</span><span id="1-81">        <span class="c1"># type: (object) -&gt; None</span>
+</span><span id="1-82"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-83"><span class="sd">        If a dictionary is passed to this method, the method scrubs the dictionary of any</span>
+</span><span id="1-84"><span class="sd">        sensitive data. The method calls itself recursively on any nested dictionaries (</span>
+</span><span id="1-85"><span class="sd">        including dictionaries nested in lists) if self.recursive is True.</span>
+</span><span id="1-86"><span class="sd">        This method does nothing if the parameter passed to it is not a dictionary.</span>
+</span><span id="1-87"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-88">        <span class="k">if</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">d</span><span class="p">,</span> <span class="nb">dict</span><span class="p">):</span>
+</span><span id="1-89">            <span class="k">return</span>
+</span><span id="1-90">
+</span><span id="1-91">        <span class="k">for</span> <span class="n">k</span><span class="p">,</span> <span class="n">v</span> <span class="ow">in</span> <span class="n">d</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
+</span><span id="1-92">            <span class="c1"># The cast is needed because mypy is not smart enough to figure out that k must be a</span>
+</span><span id="1-93">            <span class="c1"># string after the isinstance check.</span>
+</span><span id="1-94">            <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">k</span><span class="p">,</span> <span class="nb">str</span><span class="p">)</span> <span class="ow">and</span> <span class="n">k</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">denylist</span><span class="p">:</span>
+</span><span id="1-95">                <span class="n">d</span><span class="p">[</span><span class="n">k</span><span class="p">]</span> <span class="o">=</span> <span class="n">AnnotatedValue</span><span class="o">.</span><span class="n">substituted_because_contains_sensitive_data</span><span class="p">()</span>
+</span><span id="1-96">            <span class="k">elif</span> <span class="bp">self</span><span class="o">.</span><span class="n">recursive</span><span class="p">:</span>
+</span><span id="1-97">                <span class="bp">self</span><span class="o">.</span><span class="n">scrub_dict</span><span class="p">(</span><span class="n">v</span><span class="p">)</span>  <span class="c1"># no-op unless v is a dict</span>
+</span><span id="1-98">                <span class="bp">self</span><span class="o">.</span><span class="n">scrub_list</span><span class="p">(</span><span class="n">v</span><span class="p">)</span>  <span class="c1"># no-op unless v is a list</span></div>
 
-</span><span id="1-105">
-</span><span id="1-106">    <span class="k">def</span> <span class="nf">scrub_request</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">):</span>
-</span><span id="1-107">        <span class="c1"># type: (Event) -&gt; None</span>
-</span><span id="1-108">        <span class="k">with</span> <span class="n">capture_internal_exceptions</span><span class="p">():</span>
-</span><span id="1-109">            <span class="k">if</span> <span class="s2">&quot;request&quot;</span> <span class="ow">in</span> <span class="n">event</span><span class="p">:</span>
-</span><span id="1-110">                <span class="k">if</span> <span class="s2">&quot;headers&quot;</span> <span class="ow">in</span> <span class="n">event</span><span class="p">[</span><span class="s2">&quot;request&quot;</span><span class="p">]:</span>
-</span><span id="1-111">                    <span class="bp">self</span><span class="o">.</span><span class="n">scrub_dict</span><span class="p">(</span><span class="n">event</span><span class="p">[</span><span class="s2">&quot;request&quot;</span><span class="p">][</span><span class="s2">&quot;headers&quot;</span><span class="p">])</span>
-</span><span id="1-112">                <span class="k">if</span> <span class="s2">&quot;cookies&quot;</span> <span class="ow">in</span> <span class="n">event</span><span class="p">[</span><span class="s2">&quot;request&quot;</span><span class="p">]:</span>
-</span><span id="1-113">                    <span class="bp">self</span><span class="o">.</span><span class="n">scrub_dict</span><span class="p">(</span><span class="n">event</span><span class="p">[</span><span class="s2">&quot;request&quot;</span><span class="p">][</span><span class="s2">&quot;cookies&quot;</span><span class="p">])</span>
-</span><span id="1-114">                <span class="k">if</span> <span class="s2">&quot;data&quot;</span> <span class="ow">in</span> <span class="n">event</span><span class="p">[</span><span class="s2">&quot;request&quot;</span><span class="p">]:</span>
-</span><span id="1-115">                    <span class="bp">self</span><span class="o">.</span><span class="n">scrub_dict</span><span class="p">(</span><span class="n">event</span><span class="p">[</span><span class="s2">&quot;request&quot;</span><span class="p">][</span><span class="s2">&quot;data&quot;</span><span class="p">])</span>
+</span><span id="1-99">
+</span><span id="1-100">    <span class="k">def</span> <span class="nf">scrub_request</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">):</span>
+</span><span id="1-101">        <span class="c1"># type: (Event) -&gt; None</span>
+</span><span id="1-102">        <span class="k">with</span> <span class="n">capture_internal_exceptions</span><span class="p">():</span>
+</span><span id="1-103">            <span class="k">if</span> <span class="s2">&quot;request&quot;</span> <span class="ow">in</span> <span class="n">event</span><span class="p">:</span>
+</span><span id="1-104">                <span class="k">if</span> <span class="s2">&quot;headers&quot;</span> <span class="ow">in</span> <span class="n">event</span><span class="p">[</span><span class="s2">&quot;request&quot;</span><span class="p">]:</span>
+</span><span id="1-105">                    <span class="bp">self</span><span class="o">.</span><span class="n">scrub_dict</span><span class="p">(</span><span class="n">event</span><span class="p">[</span><span class="s2">&quot;request&quot;</span><span class="p">][</span><span class="s2">&quot;headers&quot;</span><span class="p">])</span>
+</span><span id="1-106">                <span class="k">if</span> <span class="s2">&quot;cookies&quot;</span> <span class="ow">in</span> <span class="n">event</span><span class="p">[</span><span class="s2">&quot;request&quot;</span><span class="p">]:</span>
+</span><span id="1-107">                    <span class="bp">self</span><span class="o">.</span><span class="n">scrub_dict</span><span class="p">(</span><span class="n">event</span><span class="p">[</span><span class="s2">&quot;request&quot;</span><span class="p">][</span><span class="s2">&quot;cookies&quot;</span><span class="p">])</span>
+</span><span id="1-108">                <span class="k">if</span> <span class="s2">&quot;data&quot;</span> <span class="ow">in</span> <span class="n">event</span><span class="p">[</span><span class="s2">&quot;request&quot;</span><span class="p">]:</span>
+</span><span id="1-109">                    <span class="bp">self</span><span class="o">.</span><span class="n">scrub_dict</span><span class="p">(</span><span class="n">event</span><span class="p">[</span><span class="s2">&quot;request&quot;</span><span class="p">][</span><span class="s2">&quot;data&quot;</span><span class="p">])</span>
+</span><span id="1-110">
+</span><span id="1-111">    <span class="k">def</span> <span class="nf">scrub_extra</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">):</span>
+</span><span id="1-112">        <span class="c1"># type: (Event) -&gt; None</span>
+</span><span id="1-113">        <span class="k">with</span> <span class="n">capture_internal_exceptions</span><span class="p">():</span>
+</span><span id="1-114">            <span class="k">if</span> <span class="s2">&quot;extra&quot;</span> <span class="ow">in</span> <span class="n">event</span><span class="p">:</span>
+</span><span id="1-115">                <span class="bp">self</span><span class="o">.</span><span class="n">scrub_dict</span><span class="p">(</span><span class="n">event</span><span class="p">[</span><span class="s2">&quot;extra&quot;</span><span class="p">])</span>
 </span><span id="1-116">
-</span><span id="1-117">    <span class="k">def</span> <span class="nf">scrub_extra</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">):</span>
+</span><span id="1-117">    <span class="k">def</span> <span class="nf">scrub_user</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">):</span>
 </span><span id="1-118">        <span class="c1"># type: (Event) -&gt; None</span>
 </span><span id="1-119">        <span class="k">with</span> <span class="n">capture_internal_exceptions</span><span class="p">():</span>
-</span><span id="1-120">            <span class="k">if</span> <span class="s2">&quot;extra&quot;</span> <span class="ow">in</span> <span class="n">event</span><span class="p">:</span>
-</span><span id="1-121">                <span class="bp">self</span><span class="o">.</span><span class="n">scrub_dict</span><span class="p">(</span><span class="n">event</span><span class="p">[</span><span class="s2">&quot;extra&quot;</span><span class="p">])</span>
+</span><span id="1-120">            <span class="k">if</span> <span class="s2">&quot;user&quot;</span> <span class="ow">in</span> <span class="n">event</span><span class="p">:</span>
+</span><span id="1-121">                <span class="bp">self</span><span class="o">.</span><span class="n">scrub_dict</span><span class="p">(</span><span class="n">event</span><span class="p">[</span><span class="s2">&quot;user&quot;</span><span class="p">])</span>
 </span><span id="1-122">
-</span><span id="1-123">    <span class="k">def</span> <span class="nf">scrub_user</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">):</span>
+</span><span id="1-123">    <span class="k">def</span> <span class="nf">scrub_breadcrumbs</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">):</span>
 </span><span id="1-124">        <span class="c1"># type: (Event) -&gt; None</span>
 </span><span id="1-125">        <span class="k">with</span> <span class="n">capture_internal_exceptions</span><span class="p">():</span>
-</span><span id="1-126">            <span class="k">if</span> <span class="s2">&quot;user&quot;</span> <span class="ow">in</span> <span class="n">event</span><span class="p">:</span>
-</span><span id="1-127">                <span class="bp">self</span><span class="o">.</span><span class="n">scrub_dict</span><span class="p">(</span><span class="n">event</span><span class="p">[</span><span class="s2">&quot;user&quot;</span><span class="p">])</span>
-</span><span id="1-128">
-</span><span id="1-129">    <span class="k">def</span> <span class="nf">scrub_breadcrumbs</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">):</span>
-</span><span id="1-130">        <span class="c1"># type: (Event) -&gt; None</span>
-</span><span id="1-131">        <span class="k">with</span> <span class="n">capture_internal_exceptions</span><span class="p">():</span>
-</span><span id="1-132">            <span class="k">if</span> <span class="s2">&quot;breadcrumbs&quot;</span> <span class="ow">in</span> <span class="n">event</span><span class="p">:</span>
-</span><span id="1-133">                <span class="k">if</span> <span class="s2">&quot;values&quot;</span> <span class="ow">in</span> <span class="n">event</span><span class="p">[</span><span class="s2">&quot;breadcrumbs&quot;</span><span class="p">]:</span>
-</span><span id="1-134">                    <span class="k">for</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">event</span><span class="p">[</span><span class="s2">&quot;breadcrumbs&quot;</span><span class="p">][</span><span class="s2">&quot;values&quot;</span><span class="p">]:</span>
-</span><span id="1-135">                        <span class="k">if</span> <span class="s2">&quot;data&quot;</span> <span class="ow">in</span> <span class="n">value</span><span class="p">:</span>
-</span><span id="1-136">                            <span class="bp">self</span><span class="o">.</span><span class="n">scrub_dict</span><span class="p">(</span><span class="n">value</span><span class="p">[</span><span class="s2">&quot;data&quot;</span><span class="p">])</span>
-</span><span id="1-137">
-</span><span id="1-138">    <span class="k">def</span> <span class="nf">scrub_frames</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">):</span>
-</span><span id="1-139">        <span class="c1"># type: (Event) -&gt; None</span>
-</span><span id="1-140">        <span class="k">with</span> <span class="n">capture_internal_exceptions</span><span class="p">():</span>
-</span><span id="1-141">            <span class="k">for</span> <span class="n">frame</span> <span class="ow">in</span> <span class="n">iter_event_frames</span><span class="p">(</span><span class="n">event</span><span class="p">):</span>
-</span><span id="1-142">                <span class="k">if</span> <span class="s2">&quot;vars&quot;</span> <span class="ow">in</span> <span class="n">frame</span><span class="p">:</span>
-</span><span id="1-143">                    <span class="bp">self</span><span class="o">.</span><span class="n">scrub_dict</span><span class="p">(</span><span class="n">frame</span><span class="p">[</span><span class="s2">&quot;vars&quot;</span><span class="p">])</span>
-</span><span id="1-144">
-</span><span id="1-145">    <span class="k">def</span> <span class="nf">scrub_spans</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">):</span>
-</span><span id="1-146">        <span class="c1"># type: (Event) -&gt; None</span>
-</span><span id="1-147">        <span class="k">with</span> <span class="n">capture_internal_exceptions</span><span class="p">():</span>
-</span><span id="1-148">            <span class="k">if</span> <span class="s2">&quot;spans&quot;</span> <span class="ow">in</span> <span class="n">event</span><span class="p">:</span>
-</span><span id="1-149">                <span class="k">for</span> <span class="n">span</span> <span class="ow">in</span> <span class="n">event</span><span class="p">[</span><span class="s2">&quot;spans&quot;</span><span class="p">]:</span>
-</span><span id="1-150">                    <span class="k">if</span> <span class="s2">&quot;data&quot;</span> <span class="ow">in</span> <span class="n">span</span><span class="p">:</span>
-</span><span id="1-151">                        <span class="bp">self</span><span class="o">.</span><span class="n">scrub_dict</span><span class="p">(</span><span class="n">span</span><span class="p">[</span><span class="s2">&quot;data&quot;</span><span class="p">])</span>
-</span><span id="1-152">
-</span><span id="1-153">    <span class="k">def</span> <span class="nf">scrub_event</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">):</span>
-</span><span id="1-154">        <span class="c1"># type: (Event) -&gt; None</span>
-</span><span id="1-155">        <span class="bp">self</span><span class="o">.</span><span class="n">scrub_request</span><span class="p">(</span><span class="n">event</span><span class="p">)</span>
-</span><span id="1-156">        <span class="bp">self</span><span class="o">.</span><span class="n">scrub_extra</span><span class="p">(</span><span class="n">event</span><span class="p">)</span>
-</span><span id="1-157">        <span class="bp">self</span><span class="o">.</span><span class="n">scrub_user</span><span class="p">(</span><span class="n">event</span><span class="p">)</span>
-</span><span id="1-158">        <span class="bp">self</span><span class="o">.</span><span class="n">scrub_breadcrumbs</span><span class="p">(</span><span class="n">event</span><span class="p">)</span>
-</span><span id="1-159">        <span class="bp">self</span><span class="o">.</span><span class="n">scrub_frames</span><span class="p">(</span><span class="n">event</span><span class="p">)</span>
-</span><span id="1-160">        <span class="bp">self</span><span class="o">.</span><span class="n">scrub_spans</span><span class="p">(</span><span class="n">event</span><span class="p">)</span></div>
+</span><span id="1-126">            <span class="k">if</span> <span class="s2">&quot;breadcrumbs&quot;</span> <span class="ow">in</span> <span class="n">event</span><span class="p">:</span>
+</span><span id="1-127">                <span class="k">if</span> <span class="s2">&quot;values&quot;</span> <span class="ow">in</span> <span class="n">event</span><span class="p">[</span><span class="s2">&quot;breadcrumbs&quot;</span><span class="p">]:</span>
+</span><span id="1-128">                    <span class="k">for</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">event</span><span class="p">[</span><span class="s2">&quot;breadcrumbs&quot;</span><span class="p">][</span><span class="s2">&quot;values&quot;</span><span class="p">]:</span>
+</span><span id="1-129">                        <span class="k">if</span> <span class="s2">&quot;data&quot;</span> <span class="ow">in</span> <span class="n">value</span><span class="p">:</span>
+</span><span id="1-130">                            <span class="bp">self</span><span class="o">.</span><span class="n">scrub_dict</span><span class="p">(</span><span class="n">value</span><span class="p">[</span><span class="s2">&quot;data&quot;</span><span class="p">])</span>
+</span><span id="1-131">
+</span><span id="1-132">    <span class="k">def</span> <span class="nf">scrub_frames</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">):</span>
+</span><span id="1-133">        <span class="c1"># type: (Event) -&gt; None</span>
+</span><span id="1-134">        <span class="k">with</span> <span class="n">capture_internal_exceptions</span><span class="p">():</span>
+</span><span id="1-135">            <span class="k">for</span> <span class="n">frame</span> <span class="ow">in</span> <span class="n">iter_event_frames</span><span class="p">(</span><span class="n">event</span><span class="p">):</span>
+</span><span id="1-136">                <span class="k">if</span> <span class="s2">&quot;vars&quot;</span> <span class="ow">in</span> <span class="n">frame</span><span class="p">:</span>
+</span><span id="1-137">                    <span class="bp">self</span><span class="o">.</span><span class="n">scrub_dict</span><span class="p">(</span><span class="n">frame</span><span class="p">[</span><span class="s2">&quot;vars&quot;</span><span class="p">])</span>
+</span><span id="1-138">
+</span><span id="1-139">    <span class="k">def</span> <span class="nf">scrub_spans</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">):</span>
+</span><span id="1-140">        <span class="c1"># type: (Event) -&gt; None</span>
+</span><span id="1-141">        <span class="k">with</span> <span class="n">capture_internal_exceptions</span><span class="p">():</span>
+</span><span id="1-142">            <span class="k">if</span> <span class="s2">&quot;spans&quot;</span> <span class="ow">in</span> <span class="n">event</span><span class="p">:</span>
+</span><span id="1-143">                <span class="k">for</span> <span class="n">span</span> <span class="ow">in</span> <span class="n">event</span><span class="p">[</span><span class="s2">&quot;spans&quot;</span><span class="p">]:</span>
+</span><span id="1-144">                    <span class="k">if</span> <span class="s2">&quot;data&quot;</span> <span class="ow">in</span> <span class="n">span</span><span class="p">:</span>
+</span><span id="1-145">                        <span class="bp">self</span><span class="o">.</span><span class="n">scrub_dict</span><span class="p">(</span><span class="n">span</span><span class="p">[</span><span class="s2">&quot;data&quot;</span><span class="p">])</span>
+</span><span id="1-146">
+</span><span id="1-147">    <span class="k">def</span> <span class="nf">scrub_event</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">event</span><span class="p">):</span>
+</span><span id="1-148">        <span class="c1"># type: (Event) -&gt; None</span>
+</span><span id="1-149">        <span class="bp">self</span><span class="o">.</span><span class="n">scrub_request</span><span class="p">(</span><span class="n">event</span><span class="p">)</span>
+</span><span id="1-150">        <span class="bp">self</span><span class="o">.</span><span class="n">scrub_extra</span><span class="p">(</span><span class="n">event</span><span class="p">)</span>
+</span><span id="1-151">        <span class="bp">self</span><span class="o">.</span><span class="n">scrub_user</span><span class="p">(</span><span class="n">event</span><span class="p">)</span>
+</span><span id="1-152">        <span class="bp">self</span><span class="o">.</span><span class="n">scrub_breadcrumbs</span><span class="p">(</span><span class="n">event</span><span class="p">)</span>
+</span><span id="1-153">        <span class="bp">self</span><span class="o">.</span><span class="n">scrub_frames</span><span class="p">(</span><span class="n">event</span><span class="p">)</span>
+</span><span id="1-154">        <span class="bp">self</span><span class="o">.</span><span class="n">scrub_spans</span><span class="p">(</span><span class="n">event</span><span class="p">)</span></div>
 
 </span></pre></div>
         </article>
@@ -333,7 +327,7 @@ <h1>Source code for sentry_sdk.scrubber</h1><div class="highlight"><pre>
     </div>
   </div>
 </footer></div>
-      <script src="../../_static/documentation_options.js?v=fca6d697"></script>
+      <script src="../../_static/documentation_options.js?v=aa9da443"></script>
       <script src="../../_static/doctools.js?v=888ff710"></script>
       <script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
       <script src="../../_static/shibuya.js?v=999236dc"></script>
diff --git a/_modules/sentry_sdk/session.html b/_modules/sentry_sdk/session.html
index 4df4bba1d2..38d3f1bd86 100644
--- a/_modules/sentry_sdk/session.html
+++ b/_modules/sentry_sdk/session.html
@@ -4,7 +4,7 @@
 <head>
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-      <title>sentry_sdk.session - sentry-python 1.44.1 documentation</title>
+      <title>sentry_sdk.session - sentry-python 2.0.0rc4 documentation</title>
     <link rel="index" title="Index" href="../../genindex.html" /><link rel="search" title="Search" href="../../search.html" />
 
   <script>
@@ -133,182 +133,181 @@
         <article class="yue" role="main">
           <h1>Source code for sentry_sdk.session</h1><div class="highlight"><pre>
 <span></span><span id="1-1"><span class="kn">import</span> <span class="nn">uuid</span>
-</span><span id="1-2">
-</span><span id="1-3"><span class="kn">from</span> <span class="nn">sentry_sdk._compat</span> <span class="kn">import</span> <span class="n">datetime_utcnow</span>
+</span><span id="1-2"><span class="kn">from</span> <span class="nn">datetime</span> <span class="kn">import</span> <span class="n">datetime</span><span class="p">,</span> <span class="n">timezone</span>
+</span><span id="1-3">
 </span><span id="1-4"><span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="n">TYPE_CHECKING</span>
 </span><span id="1-5"><span class="kn">from</span> <span class="nn">sentry_sdk.utils</span> <span class="kn">import</span> <span class="n">format_timestamp</span>
 </span><span id="1-6">
 </span><span id="1-7"><span class="k">if</span> <span class="n">TYPE_CHECKING</span><span class="p">:</span>
-</span><span id="1-8">    <span class="kn">from</span> <span class="nn">datetime</span> <span class="kn">import</span> <span class="n">datetime</span>
-</span><span id="1-9">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Optional</span>
-</span><span id="1-10">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Union</span>
-</span><span id="1-11">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Any</span>
-</span><span id="1-12">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Dict</span>
-</span><span id="1-13">
-</span><span id="1-14">    <span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="n">SessionStatus</span>
+</span><span id="1-8">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Optional</span>
+</span><span id="1-9">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Union</span>
+</span><span id="1-10">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Any</span>
+</span><span id="1-11">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Dict</span>
+</span><span id="1-12">
+</span><span id="1-13">    <span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="n">SessionStatus</span>
+</span><span id="1-14">
 </span><span id="1-15">
-</span><span id="1-16">
-</span><span id="1-17"><span class="k">def</span> <span class="nf">_minute_trunc</span><span class="p">(</span><span class="n">ts</span><span class="p">):</span>
-</span><span id="1-18">    <span class="c1"># type: (datetime) -&gt; datetime</span>
-</span><span id="1-19">    <span class="k">return</span> <span class="n">ts</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="n">second</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">microsecond</span><span class="o">=</span><span class="mi">0</span><span class="p">)</span>
+</span><span id="1-16"><span class="k">def</span> <span class="nf">_minute_trunc</span><span class="p">(</span><span class="n">ts</span><span class="p">):</span>
+</span><span id="1-17">    <span class="c1"># type: (datetime) -&gt; datetime</span>
+</span><span id="1-18">    <span class="k">return</span> <span class="n">ts</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="n">second</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="n">microsecond</span><span class="o">=</span><span class="mi">0</span><span class="p">)</span>
+</span><span id="1-19">
 </span><span id="1-20">
-</span><span id="1-21">
-</span><span id="1-22"><span class="k">def</span> <span class="nf">_make_uuid</span><span class="p">(</span>
-</span><span id="1-23">    <span class="n">val</span><span class="p">,</span>  <span class="c1"># type: Union[str, uuid.UUID]</span>
-</span><span id="1-24"><span class="p">):</span>
-</span><span id="1-25">    <span class="c1"># type: (...) -&gt; uuid.UUID</span>
-</span><span id="1-26">    <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">val</span><span class="p">,</span> <span class="n">uuid</span><span class="o">.</span><span class="n">UUID</span><span class="p">):</span>
-</span><span id="1-27">        <span class="k">return</span> <span class="n">val</span>
-</span><span id="1-28">    <span class="k">return</span> <span class="n">uuid</span><span class="o">.</span><span class="n">UUID</span><span class="p">(</span><span class="n">val</span><span class="p">)</span>
+</span><span id="1-21"><span class="k">def</span> <span class="nf">_make_uuid</span><span class="p">(</span>
+</span><span id="1-22">    <span class="n">val</span><span class="p">,</span>  <span class="c1"># type: Union[str, uuid.UUID]</span>
+</span><span id="1-23"><span class="p">):</span>
+</span><span id="1-24">    <span class="c1"># type: (...) -&gt; uuid.UUID</span>
+</span><span id="1-25">    <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">val</span><span class="p">,</span> <span class="n">uuid</span><span class="o">.</span><span class="n">UUID</span><span class="p">):</span>
+</span><span id="1-26">        <span class="k">return</span> <span class="n">val</span>
+</span><span id="1-27">    <span class="k">return</span> <span class="n">uuid</span><span class="o">.</span><span class="n">UUID</span><span class="p">(</span><span class="n">val</span><span class="p">)</span>
+</span><span id="1-28">
 </span><span id="1-29">
-</span><span id="1-30">
 <div class="viewcode-block" id="Session">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.session.Session">[docs]</a>
-</span><span id="1-31"><span class="k">class</span> <span class="nc">Session</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-</span><span id="1-32">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
-</span><span id="1-33">        <span class="bp">self</span><span class="p">,</span>
-</span><span id="1-34">        <span class="n">sid</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Union[str, uuid.UUID]]</span>
-</span><span id="1-35">        <span class="n">did</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
-</span><span id="1-36">        <span class="n">timestamp</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[datetime]</span>
-</span><span id="1-37">        <span class="n">started</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[datetime]</span>
-</span><span id="1-38">        <span class="n">duration</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[float]</span>
-</span><span id="1-39">        <span class="n">status</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[SessionStatus]</span>
-</span><span id="1-40">        <span class="n">release</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
-</span><span id="1-41">        <span class="n">environment</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
-</span><span id="1-42">        <span class="n">user_agent</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
-</span><span id="1-43">        <span class="n">ip_address</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
-</span><span id="1-44">        <span class="n">errors</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[int]</span>
-</span><span id="1-45">        <span class="n">user</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Any]</span>
-</span><span id="1-46">        <span class="n">session_mode</span><span class="o">=</span><span class="s2">&quot;application&quot;</span><span class="p">,</span>  <span class="c1"># type: str</span>
-</span><span id="1-47">    <span class="p">):</span>
-</span><span id="1-48">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-49">        <span class="k">if</span> <span class="n">sid</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-50">            <span class="n">sid</span> <span class="o">=</span> <span class="n">uuid</span><span class="o">.</span><span class="n">uuid4</span><span class="p">()</span>
-</span><span id="1-51">        <span class="k">if</span> <span class="n">started</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-52">            <span class="n">started</span> <span class="o">=</span> <span class="n">datetime_utcnow</span><span class="p">()</span>
-</span><span id="1-53">        <span class="k">if</span> <span class="n">status</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-54">            <span class="n">status</span> <span class="o">=</span> <span class="s2">&quot;ok&quot;</span>
-</span><span id="1-55">        <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">=</span> <span class="n">status</span>
-</span><span id="1-56">        <span class="bp">self</span><span class="o">.</span><span class="n">did</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[str]</span>
-</span><span id="1-57">        <span class="bp">self</span><span class="o">.</span><span class="n">started</span> <span class="o">=</span> <span class="n">started</span>
-</span><span id="1-58">        <span class="bp">self</span><span class="o">.</span><span class="n">release</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[str]</span>
-</span><span id="1-59">        <span class="bp">self</span><span class="o">.</span><span class="n">environment</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[str]</span>
-</span><span id="1-60">        <span class="bp">self</span><span class="o">.</span><span class="n">duration</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[float]</span>
-</span><span id="1-61">        <span class="bp">self</span><span class="o">.</span><span class="n">user_agent</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[str]</span>
-</span><span id="1-62">        <span class="bp">self</span><span class="o">.</span><span class="n">ip_address</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[str]</span>
-</span><span id="1-63">        <span class="bp">self</span><span class="o">.</span><span class="n">session_mode</span> <span class="o">=</span> <span class="n">session_mode</span>  <span class="c1"># type: str</span>
-</span><span id="1-64">        <span class="bp">self</span><span class="o">.</span><span class="n">errors</span> <span class="o">=</span> <span class="mi">0</span>
-</span><span id="1-65">
-</span><span id="1-66">        <span class="bp">self</span><span class="o">.</span><span class="n">update</span><span class="p">(</span>
-</span><span id="1-67">            <span class="n">sid</span><span class="o">=</span><span class="n">sid</span><span class="p">,</span>
-</span><span id="1-68">            <span class="n">did</span><span class="o">=</span><span class="n">did</span><span class="p">,</span>
-</span><span id="1-69">            <span class="n">timestamp</span><span class="o">=</span><span class="n">timestamp</span><span class="p">,</span>
-</span><span id="1-70">            <span class="n">duration</span><span class="o">=</span><span class="n">duration</span><span class="p">,</span>
-</span><span id="1-71">            <span class="n">release</span><span class="o">=</span><span class="n">release</span><span class="p">,</span>
-</span><span id="1-72">            <span class="n">environment</span><span class="o">=</span><span class="n">environment</span><span class="p">,</span>
-</span><span id="1-73">            <span class="n">user_agent</span><span class="o">=</span><span class="n">user_agent</span><span class="p">,</span>
-</span><span id="1-74">            <span class="n">ip_address</span><span class="o">=</span><span class="n">ip_address</span><span class="p">,</span>
-</span><span id="1-75">            <span class="n">errors</span><span class="o">=</span><span class="n">errors</span><span class="p">,</span>
-</span><span id="1-76">            <span class="n">user</span><span class="o">=</span><span class="n">user</span><span class="p">,</span>
-</span><span id="1-77">        <span class="p">)</span>
-</span><span id="1-78">
-</span><span id="1-79">    <span class="nd">@property</span>
-</span><span id="1-80">    <span class="k">def</span> <span class="nf">truncated_started</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-81">        <span class="c1"># type: (...) -&gt; datetime</span>
-</span><span id="1-82">        <span class="k">return</span> <span class="n">_minute_trunc</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">started</span><span class="p">)</span>
-</span><span id="1-83">
-</span><span id="1-84">    <span class="k">def</span> <span class="nf">update</span><span class="p">(</span>
-</span><span id="1-85">        <span class="bp">self</span><span class="p">,</span>
-</span><span id="1-86">        <span class="n">sid</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Union[str, uuid.UUID]]</span>
-</span><span id="1-87">        <span class="n">did</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
-</span><span id="1-88">        <span class="n">timestamp</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[datetime]</span>
-</span><span id="1-89">        <span class="n">started</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[datetime]</span>
-</span><span id="1-90">        <span class="n">duration</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[float]</span>
-</span><span id="1-91">        <span class="n">status</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[SessionStatus]</span>
-</span><span id="1-92">        <span class="n">release</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
-</span><span id="1-93">        <span class="n">environment</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
-</span><span id="1-94">        <span class="n">user_agent</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
-</span><span id="1-95">        <span class="n">ip_address</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
-</span><span id="1-96">        <span class="n">errors</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[int]</span>
-</span><span id="1-97">        <span class="n">user</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Any]</span>
-</span><span id="1-98">    <span class="p">):</span>
-</span><span id="1-99">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-100">        <span class="c1"># If a user is supplied we pull some data form it</span>
-</span><span id="1-101">        <span class="k">if</span> <span class="n">user</span><span class="p">:</span>
-</span><span id="1-102">            <span class="k">if</span> <span class="n">ip_address</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-103">                <span class="n">ip_address</span> <span class="o">=</span> <span class="n">user</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;ip_address&quot;</span><span class="p">)</span>
-</span><span id="1-104">            <span class="k">if</span> <span class="n">did</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-105">                <span class="n">did</span> <span class="o">=</span> <span class="n">user</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;id&quot;</span><span class="p">)</span> <span class="ow">or</span> <span class="n">user</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;email&quot;</span><span class="p">)</span> <span class="ow">or</span> <span class="n">user</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;username&quot;</span><span class="p">)</span>
-</span><span id="1-106">
-</span><span id="1-107">        <span class="k">if</span> <span class="n">sid</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-108">            <span class="bp">self</span><span class="o">.</span><span class="n">sid</span> <span class="o">=</span> <span class="n">_make_uuid</span><span class="p">(</span><span class="n">sid</span><span class="p">)</span>
-</span><span id="1-109">        <span class="k">if</span> <span class="n">did</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-110">            <span class="bp">self</span><span class="o">.</span><span class="n">did</span> <span class="o">=</span> <span class="nb">str</span><span class="p">(</span><span class="n">did</span><span class="p">)</span>
-</span><span id="1-111">        <span class="k">if</span> <span class="n">timestamp</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-112">            <span class="n">timestamp</span> <span class="o">=</span> <span class="n">datetime_utcnow</span><span class="p">()</span>
-</span><span id="1-113">        <span class="bp">self</span><span class="o">.</span><span class="n">timestamp</span> <span class="o">=</span> <span class="n">timestamp</span>
-</span><span id="1-114">        <span class="k">if</span> <span class="n">started</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-115">            <span class="bp">self</span><span class="o">.</span><span class="n">started</span> <span class="o">=</span> <span class="n">started</span>
-</span><span id="1-116">        <span class="k">if</span> <span class="n">duration</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-117">            <span class="bp">self</span><span class="o">.</span><span class="n">duration</span> <span class="o">=</span> <span class="n">duration</span>
-</span><span id="1-118">        <span class="k">if</span> <span class="n">release</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-119">            <span class="bp">self</span><span class="o">.</span><span class="n">release</span> <span class="o">=</span> <span class="n">release</span>
-</span><span id="1-120">        <span class="k">if</span> <span class="n">environment</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-121">            <span class="bp">self</span><span class="o">.</span><span class="n">environment</span> <span class="o">=</span> <span class="n">environment</span>
-</span><span id="1-122">        <span class="k">if</span> <span class="n">ip_address</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-123">            <span class="bp">self</span><span class="o">.</span><span class="n">ip_address</span> <span class="o">=</span> <span class="n">ip_address</span>
-</span><span id="1-124">        <span class="k">if</span> <span class="n">user_agent</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-125">            <span class="bp">self</span><span class="o">.</span><span class="n">user_agent</span> <span class="o">=</span> <span class="n">user_agent</span>
-</span><span id="1-126">        <span class="k">if</span> <span class="n">errors</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-127">            <span class="bp">self</span><span class="o">.</span><span class="n">errors</span> <span class="o">=</span> <span class="n">errors</span>
-</span><span id="1-128">
-</span><span id="1-129">        <span class="k">if</span> <span class="n">status</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-130">            <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">=</span> <span class="n">status</span>
-</span><span id="1-131">
-</span><span id="1-132">    <span class="k">def</span> <span class="nf">close</span><span class="p">(</span>
-</span><span id="1-133">        <span class="bp">self</span><span class="p">,</span> <span class="n">status</span><span class="o">=</span><span class="kc">None</span>  <span class="c1"># type: Optional[SessionStatus]</span>
-</span><span id="1-134">    <span class="p">):</span>
-</span><span id="1-135">        <span class="c1"># type: (...) -&gt; Any</span>
-</span><span id="1-136">        <span class="k">if</span> <span class="n">status</span> <span class="ow">is</span> <span class="kc">None</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">==</span> <span class="s2">&quot;ok&quot;</span><span class="p">:</span>
-</span><span id="1-137">            <span class="n">status</span> <span class="o">=</span> <span class="s2">&quot;exited&quot;</span>
-</span><span id="1-138">        <span class="k">if</span> <span class="n">status</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-139">            <span class="bp">self</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">status</span><span class="o">=</span><span class="n">status</span><span class="p">)</span>
-</span><span id="1-140">
-</span><span id="1-141">    <span class="k">def</span> <span class="nf">get_json_attrs</span><span class="p">(</span>
-</span><span id="1-142">        <span class="bp">self</span><span class="p">,</span> <span class="n">with_user_info</span><span class="o">=</span><span class="kc">True</span>  <span class="c1"># type: Optional[bool]</span>
-</span><span id="1-143">    <span class="p">):</span>
-</span><span id="1-144">        <span class="c1"># type: (...) -&gt; Any</span>
-</span><span id="1-145">        <span class="n">attrs</span> <span class="o">=</span> <span class="p">{}</span>
-</span><span id="1-146">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">release</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-147">            <span class="n">attrs</span><span class="p">[</span><span class="s2">&quot;release&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">release</span>
-</span><span id="1-148">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">environment</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-149">            <span class="n">attrs</span><span class="p">[</span><span class="s2">&quot;environment&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">environment</span>
-</span><span id="1-150">        <span class="k">if</span> <span class="n">with_user_info</span><span class="p">:</span>
-</span><span id="1-151">            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">ip_address</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-152">                <span class="n">attrs</span><span class="p">[</span><span class="s2">&quot;ip_address&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">ip_address</span>
-</span><span id="1-153">            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">user_agent</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-154">                <span class="n">attrs</span><span class="p">[</span><span class="s2">&quot;user_agent&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">user_agent</span>
-</span><span id="1-155">        <span class="k">return</span> <span class="n">attrs</span>
-</span><span id="1-156">
-</span><span id="1-157">    <span class="k">def</span> <span class="nf">to_json</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-158">        <span class="c1"># type: (...) -&gt; Any</span>
-</span><span id="1-159">        <span class="n">rv</span> <span class="o">=</span> <span class="p">{</span>
-</span><span id="1-160">            <span class="s2">&quot;sid&quot;</span><span class="p">:</span> <span class="nb">str</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">sid</span><span class="p">),</span>
-</span><span id="1-161">            <span class="s2">&quot;init&quot;</span><span class="p">:</span> <span class="kc">True</span><span class="p">,</span>
-</span><span id="1-162">            <span class="s2">&quot;started&quot;</span><span class="p">:</span> <span class="n">format_timestamp</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">started</span><span class="p">),</span>
-</span><span id="1-163">            <span class="s2">&quot;timestamp&quot;</span><span class="p">:</span> <span class="n">format_timestamp</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">timestamp</span><span class="p">),</span>
-</span><span id="1-164">            <span class="s2">&quot;status&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">status</span><span class="p">,</span>
-</span><span id="1-165">        <span class="p">}</span>  <span class="c1"># type: Dict[str, Any]</span>
-</span><span id="1-166">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">errors</span><span class="p">:</span>
-</span><span id="1-167">            <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;errors&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">errors</span>
-</span><span id="1-168">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">did</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-169">            <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;did&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">did</span>
-</span><span id="1-170">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">duration</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-171">            <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;duration&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">duration</span>
-</span><span id="1-172">        <span class="n">attrs</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_json_attrs</span><span class="p">()</span>
-</span><span id="1-173">        <span class="k">if</span> <span class="n">attrs</span><span class="p">:</span>
-</span><span id="1-174">            <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;attrs&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">attrs</span>
-</span><span id="1-175">        <span class="k">return</span> <span class="n">rv</span></div>
+</span><span id="1-30"><span class="k">class</span> <span class="nc">Session</span><span class="p">:</span>
+</span><span id="1-31">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
+</span><span id="1-32">        <span class="bp">self</span><span class="p">,</span>
+</span><span id="1-33">        <span class="n">sid</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Union[str, uuid.UUID]]</span>
+</span><span id="1-34">        <span class="n">did</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
+</span><span id="1-35">        <span class="n">timestamp</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[datetime]</span>
+</span><span id="1-36">        <span class="n">started</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[datetime]</span>
+</span><span id="1-37">        <span class="n">duration</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[float]</span>
+</span><span id="1-38">        <span class="n">status</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[SessionStatus]</span>
+</span><span id="1-39">        <span class="n">release</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
+</span><span id="1-40">        <span class="n">environment</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
+</span><span id="1-41">        <span class="n">user_agent</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
+</span><span id="1-42">        <span class="n">ip_address</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
+</span><span id="1-43">        <span class="n">errors</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[int]</span>
+</span><span id="1-44">        <span class="n">user</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Any]</span>
+</span><span id="1-45">        <span class="n">session_mode</span><span class="o">=</span><span class="s2">&quot;application&quot;</span><span class="p">,</span>  <span class="c1"># type: str</span>
+</span><span id="1-46">    <span class="p">):</span>
+</span><span id="1-47">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-48">        <span class="k">if</span> <span class="n">sid</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-49">            <span class="n">sid</span> <span class="o">=</span> <span class="n">uuid</span><span class="o">.</span><span class="n">uuid4</span><span class="p">()</span>
+</span><span id="1-50">        <span class="k">if</span> <span class="n">started</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-51">            <span class="n">started</span> <span class="o">=</span> <span class="n">datetime</span><span class="o">.</span><span class="n">now</span><span class="p">(</span><span class="n">timezone</span><span class="o">.</span><span class="n">utc</span><span class="p">)</span>
+</span><span id="1-52">        <span class="k">if</span> <span class="n">status</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-53">            <span class="n">status</span> <span class="o">=</span> <span class="s2">&quot;ok&quot;</span>
+</span><span id="1-54">        <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">=</span> <span class="n">status</span>
+</span><span id="1-55">        <span class="bp">self</span><span class="o">.</span><span class="n">did</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[str]</span>
+</span><span id="1-56">        <span class="bp">self</span><span class="o">.</span><span class="n">started</span> <span class="o">=</span> <span class="n">started</span>
+</span><span id="1-57">        <span class="bp">self</span><span class="o">.</span><span class="n">release</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[str]</span>
+</span><span id="1-58">        <span class="bp">self</span><span class="o">.</span><span class="n">environment</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[str]</span>
+</span><span id="1-59">        <span class="bp">self</span><span class="o">.</span><span class="n">duration</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[float]</span>
+</span><span id="1-60">        <span class="bp">self</span><span class="o">.</span><span class="n">user_agent</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[str]</span>
+</span><span id="1-61">        <span class="bp">self</span><span class="o">.</span><span class="n">ip_address</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[str]</span>
+</span><span id="1-62">        <span class="bp">self</span><span class="o">.</span><span class="n">session_mode</span> <span class="o">=</span> <span class="n">session_mode</span>  <span class="c1"># type: str</span>
+</span><span id="1-63">        <span class="bp">self</span><span class="o">.</span><span class="n">errors</span> <span class="o">=</span> <span class="mi">0</span>
+</span><span id="1-64">
+</span><span id="1-65">        <span class="bp">self</span><span class="o">.</span><span class="n">update</span><span class="p">(</span>
+</span><span id="1-66">            <span class="n">sid</span><span class="o">=</span><span class="n">sid</span><span class="p">,</span>
+</span><span id="1-67">            <span class="n">did</span><span class="o">=</span><span class="n">did</span><span class="p">,</span>
+</span><span id="1-68">            <span class="n">timestamp</span><span class="o">=</span><span class="n">timestamp</span><span class="p">,</span>
+</span><span id="1-69">            <span class="n">duration</span><span class="o">=</span><span class="n">duration</span><span class="p">,</span>
+</span><span id="1-70">            <span class="n">release</span><span class="o">=</span><span class="n">release</span><span class="p">,</span>
+</span><span id="1-71">            <span class="n">environment</span><span class="o">=</span><span class="n">environment</span><span class="p">,</span>
+</span><span id="1-72">            <span class="n">user_agent</span><span class="o">=</span><span class="n">user_agent</span><span class="p">,</span>
+</span><span id="1-73">            <span class="n">ip_address</span><span class="o">=</span><span class="n">ip_address</span><span class="p">,</span>
+</span><span id="1-74">            <span class="n">errors</span><span class="o">=</span><span class="n">errors</span><span class="p">,</span>
+</span><span id="1-75">            <span class="n">user</span><span class="o">=</span><span class="n">user</span><span class="p">,</span>
+</span><span id="1-76">        <span class="p">)</span>
+</span><span id="1-77">
+</span><span id="1-78">    <span class="nd">@property</span>
+</span><span id="1-79">    <span class="k">def</span> <span class="nf">truncated_started</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-80">        <span class="c1"># type: (...) -&gt; datetime</span>
+</span><span id="1-81">        <span class="k">return</span> <span class="n">_minute_trunc</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">started</span><span class="p">)</span>
+</span><span id="1-82">
+</span><span id="1-83">    <span class="k">def</span> <span class="nf">update</span><span class="p">(</span>
+</span><span id="1-84">        <span class="bp">self</span><span class="p">,</span>
+</span><span id="1-85">        <span class="n">sid</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Union[str, uuid.UUID]]</span>
+</span><span id="1-86">        <span class="n">did</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
+</span><span id="1-87">        <span class="n">timestamp</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[datetime]</span>
+</span><span id="1-88">        <span class="n">started</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[datetime]</span>
+</span><span id="1-89">        <span class="n">duration</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[float]</span>
+</span><span id="1-90">        <span class="n">status</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[SessionStatus]</span>
+</span><span id="1-91">        <span class="n">release</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
+</span><span id="1-92">        <span class="n">environment</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
+</span><span id="1-93">        <span class="n">user_agent</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
+</span><span id="1-94">        <span class="n">ip_address</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
+</span><span id="1-95">        <span class="n">errors</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[int]</span>
+</span><span id="1-96">        <span class="n">user</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Any]</span>
+</span><span id="1-97">    <span class="p">):</span>
+</span><span id="1-98">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-99">        <span class="c1"># If a user is supplied we pull some data form it</span>
+</span><span id="1-100">        <span class="k">if</span> <span class="n">user</span><span class="p">:</span>
+</span><span id="1-101">            <span class="k">if</span> <span class="n">ip_address</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-102">                <span class="n">ip_address</span> <span class="o">=</span> <span class="n">user</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;ip_address&quot;</span><span class="p">)</span>
+</span><span id="1-103">            <span class="k">if</span> <span class="n">did</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-104">                <span class="n">did</span> <span class="o">=</span> <span class="n">user</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;id&quot;</span><span class="p">)</span> <span class="ow">or</span> <span class="n">user</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;email&quot;</span><span class="p">)</span> <span class="ow">or</span> <span class="n">user</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;username&quot;</span><span class="p">)</span>
+</span><span id="1-105">
+</span><span id="1-106">        <span class="k">if</span> <span class="n">sid</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-107">            <span class="bp">self</span><span class="o">.</span><span class="n">sid</span> <span class="o">=</span> <span class="n">_make_uuid</span><span class="p">(</span><span class="n">sid</span><span class="p">)</span>
+</span><span id="1-108">        <span class="k">if</span> <span class="n">did</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-109">            <span class="bp">self</span><span class="o">.</span><span class="n">did</span> <span class="o">=</span> <span class="nb">str</span><span class="p">(</span><span class="n">did</span><span class="p">)</span>
+</span><span id="1-110">        <span class="k">if</span> <span class="n">timestamp</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-111">            <span class="n">timestamp</span> <span class="o">=</span> <span class="n">datetime</span><span class="o">.</span><span class="n">now</span><span class="p">(</span><span class="n">timezone</span><span class="o">.</span><span class="n">utc</span><span class="p">)</span>
+</span><span id="1-112">        <span class="bp">self</span><span class="o">.</span><span class="n">timestamp</span> <span class="o">=</span> <span class="n">timestamp</span>
+</span><span id="1-113">        <span class="k">if</span> <span class="n">started</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-114">            <span class="bp">self</span><span class="o">.</span><span class="n">started</span> <span class="o">=</span> <span class="n">started</span>
+</span><span id="1-115">        <span class="k">if</span> <span class="n">duration</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-116">            <span class="bp">self</span><span class="o">.</span><span class="n">duration</span> <span class="o">=</span> <span class="n">duration</span>
+</span><span id="1-117">        <span class="k">if</span> <span class="n">release</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-118">            <span class="bp">self</span><span class="o">.</span><span class="n">release</span> <span class="o">=</span> <span class="n">release</span>
+</span><span id="1-119">        <span class="k">if</span> <span class="n">environment</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-120">            <span class="bp">self</span><span class="o">.</span><span class="n">environment</span> <span class="o">=</span> <span class="n">environment</span>
+</span><span id="1-121">        <span class="k">if</span> <span class="n">ip_address</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-122">            <span class="bp">self</span><span class="o">.</span><span class="n">ip_address</span> <span class="o">=</span> <span class="n">ip_address</span>
+</span><span id="1-123">        <span class="k">if</span> <span class="n">user_agent</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-124">            <span class="bp">self</span><span class="o">.</span><span class="n">user_agent</span> <span class="o">=</span> <span class="n">user_agent</span>
+</span><span id="1-125">        <span class="k">if</span> <span class="n">errors</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-126">            <span class="bp">self</span><span class="o">.</span><span class="n">errors</span> <span class="o">=</span> <span class="n">errors</span>
+</span><span id="1-127">
+</span><span id="1-128">        <span class="k">if</span> <span class="n">status</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-129">            <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">=</span> <span class="n">status</span>
+</span><span id="1-130">
+</span><span id="1-131">    <span class="k">def</span> <span class="nf">close</span><span class="p">(</span>
+</span><span id="1-132">        <span class="bp">self</span><span class="p">,</span> <span class="n">status</span><span class="o">=</span><span class="kc">None</span>  <span class="c1"># type: Optional[SessionStatus]</span>
+</span><span id="1-133">    <span class="p">):</span>
+</span><span id="1-134">        <span class="c1"># type: (...) -&gt; Any</span>
+</span><span id="1-135">        <span class="k">if</span> <span class="n">status</span> <span class="ow">is</span> <span class="kc">None</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">==</span> <span class="s2">&quot;ok&quot;</span><span class="p">:</span>
+</span><span id="1-136">            <span class="n">status</span> <span class="o">=</span> <span class="s2">&quot;exited&quot;</span>
+</span><span id="1-137">        <span class="k">if</span> <span class="n">status</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-138">            <span class="bp">self</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">status</span><span class="o">=</span><span class="n">status</span><span class="p">)</span>
+</span><span id="1-139">
+</span><span id="1-140">    <span class="k">def</span> <span class="nf">get_json_attrs</span><span class="p">(</span>
+</span><span id="1-141">        <span class="bp">self</span><span class="p">,</span> <span class="n">with_user_info</span><span class="o">=</span><span class="kc">True</span>  <span class="c1"># type: Optional[bool]</span>
+</span><span id="1-142">    <span class="p">):</span>
+</span><span id="1-143">        <span class="c1"># type: (...) -&gt; Any</span>
+</span><span id="1-144">        <span class="n">attrs</span> <span class="o">=</span> <span class="p">{}</span>
+</span><span id="1-145">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">release</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-146">            <span class="n">attrs</span><span class="p">[</span><span class="s2">&quot;release&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">release</span>
+</span><span id="1-147">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">environment</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-148">            <span class="n">attrs</span><span class="p">[</span><span class="s2">&quot;environment&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">environment</span>
+</span><span id="1-149">        <span class="k">if</span> <span class="n">with_user_info</span><span class="p">:</span>
+</span><span id="1-150">            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">ip_address</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-151">                <span class="n">attrs</span><span class="p">[</span><span class="s2">&quot;ip_address&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">ip_address</span>
+</span><span id="1-152">            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">user_agent</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-153">                <span class="n">attrs</span><span class="p">[</span><span class="s2">&quot;user_agent&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">user_agent</span>
+</span><span id="1-154">        <span class="k">return</span> <span class="n">attrs</span>
+</span><span id="1-155">
+</span><span id="1-156">    <span class="k">def</span> <span class="nf">to_json</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-157">        <span class="c1"># type: (...) -&gt; Any</span>
+</span><span id="1-158">        <span class="n">rv</span> <span class="o">=</span> <span class="p">{</span>
+</span><span id="1-159">            <span class="s2">&quot;sid&quot;</span><span class="p">:</span> <span class="nb">str</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">sid</span><span class="p">),</span>
+</span><span id="1-160">            <span class="s2">&quot;init&quot;</span><span class="p">:</span> <span class="kc">True</span><span class="p">,</span>
+</span><span id="1-161">            <span class="s2">&quot;started&quot;</span><span class="p">:</span> <span class="n">format_timestamp</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">started</span><span class="p">),</span>
+</span><span id="1-162">            <span class="s2">&quot;timestamp&quot;</span><span class="p">:</span> <span class="n">format_timestamp</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">timestamp</span><span class="p">),</span>
+</span><span id="1-163">            <span class="s2">&quot;status&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">status</span><span class="p">,</span>
+</span><span id="1-164">        <span class="p">}</span>  <span class="c1"># type: Dict[str, Any]</span>
+</span><span id="1-165">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">errors</span><span class="p">:</span>
+</span><span id="1-166">            <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;errors&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">errors</span>
+</span><span id="1-167">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">did</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-168">            <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;did&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">did</span>
+</span><span id="1-169">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">duration</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-170">            <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;duration&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">duration</span>
+</span><span id="1-171">        <span class="n">attrs</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_json_attrs</span><span class="p">()</span>
+</span><span id="1-172">        <span class="k">if</span> <span class="n">attrs</span><span class="p">:</span>
+</span><span id="1-173">            <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;attrs&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">attrs</span>
+</span><span id="1-174">        <span class="k">return</span> <span class="n">rv</span></div>
 
 </span></pre></div>
         </article>
@@ -342,7 +341,7 @@ <h1>Source code for sentry_sdk.session</h1><div class="highlight"><pre>
     </div>
   </div>
 </footer></div>
-      <script src="../../_static/documentation_options.js?v=fca6d697"></script>
+      <script src="../../_static/documentation_options.js?v=aa9da443"></script>
       <script src="../../_static/doctools.js?v=888ff710"></script>
       <script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
       <script src="../../_static/shibuya.js?v=999236dc"></script>
diff --git a/_modules/sentry_sdk/tracing.html b/_modules/sentry_sdk/tracing.html
index 40ff796881..17c0871bd8 100644
--- a/_modules/sentry_sdk/tracing.html
+++ b/_modules/sentry_sdk/tracing.html
@@ -4,7 +4,7 @@
 <head>
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-      <title>sentry_sdk.tracing - sentry-python 1.44.1 documentation</title>
+      <title>sentry_sdk.tracing - sentry-python 2.0.0rc4 documentation</title>
     <link rel="index" title="Index" href="../../genindex.html" /><link rel="search" title="Search" href="../../search.html" />
 
   <script>
@@ -134,1116 +134,1156 @@
           <h1>Source code for sentry_sdk.tracing</h1><div class="highlight"><pre>
 <span></span><span id="1-1"><span class="kn">import</span> <span class="nn">uuid</span>
 </span><span id="1-2"><span class="kn">import</span> <span class="nn">random</span>
-</span><span id="1-3">
-</span><span id="1-4"><span class="kn">from</span> <span class="nn">datetime</span> <span class="kn">import</span> <span class="n">datetime</span><span class="p">,</span> <span class="n">timedelta</span>
-</span><span id="1-5">
-</span><span id="1-6"><span class="kn">import</span> <span class="nn">sentry_sdk</span>
-</span><span id="1-7"><span class="kn">from</span> <span class="nn">sentry_sdk.consts</span> <span class="kn">import</span> <span class="n">INSTRUMENTER</span>
-</span><span id="1-8"><span class="kn">from</span> <span class="nn">sentry_sdk.utils</span> <span class="kn">import</span> <span class="p">(</span>
-</span><span id="1-9">    <span class="n">get_current_thread_meta</span><span class="p">,</span>
-</span><span id="1-10">    <span class="n">is_valid_sample_rate</span><span class="p">,</span>
-</span><span id="1-11">    <span class="n">logger</span><span class="p">,</span>
-</span><span id="1-12">    <span class="n">nanosecond_time</span><span class="p">,</span>
-</span><span id="1-13"><span class="p">)</span>
-</span><span id="1-14"><span class="kn">from</span> <span class="nn">sentry_sdk._compat</span> <span class="kn">import</span> <span class="n">datetime_utcnow</span><span class="p">,</span> <span class="n">utc_from_timestamp</span><span class="p">,</span> <span class="n">PY2</span>
-</span><span id="1-15"><span class="kn">from</span> <span class="nn">sentry_sdk.consts</span> <span class="kn">import</span> <span class="n">SPANDATA</span>
-</span><span id="1-16"><span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="n">TYPE_CHECKING</span>
-</span><span id="1-17">
-</span><span id="1-18">
-</span><span id="1-19"><span class="k">if</span> <span class="n">TYPE_CHECKING</span><span class="p">:</span>
-</span><span id="1-20">    <span class="kn">import</span> <span class="nn">typing</span>
-</span><span id="1-21">
-</span><span id="1-22">    <span class="kn">from</span> <span class="nn">collections.abc</span> <span class="kn">import</span> <span class="n">Callable</span><span class="p">,</span> <span class="n">MutableMapping</span>
-</span><span id="1-23">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Any</span>
-</span><span id="1-24">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Dict</span>
-</span><span id="1-25">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Iterator</span>
-</span><span id="1-26">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">List</span>
-</span><span id="1-27">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Optional</span>
-</span><span id="1-28">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">overload</span>
-</span><span id="1-29">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">ParamSpec</span>
-</span><span id="1-30">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Tuple</span>
-</span><span id="1-31">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Union</span>
-</span><span id="1-32">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">TypeVar</span>
+</span><span id="1-3"><span class="kn">from</span> <span class="nn">datetime</span> <span class="kn">import</span> <span class="n">datetime</span><span class="p">,</span> <span class="n">timedelta</span><span class="p">,</span> <span class="n">timezone</span>
+</span><span id="1-4">
+</span><span id="1-5"><span class="kn">import</span> <span class="nn">sentry_sdk</span>
+</span><span id="1-6"><span class="kn">from</span> <span class="nn">sentry_sdk.consts</span> <span class="kn">import</span> <span class="n">INSTRUMENTER</span><span class="p">,</span> <span class="n">SPANDATA</span>
+</span><span id="1-7"><span class="kn">from</span> <span class="nn">sentry_sdk.utils</span> <span class="kn">import</span> <span class="p">(</span>
+</span><span id="1-8">    <span class="n">get_current_thread_meta</span><span class="p">,</span>
+</span><span id="1-9">    <span class="n">is_valid_sample_rate</span><span class="p">,</span>
+</span><span id="1-10">    <span class="n">logger</span><span class="p">,</span>
+</span><span id="1-11">    <span class="n">nanosecond_time</span><span class="p">,</span>
+</span><span id="1-12"><span class="p">)</span>
+</span><span id="1-13"><span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="n">TYPE_CHECKING</span>
+</span><span id="1-14">
+</span><span id="1-15">
+</span><span id="1-16"><span class="k">if</span> <span class="n">TYPE_CHECKING</span><span class="p">:</span>
+</span><span id="1-17">    <span class="kn">from</span> <span class="nn">collections.abc</span> <span class="kn">import</span> <span class="n">Callable</span><span class="p">,</span> <span class="n">Mapping</span><span class="p">,</span> <span class="n">MutableMapping</span>
+</span><span id="1-18">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Any</span>
+</span><span id="1-19">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Dict</span>
+</span><span id="1-20">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Iterator</span>
+</span><span id="1-21">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">List</span>
+</span><span id="1-22">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Optional</span>
+</span><span id="1-23">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">overload</span>
+</span><span id="1-24">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">ParamSpec</span>
+</span><span id="1-25">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Tuple</span>
+</span><span id="1-26">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Union</span>
+</span><span id="1-27">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">TypeVar</span>
+</span><span id="1-28">
+</span><span id="1-29">    <span class="kn">from</span> <span class="nn">typing_extensions</span> <span class="kn">import</span> <span class="n">TypedDict</span><span class="p">,</span> <span class="n">Unpack</span>
+</span><span id="1-30">
+</span><span id="1-31">    <span class="n">P</span> <span class="o">=</span> <span class="n">ParamSpec</span><span class="p">(</span><span class="s2">&quot;P&quot;</span><span class="p">)</span>
+</span><span id="1-32">    <span class="n">R</span> <span class="o">=</span> <span class="n">TypeVar</span><span class="p">(</span><span class="s2">&quot;R&quot;</span><span class="p">)</span>
 </span><span id="1-33">
-</span><span id="1-34">    <span class="n">P</span> <span class="o">=</span> <span class="n">ParamSpec</span><span class="p">(</span><span class="s2">&quot;P&quot;</span><span class="p">)</span>
-</span><span id="1-35">    <span class="n">R</span> <span class="o">=</span> <span class="n">TypeVar</span><span class="p">(</span><span class="s2">&quot;R&quot;</span><span class="p">)</span>
+</span><span id="1-34">    <span class="kn">import</span> <span class="nn">sentry_sdk.profiler</span>
+</span><span id="1-35">    <span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="n">Event</span><span class="p">,</span> <span class="n">MeasurementUnit</span><span class="p">,</span> <span class="n">SamplingContext</span>
 </span><span id="1-36">
-</span><span id="1-37">    <span class="kn">import</span> <span class="nn">sentry_sdk.profiler</span>
-</span><span id="1-38">    <span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="n">Event</span><span class="p">,</span> <span class="n">MeasurementUnit</span><span class="p">,</span> <span class="n">SamplingContext</span>
-</span><span id="1-39">
-</span><span id="1-40">
-</span><span id="1-41"><span class="n">BAGGAGE_HEADER_NAME</span> <span class="o">=</span> <span class="s2">&quot;baggage&quot;</span>
-</span><span id="1-42"><span class="n">SENTRY_TRACE_HEADER_NAME</span> <span class="o">=</span> <span class="s2">&quot;sentry-trace&quot;</span>
+</span><span id="1-37">    <span class="k">class</span> <span class="nc">SpanKwargs</span><span class="p">(</span><span class="n">TypedDict</span><span class="p">,</span> <span class="n">total</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
+</span><span id="1-38">        <span class="n">trace_id</span><span class="p">:</span> <span class="nb">str</span>
+</span><span id="1-39"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-40"><span class="sd">        The trace ID of the root span. If this new span is to be the root span,</span>
+</span><span id="1-41"><span class="sd">        omit this parameter, and a new trace ID will be generated.</span>
+</span><span id="1-42"><span class="sd">        &quot;&quot;&quot;</span>
 </span><span id="1-43">
-</span><span id="1-44">
-</span><span id="1-45"><span class="c1"># Transaction source</span>
-</span><span id="1-46"><span class="c1"># see https://develop.sentry.dev/sdk/event-payloads/transaction/#transaction-annotations</span>
-</span><span id="1-47"><span class="n">TRANSACTION_SOURCE_CUSTOM</span> <span class="o">=</span> <span class="s2">&quot;custom&quot;</span>
-</span><span id="1-48"><span class="n">TRANSACTION_SOURCE_URL</span> <span class="o">=</span> <span class="s2">&quot;url&quot;</span>
-</span><span id="1-49"><span class="n">TRANSACTION_SOURCE_ROUTE</span> <span class="o">=</span> <span class="s2">&quot;route&quot;</span>
-</span><span id="1-50"><span class="n">TRANSACTION_SOURCE_VIEW</span> <span class="o">=</span> <span class="s2">&quot;view&quot;</span>
-</span><span id="1-51"><span class="n">TRANSACTION_SOURCE_COMPONENT</span> <span class="o">=</span> <span class="s2">&quot;component&quot;</span>
-</span><span id="1-52"><span class="n">TRANSACTION_SOURCE_TASK</span> <span class="o">=</span> <span class="s2">&quot;task&quot;</span>
-</span><span id="1-53">
-</span><span id="1-54"><span class="c1"># These are typically high cardinality and the server hates them</span>
-</span><span id="1-55"><span class="n">LOW_QUALITY_TRANSACTION_SOURCES</span> <span class="o">=</span> <span class="p">[</span>
-</span><span id="1-56">    <span class="n">TRANSACTION_SOURCE_URL</span><span class="p">,</span>
-</span><span id="1-57"><span class="p">]</span>
+</span><span id="1-44">        <span class="n">span_id</span><span class="p">:</span> <span class="nb">str</span>
+</span><span id="1-45"><span class="w">        </span><span class="sd">&quot;&quot;&quot;The span ID of this span. If omitted, a new span ID will be generated.&quot;&quot;&quot;</span>
+</span><span id="1-46">
+</span><span id="1-47">        <span class="n">parent_span_id</span><span class="p">:</span> <span class="nb">str</span>
+</span><span id="1-48"><span class="w">        </span><span class="sd">&quot;&quot;&quot;The span ID of the parent span, if applicable.&quot;&quot;&quot;</span>
+</span><span id="1-49">
+</span><span id="1-50">        <span class="n">same_process_as_parent</span><span class="p">:</span> <span class="nb">bool</span>
+</span><span id="1-51"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Whether this span is in the same process as the parent span.&quot;&quot;&quot;</span>
+</span><span id="1-52">
+</span><span id="1-53">        <span class="n">sampled</span><span class="p">:</span> <span class="nb">bool</span>
+</span><span id="1-54"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-55"><span class="sd">        Whether the span should be sampled. Overrides the default sampling decision</span>
+</span><span id="1-56"><span class="sd">        for this span when provided.</span>
+</span><span id="1-57"><span class="sd">        &quot;&quot;&quot;</span>
 </span><span id="1-58">
-</span><span id="1-59"><span class="n">SOURCE_FOR_STYLE</span> <span class="o">=</span> <span class="p">{</span>
-</span><span id="1-60">    <span class="s2">&quot;endpoint&quot;</span><span class="p">:</span> <span class="n">TRANSACTION_SOURCE_COMPONENT</span><span class="p">,</span>
-</span><span id="1-61">    <span class="s2">&quot;function_name&quot;</span><span class="p">:</span> <span class="n">TRANSACTION_SOURCE_COMPONENT</span><span class="p">,</span>
-</span><span id="1-62">    <span class="s2">&quot;handler_name&quot;</span><span class="p">:</span> <span class="n">TRANSACTION_SOURCE_COMPONENT</span><span class="p">,</span>
-</span><span id="1-63">    <span class="s2">&quot;method_and_path_pattern&quot;</span><span class="p">:</span> <span class="n">TRANSACTION_SOURCE_ROUTE</span><span class="p">,</span>
-</span><span id="1-64">    <span class="s2">&quot;path&quot;</span><span class="p">:</span> <span class="n">TRANSACTION_SOURCE_URL</span><span class="p">,</span>
-</span><span id="1-65">    <span class="s2">&quot;route_name&quot;</span><span class="p">:</span> <span class="n">TRANSACTION_SOURCE_COMPONENT</span><span class="p">,</span>
-</span><span id="1-66">    <span class="s2">&quot;route_pattern&quot;</span><span class="p">:</span> <span class="n">TRANSACTION_SOURCE_ROUTE</span><span class="p">,</span>
-</span><span id="1-67">    <span class="s2">&quot;uri_template&quot;</span><span class="p">:</span> <span class="n">TRANSACTION_SOURCE_ROUTE</span><span class="p">,</span>
-</span><span id="1-68">    <span class="s2">&quot;url&quot;</span><span class="p">:</span> <span class="n">TRANSACTION_SOURCE_ROUTE</span><span class="p">,</span>
-</span><span id="1-69"><span class="p">}</span>
+</span><span id="1-59">        <span class="n">op</span><span class="p">:</span> <span class="nb">str</span>
+</span><span id="1-60"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-61"><span class="sd">        The span&#39;s operation. A list of recommended values is available here:</span>
+</span><span id="1-62"><span class="sd">        https://develop.sentry.dev/sdk/performance/span-operations/</span>
+</span><span id="1-63"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-64">
+</span><span id="1-65">        <span class="n">description</span><span class="p">:</span> <span class="nb">str</span>
+</span><span id="1-66"><span class="w">        </span><span class="sd">&quot;&quot;&quot;A description of what operation is being performed within the span.&quot;&quot;&quot;</span>
+</span><span id="1-67">
+</span><span id="1-68">        <span class="n">hub</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="s2">&quot;sentry_sdk.Hub&quot;</span><span class="p">]</span>
+</span><span id="1-69"><span class="w">        </span><span class="sd">&quot;&quot;&quot;The hub to use for this span. This argument is DEPRECATED. Please use the `scope` parameter, instead.&quot;&quot;&quot;</span>
 </span><span id="1-70">
-</span><span id="1-71">
-</span><span id="1-72"><span class="k">class</span> <span class="nc">_SpanRecorder</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-</span><span id="1-73"><span class="w">    </span><span class="sd">&quot;&quot;&quot;Limits the number of spans recorded in a transaction.&quot;&quot;&quot;</span>
-</span><span id="1-74">
-</span><span id="1-75">    <span class="vm">__slots__</span> <span class="o">=</span> <span class="p">(</span><span class="s2">&quot;maxlen&quot;</span><span class="p">,</span> <span class="s2">&quot;spans&quot;</span><span class="p">)</span>
+</span><span id="1-71">        <span class="n">status</span><span class="p">:</span> <span class="nb">str</span>
+</span><span id="1-72"><span class="w">        </span><span class="sd">&quot;&quot;&quot;The span&#39;s status. Possible values are listed at https://develop.sentry.dev/sdk/event-payloads/span/&quot;&quot;&quot;</span>
+</span><span id="1-73">
+</span><span id="1-74">        <span class="n">containing_transaction</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="s2">&quot;Transaction&quot;</span><span class="p">]</span>
+</span><span id="1-75"><span class="w">        </span><span class="sd">&quot;&quot;&quot;The transaction that this span belongs to.&quot;&quot;&quot;</span>
 </span><span id="1-76">
-</span><span id="1-77">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">maxlen</span><span class="p">):</span>
-</span><span id="1-78">        <span class="c1"># type: (int) -&gt; None</span>
-</span><span id="1-79">        <span class="c1"># FIXME: this is `maxlen - 1` only to preserve historical behavior</span>
-</span><span id="1-80">        <span class="c1"># enforced by tests.</span>
-</span><span id="1-81">        <span class="c1"># Either this should be changed to `maxlen` or the JS SDK implementation</span>
-</span><span id="1-82">        <span class="c1"># should be changed to match a consistent interpretation of what maxlen</span>
-</span><span id="1-83">        <span class="c1"># limits: either transaction+spans or only child spans.</span>
-</span><span id="1-84">        <span class="bp">self</span><span class="o">.</span><span class="n">maxlen</span> <span class="o">=</span> <span class="n">maxlen</span> <span class="o">-</span> <span class="mi">1</span>
-</span><span id="1-85">        <span class="bp">self</span><span class="o">.</span><span class="n">spans</span> <span class="o">=</span> <span class="p">[]</span>  <span class="c1"># type: List[Span]</span>
-</span><span id="1-86">
-</span><span id="1-87">    <span class="k">def</span> <span class="nf">add</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">span</span><span class="p">):</span>
-</span><span id="1-88">        <span class="c1"># type: (Span) -&gt; None</span>
-</span><span id="1-89">        <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">spans</span><span class="p">)</span> <span class="o">&gt;</span> <span class="bp">self</span><span class="o">.</span><span class="n">maxlen</span><span class="p">:</span>
-</span><span id="1-90">            <span class="n">span</span><span class="o">.</span><span class="n">_span_recorder</span> <span class="o">=</span> <span class="kc">None</span>
-</span><span id="1-91">        <span class="k">else</span><span class="p">:</span>
-</span><span id="1-92">            <span class="bp">self</span><span class="o">.</span><span class="n">spans</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">span</span><span class="p">)</span>
-</span><span id="1-93">
-</span><span id="1-94">
+</span><span id="1-77">        <span class="n">start_timestamp</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="n">datetime</span><span class="p">,</span> <span class="nb">float</span><span class="p">]]</span>
+</span><span id="1-78"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-79"><span class="sd">        The timestamp when the span started. If omitted, the current time</span>
+</span><span id="1-80"><span class="sd">        will be used.</span>
+</span><span id="1-81"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-82">
+</span><span id="1-83">        <span class="n">scope</span><span class="p">:</span> <span class="s2">&quot;sentry_sdk.Scope&quot;</span>
+</span><span id="1-84"><span class="w">        </span><span class="sd">&quot;&quot;&quot;The scope to use for this span. If not provided, we use the current scope.&quot;&quot;&quot;</span>
+</span><span id="1-85">
+</span><span id="1-86">    <span class="k">class</span> <span class="nc">TransactionKwargs</span><span class="p">(</span><span class="n">SpanKwargs</span><span class="p">,</span> <span class="n">total</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
+</span><span id="1-87">        <span class="n">name</span><span class="p">:</span> <span class="nb">str</span>
+</span><span id="1-88"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Identifier of the transaction. Will show up in the Sentry UI.&quot;&quot;&quot;</span>
+</span><span id="1-89">
+</span><span id="1-90">        <span class="n">source</span><span class="p">:</span> <span class="nb">str</span>
+</span><span id="1-91"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-92"><span class="sd">        A string describing the source of the transaction name. This will be used to determine the transaction&#39;s type.</span>
+</span><span id="1-93"><span class="sd">        See https://develop.sentry.dev/sdk/event-payloads/transaction/#transaction-annotations for more information.</span>
+</span><span id="1-94"><span class="sd">        Default &quot;custom&quot;.</span>
+</span><span id="1-95"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-96">
+</span><span id="1-97">        <span class="n">parent_sampled</span><span class="p">:</span> <span class="nb">bool</span>
+</span><span id="1-98"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Whether the parent transaction was sampled. If True this transaction will be kept, if False it will be discarded.&quot;&quot;&quot;</span>
+</span><span id="1-99">
+</span><span id="1-100">        <span class="n">baggage</span><span class="p">:</span> <span class="s2">&quot;Baggage&quot;</span>
+</span><span id="1-101"><span class="w">        </span><span class="sd">&quot;&quot;&quot;The W3C baggage header value. (see https://www.w3.org/TR/baggage/)&quot;&quot;&quot;</span>
+</span><span id="1-102">
+</span><span id="1-103">
+</span><span id="1-104"><span class="n">BAGGAGE_HEADER_NAME</span> <span class="o">=</span> <span class="s2">&quot;baggage&quot;</span>
+</span><span id="1-105"><span class="n">SENTRY_TRACE_HEADER_NAME</span> <span class="o">=</span> <span class="s2">&quot;sentry-trace&quot;</span>
+</span><span id="1-106">
+</span><span id="1-107">
+</span><span id="1-108"><span class="c1"># Transaction source</span>
+</span><span id="1-109"><span class="c1"># see https://develop.sentry.dev/sdk/event-payloads/transaction/#transaction-annotations</span>
+</span><span id="1-110"><span class="n">TRANSACTION_SOURCE_CUSTOM</span> <span class="o">=</span> <span class="s2">&quot;custom&quot;</span>
+</span><span id="1-111"><span class="n">TRANSACTION_SOURCE_URL</span> <span class="o">=</span> <span class="s2">&quot;url&quot;</span>
+</span><span id="1-112"><span class="n">TRANSACTION_SOURCE_ROUTE</span> <span class="o">=</span> <span class="s2">&quot;route&quot;</span>
+</span><span id="1-113"><span class="n">TRANSACTION_SOURCE_VIEW</span> <span class="o">=</span> <span class="s2">&quot;view&quot;</span>
+</span><span id="1-114"><span class="n">TRANSACTION_SOURCE_COMPONENT</span> <span class="o">=</span> <span class="s2">&quot;component&quot;</span>
+</span><span id="1-115"><span class="n">TRANSACTION_SOURCE_TASK</span> <span class="o">=</span> <span class="s2">&quot;task&quot;</span>
+</span><span id="1-116">
+</span><span id="1-117"><span class="c1"># These are typically high cardinality and the server hates them</span>
+</span><span id="1-118"><span class="n">LOW_QUALITY_TRANSACTION_SOURCES</span> <span class="o">=</span> <span class="p">[</span>
+</span><span id="1-119">    <span class="n">TRANSACTION_SOURCE_URL</span><span class="p">,</span>
+</span><span id="1-120"><span class="p">]</span>
+</span><span id="1-121">
+</span><span id="1-122"><span class="n">SOURCE_FOR_STYLE</span> <span class="o">=</span> <span class="p">{</span>
+</span><span id="1-123">    <span class="s2">&quot;endpoint&quot;</span><span class="p">:</span> <span class="n">TRANSACTION_SOURCE_COMPONENT</span><span class="p">,</span>
+</span><span id="1-124">    <span class="s2">&quot;function_name&quot;</span><span class="p">:</span> <span class="n">TRANSACTION_SOURCE_COMPONENT</span><span class="p">,</span>
+</span><span id="1-125">    <span class="s2">&quot;handler_name&quot;</span><span class="p">:</span> <span class="n">TRANSACTION_SOURCE_COMPONENT</span><span class="p">,</span>
+</span><span id="1-126">    <span class="s2">&quot;method_and_path_pattern&quot;</span><span class="p">:</span> <span class="n">TRANSACTION_SOURCE_ROUTE</span><span class="p">,</span>
+</span><span id="1-127">    <span class="s2">&quot;path&quot;</span><span class="p">:</span> <span class="n">TRANSACTION_SOURCE_URL</span><span class="p">,</span>
+</span><span id="1-128">    <span class="s2">&quot;route_name&quot;</span><span class="p">:</span> <span class="n">TRANSACTION_SOURCE_COMPONENT</span><span class="p">,</span>
+</span><span id="1-129">    <span class="s2">&quot;route_pattern&quot;</span><span class="p">:</span> <span class="n">TRANSACTION_SOURCE_ROUTE</span><span class="p">,</span>
+</span><span id="1-130">    <span class="s2">&quot;uri_template&quot;</span><span class="p">:</span> <span class="n">TRANSACTION_SOURCE_ROUTE</span><span class="p">,</span>
+</span><span id="1-131">    <span class="s2">&quot;url&quot;</span><span class="p">:</span> <span class="n">TRANSACTION_SOURCE_ROUTE</span><span class="p">,</span>
+</span><span id="1-132"><span class="p">}</span>
+</span><span id="1-133">
+</span><span id="1-134">
+</span><span id="1-135"><span class="k">class</span> <span class="nc">_SpanRecorder</span><span class="p">:</span>
+</span><span id="1-136"><span class="w">    </span><span class="sd">&quot;&quot;&quot;Limits the number of spans recorded in a transaction.&quot;&quot;&quot;</span>
+</span><span id="1-137">
+</span><span id="1-138">    <span class="vm">__slots__</span> <span class="o">=</span> <span class="p">(</span><span class="s2">&quot;maxlen&quot;</span><span class="p">,</span> <span class="s2">&quot;spans&quot;</span><span class="p">)</span>
+</span><span id="1-139">
+</span><span id="1-140">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">maxlen</span><span class="p">):</span>
+</span><span id="1-141">        <span class="c1"># type: (int) -&gt; None</span>
+</span><span id="1-142">        <span class="c1"># FIXME: this is `maxlen - 1` only to preserve historical behavior</span>
+</span><span id="1-143">        <span class="c1"># enforced by tests.</span>
+</span><span id="1-144">        <span class="c1"># Either this should be changed to `maxlen` or the JS SDK implementation</span>
+</span><span id="1-145">        <span class="c1"># should be changed to match a consistent interpretation of what maxlen</span>
+</span><span id="1-146">        <span class="c1"># limits: either transaction+spans or only child spans.</span>
+</span><span id="1-147">        <span class="bp">self</span><span class="o">.</span><span class="n">maxlen</span> <span class="o">=</span> <span class="n">maxlen</span> <span class="o">-</span> <span class="mi">1</span>
+</span><span id="1-148">        <span class="bp">self</span><span class="o">.</span><span class="n">spans</span> <span class="o">=</span> <span class="p">[]</span>  <span class="c1"># type: List[Span]</span>
+</span><span id="1-149">
+</span><span id="1-150">    <span class="k">def</span> <span class="nf">add</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">span</span><span class="p">):</span>
+</span><span id="1-151">        <span class="c1"># type: (Span) -&gt; None</span>
+</span><span id="1-152">        <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">spans</span><span class="p">)</span> <span class="o">&gt;</span> <span class="bp">self</span><span class="o">.</span><span class="n">maxlen</span><span class="p">:</span>
+</span><span id="1-153">            <span class="n">span</span><span class="o">.</span><span class="n">_span_recorder</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="1-154">        <span class="k">else</span><span class="p">:</span>
+</span><span id="1-155">            <span class="bp">self</span><span class="o">.</span><span class="n">spans</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">span</span><span class="p">)</span>
+</span><span id="1-156">
+</span><span id="1-157">
 <div class="viewcode-block" id="Span">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.tracing.Span">[docs]</a>
-</span><span id="1-95"><span class="k">class</span> <span class="nc">Span</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-</span><span id="1-96"><span class="w">    </span><span class="sd">&quot;&quot;&quot;A span holds timing information of a block of code.</span>
-</span><span id="1-97"><span class="sd">    Spans can have multiple child spans thus forming a span tree.&quot;&quot;&quot;</span>
-</span><span id="1-98">
-</span><span id="1-99">    <span class="vm">__slots__</span> <span class="o">=</span> <span class="p">(</span>
-</span><span id="1-100">        <span class="s2">&quot;trace_id&quot;</span><span class="p">,</span>
-</span><span id="1-101">        <span class="s2">&quot;span_id&quot;</span><span class="p">,</span>
-</span><span id="1-102">        <span class="s2">&quot;parent_span_id&quot;</span><span class="p">,</span>
-</span><span id="1-103">        <span class="s2">&quot;same_process_as_parent&quot;</span><span class="p">,</span>
-</span><span id="1-104">        <span class="s2">&quot;sampled&quot;</span><span class="p">,</span>
-</span><span id="1-105">        <span class="s2">&quot;op&quot;</span><span class="p">,</span>
-</span><span id="1-106">        <span class="s2">&quot;description&quot;</span><span class="p">,</span>
-</span><span id="1-107">        <span class="s2">&quot;start_timestamp&quot;</span><span class="p">,</span>
-</span><span id="1-108">        <span class="s2">&quot;_start_timestamp_monotonic_ns&quot;</span><span class="p">,</span>
-</span><span id="1-109">        <span class="s2">&quot;status&quot;</span><span class="p">,</span>
-</span><span id="1-110">        <span class="s2">&quot;timestamp&quot;</span><span class="p">,</span>
-</span><span id="1-111">        <span class="s2">&quot;_tags&quot;</span><span class="p">,</span>
-</span><span id="1-112">        <span class="s2">&quot;_data&quot;</span><span class="p">,</span>
-</span><span id="1-113">        <span class="s2">&quot;_span_recorder&quot;</span><span class="p">,</span>
-</span><span id="1-114">        <span class="s2">&quot;hub&quot;</span><span class="p">,</span>
-</span><span id="1-115">        <span class="s2">&quot;_context_manager_state&quot;</span><span class="p">,</span>
-</span><span id="1-116">        <span class="s2">&quot;_containing_transaction&quot;</span><span class="p">,</span>
-</span><span id="1-117">        <span class="s2">&quot;_local_aggregator&quot;</span><span class="p">,</span>
-</span><span id="1-118">    <span class="p">)</span>
-</span><span id="1-119">
-</span><span id="1-120">    <span class="k">def</span> <span class="fm">__new__</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-</span><span id="1-121">        <span class="c1"># type: (**Any) -&gt; Any</span>
-</span><span id="1-122"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-123"><span class="sd">        Backwards-compatible implementation of Span and Transaction</span>
-</span><span id="1-124"><span class="sd">        creation.</span>
-</span><span id="1-125"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-126">
-</span><span id="1-127">        <span class="c1"># TODO: consider removing this in a future release.</span>
-</span><span id="1-128">        <span class="c1"># This is for backwards compatibility with releases before Transaction</span>
-</span><span id="1-129">        <span class="c1"># existed, to allow for a smoother transition.</span>
-</span><span id="1-130">        <span class="k">if</span> <span class="s2">&quot;transaction&quot;</span> <span class="ow">in</span> <span class="n">kwargs</span><span class="p">:</span>
-</span><span id="1-131">            <span class="k">return</span> <span class="nb">object</span><span class="o">.</span><span class="fm">__new__</span><span class="p">(</span><span class="n">Transaction</span><span class="p">)</span>
-</span><span id="1-132">        <span class="k">return</span> <span class="nb">object</span><span class="o">.</span><span class="fm">__new__</span><span class="p">(</span><span class="bp">cls</span><span class="p">)</span>
-</span><span id="1-133">
-</span><span id="1-134">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
-</span><span id="1-135">        <span class="bp">self</span><span class="p">,</span>
-</span><span id="1-136">        <span class="n">trace_id</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
-</span><span id="1-137">        <span class="n">span_id</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
-</span><span id="1-138">        <span class="n">parent_span_id</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
-</span><span id="1-139">        <span class="n">same_process_as_parent</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span>  <span class="c1"># type: bool</span>
-</span><span id="1-140">        <span class="n">sampled</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[bool]</span>
-</span><span id="1-141">        <span class="n">op</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
-</span><span id="1-142">        <span class="n">description</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
-</span><span id="1-143">        <span class="n">hub</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[sentry_sdk.Hub]</span>
-</span><span id="1-144">        <span class="n">status</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
-</span><span id="1-145">        <span class="n">transaction</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str] # deprecated</span>
-</span><span id="1-146">        <span class="n">containing_transaction</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Transaction]</span>
-</span><span id="1-147">        <span class="n">start_timestamp</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Union[datetime, float]]</span>
-</span><span id="1-148">    <span class="p">):</span>
-</span><span id="1-149">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-150">        <span class="bp">self</span><span class="o">.</span><span class="n">trace_id</span> <span class="o">=</span> <span class="n">trace_id</span> <span class="ow">or</span> <span class="n">uuid</span><span class="o">.</span><span class="n">uuid4</span><span class="p">()</span><span class="o">.</span><span class="n">hex</span>
-</span><span id="1-151">        <span class="bp">self</span><span class="o">.</span><span class="n">span_id</span> <span class="o">=</span> <span class="n">span_id</span> <span class="ow">or</span> <span class="n">uuid</span><span class="o">.</span><span class="n">uuid4</span><span class="p">()</span><span class="o">.</span><span class="n">hex</span><span class="p">[</span><span class="mi">16</span><span class="p">:]</span>
-</span><span id="1-152">        <span class="bp">self</span><span class="o">.</span><span class="n">parent_span_id</span> <span class="o">=</span> <span class="n">parent_span_id</span>
-</span><span id="1-153">        <span class="bp">self</span><span class="o">.</span><span class="n">same_process_as_parent</span> <span class="o">=</span> <span class="n">same_process_as_parent</span>
-</span><span id="1-154">        <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span> <span class="o">=</span> <span class="n">sampled</span>
-</span><span id="1-155">        <span class="bp">self</span><span class="o">.</span><span class="n">op</span> <span class="o">=</span> <span class="n">op</span>
-</span><span id="1-156">        <span class="bp">self</span><span class="o">.</span><span class="n">description</span> <span class="o">=</span> <span class="n">description</span>
-</span><span id="1-157">        <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">=</span> <span class="n">status</span>
-</span><span id="1-158">        <span class="bp">self</span><span class="o">.</span><span class="n">hub</span> <span class="o">=</span> <span class="n">hub</span>
-</span><span id="1-159">        <span class="bp">self</span><span class="o">.</span><span class="n">_tags</span> <span class="o">=</span> <span class="p">{}</span>  <span class="c1"># type: MutableMapping[str, str]</span>
-</span><span id="1-160">        <span class="bp">self</span><span class="o">.</span><span class="n">_data</span> <span class="o">=</span> <span class="p">{}</span>  <span class="c1"># type: Dict[str, Any]</span>
-</span><span id="1-161">        <span class="bp">self</span><span class="o">.</span><span class="n">_containing_transaction</span> <span class="o">=</span> <span class="n">containing_transaction</span>
-</span><span id="1-162">        <span class="k">if</span> <span class="n">start_timestamp</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-163">            <span class="n">start_timestamp</span> <span class="o">=</span> <span class="n">datetime_utcnow</span><span class="p">()</span>
-</span><span id="1-164">        <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">start_timestamp</span><span class="p">,</span> <span class="nb">float</span><span class="p">):</span>
-</span><span id="1-165">            <span class="n">start_timestamp</span> <span class="o">=</span> <span class="n">utc_from_timestamp</span><span class="p">(</span><span class="n">start_timestamp</span><span class="p">)</span>
-</span><span id="1-166">        <span class="bp">self</span><span class="o">.</span><span class="n">start_timestamp</span> <span class="o">=</span> <span class="n">start_timestamp</span>
-</span><span id="1-167">        <span class="k">try</span><span class="p">:</span>
-</span><span id="1-168">            <span class="c1"># profiling depends on this value and requires that</span>
-</span><span id="1-169">            <span class="c1"># it is measured in nanoseconds</span>
-</span><span id="1-170">            <span class="bp">self</span><span class="o">.</span><span class="n">_start_timestamp_monotonic_ns</span> <span class="o">=</span> <span class="n">nanosecond_time</span><span class="p">()</span>
-</span><span id="1-171">        <span class="k">except</span> <span class="ne">AttributeError</span><span class="p">:</span>
-</span><span id="1-172">            <span class="k">pass</span>
+</span><span id="1-158"><span class="k">class</span> <span class="nc">Span</span><span class="p">:</span>
+</span><span id="1-159"><span class="w">    </span><span class="sd">&quot;&quot;&quot;A span holds timing information of a block of code.</span>
+</span><span id="1-160"><span class="sd">    Spans can have multiple child spans thus forming a span tree.</span>
+</span><span id="1-161">
+</span><span id="1-162"><span class="sd">    :param trace_id: The trace ID of the root span. If this new span is to be the root span,</span>
+</span><span id="1-163"><span class="sd">        omit this parameter, and a new trace ID will be generated.</span>
+</span><span id="1-164"><span class="sd">    :param span_id: The span ID of this span. If omitted, a new span ID will be generated.</span>
+</span><span id="1-165"><span class="sd">    :param parent_span_id: The span ID of the parent span, if applicable.</span>
+</span><span id="1-166"><span class="sd">    :param same_process_as_parent: Whether this span is in the same process as the parent span.</span>
+</span><span id="1-167"><span class="sd">    :param sampled: Whether the span should be sampled. Overrides the default sampling decision</span>
+</span><span id="1-168"><span class="sd">        for this span when provided.</span>
+</span><span id="1-169"><span class="sd">    :param op: The span&#39;s operation. A list of recommended values is available here:</span>
+</span><span id="1-170"><span class="sd">        https://develop.sentry.dev/sdk/performance/span-operations/</span>
+</span><span id="1-171"><span class="sd">    :param description: A description of what operation is being performed within the span.</span>
+</span><span id="1-172"><span class="sd">    :param hub: The hub to use for this span.</span>
 </span><span id="1-173">
-</span><span id="1-174">        <span class="c1">#: End timestamp of span</span>
-</span><span id="1-175">        <span class="bp">self</span><span class="o">.</span><span class="n">timestamp</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[datetime]</span>
-</span><span id="1-176">
-</span><span id="1-177">        <span class="bp">self</span><span class="o">.</span><span class="n">_span_recorder</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[_SpanRecorder]</span>
-</span><span id="1-178">        <span class="bp">self</span><span class="o">.</span><span class="n">_local_aggregator</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[LocalAggregator]</span>
-</span><span id="1-179">
-</span><span id="1-180">        <span class="n">thread_id</span><span class="p">,</span> <span class="n">thread_name</span> <span class="o">=</span> <span class="n">get_current_thread_meta</span><span class="p">()</span>
-</span><span id="1-181">        <span class="bp">self</span><span class="o">.</span><span class="n">set_thread</span><span class="p">(</span><span class="n">thread_id</span><span class="p">,</span> <span class="n">thread_name</span><span class="p">)</span>
-</span><span id="1-182">
-</span><span id="1-183">    <span class="c1"># TODO this should really live on the Transaction class rather than the Span</span>
-</span><span id="1-184">    <span class="c1"># class</span>
-</span><span id="1-185">    <span class="k">def</span> <span class="nf">init_span_recorder</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">maxlen</span><span class="p">):</span>
-</span><span id="1-186">        <span class="c1"># type: (int) -&gt; None</span>
-</span><span id="1-187">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_span_recorder</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-188">            <span class="bp">self</span><span class="o">.</span><span class="n">_span_recorder</span> <span class="o">=</span> <span class="n">_SpanRecorder</span><span class="p">(</span><span class="n">maxlen</span><span class="p">)</span>
-</span><span id="1-189">
-</span><span id="1-190">    <span class="k">def</span> <span class="nf">_get_local_aggregator</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-191">        <span class="c1"># type: (...) -&gt; LocalAggregator</span>
-</span><span id="1-192">        <span class="n">rv</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_local_aggregator</span>
-</span><span id="1-193">        <span class="k">if</span> <span class="n">rv</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-194">            <span class="n">rv</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_local_aggregator</span> <span class="o">=</span> <span class="n">LocalAggregator</span><span class="p">()</span>
-</span><span id="1-195">        <span class="k">return</span> <span class="n">rv</span>
-</span><span id="1-196">
-</span><span id="1-197">    <span class="k">def</span> <span class="fm">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-198">        <span class="c1"># type: () -&gt; str</span>
-</span><span id="1-199">        <span class="k">return</span> <span class="p">(</span>
-</span><span id="1-200">            <span class="s2">&quot;&lt;</span><span class="si">%s</span><span class="s2">(op=</span><span class="si">%r</span><span class="s2">, description:</span><span class="si">%r</span><span class="s2">, trace_id=</span><span class="si">%r</span><span class="s2">, span_id=</span><span class="si">%r</span><span class="s2">, parent_span_id=</span><span class="si">%r</span><span class="s2">, sampled=</span><span class="si">%r</span><span class="s2">)&gt;&quot;</span>
-</span><span id="1-201">            <span class="o">%</span> <span class="p">(</span>
-</span><span id="1-202">                <span class="bp">self</span><span class="o">.</span><span class="vm">__class__</span><span class="o">.</span><span class="vm">__name__</span><span class="p">,</span>
-</span><span id="1-203">                <span class="bp">self</span><span class="o">.</span><span class="n">op</span><span class="p">,</span>
-</span><span id="1-204">                <span class="bp">self</span><span class="o">.</span><span class="n">description</span><span class="p">,</span>
-</span><span id="1-205">                <span class="bp">self</span><span class="o">.</span><span class="n">trace_id</span><span class="p">,</span>
-</span><span id="1-206">                <span class="bp">self</span><span class="o">.</span><span class="n">span_id</span><span class="p">,</span>
-</span><span id="1-207">                <span class="bp">self</span><span class="o">.</span><span class="n">parent_span_id</span><span class="p">,</span>
-</span><span id="1-208">                <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span><span class="p">,</span>
-</span><span id="1-209">            <span class="p">)</span>
-</span><span id="1-210">        <span class="p">)</span>
-</span><span id="1-211">
-</span><span id="1-212">    <span class="k">def</span> <span class="fm">__enter__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-213">        <span class="c1"># type: () -&gt; Span</span>
-</span><span id="1-214">        <span class="n">hub</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">hub</span> <span class="ow">or</span> <span class="n">sentry_sdk</span><span class="o">.</span><span class="n">Hub</span><span class="o">.</span><span class="n">current</span>
-</span><span id="1-215">
-</span><span id="1-216">        <span class="n">_</span><span class="p">,</span> <span class="n">scope</span> <span class="o">=</span> <span class="n">hub</span><span class="o">.</span><span class="n">_stack</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span>
-</span><span id="1-217">        <span class="n">old_span</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">span</span>
-</span><span id="1-218">        <span class="n">scope</span><span class="o">.</span><span class="n">span</span> <span class="o">=</span> <span class="bp">self</span>
-</span><span id="1-219">        <span class="bp">self</span><span class="o">.</span><span class="n">_context_manager_state</span> <span class="o">=</span> <span class="p">(</span><span class="n">hub</span><span class="p">,</span> <span class="n">scope</span><span class="p">,</span> <span class="n">old_span</span><span class="p">)</span>
-</span><span id="1-220">        <span class="k">return</span> <span class="bp">self</span>
-</span><span id="1-221">
-</span><span id="1-222">    <span class="k">def</span> <span class="fm">__exit__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">ty</span><span class="p">,</span> <span class="n">value</span><span class="p">,</span> <span class="n">tb</span><span class="p">):</span>
-</span><span id="1-223">        <span class="c1"># type: (Optional[Any], Optional[Any], Optional[Any]) -&gt; None</span>
-</span><span id="1-224">        <span class="k">if</span> <span class="n">value</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-225">            <span class="bp">self</span><span class="o">.</span><span class="n">set_status</span><span class="p">(</span><span class="s2">&quot;internal_error&quot;</span><span class="p">)</span>
-</span><span id="1-226">
-</span><span id="1-227">        <span class="n">hub</span><span class="p">,</span> <span class="n">scope</span><span class="p">,</span> <span class="n">old_span</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_context_manager_state</span>
-</span><span id="1-228">        <span class="k">del</span> <span class="bp">self</span><span class="o">.</span><span class="n">_context_manager_state</span>
-</span><span id="1-229">
-</span><span id="1-230">        <span class="bp">self</span><span class="o">.</span><span class="n">finish</span><span class="p">(</span><span class="n">hub</span><span class="p">)</span>
-</span><span id="1-231">        <span class="n">scope</span><span class="o">.</span><span class="n">span</span> <span class="o">=</span> <span class="n">old_span</span>
-</span><span id="1-232">
-</span><span id="1-233">    <span class="nd">@property</span>
-</span><span id="1-234">    <span class="k">def</span> <span class="nf">containing_transaction</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-235">        <span class="c1"># type: () -&gt; Optional[Transaction]</span>
-</span><span id="1-236"><span class="w">        </span><span class="sd">&quot;&quot;&quot;The ``Transaction`` that this span belongs to.</span>
-</span><span id="1-237"><span class="sd">        The ``Transaction`` is the root of the span tree,</span>
-</span><span id="1-238"><span class="sd">        so one could also think of this ``Transaction`` as the &quot;root span&quot;.&quot;&quot;&quot;</span>
-</span><span id="1-239">
-</span><span id="1-240">        <span class="c1"># this is a getter rather than a regular attribute so that transactions</span>
-</span><span id="1-241">        <span class="c1"># can return `self` here instead (as a way to prevent them circularly</span>
-</span><span id="1-242">        <span class="c1"># referencing themselves)</span>
-</span><span id="1-243">        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_containing_transaction</span>
-</span><span id="1-244">
-<div class="viewcode-block" id="Span.start_child">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.tracing.Span.start_child">[docs]</a>
-</span><span id="1-245">    <span class="k">def</span> <span class="nf">start_child</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">instrumenter</span><span class="o">=</span><span class="n">INSTRUMENTER</span><span class="o">.</span><span class="n">SENTRY</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-</span><span id="1-246">        <span class="c1"># type: (str, **Any) -&gt; Span</span>
-</span><span id="1-247"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-248"><span class="sd">        Start a sub-span from the current span or transaction.</span>
+</span><span id="1-174"><span class="sd">        .. deprecated:: 2.0.0</span>
+</span><span id="1-175"><span class="sd">            Please use the `scope` parameter, instead.</span>
+</span><span id="1-176"><span class="sd">    :param status: The span&#39;s status. Possible values are listed at</span>
+</span><span id="1-177"><span class="sd">        https://develop.sentry.dev/sdk/event-payloads/span/</span>
+</span><span id="1-178"><span class="sd">    :param containing_transaction: The transaction that this span belongs to.</span>
+</span><span id="1-179"><span class="sd">    :param start_timestamp: The timestamp when the span started. If omitted, the current time</span>
+</span><span id="1-180"><span class="sd">        will be used.</span>
+</span><span id="1-181"><span class="sd">    :param scope: The scope to use for this span. If not provided, we use the current scope.</span>
+</span><span id="1-182"><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="1-183">
+</span><span id="1-184">    <span class="vm">__slots__</span> <span class="o">=</span> <span class="p">(</span>
+</span><span id="1-185">        <span class="s2">&quot;trace_id&quot;</span><span class="p">,</span>
+</span><span id="1-186">        <span class="s2">&quot;span_id&quot;</span><span class="p">,</span>
+</span><span id="1-187">        <span class="s2">&quot;parent_span_id&quot;</span><span class="p">,</span>
+</span><span id="1-188">        <span class="s2">&quot;same_process_as_parent&quot;</span><span class="p">,</span>
+</span><span id="1-189">        <span class="s2">&quot;sampled&quot;</span><span class="p">,</span>
+</span><span id="1-190">        <span class="s2">&quot;op&quot;</span><span class="p">,</span>
+</span><span id="1-191">        <span class="s2">&quot;description&quot;</span><span class="p">,</span>
+</span><span id="1-192">        <span class="s2">&quot;start_timestamp&quot;</span><span class="p">,</span>
+</span><span id="1-193">        <span class="s2">&quot;_start_timestamp_monotonic_ns&quot;</span><span class="p">,</span>
+</span><span id="1-194">        <span class="s2">&quot;status&quot;</span><span class="p">,</span>
+</span><span id="1-195">        <span class="s2">&quot;timestamp&quot;</span><span class="p">,</span>
+</span><span id="1-196">        <span class="s2">&quot;_tags&quot;</span><span class="p">,</span>
+</span><span id="1-197">        <span class="s2">&quot;_data&quot;</span><span class="p">,</span>
+</span><span id="1-198">        <span class="s2">&quot;_span_recorder&quot;</span><span class="p">,</span>
+</span><span id="1-199">        <span class="s2">&quot;hub&quot;</span><span class="p">,</span>
+</span><span id="1-200">        <span class="s2">&quot;_context_manager_state&quot;</span><span class="p">,</span>
+</span><span id="1-201">        <span class="s2">&quot;_containing_transaction&quot;</span><span class="p">,</span>
+</span><span id="1-202">        <span class="s2">&quot;_local_aggregator&quot;</span><span class="p">,</span>
+</span><span id="1-203">        <span class="s2">&quot;scope&quot;</span><span class="p">,</span>
+</span><span id="1-204">    <span class="p">)</span>
+</span><span id="1-205">
+</span><span id="1-206">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
+</span><span id="1-207">        <span class="bp">self</span><span class="p">,</span>
+</span><span id="1-208">        <span class="n">trace_id</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
+</span><span id="1-209">        <span class="n">span_id</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
+</span><span id="1-210">        <span class="n">parent_span_id</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
+</span><span id="1-211">        <span class="n">same_process_as_parent</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span>  <span class="c1"># type: bool</span>
+</span><span id="1-212">        <span class="n">sampled</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[bool]</span>
+</span><span id="1-213">        <span class="n">op</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
+</span><span id="1-214">        <span class="n">description</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
+</span><span id="1-215">        <span class="n">hub</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[sentry_sdk.Hub]  # deprecated</span>
+</span><span id="1-216">        <span class="n">status</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
+</span><span id="1-217">        <span class="n">containing_transaction</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Transaction]</span>
+</span><span id="1-218">        <span class="n">start_timestamp</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Union[datetime, float]]</span>
+</span><span id="1-219">        <span class="n">scope</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[sentry_sdk.Scope]</span>
+</span><span id="1-220">    <span class="p">):</span>
+</span><span id="1-221">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-222">        <span class="bp">self</span><span class="o">.</span><span class="n">trace_id</span> <span class="o">=</span> <span class="n">trace_id</span> <span class="ow">or</span> <span class="n">uuid</span><span class="o">.</span><span class="n">uuid4</span><span class="p">()</span><span class="o">.</span><span class="n">hex</span>
+</span><span id="1-223">        <span class="bp">self</span><span class="o">.</span><span class="n">span_id</span> <span class="o">=</span> <span class="n">span_id</span> <span class="ow">or</span> <span class="n">uuid</span><span class="o">.</span><span class="n">uuid4</span><span class="p">()</span><span class="o">.</span><span class="n">hex</span><span class="p">[</span><span class="mi">16</span><span class="p">:]</span>
+</span><span id="1-224">        <span class="bp">self</span><span class="o">.</span><span class="n">parent_span_id</span> <span class="o">=</span> <span class="n">parent_span_id</span>
+</span><span id="1-225">        <span class="bp">self</span><span class="o">.</span><span class="n">same_process_as_parent</span> <span class="o">=</span> <span class="n">same_process_as_parent</span>
+</span><span id="1-226">        <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span> <span class="o">=</span> <span class="n">sampled</span>
+</span><span id="1-227">        <span class="bp">self</span><span class="o">.</span><span class="n">op</span> <span class="o">=</span> <span class="n">op</span>
+</span><span id="1-228">        <span class="bp">self</span><span class="o">.</span><span class="n">description</span> <span class="o">=</span> <span class="n">description</span>
+</span><span id="1-229">        <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">=</span> <span class="n">status</span>
+</span><span id="1-230">        <span class="bp">self</span><span class="o">.</span><span class="n">hub</span> <span class="o">=</span> <span class="n">hub</span>
+</span><span id="1-231">        <span class="bp">self</span><span class="o">.</span><span class="n">scope</span> <span class="o">=</span> <span class="n">scope</span>
+</span><span id="1-232">        <span class="bp">self</span><span class="o">.</span><span class="n">_tags</span> <span class="o">=</span> <span class="p">{}</span>  <span class="c1"># type: MutableMapping[str, str]</span>
+</span><span id="1-233">        <span class="bp">self</span><span class="o">.</span><span class="n">_data</span> <span class="o">=</span> <span class="p">{}</span>  <span class="c1"># type: Dict[str, Any]</span>
+</span><span id="1-234">        <span class="bp">self</span><span class="o">.</span><span class="n">_containing_transaction</span> <span class="o">=</span> <span class="n">containing_transaction</span>
+</span><span id="1-235">        <span class="k">if</span> <span class="n">start_timestamp</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-236">            <span class="n">start_timestamp</span> <span class="o">=</span> <span class="n">datetime</span><span class="o">.</span><span class="n">now</span><span class="p">(</span><span class="n">timezone</span><span class="o">.</span><span class="n">utc</span><span class="p">)</span>
+</span><span id="1-237">        <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">start_timestamp</span><span class="p">,</span> <span class="nb">float</span><span class="p">):</span>
+</span><span id="1-238">            <span class="n">start_timestamp</span> <span class="o">=</span> <span class="n">datetime</span><span class="o">.</span><span class="n">fromtimestamp</span><span class="p">(</span><span class="n">start_timestamp</span><span class="p">,</span> <span class="n">timezone</span><span class="o">.</span><span class="n">utc</span><span class="p">)</span>
+</span><span id="1-239">        <span class="bp">self</span><span class="o">.</span><span class="n">start_timestamp</span> <span class="o">=</span> <span class="n">start_timestamp</span>
+</span><span id="1-240">        <span class="k">try</span><span class="p">:</span>
+</span><span id="1-241">            <span class="c1"># profiling depends on this value and requires that</span>
+</span><span id="1-242">            <span class="c1"># it is measured in nanoseconds</span>
+</span><span id="1-243">            <span class="bp">self</span><span class="o">.</span><span class="n">_start_timestamp_monotonic_ns</span> <span class="o">=</span> <span class="n">nanosecond_time</span><span class="p">()</span>
+</span><span id="1-244">        <span class="k">except</span> <span class="ne">AttributeError</span><span class="p">:</span>
+</span><span id="1-245">            <span class="k">pass</span>
+</span><span id="1-246">
+</span><span id="1-247">        <span class="c1">#: End timestamp of span</span>
+</span><span id="1-248">        <span class="bp">self</span><span class="o">.</span><span class="n">timestamp</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[datetime]</span>
 </span><span id="1-249">
-</span><span id="1-250"><span class="sd">        Takes the same arguments as the initializer of :py:class:`Span`. The</span>
-</span><span id="1-251"><span class="sd">        trace id, sampling decision, transaction pointer, and span recorder are</span>
-</span><span id="1-252"><span class="sd">        inherited from the current span/transaction.</span>
-</span><span id="1-253"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-254">        <span class="n">hub</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">hub</span> <span class="ow">or</span> <span class="n">sentry_sdk</span><span class="o">.</span><span class="n">Hub</span><span class="o">.</span><span class="n">current</span>
-</span><span id="1-255">        <span class="n">client</span> <span class="o">=</span> <span class="n">hub</span><span class="o">.</span><span class="n">client</span>
-</span><span id="1-256">        <span class="n">configuration_instrumenter</span> <span class="o">=</span> <span class="n">client</span> <span class="ow">and</span> <span class="n">client</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;instrumenter&quot;</span><span class="p">]</span>
-</span><span id="1-257">
-</span><span id="1-258">        <span class="k">if</span> <span class="n">instrumenter</span> <span class="o">!=</span> <span class="n">configuration_instrumenter</span><span class="p">:</span>
-</span><span id="1-259">            <span class="k">return</span> <span class="n">NoOpSpan</span><span class="p">()</span>
-</span><span id="1-260">
-</span><span id="1-261">        <span class="n">kwargs</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="s2">&quot;sampled&quot;</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span><span class="p">)</span>
+</span><span id="1-250">        <span class="bp">self</span><span class="o">.</span><span class="n">_span_recorder</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[_SpanRecorder]</span>
+</span><span id="1-251">        <span class="bp">self</span><span class="o">.</span><span class="n">_local_aggregator</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[LocalAggregator]</span>
+</span><span id="1-252">
+</span><span id="1-253">        <span class="n">thread_id</span><span class="p">,</span> <span class="n">thread_name</span> <span class="o">=</span> <span class="n">get_current_thread_meta</span><span class="p">()</span>
+</span><span id="1-254">        <span class="bp">self</span><span class="o">.</span><span class="n">set_thread</span><span class="p">(</span><span class="n">thread_id</span><span class="p">,</span> <span class="n">thread_name</span><span class="p">)</span>
+</span><span id="1-255">
+</span><span id="1-256">    <span class="c1"># TODO this should really live on the Transaction class rather than the Span</span>
+</span><span id="1-257">    <span class="c1"># class</span>
+</span><span id="1-258">    <span class="k">def</span> <span class="nf">init_span_recorder</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">maxlen</span><span class="p">):</span>
+</span><span id="1-259">        <span class="c1"># type: (int) -&gt; None</span>
+</span><span id="1-260">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_span_recorder</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-261">            <span class="bp">self</span><span class="o">.</span><span class="n">_span_recorder</span> <span class="o">=</span> <span class="n">_SpanRecorder</span><span class="p">(</span><span class="n">maxlen</span><span class="p">)</span>
 </span><span id="1-262">
-</span><span id="1-263">        <span class="n">child</span> <span class="o">=</span> <span class="n">Span</span><span class="p">(</span>
-</span><span id="1-264">            <span class="n">trace_id</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">trace_id</span><span class="p">,</span>
-</span><span id="1-265">            <span class="n">parent_span_id</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">span_id</span><span class="p">,</span>
-</span><span id="1-266">            <span class="n">containing_transaction</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">containing_transaction</span><span class="p">,</span>
-</span><span id="1-267">            <span class="o">**</span><span class="n">kwargs</span>
-</span><span id="1-268">        <span class="p">)</span>
+</span><span id="1-263">    <span class="k">def</span> <span class="nf">_get_local_aggregator</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-264">        <span class="c1"># type: (...) -&gt; LocalAggregator</span>
+</span><span id="1-265">        <span class="n">rv</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_local_aggregator</span>
+</span><span id="1-266">        <span class="k">if</span> <span class="n">rv</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-267">            <span class="n">rv</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_local_aggregator</span> <span class="o">=</span> <span class="n">LocalAggregator</span><span class="p">()</span>
+</span><span id="1-268">        <span class="k">return</span> <span class="n">rv</span>
 </span><span id="1-269">
-</span><span id="1-270">        <span class="n">span_recorder</span> <span class="o">=</span> <span class="p">(</span>
-</span><span id="1-271">            <span class="bp">self</span><span class="o">.</span><span class="n">containing_transaction</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">containing_transaction</span><span class="o">.</span><span class="n">_span_recorder</span>
-</span><span id="1-272">        <span class="p">)</span>
-</span><span id="1-273">        <span class="k">if</span> <span class="n">span_recorder</span><span class="p">:</span>
-</span><span id="1-274">            <span class="n">span_recorder</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">child</span><span class="p">)</span>
-</span><span id="1-275">
-</span><span id="1-276">        <span class="k">return</span> <span class="n">child</span></div>
-
-</span><span id="1-277">
-<div class="viewcode-block" id="Span.new_span">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.tracing.Span.new_span">[docs]</a>
-</span><span id="1-278">    <span class="k">def</span> <span class="nf">new_span</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-</span><span id="1-279">        <span class="c1"># type: (**Any) -&gt; Span</span>
-</span><span id="1-280"><span class="w">        </span><span class="sd">&quot;&quot;&quot;DEPRECATED: use :py:meth:`sentry_sdk.tracing.Span.start_child` instead.&quot;&quot;&quot;</span>
-</span><span id="1-281">        <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
-</span><span id="1-282">            <span class="s2">&quot;Deprecated: use Span.start_child instead of Span.new_span. This will be removed in the future.&quot;</span>
+</span><span id="1-270">    <span class="k">def</span> <span class="fm">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-271">        <span class="c1"># type: () -&gt; str</span>
+</span><span id="1-272">        <span class="k">return</span> <span class="p">(</span>
+</span><span id="1-273">            <span class="s2">&quot;&lt;</span><span class="si">%s</span><span class="s2">(op=</span><span class="si">%r</span><span class="s2">, description:</span><span class="si">%r</span><span class="s2">, trace_id=</span><span class="si">%r</span><span class="s2">, span_id=</span><span class="si">%r</span><span class="s2">, parent_span_id=</span><span class="si">%r</span><span class="s2">, sampled=</span><span class="si">%r</span><span class="s2">)&gt;&quot;</span>
+</span><span id="1-274">            <span class="o">%</span> <span class="p">(</span>
+</span><span id="1-275">                <span class="bp">self</span><span class="o">.</span><span class="vm">__class__</span><span class="o">.</span><span class="vm">__name__</span><span class="p">,</span>
+</span><span id="1-276">                <span class="bp">self</span><span class="o">.</span><span class="n">op</span><span class="p">,</span>
+</span><span id="1-277">                <span class="bp">self</span><span class="o">.</span><span class="n">description</span><span class="p">,</span>
+</span><span id="1-278">                <span class="bp">self</span><span class="o">.</span><span class="n">trace_id</span><span class="p">,</span>
+</span><span id="1-279">                <span class="bp">self</span><span class="o">.</span><span class="n">span_id</span><span class="p">,</span>
+</span><span id="1-280">                <span class="bp">self</span><span class="o">.</span><span class="n">parent_span_id</span><span class="p">,</span>
+</span><span id="1-281">                <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span><span class="p">,</span>
+</span><span id="1-282">            <span class="p">)</span>
 </span><span id="1-283">        <span class="p">)</span>
-</span><span id="1-284">        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">start_child</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></div>
+</span><span id="1-284">
+</span><span id="1-285">    <span class="k">def</span> <span class="fm">__enter__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-286">        <span class="c1"># type: () -&gt; Span</span>
+</span><span id="1-287">        <span class="n">scope</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">scope</span> <span class="ow">or</span> <span class="n">sentry_sdk</span><span class="o">.</span><span class="n">Scope</span><span class="o">.</span><span class="n">get_current_scope</span><span class="p">()</span>
+</span><span id="1-288">        <span class="n">old_span</span> <span class="o">=</span> <span class="n">scope</span><span class="o">.</span><span class="n">span</span>
+</span><span id="1-289">        <span class="n">scope</span><span class="o">.</span><span class="n">span</span> <span class="o">=</span> <span class="bp">self</span>
+</span><span id="1-290">        <span class="bp">self</span><span class="o">.</span><span class="n">_context_manager_state</span> <span class="o">=</span> <span class="p">(</span><span class="n">scope</span><span class="p">,</span> <span class="n">old_span</span><span class="p">)</span>
+</span><span id="1-291">        <span class="k">return</span> <span class="bp">self</span>
+</span><span id="1-292">
+</span><span id="1-293">    <span class="k">def</span> <span class="fm">__exit__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">ty</span><span class="p">,</span> <span class="n">value</span><span class="p">,</span> <span class="n">tb</span><span class="p">):</span>
+</span><span id="1-294">        <span class="c1"># type: (Optional[Any], Optional[Any], Optional[Any]) -&gt; None</span>
+</span><span id="1-295">        <span class="k">if</span> <span class="n">value</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-296">            <span class="bp">self</span><span class="o">.</span><span class="n">set_status</span><span class="p">(</span><span class="s2">&quot;internal_error&quot;</span><span class="p">)</span>
+</span><span id="1-297">
+</span><span id="1-298">        <span class="n">scope</span><span class="p">,</span> <span class="n">old_span</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_context_manager_state</span>
+</span><span id="1-299">        <span class="k">del</span> <span class="bp">self</span><span class="o">.</span><span class="n">_context_manager_state</span>
+</span><span id="1-300">        <span class="bp">self</span><span class="o">.</span><span class="n">finish</span><span class="p">(</span><span class="n">scope</span><span class="p">)</span>
+</span><span id="1-301">        <span class="n">scope</span><span class="o">.</span><span class="n">span</span> <span class="o">=</span> <span class="n">old_span</span>
+</span><span id="1-302">
+</span><span id="1-303">    <span class="nd">@property</span>
+</span><span id="1-304">    <span class="k">def</span> <span class="nf">containing_transaction</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-305">        <span class="c1"># type: () -&gt; Optional[Transaction]</span>
+</span><span id="1-306"><span class="w">        </span><span class="sd">&quot;&quot;&quot;The ``Transaction`` that this span belongs to.</span>
+</span><span id="1-307"><span class="sd">        The ``Transaction`` is the root of the span tree,</span>
+</span><span id="1-308"><span class="sd">        so one could also think of this ``Transaction`` as the &quot;root span&quot;.&quot;&quot;&quot;</span>
+</span><span id="1-309">
+</span><span id="1-310">        <span class="c1"># this is a getter rather than a regular attribute so that transactions</span>
+</span><span id="1-311">        <span class="c1"># can return `self` here instead (as a way to prevent them circularly</span>
+</span><span id="1-312">        <span class="c1"># referencing themselves)</span>
+</span><span id="1-313">        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_containing_transaction</span>
+</span><span id="1-314">
+<div class="viewcode-block" id="Span.start_child">
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.tracing.Span.start_child">[docs]</a>
+</span><span id="1-315">    <span class="k">def</span> <span class="nf">start_child</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">instrumenter</span><span class="o">=</span><span class="n">INSTRUMENTER</span><span class="o">.</span><span class="n">SENTRY</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
+</span><span id="1-316">        <span class="c1"># type: (str, **Any) -&gt; Span</span>
+</span><span id="1-317"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-318"><span class="sd">        Start a sub-span from the current span or transaction.</span>
+</span><span id="1-319">
+</span><span id="1-320"><span class="sd">        Takes the same arguments as the initializer of :py:class:`Span`. The</span>
+</span><span id="1-321"><span class="sd">        trace id, sampling decision, transaction pointer, and span recorder are</span>
+</span><span id="1-322"><span class="sd">        inherited from the current span/transaction.</span>
+</span><span id="1-323"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-324">        <span class="n">configuration_instrumenter</span> <span class="o">=</span> <span class="n">sentry_sdk</span><span class="o">.</span><span class="n">Scope</span><span class="o">.</span><span class="n">get_client</span><span class="p">()</span><span class="o">.</span><span class="n">options</span><span class="p">[</span>
+</span><span id="1-325">            <span class="s2">&quot;instrumenter&quot;</span>
+</span><span id="1-326">        <span class="p">]</span>
+</span><span id="1-327">
+</span><span id="1-328">        <span class="k">if</span> <span class="n">instrumenter</span> <span class="o">!=</span> <span class="n">configuration_instrumenter</span><span class="p">:</span>
+</span><span id="1-329">            <span class="k">return</span> <span class="n">NoOpSpan</span><span class="p">()</span>
+</span><span id="1-330">
+</span><span id="1-331">        <span class="n">kwargs</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="s2">&quot;sampled&quot;</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span><span class="p">)</span>
+</span><span id="1-332">
+</span><span id="1-333">        <span class="n">child</span> <span class="o">=</span> <span class="n">Span</span><span class="p">(</span>
+</span><span id="1-334">            <span class="n">trace_id</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">trace_id</span><span class="p">,</span>
+</span><span id="1-335">            <span class="n">parent_span_id</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">span_id</span><span class="p">,</span>
+</span><span id="1-336">            <span class="n">containing_transaction</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">containing_transaction</span><span class="p">,</span>
+</span><span id="1-337">            <span class="o">**</span><span class="n">kwargs</span><span class="p">,</span>
+</span><span id="1-338">        <span class="p">)</span>
+</span><span id="1-339">
+</span><span id="1-340">        <span class="n">span_recorder</span> <span class="o">=</span> <span class="p">(</span>
+</span><span id="1-341">            <span class="bp">self</span><span class="o">.</span><span class="n">containing_transaction</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">containing_transaction</span><span class="o">.</span><span class="n">_span_recorder</span>
+</span><span id="1-342">        <span class="p">)</span>
+</span><span id="1-343">        <span class="k">if</span> <span class="n">span_recorder</span><span class="p">:</span>
+</span><span id="1-344">            <span class="n">span_recorder</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">child</span><span class="p">)</span>
+</span><span id="1-345">
+</span><span id="1-346">        <span class="k">return</span> <span class="n">child</span></div>
 
-</span><span id="1-285">
+</span><span id="1-347">
 <div class="viewcode-block" id="Span.continue_from_environ">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.tracing.Span.continue_from_environ">[docs]</a>
-</span><span id="1-286">    <span class="nd">@classmethod</span>
-</span><span id="1-287">    <span class="k">def</span> <span class="nf">continue_from_environ</span><span class="p">(</span>
-</span><span id="1-288">        <span class="bp">cls</span><span class="p">,</span>
-</span><span id="1-289">        <span class="n">environ</span><span class="p">,</span>  <span class="c1"># type: typing.Mapping[str, str]</span>
-</span><span id="1-290">        <span class="o">**</span><span class="n">kwargs</span>  <span class="c1"># type: Any</span>
-</span><span id="1-291">    <span class="p">):</span>
-</span><span id="1-292">        <span class="c1"># type: (...) -&gt; Transaction</span>
-</span><span id="1-293"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-294"><span class="sd">        Create a Transaction with the given params, then add in data pulled from</span>
-</span><span id="1-295"><span class="sd">        the ``sentry-trace`` and ``baggage`` headers from the environ (if any)</span>
-</span><span id="1-296"><span class="sd">        before returning the Transaction.</span>
-</span><span id="1-297">
-</span><span id="1-298"><span class="sd">        This is different from :py:meth:`~sentry_sdk.tracing.Span.continue_from_headers`</span>
-</span><span id="1-299"><span class="sd">        in that it assumes header names in the form ``HTTP_HEADER_NAME`` -</span>
-</span><span id="1-300"><span class="sd">        such as you would get from a WSGI/ASGI environ -</span>
-</span><span id="1-301"><span class="sd">        rather than the form ``header-name``.</span>
-</span><span id="1-302">
-</span><span id="1-303"><span class="sd">        :param environ: The ASGI/WSGI environ to pull information from.</span>
-</span><span id="1-304"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-305">        <span class="k">if</span> <span class="bp">cls</span> <span class="ow">is</span> <span class="n">Span</span><span class="p">:</span>
-</span><span id="1-306">            <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
-</span><span id="1-307">                <span class="s2">&quot;Deprecated: use Transaction.continue_from_environ &quot;</span>
-</span><span id="1-308">                <span class="s2">&quot;instead of Span.continue_from_environ.&quot;</span>
-</span><span id="1-309">            <span class="p">)</span>
-</span><span id="1-310">        <span class="k">return</span> <span class="n">Transaction</span><span class="o">.</span><span class="n">continue_from_headers</span><span class="p">(</span><span class="n">EnvironHeaders</span><span class="p">(</span><span class="n">environ</span><span class="p">),</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></div>
+</span><span id="1-348">    <span class="nd">@classmethod</span>
+</span><span id="1-349">    <span class="k">def</span> <span class="nf">continue_from_environ</span><span class="p">(</span>
+</span><span id="1-350">        <span class="bp">cls</span><span class="p">,</span>
+</span><span id="1-351">        <span class="n">environ</span><span class="p">,</span>  <span class="c1"># type: Mapping[str, str]</span>
+</span><span id="1-352">        <span class="o">**</span><span class="n">kwargs</span><span class="p">,</span>  <span class="c1"># type: Any</span>
+</span><span id="1-353">    <span class="p">):</span>
+</span><span id="1-354">        <span class="c1"># type: (...) -&gt; Transaction</span>
+</span><span id="1-355"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-356"><span class="sd">        Create a Transaction with the given params, then add in data pulled from</span>
+</span><span id="1-357"><span class="sd">        the ``sentry-trace`` and ``baggage`` headers from the environ (if any)</span>
+</span><span id="1-358"><span class="sd">        before returning the Transaction.</span>
+</span><span id="1-359">
+</span><span id="1-360"><span class="sd">        This is different from :py:meth:`~sentry_sdk.tracing.Span.continue_from_headers`</span>
+</span><span id="1-361"><span class="sd">        in that it assumes header names in the form ``HTTP_HEADER_NAME`` -</span>
+</span><span id="1-362"><span class="sd">        such as you would get from a WSGI/ASGI environ -</span>
+</span><span id="1-363"><span class="sd">        rather than the form ``header-name``.</span>
+</span><span id="1-364">
+</span><span id="1-365"><span class="sd">        :param environ: The ASGI/WSGI environ to pull information from.</span>
+</span><span id="1-366"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-367">        <span class="k">if</span> <span class="bp">cls</span> <span class="ow">is</span> <span class="n">Span</span><span class="p">:</span>
+</span><span id="1-368">            <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
+</span><span id="1-369">                <span class="s2">&quot;Deprecated: use Transaction.continue_from_environ &quot;</span>
+</span><span id="1-370">                <span class="s2">&quot;instead of Span.continue_from_environ.&quot;</span>
+</span><span id="1-371">            <span class="p">)</span>
+</span><span id="1-372">        <span class="k">return</span> <span class="n">Transaction</span><span class="o">.</span><span class="n">continue_from_headers</span><span class="p">(</span><span class="n">EnvironHeaders</span><span class="p">(</span><span class="n">environ</span><span class="p">),</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></div>
 
-</span><span id="1-311">
+</span><span id="1-373">
 <div class="viewcode-block" id="Span.continue_from_headers">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.tracing.Span.continue_from_headers">[docs]</a>
-</span><span id="1-312">    <span class="nd">@classmethod</span>
-</span><span id="1-313">    <span class="k">def</span> <span class="nf">continue_from_headers</span><span class="p">(</span>
-</span><span id="1-314">        <span class="bp">cls</span><span class="p">,</span>
-</span><span id="1-315">        <span class="n">headers</span><span class="p">,</span>  <span class="c1"># type: typing.Mapping[str, str]</span>
-</span><span id="1-316">        <span class="o">**</span><span class="n">kwargs</span>  <span class="c1"># type: Any</span>
-</span><span id="1-317">    <span class="p">):</span>
-</span><span id="1-318">        <span class="c1"># type: (...) -&gt; Transaction</span>
-</span><span id="1-319"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-320"><span class="sd">        Create a transaction with the given params (including any data pulled from</span>
-</span><span id="1-321"><span class="sd">        the ``sentry-trace`` and ``baggage`` headers).</span>
-</span><span id="1-322">
-</span><span id="1-323"><span class="sd">        :param headers: The dictionary with the HTTP headers to pull information from.</span>
-</span><span id="1-324"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-325">        <span class="c1"># TODO move this to the Transaction class</span>
-</span><span id="1-326">        <span class="k">if</span> <span class="bp">cls</span> <span class="ow">is</span> <span class="n">Span</span><span class="p">:</span>
-</span><span id="1-327">            <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
-</span><span id="1-328">                <span class="s2">&quot;Deprecated: use Transaction.continue_from_headers &quot;</span>
-</span><span id="1-329">                <span class="s2">&quot;instead of Span.continue_from_headers.&quot;</span>
-</span><span id="1-330">            <span class="p">)</span>
-</span><span id="1-331">
-</span><span id="1-332">        <span class="c1"># TODO-neel move away from this kwargs stuff, it&#39;s confusing and opaque</span>
-</span><span id="1-333">        <span class="c1"># make more explicit</span>
-</span><span id="1-334">        <span class="n">baggage</span> <span class="o">=</span> <span class="n">Baggage</span><span class="o">.</span><span class="n">from_incoming_header</span><span class="p">(</span><span class="n">headers</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">BAGGAGE_HEADER_NAME</span><span class="p">))</span>
-</span><span id="1-335">        <span class="n">kwargs</span><span class="o">.</span><span class="n">update</span><span class="p">({</span><span class="n">BAGGAGE_HEADER_NAME</span><span class="p">:</span> <span class="n">baggage</span><span class="p">})</span>
-</span><span id="1-336">
-</span><span id="1-337">        <span class="n">sentrytrace_kwargs</span> <span class="o">=</span> <span class="n">extract_sentrytrace_data</span><span class="p">(</span>
-</span><span id="1-338">            <span class="n">headers</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">SENTRY_TRACE_HEADER_NAME</span><span class="p">)</span>
-</span><span id="1-339">        <span class="p">)</span>
-</span><span id="1-340">
-</span><span id="1-341">        <span class="k">if</span> <span class="n">sentrytrace_kwargs</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-342">            <span class="n">kwargs</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">sentrytrace_kwargs</span><span class="p">)</span>
-</span><span id="1-343">
-</span><span id="1-344">            <span class="c1"># If there&#39;s an incoming sentry-trace but no incoming baggage header,</span>
-</span><span id="1-345">            <span class="c1"># for instance in traces coming from older SDKs,</span>
-</span><span id="1-346">            <span class="c1"># baggage will be empty and immutable and won&#39;t be populated as head SDK.</span>
-</span><span id="1-347">            <span class="n">baggage</span><span class="o">.</span><span class="n">freeze</span><span class="p">()</span>
-</span><span id="1-348">
-</span><span id="1-349">        <span class="n">transaction</span> <span class="o">=</span> <span class="n">Transaction</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-</span><span id="1-350">        <span class="n">transaction</span><span class="o">.</span><span class="n">same_process_as_parent</span> <span class="o">=</span> <span class="kc">False</span>
-</span><span id="1-351">
-</span><span id="1-352">        <span class="k">return</span> <span class="n">transaction</span></div>
+</span><span id="1-374">    <span class="nd">@classmethod</span>
+</span><span id="1-375">    <span class="k">def</span> <span class="nf">continue_from_headers</span><span class="p">(</span>
+</span><span id="1-376">        <span class="bp">cls</span><span class="p">,</span>
+</span><span id="1-377">        <span class="n">headers</span><span class="p">,</span>  <span class="c1"># type: Mapping[str, str]</span>
+</span><span id="1-378">        <span class="o">**</span><span class="n">kwargs</span><span class="p">,</span>  <span class="c1"># type: Any</span>
+</span><span id="1-379">    <span class="p">):</span>
+</span><span id="1-380">        <span class="c1"># type: (...) -&gt; Transaction</span>
+</span><span id="1-381"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-382"><span class="sd">        Create a transaction with the given params (including any data pulled from</span>
+</span><span id="1-383"><span class="sd">        the ``sentry-trace`` and ``baggage`` headers).</span>
+</span><span id="1-384">
+</span><span id="1-385"><span class="sd">        :param headers: The dictionary with the HTTP headers to pull information from.</span>
+</span><span id="1-386"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-387">        <span class="c1"># TODO move this to the Transaction class</span>
+</span><span id="1-388">        <span class="k">if</span> <span class="bp">cls</span> <span class="ow">is</span> <span class="n">Span</span><span class="p">:</span>
+</span><span id="1-389">            <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
+</span><span id="1-390">                <span class="s2">&quot;Deprecated: use Transaction.continue_from_headers &quot;</span>
+</span><span id="1-391">                <span class="s2">&quot;instead of Span.continue_from_headers.&quot;</span>
+</span><span id="1-392">            <span class="p">)</span>
+</span><span id="1-393">
+</span><span id="1-394">        <span class="c1"># TODO-neel move away from this kwargs stuff, it&#39;s confusing and opaque</span>
+</span><span id="1-395">        <span class="c1"># make more explicit</span>
+</span><span id="1-396">        <span class="n">baggage</span> <span class="o">=</span> <span class="n">Baggage</span><span class="o">.</span><span class="n">from_incoming_header</span><span class="p">(</span><span class="n">headers</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">BAGGAGE_HEADER_NAME</span><span class="p">))</span>
+</span><span id="1-397">        <span class="n">kwargs</span><span class="o">.</span><span class="n">update</span><span class="p">({</span><span class="n">BAGGAGE_HEADER_NAME</span><span class="p">:</span> <span class="n">baggage</span><span class="p">})</span>
+</span><span id="1-398">
+</span><span id="1-399">        <span class="n">sentrytrace_kwargs</span> <span class="o">=</span> <span class="n">extract_sentrytrace_data</span><span class="p">(</span>
+</span><span id="1-400">            <span class="n">headers</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">SENTRY_TRACE_HEADER_NAME</span><span class="p">)</span>
+</span><span id="1-401">        <span class="p">)</span>
+</span><span id="1-402">
+</span><span id="1-403">        <span class="k">if</span> <span class="n">sentrytrace_kwargs</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-404">            <span class="n">kwargs</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">sentrytrace_kwargs</span><span class="p">)</span>
+</span><span id="1-405">
+</span><span id="1-406">            <span class="c1"># If there&#39;s an incoming sentry-trace but no incoming baggage header,</span>
+</span><span id="1-407">            <span class="c1"># for instance in traces coming from older SDKs,</span>
+</span><span id="1-408">            <span class="c1"># baggage will be empty and immutable and won&#39;t be populated as head SDK.</span>
+</span><span id="1-409">            <span class="n">baggage</span><span class="o">.</span><span class="n">freeze</span><span class="p">()</span>
+</span><span id="1-410">
+</span><span id="1-411">        <span class="n">transaction</span> <span class="o">=</span> <span class="n">Transaction</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+</span><span id="1-412">        <span class="n">transaction</span><span class="o">.</span><span class="n">same_process_as_parent</span> <span class="o">=</span> <span class="kc">False</span>
+</span><span id="1-413">
+</span><span id="1-414">        <span class="k">return</span> <span class="n">transaction</span></div>
 
-</span><span id="1-353">
+</span><span id="1-415">
 <div class="viewcode-block" id="Span.iter_headers">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.tracing.Span.iter_headers">[docs]</a>
-</span><span id="1-354">    <span class="k">def</span> <span class="nf">iter_headers</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-355">        <span class="c1"># type: () -&gt; Iterator[Tuple[str, str]]</span>
-</span><span id="1-356"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-357"><span class="sd">        Creates a generator which returns the span&#39;s ``sentry-trace`` and ``baggage`` headers.</span>
-</span><span id="1-358"><span class="sd">        If the span&#39;s containing transaction doesn&#39;t yet have a ``baggage`` value,</span>
-</span><span id="1-359"><span class="sd">        this will cause one to be generated and stored.</span>
-</span><span id="1-360"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-361">        <span class="k">yield</span> <span class="n">SENTRY_TRACE_HEADER_NAME</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">to_traceparent</span><span class="p">()</span>
-</span><span id="1-362">
-</span><span id="1-363">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">containing_transaction</span><span class="p">:</span>
-</span><span id="1-364">            <span class="n">baggage</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">containing_transaction</span><span class="o">.</span><span class="n">get_baggage</span><span class="p">()</span><span class="o">.</span><span class="n">serialize</span><span class="p">()</span>
-</span><span id="1-365">            <span class="k">if</span> <span class="n">baggage</span><span class="p">:</span>
-</span><span id="1-366">                <span class="k">yield</span> <span class="n">BAGGAGE_HEADER_NAME</span><span class="p">,</span> <span class="n">baggage</span></div>
+</span><span id="1-416">    <span class="k">def</span> <span class="nf">iter_headers</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-417">        <span class="c1"># type: () -&gt; Iterator[Tuple[str, str]]</span>
+</span><span id="1-418"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-419"><span class="sd">        Creates a generator which returns the span&#39;s ``sentry-trace`` and ``baggage`` headers.</span>
+</span><span id="1-420"><span class="sd">        If the span&#39;s containing transaction doesn&#39;t yet have a ``baggage`` value,</span>
+</span><span id="1-421"><span class="sd">        this will cause one to be generated and stored.</span>
+</span><span id="1-422"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-423">        <span class="k">yield</span> <span class="n">SENTRY_TRACE_HEADER_NAME</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">to_traceparent</span><span class="p">()</span>
+</span><span id="1-424">
+</span><span id="1-425">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">containing_transaction</span><span class="p">:</span>
+</span><span id="1-426">            <span class="n">baggage</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">containing_transaction</span><span class="o">.</span><span class="n">get_baggage</span><span class="p">()</span><span class="o">.</span><span class="n">serialize</span><span class="p">()</span>
+</span><span id="1-427">            <span class="k">if</span> <span class="n">baggage</span><span class="p">:</span>
+</span><span id="1-428">                <span class="k">yield</span> <span class="n">BAGGAGE_HEADER_NAME</span><span class="p">,</span> <span class="n">baggage</span></div>
 
-</span><span id="1-367">
+</span><span id="1-429">
 <div class="viewcode-block" id="Span.from_traceparent">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.tracing.Span.from_traceparent">[docs]</a>
-</span><span id="1-368">    <span class="nd">@classmethod</span>
-</span><span id="1-369">    <span class="k">def</span> <span class="nf">from_traceparent</span><span class="p">(</span>
-</span><span id="1-370">        <span class="bp">cls</span><span class="p">,</span>
-</span><span id="1-371">        <span class="n">traceparent</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
-</span><span id="1-372">        <span class="o">**</span><span class="n">kwargs</span>  <span class="c1"># type: Any</span>
-</span><span id="1-373">    <span class="p">):</span>
-</span><span id="1-374">        <span class="c1"># type: (...) -&gt; Optional[Transaction]</span>
-</span><span id="1-375"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-376"><span class="sd">        DEPRECATED: Use :py:meth:`sentry_sdk.tracing.Span.continue_from_headers`.</span>
-</span><span id="1-377">
-</span><span id="1-378"><span class="sd">        Create a ``Transaction`` with the given params, then add in data pulled from</span>
-</span><span id="1-379"><span class="sd">        the given ``sentry-trace`` header value before returning the ``Transaction``.</span>
-</span><span id="1-380"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-381">        <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
-</span><span id="1-382">            <span class="s2">&quot;Deprecated: Use Transaction.continue_from_headers(headers, **kwargs) &quot;</span>
-</span><span id="1-383">            <span class="s2">&quot;instead of from_traceparent(traceparent, **kwargs)&quot;</span>
-</span><span id="1-384">        <span class="p">)</span>
-</span><span id="1-385">
-</span><span id="1-386">        <span class="k">if</span> <span class="ow">not</span> <span class="n">traceparent</span><span class="p">:</span>
-</span><span id="1-387">            <span class="k">return</span> <span class="kc">None</span>
-</span><span id="1-388">
-</span><span id="1-389">        <span class="k">return</span> <span class="bp">cls</span><span class="o">.</span><span class="n">continue_from_headers</span><span class="p">(</span>
-</span><span id="1-390">            <span class="p">{</span><span class="n">SENTRY_TRACE_HEADER_NAME</span><span class="p">:</span> <span class="n">traceparent</span><span class="p">},</span> <span class="o">**</span><span class="n">kwargs</span>
-</span><span id="1-391">        <span class="p">)</span></div>
+</span><span id="1-430">    <span class="nd">@classmethod</span>
+</span><span id="1-431">    <span class="k">def</span> <span class="nf">from_traceparent</span><span class="p">(</span>
+</span><span id="1-432">        <span class="bp">cls</span><span class="p">,</span>
+</span><span id="1-433">        <span class="n">traceparent</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
+</span><span id="1-434">        <span class="o">**</span><span class="n">kwargs</span><span class="p">,</span>  <span class="c1"># type: Any</span>
+</span><span id="1-435">    <span class="p">):</span>
+</span><span id="1-436">        <span class="c1"># type: (...) -&gt; Optional[Transaction]</span>
+</span><span id="1-437"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-438"><span class="sd">        DEPRECATED: Use :py:meth:`sentry_sdk.tracing.Span.continue_from_headers`.</span>
+</span><span id="1-439">
+</span><span id="1-440"><span class="sd">        Create a ``Transaction`` with the given params, then add in data pulled from</span>
+</span><span id="1-441"><span class="sd">        the given ``sentry-trace`` header value before returning the ``Transaction``.</span>
+</span><span id="1-442"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-443">        <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
+</span><span id="1-444">            <span class="s2">&quot;Deprecated: Use Transaction.continue_from_headers(headers, **kwargs) &quot;</span>
+</span><span id="1-445">            <span class="s2">&quot;instead of from_traceparent(traceparent, **kwargs)&quot;</span>
+</span><span id="1-446">        <span class="p">)</span>
+</span><span id="1-447">
+</span><span id="1-448">        <span class="k">if</span> <span class="ow">not</span> <span class="n">traceparent</span><span class="p">:</span>
+</span><span id="1-449">            <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-450">
+</span><span id="1-451">        <span class="k">return</span> <span class="bp">cls</span><span class="o">.</span><span class="n">continue_from_headers</span><span class="p">(</span>
+</span><span id="1-452">            <span class="p">{</span><span class="n">SENTRY_TRACE_HEADER_NAME</span><span class="p">:</span> <span class="n">traceparent</span><span class="p">},</span> <span class="o">**</span><span class="n">kwargs</span>
+</span><span id="1-453">        <span class="p">)</span></div>
 
-</span><span id="1-392">
-</span><span id="1-393">    <span class="k">def</span> <span class="nf">to_traceparent</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-394">        <span class="c1"># type: () -&gt; str</span>
-</span><span id="1-395">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span> <span class="ow">is</span> <span class="kc">True</span><span class="p">:</span>
-</span><span id="1-396">            <span class="n">sampled</span> <span class="o">=</span> <span class="s2">&quot;1&quot;</span>
-</span><span id="1-397">        <span class="k">elif</span> <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span> <span class="ow">is</span> <span class="kc">False</span><span class="p">:</span>
-</span><span id="1-398">            <span class="n">sampled</span> <span class="o">=</span> <span class="s2">&quot;0&quot;</span>
-</span><span id="1-399">        <span class="k">else</span><span class="p">:</span>
-</span><span id="1-400">            <span class="n">sampled</span> <span class="o">=</span> <span class="kc">None</span>
-</span><span id="1-401">
-</span><span id="1-402">        <span class="n">traceparent</span> <span class="o">=</span> <span class="s2">&quot;</span><span class="si">%s</span><span class="s2">-</span><span class="si">%s</span><span class="s2">&quot;</span> <span class="o">%</span> <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">trace_id</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">span_id</span><span class="p">)</span>
-</span><span id="1-403">        <span class="k">if</span> <span class="n">sampled</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-404">            <span class="n">traceparent</span> <span class="o">+=</span> <span class="s2">&quot;-</span><span class="si">%s</span><span class="s2">&quot;</span> <span class="o">%</span> <span class="p">(</span><span class="n">sampled</span><span class="p">,)</span>
-</span><span id="1-405">
-</span><span id="1-406">        <span class="k">return</span> <span class="n">traceparent</span>
-</span><span id="1-407">
+</span><span id="1-454">
+</span><span id="1-455">    <span class="k">def</span> <span class="nf">to_traceparent</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-456">        <span class="c1"># type: () -&gt; str</span>
+</span><span id="1-457">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span> <span class="ow">is</span> <span class="kc">True</span><span class="p">:</span>
+</span><span id="1-458">            <span class="n">sampled</span> <span class="o">=</span> <span class="s2">&quot;1&quot;</span>
+</span><span id="1-459">        <span class="k">elif</span> <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span> <span class="ow">is</span> <span class="kc">False</span><span class="p">:</span>
+</span><span id="1-460">            <span class="n">sampled</span> <span class="o">=</span> <span class="s2">&quot;0&quot;</span>
+</span><span id="1-461">        <span class="k">else</span><span class="p">:</span>
+</span><span id="1-462">            <span class="n">sampled</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="1-463">
+</span><span id="1-464">        <span class="n">traceparent</span> <span class="o">=</span> <span class="s2">&quot;</span><span class="si">%s</span><span class="s2">-</span><span class="si">%s</span><span class="s2">&quot;</span> <span class="o">%</span> <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">trace_id</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">span_id</span><span class="p">)</span>
+</span><span id="1-465">        <span class="k">if</span> <span class="n">sampled</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-466">            <span class="n">traceparent</span> <span class="o">+=</span> <span class="s2">&quot;-</span><span class="si">%s</span><span class="s2">&quot;</span> <span class="o">%</span> <span class="p">(</span><span class="n">sampled</span><span class="p">,)</span>
+</span><span id="1-467">
+</span><span id="1-468">        <span class="k">return</span> <span class="n">traceparent</span>
+</span><span id="1-469">
 <div class="viewcode-block" id="Span.to_baggage">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.tracing.Span.to_baggage">[docs]</a>
-</span><span id="1-408">    <span class="k">def</span> <span class="nf">to_baggage</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-409">        <span class="c1"># type: () -&gt; Optional[Baggage]</span>
-</span><span id="1-410"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Returns the :py:class:`~sentry_sdk.tracing_utils.Baggage`</span>
-</span><span id="1-411"><span class="sd">        associated with this ``Span``, if any. (Taken from the root of the span tree.)</span>
-</span><span id="1-412"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-413">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">containing_transaction</span><span class="p">:</span>
-</span><span id="1-414">            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">containing_transaction</span><span class="o">.</span><span class="n">get_baggage</span><span class="p">()</span>
-</span><span id="1-415">        <span class="k">return</span> <span class="kc">None</span></div>
+</span><span id="1-470">    <span class="k">def</span> <span class="nf">to_baggage</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-471">        <span class="c1"># type: () -&gt; Optional[Baggage]</span>
+</span><span id="1-472"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Returns the :py:class:`~sentry_sdk.tracing_utils.Baggage`</span>
+</span><span id="1-473"><span class="sd">        associated with this ``Span``, if any. (Taken from the root of the span tree.)</span>
+</span><span id="1-474"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-475">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">containing_transaction</span><span class="p">:</span>
+</span><span id="1-476">            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">containing_transaction</span><span class="o">.</span><span class="n">get_baggage</span><span class="p">()</span>
+</span><span id="1-477">        <span class="k">return</span> <span class="kc">None</span></div>
 
-</span><span id="1-416">
-</span><span id="1-417">    <span class="k">def</span> <span class="nf">set_tag</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-</span><span id="1-418">        <span class="c1"># type: (str, Any) -&gt; None</span>
-</span><span id="1-419">        <span class="bp">self</span><span class="o">.</span><span class="n">_tags</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="o">=</span> <span class="n">value</span>
-</span><span id="1-420">
-</span><span id="1-421">    <span class="k">def</span> <span class="nf">set_data</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-</span><span id="1-422">        <span class="c1"># type: (str, Any) -&gt; None</span>
-</span><span id="1-423">        <span class="bp">self</span><span class="o">.</span><span class="n">_data</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="o">=</span> <span class="n">value</span>
-</span><span id="1-424">
-</span><span id="1-425">    <span class="k">def</span> <span class="nf">set_status</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-</span><span id="1-426">        <span class="c1"># type: (str) -&gt; None</span>
-</span><span id="1-427">        <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">=</span> <span class="n">value</span>
-</span><span id="1-428">
-</span><span id="1-429">    <span class="k">def</span> <span class="nf">set_thread</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">thread_id</span><span class="p">,</span> <span class="n">thread_name</span><span class="p">):</span>
-</span><span id="1-430">        <span class="c1"># type: (Optional[int], Optional[str]) -&gt; None</span>
-</span><span id="1-431">
-</span><span id="1-432">        <span class="k">if</span> <span class="n">thread_id</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-433">            <span class="bp">self</span><span class="o">.</span><span class="n">set_data</span><span class="p">(</span><span class="n">SPANDATA</span><span class="o">.</span><span class="n">THREAD_ID</span><span class="p">,</span> <span class="nb">str</span><span class="p">(</span><span class="n">thread_id</span><span class="p">))</span>
-</span><span id="1-434">
-</span><span id="1-435">            <span class="k">if</span> <span class="n">thread_name</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-436">                <span class="bp">self</span><span class="o">.</span><span class="n">set_data</span><span class="p">(</span><span class="n">SPANDATA</span><span class="o">.</span><span class="n">THREAD_NAME</span><span class="p">,</span> <span class="n">thread_name</span><span class="p">)</span>
-</span><span id="1-437">
-</span><span id="1-438">    <span class="k">def</span> <span class="nf">set_http_status</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">http_status</span><span class="p">):</span>
-</span><span id="1-439">        <span class="c1"># type: (int) -&gt; None</span>
-</span><span id="1-440">        <span class="bp">self</span><span class="o">.</span><span class="n">set_tag</span><span class="p">(</span>
-</span><span id="1-441">            <span class="s2">&quot;http.status_code&quot;</span><span class="p">,</span> <span class="nb">str</span><span class="p">(</span><span class="n">http_status</span><span class="p">)</span>
-</span><span id="1-442">        <span class="p">)</span>  <span class="c1"># we keep this for backwards compatability</span>
-</span><span id="1-443">        <span class="bp">self</span><span class="o">.</span><span class="n">set_data</span><span class="p">(</span><span class="n">SPANDATA</span><span class="o">.</span><span class="n">HTTP_STATUS_CODE</span><span class="p">,</span> <span class="n">http_status</span><span class="p">)</span>
-</span><span id="1-444">
-</span><span id="1-445">        <span class="k">if</span> <span class="n">http_status</span> <span class="o">&lt;</span> <span class="mi">400</span><span class="p">:</span>
-</span><span id="1-446">            <span class="bp">self</span><span class="o">.</span><span class="n">set_status</span><span class="p">(</span><span class="s2">&quot;ok&quot;</span><span class="p">)</span>
-</span><span id="1-447">        <span class="k">elif</span> <span class="mi">400</span> <span class="o">&lt;=</span> <span class="n">http_status</span> <span class="o">&lt;</span> <span class="mi">500</span><span class="p">:</span>
-</span><span id="1-448">            <span class="k">if</span> <span class="n">http_status</span> <span class="o">==</span> <span class="mi">403</span><span class="p">:</span>
-</span><span id="1-449">                <span class="bp">self</span><span class="o">.</span><span class="n">set_status</span><span class="p">(</span><span class="s2">&quot;permission_denied&quot;</span><span class="p">)</span>
-</span><span id="1-450">            <span class="k">elif</span> <span class="n">http_status</span> <span class="o">==</span> <span class="mi">404</span><span class="p">:</span>
-</span><span id="1-451">                <span class="bp">self</span><span class="o">.</span><span class="n">set_status</span><span class="p">(</span><span class="s2">&quot;not_found&quot;</span><span class="p">)</span>
-</span><span id="1-452">            <span class="k">elif</span> <span class="n">http_status</span> <span class="o">==</span> <span class="mi">429</span><span class="p">:</span>
-</span><span id="1-453">                <span class="bp">self</span><span class="o">.</span><span class="n">set_status</span><span class="p">(</span><span class="s2">&quot;resource_exhausted&quot;</span><span class="p">)</span>
-</span><span id="1-454">            <span class="k">elif</span> <span class="n">http_status</span> <span class="o">==</span> <span class="mi">413</span><span class="p">:</span>
-</span><span id="1-455">                <span class="bp">self</span><span class="o">.</span><span class="n">set_status</span><span class="p">(</span><span class="s2">&quot;failed_precondition&quot;</span><span class="p">)</span>
-</span><span id="1-456">            <span class="k">elif</span> <span class="n">http_status</span> <span class="o">==</span> <span class="mi">401</span><span class="p">:</span>
-</span><span id="1-457">                <span class="bp">self</span><span class="o">.</span><span class="n">set_status</span><span class="p">(</span><span class="s2">&quot;unauthenticated&quot;</span><span class="p">)</span>
-</span><span id="1-458">            <span class="k">elif</span> <span class="n">http_status</span> <span class="o">==</span> <span class="mi">409</span><span class="p">:</span>
-</span><span id="1-459">                <span class="bp">self</span><span class="o">.</span><span class="n">set_status</span><span class="p">(</span><span class="s2">&quot;already_exists&quot;</span><span class="p">)</span>
-</span><span id="1-460">            <span class="k">else</span><span class="p">:</span>
-</span><span id="1-461">                <span class="bp">self</span><span class="o">.</span><span class="n">set_status</span><span class="p">(</span><span class="s2">&quot;invalid_argument&quot;</span><span class="p">)</span>
-</span><span id="1-462">        <span class="k">elif</span> <span class="mi">500</span> <span class="o">&lt;=</span> <span class="n">http_status</span> <span class="o">&lt;</span> <span class="mi">600</span><span class="p">:</span>
-</span><span id="1-463">            <span class="k">if</span> <span class="n">http_status</span> <span class="o">==</span> <span class="mi">504</span><span class="p">:</span>
-</span><span id="1-464">                <span class="bp">self</span><span class="o">.</span><span class="n">set_status</span><span class="p">(</span><span class="s2">&quot;deadline_exceeded&quot;</span><span class="p">)</span>
-</span><span id="1-465">            <span class="k">elif</span> <span class="n">http_status</span> <span class="o">==</span> <span class="mi">501</span><span class="p">:</span>
-</span><span id="1-466">                <span class="bp">self</span><span class="o">.</span><span class="n">set_status</span><span class="p">(</span><span class="s2">&quot;unimplemented&quot;</span><span class="p">)</span>
-</span><span id="1-467">            <span class="k">elif</span> <span class="n">http_status</span> <span class="o">==</span> <span class="mi">503</span><span class="p">:</span>
-</span><span id="1-468">                <span class="bp">self</span><span class="o">.</span><span class="n">set_status</span><span class="p">(</span><span class="s2">&quot;unavailable&quot;</span><span class="p">)</span>
-</span><span id="1-469">            <span class="k">else</span><span class="p">:</span>
-</span><span id="1-470">                <span class="bp">self</span><span class="o">.</span><span class="n">set_status</span><span class="p">(</span><span class="s2">&quot;internal_error&quot;</span><span class="p">)</span>
-</span><span id="1-471">        <span class="k">else</span><span class="p">:</span>
-</span><span id="1-472">            <span class="bp">self</span><span class="o">.</span><span class="n">set_status</span><span class="p">(</span><span class="s2">&quot;unknown_error&quot;</span><span class="p">)</span>
-</span><span id="1-473">
-</span><span id="1-474">    <span class="k">def</span> <span class="nf">is_success</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-475">        <span class="c1"># type: () -&gt; bool</span>
-</span><span id="1-476">        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">==</span> <span class="s2">&quot;ok&quot;</span>
-</span><span id="1-477">
+</span><span id="1-478">
+</span><span id="1-479">    <span class="k">def</span> <span class="nf">set_tag</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
+</span><span id="1-480">        <span class="c1"># type: (str, Any) -&gt; None</span>
+</span><span id="1-481">        <span class="bp">self</span><span class="o">.</span><span class="n">_tags</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="o">=</span> <span class="n">value</span>
+</span><span id="1-482">
+</span><span id="1-483">    <span class="k">def</span> <span class="nf">set_data</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
+</span><span id="1-484">        <span class="c1"># type: (str, Any) -&gt; None</span>
+</span><span id="1-485">        <span class="bp">self</span><span class="o">.</span><span class="n">_data</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="o">=</span> <span class="n">value</span>
+</span><span id="1-486">
+</span><span id="1-487">    <span class="k">def</span> <span class="nf">set_status</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
+</span><span id="1-488">        <span class="c1"># type: (str) -&gt; None</span>
+</span><span id="1-489">        <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">=</span> <span class="n">value</span>
+</span><span id="1-490">
+</span><span id="1-491">    <span class="k">def</span> <span class="nf">set_thread</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">thread_id</span><span class="p">,</span> <span class="n">thread_name</span><span class="p">):</span>
+</span><span id="1-492">        <span class="c1"># type: (Optional[int], Optional[str]) -&gt; None</span>
+</span><span id="1-493">
+</span><span id="1-494">        <span class="k">if</span> <span class="n">thread_id</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-495">            <span class="bp">self</span><span class="o">.</span><span class="n">set_data</span><span class="p">(</span><span class="n">SPANDATA</span><span class="o">.</span><span class="n">THREAD_ID</span><span class="p">,</span> <span class="nb">str</span><span class="p">(</span><span class="n">thread_id</span><span class="p">))</span>
+</span><span id="1-496">
+</span><span id="1-497">            <span class="k">if</span> <span class="n">thread_name</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-498">                <span class="bp">self</span><span class="o">.</span><span class="n">set_data</span><span class="p">(</span><span class="n">SPANDATA</span><span class="o">.</span><span class="n">THREAD_NAME</span><span class="p">,</span> <span class="n">thread_name</span><span class="p">)</span>
+</span><span id="1-499">
+</span><span id="1-500">    <span class="k">def</span> <span class="nf">set_http_status</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">http_status</span><span class="p">):</span>
+</span><span id="1-501">        <span class="c1"># type: (int) -&gt; None</span>
+</span><span id="1-502">        <span class="bp">self</span><span class="o">.</span><span class="n">set_tag</span><span class="p">(</span>
+</span><span id="1-503">            <span class="s2">&quot;http.status_code&quot;</span><span class="p">,</span> <span class="nb">str</span><span class="p">(</span><span class="n">http_status</span><span class="p">)</span>
+</span><span id="1-504">        <span class="p">)</span>  <span class="c1"># we keep this for backwards compatability</span>
+</span><span id="1-505">        <span class="bp">self</span><span class="o">.</span><span class="n">set_data</span><span class="p">(</span><span class="n">SPANDATA</span><span class="o">.</span><span class="n">HTTP_STATUS_CODE</span><span class="p">,</span> <span class="n">http_status</span><span class="p">)</span>
+</span><span id="1-506">
+</span><span id="1-507">        <span class="k">if</span> <span class="n">http_status</span> <span class="o">&lt;</span> <span class="mi">400</span><span class="p">:</span>
+</span><span id="1-508">            <span class="bp">self</span><span class="o">.</span><span class="n">set_status</span><span class="p">(</span><span class="s2">&quot;ok&quot;</span><span class="p">)</span>
+</span><span id="1-509">        <span class="k">elif</span> <span class="mi">400</span> <span class="o">&lt;=</span> <span class="n">http_status</span> <span class="o">&lt;</span> <span class="mi">500</span><span class="p">:</span>
+</span><span id="1-510">            <span class="k">if</span> <span class="n">http_status</span> <span class="o">==</span> <span class="mi">403</span><span class="p">:</span>
+</span><span id="1-511">                <span class="bp">self</span><span class="o">.</span><span class="n">set_status</span><span class="p">(</span><span class="s2">&quot;permission_denied&quot;</span><span class="p">)</span>
+</span><span id="1-512">            <span class="k">elif</span> <span class="n">http_status</span> <span class="o">==</span> <span class="mi">404</span><span class="p">:</span>
+</span><span id="1-513">                <span class="bp">self</span><span class="o">.</span><span class="n">set_status</span><span class="p">(</span><span class="s2">&quot;not_found&quot;</span><span class="p">)</span>
+</span><span id="1-514">            <span class="k">elif</span> <span class="n">http_status</span> <span class="o">==</span> <span class="mi">429</span><span class="p">:</span>
+</span><span id="1-515">                <span class="bp">self</span><span class="o">.</span><span class="n">set_status</span><span class="p">(</span><span class="s2">&quot;resource_exhausted&quot;</span><span class="p">)</span>
+</span><span id="1-516">            <span class="k">elif</span> <span class="n">http_status</span> <span class="o">==</span> <span class="mi">413</span><span class="p">:</span>
+</span><span id="1-517">                <span class="bp">self</span><span class="o">.</span><span class="n">set_status</span><span class="p">(</span><span class="s2">&quot;failed_precondition&quot;</span><span class="p">)</span>
+</span><span id="1-518">            <span class="k">elif</span> <span class="n">http_status</span> <span class="o">==</span> <span class="mi">401</span><span class="p">:</span>
+</span><span id="1-519">                <span class="bp">self</span><span class="o">.</span><span class="n">set_status</span><span class="p">(</span><span class="s2">&quot;unauthenticated&quot;</span><span class="p">)</span>
+</span><span id="1-520">            <span class="k">elif</span> <span class="n">http_status</span> <span class="o">==</span> <span class="mi">409</span><span class="p">:</span>
+</span><span id="1-521">                <span class="bp">self</span><span class="o">.</span><span class="n">set_status</span><span class="p">(</span><span class="s2">&quot;already_exists&quot;</span><span class="p">)</span>
+</span><span id="1-522">            <span class="k">else</span><span class="p">:</span>
+</span><span id="1-523">                <span class="bp">self</span><span class="o">.</span><span class="n">set_status</span><span class="p">(</span><span class="s2">&quot;invalid_argument&quot;</span><span class="p">)</span>
+</span><span id="1-524">        <span class="k">elif</span> <span class="mi">500</span> <span class="o">&lt;=</span> <span class="n">http_status</span> <span class="o">&lt;</span> <span class="mi">600</span><span class="p">:</span>
+</span><span id="1-525">            <span class="k">if</span> <span class="n">http_status</span> <span class="o">==</span> <span class="mi">504</span><span class="p">:</span>
+</span><span id="1-526">                <span class="bp">self</span><span class="o">.</span><span class="n">set_status</span><span class="p">(</span><span class="s2">&quot;deadline_exceeded&quot;</span><span class="p">)</span>
+</span><span id="1-527">            <span class="k">elif</span> <span class="n">http_status</span> <span class="o">==</span> <span class="mi">501</span><span class="p">:</span>
+</span><span id="1-528">                <span class="bp">self</span><span class="o">.</span><span class="n">set_status</span><span class="p">(</span><span class="s2">&quot;unimplemented&quot;</span><span class="p">)</span>
+</span><span id="1-529">            <span class="k">elif</span> <span class="n">http_status</span> <span class="o">==</span> <span class="mi">503</span><span class="p">:</span>
+</span><span id="1-530">                <span class="bp">self</span><span class="o">.</span><span class="n">set_status</span><span class="p">(</span><span class="s2">&quot;unavailable&quot;</span><span class="p">)</span>
+</span><span id="1-531">            <span class="k">else</span><span class="p">:</span>
+</span><span id="1-532">                <span class="bp">self</span><span class="o">.</span><span class="n">set_status</span><span class="p">(</span><span class="s2">&quot;internal_error&quot;</span><span class="p">)</span>
+</span><span id="1-533">        <span class="k">else</span><span class="p">:</span>
+</span><span id="1-534">            <span class="bp">self</span><span class="o">.</span><span class="n">set_status</span><span class="p">(</span><span class="s2">&quot;unknown_error&quot;</span><span class="p">)</span>
+</span><span id="1-535">
+</span><span id="1-536">    <span class="k">def</span> <span class="nf">is_success</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-537">        <span class="c1"># type: () -&gt; bool</span>
+</span><span id="1-538">        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">status</span> <span class="o">==</span> <span class="s2">&quot;ok&quot;</span>
+</span><span id="1-539">
 <div class="viewcode-block" id="Span.finish">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.tracing.Span.finish">[docs]</a>
-</span><span id="1-478">    <span class="k">def</span> <span class="nf">finish</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">hub</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">end_timestamp</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-</span><span id="1-479">        <span class="c1"># type: (Optional[sentry_sdk.Hub], Optional[Union[float, datetime]]) -&gt; Optional[str]</span>
-</span><span id="1-480">        <span class="c1"># Note: would be type: (Optional[sentry_sdk.Hub]) -&gt; None, but that leads</span>
-</span><span id="1-481">        <span class="c1"># to incompatible return types for Span.finish and Transaction.finish.</span>
-</span><span id="1-482"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Sets the end timestamp of the span.</span>
-</span><span id="1-483"><span class="sd">        Additionally it also creates a breadcrumb from the span,</span>
-</span><span id="1-484"><span class="sd">        if the span represents a database or HTTP request.</span>
-</span><span id="1-485">
-</span><span id="1-486"><span class="sd">        :param hub: The hub to use for this transaction.</span>
-</span><span id="1-487"><span class="sd">            If not provided, the current hub will be used.</span>
-</span><span id="1-488"><span class="sd">        :param end_timestamp: Optional timestamp that should</span>
-</span><span id="1-489"><span class="sd">            be used as timestamp instead of the current time.</span>
-</span><span id="1-490">
-</span><span id="1-491"><span class="sd">        :return: Always ``None``. The type is ``Optional[str]`` to match</span>
-</span><span id="1-492"><span class="sd">            the return value of :py:meth:`sentry_sdk.tracing.Transaction.finish`.</span>
-</span><span id="1-493"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-494">
-</span><span id="1-495">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">timestamp</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-496">            <span class="c1"># This span is already finished, ignore.</span>
-</span><span id="1-497">            <span class="k">return</span> <span class="kc">None</span>
-</span><span id="1-498">
-</span><span id="1-499">        <span class="n">hub</span> <span class="o">=</span> <span class="n">hub</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">hub</span> <span class="ow">or</span> <span class="n">sentry_sdk</span><span class="o">.</span><span class="n">Hub</span><span class="o">.</span><span class="n">current</span>
-</span><span id="1-500">
-</span><span id="1-501">        <span class="k">try</span><span class="p">:</span>
-</span><span id="1-502">            <span class="k">if</span> <span class="n">end_timestamp</span><span class="p">:</span>
-</span><span id="1-503">                <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">end_timestamp</span><span class="p">,</span> <span class="nb">float</span><span class="p">):</span>
-</span><span id="1-504">                    <span class="n">end_timestamp</span> <span class="o">=</span> <span class="n">utc_from_timestamp</span><span class="p">(</span><span class="n">end_timestamp</span><span class="p">)</span>
-</span><span id="1-505">                <span class="bp">self</span><span class="o">.</span><span class="n">timestamp</span> <span class="o">=</span> <span class="n">end_timestamp</span>
-</span><span id="1-506">            <span class="k">else</span><span class="p">:</span>
-</span><span id="1-507">                <span class="n">elapsed</span> <span class="o">=</span> <span class="n">nanosecond_time</span><span class="p">()</span> <span class="o">-</span> <span class="bp">self</span><span class="o">.</span><span class="n">_start_timestamp_monotonic_ns</span>
-</span><span id="1-508">                <span class="bp">self</span><span class="o">.</span><span class="n">timestamp</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">start_timestamp</span> <span class="o">+</span> <span class="n">timedelta</span><span class="p">(</span>
-</span><span id="1-509">                    <span class="n">microseconds</span><span class="o">=</span><span class="n">elapsed</span> <span class="o">/</span> <span class="mi">1000</span>
-</span><span id="1-510">                <span class="p">)</span>
-</span><span id="1-511">        <span class="k">except</span> <span class="ne">AttributeError</span><span class="p">:</span>
-</span><span id="1-512">            <span class="bp">self</span><span class="o">.</span><span class="n">timestamp</span> <span class="o">=</span> <span class="n">datetime_utcnow</span><span class="p">()</span>
-</span><span id="1-513">
-</span><span id="1-514">        <span class="n">maybe_create_breadcrumbs_from_span</span><span class="p">(</span><span class="n">hub</span><span class="p">,</span> <span class="bp">self</span><span class="p">)</span>
-</span><span id="1-515">
-</span><span id="1-516">        <span class="k">return</span> <span class="kc">None</span></div>
+</span><span id="1-540">    <span class="k">def</span> <span class="nf">finish</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">scope</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">end_timestamp</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+</span><span id="1-541">        <span class="c1"># type: (Optional[sentry_sdk.Scope], Optional[Union[float, datetime]]) -&gt; Optional[str]</span>
+</span><span id="1-542"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-543"><span class="sd">        Sets the end timestamp of the span.</span>
+</span><span id="1-544">
+</span><span id="1-545"><span class="sd">        Additionally it also creates a breadcrumb from the span,</span>
+</span><span id="1-546"><span class="sd">        if the span represents a database or HTTP request.</span>
+</span><span id="1-547">
+</span><span id="1-548"><span class="sd">        :param scope: The scope to use for this transaction.</span>
+</span><span id="1-549"><span class="sd">            If not provided, the current scope will be used.</span>
+</span><span id="1-550"><span class="sd">        :param end_timestamp: Optional timestamp that should</span>
+</span><span id="1-551"><span class="sd">            be used as timestamp instead of the current time.</span>
+</span><span id="1-552">
+</span><span id="1-553"><span class="sd">        :return: Always ``None``. The type is ``Optional[str]`` to match</span>
+</span><span id="1-554"><span class="sd">            the return value of :py:meth:`sentry_sdk.tracing.Transaction.finish`.</span>
+</span><span id="1-555"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-556">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">timestamp</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-557">            <span class="c1"># This span is already finished, ignore.</span>
+</span><span id="1-558">            <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-559">
+</span><span id="1-560">        <span class="k">try</span><span class="p">:</span>
+</span><span id="1-561">            <span class="k">if</span> <span class="n">end_timestamp</span><span class="p">:</span>
+</span><span id="1-562">                <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">end_timestamp</span><span class="p">,</span> <span class="nb">float</span><span class="p">):</span>
+</span><span id="1-563">                    <span class="n">end_timestamp</span> <span class="o">=</span> <span class="n">datetime</span><span class="o">.</span><span class="n">fromtimestamp</span><span class="p">(</span><span class="n">end_timestamp</span><span class="p">,</span> <span class="n">timezone</span><span class="o">.</span><span class="n">utc</span><span class="p">)</span>
+</span><span id="1-564">                <span class="bp">self</span><span class="o">.</span><span class="n">timestamp</span> <span class="o">=</span> <span class="n">end_timestamp</span>
+</span><span id="1-565">            <span class="k">else</span><span class="p">:</span>
+</span><span id="1-566">                <span class="n">elapsed</span> <span class="o">=</span> <span class="n">nanosecond_time</span><span class="p">()</span> <span class="o">-</span> <span class="bp">self</span><span class="o">.</span><span class="n">_start_timestamp_monotonic_ns</span>
+</span><span id="1-567">                <span class="bp">self</span><span class="o">.</span><span class="n">timestamp</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">start_timestamp</span> <span class="o">+</span> <span class="n">timedelta</span><span class="p">(</span>
+</span><span id="1-568">                    <span class="n">microseconds</span><span class="o">=</span><span class="n">elapsed</span> <span class="o">/</span> <span class="mi">1000</span>
+</span><span id="1-569">                <span class="p">)</span>
+</span><span id="1-570">        <span class="k">except</span> <span class="ne">AttributeError</span><span class="p">:</span>
+</span><span id="1-571">            <span class="bp">self</span><span class="o">.</span><span class="n">timestamp</span> <span class="o">=</span> <span class="n">datetime</span><span class="o">.</span><span class="n">now</span><span class="p">(</span><span class="n">timezone</span><span class="o">.</span><span class="n">utc</span><span class="p">)</span>
+</span><span id="1-572">
+</span><span id="1-573">        <span class="n">scope</span> <span class="o">=</span> <span class="n">scope</span> <span class="ow">or</span> <span class="n">sentry_sdk</span><span class="o">.</span><span class="n">Scope</span><span class="o">.</span><span class="n">get_current_scope</span><span class="p">()</span>
+</span><span id="1-574">        <span class="n">maybe_create_breadcrumbs_from_span</span><span class="p">(</span><span class="n">scope</span><span class="p">,</span> <span class="bp">self</span><span class="p">)</span>
+</span><span id="1-575">
+</span><span id="1-576">        <span class="k">return</span> <span class="kc">None</span></div>
 
-</span><span id="1-517">
+</span><span id="1-577">
 <div class="viewcode-block" id="Span.to_json">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.tracing.Span.to_json">[docs]</a>
-</span><span id="1-518">    <span class="k">def</span> <span class="nf">to_json</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-519">        <span class="c1"># type: () -&gt; Dict[str, Any]</span>
-</span><span id="1-520"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Returns a JSON-compatible representation of the span.&quot;&quot;&quot;</span>
-</span><span id="1-521">
-</span><span id="1-522">        <span class="n">rv</span> <span class="o">=</span> <span class="p">{</span>
-</span><span id="1-523">            <span class="s2">&quot;trace_id&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">trace_id</span><span class="p">,</span>
-</span><span id="1-524">            <span class="s2">&quot;span_id&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">span_id</span><span class="p">,</span>
-</span><span id="1-525">            <span class="s2">&quot;parent_span_id&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">parent_span_id</span><span class="p">,</span>
-</span><span id="1-526">            <span class="s2">&quot;same_process_as_parent&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">same_process_as_parent</span><span class="p">,</span>
-</span><span id="1-527">            <span class="s2">&quot;op&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">op</span><span class="p">,</span>
-</span><span id="1-528">            <span class="s2">&quot;description&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">description</span><span class="p">,</span>
-</span><span id="1-529">            <span class="s2">&quot;start_timestamp&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">start_timestamp</span><span class="p">,</span>
-</span><span id="1-530">            <span class="s2">&quot;timestamp&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">timestamp</span><span class="p">,</span>
-</span><span id="1-531">        <span class="p">}</span>  <span class="c1"># type: Dict[str, Any]</span>
-</span><span id="1-532">
-</span><span id="1-533">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">status</span><span class="p">:</span>
-</span><span id="1-534">            <span class="bp">self</span><span class="o">.</span><span class="n">_tags</span><span class="p">[</span><span class="s2">&quot;status&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">status</span>
-</span><span id="1-535">
-</span><span id="1-536">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_local_aggregator</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-537">            <span class="n">metrics_summary</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_local_aggregator</span><span class="o">.</span><span class="n">to_json</span><span class="p">()</span>
-</span><span id="1-538">            <span class="k">if</span> <span class="n">metrics_summary</span><span class="p">:</span>
-</span><span id="1-539">                <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;_metrics_summary&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">metrics_summary</span>
-</span><span id="1-540">
-</span><span id="1-541">        <span class="n">tags</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_tags</span>
-</span><span id="1-542">        <span class="k">if</span> <span class="n">tags</span><span class="p">:</span>
-</span><span id="1-543">            <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;tags&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">tags</span>
-</span><span id="1-544">
-</span><span id="1-545">        <span class="n">data</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_data</span>
-</span><span id="1-546">        <span class="k">if</span> <span class="n">data</span><span class="p">:</span>
-</span><span id="1-547">            <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;data&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">data</span>
-</span><span id="1-548">
-</span><span id="1-549">        <span class="k">return</span> <span class="n">rv</span></div>
+</span><span id="1-578">    <span class="k">def</span> <span class="nf">to_json</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-579">        <span class="c1"># type: () -&gt; Dict[str, Any]</span>
+</span><span id="1-580"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Returns a JSON-compatible representation of the span.&quot;&quot;&quot;</span>
+</span><span id="1-581">
+</span><span id="1-582">        <span class="n">rv</span> <span class="o">=</span> <span class="p">{</span>
+</span><span id="1-583">            <span class="s2">&quot;trace_id&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">trace_id</span><span class="p">,</span>
+</span><span id="1-584">            <span class="s2">&quot;span_id&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">span_id</span><span class="p">,</span>
+</span><span id="1-585">            <span class="s2">&quot;parent_span_id&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">parent_span_id</span><span class="p">,</span>
+</span><span id="1-586">            <span class="s2">&quot;same_process_as_parent&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">same_process_as_parent</span><span class="p">,</span>
+</span><span id="1-587">            <span class="s2">&quot;op&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">op</span><span class="p">,</span>
+</span><span id="1-588">            <span class="s2">&quot;description&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">description</span><span class="p">,</span>
+</span><span id="1-589">            <span class="s2">&quot;start_timestamp&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">start_timestamp</span><span class="p">,</span>
+</span><span id="1-590">            <span class="s2">&quot;timestamp&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">timestamp</span><span class="p">,</span>
+</span><span id="1-591">        <span class="p">}</span>  <span class="c1"># type: Dict[str, Any]</span>
+</span><span id="1-592">
+</span><span id="1-593">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">status</span><span class="p">:</span>
+</span><span id="1-594">            <span class="bp">self</span><span class="o">.</span><span class="n">_tags</span><span class="p">[</span><span class="s2">&quot;status&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">status</span>
+</span><span id="1-595">
+</span><span id="1-596">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_local_aggregator</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-597">            <span class="n">metrics_summary</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_local_aggregator</span><span class="o">.</span><span class="n">to_json</span><span class="p">()</span>
+</span><span id="1-598">            <span class="k">if</span> <span class="n">metrics_summary</span><span class="p">:</span>
+</span><span id="1-599">                <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;_metrics_summary&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">metrics_summary</span>
+</span><span id="1-600">
+</span><span id="1-601">        <span class="n">tags</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_tags</span>
+</span><span id="1-602">        <span class="k">if</span> <span class="n">tags</span><span class="p">:</span>
+</span><span id="1-603">            <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;tags&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">tags</span>
+</span><span id="1-604">
+</span><span id="1-605">        <span class="n">data</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_data</span>
+</span><span id="1-606">        <span class="k">if</span> <span class="n">data</span><span class="p">:</span>
+</span><span id="1-607">            <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;data&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">data</span>
+</span><span id="1-608">
+</span><span id="1-609">        <span class="k">return</span> <span class="n">rv</span></div>
 
-</span><span id="1-550">
-</span><span id="1-551">    <span class="k">def</span> <span class="nf">get_trace_context</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-552">        <span class="c1"># type: () -&gt; Any</span>
-</span><span id="1-553">        <span class="n">rv</span> <span class="o">=</span> <span class="p">{</span>
-</span><span id="1-554">            <span class="s2">&quot;trace_id&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">trace_id</span><span class="p">,</span>
-</span><span id="1-555">            <span class="s2">&quot;span_id&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">span_id</span><span class="p">,</span>
-</span><span id="1-556">            <span class="s2">&quot;parent_span_id&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">parent_span_id</span><span class="p">,</span>
-</span><span id="1-557">            <span class="s2">&quot;op&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">op</span><span class="p">,</span>
-</span><span id="1-558">            <span class="s2">&quot;description&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">description</span><span class="p">,</span>
-</span><span id="1-559">        <span class="p">}</span>  <span class="c1"># type: Dict[str, Any]</span>
-</span><span id="1-560">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">status</span><span class="p">:</span>
-</span><span id="1-561">            <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;status&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">status</span>
-</span><span id="1-562">
-</span><span id="1-563">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">containing_transaction</span><span class="p">:</span>
-</span><span id="1-564">            <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;dynamic_sampling_context&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="p">(</span>
-</span><span id="1-565">                <span class="bp">self</span><span class="o">.</span><span class="n">containing_transaction</span><span class="o">.</span><span class="n">get_baggage</span><span class="p">()</span><span class="o">.</span><span class="n">dynamic_sampling_context</span><span class="p">()</span>
-</span><span id="1-566">            <span class="p">)</span>
-</span><span id="1-567">
-</span><span id="1-568">        <span class="k">return</span> <span class="n">rv</span></div>
+</span><span id="1-610">
+</span><span id="1-611">    <span class="k">def</span> <span class="nf">get_trace_context</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-612">        <span class="c1"># type: () -&gt; Any</span>
+</span><span id="1-613">        <span class="n">rv</span> <span class="o">=</span> <span class="p">{</span>
+</span><span id="1-614">            <span class="s2">&quot;trace_id&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">trace_id</span><span class="p">,</span>
+</span><span id="1-615">            <span class="s2">&quot;span_id&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">span_id</span><span class="p">,</span>
+</span><span id="1-616">            <span class="s2">&quot;parent_span_id&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">parent_span_id</span><span class="p">,</span>
+</span><span id="1-617">            <span class="s2">&quot;op&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">op</span><span class="p">,</span>
+</span><span id="1-618">            <span class="s2">&quot;description&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">description</span><span class="p">,</span>
+</span><span id="1-619">        <span class="p">}</span>  <span class="c1"># type: Dict[str, Any]</span>
+</span><span id="1-620">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">status</span><span class="p">:</span>
+</span><span id="1-621">            <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;status&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">status</span>
+</span><span id="1-622">
+</span><span id="1-623">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">containing_transaction</span><span class="p">:</span>
+</span><span id="1-624">            <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;dynamic_sampling_context&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="p">(</span>
+</span><span id="1-625">                <span class="bp">self</span><span class="o">.</span><span class="n">containing_transaction</span><span class="o">.</span><span class="n">get_baggage</span><span class="p">()</span><span class="o">.</span><span class="n">dynamic_sampling_context</span><span class="p">()</span>
+</span><span id="1-626">            <span class="p">)</span>
+</span><span id="1-627">
+</span><span id="1-628">        <span class="k">return</span> <span class="n">rv</span></div>
 
-</span><span id="1-569">
-</span><span id="1-570">
+</span><span id="1-629">
+</span><span id="1-630">
 <div class="viewcode-block" id="Transaction">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.tracing.Transaction">[docs]</a>
-</span><span id="1-571"><span class="k">class</span> <span class="nc">Transaction</span><span class="p">(</span><span class="n">Span</span><span class="p">):</span>
-</span><span id="1-572"><span class="w">    </span><span class="sd">&quot;&quot;&quot;The Transaction is the root element that holds all the spans</span>
-</span><span id="1-573"><span class="sd">    for Sentry performance instrumentation.&quot;&quot;&quot;</span>
-</span><span id="1-574">
-</span><span id="1-575">    <span class="vm">__slots__</span> <span class="o">=</span> <span class="p">(</span>
-</span><span id="1-576">        <span class="s2">&quot;name&quot;</span><span class="p">,</span>
-</span><span id="1-577">        <span class="s2">&quot;source&quot;</span><span class="p">,</span>
-</span><span id="1-578">        <span class="s2">&quot;parent_sampled&quot;</span><span class="p">,</span>
-</span><span id="1-579">        <span class="c1"># used to create baggage value for head SDKs in dynamic sampling</span>
-</span><span id="1-580">        <span class="s2">&quot;sample_rate&quot;</span><span class="p">,</span>
-</span><span id="1-581">        <span class="s2">&quot;_measurements&quot;</span><span class="p">,</span>
-</span><span id="1-582">        <span class="s2">&quot;_contexts&quot;</span><span class="p">,</span>
-</span><span id="1-583">        <span class="s2">&quot;_profile&quot;</span><span class="p">,</span>
-</span><span id="1-584">        <span class="s2">&quot;_baggage&quot;</span><span class="p">,</span>
-</span><span id="1-585">    <span class="p">)</span>
-</span><span id="1-586">
-</span><span id="1-587">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
-</span><span id="1-588">        <span class="bp">self</span><span class="p">,</span>
-</span><span id="1-589">        <span class="n">name</span><span class="o">=</span><span class="s2">&quot;&quot;</span><span class="p">,</span>  <span class="c1"># type: str</span>
-</span><span id="1-590">        <span class="n">parent_sampled</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[bool]</span>
-</span><span id="1-591">        <span class="n">baggage</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Baggage]</span>
-</span><span id="1-592">        <span class="n">source</span><span class="o">=</span><span class="n">TRANSACTION_SOURCE_CUSTOM</span><span class="p">,</span>  <span class="c1"># type: str</span>
-</span><span id="1-593">        <span class="o">**</span><span class="n">kwargs</span>  <span class="c1"># type: Any</span>
-</span><span id="1-594">    <span class="p">):</span>
-</span><span id="1-595">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-596"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Constructs a new Transaction.</span>
-</span><span id="1-597">
-</span><span id="1-598"><span class="sd">        :param name: Identifier of the transaction.</span>
-</span><span id="1-599"><span class="sd">            Will show up in the Sentry UI.</span>
-</span><span id="1-600"><span class="sd">        :param parent_sampled: Whether the parent transaction was sampled.</span>
-</span><span id="1-601"><span class="sd">            If True this transaction will be kept, if False it will be discarded.</span>
-</span><span id="1-602"><span class="sd">        :param baggage: The W3C baggage header value.</span>
-</span><span id="1-603"><span class="sd">            (see https://www.w3.org/TR/baggage/)</span>
-</span><span id="1-604"><span class="sd">        :param source: A string describing the source of the transaction name.</span>
-</span><span id="1-605"><span class="sd">            This will be used to determine the transaction&#39;s type.</span>
-</span><span id="1-606"><span class="sd">            See https://develop.sentry.dev/sdk/event-payloads/transaction/#transaction-annotations</span>
-</span><span id="1-607"><span class="sd">            for more information. Default &quot;custom&quot;.</span>
-</span><span id="1-608"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-609">        <span class="c1"># TODO: consider removing this in a future release.</span>
-</span><span id="1-610">        <span class="c1"># This is for backwards compatibility with releases before Transaction</span>
-</span><span id="1-611">        <span class="c1"># existed, to allow for a smoother transition.</span>
-</span><span id="1-612">        <span class="k">if</span> <span class="ow">not</span> <span class="n">name</span> <span class="ow">and</span> <span class="s2">&quot;transaction&quot;</span> <span class="ow">in</span> <span class="n">kwargs</span><span class="p">:</span>
-</span><span id="1-613">            <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
-</span><span id="1-614">                <span class="s2">&quot;Deprecated: use Transaction(name=...) to create transactions &quot;</span>
-</span><span id="1-615">                <span class="s2">&quot;instead of Span(transaction=...).&quot;</span>
-</span><span id="1-616">            <span class="p">)</span>
-</span><span id="1-617">            <span class="n">name</span> <span class="o">=</span> <span class="n">kwargs</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="s2">&quot;transaction&quot;</span><span class="p">)</span>
-</span><span id="1-618">
-</span><span id="1-619">        <span class="nb">super</span><span class="p">(</span><span class="n">Transaction</span><span class="p">,</span> <span class="bp">self</span><span class="p">)</span><span class="o">.</span><span class="fm">__init__</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-</span><span id="1-620">
-</span><span id="1-621">        <span class="bp">self</span><span class="o">.</span><span class="n">name</span> <span class="o">=</span> <span class="n">name</span>
-</span><span id="1-622">        <span class="bp">self</span><span class="o">.</span><span class="n">source</span> <span class="o">=</span> <span class="n">source</span>
-</span><span id="1-623">        <span class="bp">self</span><span class="o">.</span><span class="n">sample_rate</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[float]</span>
-</span><span id="1-624">        <span class="bp">self</span><span class="o">.</span><span class="n">parent_sampled</span> <span class="o">=</span> <span class="n">parent_sampled</span>
-</span><span id="1-625">        <span class="bp">self</span><span class="o">.</span><span class="n">_measurements</span> <span class="o">=</span> <span class="p">{}</span>  <span class="c1"># type: Dict[str, Any]</span>
-</span><span id="1-626">        <span class="bp">self</span><span class="o">.</span><span class="n">_contexts</span> <span class="o">=</span> <span class="p">{}</span>  <span class="c1"># type: Dict[str, Any]</span>
-</span><span id="1-627">        <span class="bp">self</span><span class="o">.</span><span class="n">_profile</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[sentry_sdk.profiler.Profile]</span>
-</span><span id="1-628">        <span class="bp">self</span><span class="o">.</span><span class="n">_baggage</span> <span class="o">=</span> <span class="n">baggage</span>
-</span><span id="1-629">
-</span><span id="1-630">    <span class="k">def</span> <span class="fm">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-631">        <span class="c1"># type: () -&gt; str</span>
-</span><span id="1-632">        <span class="k">return</span> <span class="p">(</span>
-</span><span id="1-633">            <span class="s2">&quot;&lt;</span><span class="si">%s</span><span class="s2">(name=</span><span class="si">%r</span><span class="s2">, op=</span><span class="si">%r</span><span class="s2">, trace_id=</span><span class="si">%r</span><span class="s2">, span_id=</span><span class="si">%r</span><span class="s2">, parent_span_id=</span><span class="si">%r</span><span class="s2">, sampled=</span><span class="si">%r</span><span class="s2">, source=</span><span class="si">%r</span><span class="s2">)&gt;&quot;</span>
-</span><span id="1-634">            <span class="o">%</span> <span class="p">(</span>
-</span><span id="1-635">                <span class="bp">self</span><span class="o">.</span><span class="vm">__class__</span><span class="o">.</span><span class="vm">__name__</span><span class="p">,</span>
-</span><span id="1-636">                <span class="bp">self</span><span class="o">.</span><span class="n">name</span><span class="p">,</span>
-</span><span id="1-637">                <span class="bp">self</span><span class="o">.</span><span class="n">op</span><span class="p">,</span>
-</span><span id="1-638">                <span class="bp">self</span><span class="o">.</span><span class="n">trace_id</span><span class="p">,</span>
-</span><span id="1-639">                <span class="bp">self</span><span class="o">.</span><span class="n">span_id</span><span class="p">,</span>
-</span><span id="1-640">                <span class="bp">self</span><span class="o">.</span><span class="n">parent_span_id</span><span class="p">,</span>
-</span><span id="1-641">                <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span><span class="p">,</span>
-</span><span id="1-642">                <span class="bp">self</span><span class="o">.</span><span class="n">source</span><span class="p">,</span>
-</span><span id="1-643">            <span class="p">)</span>
-</span><span id="1-644">        <span class="p">)</span>
-</span><span id="1-645">
-</span><span id="1-646">    <span class="k">def</span> <span class="fm">__enter__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-647">        <span class="c1"># type: () -&gt; Transaction</span>
-</span><span id="1-648">        <span class="nb">super</span><span class="p">(</span><span class="n">Transaction</span><span class="p">,</span> <span class="bp">self</span><span class="p">)</span><span class="o">.</span><span class="fm">__enter__</span><span class="p">()</span>
-</span><span id="1-649">
-</span><span id="1-650">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_profile</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-651">            <span class="bp">self</span><span class="o">.</span><span class="n">_profile</span><span class="o">.</span><span class="fm">__enter__</span><span class="p">()</span>
-</span><span id="1-652">
-</span><span id="1-653">        <span class="k">return</span> <span class="bp">self</span>
-</span><span id="1-654">
-</span><span id="1-655">    <span class="k">def</span> <span class="fm">__exit__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">ty</span><span class="p">,</span> <span class="n">value</span><span class="p">,</span> <span class="n">tb</span><span class="p">):</span>
-</span><span id="1-656">        <span class="c1"># type: (Optional[Any], Optional[Any], Optional[Any]) -&gt; None</span>
-</span><span id="1-657">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_profile</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-658">            <span class="bp">self</span><span class="o">.</span><span class="n">_profile</span><span class="o">.</span><span class="fm">__exit__</span><span class="p">(</span><span class="n">ty</span><span class="p">,</span> <span class="n">value</span><span class="p">,</span> <span class="n">tb</span><span class="p">)</span>
-</span><span id="1-659">
-</span><span id="1-660">        <span class="nb">super</span><span class="p">(</span><span class="n">Transaction</span><span class="p">,</span> <span class="bp">self</span><span class="p">)</span><span class="o">.</span><span class="fm">__exit__</span><span class="p">(</span><span class="n">ty</span><span class="p">,</span> <span class="n">value</span><span class="p">,</span> <span class="n">tb</span><span class="p">)</span>
-</span><span id="1-661">
-</span><span id="1-662">    <span class="nd">@property</span>
-</span><span id="1-663">    <span class="k">def</span> <span class="nf">containing_transaction</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-664">        <span class="c1"># type: () -&gt; Transaction</span>
-</span><span id="1-665"><span class="w">        </span><span class="sd">&quot;&quot;&quot;The root element of the span tree.</span>
-</span><span id="1-666"><span class="sd">        In the case of a transaction it is the transaction itself.</span>
-</span><span id="1-667"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-668">
-</span><span id="1-669">        <span class="c1"># Transactions (as spans) belong to themselves (as transactions). This</span>
-</span><span id="1-670">        <span class="c1"># is a getter rather than a regular attribute to avoid having a circular</span>
-</span><span id="1-671">        <span class="c1"># reference.</span>
-</span><span id="1-672">        <span class="k">return</span> <span class="bp">self</span>
-</span><span id="1-673">
-<div class="viewcode-block" id="Transaction.finish">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.tracing.Transaction.finish">[docs]</a>
-</span><span id="1-674">    <span class="k">def</span> <span class="nf">finish</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">hub</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">end_timestamp</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-</span><span id="1-675">        <span class="c1"># type: (Optional[sentry_sdk.Hub], Optional[Union[float, datetime]]) -&gt; Optional[str]</span>
-</span><span id="1-676"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Finishes the transaction and sends it to Sentry.</span>
-</span><span id="1-677"><span class="sd">        All finished spans in the transaction will also be sent to Sentry.</span>
-</span><span id="1-678">
-</span><span id="1-679"><span class="sd">        :param hub: The hub to use for this transaction.</span>
-</span><span id="1-680"><span class="sd">            If not provided, the current hub will be used.</span>
-</span><span id="1-681"><span class="sd">        :param end_timestamp: Optional timestamp that should</span>
-</span><span id="1-682"><span class="sd">            be used as timestamp instead of the current time.</span>
-</span><span id="1-683">
-</span><span id="1-684"><span class="sd">        :return: The event ID if the transaction was sent to Sentry,</span>
-</span><span id="1-685"><span class="sd">            otherwise None.</span>
-</span><span id="1-686"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-687">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">timestamp</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-688">            <span class="c1"># This transaction is already finished, ignore.</span>
-</span><span id="1-689">            <span class="k">return</span> <span class="kc">None</span>
-</span><span id="1-690">
-</span><span id="1-691">        <span class="n">hub</span> <span class="o">=</span> <span class="n">hub</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">hub</span> <span class="ow">or</span> <span class="n">sentry_sdk</span><span class="o">.</span><span class="n">Hub</span><span class="o">.</span><span class="n">current</span>
-</span><span id="1-692">        <span class="n">client</span> <span class="o">=</span> <span class="n">hub</span><span class="o">.</span><span class="n">client</span>
-</span><span id="1-693">
-</span><span id="1-694">        <span class="k">if</span> <span class="n">client</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-695">            <span class="c1"># We have no client and therefore nowhere to send this transaction.</span>
-</span><span id="1-696">            <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-631"><span class="k">class</span> <span class="nc">Transaction</span><span class="p">(</span><span class="n">Span</span><span class="p">):</span>
+</span><span id="1-632"><span class="w">    </span><span class="sd">&quot;&quot;&quot;The Transaction is the root element that holds all the spans</span>
+</span><span id="1-633"><span class="sd">    for Sentry performance instrumentation.</span>
+</span><span id="1-634">
+</span><span id="1-635"><span class="sd">    :param name: Identifier of the transaction.</span>
+</span><span id="1-636"><span class="sd">        Will show up in the Sentry UI.</span>
+</span><span id="1-637"><span class="sd">    :param parent_sampled: Whether the parent transaction was sampled.</span>
+</span><span id="1-638"><span class="sd">        If True this transaction will be kept, if False it will be discarded.</span>
+</span><span id="1-639"><span class="sd">    :param baggage: The W3C baggage header value.</span>
+</span><span id="1-640"><span class="sd">        (see https://www.w3.org/TR/baggage/)</span>
+</span><span id="1-641"><span class="sd">    :param source: A string describing the source of the transaction name.</span>
+</span><span id="1-642"><span class="sd">        This will be used to determine the transaction&#39;s type.</span>
+</span><span id="1-643"><span class="sd">        See https://develop.sentry.dev/sdk/event-payloads/transaction/#transaction-annotations</span>
+</span><span id="1-644"><span class="sd">        for more information. Default &quot;custom&quot;.</span>
+</span><span id="1-645"><span class="sd">    :param kwargs: Additional arguments to be passed to the Span constructor.</span>
+</span><span id="1-646"><span class="sd">        See :py:class:`sentry_sdk.tracing.Span` for available arguments.</span>
+</span><span id="1-647"><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="1-648">
+</span><span id="1-649">    <span class="vm">__slots__</span> <span class="o">=</span> <span class="p">(</span>
+</span><span id="1-650">        <span class="s2">&quot;name&quot;</span><span class="p">,</span>
+</span><span id="1-651">        <span class="s2">&quot;source&quot;</span><span class="p">,</span>
+</span><span id="1-652">        <span class="s2">&quot;parent_sampled&quot;</span><span class="p">,</span>
+</span><span id="1-653">        <span class="c1"># used to create baggage value for head SDKs in dynamic sampling</span>
+</span><span id="1-654">        <span class="s2">&quot;sample_rate&quot;</span><span class="p">,</span>
+</span><span id="1-655">        <span class="s2">&quot;_measurements&quot;</span><span class="p">,</span>
+</span><span id="1-656">        <span class="s2">&quot;_contexts&quot;</span><span class="p">,</span>
+</span><span id="1-657">        <span class="s2">&quot;_profile&quot;</span><span class="p">,</span>
+</span><span id="1-658">        <span class="s2">&quot;_baggage&quot;</span><span class="p">,</span>
+</span><span id="1-659">    <span class="p">)</span>
+</span><span id="1-660">
+</span><span id="1-661">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
+</span><span id="1-662">        <span class="bp">self</span><span class="p">,</span>
+</span><span id="1-663">        <span class="n">name</span><span class="o">=</span><span class="s2">&quot;&quot;</span><span class="p">,</span>  <span class="c1"># type: str</span>
+</span><span id="1-664">        <span class="n">parent_sampled</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[bool]</span>
+</span><span id="1-665">        <span class="n">baggage</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Baggage]</span>
+</span><span id="1-666">        <span class="n">source</span><span class="o">=</span><span class="n">TRANSACTION_SOURCE_CUSTOM</span><span class="p">,</span>  <span class="c1"># type: str</span>
+</span><span id="1-667">        <span class="o">**</span><span class="n">kwargs</span><span class="p">,</span>  <span class="c1"># type: Unpack[SpanKwargs]</span>
+</span><span id="1-668">    <span class="p">):</span>
+</span><span id="1-669">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-670">
+</span><span id="1-671">        <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="fm">__init__</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+</span><span id="1-672">
+</span><span id="1-673">        <span class="bp">self</span><span class="o">.</span><span class="n">name</span> <span class="o">=</span> <span class="n">name</span>
+</span><span id="1-674">        <span class="bp">self</span><span class="o">.</span><span class="n">source</span> <span class="o">=</span> <span class="n">source</span>
+</span><span id="1-675">        <span class="bp">self</span><span class="o">.</span><span class="n">sample_rate</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[float]</span>
+</span><span id="1-676">        <span class="bp">self</span><span class="o">.</span><span class="n">parent_sampled</span> <span class="o">=</span> <span class="n">parent_sampled</span>
+</span><span id="1-677">        <span class="bp">self</span><span class="o">.</span><span class="n">_measurements</span> <span class="o">=</span> <span class="p">{}</span>  <span class="c1"># type: Dict[str, Any]</span>
+</span><span id="1-678">        <span class="bp">self</span><span class="o">.</span><span class="n">_contexts</span> <span class="o">=</span> <span class="p">{}</span>  <span class="c1"># type: Dict[str, Any]</span>
+</span><span id="1-679">        <span class="bp">self</span><span class="o">.</span><span class="n">_profile</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[sentry_sdk.profiler.Profile]</span>
+</span><span id="1-680">        <span class="bp">self</span><span class="o">.</span><span class="n">_baggage</span> <span class="o">=</span> <span class="n">baggage</span>
+</span><span id="1-681">
+</span><span id="1-682">    <span class="k">def</span> <span class="fm">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-683">        <span class="c1"># type: () -&gt; str</span>
+</span><span id="1-684">        <span class="k">return</span> <span class="p">(</span>
+</span><span id="1-685">            <span class="s2">&quot;&lt;</span><span class="si">%s</span><span class="s2">(name=</span><span class="si">%r</span><span class="s2">, op=</span><span class="si">%r</span><span class="s2">, trace_id=</span><span class="si">%r</span><span class="s2">, span_id=</span><span class="si">%r</span><span class="s2">, parent_span_id=</span><span class="si">%r</span><span class="s2">, sampled=</span><span class="si">%r</span><span class="s2">, source=</span><span class="si">%r</span><span class="s2">)&gt;&quot;</span>
+</span><span id="1-686">            <span class="o">%</span> <span class="p">(</span>
+</span><span id="1-687">                <span class="bp">self</span><span class="o">.</span><span class="vm">__class__</span><span class="o">.</span><span class="vm">__name__</span><span class="p">,</span>
+</span><span id="1-688">                <span class="bp">self</span><span class="o">.</span><span class="n">name</span><span class="p">,</span>
+</span><span id="1-689">                <span class="bp">self</span><span class="o">.</span><span class="n">op</span><span class="p">,</span>
+</span><span id="1-690">                <span class="bp">self</span><span class="o">.</span><span class="n">trace_id</span><span class="p">,</span>
+</span><span id="1-691">                <span class="bp">self</span><span class="o">.</span><span class="n">span_id</span><span class="p">,</span>
+</span><span id="1-692">                <span class="bp">self</span><span class="o">.</span><span class="n">parent_span_id</span><span class="p">,</span>
+</span><span id="1-693">                <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span><span class="p">,</span>
+</span><span id="1-694">                <span class="bp">self</span><span class="o">.</span><span class="n">source</span><span class="p">,</span>
+</span><span id="1-695">            <span class="p">)</span>
+</span><span id="1-696">        <span class="p">)</span>
 </span><span id="1-697">
-</span><span id="1-698">        <span class="c1"># This is a de facto proxy for checking if sampled = False</span>
-</span><span id="1-699">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_span_recorder</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-700">            <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;Discarding transaction because sampled = False&quot;</span><span class="p">)</span>
+</span><span id="1-698">    <span class="k">def</span> <span class="fm">__enter__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-699">        <span class="c1"># type: () -&gt; Transaction</span>
+</span><span id="1-700">        <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="fm">__enter__</span><span class="p">()</span>
 </span><span id="1-701">
-</span><span id="1-702">            <span class="c1"># This is not entirely accurate because discards here are not</span>
-</span><span id="1-703">            <span class="c1"># exclusively based on sample rate but also traces sampler, but</span>
-</span><span id="1-704">            <span class="c1"># we handle this the same here.</span>
-</span><span id="1-705">            <span class="k">if</span> <span class="n">client</span><span class="o">.</span><span class="n">transport</span> <span class="ow">and</span> <span class="n">has_tracing_enabled</span><span class="p">(</span><span class="n">client</span><span class="o">.</span><span class="n">options</span><span class="p">):</span>
-</span><span id="1-706">                <span class="k">if</span> <span class="n">client</span><span class="o">.</span><span class="n">monitor</span> <span class="ow">and</span> <span class="n">client</span><span class="o">.</span><span class="n">monitor</span><span class="o">.</span><span class="n">downsample_factor</span> <span class="o">&gt;</span> <span class="mi">0</span><span class="p">:</span>
-</span><span id="1-707">                    <span class="n">reason</span> <span class="o">=</span> <span class="s2">&quot;backpressure&quot;</span>
-</span><span id="1-708">                <span class="k">else</span><span class="p">:</span>
-</span><span id="1-709">                    <span class="n">reason</span> <span class="o">=</span> <span class="s2">&quot;sample_rate&quot;</span>
-</span><span id="1-710">
-</span><span id="1-711">                <span class="n">client</span><span class="o">.</span><span class="n">transport</span><span class="o">.</span><span class="n">record_lost_event</span><span class="p">(</span><span class="n">reason</span><span class="p">,</span> <span class="n">data_category</span><span class="o">=</span><span class="s2">&quot;transaction&quot;</span><span class="p">)</span>
-</span><span id="1-712">
-</span><span id="1-713">            <span class="k">return</span> <span class="kc">None</span>
-</span><span id="1-714">
-</span><span id="1-715">        <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">name</span><span class="p">:</span>
-</span><span id="1-716">            <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
-</span><span id="1-717">                <span class="s2">&quot;Transaction has no name, falling back to `&lt;unlabeled transaction&gt;`.&quot;</span>
-</span><span id="1-718">            <span class="p">)</span>
-</span><span id="1-719">            <span class="bp">self</span><span class="o">.</span><span class="n">name</span> <span class="o">=</span> <span class="s2">&quot;&lt;unlabeled transaction&gt;&quot;</span>
+</span><span id="1-702">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_profile</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-703">            <span class="bp">self</span><span class="o">.</span><span class="n">_profile</span><span class="o">.</span><span class="fm">__enter__</span><span class="p">()</span>
+</span><span id="1-704">
+</span><span id="1-705">        <span class="k">return</span> <span class="bp">self</span>
+</span><span id="1-706">
+</span><span id="1-707">    <span class="k">def</span> <span class="fm">__exit__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">ty</span><span class="p">,</span> <span class="n">value</span><span class="p">,</span> <span class="n">tb</span><span class="p">):</span>
+</span><span id="1-708">        <span class="c1"># type: (Optional[Any], Optional[Any], Optional[Any]) -&gt; None</span>
+</span><span id="1-709">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_profile</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-710">            <span class="bp">self</span><span class="o">.</span><span class="n">_profile</span><span class="o">.</span><span class="fm">__exit__</span><span class="p">(</span><span class="n">ty</span><span class="p">,</span> <span class="n">value</span><span class="p">,</span> <span class="n">tb</span><span class="p">)</span>
+</span><span id="1-711">
+</span><span id="1-712">        <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="fm">__exit__</span><span class="p">(</span><span class="n">ty</span><span class="p">,</span> <span class="n">value</span><span class="p">,</span> <span class="n">tb</span><span class="p">)</span>
+</span><span id="1-713">
+</span><span id="1-714">    <span class="nd">@property</span>
+</span><span id="1-715">    <span class="k">def</span> <span class="nf">containing_transaction</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-716">        <span class="c1"># type: () -&gt; Transaction</span>
+</span><span id="1-717"><span class="w">        </span><span class="sd">&quot;&quot;&quot;The root element of the span tree.</span>
+</span><span id="1-718"><span class="sd">        In the case of a transaction it is the transaction itself.</span>
+</span><span id="1-719"><span class="sd">        &quot;&quot;&quot;</span>
 </span><span id="1-720">
-</span><span id="1-721">        <span class="nb">super</span><span class="p">(</span><span class="n">Transaction</span><span class="p">,</span> <span class="bp">self</span><span class="p">)</span><span class="o">.</span><span class="n">finish</span><span class="p">(</span><span class="n">hub</span><span class="p">,</span> <span class="n">end_timestamp</span><span class="p">)</span>
-</span><span id="1-722">
-</span><span id="1-723">        <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span><span class="p">:</span>
-</span><span id="1-724">            <span class="c1"># At this point a `sampled = None` should have already been resolved</span>
-</span><span id="1-725">            <span class="c1"># to a concrete decision.</span>
-</span><span id="1-726">            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-727">                <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span><span class="s2">&quot;Discarding transaction without sampling decision.&quot;</span><span class="p">)</span>
-</span><span id="1-728">
-</span><span id="1-729">            <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-721">        <span class="c1"># Transactions (as spans) belong to themselves (as transactions). This</span>
+</span><span id="1-722">        <span class="c1"># is a getter rather than a regular attribute to avoid having a circular</span>
+</span><span id="1-723">        <span class="c1"># reference.</span>
+</span><span id="1-724">        <span class="k">return</span> <span class="bp">self</span>
+</span><span id="1-725">
+<div class="viewcode-block" id="Transaction.finish">
+<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.tracing.Transaction.finish">[docs]</a>
+</span><span id="1-726">    <span class="k">def</span> <span class="nf">finish</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">hub</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">end_timestamp</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+</span><span id="1-727">        <span class="c1"># type: (Optional[Union[sentry_sdk.Hub, sentry_sdk.Scope]], Optional[Union[float, datetime]]) -&gt; Optional[str]</span>
+</span><span id="1-728"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Finishes the transaction and sends it to Sentry.</span>
+</span><span id="1-729"><span class="sd">        All finished spans in the transaction will also be sent to Sentry.</span>
 </span><span id="1-730">
-</span><span id="1-731">        <span class="n">finished_spans</span> <span class="o">=</span> <span class="p">[</span>
-</span><span id="1-732">            <span class="n">span</span><span class="o">.</span><span class="n">to_json</span><span class="p">()</span>
-</span><span id="1-733">            <span class="k">for</span> <span class="n">span</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_span_recorder</span><span class="o">.</span><span class="n">spans</span>
-</span><span id="1-734">            <span class="k">if</span> <span class="n">span</span><span class="o">.</span><span class="n">timestamp</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span>
-</span><span id="1-735">        <span class="p">]</span>
-</span><span id="1-736">
-</span><span id="1-737">        <span class="c1"># we do this to break the circular reference of transaction -&gt; span</span>
-</span><span id="1-738">        <span class="c1"># recorder -&gt; span -&gt; containing transaction (which is where we started)</span>
-</span><span id="1-739">        <span class="c1"># before either the spans or the transaction goes out of scope and has</span>
-</span><span id="1-740">        <span class="c1"># to be garbage collected</span>
-</span><span id="1-741">        <span class="bp">self</span><span class="o">.</span><span class="n">_span_recorder</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="1-731"><span class="sd">        :param hub: The hub to use for this transaction.</span>
+</span><span id="1-732"><span class="sd">            If not provided, the current hub will be used.</span>
+</span><span id="1-733"><span class="sd">        :param end_timestamp: Optional timestamp that should</span>
+</span><span id="1-734"><span class="sd">            be used as timestamp instead of the current time.</span>
+</span><span id="1-735">
+</span><span id="1-736"><span class="sd">        :return: The event ID if the transaction was sent to Sentry,</span>
+</span><span id="1-737"><span class="sd">            otherwise None.</span>
+</span><span id="1-738"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-739">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">timestamp</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-740">            <span class="c1"># This transaction is already finished, ignore.</span>
+</span><span id="1-741">            <span class="k">return</span> <span class="kc">None</span>
 </span><span id="1-742">
-</span><span id="1-743">        <span class="n">contexts</span> <span class="o">=</span> <span class="p">{}</span>
-</span><span id="1-744">        <span class="n">contexts</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_contexts</span><span class="p">)</span>
-</span><span id="1-745">        <span class="n">contexts</span><span class="o">.</span><span class="n">update</span><span class="p">({</span><span class="s2">&quot;trace&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_trace_context</span><span class="p">()})</span>
-</span><span id="1-746">
-</span><span id="1-747">        <span class="n">event</span> <span class="o">=</span> <span class="p">{</span>
-</span><span id="1-748">            <span class="s2">&quot;type&quot;</span><span class="p">:</span> <span class="s2">&quot;transaction&quot;</span><span class="p">,</span>
-</span><span id="1-749">            <span class="s2">&quot;transaction&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">name</span><span class="p">,</span>
-</span><span id="1-750">            <span class="s2">&quot;transaction_info&quot;</span><span class="p">:</span> <span class="p">{</span><span class="s2">&quot;source&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">source</span><span class="p">},</span>
-</span><span id="1-751">            <span class="s2">&quot;contexts&quot;</span><span class="p">:</span> <span class="n">contexts</span><span class="p">,</span>
-</span><span id="1-752">            <span class="s2">&quot;tags&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">_tags</span><span class="p">,</span>
-</span><span id="1-753">            <span class="s2">&quot;timestamp&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">timestamp</span><span class="p">,</span>
-</span><span id="1-754">            <span class="s2">&quot;start_timestamp&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">start_timestamp</span><span class="p">,</span>
-</span><span id="1-755">            <span class="s2">&quot;spans&quot;</span><span class="p">:</span> <span class="n">finished_spans</span><span class="p">,</span>
-</span><span id="1-756">        <span class="p">}</span>  <span class="c1"># type: Event</span>
-</span><span id="1-757">
-</span><span id="1-758">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_profile</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">_profile</span><span class="o">.</span><span class="n">valid</span><span class="p">():</span>
-</span><span id="1-759">            <span class="n">event</span><span class="p">[</span><span class="s2">&quot;profile&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_profile</span>
-</span><span id="1-760">            <span class="bp">self</span><span class="o">.</span><span class="n">_profile</span> <span class="o">=</span> <span class="kc">None</span>
-</span><span id="1-761">
-</span><span id="1-762">        <span class="n">event</span><span class="p">[</span><span class="s2">&quot;measurements&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_measurements</span>
-</span><span id="1-763">
-</span><span id="1-764">        <span class="c1"># This is here since `to_json` is not invoked.  This really should</span>
-</span><span id="1-765">        <span class="c1"># be gone when we switch to onlyspans.</span>
-</span><span id="1-766">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_local_aggregator</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-767">            <span class="n">metrics_summary</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_local_aggregator</span><span class="o">.</span><span class="n">to_json</span><span class="p">()</span>
-</span><span id="1-768">            <span class="k">if</span> <span class="n">metrics_summary</span><span class="p">:</span>
-</span><span id="1-769">                <span class="n">event</span><span class="p">[</span><span class="s2">&quot;_metrics_summary&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">metrics_summary</span>
-</span><span id="1-770">
-</span><span id="1-771">        <span class="k">return</span> <span class="n">hub</span><span class="o">.</span><span class="n">capture_event</span><span class="p">(</span><span class="n">event</span><span class="p">)</span></div>
-
+</span><span id="1-743">        <span class="n">hub</span> <span class="o">=</span> <span class="n">hub</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">hub</span> <span class="ow">or</span> <span class="n">sentry_sdk</span><span class="o">.</span><span class="n">Hub</span><span class="o">.</span><span class="n">current</span>
+</span><span id="1-744">        <span class="n">client</span> <span class="o">=</span> <span class="n">sentry_sdk</span><span class="o">.</span><span class="n">Scope</span><span class="o">.</span><span class="n">get_client</span><span class="p">()</span>
+</span><span id="1-745">
+</span><span id="1-746">        <span class="k">if</span> <span class="ow">not</span> <span class="n">client</span><span class="o">.</span><span class="n">is_active</span><span class="p">():</span>
+</span><span id="1-747">            <span class="c1"># We have no active client and therefore nowhere to send this transaction.</span>
+</span><span id="1-748">            <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-749">
+</span><span id="1-750">        <span class="c1"># This is a de facto proxy for checking if sampled = False</span>
+</span><span id="1-751">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_span_recorder</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-752">            <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;Discarding transaction because sampled = False&quot;</span><span class="p">)</span>
+</span><span id="1-753">
+</span><span id="1-754">            <span class="c1"># This is not entirely accurate because discards here are not</span>
+</span><span id="1-755">            <span class="c1"># exclusively based on sample rate but also traces sampler, but</span>
+</span><span id="1-756">            <span class="c1"># we handle this the same here.</span>
+</span><span id="1-757">            <span class="k">if</span> <span class="n">client</span><span class="o">.</span><span class="n">transport</span> <span class="ow">and</span> <span class="n">has_tracing_enabled</span><span class="p">(</span><span class="n">client</span><span class="o">.</span><span class="n">options</span><span class="p">):</span>
+</span><span id="1-758">                <span class="k">if</span> <span class="n">client</span><span class="o">.</span><span class="n">monitor</span> <span class="ow">and</span> <span class="n">client</span><span class="o">.</span><span class="n">monitor</span><span class="o">.</span><span class="n">downsample_factor</span> <span class="o">&gt;</span> <span class="mi">0</span><span class="p">:</span>
+</span><span id="1-759">                    <span class="n">reason</span> <span class="o">=</span> <span class="s2">&quot;backpressure&quot;</span>
+</span><span id="1-760">                <span class="k">else</span><span class="p">:</span>
+</span><span id="1-761">                    <span class="n">reason</span> <span class="o">=</span> <span class="s2">&quot;sample_rate&quot;</span>
+</span><span id="1-762">
+</span><span id="1-763">                <span class="n">client</span><span class="o">.</span><span class="n">transport</span><span class="o">.</span><span class="n">record_lost_event</span><span class="p">(</span><span class="n">reason</span><span class="p">,</span> <span class="n">data_category</span><span class="o">=</span><span class="s2">&quot;transaction&quot;</span><span class="p">)</span>
+</span><span id="1-764">
+</span><span id="1-765">            <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-766">
+</span><span id="1-767">        <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">name</span><span class="p">:</span>
+</span><span id="1-768">            <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
+</span><span id="1-769">                <span class="s2">&quot;Transaction has no name, falling back to `&lt;unlabeled transaction&gt;`.&quot;</span>
+</span><span id="1-770">            <span class="p">)</span>
+</span><span id="1-771">            <span class="bp">self</span><span class="o">.</span><span class="n">name</span> <span class="o">=</span> <span class="s2">&quot;&lt;unlabeled transaction&gt;&quot;</span>
 </span><span id="1-772">
-</span><span id="1-773">    <span class="k">def</span> <span class="nf">set_measurement</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">value</span><span class="p">,</span> <span class="n">unit</span><span class="o">=</span><span class="s2">&quot;&quot;</span><span class="p">):</span>
-</span><span id="1-774">        <span class="c1"># type: (str, float, MeasurementUnit) -&gt; None</span>
-</span><span id="1-775">        <span class="bp">self</span><span class="o">.</span><span class="n">_measurements</span><span class="p">[</span><span class="n">name</span><span class="p">]</span> <span class="o">=</span> <span class="p">{</span><span class="s2">&quot;value&quot;</span><span class="p">:</span> <span class="n">value</span><span class="p">,</span> <span class="s2">&quot;unit&quot;</span><span class="p">:</span> <span class="n">unit</span><span class="p">}</span>
-</span><span id="1-776">
+</span><span id="1-773">        <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="n">finish</span><span class="p">(</span><span class="n">hub</span><span class="p">,</span> <span class="n">end_timestamp</span><span class="p">)</span>
+</span><span id="1-774">
+</span><span id="1-775">        <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span><span class="p">:</span>
+</span><span id="1-776">            <span class="c1"># At this point a `sampled = None` should have already been resolved</span>
+</span><span id="1-777">            <span class="c1"># to a concrete decision.</span>
+</span><span id="1-778">            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-779">                <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span><span class="s2">&quot;Discarding transaction without sampling decision.&quot;</span><span class="p">)</span>
+</span><span id="1-780">
+</span><span id="1-781">            <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-782">
+</span><span id="1-783">        <span class="n">finished_spans</span> <span class="o">=</span> <span class="p">[</span>
+</span><span id="1-784">            <span class="n">span</span><span class="o">.</span><span class="n">to_json</span><span class="p">()</span>
+</span><span id="1-785">            <span class="k">for</span> <span class="n">span</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_span_recorder</span><span class="o">.</span><span class="n">spans</span>
+</span><span id="1-786">            <span class="k">if</span> <span class="n">span</span><span class="o">.</span><span class="n">timestamp</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span>
+</span><span id="1-787">        <span class="p">]</span>
+</span><span id="1-788">
+</span><span id="1-789">        <span class="c1"># we do this to break the circular reference of transaction -&gt; span</span>
+</span><span id="1-790">        <span class="c1"># recorder -&gt; span -&gt; containing transaction (which is where we started)</span>
+</span><span id="1-791">        <span class="c1"># before either the spans or the transaction goes out of scope and has</span>
+</span><span id="1-792">        <span class="c1"># to be garbage collected</span>
+</span><span id="1-793">        <span class="bp">self</span><span class="o">.</span><span class="n">_span_recorder</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="1-794">
+</span><span id="1-795">        <span class="n">contexts</span> <span class="o">=</span> <span class="p">{}</span>
+</span><span id="1-796">        <span class="n">contexts</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_contexts</span><span class="p">)</span>
+</span><span id="1-797">        <span class="n">contexts</span><span class="o">.</span><span class="n">update</span><span class="p">({</span><span class="s2">&quot;trace&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">get_trace_context</span><span class="p">()})</span>
+</span><span id="1-798">
+</span><span id="1-799">        <span class="n">event</span> <span class="o">=</span> <span class="p">{</span>
+</span><span id="1-800">            <span class="s2">&quot;type&quot;</span><span class="p">:</span> <span class="s2">&quot;transaction&quot;</span><span class="p">,</span>
+</span><span id="1-801">            <span class="s2">&quot;transaction&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">name</span><span class="p">,</span>
+</span><span id="1-802">            <span class="s2">&quot;transaction_info&quot;</span><span class="p">:</span> <span class="p">{</span><span class="s2">&quot;source&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">source</span><span class="p">},</span>
+</span><span id="1-803">            <span class="s2">&quot;contexts&quot;</span><span class="p">:</span> <span class="n">contexts</span><span class="p">,</span>
+</span><span id="1-804">            <span class="s2">&quot;tags&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">_tags</span><span class="p">,</span>
+</span><span id="1-805">            <span class="s2">&quot;timestamp&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">timestamp</span><span class="p">,</span>
+</span><span id="1-806">            <span class="s2">&quot;start_timestamp&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">start_timestamp</span><span class="p">,</span>
+</span><span id="1-807">            <span class="s2">&quot;spans&quot;</span><span class="p">:</span> <span class="n">finished_spans</span><span class="p">,</span>
+</span><span id="1-808">        <span class="p">}</span>  <span class="c1"># type: Event</span>
+</span><span id="1-809">
+</span><span id="1-810">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_profile</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">_profile</span><span class="o">.</span><span class="n">valid</span><span class="p">():</span>
+</span><span id="1-811">            <span class="n">event</span><span class="p">[</span><span class="s2">&quot;profile&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_profile</span>
+</span><span id="1-812">            <span class="bp">self</span><span class="o">.</span><span class="n">_profile</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="1-813">
+</span><span id="1-814">        <span class="n">event</span><span class="p">[</span><span class="s2">&quot;measurements&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_measurements</span>
+</span><span id="1-815">
+</span><span id="1-816">        <span class="c1"># This is here since `to_json` is not invoked.  This really should</span>
+</span><span id="1-817">        <span class="c1"># be gone when we switch to onlyspans.</span>
+</span><span id="1-818">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_local_aggregator</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-819">            <span class="n">metrics_summary</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_local_aggregator</span><span class="o">.</span><span class="n">to_json</span><span class="p">()</span>
+</span><span id="1-820">            <span class="k">if</span> <span class="n">metrics_summary</span><span class="p">:</span>
+</span><span id="1-821">                <span class="n">event</span><span class="p">[</span><span class="s2">&quot;_metrics_summary&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">metrics_summary</span>
+</span><span id="1-822">
+</span><span id="1-823">        <span class="k">return</span> <span class="n">hub</span><span class="o">.</span><span class="n">capture_event</span><span class="p">(</span><span class="n">event</span><span class="p">)</span></div>
+
+</span><span id="1-824">
+</span><span id="1-825">    <span class="k">def</span> <span class="nf">set_measurement</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">value</span><span class="p">,</span> <span class="n">unit</span><span class="o">=</span><span class="s2">&quot;&quot;</span><span class="p">):</span>
+</span><span id="1-826">        <span class="c1"># type: (str, float, MeasurementUnit) -&gt; None</span>
+</span><span id="1-827">        <span class="bp">self</span><span class="o">.</span><span class="n">_measurements</span><span class="p">[</span><span class="n">name</span><span class="p">]</span> <span class="o">=</span> <span class="p">{</span><span class="s2">&quot;value&quot;</span><span class="p">:</span> <span class="n">value</span><span class="p">,</span> <span class="s2">&quot;unit&quot;</span><span class="p">:</span> <span class="n">unit</span><span class="p">}</span>
+</span><span id="1-828">
 <div class="viewcode-block" id="Transaction.set_context">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.tracing.Transaction.set_context">[docs]</a>
-</span><span id="1-777">    <span class="k">def</span> <span class="nf">set_context</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-</span><span id="1-778">        <span class="c1"># type: (str, Any) -&gt; None</span>
-</span><span id="1-779"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Sets a context. Transactions can have multiple contexts</span>
-</span><span id="1-780"><span class="sd">        and they should follow the format described in the &quot;Contexts Interface&quot;</span>
-</span><span id="1-781"><span class="sd">        documentation.</span>
-</span><span id="1-782">
-</span><span id="1-783"><span class="sd">        :param key: The name of the context.</span>
-</span><span id="1-784"><span class="sd">        :param value: The information about the context.</span>
-</span><span id="1-785"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-786">        <span class="bp">self</span><span class="o">.</span><span class="n">_contexts</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="o">=</span> <span class="n">value</span></div>
+</span><span id="1-829">    <span class="k">def</span> <span class="nf">set_context</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
+</span><span id="1-830">        <span class="c1"># type: (str, Any) -&gt; None</span>
+</span><span id="1-831"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Sets a context. Transactions can have multiple contexts</span>
+</span><span id="1-832"><span class="sd">        and they should follow the format described in the &quot;Contexts Interface&quot;</span>
+</span><span id="1-833"><span class="sd">        documentation.</span>
+</span><span id="1-834">
+</span><span id="1-835"><span class="sd">        :param key: The name of the context.</span>
+</span><span id="1-836"><span class="sd">        :param value: The information about the context.</span>
+</span><span id="1-837"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-838">        <span class="bp">self</span><span class="o">.</span><span class="n">_contexts</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="o">=</span> <span class="n">value</span></div>
 
-</span><span id="1-787">
+</span><span id="1-839">
 <div class="viewcode-block" id="Transaction.set_http_status">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.tracing.Transaction.set_http_status">[docs]</a>
-</span><span id="1-788">    <span class="k">def</span> <span class="nf">set_http_status</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">http_status</span><span class="p">):</span>
-</span><span id="1-789">        <span class="c1"># type: (int) -&gt; None</span>
-</span><span id="1-790"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Sets the status of the Transaction according to the given HTTP status.</span>
-</span><span id="1-791">
-</span><span id="1-792"><span class="sd">        :param http_status: The HTTP status code.&quot;&quot;&quot;</span>
-</span><span id="1-793">        <span class="nb">super</span><span class="p">(</span><span class="n">Transaction</span><span class="p">,</span> <span class="bp">self</span><span class="p">)</span><span class="o">.</span><span class="n">set_http_status</span><span class="p">(</span><span class="n">http_status</span><span class="p">)</span>
-</span><span id="1-794">        <span class="bp">self</span><span class="o">.</span><span class="n">set_context</span><span class="p">(</span><span class="s2">&quot;response&quot;</span><span class="p">,</span> <span class="p">{</span><span class="s2">&quot;status_code&quot;</span><span class="p">:</span> <span class="n">http_status</span><span class="p">})</span></div>
+</span><span id="1-840">    <span class="k">def</span> <span class="nf">set_http_status</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">http_status</span><span class="p">):</span>
+</span><span id="1-841">        <span class="c1"># type: (int) -&gt; None</span>
+</span><span id="1-842"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Sets the status of the Transaction according to the given HTTP status.</span>
+</span><span id="1-843">
+</span><span id="1-844"><span class="sd">        :param http_status: The HTTP status code.&quot;&quot;&quot;</span>
+</span><span id="1-845">        <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="n">set_http_status</span><span class="p">(</span><span class="n">http_status</span><span class="p">)</span>
+</span><span id="1-846">        <span class="bp">self</span><span class="o">.</span><span class="n">set_context</span><span class="p">(</span><span class="s2">&quot;response&quot;</span><span class="p">,</span> <span class="p">{</span><span class="s2">&quot;status_code&quot;</span><span class="p">:</span> <span class="n">http_status</span><span class="p">})</span></div>
 
-</span><span id="1-795">
+</span><span id="1-847">
 <div class="viewcode-block" id="Transaction.to_json">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.tracing.Transaction.to_json">[docs]</a>
-</span><span id="1-796">    <span class="k">def</span> <span class="nf">to_json</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-797">        <span class="c1"># type: () -&gt; Dict[str, Any]</span>
-</span><span id="1-798"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Returns a JSON-compatible representation of the transaction.&quot;&quot;&quot;</span>
-</span><span id="1-799">        <span class="n">rv</span> <span class="o">=</span> <span class="nb">super</span><span class="p">(</span><span class="n">Transaction</span><span class="p">,</span> <span class="bp">self</span><span class="p">)</span><span class="o">.</span><span class="n">to_json</span><span class="p">()</span>
-</span><span id="1-800">
-</span><span id="1-801">        <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;name&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">name</span>
-</span><span id="1-802">        <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;source&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">source</span>
-</span><span id="1-803">        <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;sampled&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span>
-</span><span id="1-804">
-</span><span id="1-805">        <span class="k">return</span> <span class="n">rv</span></div>
+</span><span id="1-848">    <span class="k">def</span> <span class="nf">to_json</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-849">        <span class="c1"># type: () -&gt; Dict[str, Any]</span>
+</span><span id="1-850"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Returns a JSON-compatible representation of the transaction.&quot;&quot;&quot;</span>
+</span><span id="1-851">        <span class="n">rv</span> <span class="o">=</span> <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="n">to_json</span><span class="p">()</span>
+</span><span id="1-852">
+</span><span id="1-853">        <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;name&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">name</span>
+</span><span id="1-854">        <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;source&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">source</span>
+</span><span id="1-855">        <span class="n">rv</span><span class="p">[</span><span class="s2">&quot;sampled&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span>
+</span><span id="1-856">
+</span><span id="1-857">        <span class="k">return</span> <span class="n">rv</span></div>
 
-</span><span id="1-806">
+</span><span id="1-858">
 <div class="viewcode-block" id="Transaction.get_baggage">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.tracing.Transaction.get_baggage">[docs]</a>
-</span><span id="1-807">    <span class="k">def</span> <span class="nf">get_baggage</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-808">        <span class="c1"># type: () -&gt; Baggage</span>
-</span><span id="1-809"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Returns the :py:class:`~sentry_sdk.tracing_utils.Baggage`</span>
-</span><span id="1-810"><span class="sd">        associated with the Transaction.</span>
-</span><span id="1-811">
-</span><span id="1-812"><span class="sd">        The first time a new baggage with Sentry items is made,</span>
-</span><span id="1-813"><span class="sd">        it will be frozen.&quot;&quot;&quot;</span>
-</span><span id="1-814">
-</span><span id="1-815">        <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_baggage</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">_baggage</span><span class="o">.</span><span class="n">mutable</span><span class="p">:</span>
-</span><span id="1-816">            <span class="bp">self</span><span class="o">.</span><span class="n">_baggage</span> <span class="o">=</span> <span class="n">Baggage</span><span class="o">.</span><span class="n">populate_from_transaction</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-</span><span id="1-817">
-</span><span id="1-818">        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_baggage</span></div>
-
-</span><span id="1-819">
-</span><span id="1-820">    <span class="k">def</span> <span class="nf">_set_initial_sampling_decision</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">sampling_context</span><span class="p">):</span>
-</span><span id="1-821">        <span class="c1"># type: (SamplingContext) -&gt; None</span>
-</span><span id="1-822"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-823"><span class="sd">        Sets the transaction&#39;s sampling decision, according to the following</span>
-</span><span id="1-824"><span class="sd">        precedence rules:</span>
-</span><span id="1-825">
-</span><span id="1-826"><span class="sd">        1. If a sampling decision is passed to `start_transaction`</span>
-</span><span id="1-827"><span class="sd">        (`start_transaction(name: &quot;my transaction&quot;, sampled: True)`), that</span>
-</span><span id="1-828"><span class="sd">        decision will be used, regardless of anything else</span>
-</span><span id="1-829">
-</span><span id="1-830"><span class="sd">        2. If `traces_sampler` is defined, its decision will be used. It can</span>
-</span><span id="1-831"><span class="sd">        choose to keep or ignore any parent sampling decision, or use the</span>
-</span><span id="1-832"><span class="sd">        sampling context data to make its own decision or to choose a sample</span>
-</span><span id="1-833"><span class="sd">        rate for the transaction.</span>
-</span><span id="1-834">
-</span><span id="1-835"><span class="sd">        3. If `traces_sampler` is not defined, but there&#39;s a parent sampling</span>
-</span><span id="1-836"><span class="sd">        decision, the parent sampling decision will be used.</span>
-</span><span id="1-837">
-</span><span id="1-838"><span class="sd">        4. If `traces_sampler` is not defined and there&#39;s no parent sampling</span>
-</span><span id="1-839"><span class="sd">        decision, `traces_sample_rate` will be used.</span>
-</span><span id="1-840"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-841">
-</span><span id="1-842">        <span class="n">hub</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">hub</span> <span class="ow">or</span> <span class="n">sentry_sdk</span><span class="o">.</span><span class="n">Hub</span><span class="o">.</span><span class="n">current</span>
-</span><span id="1-843">        <span class="n">client</span> <span class="o">=</span> <span class="n">hub</span><span class="o">.</span><span class="n">client</span>
-</span><span id="1-844">        <span class="n">options</span> <span class="o">=</span> <span class="p">(</span><span class="n">client</span> <span class="ow">and</span> <span class="n">client</span><span class="o">.</span><span class="n">options</span><span class="p">)</span> <span class="ow">or</span> <span class="p">{}</span>
-</span><span id="1-845">        <span class="n">transaction_description</span> <span class="o">=</span> <span class="s2">&quot;</span><span class="si">{op}</span><span class="s2">transaction &lt;</span><span class="si">{name}</span><span class="s2">&gt;&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span>
-</span><span id="1-846">            <span class="n">op</span><span class="o">=</span><span class="p">(</span><span class="s2">&quot;&lt;&quot;</span> <span class="o">+</span> <span class="bp">self</span><span class="o">.</span><span class="n">op</span> <span class="o">+</span> <span class="s2">&quot;&gt; &quot;</span> <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">op</span> <span class="k">else</span> <span class="s2">&quot;&quot;</span><span class="p">),</span> <span class="n">name</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">name</span>
-</span><span id="1-847">        <span class="p">)</span>
-</span><span id="1-848">
-</span><span id="1-849">        <span class="c1"># nothing to do if there&#39;s no client or if tracing is disabled</span>
-</span><span id="1-850">        <span class="k">if</span> <span class="ow">not</span> <span class="n">client</span> <span class="ow">or</span> <span class="ow">not</span> <span class="n">has_tracing_enabled</span><span class="p">(</span><span class="n">options</span><span class="p">):</span>
-</span><span id="1-851">            <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span> <span class="o">=</span> <span class="kc">False</span>
-</span><span id="1-852">            <span class="k">return</span>
-</span><span id="1-853">
-</span><span id="1-854">        <span class="c1"># if the user has forced a sampling decision by passing a `sampled`</span>
-</span><span id="1-855">        <span class="c1"># value when starting the transaction, go with that</span>
-</span><span id="1-856">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-857">            <span class="bp">self</span><span class="o">.</span><span class="n">sample_rate</span> <span class="o">=</span> <span class="nb">float</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">sampled</span><span class="p">)</span>
-</span><span id="1-858">            <span class="k">return</span>
-</span><span id="1-859">
-</span><span id="1-860">        <span class="c1"># we would have bailed already if neither `traces_sampler` nor</span>
-</span><span id="1-861">        <span class="c1"># `traces_sample_rate` were defined, so one of these should work; prefer</span>
-</span><span id="1-862">        <span class="c1"># the hook if so</span>
-</span><span id="1-863">        <span class="n">sample_rate</span> <span class="o">=</span> <span class="p">(</span>
-</span><span id="1-864">            <span class="n">options</span><span class="p">[</span><span class="s2">&quot;traces_sampler&quot;</span><span class="p">](</span><span class="n">sampling_context</span><span class="p">)</span>
-</span><span id="1-865">            <span class="k">if</span> <span class="nb">callable</span><span class="p">(</span><span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;traces_sampler&quot;</span><span class="p">))</span>
-</span><span id="1-866">            <span class="k">else</span> <span class="p">(</span>
-</span><span id="1-867">                <span class="c1"># default inheritance behavior</span>
-</span><span id="1-868">                <span class="n">sampling_context</span><span class="p">[</span><span class="s2">&quot;parent_sampled&quot;</span><span class="p">]</span>
-</span><span id="1-869">                <span class="k">if</span> <span class="n">sampling_context</span><span class="p">[</span><span class="s2">&quot;parent_sampled&quot;</span><span class="p">]</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span>
-</span><span id="1-870">                <span class="k">else</span> <span class="n">options</span><span class="p">[</span><span class="s2">&quot;traces_sample_rate&quot;</span><span class="p">]</span>
-</span><span id="1-871">            <span class="p">)</span>
-</span><span id="1-872">        <span class="p">)</span>
-</span><span id="1-873">
-</span><span id="1-874">        <span class="c1"># Since this is coming from the user (or from a function provided by the</span>
-</span><span id="1-875">        <span class="c1"># user), who knows what we might get. (The only valid values are</span>
-</span><span id="1-876">        <span class="c1"># booleans or numbers between 0 and 1.)</span>
-</span><span id="1-877">        <span class="k">if</span> <span class="ow">not</span> <span class="n">is_valid_sample_rate</span><span class="p">(</span><span class="n">sample_rate</span><span class="p">,</span> <span class="n">source</span><span class="o">=</span><span class="s2">&quot;Tracing&quot;</span><span class="p">):</span>
-</span><span id="1-878">            <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
-</span><span id="1-879">                <span class="s2">&quot;[Tracing] Discarding </span><span class="si">{transaction_description}</span><span class="s2"> because of invalid sample rate.&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span>
-</span><span id="1-880">                    <span class="n">transaction_description</span><span class="o">=</span><span class="n">transaction_description</span><span class="p">,</span>
-</span><span id="1-881">                <span class="p">)</span>
-</span><span id="1-882">            <span class="p">)</span>
-</span><span id="1-883">            <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span> <span class="o">=</span> <span class="kc">False</span>
-</span><span id="1-884">            <span class="k">return</span>
-</span><span id="1-885">
-</span><span id="1-886">        <span class="bp">self</span><span class="o">.</span><span class="n">sample_rate</span> <span class="o">=</span> <span class="nb">float</span><span class="p">(</span><span class="n">sample_rate</span><span class="p">)</span>
-</span><span id="1-887">
-</span><span id="1-888">        <span class="k">if</span> <span class="n">client</span><span class="o">.</span><span class="n">monitor</span><span class="p">:</span>
-</span><span id="1-889">            <span class="bp">self</span><span class="o">.</span><span class="n">sample_rate</span> <span class="o">/=</span> <span class="mi">2</span><span class="o">**</span><span class="n">client</span><span class="o">.</span><span class="n">monitor</span><span class="o">.</span><span class="n">downsample_factor</span>
-</span><span id="1-890">
-</span><span id="1-891">        <span class="c1"># if the function returned 0 (or false), or if `traces_sample_rate` is</span>
-</span><span id="1-892">        <span class="c1"># 0, it&#39;s a sign the transaction should be dropped</span>
-</span><span id="1-893">        <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">sample_rate</span><span class="p">:</span>
-</span><span id="1-894">            <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span>
-</span><span id="1-895">                <span class="s2">&quot;[Tracing] Discarding </span><span class="si">{transaction_description}</span><span class="s2"> because </span><span class="si">{reason}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span>
-</span><span id="1-896">                    <span class="n">transaction_description</span><span class="o">=</span><span class="n">transaction_description</span><span class="p">,</span>
-</span><span id="1-897">                    <span class="n">reason</span><span class="o">=</span><span class="p">(</span>
-</span><span id="1-898">                        <span class="s2">&quot;traces_sampler returned 0 or False&quot;</span>
-</span><span id="1-899">                        <span class="k">if</span> <span class="nb">callable</span><span class="p">(</span><span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;traces_sampler&quot;</span><span class="p">))</span>
-</span><span id="1-900">                        <span class="k">else</span> <span class="s2">&quot;traces_sample_rate is set to 0&quot;</span>
-</span><span id="1-901">                    <span class="p">),</span>
-</span><span id="1-902">                <span class="p">)</span>
-</span><span id="1-903">            <span class="p">)</span>
-</span><span id="1-904">            <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span> <span class="o">=</span> <span class="kc">False</span>
-</span><span id="1-905">            <span class="k">return</span>
-</span><span id="1-906">
-</span><span id="1-907">        <span class="c1"># Now we roll the dice. random.random is inclusive of 0, but not of 1,</span>
-</span><span id="1-908">        <span class="c1"># so strict &lt; is safe here. In case sample_rate is a boolean, cast it</span>
-</span><span id="1-909">        <span class="c1"># to a float (True becomes 1.0 and False becomes 0.0)</span>
-</span><span id="1-910">        <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span> <span class="o">=</span> <span class="n">random</span><span class="o">.</span><span class="n">random</span><span class="p">()</span> <span class="o">&lt;</span> <span class="bp">self</span><span class="o">.</span><span class="n">sample_rate</span>
-</span><span id="1-911">
-</span><span id="1-912">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span><span class="p">:</span>
-</span><span id="1-913">            <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span>
-</span><span id="1-914">                <span class="s2">&quot;[Tracing] Starting </span><span class="si">{transaction_description}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span>
-</span><span id="1-915">                    <span class="n">transaction_description</span><span class="o">=</span><span class="n">transaction_description</span><span class="p">,</span>
-</span><span id="1-916">                <span class="p">)</span>
-</span><span id="1-917">            <span class="p">)</span>
-</span><span id="1-918">        <span class="k">else</span><span class="p">:</span>
-</span><span id="1-919">            <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span>
-</span><span id="1-920">                <span class="s2">&quot;[Tracing] Discarding </span><span class="si">{transaction_description}</span><span class="s2"> because it&#39;s not included in the random sample (sampling rate = </span><span class="si">{sample_rate}</span><span class="s2">)&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span>
-</span><span id="1-921">                    <span class="n">transaction_description</span><span class="o">=</span><span class="n">transaction_description</span><span class="p">,</span>
-</span><span id="1-922">                    <span class="n">sample_rate</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">sample_rate</span><span class="p">,</span>
-</span><span id="1-923">                <span class="p">)</span>
-</span><span id="1-924">            <span class="p">)</span></div>
+</span><span id="1-859">    <span class="k">def</span> <span class="nf">get_baggage</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-860">        <span class="c1"># type: () -&gt; Baggage</span>
+</span><span id="1-861"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Returns the :py:class:`~sentry_sdk.tracing_utils.Baggage`</span>
+</span><span id="1-862"><span class="sd">        associated with the Transaction.</span>
+</span><span id="1-863">
+</span><span id="1-864"><span class="sd">        The first time a new baggage with Sentry items is made,</span>
+</span><span id="1-865"><span class="sd">        it will be frozen.&quot;&quot;&quot;</span>
+</span><span id="1-866">
+</span><span id="1-867">        <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_baggage</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">_baggage</span><span class="o">.</span><span class="n">mutable</span><span class="p">:</span>
+</span><span id="1-868">            <span class="bp">self</span><span class="o">.</span><span class="n">_baggage</span> <span class="o">=</span> <span class="n">Baggage</span><span class="o">.</span><span class="n">populate_from_transaction</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
+</span><span id="1-869">
+</span><span id="1-870">        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_baggage</span></div>
 
-</span><span id="1-925">
-</span><span id="1-926">
-</span><span id="1-927"><span class="k">class</span> <span class="nc">NoOpSpan</span><span class="p">(</span><span class="n">Span</span><span class="p">):</span>
-</span><span id="1-928">    <span class="k">def</span> <span class="fm">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-929">        <span class="c1"># type: () -&gt; str</span>
-</span><span id="1-930">        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="vm">__class__</span><span class="o">.</span><span class="vm">__name__</span>
-</span><span id="1-931">
-</span><span id="1-932">    <span class="nd">@property</span>
-</span><span id="1-933">    <span class="k">def</span> <span class="nf">containing_transaction</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-934">        <span class="c1"># type: () -&gt; Optional[Transaction]</span>
-</span><span id="1-935">        <span class="k">return</span> <span class="kc">None</span>
-</span><span id="1-936">
-</span><span id="1-937">    <span class="k">def</span> <span class="nf">start_child</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">instrumenter</span><span class="o">=</span><span class="n">INSTRUMENTER</span><span class="o">.</span><span class="n">SENTRY</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-</span><span id="1-938">        <span class="c1"># type: (str, **Any) -&gt; NoOpSpan</span>
-</span><span id="1-939">        <span class="k">return</span> <span class="n">NoOpSpan</span><span class="p">()</span>
+</span><span id="1-871">
+</span><span id="1-872">    <span class="k">def</span> <span class="nf">_set_initial_sampling_decision</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">sampling_context</span><span class="p">):</span>
+</span><span id="1-873">        <span class="c1"># type: (SamplingContext) -&gt; None</span>
+</span><span id="1-874"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-875"><span class="sd">        Sets the transaction&#39;s sampling decision, according to the following</span>
+</span><span id="1-876"><span class="sd">        precedence rules:</span>
+</span><span id="1-877">
+</span><span id="1-878"><span class="sd">        1. If a sampling decision is passed to `start_transaction`</span>
+</span><span id="1-879"><span class="sd">        (`start_transaction(name: &quot;my transaction&quot;, sampled: True)`), that</span>
+</span><span id="1-880"><span class="sd">        decision will be used, regardless of anything else</span>
+</span><span id="1-881">
+</span><span id="1-882"><span class="sd">        2. If `traces_sampler` is defined, its decision will be used. It can</span>
+</span><span id="1-883"><span class="sd">        choose to keep or ignore any parent sampling decision, or use the</span>
+</span><span id="1-884"><span class="sd">        sampling context data to make its own decision or to choose a sample</span>
+</span><span id="1-885"><span class="sd">        rate for the transaction.</span>
+</span><span id="1-886">
+</span><span id="1-887"><span class="sd">        3. If `traces_sampler` is not defined, but there&#39;s a parent sampling</span>
+</span><span id="1-888"><span class="sd">        decision, the parent sampling decision will be used.</span>
+</span><span id="1-889">
+</span><span id="1-890"><span class="sd">        4. If `traces_sampler` is not defined and there&#39;s no parent sampling</span>
+</span><span id="1-891"><span class="sd">        decision, `traces_sample_rate` will be used.</span>
+</span><span id="1-892"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-893">        <span class="n">client</span> <span class="o">=</span> <span class="n">sentry_sdk</span><span class="o">.</span><span class="n">Scope</span><span class="o">.</span><span class="n">get_client</span><span class="p">()</span>
+</span><span id="1-894">
+</span><span id="1-895">        <span class="n">transaction_description</span> <span class="o">=</span> <span class="s2">&quot;</span><span class="si">{op}</span><span class="s2">transaction &lt;</span><span class="si">{name}</span><span class="s2">&gt;&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span>
+</span><span id="1-896">            <span class="n">op</span><span class="o">=</span><span class="p">(</span><span class="s2">&quot;&lt;&quot;</span> <span class="o">+</span> <span class="bp">self</span><span class="o">.</span><span class="n">op</span> <span class="o">+</span> <span class="s2">&quot;&gt; &quot;</span> <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">op</span> <span class="k">else</span> <span class="s2">&quot;&quot;</span><span class="p">),</span> <span class="n">name</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">name</span>
+</span><span id="1-897">        <span class="p">)</span>
+</span><span id="1-898">
+</span><span id="1-899">        <span class="c1"># nothing to do if tracing is disabled</span>
+</span><span id="1-900">        <span class="k">if</span> <span class="ow">not</span> <span class="n">has_tracing_enabled</span><span class="p">(</span><span class="n">client</span><span class="o">.</span><span class="n">options</span><span class="p">):</span>
+</span><span id="1-901">            <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span> <span class="o">=</span> <span class="kc">False</span>
+</span><span id="1-902">            <span class="k">return</span>
+</span><span id="1-903">
+</span><span id="1-904">        <span class="c1"># if the user has forced a sampling decision by passing a `sampled`</span>
+</span><span id="1-905">        <span class="c1"># value when starting the transaction, go with that</span>
+</span><span id="1-906">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-907">            <span class="bp">self</span><span class="o">.</span><span class="n">sample_rate</span> <span class="o">=</span> <span class="nb">float</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">sampled</span><span class="p">)</span>
+</span><span id="1-908">            <span class="k">return</span>
+</span><span id="1-909">
+</span><span id="1-910">        <span class="c1"># we would have bailed already if neither `traces_sampler` nor</span>
+</span><span id="1-911">        <span class="c1"># `traces_sample_rate` were defined, so one of these should work; prefer</span>
+</span><span id="1-912">        <span class="c1"># the hook if so</span>
+</span><span id="1-913">        <span class="n">sample_rate</span> <span class="o">=</span> <span class="p">(</span>
+</span><span id="1-914">            <span class="n">client</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;traces_sampler&quot;</span><span class="p">](</span><span class="n">sampling_context</span><span class="p">)</span>
+</span><span id="1-915">            <span class="k">if</span> <span class="nb">callable</span><span class="p">(</span><span class="n">client</span><span class="o">.</span><span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;traces_sampler&quot;</span><span class="p">))</span>
+</span><span id="1-916">            <span class="k">else</span> <span class="p">(</span>
+</span><span id="1-917">                <span class="c1"># default inheritance behavior</span>
+</span><span id="1-918">                <span class="n">sampling_context</span><span class="p">[</span><span class="s2">&quot;parent_sampled&quot;</span><span class="p">]</span>
+</span><span id="1-919">                <span class="k">if</span> <span class="n">sampling_context</span><span class="p">[</span><span class="s2">&quot;parent_sampled&quot;</span><span class="p">]</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span>
+</span><span id="1-920">                <span class="k">else</span> <span class="n">client</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;traces_sample_rate&quot;</span><span class="p">]</span>
+</span><span id="1-921">            <span class="p">)</span>
+</span><span id="1-922">        <span class="p">)</span>
+</span><span id="1-923">
+</span><span id="1-924">        <span class="c1"># Since this is coming from the user (or from a function provided by the</span>
+</span><span id="1-925">        <span class="c1"># user), who knows what we might get. (The only valid values are</span>
+</span><span id="1-926">        <span class="c1"># booleans or numbers between 0 and 1.)</span>
+</span><span id="1-927">        <span class="k">if</span> <span class="ow">not</span> <span class="n">is_valid_sample_rate</span><span class="p">(</span><span class="n">sample_rate</span><span class="p">,</span> <span class="n">source</span><span class="o">=</span><span class="s2">&quot;Tracing&quot;</span><span class="p">):</span>
+</span><span id="1-928">            <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
+</span><span id="1-929">                <span class="s2">&quot;[Tracing] Discarding </span><span class="si">{transaction_description}</span><span class="s2"> because of invalid sample rate.&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span>
+</span><span id="1-930">                    <span class="n">transaction_description</span><span class="o">=</span><span class="n">transaction_description</span><span class="p">,</span>
+</span><span id="1-931">                <span class="p">)</span>
+</span><span id="1-932">            <span class="p">)</span>
+</span><span id="1-933">            <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span> <span class="o">=</span> <span class="kc">False</span>
+</span><span id="1-934">            <span class="k">return</span>
+</span><span id="1-935">
+</span><span id="1-936">        <span class="bp">self</span><span class="o">.</span><span class="n">sample_rate</span> <span class="o">=</span> <span class="nb">float</span><span class="p">(</span><span class="n">sample_rate</span><span class="p">)</span>
+</span><span id="1-937">
+</span><span id="1-938">        <span class="k">if</span> <span class="n">client</span><span class="o">.</span><span class="n">monitor</span><span class="p">:</span>
+</span><span id="1-939">            <span class="bp">self</span><span class="o">.</span><span class="n">sample_rate</span> <span class="o">/=</span> <span class="mi">2</span><span class="o">**</span><span class="n">client</span><span class="o">.</span><span class="n">monitor</span><span class="o">.</span><span class="n">downsample_factor</span>
 </span><span id="1-940">
-</span><span id="1-941">    <span class="k">def</span> <span class="nf">new_span</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-</span><span id="1-942">        <span class="c1"># type: (**Any) -&gt; NoOpSpan</span>
-</span><span id="1-943">        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">start_child</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-</span><span id="1-944">
-</span><span id="1-945">    <span class="k">def</span> <span class="nf">to_traceparent</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-946">        <span class="c1"># type: () -&gt; str</span>
-</span><span id="1-947">        <span class="k">return</span> <span class="s2">&quot;&quot;</span>
-</span><span id="1-948">
-</span><span id="1-949">    <span class="k">def</span> <span class="nf">to_baggage</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-950">        <span class="c1"># type: () -&gt; Optional[Baggage]</span>
-</span><span id="1-951">        <span class="k">return</span> <span class="kc">None</span>
-</span><span id="1-952">
-</span><span id="1-953">    <span class="k">def</span> <span class="nf">get_baggage</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-954">        <span class="c1"># type: () -&gt; Optional[Baggage]</span>
-</span><span id="1-955">        <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-941">        <span class="c1"># if the function returned 0 (or false), or if `traces_sample_rate` is</span>
+</span><span id="1-942">        <span class="c1"># 0, it&#39;s a sign the transaction should be dropped</span>
+</span><span id="1-943">        <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">sample_rate</span><span class="p">:</span>
+</span><span id="1-944">            <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span>
+</span><span id="1-945">                <span class="s2">&quot;[Tracing] Discarding </span><span class="si">{transaction_description}</span><span class="s2"> because </span><span class="si">{reason}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span>
+</span><span id="1-946">                    <span class="n">transaction_description</span><span class="o">=</span><span class="n">transaction_description</span><span class="p">,</span>
+</span><span id="1-947">                    <span class="n">reason</span><span class="o">=</span><span class="p">(</span>
+</span><span id="1-948">                        <span class="s2">&quot;traces_sampler returned 0 or False&quot;</span>
+</span><span id="1-949">                        <span class="k">if</span> <span class="nb">callable</span><span class="p">(</span><span class="n">client</span><span class="o">.</span><span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;traces_sampler&quot;</span><span class="p">))</span>
+</span><span id="1-950">                        <span class="k">else</span> <span class="s2">&quot;traces_sample_rate is set to 0&quot;</span>
+</span><span id="1-951">                    <span class="p">),</span>
+</span><span id="1-952">                <span class="p">)</span>
+</span><span id="1-953">            <span class="p">)</span>
+</span><span id="1-954">            <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span> <span class="o">=</span> <span class="kc">False</span>
+</span><span id="1-955">            <span class="k">return</span>
 </span><span id="1-956">
-</span><span id="1-957">    <span class="k">def</span> <span class="nf">iter_headers</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-958">        <span class="c1"># type: () -&gt; Iterator[Tuple[str, str]]</span>
-</span><span id="1-959">        <span class="k">return</span> <span class="nb">iter</span><span class="p">(())</span>
-</span><span id="1-960">
-</span><span id="1-961">    <span class="k">def</span> <span class="nf">set_tag</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-</span><span id="1-962">        <span class="c1"># type: (str, Any) -&gt; None</span>
-</span><span id="1-963">        <span class="k">pass</span>
-</span><span id="1-964">
-</span><span id="1-965">    <span class="k">def</span> <span class="nf">set_data</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-</span><span id="1-966">        <span class="c1"># type: (str, Any) -&gt; None</span>
-</span><span id="1-967">        <span class="k">pass</span>
-</span><span id="1-968">
-</span><span id="1-969">    <span class="k">def</span> <span class="nf">set_status</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-</span><span id="1-970">        <span class="c1"># type: (str) -&gt; None</span>
-</span><span id="1-971">        <span class="k">pass</span>
-</span><span id="1-972">
-</span><span id="1-973">    <span class="k">def</span> <span class="nf">set_http_status</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">http_status</span><span class="p">):</span>
-</span><span id="1-974">        <span class="c1"># type: (int) -&gt; None</span>
-</span><span id="1-975">        <span class="k">pass</span>
+</span><span id="1-957">        <span class="c1"># Now we roll the dice. random.random is inclusive of 0, but not of 1,</span>
+</span><span id="1-958">        <span class="c1"># so strict &lt; is safe here. In case sample_rate is a boolean, cast it</span>
+</span><span id="1-959">        <span class="c1"># to a float (True becomes 1.0 and False becomes 0.0)</span>
+</span><span id="1-960">        <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span> <span class="o">=</span> <span class="n">random</span><span class="o">.</span><span class="n">random</span><span class="p">()</span> <span class="o">&lt;</span> <span class="bp">self</span><span class="o">.</span><span class="n">sample_rate</span>
+</span><span id="1-961">
+</span><span id="1-962">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">sampled</span><span class="p">:</span>
+</span><span id="1-963">            <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span>
+</span><span id="1-964">                <span class="s2">&quot;[Tracing] Starting </span><span class="si">{transaction_description}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span>
+</span><span id="1-965">                    <span class="n">transaction_description</span><span class="o">=</span><span class="n">transaction_description</span><span class="p">,</span>
+</span><span id="1-966">                <span class="p">)</span>
+</span><span id="1-967">            <span class="p">)</span>
+</span><span id="1-968">        <span class="k">else</span><span class="p">:</span>
+</span><span id="1-969">            <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span>
+</span><span id="1-970">                <span class="s2">&quot;[Tracing] Discarding </span><span class="si">{transaction_description}</span><span class="s2"> because it&#39;s not included in the random sample (sampling rate = </span><span class="si">{sample_rate}</span><span class="s2">)&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span>
+</span><span id="1-971">                    <span class="n">transaction_description</span><span class="o">=</span><span class="n">transaction_description</span><span class="p">,</span>
+</span><span id="1-972">                    <span class="n">sample_rate</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">sample_rate</span><span class="p">,</span>
+</span><span id="1-973">                <span class="p">)</span>
+</span><span id="1-974">            <span class="p">)</span></div>
+
+</span><span id="1-975">
 </span><span id="1-976">
-</span><span id="1-977">    <span class="k">def</span> <span class="nf">is_success</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-978">        <span class="c1"># type: () -&gt; bool</span>
-</span><span id="1-979">        <span class="k">return</span> <span class="kc">True</span>
-</span><span id="1-980">
-</span><span id="1-981">    <span class="k">def</span> <span class="nf">to_json</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-982">        <span class="c1"># type: () -&gt; Dict[str, Any]</span>
-</span><span id="1-983">        <span class="k">return</span> <span class="p">{}</span>
-</span><span id="1-984">
-</span><span id="1-985">    <span class="k">def</span> <span class="nf">get_trace_context</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-986">        <span class="c1"># type: () -&gt; Any</span>
-</span><span id="1-987">        <span class="k">return</span> <span class="p">{}</span>
-</span><span id="1-988">
-</span><span id="1-989">    <span class="k">def</span> <span class="nf">finish</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">hub</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">end_timestamp</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-</span><span id="1-990">        <span class="c1"># type: (Optional[sentry_sdk.Hub], Optional[Union[float, datetime]]) -&gt; Optional[str]</span>
-</span><span id="1-991">        <span class="k">pass</span>
-</span><span id="1-992">
-</span><span id="1-993">    <span class="k">def</span> <span class="nf">set_measurement</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">value</span><span class="p">,</span> <span class="n">unit</span><span class="o">=</span><span class="s2">&quot;&quot;</span><span class="p">):</span>
-</span><span id="1-994">        <span class="c1"># type: (str, float, MeasurementUnit) -&gt; None</span>
-</span><span id="1-995">        <span class="k">pass</span>
-</span><span id="1-996">
-</span><span id="1-997">    <span class="k">def</span> <span class="nf">set_context</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-</span><span id="1-998">        <span class="c1"># type: (str, Any) -&gt; None</span>
-</span><span id="1-999">        <span class="k">pass</span>
-</span><span id="1-1000">
-</span><span id="1-1001">    <span class="k">def</span> <span class="nf">init_span_recorder</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">maxlen</span><span class="p">):</span>
-</span><span id="1-1002">        <span class="c1"># type: (int) -&gt; None</span>
-</span><span id="1-1003">        <span class="k">pass</span>
-</span><span id="1-1004">
-</span><span id="1-1005">    <span class="k">def</span> <span class="nf">_set_initial_sampling_decision</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">sampling_context</span><span class="p">):</span>
-</span><span id="1-1006">        <span class="c1"># type: (SamplingContext) -&gt; None</span>
-</span><span id="1-1007">        <span class="k">pass</span>
-</span><span id="1-1008">
-</span><span id="1-1009">
-</span><span id="1-1010"><span class="k">if</span> <span class="n">TYPE_CHECKING</span><span class="p">:</span>
-</span><span id="1-1011">
-</span><span id="1-1012">    <span class="nd">@overload</span>
-</span><span id="1-1013">    <span class="k">def</span> <span class="nf">trace</span><span class="p">(</span><span class="n">func</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-</span><span id="1-1014">        <span class="c1"># type: (None) -&gt; Callable[[Callable[P, R]], Callable[P, R]]</span>
-</span><span id="1-1015">        <span class="k">pass</span>
-</span><span id="1-1016">
-</span><span id="1-1017">    <span class="nd">@overload</span>
-</span><span id="1-1018">    <span class="k">def</span> <span class="nf">trace</span><span class="p">(</span><span class="n">func</span><span class="p">):</span>
-</span><span id="1-1019">        <span class="c1"># type: (Callable[P, R]) -&gt; Callable[P, R]</span>
-</span><span id="1-1020">        <span class="k">pass</span>
-</span><span id="1-1021">
+</span><span id="1-977"><span class="k">class</span> <span class="nc">NoOpSpan</span><span class="p">(</span><span class="n">Span</span><span class="p">):</span>
+</span><span id="1-978">    <span class="k">def</span> <span class="fm">__repr__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-979">        <span class="c1"># type: () -&gt; str</span>
+</span><span id="1-980">        <span class="k">return</span> <span class="s2">&quot;&lt;</span><span class="si">%s</span><span class="s2">&gt;&quot;</span> <span class="o">%</span> <span class="bp">self</span><span class="o">.</span><span class="vm">__class__</span><span class="o">.</span><span class="vm">__name__</span>
+</span><span id="1-981">
+</span><span id="1-982">    <span class="nd">@property</span>
+</span><span id="1-983">    <span class="k">def</span> <span class="nf">containing_transaction</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-984">        <span class="c1"># type: () -&gt; Optional[Transaction]</span>
+</span><span id="1-985">        <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-986">
+</span><span id="1-987">    <span class="k">def</span> <span class="nf">start_child</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">instrumenter</span><span class="o">=</span><span class="n">INSTRUMENTER</span><span class="o">.</span><span class="n">SENTRY</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
+</span><span id="1-988">        <span class="c1"># type: (str, **Any) -&gt; NoOpSpan</span>
+</span><span id="1-989">        <span class="k">return</span> <span class="n">NoOpSpan</span><span class="p">()</span>
+</span><span id="1-990">
+</span><span id="1-991">    <span class="k">def</span> <span class="nf">to_traceparent</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-992">        <span class="c1"># type: () -&gt; str</span>
+</span><span id="1-993">        <span class="k">return</span> <span class="s2">&quot;&quot;</span>
+</span><span id="1-994">
+</span><span id="1-995">    <span class="k">def</span> <span class="nf">to_baggage</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-996">        <span class="c1"># type: () -&gt; Optional[Baggage]</span>
+</span><span id="1-997">        <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-998">
+</span><span id="1-999">    <span class="k">def</span> <span class="nf">get_baggage</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-1000">        <span class="c1"># type: () -&gt; Optional[Baggage]</span>
+</span><span id="1-1001">        <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-1002">
+</span><span id="1-1003">    <span class="k">def</span> <span class="nf">iter_headers</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-1004">        <span class="c1"># type: () -&gt; Iterator[Tuple[str, str]]</span>
+</span><span id="1-1005">        <span class="k">return</span> <span class="nb">iter</span><span class="p">(())</span>
+</span><span id="1-1006">
+</span><span id="1-1007">    <span class="k">def</span> <span class="nf">set_tag</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
+</span><span id="1-1008">        <span class="c1"># type: (str, Any) -&gt; None</span>
+</span><span id="1-1009">        <span class="k">pass</span>
+</span><span id="1-1010">
+</span><span id="1-1011">    <span class="k">def</span> <span class="nf">set_data</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
+</span><span id="1-1012">        <span class="c1"># type: (str, Any) -&gt; None</span>
+</span><span id="1-1013">        <span class="k">pass</span>
+</span><span id="1-1014">
+</span><span id="1-1015">    <span class="k">def</span> <span class="nf">set_status</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
+</span><span id="1-1016">        <span class="c1"># type: (str) -&gt; None</span>
+</span><span id="1-1017">        <span class="k">pass</span>
+</span><span id="1-1018">
+</span><span id="1-1019">    <span class="k">def</span> <span class="nf">set_http_status</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">http_status</span><span class="p">):</span>
+</span><span id="1-1020">        <span class="c1"># type: (int) -&gt; None</span>
+</span><span id="1-1021">        <span class="k">pass</span>
 </span><span id="1-1022">
-</span><span id="1-1023"><span class="k">def</span> <span class="nf">trace</span><span class="p">(</span><span class="n">func</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-</span><span id="1-1024">    <span class="c1"># type: (Optional[Callable[P, R]]) -&gt; Union[Callable[P, R], Callable[[Callable[P, R]], Callable[P, R]]]</span>
-</span><span id="1-1025"><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-1026"><span class="sd">    Decorator to start a child span under the existing current transaction.</span>
-</span><span id="1-1027"><span class="sd">    If there is no current transaction, then nothing will be traced.</span>
-</span><span id="1-1028">
-</span><span id="1-1029"><span class="sd">    .. code-block::</span>
-</span><span id="1-1030"><span class="sd">        :caption: Usage</span>
-</span><span id="1-1031">
-</span><span id="1-1032"><span class="sd">        import sentry_sdk</span>
-</span><span id="1-1033">
-</span><span id="1-1034"><span class="sd">        @sentry_sdk.trace</span>
-</span><span id="1-1035"><span class="sd">        def my_function():</span>
-</span><span id="1-1036"><span class="sd">            ...</span>
-</span><span id="1-1037">
-</span><span id="1-1038"><span class="sd">        @sentry_sdk.trace</span>
-</span><span id="1-1039"><span class="sd">        async def my_async_function():</span>
-</span><span id="1-1040"><span class="sd">            ...</span>
-</span><span id="1-1041"><span class="sd">    &quot;&quot;&quot;</span>
-</span><span id="1-1042">    <span class="k">if</span> <span class="n">PY2</span><span class="p">:</span>
-</span><span id="1-1043">        <span class="kn">from</span> <span class="nn">sentry_sdk.tracing_utils_py2</span> <span class="kn">import</span> <span class="n">start_child_span_decorator</span>
-</span><span id="1-1044">    <span class="k">else</span><span class="p">:</span>
-</span><span id="1-1045">        <span class="kn">from</span> <span class="nn">sentry_sdk.tracing_utils_py3</span> <span class="kn">import</span> <span class="n">start_child_span_decorator</span>
+</span><span id="1-1023">    <span class="k">def</span> <span class="nf">is_success</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-1024">        <span class="c1"># type: () -&gt; bool</span>
+</span><span id="1-1025">        <span class="k">return</span> <span class="kc">True</span>
+</span><span id="1-1026">
+</span><span id="1-1027">    <span class="k">def</span> <span class="nf">to_json</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-1028">        <span class="c1"># type: () -&gt; Dict[str, Any]</span>
+</span><span id="1-1029">        <span class="k">return</span> <span class="p">{}</span>
+</span><span id="1-1030">
+</span><span id="1-1031">    <span class="k">def</span> <span class="nf">get_trace_context</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-1032">        <span class="c1"># type: () -&gt; Any</span>
+</span><span id="1-1033">        <span class="k">return</span> <span class="p">{}</span>
+</span><span id="1-1034">
+</span><span id="1-1035">    <span class="k">def</span> <span class="nf">finish</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">hub</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">end_timestamp</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+</span><span id="1-1036">        <span class="c1"># type: (Optional[Union[sentry_sdk.Hub, sentry_sdk.Scope]], Optional[Union[float, datetime]]) -&gt; Optional[str]</span>
+</span><span id="1-1037">        <span class="k">pass</span>
+</span><span id="1-1038">
+</span><span id="1-1039">    <span class="k">def</span> <span class="nf">set_measurement</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">,</span> <span class="n">value</span><span class="p">,</span> <span class="n">unit</span><span class="o">=</span><span class="s2">&quot;&quot;</span><span class="p">):</span>
+</span><span id="1-1040">        <span class="c1"># type: (str, float, MeasurementUnit) -&gt; None</span>
+</span><span id="1-1041">        <span class="k">pass</span>
+</span><span id="1-1042">
+</span><span id="1-1043">    <span class="k">def</span> <span class="nf">set_context</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
+</span><span id="1-1044">        <span class="c1"># type: (str, Any) -&gt; None</span>
+</span><span id="1-1045">        <span class="k">pass</span>
 </span><span id="1-1046">
-</span><span id="1-1047">    <span class="c1"># This patterns allows usage of both @sentry_traced and @sentry_traced(...)</span>
-</span><span id="1-1048">    <span class="c1"># See https://stackoverflow.com/questions/52126071/decorator-with-arguments-avoid-parenthesis-when-no-arguments/52126278</span>
-</span><span id="1-1049">    <span class="k">if</span> <span class="n">func</span><span class="p">:</span>
-</span><span id="1-1050">        <span class="k">return</span> <span class="n">start_child_span_decorator</span><span class="p">(</span><span class="n">func</span><span class="p">)</span>
-</span><span id="1-1051">    <span class="k">else</span><span class="p">:</span>
-</span><span id="1-1052">        <span class="k">return</span> <span class="n">start_child_span_decorator</span>
-</span><span id="1-1053">
+</span><span id="1-1047">    <span class="k">def</span> <span class="nf">init_span_recorder</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">maxlen</span><span class="p">):</span>
+</span><span id="1-1048">        <span class="c1"># type: (int) -&gt; None</span>
+</span><span id="1-1049">        <span class="k">pass</span>
+</span><span id="1-1050">
+</span><span id="1-1051">    <span class="k">def</span> <span class="nf">_set_initial_sampling_decision</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">sampling_context</span><span class="p">):</span>
+</span><span id="1-1052">        <span class="c1"># type: (SamplingContext) -&gt; None</span>
+</span><span id="1-1053">        <span class="k">pass</span>
 </span><span id="1-1054">
-</span><span id="1-1055"><span class="c1"># Circular imports</span>
-</span><span id="1-1056">
-</span><span id="1-1057"><span class="kn">from</span> <span class="nn">sentry_sdk.tracing_utils</span> <span class="kn">import</span> <span class="p">(</span>
-</span><span id="1-1058">    <span class="n">Baggage</span><span class="p">,</span>
-</span><span id="1-1059">    <span class="n">EnvironHeaders</span><span class="p">,</span>
-</span><span id="1-1060">    <span class="n">extract_sentrytrace_data</span><span class="p">,</span>
-</span><span id="1-1061">    <span class="n">has_tracing_enabled</span><span class="p">,</span>
-</span><span id="1-1062">    <span class="n">maybe_create_breadcrumbs_from_span</span><span class="p">,</span>
-</span><span id="1-1063"><span class="p">)</span>
-</span><span id="1-1064"><span class="kn">from</span> <span class="nn">sentry_sdk.metrics</span> <span class="kn">import</span> <span class="n">LocalAggregator</span>
+</span><span id="1-1055">
+</span><span id="1-1056"><span class="k">if</span> <span class="n">TYPE_CHECKING</span><span class="p">:</span>
+</span><span id="1-1057">
+</span><span id="1-1058">    <span class="nd">@overload</span>
+</span><span id="1-1059">    <span class="k">def</span> <span class="nf">trace</span><span class="p">(</span><span class="n">func</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+</span><span id="1-1060">        <span class="c1"># type: (None) -&gt; Callable[[Callable[P, R]], Callable[P, R]]</span>
+</span><span id="1-1061">        <span class="k">pass</span>
+</span><span id="1-1062">
+</span><span id="1-1063">    <span class="nd">@overload</span>
+</span><span id="1-1064">    <span class="k">def</span> <span class="nf">trace</span><span class="p">(</span><span class="n">func</span><span class="p">):</span>
+</span><span id="1-1065">        <span class="c1"># type: (Callable[P, R]) -&gt; Callable[P, R]</span>
+</span><span id="1-1066">        <span class="k">pass</span>
+</span><span id="1-1067">
+</span><span id="1-1068">
+</span><span id="1-1069"><span class="k">def</span> <span class="nf">trace</span><span class="p">(</span><span class="n">func</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+</span><span id="1-1070">    <span class="c1"># type: (Optional[Callable[P, R]]) -&gt; Union[Callable[P, R], Callable[[Callable[P, R]], Callable[P, R]]]</span>
+</span><span id="1-1071"><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-1072"><span class="sd">    Decorator to start a child span under the existing current transaction.</span>
+</span><span id="1-1073"><span class="sd">    If there is no current transaction, then nothing will be traced.</span>
+</span><span id="1-1074">
+</span><span id="1-1075"><span class="sd">    .. code-block::</span>
+</span><span id="1-1076"><span class="sd">        :caption: Usage</span>
+</span><span id="1-1077">
+</span><span id="1-1078"><span class="sd">        import sentry_sdk</span>
+</span><span id="1-1079">
+</span><span id="1-1080"><span class="sd">        @sentry_sdk.trace</span>
+</span><span id="1-1081"><span class="sd">        def my_function():</span>
+</span><span id="1-1082"><span class="sd">            ...</span>
+</span><span id="1-1083">
+</span><span id="1-1084"><span class="sd">        @sentry_sdk.trace</span>
+</span><span id="1-1085"><span class="sd">        async def my_async_function():</span>
+</span><span id="1-1086"><span class="sd">            ...</span>
+</span><span id="1-1087"><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="1-1088">    <span class="kn">from</span> <span class="nn">sentry_sdk.tracing_utils</span> <span class="kn">import</span> <span class="n">start_child_span_decorator</span>
+</span><span id="1-1089">
+</span><span id="1-1090">    <span class="c1"># This patterns allows usage of both @sentry_traced and @sentry_traced(...)</span>
+</span><span id="1-1091">    <span class="c1"># See https://stackoverflow.com/questions/52126071/decorator-with-arguments-avoid-parenthesis-when-no-arguments/52126278</span>
+</span><span id="1-1092">    <span class="k">if</span> <span class="n">func</span><span class="p">:</span>
+</span><span id="1-1093">        <span class="k">return</span> <span class="n">start_child_span_decorator</span><span class="p">(</span><span class="n">func</span><span class="p">)</span>
+</span><span id="1-1094">    <span class="k">else</span><span class="p">:</span>
+</span><span id="1-1095">        <span class="k">return</span> <span class="n">start_child_span_decorator</span>
+</span><span id="1-1096">
+</span><span id="1-1097">
+</span><span id="1-1098"><span class="c1"># Circular imports</span>
+</span><span id="1-1099">
+</span><span id="1-1100"><span class="kn">from</span> <span class="nn">sentry_sdk.tracing_utils</span> <span class="kn">import</span> <span class="p">(</span>
+</span><span id="1-1101">    <span class="n">Baggage</span><span class="p">,</span>
+</span><span id="1-1102">    <span class="n">EnvironHeaders</span><span class="p">,</span>
+</span><span id="1-1103">    <span class="n">extract_sentrytrace_data</span><span class="p">,</span>
+</span><span id="1-1104">    <span class="n">has_tracing_enabled</span><span class="p">,</span>
+</span><span id="1-1105">    <span class="n">maybe_create_breadcrumbs_from_span</span><span class="p">,</span>
+</span><span id="1-1106"><span class="p">)</span>
+</span><span id="1-1107"><span class="kn">from</span> <span class="nn">sentry_sdk.metrics</span> <span class="kn">import</span> <span class="n">LocalAggregator</span>
 </span></pre></div>
         </article>
         
@@ -1276,7 +1316,7 @@ <h1>Source code for sentry_sdk.tracing</h1><div class="highlight"><pre>
     </div>
   </div>
 </footer></div>
-      <script src="../../_static/documentation_options.js?v=fca6d697"></script>
+      <script src="../../_static/documentation_options.js?v=aa9da443"></script>
       <script src="../../_static/doctools.js?v=888ff710"></script>
       <script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
       <script src="../../_static/shibuya.js?v=999236dc"></script>
diff --git a/_modules/sentry_sdk/transport.html b/_modules/sentry_sdk/transport.html
index 80b9e233db..216f7b0bc9 100644
--- a/_modules/sentry_sdk/transport.html
+++ b/_modules/sentry_sdk/transport.html
@@ -4,7 +4,7 @@
 <head>
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-      <title>sentry_sdk.transport - sentry-python 1.44.1 documentation</title>
+      <title>sentry_sdk.transport - sentry-python 2.0.0rc4 documentation</title>
     <link rel="index" title="Index" href="../../genindex.html" /><link rel="search" title="Search" href="../../search.html" />
 
   <script>
@@ -132,26 +132,26 @@
       <div class="min-w-0 max-w-6xl px-6 pb-6 pt-8 xl:px-12">
         <article class="yue" role="main">
           <h1>Source code for sentry_sdk.transport</h1><div class="highlight"><pre>
-<span></span><span id="1-1"><span class="kn">from</span> <span class="nn">__future__</span> <span class="kn">import</span> <span class="n">print_function</span>
-</span><span id="1-2">
-</span><span id="1-3"><span class="kn">import</span> <span class="nn">io</span>
-</span><span id="1-4"><span class="kn">import</span> <span class="nn">gzip</span>
-</span><span id="1-5"><span class="kn">import</span> <span class="nn">socket</span>
-</span><span id="1-6"><span class="kn">import</span> <span class="nn">time</span>
-</span><span id="1-7"><span class="kn">from</span> <span class="nn">datetime</span> <span class="kn">import</span> <span class="n">timedelta</span>
+<span></span><span id="1-1"><span class="kn">from</span> <span class="nn">abc</span> <span class="kn">import</span> <span class="n">ABC</span><span class="p">,</span> <span class="n">abstractmethod</span>
+</span><span id="1-2"><span class="kn">import</span> <span class="nn">io</span>
+</span><span id="1-3"><span class="kn">import</span> <span class="nn">gzip</span>
+</span><span id="1-4"><span class="kn">import</span> <span class="nn">socket</span>
+</span><span id="1-5"><span class="kn">import</span> <span class="nn">time</span>
+</span><span id="1-6"><span class="kn">import</span> <span class="nn">warnings</span>
+</span><span id="1-7"><span class="kn">from</span> <span class="nn">datetime</span> <span class="kn">import</span> <span class="n">datetime</span><span class="p">,</span> <span class="n">timedelta</span><span class="p">,</span> <span class="n">timezone</span>
 </span><span id="1-8"><span class="kn">from</span> <span class="nn">collections</span> <span class="kn">import</span> <span class="n">defaultdict</span>
-</span><span id="1-9">
-</span><span id="1-10"><span class="kn">import</span> <span class="nn">urllib3</span>
-</span><span id="1-11"><span class="kn">import</span> <span class="nn">certifi</span>
-</span><span id="1-12">
-</span><span id="1-13"><span class="kn">from</span> <span class="nn">sentry_sdk.utils</span> <span class="kn">import</span> <span class="n">Dsn</span><span class="p">,</span> <span class="n">logger</span><span class="p">,</span> <span class="n">capture_internal_exceptions</span><span class="p">,</span> <span class="n">json_dumps</span>
-</span><span id="1-14"><span class="kn">from</span> <span class="nn">sentry_sdk.worker</span> <span class="kn">import</span> <span class="n">BackgroundWorker</span>
-</span><span id="1-15"><span class="kn">from</span> <span class="nn">sentry_sdk.envelope</span> <span class="kn">import</span> <span class="n">Envelope</span><span class="p">,</span> <span class="n">Item</span><span class="p">,</span> <span class="n">PayloadRef</span>
-</span><span id="1-16"><span class="kn">from</span> <span class="nn">sentry_sdk._compat</span> <span class="kn">import</span> <span class="n">datetime_utcnow</span>
-</span><span id="1-17"><span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="n">TYPE_CHECKING</span>
-</span><span id="1-18">
-</span><span id="1-19"><span class="k">if</span> <span class="n">TYPE_CHECKING</span><span class="p">:</span>
-</span><span id="1-20">    <span class="kn">from</span> <span class="nn">datetime</span> <span class="kn">import</span> <span class="n">datetime</span>
+</span><span id="1-9"><span class="kn">from</span> <span class="nn">urllib.request</span> <span class="kn">import</span> <span class="n">getproxies</span>
+</span><span id="1-10">
+</span><span id="1-11"><span class="kn">import</span> <span class="nn">urllib3</span>
+</span><span id="1-12"><span class="kn">import</span> <span class="nn">certifi</span>
+</span><span id="1-13">
+</span><span id="1-14"><span class="kn">from</span> <span class="nn">sentry_sdk.consts</span> <span class="kn">import</span> <span class="n">EndpointType</span>
+</span><span id="1-15"><span class="kn">from</span> <span class="nn">sentry_sdk.utils</span> <span class="kn">import</span> <span class="n">Dsn</span><span class="p">,</span> <span class="n">logger</span><span class="p">,</span> <span class="n">capture_internal_exceptions</span>
+</span><span id="1-16"><span class="kn">from</span> <span class="nn">sentry_sdk.worker</span> <span class="kn">import</span> <span class="n">BackgroundWorker</span>
+</span><span id="1-17"><span class="kn">from</span> <span class="nn">sentry_sdk.envelope</span> <span class="kn">import</span> <span class="n">Envelope</span><span class="p">,</span> <span class="n">Item</span><span class="p">,</span> <span class="n">PayloadRef</span>
+</span><span id="1-18"><span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="n">TYPE_CHECKING</span>
+</span><span id="1-19">
+</span><span id="1-20"><span class="k">if</span> <span class="n">TYPE_CHECKING</span><span class="p">:</span>
 </span><span id="1-21">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Any</span>
 </span><span id="1-22">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Callable</span>
 </span><span id="1-23">    <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Dict</span>
@@ -166,639 +166,616 @@ <h1>Source code for sentry_sdk.transport</h1><div class="highlight"><pre>
 </span><span id="1-32">    <span class="kn">from</span> <span class="nn">urllib3.poolmanager</span> <span class="kn">import</span> <span class="n">PoolManager</span>
 </span><span id="1-33">    <span class="kn">from</span> <span class="nn">urllib3.poolmanager</span> <span class="kn">import</span> <span class="n">ProxyManager</span>
 </span><span id="1-34">
-</span><span id="1-35">    <span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="n">Event</span><span class="p">,</span> <span class="n">EndpointType</span>
+</span><span id="1-35">    <span class="kn">from</span> <span class="nn">sentry_sdk._types</span> <span class="kn">import</span> <span class="n">Event</span>
 </span><span id="1-36">
 </span><span id="1-37">    <span class="n">DataCategory</span> <span class="o">=</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span>
 </span><span id="1-38">
-</span><span id="1-39"><span class="k">try</span><span class="p">:</span>
-</span><span id="1-40">    <span class="kn">from</span> <span class="nn">urllib.request</span> <span class="kn">import</span> <span class="n">getproxies</span>
-</span><span id="1-41"><span class="k">except</span> <span class="ne">ImportError</span><span class="p">:</span>
-</span><span id="1-42">    <span class="kn">from</span> <span class="nn">urllib</span> <span class="kn">import</span> <span class="n">getproxies</span>  <span class="c1"># type: ignore</span>
-</span><span id="1-43">
-</span><span id="1-44">
-</span><span id="1-45"><span class="n">KEEP_ALIVE_SOCKET_OPTIONS</span> <span class="o">=</span> <span class="p">[]</span>
-</span><span id="1-46"><span class="k">for</span> <span class="n">option</span> <span class="ow">in</span> <span class="p">[</span>
-</span><span id="1-47">    <span class="p">(</span><span class="n">socket</span><span class="o">.</span><span class="n">SOL_SOCKET</span><span class="p">,</span> <span class="k">lambda</span><span class="p">:</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">socket</span><span class="p">,</span> <span class="s2">&quot;SO_KEEPALIVE&quot;</span><span class="p">),</span> <span class="mi">1</span><span class="p">),</span>  <span class="c1"># noqa: B009</span>
-</span><span id="1-48">    <span class="p">(</span><span class="n">socket</span><span class="o">.</span><span class="n">SOL_TCP</span><span class="p">,</span> <span class="k">lambda</span><span class="p">:</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">socket</span><span class="p">,</span> <span class="s2">&quot;TCP_KEEPIDLE&quot;</span><span class="p">),</span> <span class="mi">45</span><span class="p">),</span>  <span class="c1"># noqa: B009</span>
-</span><span id="1-49">    <span class="p">(</span><span class="n">socket</span><span class="o">.</span><span class="n">SOL_TCP</span><span class="p">,</span> <span class="k">lambda</span><span class="p">:</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">socket</span><span class="p">,</span> <span class="s2">&quot;TCP_KEEPINTVL&quot;</span><span class="p">),</span> <span class="mi">10</span><span class="p">),</span>  <span class="c1"># noqa: B009</span>
-</span><span id="1-50">    <span class="p">(</span><span class="n">socket</span><span class="o">.</span><span class="n">SOL_TCP</span><span class="p">,</span> <span class="k">lambda</span><span class="p">:</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">socket</span><span class="p">,</span> <span class="s2">&quot;TCP_KEEPCNT&quot;</span><span class="p">),</span> <span class="mi">6</span><span class="p">),</span>  <span class="c1"># noqa: B009</span>
-</span><span id="1-51"><span class="p">]:</span>
-</span><span id="1-52">    <span class="k">try</span><span class="p">:</span>
-</span><span id="1-53">        <span class="n">KEEP_ALIVE_SOCKET_OPTIONS</span><span class="o">.</span><span class="n">append</span><span class="p">((</span><span class="n">option</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">option</span><span class="p">[</span><span class="mi">1</span><span class="p">](),</span> <span class="n">option</span><span class="p">[</span><span class="mi">2</span><span class="p">]))</span>
-</span><span id="1-54">    <span class="k">except</span> <span class="ne">AttributeError</span><span class="p">:</span>
-</span><span id="1-55">        <span class="c1"># a specific option might not be available on specific systems,</span>
-</span><span id="1-56">        <span class="c1"># e.g. TCP_KEEPIDLE doesn&#39;t exist on macOS</span>
-</span><span id="1-57">        <span class="k">pass</span>
-</span><span id="1-58">
-</span><span id="1-59">
+</span><span id="1-39">
+</span><span id="1-40"><span class="n">KEEP_ALIVE_SOCKET_OPTIONS</span> <span class="o">=</span> <span class="p">[]</span>
+</span><span id="1-41"><span class="k">for</span> <span class="n">option</span> <span class="ow">in</span> <span class="p">[</span>
+</span><span id="1-42">    <span class="p">(</span><span class="n">socket</span><span class="o">.</span><span class="n">SOL_SOCKET</span><span class="p">,</span> <span class="k">lambda</span><span class="p">:</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">socket</span><span class="p">,</span> <span class="s2">&quot;SO_KEEPALIVE&quot;</span><span class="p">),</span> <span class="mi">1</span><span class="p">),</span>  <span class="c1"># noqa: B009</span>
+</span><span id="1-43">    <span class="p">(</span><span class="n">socket</span><span class="o">.</span><span class="n">SOL_TCP</span><span class="p">,</span> <span class="k">lambda</span><span class="p">:</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">socket</span><span class="p">,</span> <span class="s2">&quot;TCP_KEEPIDLE&quot;</span><span class="p">),</span> <span class="mi">45</span><span class="p">),</span>  <span class="c1"># noqa: B009</span>
+</span><span id="1-44">    <span class="p">(</span><span class="n">socket</span><span class="o">.</span><span class="n">SOL_TCP</span><span class="p">,</span> <span class="k">lambda</span><span class="p">:</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">socket</span><span class="p">,</span> <span class="s2">&quot;TCP_KEEPINTVL&quot;</span><span class="p">),</span> <span class="mi">10</span><span class="p">),</span>  <span class="c1"># noqa: B009</span>
+</span><span id="1-45">    <span class="p">(</span><span class="n">socket</span><span class="o">.</span><span class="n">SOL_TCP</span><span class="p">,</span> <span class="k">lambda</span><span class="p">:</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">socket</span><span class="p">,</span> <span class="s2">&quot;TCP_KEEPCNT&quot;</span><span class="p">),</span> <span class="mi">6</span><span class="p">),</span>  <span class="c1"># noqa: B009</span>
+</span><span id="1-46"><span class="p">]:</span>
+</span><span id="1-47">    <span class="k">try</span><span class="p">:</span>
+</span><span id="1-48">        <span class="n">KEEP_ALIVE_SOCKET_OPTIONS</span><span class="o">.</span><span class="n">append</span><span class="p">((</span><span class="n">option</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">option</span><span class="p">[</span><span class="mi">1</span><span class="p">](),</span> <span class="n">option</span><span class="p">[</span><span class="mi">2</span><span class="p">]))</span>
+</span><span id="1-49">    <span class="k">except</span> <span class="ne">AttributeError</span><span class="p">:</span>
+</span><span id="1-50">        <span class="c1"># a specific option might not be available on specific systems,</span>
+</span><span id="1-51">        <span class="c1"># e.g. TCP_KEEPIDLE doesn&#39;t exist on macOS</span>
+</span><span id="1-52">        <span class="k">pass</span>
+</span><span id="1-53">
+</span><span id="1-54">
 <div class="viewcode-block" id="Transport">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Transport">[docs]</a>
-</span><span id="1-60"><span class="k">class</span> <span class="nc">Transport</span><span class="p">(</span><span class="nb">object</span><span class="p">):</span>
-</span><span id="1-61"><span class="w">    </span><span class="sd">&quot;&quot;&quot;Baseclass for all transports.</span>
+</span><span id="1-55"><span class="k">class</span> <span class="nc">Transport</span><span class="p">(</span><span class="n">ABC</span><span class="p">):</span>
+</span><span id="1-56"><span class="w">    </span><span class="sd">&quot;&quot;&quot;Baseclass for all transports.</span>
+</span><span id="1-57">
+</span><span id="1-58"><span class="sd">    A transport is used to send an event to sentry.</span>
+</span><span id="1-59"><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="1-60">
+</span><span id="1-61">    <span class="n">parsed_dsn</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[Dsn]</span>
 </span><span id="1-62">
-</span><span id="1-63"><span class="sd">    A transport is used to send an event to sentry.</span>
-</span><span id="1-64"><span class="sd">    &quot;&quot;&quot;</span>
-</span><span id="1-65">
-</span><span id="1-66">    <span class="n">parsed_dsn</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[Dsn]</span>
-</span><span id="1-67">
-</span><span id="1-68">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
-</span><span id="1-69">        <span class="bp">self</span><span class="p">,</span> <span class="n">options</span><span class="o">=</span><span class="kc">None</span>  <span class="c1"># type: Optional[Dict[str, Any]]</span>
-</span><span id="1-70">    <span class="p">):</span>
-</span><span id="1-71">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-72">        <span class="bp">self</span><span class="o">.</span><span class="n">options</span> <span class="o">=</span> <span class="n">options</span>
-</span><span id="1-73">        <span class="k">if</span> <span class="n">options</span> <span class="ow">and</span> <span class="n">options</span><span class="p">[</span><span class="s2">&quot;dsn&quot;</span><span class="p">]</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">options</span><span class="p">[</span><span class="s2">&quot;dsn&quot;</span><span class="p">]:</span>
-</span><span id="1-74">            <span class="bp">self</span><span class="o">.</span><span class="n">parsed_dsn</span> <span class="o">=</span> <span class="n">Dsn</span><span class="p">(</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;dsn&quot;</span><span class="p">])</span>
-</span><span id="1-75">        <span class="k">else</span><span class="p">:</span>
-</span><span id="1-76">            <span class="bp">self</span><span class="o">.</span><span class="n">parsed_dsn</span> <span class="o">=</span> <span class="kc">None</span>
-</span><span id="1-77">
+</span><span id="1-63">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
+</span><span id="1-64">        <span class="bp">self</span><span class="p">,</span> <span class="n">options</span><span class="o">=</span><span class="kc">None</span>  <span class="c1"># type: Optional[Dict[str, Any]]</span>
+</span><span id="1-65">    <span class="p">):</span>
+</span><span id="1-66">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-67">        <span class="bp">self</span><span class="o">.</span><span class="n">options</span> <span class="o">=</span> <span class="n">options</span>
+</span><span id="1-68">        <span class="k">if</span> <span class="n">options</span> <span class="ow">and</span> <span class="n">options</span><span class="p">[</span><span class="s2">&quot;dsn&quot;</span><span class="p">]</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">options</span><span class="p">[</span><span class="s2">&quot;dsn&quot;</span><span class="p">]:</span>
+</span><span id="1-69">            <span class="bp">self</span><span class="o">.</span><span class="n">parsed_dsn</span> <span class="o">=</span> <span class="n">Dsn</span><span class="p">(</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;dsn&quot;</span><span class="p">])</span>
+</span><span id="1-70">        <span class="k">else</span><span class="p">:</span>
+</span><span id="1-71">            <span class="bp">self</span><span class="o">.</span><span class="n">parsed_dsn</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="1-72">
 <div class="viewcode-block" id="Transport.capture_event">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Transport.capture_event">[docs]</a>
-</span><span id="1-78">    <span class="k">def</span> <span class="nf">capture_event</span><span class="p">(</span>
-</span><span id="1-79">        <span class="bp">self</span><span class="p">,</span> <span class="n">event</span>  <span class="c1"># type: Event</span>
-</span><span id="1-80">    <span class="p">):</span>
-</span><span id="1-81">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-82"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-83"><span class="sd">        This gets invoked with the event dictionary when an event should</span>
-</span><span id="1-84"><span class="sd">        be sent to sentry.</span>
-</span><span id="1-85"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-86">        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div>
+</span><span id="1-73">    <span class="k">def</span> <span class="nf">capture_event</span><span class="p">(</span>
+</span><span id="1-74">        <span class="bp">self</span><span class="p">,</span> <span class="n">event</span>  <span class="c1"># type: Event</span>
+</span><span id="1-75">    <span class="p">):</span>
+</span><span id="1-76">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-77"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-78"><span class="sd">        DEPRECATED: Please use capture_envelope instead.</span>
+</span><span id="1-79">
+</span><span id="1-80"><span class="sd">        This gets invoked with the event dictionary when an event should</span>
+</span><span id="1-81"><span class="sd">        be sent to sentry.</span>
+</span><span id="1-82"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-83">
+</span><span id="1-84">        <span class="n">warnings</span><span class="o">.</span><span class="n">warn</span><span class="p">(</span>
+</span><span id="1-85">            <span class="s2">&quot;capture_event is deprecated, please use capture_envelope instead!&quot;</span><span class="p">,</span>
+</span><span id="1-86">            <span class="ne">DeprecationWarning</span><span class="p">,</span>
+</span><span id="1-87">            <span class="n">stacklevel</span><span class="o">=</span><span class="mi">2</span><span class="p">,</span>
+</span><span id="1-88">        <span class="p">)</span>
+</span><span id="1-89">
+</span><span id="1-90">        <span class="n">envelope</span> <span class="o">=</span> <span class="n">Envelope</span><span class="p">()</span>
+</span><span id="1-91">        <span class="n">envelope</span><span class="o">.</span><span class="n">add_event</span><span class="p">(</span><span class="n">event</span><span class="p">)</span>
+</span><span id="1-92">        <span class="bp">self</span><span class="o">.</span><span class="n">capture_envelope</span><span class="p">(</span><span class="n">envelope</span><span class="p">)</span></div>
 
-</span><span id="1-87">
+</span><span id="1-93">
 <div class="viewcode-block" id="Transport.capture_envelope">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Transport.capture_envelope">[docs]</a>
-</span><span id="1-88">    <span class="k">def</span> <span class="nf">capture_envelope</span><span class="p">(</span>
-</span><span id="1-89">        <span class="bp">self</span><span class="p">,</span> <span class="n">envelope</span>  <span class="c1"># type: Envelope</span>
-</span><span id="1-90">    <span class="p">):</span>
-</span><span id="1-91">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-92"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="1-93"><span class="sd">        Send an envelope to Sentry.</span>
-</span><span id="1-94">
-</span><span id="1-95"><span class="sd">        Envelopes are a data container format that can hold any type of data</span>
-</span><span id="1-96"><span class="sd">        submitted to Sentry. We use it for transactions and sessions, but</span>
-</span><span id="1-97"><span class="sd">        regular &quot;error&quot; events should go through `capture_event` for backwards</span>
-</span><span id="1-98"><span class="sd">        compat.</span>
-</span><span id="1-99"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-100">        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">()</span></div>
-
+</span><span id="1-94">    <span class="nd">@abstractmethod</span>
+</span><span id="1-95">    <span class="k">def</span> <span class="nf">capture_envelope</span><span class="p">(</span>
+</span><span id="1-96">        <span class="bp">self</span><span class="p">,</span> <span class="n">envelope</span>  <span class="c1"># type: Envelope</span>
+</span><span id="1-97">    <span class="p">):</span>
+</span><span id="1-98">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-99"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-100"><span class="sd">        Send an envelope to Sentry.</span>
 </span><span id="1-101">
+</span><span id="1-102"><span class="sd">        Envelopes are a data container format that can hold any type of data</span>
+</span><span id="1-103"><span class="sd">        submitted to Sentry. We use it to send all event data (including errors,</span>
+</span><span id="1-104"><span class="sd">        transactions, crons checkins, etc.) to Sentry.</span>
+</span><span id="1-105"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-106">        <span class="k">pass</span></div>
+
+</span><span id="1-107">
 <div class="viewcode-block" id="Transport.flush">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Transport.flush">[docs]</a>
-</span><span id="1-102">    <span class="k">def</span> <span class="nf">flush</span><span class="p">(</span>
-</span><span id="1-103">        <span class="bp">self</span><span class="p">,</span>
-</span><span id="1-104">        <span class="n">timeout</span><span class="p">,</span>  <span class="c1"># type: float</span>
-</span><span id="1-105">        <span class="n">callback</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Any]</span>
-</span><span id="1-106">    <span class="p">):</span>
-</span><span id="1-107">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-108"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Wait `timeout` seconds for the current events to be sent out.&quot;&quot;&quot;</span>
-</span><span id="1-109">        <span class="k">pass</span></div>
+</span><span id="1-108">    <span class="k">def</span> <span class="nf">flush</span><span class="p">(</span>
+</span><span id="1-109">        <span class="bp">self</span><span class="p">,</span>
+</span><span id="1-110">        <span class="n">timeout</span><span class="p">,</span>  <span class="c1"># type: float</span>
+</span><span id="1-111">        <span class="n">callback</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Any]</span>
+</span><span id="1-112">    <span class="p">):</span>
+</span><span id="1-113">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-114"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-115"><span class="sd">        Wait `timeout` seconds for the current events to be sent out.</span>
+</span><span id="1-116">
+</span><span id="1-117"><span class="sd">        The default implementation is a no-op, since this method may only be relevant to some transports.</span>
+</span><span id="1-118"><span class="sd">        Subclasses should override this method if necessary.</span>
+</span><span id="1-119"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-120">        <span class="k">return</span> <span class="kc">None</span></div>
 
-</span><span id="1-110">
+</span><span id="1-121">
 <div class="viewcode-block" id="Transport.kill">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Transport.kill">[docs]</a>
-</span><span id="1-111">    <span class="k">def</span> <span class="nf">kill</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-112">        <span class="c1"># type: () -&gt; None</span>
-</span><span id="1-113"><span class="w">        </span><span class="sd">&quot;&quot;&quot;Forcefully kills the transport.&quot;&quot;&quot;</span>
-</span><span id="1-114">        <span class="k">pass</span></div>
+</span><span id="1-122">    <span class="k">def</span> <span class="nf">kill</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-123">        <span class="c1"># type: () -&gt; None</span>
+</span><span id="1-124"><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-125"><span class="sd">        Forcefully kills the transport.</span>
+</span><span id="1-126">
+</span><span id="1-127"><span class="sd">        The default implementation is a no-op, since this method may only be relevant to some transports.</span>
+</span><span id="1-128"><span class="sd">        Subclasses should override this method if necessary.</span>
+</span><span id="1-129"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-130">        <span class="k">return</span> <span class="kc">None</span></div>
 
-</span><span id="1-115">
+</span><span id="1-131">
 <div class="viewcode-block" id="Transport.record_lost_event">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.Transport.record_lost_event">[docs]</a>
-</span><span id="1-116">    <span class="k">def</span> <span class="nf">record_lost_event</span><span class="p">(</span>
-</span><span id="1-117">        <span class="bp">self</span><span class="p">,</span>
-</span><span id="1-118">        <span class="n">reason</span><span class="p">,</span>  <span class="c1"># type: str</span>
-</span><span id="1-119">        <span class="n">data_category</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
-</span><span id="1-120">        <span class="n">item</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Item]</span>
-</span><span id="1-121">    <span class="p">):</span>
-</span><span id="1-122">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-123"><span class="w">        </span><span class="sd">&quot;&quot;&quot;This increments a counter for event loss by reason and</span>
-</span><span id="1-124"><span class="sd">        data category.</span>
-</span><span id="1-125"><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="1-126">        <span class="k">return</span> <span class="kc">None</span></div>
+</span><span id="1-132">    <span class="k">def</span> <span class="nf">record_lost_event</span><span class="p">(</span>
+</span><span id="1-133">        <span class="bp">self</span><span class="p">,</span>
+</span><span id="1-134">        <span class="n">reason</span><span class="p">,</span>  <span class="c1"># type: str</span>
+</span><span id="1-135">        <span class="n">data_category</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
+</span><span id="1-136">        <span class="n">item</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Item]</span>
+</span><span id="1-137">    <span class="p">):</span>
+</span><span id="1-138">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-139"><span class="w">        </span><span class="sd">&quot;&quot;&quot;This increments a counter for event loss by reason and</span>
+</span><span id="1-140"><span class="sd">        data category.</span>
+</span><span id="1-141"><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="1-142">        <span class="k">return</span> <span class="kc">None</span></div>
 
-</span><span id="1-127">
-</span><span id="1-128">    <span class="k">def</span> <span class="nf">is_healthy</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-129">        <span class="c1"># type: () -&gt; bool</span>
-</span><span id="1-130">        <span class="k">return</span> <span class="kc">True</span>
-</span><span id="1-131">
-</span><span id="1-132">    <span class="k">def</span> <span class="fm">__del__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-133">        <span class="c1"># type: () -&gt; None</span>
-</span><span id="1-134">        <span class="k">try</span><span class="p">:</span>
-</span><span id="1-135">            <span class="bp">self</span><span class="o">.</span><span class="n">kill</span><span class="p">()</span>
-</span><span id="1-136">        <span class="k">except</span> <span class="ne">Exception</span><span class="p">:</span>
-</span><span id="1-137">            <span class="k">pass</span></div>
+</span><span id="1-143">
+</span><span id="1-144">    <span class="k">def</span> <span class="nf">is_healthy</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-145">        <span class="c1"># type: () -&gt; bool</span>
+</span><span id="1-146">        <span class="k">return</span> <span class="kc">True</span>
+</span><span id="1-147">
+</span><span id="1-148">    <span class="k">def</span> <span class="fm">__del__</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-149">        <span class="c1"># type: () -&gt; None</span>
+</span><span id="1-150">        <span class="k">try</span><span class="p">:</span>
+</span><span id="1-151">            <span class="bp">self</span><span class="o">.</span><span class="n">kill</span><span class="p">()</span>
+</span><span id="1-152">        <span class="k">except</span> <span class="ne">Exception</span><span class="p">:</span>
+</span><span id="1-153">            <span class="k">pass</span></div>
 
-</span><span id="1-138">
-</span><span id="1-139">
-</span><span id="1-140"><span class="k">def</span> <span class="nf">_parse_rate_limits</span><span class="p">(</span><span class="n">header</span><span class="p">,</span> <span class="n">now</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-</span><span id="1-141">    <span class="c1"># type: (Any, Optional[datetime]) -&gt; Iterable[Tuple[DataCategory, datetime]]</span>
-</span><span id="1-142">    <span class="k">if</span> <span class="n">now</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-143">        <span class="n">now</span> <span class="o">=</span> <span class="n">datetime_utcnow</span><span class="p">()</span>
-</span><span id="1-144">
-</span><span id="1-145">    <span class="k">for</span> <span class="n">limit</span> <span class="ow">in</span> <span class="n">header</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s2">&quot;,&quot;</span><span class="p">):</span>
-</span><span id="1-146">        <span class="k">try</span><span class="p">:</span>
-</span><span id="1-147">            <span class="n">retry_after</span><span class="p">,</span> <span class="n">categories</span><span class="p">,</span> <span class="n">_</span> <span class="o">=</span> <span class="n">limit</span><span class="o">.</span><span class="n">strip</span><span class="p">()</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s2">&quot;:&quot;</span><span class="p">,</span> <span class="mi">2</span><span class="p">)</span>
-</span><span id="1-148">            <span class="n">retry_after</span> <span class="o">=</span> <span class="n">now</span> <span class="o">+</span> <span class="n">timedelta</span><span class="p">(</span><span class="n">seconds</span><span class="o">=</span><span class="nb">int</span><span class="p">(</span><span class="n">retry_after</span><span class="p">))</span>
-</span><span id="1-149">            <span class="k">for</span> <span class="n">category</span> <span class="ow">in</span> <span class="n">categories</span> <span class="ow">and</span> <span class="n">categories</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s2">&quot;;&quot;</span><span class="p">)</span> <span class="ow">or</span> <span class="p">(</span><span class="kc">None</span><span class="p">,):</span>
-</span><span id="1-150">                <span class="k">yield</span> <span class="n">category</span><span class="p">,</span> <span class="n">retry_after</span>
-</span><span id="1-151">        <span class="k">except</span> <span class="p">(</span><span class="ne">LookupError</span><span class="p">,</span> <span class="ne">ValueError</span><span class="p">):</span>
-</span><span id="1-152">            <span class="k">continue</span>
-</span><span id="1-153">
 </span><span id="1-154">
+</span><span id="1-155">
+</span><span id="1-156"><span class="k">def</span> <span class="nf">_parse_rate_limits</span><span class="p">(</span><span class="n">header</span><span class="p">,</span> <span class="n">now</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+</span><span id="1-157">    <span class="c1"># type: (Any, Optional[datetime]) -&gt; Iterable[Tuple[DataCategory, datetime]]</span>
+</span><span id="1-158">    <span class="k">if</span> <span class="n">now</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-159">        <span class="n">now</span> <span class="o">=</span> <span class="n">datetime</span><span class="o">.</span><span class="n">now</span><span class="p">(</span><span class="n">timezone</span><span class="o">.</span><span class="n">utc</span><span class="p">)</span>
+</span><span id="1-160">
+</span><span id="1-161">    <span class="k">for</span> <span class="n">limit</span> <span class="ow">in</span> <span class="n">header</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s2">&quot;,&quot;</span><span class="p">):</span>
+</span><span id="1-162">        <span class="k">try</span><span class="p">:</span>
+</span><span id="1-163">            <span class="n">retry_after</span><span class="p">,</span> <span class="n">categories</span><span class="p">,</span> <span class="n">_</span> <span class="o">=</span> <span class="n">limit</span><span class="o">.</span><span class="n">strip</span><span class="p">()</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s2">&quot;:&quot;</span><span class="p">,</span> <span class="mi">2</span><span class="p">)</span>
+</span><span id="1-164">            <span class="n">retry_after</span> <span class="o">=</span> <span class="n">now</span> <span class="o">+</span> <span class="n">timedelta</span><span class="p">(</span><span class="n">seconds</span><span class="o">=</span><span class="nb">int</span><span class="p">(</span><span class="n">retry_after</span><span class="p">))</span>
+</span><span id="1-165">            <span class="k">for</span> <span class="n">category</span> <span class="ow">in</span> <span class="n">categories</span> <span class="ow">and</span> <span class="n">categories</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s2">&quot;;&quot;</span><span class="p">)</span> <span class="ow">or</span> <span class="p">(</span><span class="kc">None</span><span class="p">,):</span>
+</span><span id="1-166">                <span class="k">yield</span> <span class="n">category</span><span class="p">,</span> <span class="n">retry_after</span>
+</span><span id="1-167">        <span class="k">except</span> <span class="p">(</span><span class="ne">LookupError</span><span class="p">,</span> <span class="ne">ValueError</span><span class="p">):</span>
+</span><span id="1-168">            <span class="k">continue</span>
+</span><span id="1-169">
+</span><span id="1-170">
 <div class="viewcode-block" id="HttpTransport">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.HttpTransport">[docs]</a>
-</span><span id="1-155"><span class="k">class</span> <span class="nc">HttpTransport</span><span class="p">(</span><span class="n">Transport</span><span class="p">):</span>
-</span><span id="1-156"><span class="w">    </span><span class="sd">&quot;&quot;&quot;The default HTTP transport.&quot;&quot;&quot;</span>
-</span><span id="1-157">
-</span><span id="1-158">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
-</span><span id="1-159">        <span class="bp">self</span><span class="p">,</span> <span class="n">options</span>  <span class="c1"># type: Dict[str, Any]</span>
-</span><span id="1-160">    <span class="p">):</span>
-</span><span id="1-161">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-162">        <span class="kn">from</span> <span class="nn">sentry_sdk.consts</span> <span class="kn">import</span> <span class="n">VERSION</span>
-</span><span id="1-163">
-</span><span id="1-164">        <span class="n">Transport</span><span class="o">.</span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">options</span><span class="p">)</span>
-</span><span id="1-165">        <span class="k">assert</span> <span class="bp">self</span><span class="o">.</span><span class="n">parsed_dsn</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span>
-</span><span id="1-166">        <span class="bp">self</span><span class="o">.</span><span class="n">options</span> <span class="o">=</span> <span class="n">options</span>  <span class="c1"># type: Dict[str, Any]</span>
-</span><span id="1-167">        <span class="bp">self</span><span class="o">.</span><span class="n">_worker</span> <span class="o">=</span> <span class="n">BackgroundWorker</span><span class="p">(</span><span class="n">queue_size</span><span class="o">=</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;transport_queue_size&quot;</span><span class="p">])</span>
-</span><span id="1-168">        <span class="bp">self</span><span class="o">.</span><span class="n">_auth</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">parsed_dsn</span><span class="o">.</span><span class="n">to_auth</span><span class="p">(</span><span class="s2">&quot;sentry.python/</span><span class="si">%s</span><span class="s2">&quot;</span> <span class="o">%</span> <span class="n">VERSION</span><span class="p">)</span>
-</span><span id="1-169">        <span class="bp">self</span><span class="o">.</span><span class="n">_disabled_until</span> <span class="o">=</span> <span class="p">{}</span>  <span class="c1"># type: Dict[DataCategory, datetime]</span>
-</span><span id="1-170">        <span class="bp">self</span><span class="o">.</span><span class="n">_retry</span> <span class="o">=</span> <span class="n">urllib3</span><span class="o">.</span><span class="n">util</span><span class="o">.</span><span class="n">Retry</span><span class="p">()</span>
-</span><span id="1-171">        <span class="bp">self</span><span class="o">.</span><span class="n">_discarded_events</span> <span class="o">=</span> <span class="n">defaultdict</span><span class="p">(</span>
-</span><span id="1-172">            <span class="nb">int</span>
-</span><span id="1-173">        <span class="p">)</span>  <span class="c1"># type: DefaultDict[Tuple[str, str], int]</span>
-</span><span id="1-174">        <span class="bp">self</span><span class="o">.</span><span class="n">_last_client_report_sent</span> <span class="o">=</span> <span class="n">time</span><span class="o">.</span><span class="n">time</span><span class="p">()</span>
-</span><span id="1-175">
-</span><span id="1-176">        <span class="n">compresslevel</span> <span class="o">=</span> <span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;_experiments&quot;</span><span class="p">,</span> <span class="p">{})</span><span class="o">.</span><span class="n">get</span><span class="p">(</span>
-</span><span id="1-177">            <span class="s2">&quot;transport_zlib_compression_level&quot;</span>
-</span><span id="1-178">        <span class="p">)</span>
-</span><span id="1-179">        <span class="bp">self</span><span class="o">.</span><span class="n">_compresslevel</span> <span class="o">=</span> <span class="mi">9</span> <span class="k">if</span> <span class="n">compresslevel</span> <span class="ow">is</span> <span class="kc">None</span> <span class="k">else</span> <span class="nb">int</span><span class="p">(</span><span class="n">compresslevel</span><span class="p">)</span>
-</span><span id="1-180">
-</span><span id="1-181">        <span class="n">num_pools</span> <span class="o">=</span> <span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;_experiments&quot;</span><span class="p">,</span> <span class="p">{})</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;transport_num_pools&quot;</span><span class="p">)</span>
-</span><span id="1-182">        <span class="bp">self</span><span class="o">.</span><span class="n">_num_pools</span> <span class="o">=</span> <span class="mi">2</span> <span class="k">if</span> <span class="n">num_pools</span> <span class="ow">is</span> <span class="kc">None</span> <span class="k">else</span> <span class="nb">int</span><span class="p">(</span><span class="n">num_pools</span><span class="p">)</span>
-</span><span id="1-183">
-</span><span id="1-184">        <span class="bp">self</span><span class="o">.</span><span class="n">_pool</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_make_pool</span><span class="p">(</span>
-</span><span id="1-185">            <span class="bp">self</span><span class="o">.</span><span class="n">parsed_dsn</span><span class="p">,</span>
-</span><span id="1-186">            <span class="n">http_proxy</span><span class="o">=</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;http_proxy&quot;</span><span class="p">],</span>
-</span><span id="1-187">            <span class="n">https_proxy</span><span class="o">=</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;https_proxy&quot;</span><span class="p">],</span>
-</span><span id="1-188">            <span class="n">ca_certs</span><span class="o">=</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;ca_certs&quot;</span><span class="p">],</span>
-</span><span id="1-189">            <span class="n">proxy_headers</span><span class="o">=</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;proxy_headers&quot;</span><span class="p">],</span>
-</span><span id="1-190">        <span class="p">)</span>
+</span><span id="1-171"><span class="k">class</span> <span class="nc">HttpTransport</span><span class="p">(</span><span class="n">Transport</span><span class="p">):</span>
+</span><span id="1-172"><span class="w">    </span><span class="sd">&quot;&quot;&quot;The default HTTP transport.&quot;&quot;&quot;</span>
+</span><span id="1-173">
+</span><span id="1-174">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
+</span><span id="1-175">        <span class="bp">self</span><span class="p">,</span> <span class="n">options</span>  <span class="c1"># type: Dict[str, Any]</span>
+</span><span id="1-176">    <span class="p">):</span>
+</span><span id="1-177">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-178">        <span class="kn">from</span> <span class="nn">sentry_sdk.consts</span> <span class="kn">import</span> <span class="n">VERSION</span>
+</span><span id="1-179">
+</span><span id="1-180">        <span class="n">Transport</span><span class="o">.</span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">options</span><span class="p">)</span>
+</span><span id="1-181">        <span class="k">assert</span> <span class="bp">self</span><span class="o">.</span><span class="n">parsed_dsn</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span>
+</span><span id="1-182">        <span class="bp">self</span><span class="o">.</span><span class="n">options</span> <span class="o">=</span> <span class="n">options</span>  <span class="c1"># type: Dict[str, Any]</span>
+</span><span id="1-183">        <span class="bp">self</span><span class="o">.</span><span class="n">_worker</span> <span class="o">=</span> <span class="n">BackgroundWorker</span><span class="p">(</span><span class="n">queue_size</span><span class="o">=</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;transport_queue_size&quot;</span><span class="p">])</span>
+</span><span id="1-184">        <span class="bp">self</span><span class="o">.</span><span class="n">_auth</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">parsed_dsn</span><span class="o">.</span><span class="n">to_auth</span><span class="p">(</span><span class="s2">&quot;sentry.python/</span><span class="si">%s</span><span class="s2">&quot;</span> <span class="o">%</span> <span class="n">VERSION</span><span class="p">)</span>
+</span><span id="1-185">        <span class="bp">self</span><span class="o">.</span><span class="n">_disabled_until</span> <span class="o">=</span> <span class="p">{}</span>  <span class="c1"># type: Dict[DataCategory, datetime]</span>
+</span><span id="1-186">        <span class="bp">self</span><span class="o">.</span><span class="n">_retry</span> <span class="o">=</span> <span class="n">urllib3</span><span class="o">.</span><span class="n">util</span><span class="o">.</span><span class="n">Retry</span><span class="p">()</span>
+</span><span id="1-187">        <span class="bp">self</span><span class="o">.</span><span class="n">_discarded_events</span> <span class="o">=</span> <span class="n">defaultdict</span><span class="p">(</span>
+</span><span id="1-188">            <span class="nb">int</span>
+</span><span id="1-189">        <span class="p">)</span>  <span class="c1"># type: DefaultDict[Tuple[str, str], int]</span>
+</span><span id="1-190">        <span class="bp">self</span><span class="o">.</span><span class="n">_last_client_report_sent</span> <span class="o">=</span> <span class="n">time</span><span class="o">.</span><span class="n">time</span><span class="p">()</span>
 </span><span id="1-191">
-</span><span id="1-192">        <span class="kn">from</span> <span class="nn">sentry_sdk</span> <span class="kn">import</span> <span class="n">Hub</span>
-</span><span id="1-193">
-</span><span id="1-194">        <span class="bp">self</span><span class="o">.</span><span class="n">hub_cls</span> <span class="o">=</span> <span class="n">Hub</span>
-</span><span id="1-195">
+</span><span id="1-192">        <span class="n">compresslevel</span> <span class="o">=</span> <span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;_experiments&quot;</span><span class="p">,</span> <span class="p">{})</span><span class="o">.</span><span class="n">get</span><span class="p">(</span>
+</span><span id="1-193">            <span class="s2">&quot;transport_zlib_compression_level&quot;</span>
+</span><span id="1-194">        <span class="p">)</span>
+</span><span id="1-195">        <span class="bp">self</span><span class="o">.</span><span class="n">_compresslevel</span> <span class="o">=</span> <span class="mi">9</span> <span class="k">if</span> <span class="n">compresslevel</span> <span class="ow">is</span> <span class="kc">None</span> <span class="k">else</span> <span class="nb">int</span><span class="p">(</span><span class="n">compresslevel</span><span class="p">)</span>
+</span><span id="1-196">
+</span><span id="1-197">        <span class="n">num_pools</span> <span class="o">=</span> <span class="n">options</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;_experiments&quot;</span><span class="p">,</span> <span class="p">{})</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;transport_num_pools&quot;</span><span class="p">)</span>
+</span><span id="1-198">        <span class="bp">self</span><span class="o">.</span><span class="n">_num_pools</span> <span class="o">=</span> <span class="mi">2</span> <span class="k">if</span> <span class="n">num_pools</span> <span class="ow">is</span> <span class="kc">None</span> <span class="k">else</span> <span class="nb">int</span><span class="p">(</span><span class="n">num_pools</span><span class="p">)</span>
+</span><span id="1-199">
+</span><span id="1-200">        <span class="bp">self</span><span class="o">.</span><span class="n">_pool</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_make_pool</span><span class="p">(</span>
+</span><span id="1-201">            <span class="bp">self</span><span class="o">.</span><span class="n">parsed_dsn</span><span class="p">,</span>
+</span><span id="1-202">            <span class="n">http_proxy</span><span class="o">=</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;http_proxy&quot;</span><span class="p">],</span>
+</span><span id="1-203">            <span class="n">https_proxy</span><span class="o">=</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;https_proxy&quot;</span><span class="p">],</span>
+</span><span id="1-204">            <span class="n">ca_certs</span><span class="o">=</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;ca_certs&quot;</span><span class="p">],</span>
+</span><span id="1-205">            <span class="n">proxy_headers</span><span class="o">=</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;proxy_headers&quot;</span><span class="p">],</span>
+</span><span id="1-206">        <span class="p">)</span>
+</span><span id="1-207">
+</span><span id="1-208">        <span class="kn">from</span> <span class="nn">sentry_sdk</span> <span class="kn">import</span> <span class="n">Hub</span>
+</span><span id="1-209">
+</span><span id="1-210">        <span class="bp">self</span><span class="o">.</span><span class="n">hub_cls</span> <span class="o">=</span> <span class="n">Hub</span>
+</span><span id="1-211">
 <div class="viewcode-block" id="HttpTransport.record_lost_event">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.HttpTransport.record_lost_event">[docs]</a>
-</span><span id="1-196">    <span class="k">def</span> <span class="nf">record_lost_event</span><span class="p">(</span>
-</span><span id="1-197">        <span class="bp">self</span><span class="p">,</span>
-</span><span id="1-198">        <span class="n">reason</span><span class="p">,</span>  <span class="c1"># type: str</span>
-</span><span id="1-199">        <span class="n">data_category</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
-</span><span id="1-200">        <span class="n">item</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Item]</span>
-</span><span id="1-201">    <span class="p">):</span>
-</span><span id="1-202">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-203">        <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;send_client_reports&quot;</span><span class="p">]:</span>
-</span><span id="1-204">            <span class="k">return</span>
-</span><span id="1-205">
-</span><span id="1-206">        <span class="n">quantity</span> <span class="o">=</span> <span class="mi">1</span>
-</span><span id="1-207">        <span class="k">if</span> <span class="n">item</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-208">            <span class="n">data_category</span> <span class="o">=</span> <span class="n">item</span><span class="o">.</span><span class="n">data_category</span>
-</span><span id="1-209">            <span class="k">if</span> <span class="n">data_category</span> <span class="o">==</span> <span class="s2">&quot;attachment&quot;</span><span class="p">:</span>
-</span><span id="1-210">                <span class="c1"># quantity of 0 is actually 1 as we do not want to count</span>
-</span><span id="1-211">                <span class="c1"># empty attachments as actually empty.</span>
-</span><span id="1-212">                <span class="n">quantity</span> <span class="o">=</span> <span class="nb">len</span><span class="p">(</span><span class="n">item</span><span class="o">.</span><span class="n">get_bytes</span><span class="p">())</span> <span class="ow">or</span> <span class="mi">1</span>
-</span><span id="1-213">        <span class="k">elif</span> <span class="n">data_category</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-214">            <span class="k">raise</span> <span class="ne">TypeError</span><span class="p">(</span><span class="s2">&quot;data category not provided&quot;</span><span class="p">)</span>
-</span><span id="1-215">
-</span><span id="1-216">        <span class="bp">self</span><span class="o">.</span><span class="n">_discarded_events</span><span class="p">[</span><span class="n">data_category</span><span class="p">,</span> <span class="n">reason</span><span class="p">]</span> <span class="o">+=</span> <span class="n">quantity</span></div>
+</span><span id="1-212">    <span class="k">def</span> <span class="nf">record_lost_event</span><span class="p">(</span>
+</span><span id="1-213">        <span class="bp">self</span><span class="p">,</span>
+</span><span id="1-214">        <span class="n">reason</span><span class="p">,</span>  <span class="c1"># type: str</span>
+</span><span id="1-215">        <span class="n">data_category</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
+</span><span id="1-216">        <span class="n">item</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Item]</span>
+</span><span id="1-217">    <span class="p">):</span>
+</span><span id="1-218">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-219">        <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;send_client_reports&quot;</span><span class="p">]:</span>
+</span><span id="1-220">            <span class="k">return</span>
+</span><span id="1-221">
+</span><span id="1-222">        <span class="n">quantity</span> <span class="o">=</span> <span class="mi">1</span>
+</span><span id="1-223">        <span class="k">if</span> <span class="n">item</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-224">            <span class="n">data_category</span> <span class="o">=</span> <span class="n">item</span><span class="o">.</span><span class="n">data_category</span>
+</span><span id="1-225">            <span class="k">if</span> <span class="n">data_category</span> <span class="o">==</span> <span class="s2">&quot;attachment&quot;</span><span class="p">:</span>
+</span><span id="1-226">                <span class="c1"># quantity of 0 is actually 1 as we do not want to count</span>
+</span><span id="1-227">                <span class="c1"># empty attachments as actually empty.</span>
+</span><span id="1-228">                <span class="n">quantity</span> <span class="o">=</span> <span class="nb">len</span><span class="p">(</span><span class="n">item</span><span class="o">.</span><span class="n">get_bytes</span><span class="p">())</span> <span class="ow">or</span> <span class="mi">1</span>
+</span><span id="1-229">        <span class="k">elif</span> <span class="n">data_category</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-230">            <span class="k">raise</span> <span class="ne">TypeError</span><span class="p">(</span><span class="s2">&quot;data category not provided&quot;</span><span class="p">)</span>
+</span><span id="1-231">
+</span><span id="1-232">        <span class="bp">self</span><span class="o">.</span><span class="n">_discarded_events</span><span class="p">[</span><span class="n">data_category</span><span class="p">,</span> <span class="n">reason</span><span class="p">]</span> <span class="o">+=</span> <span class="n">quantity</span></div>
 
-</span><span id="1-217">
-</span><span id="1-218">    <span class="k">def</span> <span class="nf">_update_rate_limits</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">response</span><span class="p">):</span>
-</span><span id="1-219">        <span class="c1"># type: (urllib3.BaseHTTPResponse) -&gt; None</span>
-</span><span id="1-220">
-</span><span id="1-221">        <span class="c1"># new sentries with more rate limit insights.  We honor this header</span>
-</span><span id="1-222">        <span class="c1"># no matter of the status code to update our internal rate limits.</span>
-</span><span id="1-223">        <span class="n">header</span> <span class="o">=</span> <span class="n">response</span><span class="o">.</span><span class="n">headers</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;x-sentry-rate-limits&quot;</span><span class="p">)</span>
-</span><span id="1-224">        <span class="k">if</span> <span class="n">header</span><span class="p">:</span>
-</span><span id="1-225">            <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span><span class="s2">&quot;Rate-limited via x-sentry-rate-limits&quot;</span><span class="p">)</span>
-</span><span id="1-226">            <span class="bp">self</span><span class="o">.</span><span class="n">_disabled_until</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">_parse_rate_limits</span><span class="p">(</span><span class="n">header</span><span class="p">))</span>
-</span><span id="1-227">
-</span><span id="1-228">        <span class="c1"># old sentries only communicate global rate limit hits via the</span>
-</span><span id="1-229">        <span class="c1"># retry-after header on 429.  This header can also be emitted on new</span>
-</span><span id="1-230">        <span class="c1"># sentries if a proxy in front wants to globally slow things down.</span>
-</span><span id="1-231">        <span class="k">elif</span> <span class="n">response</span><span class="o">.</span><span class="n">status</span> <span class="o">==</span> <span class="mi">429</span><span class="p">:</span>
-</span><span id="1-232">            <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span><span class="s2">&quot;Rate-limited via 429&quot;</span><span class="p">)</span>
-</span><span id="1-233">            <span class="bp">self</span><span class="o">.</span><span class="n">_disabled_until</span><span class="p">[</span><span class="kc">None</span><span class="p">]</span> <span class="o">=</span> <span class="n">datetime_utcnow</span><span class="p">()</span> <span class="o">+</span> <span class="n">timedelta</span><span class="p">(</span>
-</span><span id="1-234">                <span class="n">seconds</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">_retry</span><span class="o">.</span><span class="n">get_retry_after</span><span class="p">(</span><span class="n">response</span><span class="p">)</span> <span class="ow">or</span> <span class="mi">60</span>
-</span><span id="1-235">            <span class="p">)</span>
+</span><span id="1-233">
+</span><span id="1-234">    <span class="k">def</span> <span class="nf">_update_rate_limits</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">response</span><span class="p">):</span>
+</span><span id="1-235">        <span class="c1"># type: (urllib3.BaseHTTPResponse) -&gt; None</span>
 </span><span id="1-236">
-</span><span id="1-237">    <span class="k">def</span> <span class="nf">_send_request</span><span class="p">(</span>
-</span><span id="1-238">        <span class="bp">self</span><span class="p">,</span>
-</span><span id="1-239">        <span class="n">body</span><span class="p">,</span>  <span class="c1"># type: bytes</span>
-</span><span id="1-240">        <span class="n">headers</span><span class="p">,</span>  <span class="c1"># type: Dict[str, str]</span>
-</span><span id="1-241">        <span class="n">endpoint_type</span><span class="o">=</span><span class="s2">&quot;store&quot;</span><span class="p">,</span>  <span class="c1"># type: EndpointType</span>
-</span><span id="1-242">        <span class="n">envelope</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Envelope]</span>
-</span><span id="1-243">    <span class="p">):</span>
-</span><span id="1-244">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-245">
-</span><span id="1-246">        <span class="k">def</span> <span class="nf">record_loss</span><span class="p">(</span><span class="n">reason</span><span class="p">):</span>
-</span><span id="1-247">            <span class="c1"># type: (str) -&gt; None</span>
-</span><span id="1-248">            <span class="k">if</span> <span class="n">envelope</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-249">                <span class="bp">self</span><span class="o">.</span><span class="n">record_lost_event</span><span class="p">(</span><span class="n">reason</span><span class="p">,</span> <span class="n">data_category</span><span class="o">=</span><span class="s2">&quot;error&quot;</span><span class="p">)</span>
-</span><span id="1-250">            <span class="k">else</span><span class="p">:</span>
-</span><span id="1-251">                <span class="k">for</span> <span class="n">item</span> <span class="ow">in</span> <span class="n">envelope</span><span class="o">.</span><span class="n">items</span><span class="p">:</span>
-</span><span id="1-252">                    <span class="bp">self</span><span class="o">.</span><span class="n">record_lost_event</span><span class="p">(</span><span class="n">reason</span><span class="p">,</span> <span class="n">item</span><span class="o">=</span><span class="n">item</span><span class="p">)</span>
-</span><span id="1-253">
-</span><span id="1-254">        <span class="n">headers</span><span class="o">.</span><span class="n">update</span><span class="p">(</span>
-</span><span id="1-255">            <span class="p">{</span>
-</span><span id="1-256">                <span class="s2">&quot;User-Agent&quot;</span><span class="p">:</span> <span class="nb">str</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_auth</span><span class="o">.</span><span class="n">client</span><span class="p">),</span>
-</span><span id="1-257">                <span class="s2">&quot;X-Sentry-Auth&quot;</span><span class="p">:</span> <span class="nb">str</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_auth</span><span class="o">.</span><span class="n">to_header</span><span class="p">()),</span>
-</span><span id="1-258">            <span class="p">}</span>
-</span><span id="1-259">        <span class="p">)</span>
-</span><span id="1-260">        <span class="k">try</span><span class="p">:</span>
-</span><span id="1-261">            <span class="n">response</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_pool</span><span class="o">.</span><span class="n">request</span><span class="p">(</span>
-</span><span id="1-262">                <span class="s2">&quot;POST&quot;</span><span class="p">,</span>
-</span><span id="1-263">                <span class="nb">str</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_auth</span><span class="o">.</span><span class="n">get_api_url</span><span class="p">(</span><span class="n">endpoint_type</span><span class="p">)),</span>
-</span><span id="1-264">                <span class="n">body</span><span class="o">=</span><span class="n">body</span><span class="p">,</span>
-</span><span id="1-265">                <span class="n">headers</span><span class="o">=</span><span class="n">headers</span><span class="p">,</span>
-</span><span id="1-266">            <span class="p">)</span>
-</span><span id="1-267">        <span class="k">except</span> <span class="ne">Exception</span><span class="p">:</span>
-</span><span id="1-268">            <span class="bp">self</span><span class="o">.</span><span class="n">on_dropped_event</span><span class="p">(</span><span class="s2">&quot;network&quot;</span><span class="p">)</span>
-</span><span id="1-269">            <span class="n">record_loss</span><span class="p">(</span><span class="s2">&quot;network_error&quot;</span><span class="p">)</span>
-</span><span id="1-270">            <span class="k">raise</span>
-</span><span id="1-271">
-</span><span id="1-272">        <span class="k">try</span><span class="p">:</span>
-</span><span id="1-273">            <span class="bp">self</span><span class="o">.</span><span class="n">_update_rate_limits</span><span class="p">(</span><span class="n">response</span><span class="p">)</span>
-</span><span id="1-274">
-</span><span id="1-275">            <span class="k">if</span> <span class="n">response</span><span class="o">.</span><span class="n">status</span> <span class="o">==</span> <span class="mi">429</span><span class="p">:</span>
-</span><span id="1-276">                <span class="c1"># if we hit a 429.  Something was rate limited but we already</span>
-</span><span id="1-277">                <span class="c1"># acted on this in `self._update_rate_limits`.  Note that we</span>
-</span><span id="1-278">                <span class="c1"># do not want to record event loss here as we will have recorded</span>
-</span><span id="1-279">                <span class="c1"># an outcome in relay already.</span>
-</span><span id="1-280">                <span class="bp">self</span><span class="o">.</span><span class="n">on_dropped_event</span><span class="p">(</span><span class="s2">&quot;status_429&quot;</span><span class="p">)</span>
-</span><span id="1-281">                <span class="k">pass</span>
-</span><span id="1-282">
-</span><span id="1-283">            <span class="k">elif</span> <span class="n">response</span><span class="o">.</span><span class="n">status</span> <span class="o">&gt;=</span> <span class="mi">300</span> <span class="ow">or</span> <span class="n">response</span><span class="o">.</span><span class="n">status</span> <span class="o">&lt;</span> <span class="mi">200</span><span class="p">:</span>
-</span><span id="1-284">                <span class="n">logger</span><span class="o">.</span><span class="n">error</span><span class="p">(</span>
-</span><span id="1-285">                    <span class="s2">&quot;Unexpected status code: </span><span class="si">%s</span><span class="s2"> (body: </span><span class="si">%s</span><span class="s2">)&quot;</span><span class="p">,</span>
-</span><span id="1-286">                    <span class="n">response</span><span class="o">.</span><span class="n">status</span><span class="p">,</span>
-</span><span id="1-287">                    <span class="n">response</span><span class="o">.</span><span class="n">data</span><span class="p">,</span>
-</span><span id="1-288">                <span class="p">)</span>
-</span><span id="1-289">                <span class="bp">self</span><span class="o">.</span><span class="n">on_dropped_event</span><span class="p">(</span><span class="s2">&quot;status_</span><span class="si">{}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">response</span><span class="o">.</span><span class="n">status</span><span class="p">))</span>
-</span><span id="1-290">                <span class="n">record_loss</span><span class="p">(</span><span class="s2">&quot;network_error&quot;</span><span class="p">)</span>
-</span><span id="1-291">        <span class="k">finally</span><span class="p">:</span>
-</span><span id="1-292">            <span class="n">response</span><span class="o">.</span><span class="n">close</span><span class="p">()</span>
-</span><span id="1-293">
-</span><span id="1-294">    <span class="k">def</span> <span class="nf">on_dropped_event</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">reason</span><span class="p">):</span>
-</span><span id="1-295">        <span class="c1"># type: (str) -&gt; None</span>
-</span><span id="1-296">        <span class="k">return</span> <span class="kc">None</span>
-</span><span id="1-297">
-</span><span id="1-298">    <span class="k">def</span> <span class="nf">_fetch_pending_client_report</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">force</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">interval</span><span class="o">=</span><span class="mi">60</span><span class="p">):</span>
-</span><span id="1-299">        <span class="c1"># type: (bool, int) -&gt; Optional[Item]</span>
-</span><span id="1-300">        <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;send_client_reports&quot;</span><span class="p">]:</span>
-</span><span id="1-301">            <span class="k">return</span> <span class="kc">None</span>
-</span><span id="1-302">
-</span><span id="1-303">        <span class="k">if</span> <span class="ow">not</span> <span class="p">(</span><span class="n">force</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">_last_client_report_sent</span> <span class="o">&lt;</span> <span class="n">time</span><span class="o">.</span><span class="n">time</span><span class="p">()</span> <span class="o">-</span> <span class="n">interval</span><span class="p">):</span>
-</span><span id="1-304">            <span class="k">return</span> <span class="kc">None</span>
-</span><span id="1-305">
-</span><span id="1-306">        <span class="n">discarded_events</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_discarded_events</span>
-</span><span id="1-307">        <span class="bp">self</span><span class="o">.</span><span class="n">_discarded_events</span> <span class="o">=</span> <span class="n">defaultdict</span><span class="p">(</span><span class="nb">int</span><span class="p">)</span>
-</span><span id="1-308">        <span class="bp">self</span><span class="o">.</span><span class="n">_last_client_report_sent</span> <span class="o">=</span> <span class="n">time</span><span class="o">.</span><span class="n">time</span><span class="p">()</span>
+</span><span id="1-237">        <span class="c1"># new sentries with more rate limit insights.  We honor this header</span>
+</span><span id="1-238">        <span class="c1"># no matter of the status code to update our internal rate limits.</span>
+</span><span id="1-239">        <span class="n">header</span> <span class="o">=</span> <span class="n">response</span><span class="o">.</span><span class="n">headers</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;x-sentry-rate-limits&quot;</span><span class="p">)</span>
+</span><span id="1-240">        <span class="k">if</span> <span class="n">header</span><span class="p">:</span>
+</span><span id="1-241">            <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span><span class="s2">&quot;Rate-limited via x-sentry-rate-limits&quot;</span><span class="p">)</span>
+</span><span id="1-242">            <span class="bp">self</span><span class="o">.</span><span class="n">_disabled_until</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">_parse_rate_limits</span><span class="p">(</span><span class="n">header</span><span class="p">))</span>
+</span><span id="1-243">
+</span><span id="1-244">        <span class="c1"># old sentries only communicate global rate limit hits via the</span>
+</span><span id="1-245">        <span class="c1"># retry-after header on 429.  This header can also be emitted on new</span>
+</span><span id="1-246">        <span class="c1"># sentries if a proxy in front wants to globally slow things down.</span>
+</span><span id="1-247">        <span class="k">elif</span> <span class="n">response</span><span class="o">.</span><span class="n">status</span> <span class="o">==</span> <span class="mi">429</span><span class="p">:</span>
+</span><span id="1-248">            <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span><span class="s2">&quot;Rate-limited via 429&quot;</span><span class="p">)</span>
+</span><span id="1-249">            <span class="bp">self</span><span class="o">.</span><span class="n">_disabled_until</span><span class="p">[</span><span class="kc">None</span><span class="p">]</span> <span class="o">=</span> <span class="n">datetime</span><span class="o">.</span><span class="n">now</span><span class="p">(</span><span class="n">timezone</span><span class="o">.</span><span class="n">utc</span><span class="p">)</span> <span class="o">+</span> <span class="n">timedelta</span><span class="p">(</span>
+</span><span id="1-250">                <span class="n">seconds</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">_retry</span><span class="o">.</span><span class="n">get_retry_after</span><span class="p">(</span><span class="n">response</span><span class="p">)</span> <span class="ow">or</span> <span class="mi">60</span>
+</span><span id="1-251">            <span class="p">)</span>
+</span><span id="1-252">
+</span><span id="1-253">    <span class="k">def</span> <span class="nf">_send_request</span><span class="p">(</span>
+</span><span id="1-254">        <span class="bp">self</span><span class="p">,</span>
+</span><span id="1-255">        <span class="n">body</span><span class="p">,</span>  <span class="c1"># type: bytes</span>
+</span><span id="1-256">        <span class="n">headers</span><span class="p">,</span>  <span class="c1"># type: Dict[str, str]</span>
+</span><span id="1-257">        <span class="n">endpoint_type</span><span class="o">=</span><span class="n">EndpointType</span><span class="o">.</span><span class="n">ENVELOPE</span><span class="p">,</span>  <span class="c1"># type: EndpointType</span>
+</span><span id="1-258">        <span class="n">envelope</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Envelope]</span>
+</span><span id="1-259">    <span class="p">):</span>
+</span><span id="1-260">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-261">
+</span><span id="1-262">        <span class="k">def</span> <span class="nf">record_loss</span><span class="p">(</span><span class="n">reason</span><span class="p">):</span>
+</span><span id="1-263">            <span class="c1"># type: (str) -&gt; None</span>
+</span><span id="1-264">            <span class="k">if</span> <span class="n">envelope</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-265">                <span class="bp">self</span><span class="o">.</span><span class="n">record_lost_event</span><span class="p">(</span><span class="n">reason</span><span class="p">,</span> <span class="n">data_category</span><span class="o">=</span><span class="s2">&quot;error&quot;</span><span class="p">)</span>
+</span><span id="1-266">            <span class="k">else</span><span class="p">:</span>
+</span><span id="1-267">                <span class="k">for</span> <span class="n">item</span> <span class="ow">in</span> <span class="n">envelope</span><span class="o">.</span><span class="n">items</span><span class="p">:</span>
+</span><span id="1-268">                    <span class="bp">self</span><span class="o">.</span><span class="n">record_lost_event</span><span class="p">(</span><span class="n">reason</span><span class="p">,</span> <span class="n">item</span><span class="o">=</span><span class="n">item</span><span class="p">)</span>
+</span><span id="1-269">
+</span><span id="1-270">        <span class="n">headers</span><span class="o">.</span><span class="n">update</span><span class="p">(</span>
+</span><span id="1-271">            <span class="p">{</span>
+</span><span id="1-272">                <span class="s2">&quot;User-Agent&quot;</span><span class="p">:</span> <span class="nb">str</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_auth</span><span class="o">.</span><span class="n">client</span><span class="p">),</span>
+</span><span id="1-273">                <span class="s2">&quot;X-Sentry-Auth&quot;</span><span class="p">:</span> <span class="nb">str</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_auth</span><span class="o">.</span><span class="n">to_header</span><span class="p">()),</span>
+</span><span id="1-274">            <span class="p">}</span>
+</span><span id="1-275">        <span class="p">)</span>
+</span><span id="1-276">        <span class="k">try</span><span class="p">:</span>
+</span><span id="1-277">            <span class="n">response</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_pool</span><span class="o">.</span><span class="n">request</span><span class="p">(</span>
+</span><span id="1-278">                <span class="s2">&quot;POST&quot;</span><span class="p">,</span>
+</span><span id="1-279">                <span class="nb">str</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_auth</span><span class="o">.</span><span class="n">get_api_url</span><span class="p">(</span><span class="n">endpoint_type</span><span class="p">)),</span>
+</span><span id="1-280">                <span class="n">body</span><span class="o">=</span><span class="n">body</span><span class="p">,</span>
+</span><span id="1-281">                <span class="n">headers</span><span class="o">=</span><span class="n">headers</span><span class="p">,</span>
+</span><span id="1-282">            <span class="p">)</span>
+</span><span id="1-283">        <span class="k">except</span> <span class="ne">Exception</span><span class="p">:</span>
+</span><span id="1-284">            <span class="bp">self</span><span class="o">.</span><span class="n">on_dropped_event</span><span class="p">(</span><span class="s2">&quot;network&quot;</span><span class="p">)</span>
+</span><span id="1-285">            <span class="n">record_loss</span><span class="p">(</span><span class="s2">&quot;network_error&quot;</span><span class="p">)</span>
+</span><span id="1-286">            <span class="k">raise</span>
+</span><span id="1-287">
+</span><span id="1-288">        <span class="k">try</span><span class="p">:</span>
+</span><span id="1-289">            <span class="bp">self</span><span class="o">.</span><span class="n">_update_rate_limits</span><span class="p">(</span><span class="n">response</span><span class="p">)</span>
+</span><span id="1-290">
+</span><span id="1-291">            <span class="k">if</span> <span class="n">response</span><span class="o">.</span><span class="n">status</span> <span class="o">==</span> <span class="mi">429</span><span class="p">:</span>
+</span><span id="1-292">                <span class="c1"># if we hit a 429.  Something was rate limited but we already</span>
+</span><span id="1-293">                <span class="c1"># acted on this in `self._update_rate_limits`.  Note that we</span>
+</span><span id="1-294">                <span class="c1"># do not want to record event loss here as we will have recorded</span>
+</span><span id="1-295">                <span class="c1"># an outcome in relay already.</span>
+</span><span id="1-296">                <span class="bp">self</span><span class="o">.</span><span class="n">on_dropped_event</span><span class="p">(</span><span class="s2">&quot;status_429&quot;</span><span class="p">)</span>
+</span><span id="1-297">                <span class="k">pass</span>
+</span><span id="1-298">
+</span><span id="1-299">            <span class="k">elif</span> <span class="n">response</span><span class="o">.</span><span class="n">status</span> <span class="o">&gt;=</span> <span class="mi">300</span> <span class="ow">or</span> <span class="n">response</span><span class="o">.</span><span class="n">status</span> <span class="o">&lt;</span> <span class="mi">200</span><span class="p">:</span>
+</span><span id="1-300">                <span class="n">logger</span><span class="o">.</span><span class="n">error</span><span class="p">(</span>
+</span><span id="1-301">                    <span class="s2">&quot;Unexpected status code: </span><span class="si">%s</span><span class="s2"> (body: </span><span class="si">%s</span><span class="s2">)&quot;</span><span class="p">,</span>
+</span><span id="1-302">                    <span class="n">response</span><span class="o">.</span><span class="n">status</span><span class="p">,</span>
+</span><span id="1-303">                    <span class="n">response</span><span class="o">.</span><span class="n">data</span><span class="p">,</span>
+</span><span id="1-304">                <span class="p">)</span>
+</span><span id="1-305">                <span class="bp">self</span><span class="o">.</span><span class="n">on_dropped_event</span><span class="p">(</span><span class="s2">&quot;status_</span><span class="si">{}</span><span class="s2">&quot;</span><span class="o">.</span><span class="n">format</span><span class="p">(</span><span class="n">response</span><span class="o">.</span><span class="n">status</span><span class="p">))</span>
+</span><span id="1-306">                <span class="n">record_loss</span><span class="p">(</span><span class="s2">&quot;network_error&quot;</span><span class="p">)</span>
+</span><span id="1-307">        <span class="k">finally</span><span class="p">:</span>
+</span><span id="1-308">            <span class="n">response</span><span class="o">.</span><span class="n">close</span><span class="p">()</span>
 </span><span id="1-309">
-</span><span id="1-310">        <span class="k">if</span> <span class="ow">not</span> <span class="n">discarded_events</span><span class="p">:</span>
-</span><span id="1-311">            <span class="k">return</span> <span class="kc">None</span>
-</span><span id="1-312">
-</span><span id="1-313">        <span class="k">return</span> <span class="n">Item</span><span class="p">(</span>
-</span><span id="1-314">            <span class="n">PayloadRef</span><span class="p">(</span>
-</span><span id="1-315">                <span class="n">json</span><span class="o">=</span><span class="p">{</span>
-</span><span id="1-316">                    <span class="s2">&quot;timestamp&quot;</span><span class="p">:</span> <span class="n">time</span><span class="o">.</span><span class="n">time</span><span class="p">(),</span>
-</span><span id="1-317">                    <span class="s2">&quot;discarded_events&quot;</span><span class="p">:</span> <span class="p">[</span>
-</span><span id="1-318">                        <span class="p">{</span><span class="s2">&quot;reason&quot;</span><span class="p">:</span> <span class="n">reason</span><span class="p">,</span> <span class="s2">&quot;category&quot;</span><span class="p">:</span> <span class="n">category</span><span class="p">,</span> <span class="s2">&quot;quantity&quot;</span><span class="p">:</span> <span class="n">quantity</span><span class="p">}</span>
-</span><span id="1-319">                        <span class="k">for</span> <span class="p">(</span>
-</span><span id="1-320">                            <span class="p">(</span><span class="n">category</span><span class="p">,</span> <span class="n">reason</span><span class="p">),</span>
-</span><span id="1-321">                            <span class="n">quantity</span><span class="p">,</span>
-</span><span id="1-322">                        <span class="p">)</span> <span class="ow">in</span> <span class="n">discarded_events</span><span class="o">.</span><span class="n">items</span><span class="p">()</span>
-</span><span id="1-323">                    <span class="p">],</span>
-</span><span id="1-324">                <span class="p">}</span>
-</span><span id="1-325">            <span class="p">),</span>
-</span><span id="1-326">            <span class="nb">type</span><span class="o">=</span><span class="s2">&quot;client_report&quot;</span><span class="p">,</span>
-</span><span id="1-327">        <span class="p">)</span>
+</span><span id="1-310">    <span class="k">def</span> <span class="nf">on_dropped_event</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">reason</span><span class="p">):</span>
+</span><span id="1-311">        <span class="c1"># type: (str) -&gt; None</span>
+</span><span id="1-312">        <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-313">
+</span><span id="1-314">    <span class="k">def</span> <span class="nf">_fetch_pending_client_report</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">force</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">interval</span><span class="o">=</span><span class="mi">60</span><span class="p">):</span>
+</span><span id="1-315">        <span class="c1"># type: (bool, int) -&gt; Optional[Item]</span>
+</span><span id="1-316">        <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;send_client_reports&quot;</span><span class="p">]:</span>
+</span><span id="1-317">            <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-318">
+</span><span id="1-319">        <span class="k">if</span> <span class="ow">not</span> <span class="p">(</span><span class="n">force</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">_last_client_report_sent</span> <span class="o">&lt;</span> <span class="n">time</span><span class="o">.</span><span class="n">time</span><span class="p">()</span> <span class="o">-</span> <span class="n">interval</span><span class="p">):</span>
+</span><span id="1-320">            <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-321">
+</span><span id="1-322">        <span class="n">discarded_events</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_discarded_events</span>
+</span><span id="1-323">        <span class="bp">self</span><span class="o">.</span><span class="n">_discarded_events</span> <span class="o">=</span> <span class="n">defaultdict</span><span class="p">(</span><span class="nb">int</span><span class="p">)</span>
+</span><span id="1-324">        <span class="bp">self</span><span class="o">.</span><span class="n">_last_client_report_sent</span> <span class="o">=</span> <span class="n">time</span><span class="o">.</span><span class="n">time</span><span class="p">()</span>
+</span><span id="1-325">
+</span><span id="1-326">        <span class="k">if</span> <span class="ow">not</span> <span class="n">discarded_events</span><span class="p">:</span>
+</span><span id="1-327">            <span class="k">return</span> <span class="kc">None</span>
 </span><span id="1-328">
-</span><span id="1-329">    <span class="k">def</span> <span class="nf">_flush_client_reports</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">force</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
-</span><span id="1-330">        <span class="c1"># type: (bool) -&gt; None</span>
-</span><span id="1-331">        <span class="n">client_report</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_fetch_pending_client_report</span><span class="p">(</span><span class="n">force</span><span class="o">=</span><span class="n">force</span><span class="p">,</span> <span class="n">interval</span><span class="o">=</span><span class="mi">60</span><span class="p">)</span>
-</span><span id="1-332">        <span class="k">if</span> <span class="n">client_report</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-333">            <span class="bp">self</span><span class="o">.</span><span class="n">capture_envelope</span><span class="p">(</span><span class="n">Envelope</span><span class="p">(</span><span class="n">items</span><span class="o">=</span><span class="p">[</span><span class="n">client_report</span><span class="p">]))</span>
-</span><span id="1-334">
-</span><span id="1-335">    <span class="k">def</span> <span class="nf">_check_disabled</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">category</span><span class="p">):</span>
-</span><span id="1-336">        <span class="c1"># type: (str) -&gt; bool</span>
-</span><span id="1-337">        <span class="k">def</span> <span class="nf">_disabled</span><span class="p">(</span><span class="n">bucket</span><span class="p">):</span>
-</span><span id="1-338">            <span class="c1"># type: (Any) -&gt; bool</span>
-</span><span id="1-339">            <span class="n">ts</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_disabled_until</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">bucket</span><span class="p">)</span>
-</span><span id="1-340">            <span class="k">return</span> <span class="n">ts</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">ts</span> <span class="o">&gt;</span> <span class="n">datetime_utcnow</span><span class="p">()</span>
-</span><span id="1-341">
-</span><span id="1-342">        <span class="k">return</span> <span class="n">_disabled</span><span class="p">(</span><span class="n">category</span><span class="p">)</span> <span class="ow">or</span> <span class="n">_disabled</span><span class="p">(</span><span class="kc">None</span><span class="p">)</span>
-</span><span id="1-343">
-</span><span id="1-344">    <span class="k">def</span> <span class="nf">_is_rate_limited</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-345">        <span class="c1"># type: () -&gt; bool</span>
-</span><span id="1-346">        <span class="k">return</span> <span class="nb">any</span><span class="p">(</span><span class="n">ts</span> <span class="o">&gt;</span> <span class="n">datetime_utcnow</span><span class="p">()</span> <span class="k">for</span> <span class="n">ts</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_disabled_until</span><span class="o">.</span><span class="n">values</span><span class="p">())</span>
-</span><span id="1-347">
-</span><span id="1-348">    <span class="k">def</span> <span class="nf">_is_worker_full</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-349">        <span class="c1"># type: () -&gt; bool</span>
-</span><span id="1-350">        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_worker</span><span class="o">.</span><span class="n">full</span><span class="p">()</span>
-</span><span id="1-351">
-</span><span id="1-352">    <span class="k">def</span> <span class="nf">is_healthy</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-353">        <span class="c1"># type: () -&gt; bool</span>
-</span><span id="1-354">        <span class="k">return</span> <span class="ow">not</span> <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_is_worker_full</span><span class="p">()</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">_is_rate_limited</span><span class="p">())</span>
-</span><span id="1-355">
-</span><span id="1-356">    <span class="k">def</span> <span class="nf">_send_event</span><span class="p">(</span>
-</span><span id="1-357">        <span class="bp">self</span><span class="p">,</span> <span class="n">event</span>  <span class="c1"># type: Event</span>
-</span><span id="1-358">    <span class="p">):</span>
-</span><span id="1-359">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-360">
-</span><span id="1-361">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_check_disabled</span><span class="p">(</span><span class="s2">&quot;error&quot;</span><span class="p">):</span>
-</span><span id="1-362">            <span class="bp">self</span><span class="o">.</span><span class="n">on_dropped_event</span><span class="p">(</span><span class="s2">&quot;self_rate_limits&quot;</span><span class="p">)</span>
-</span><span id="1-363">            <span class="bp">self</span><span class="o">.</span><span class="n">record_lost_event</span><span class="p">(</span><span class="s2">&quot;ratelimit_backoff&quot;</span><span class="p">,</span> <span class="n">data_category</span><span class="o">=</span><span class="s2">&quot;error&quot;</span><span class="p">)</span>
-</span><span id="1-364">            <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-329">        <span class="k">return</span> <span class="n">Item</span><span class="p">(</span>
+</span><span id="1-330">            <span class="n">PayloadRef</span><span class="p">(</span>
+</span><span id="1-331">                <span class="n">json</span><span class="o">=</span><span class="p">{</span>
+</span><span id="1-332">                    <span class="s2">&quot;timestamp&quot;</span><span class="p">:</span> <span class="n">time</span><span class="o">.</span><span class="n">time</span><span class="p">(),</span>
+</span><span id="1-333">                    <span class="s2">&quot;discarded_events&quot;</span><span class="p">:</span> <span class="p">[</span>
+</span><span id="1-334">                        <span class="p">{</span><span class="s2">&quot;reason&quot;</span><span class="p">:</span> <span class="n">reason</span><span class="p">,</span> <span class="s2">&quot;category&quot;</span><span class="p">:</span> <span class="n">category</span><span class="p">,</span> <span class="s2">&quot;quantity&quot;</span><span class="p">:</span> <span class="n">quantity</span><span class="p">}</span>
+</span><span id="1-335">                        <span class="k">for</span> <span class="p">(</span>
+</span><span id="1-336">                            <span class="p">(</span><span class="n">category</span><span class="p">,</span> <span class="n">reason</span><span class="p">),</span>
+</span><span id="1-337">                            <span class="n">quantity</span><span class="p">,</span>
+</span><span id="1-338">                        <span class="p">)</span> <span class="ow">in</span> <span class="n">discarded_events</span><span class="o">.</span><span class="n">items</span><span class="p">()</span>
+</span><span id="1-339">                    <span class="p">],</span>
+</span><span id="1-340">                <span class="p">}</span>
+</span><span id="1-341">            <span class="p">),</span>
+</span><span id="1-342">            <span class="nb">type</span><span class="o">=</span><span class="s2">&quot;client_report&quot;</span><span class="p">,</span>
+</span><span id="1-343">        <span class="p">)</span>
+</span><span id="1-344">
+</span><span id="1-345">    <span class="k">def</span> <span class="nf">_flush_client_reports</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">force</span><span class="o">=</span><span class="kc">False</span><span class="p">):</span>
+</span><span id="1-346">        <span class="c1"># type: (bool) -&gt; None</span>
+</span><span id="1-347">        <span class="n">client_report</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_fetch_pending_client_report</span><span class="p">(</span><span class="n">force</span><span class="o">=</span><span class="n">force</span><span class="p">,</span> <span class="n">interval</span><span class="o">=</span><span class="mi">60</span><span class="p">)</span>
+</span><span id="1-348">        <span class="k">if</span> <span class="n">client_report</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-349">            <span class="bp">self</span><span class="o">.</span><span class="n">capture_envelope</span><span class="p">(</span><span class="n">Envelope</span><span class="p">(</span><span class="n">items</span><span class="o">=</span><span class="p">[</span><span class="n">client_report</span><span class="p">]))</span>
+</span><span id="1-350">
+</span><span id="1-351">    <span class="k">def</span> <span class="nf">_check_disabled</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">category</span><span class="p">):</span>
+</span><span id="1-352">        <span class="c1"># type: (str) -&gt; bool</span>
+</span><span id="1-353">        <span class="k">def</span> <span class="nf">_disabled</span><span class="p">(</span><span class="n">bucket</span><span class="p">):</span>
+</span><span id="1-354">            <span class="c1"># type: (Any) -&gt; bool</span>
+</span><span id="1-355">            <span class="n">ts</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_disabled_until</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">bucket</span><span class="p">)</span>
+</span><span id="1-356">            <span class="k">return</span> <span class="n">ts</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">ts</span> <span class="o">&gt;</span> <span class="n">datetime</span><span class="o">.</span><span class="n">now</span><span class="p">(</span><span class="n">timezone</span><span class="o">.</span><span class="n">utc</span><span class="p">)</span>
+</span><span id="1-357">
+</span><span id="1-358">        <span class="k">return</span> <span class="n">_disabled</span><span class="p">(</span><span class="n">category</span><span class="p">)</span> <span class="ow">or</span> <span class="n">_disabled</span><span class="p">(</span><span class="kc">None</span><span class="p">)</span>
+</span><span id="1-359">
+</span><span id="1-360">    <span class="k">def</span> <span class="nf">_is_rate_limited</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-361">        <span class="c1"># type: () -&gt; bool</span>
+</span><span id="1-362">        <span class="k">return</span> <span class="nb">any</span><span class="p">(</span>
+</span><span id="1-363">            <span class="n">ts</span> <span class="o">&gt;</span> <span class="n">datetime</span><span class="o">.</span><span class="n">now</span><span class="p">(</span><span class="n">timezone</span><span class="o">.</span><span class="n">utc</span><span class="p">)</span> <span class="k">for</span> <span class="n">ts</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_disabled_until</span><span class="o">.</span><span class="n">values</span><span class="p">()</span>
+</span><span id="1-364">        <span class="p">)</span>
 </span><span id="1-365">
-</span><span id="1-366">        <span class="n">body</span> <span class="o">=</span> <span class="n">io</span><span class="o">.</span><span class="n">BytesIO</span><span class="p">()</span>
-</span><span id="1-367">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_compresslevel</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
-</span><span id="1-368">            <span class="n">body</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">json_dumps</span><span class="p">(</span><span class="n">event</span><span class="p">))</span>
-</span><span id="1-369">        <span class="k">else</span><span class="p">:</span>
-</span><span id="1-370">            <span class="k">with</span> <span class="n">gzip</span><span class="o">.</span><span class="n">GzipFile</span><span class="p">(</span>
-</span><span id="1-371">                <span class="n">fileobj</span><span class="o">=</span><span class="n">body</span><span class="p">,</span> <span class="n">mode</span><span class="o">=</span><span class="s2">&quot;w&quot;</span><span class="p">,</span> <span class="n">compresslevel</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">_compresslevel</span>
-</span><span id="1-372">            <span class="p">)</span> <span class="k">as</span> <span class="n">f</span><span class="p">:</span>
-</span><span id="1-373">                <span class="n">f</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">json_dumps</span><span class="p">(</span><span class="n">event</span><span class="p">))</span>
-</span><span id="1-374">
-</span><span id="1-375">        <span class="k">assert</span> <span class="bp">self</span><span class="o">.</span><span class="n">parsed_dsn</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span>
-</span><span id="1-376">        <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span>
-</span><span id="1-377">            <span class="s2">&quot;Sending event, type:</span><span class="si">%s</span><span class="s2"> level:</span><span class="si">%s</span><span class="s2"> event_id:</span><span class="si">%s</span><span class="s2"> project:</span><span class="si">%s</span><span class="s2"> host:</span><span class="si">%s</span><span class="s2">&quot;</span>
-</span><span id="1-378">            <span class="o">%</span> <span class="p">(</span>
-</span><span id="1-379">                <span class="n">event</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;type&quot;</span><span class="p">)</span> <span class="ow">or</span> <span class="s2">&quot;null&quot;</span><span class="p">,</span>
-</span><span id="1-380">                <span class="n">event</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;level&quot;</span><span class="p">)</span> <span class="ow">or</span> <span class="s2">&quot;null&quot;</span><span class="p">,</span>
-</span><span id="1-381">                <span class="n">event</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;event_id&quot;</span><span class="p">)</span> <span class="ow">or</span> <span class="s2">&quot;null&quot;</span><span class="p">,</span>
-</span><span id="1-382">                <span class="bp">self</span><span class="o">.</span><span class="n">parsed_dsn</span><span class="o">.</span><span class="n">project_id</span><span class="p">,</span>
-</span><span id="1-383">                <span class="bp">self</span><span class="o">.</span><span class="n">parsed_dsn</span><span class="o">.</span><span class="n">host</span><span class="p">,</span>
-</span><span id="1-384">            <span class="p">)</span>
-</span><span id="1-385">        <span class="p">)</span>
-</span><span id="1-386">
-</span><span id="1-387">        <span class="n">headers</span> <span class="o">=</span> <span class="p">{</span>
-</span><span id="1-388">            <span class="s2">&quot;Content-Type&quot;</span><span class="p">:</span> <span class="s2">&quot;application/json&quot;</span><span class="p">,</span>
-</span><span id="1-389">        <span class="p">}</span>
-</span><span id="1-390">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_compresslevel</span> <span class="o">&gt;</span> <span class="mi">0</span><span class="p">:</span>
-</span><span id="1-391">            <span class="n">headers</span><span class="p">[</span><span class="s2">&quot;Content-Encoding&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="s2">&quot;gzip&quot;</span>
+</span><span id="1-366">    <span class="k">def</span> <span class="nf">_is_worker_full</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-367">        <span class="c1"># type: () -&gt; bool</span>
+</span><span id="1-368">        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_worker</span><span class="o">.</span><span class="n">full</span><span class="p">()</span>
+</span><span id="1-369">
+</span><span id="1-370">    <span class="k">def</span> <span class="nf">is_healthy</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-371">        <span class="c1"># type: () -&gt; bool</span>
+</span><span id="1-372">        <span class="k">return</span> <span class="ow">not</span> <span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_is_worker_full</span><span class="p">()</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">_is_rate_limited</span><span class="p">())</span>
+</span><span id="1-373">
+</span><span id="1-374">    <span class="k">def</span> <span class="nf">_send_envelope</span><span class="p">(</span>
+</span><span id="1-375">        <span class="bp">self</span><span class="p">,</span> <span class="n">envelope</span>  <span class="c1"># type: Envelope</span>
+</span><span id="1-376">    <span class="p">):</span>
+</span><span id="1-377">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-378">
+</span><span id="1-379">        <span class="c1"># remove all items from the envelope which are over quota</span>
+</span><span id="1-380">        <span class="n">new_items</span> <span class="o">=</span> <span class="p">[]</span>
+</span><span id="1-381">        <span class="k">for</span> <span class="n">item</span> <span class="ow">in</span> <span class="n">envelope</span><span class="o">.</span><span class="n">items</span><span class="p">:</span>
+</span><span id="1-382">            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_check_disabled</span><span class="p">(</span><span class="n">item</span><span class="o">.</span><span class="n">data_category</span><span class="p">):</span>
+</span><span id="1-383">                <span class="k">if</span> <span class="n">item</span><span class="o">.</span><span class="n">data_category</span> <span class="ow">in</span> <span class="p">(</span><span class="s2">&quot;transaction&quot;</span><span class="p">,</span> <span class="s2">&quot;error&quot;</span><span class="p">,</span> <span class="s2">&quot;default&quot;</span><span class="p">):</span>
+</span><span id="1-384">                    <span class="bp">self</span><span class="o">.</span><span class="n">on_dropped_event</span><span class="p">(</span><span class="s2">&quot;self_rate_limits&quot;</span><span class="p">)</span>
+</span><span id="1-385">                <span class="bp">self</span><span class="o">.</span><span class="n">record_lost_event</span><span class="p">(</span><span class="s2">&quot;ratelimit_backoff&quot;</span><span class="p">,</span> <span class="n">item</span><span class="o">=</span><span class="n">item</span><span class="p">)</span>
+</span><span id="1-386">            <span class="k">else</span><span class="p">:</span>
+</span><span id="1-387">                <span class="n">new_items</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">item</span><span class="p">)</span>
+</span><span id="1-388">
+</span><span id="1-389">        <span class="c1"># Since we&#39;re modifying the envelope here make a copy so that others</span>
+</span><span id="1-390">        <span class="c1"># that hold references do not see their envelope modified.</span>
+</span><span id="1-391">        <span class="n">envelope</span> <span class="o">=</span> <span class="n">Envelope</span><span class="p">(</span><span class="n">headers</span><span class="o">=</span><span class="n">envelope</span><span class="o">.</span><span class="n">headers</span><span class="p">,</span> <span class="n">items</span><span class="o">=</span><span class="n">new_items</span><span class="p">)</span>
 </span><span id="1-392">
-</span><span id="1-393">        <span class="bp">self</span><span class="o">.</span><span class="n">_send_request</span><span class="p">(</span><span class="n">body</span><span class="o">.</span><span class="n">getvalue</span><span class="p">(),</span> <span class="n">headers</span><span class="o">=</span><span class="n">headers</span><span class="p">)</span>
-</span><span id="1-394">        <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-393">        <span class="k">if</span> <span class="ow">not</span> <span class="n">envelope</span><span class="o">.</span><span class="n">items</span><span class="p">:</span>
+</span><span id="1-394">            <span class="k">return</span> <span class="kc">None</span>
 </span><span id="1-395">
-</span><span id="1-396">    <span class="k">def</span> <span class="nf">_send_envelope</span><span class="p">(</span>
-</span><span id="1-397">        <span class="bp">self</span><span class="p">,</span> <span class="n">envelope</span>  <span class="c1"># type: Envelope</span>
-</span><span id="1-398">    <span class="p">):</span>
-</span><span id="1-399">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-400">
-</span><span id="1-401">        <span class="c1"># remove all items from the envelope which are over quota</span>
-</span><span id="1-402">        <span class="n">new_items</span> <span class="o">=</span> <span class="p">[]</span>
-</span><span id="1-403">        <span class="k">for</span> <span class="n">item</span> <span class="ow">in</span> <span class="n">envelope</span><span class="o">.</span><span class="n">items</span><span class="p">:</span>
-</span><span id="1-404">            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_check_disabled</span><span class="p">(</span><span class="n">item</span><span class="o">.</span><span class="n">data_category</span><span class="p">):</span>
-</span><span id="1-405">                <span class="k">if</span> <span class="n">item</span><span class="o">.</span><span class="n">data_category</span> <span class="ow">in</span> <span class="p">(</span><span class="s2">&quot;transaction&quot;</span><span class="p">,</span> <span class="s2">&quot;error&quot;</span><span class="p">,</span> <span class="s2">&quot;default&quot;</span><span class="p">):</span>
-</span><span id="1-406">                    <span class="bp">self</span><span class="o">.</span><span class="n">on_dropped_event</span><span class="p">(</span><span class="s2">&quot;self_rate_limits&quot;</span><span class="p">)</span>
-</span><span id="1-407">                <span class="bp">self</span><span class="o">.</span><span class="n">record_lost_event</span><span class="p">(</span><span class="s2">&quot;ratelimit_backoff&quot;</span><span class="p">,</span> <span class="n">item</span><span class="o">=</span><span class="n">item</span><span class="p">)</span>
-</span><span id="1-408">            <span class="k">else</span><span class="p">:</span>
-</span><span id="1-409">                <span class="n">new_items</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">item</span><span class="p">)</span>
-</span><span id="1-410">
-</span><span id="1-411">        <span class="c1"># Since we&#39;re modifying the envelope here make a copy so that others</span>
-</span><span id="1-412">        <span class="c1"># that hold references do not see their envelope modified.</span>
-</span><span id="1-413">        <span class="n">envelope</span> <span class="o">=</span> <span class="n">Envelope</span><span class="p">(</span><span class="n">headers</span><span class="o">=</span><span class="n">envelope</span><span class="o">.</span><span class="n">headers</span><span class="p">,</span> <span class="n">items</span><span class="o">=</span><span class="n">new_items</span><span class="p">)</span>
-</span><span id="1-414">
-</span><span id="1-415">        <span class="k">if</span> <span class="ow">not</span> <span class="n">envelope</span><span class="o">.</span><span class="n">items</span><span class="p">:</span>
-</span><span id="1-416">            <span class="k">return</span> <span class="kc">None</span>
-</span><span id="1-417">
-</span><span id="1-418">        <span class="c1"># since we&#39;re already in the business of sending out an envelope here</span>
-</span><span id="1-419">        <span class="c1"># check if we have one pending for the stats session envelopes so we</span>
-</span><span id="1-420">        <span class="c1"># can attach it to this enveloped scheduled for sending.  This will</span>
-</span><span id="1-421">        <span class="c1"># currently typically attach the client report to the most recent</span>
-</span><span id="1-422">        <span class="c1"># session update.</span>
-</span><span id="1-423">        <span class="n">client_report_item</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_fetch_pending_client_report</span><span class="p">(</span><span class="n">interval</span><span class="o">=</span><span class="mi">30</span><span class="p">)</span>
-</span><span id="1-424">        <span class="k">if</span> <span class="n">client_report_item</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-425">            <span class="n">envelope</span><span class="o">.</span><span class="n">items</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">client_report_item</span><span class="p">)</span>
-</span><span id="1-426">
-</span><span id="1-427">        <span class="n">body</span> <span class="o">=</span> <span class="n">io</span><span class="o">.</span><span class="n">BytesIO</span><span class="p">()</span>
-</span><span id="1-428">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_compresslevel</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
-</span><span id="1-429">            <span class="n">envelope</span><span class="o">.</span><span class="n">serialize_into</span><span class="p">(</span><span class="n">body</span><span class="p">)</span>
-</span><span id="1-430">        <span class="k">else</span><span class="p">:</span>
-</span><span id="1-431">            <span class="k">with</span> <span class="n">gzip</span><span class="o">.</span><span class="n">GzipFile</span><span class="p">(</span>
-</span><span id="1-432">                <span class="n">fileobj</span><span class="o">=</span><span class="n">body</span><span class="p">,</span> <span class="n">mode</span><span class="o">=</span><span class="s2">&quot;w&quot;</span><span class="p">,</span> <span class="n">compresslevel</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">_compresslevel</span>
-</span><span id="1-433">            <span class="p">)</span> <span class="k">as</span> <span class="n">f</span><span class="p">:</span>
-</span><span id="1-434">                <span class="n">envelope</span><span class="o">.</span><span class="n">serialize_into</span><span class="p">(</span><span class="n">f</span><span class="p">)</span>
+</span><span id="1-396">        <span class="c1"># since we&#39;re already in the business of sending out an envelope here</span>
+</span><span id="1-397">        <span class="c1"># check if we have one pending for the stats session envelopes so we</span>
+</span><span id="1-398">        <span class="c1"># can attach it to this enveloped scheduled for sending.  This will</span>
+</span><span id="1-399">        <span class="c1"># currently typically attach the client report to the most recent</span>
+</span><span id="1-400">        <span class="c1"># session update.</span>
+</span><span id="1-401">        <span class="n">client_report_item</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_fetch_pending_client_report</span><span class="p">(</span><span class="n">interval</span><span class="o">=</span><span class="mi">30</span><span class="p">)</span>
+</span><span id="1-402">        <span class="k">if</span> <span class="n">client_report_item</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-403">            <span class="n">envelope</span><span class="o">.</span><span class="n">items</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">client_report_item</span><span class="p">)</span>
+</span><span id="1-404">
+</span><span id="1-405">        <span class="n">body</span> <span class="o">=</span> <span class="n">io</span><span class="o">.</span><span class="n">BytesIO</span><span class="p">()</span>
+</span><span id="1-406">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_compresslevel</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
+</span><span id="1-407">            <span class="n">envelope</span><span class="o">.</span><span class="n">serialize_into</span><span class="p">(</span><span class="n">body</span><span class="p">)</span>
+</span><span id="1-408">        <span class="k">else</span><span class="p">:</span>
+</span><span id="1-409">            <span class="k">with</span> <span class="n">gzip</span><span class="o">.</span><span class="n">GzipFile</span><span class="p">(</span>
+</span><span id="1-410">                <span class="n">fileobj</span><span class="o">=</span><span class="n">body</span><span class="p">,</span> <span class="n">mode</span><span class="o">=</span><span class="s2">&quot;w&quot;</span><span class="p">,</span> <span class="n">compresslevel</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">_compresslevel</span>
+</span><span id="1-411">            <span class="p">)</span> <span class="k">as</span> <span class="n">f</span><span class="p">:</span>
+</span><span id="1-412">                <span class="n">envelope</span><span class="o">.</span><span class="n">serialize_into</span><span class="p">(</span><span class="n">f</span><span class="p">)</span>
+</span><span id="1-413">
+</span><span id="1-414">        <span class="k">assert</span> <span class="bp">self</span><span class="o">.</span><span class="n">parsed_dsn</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span>
+</span><span id="1-415">        <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span>
+</span><span id="1-416">            <span class="s2">&quot;Sending envelope [</span><span class="si">%s</span><span class="s2">] project:</span><span class="si">%s</span><span class="s2"> host:</span><span class="si">%s</span><span class="s2">&quot;</span><span class="p">,</span>
+</span><span id="1-417">            <span class="n">envelope</span><span class="o">.</span><span class="n">description</span><span class="p">,</span>
+</span><span id="1-418">            <span class="bp">self</span><span class="o">.</span><span class="n">parsed_dsn</span><span class="o">.</span><span class="n">project_id</span><span class="p">,</span>
+</span><span id="1-419">            <span class="bp">self</span><span class="o">.</span><span class="n">parsed_dsn</span><span class="o">.</span><span class="n">host</span><span class="p">,</span>
+</span><span id="1-420">        <span class="p">)</span>
+</span><span id="1-421">
+</span><span id="1-422">        <span class="n">headers</span> <span class="o">=</span> <span class="p">{</span>
+</span><span id="1-423">            <span class="s2">&quot;Content-Type&quot;</span><span class="p">:</span> <span class="s2">&quot;application/x-sentry-envelope&quot;</span><span class="p">,</span>
+</span><span id="1-424">        <span class="p">}</span>
+</span><span id="1-425">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_compresslevel</span> <span class="o">&gt;</span> <span class="mi">0</span><span class="p">:</span>
+</span><span id="1-426">            <span class="n">headers</span><span class="p">[</span><span class="s2">&quot;Content-Encoding&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="s2">&quot;gzip&quot;</span>
+</span><span id="1-427">
+</span><span id="1-428">        <span class="bp">self</span><span class="o">.</span><span class="n">_send_request</span><span class="p">(</span>
+</span><span id="1-429">            <span class="n">body</span><span class="o">.</span><span class="n">getvalue</span><span class="p">(),</span>
+</span><span id="1-430">            <span class="n">headers</span><span class="o">=</span><span class="n">headers</span><span class="p">,</span>
+</span><span id="1-431">            <span class="n">endpoint_type</span><span class="o">=</span><span class="n">EndpointType</span><span class="o">.</span><span class="n">ENVELOPE</span><span class="p">,</span>
+</span><span id="1-432">            <span class="n">envelope</span><span class="o">=</span><span class="n">envelope</span><span class="p">,</span>
+</span><span id="1-433">        <span class="p">)</span>
+</span><span id="1-434">        <span class="k">return</span> <span class="kc">None</span>
 </span><span id="1-435">
-</span><span id="1-436">        <span class="k">assert</span> <span class="bp">self</span><span class="o">.</span><span class="n">parsed_dsn</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span>
-</span><span id="1-437">        <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span>
-</span><span id="1-438">            <span class="s2">&quot;Sending envelope [</span><span class="si">%s</span><span class="s2">] project:</span><span class="si">%s</span><span class="s2"> host:</span><span class="si">%s</span><span class="s2">&quot;</span><span class="p">,</span>
-</span><span id="1-439">            <span class="n">envelope</span><span class="o">.</span><span class="n">description</span><span class="p">,</span>
-</span><span id="1-440">            <span class="bp">self</span><span class="o">.</span><span class="n">parsed_dsn</span><span class="o">.</span><span class="n">project_id</span><span class="p">,</span>
-</span><span id="1-441">            <span class="bp">self</span><span class="o">.</span><span class="n">parsed_dsn</span><span class="o">.</span><span class="n">host</span><span class="p">,</span>
-</span><span id="1-442">        <span class="p">)</span>
+</span><span id="1-436">    <span class="k">def</span> <span class="nf">_get_pool_options</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">ca_certs</span><span class="p">):</span>
+</span><span id="1-437">        <span class="c1"># type: (Optional[Any]) -&gt; Dict[str, Any]</span>
+</span><span id="1-438">        <span class="n">options</span> <span class="o">=</span> <span class="p">{</span>
+</span><span id="1-439">            <span class="s2">&quot;num_pools&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">_num_pools</span><span class="p">,</span>
+</span><span id="1-440">            <span class="s2">&quot;cert_reqs&quot;</span><span class="p">:</span> <span class="s2">&quot;CERT_REQUIRED&quot;</span><span class="p">,</span>
+</span><span id="1-441">            <span class="s2">&quot;ca_certs&quot;</span><span class="p">:</span> <span class="n">ca_certs</span> <span class="ow">or</span> <span class="n">certifi</span><span class="o">.</span><span class="n">where</span><span class="p">(),</span>
+</span><span id="1-442">        <span class="p">}</span>
 </span><span id="1-443">
-</span><span id="1-444">        <span class="n">headers</span> <span class="o">=</span> <span class="p">{</span>
-</span><span id="1-445">            <span class="s2">&quot;Content-Type&quot;</span><span class="p">:</span> <span class="s2">&quot;application/x-sentry-envelope&quot;</span><span class="p">,</span>
-</span><span id="1-446">        <span class="p">}</span>
-</span><span id="1-447">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">_compresslevel</span> <span class="o">&gt;</span> <span class="mi">0</span><span class="p">:</span>
-</span><span id="1-448">            <span class="n">headers</span><span class="p">[</span><span class="s2">&quot;Content-Encoding&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="s2">&quot;gzip&quot;</span>
-</span><span id="1-449">
-</span><span id="1-450">        <span class="bp">self</span><span class="o">.</span><span class="n">_send_request</span><span class="p">(</span>
-</span><span id="1-451">            <span class="n">body</span><span class="o">.</span><span class="n">getvalue</span><span class="p">(),</span>
-</span><span id="1-452">            <span class="n">headers</span><span class="o">=</span><span class="n">headers</span><span class="p">,</span>
-</span><span id="1-453">            <span class="n">endpoint_type</span><span class="o">=</span><span class="s2">&quot;envelope&quot;</span><span class="p">,</span>
-</span><span id="1-454">            <span class="n">envelope</span><span class="o">=</span><span class="n">envelope</span><span class="p">,</span>
-</span><span id="1-455">        <span class="p">)</span>
-</span><span id="1-456">        <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-444">        <span class="n">socket_options</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[List[Tuple[int, int, int | bytes]]]</span>
+</span><span id="1-445">
+</span><span id="1-446">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;socket_options&quot;</span><span class="p">]</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-447">            <span class="n">socket_options</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;socket_options&quot;</span><span class="p">]</span>
+</span><span id="1-448">
+</span><span id="1-449">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;keep_alive&quot;</span><span class="p">]:</span>
+</span><span id="1-450">            <span class="k">if</span> <span class="n">socket_options</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-451">                <span class="n">socket_options</span> <span class="o">=</span> <span class="p">[]</span>
+</span><span id="1-452">
+</span><span id="1-453">            <span class="n">used_options</span> <span class="o">=</span> <span class="p">{(</span><span class="n">o</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">o</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span> <span class="k">for</span> <span class="n">o</span> <span class="ow">in</span> <span class="n">socket_options</span><span class="p">}</span>
+</span><span id="1-454">            <span class="k">for</span> <span class="n">default_option</span> <span class="ow">in</span> <span class="n">KEEP_ALIVE_SOCKET_OPTIONS</span><span class="p">:</span>
+</span><span id="1-455">                <span class="k">if</span> <span class="p">(</span><span class="n">default_option</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">default_option</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">used_options</span><span class="p">:</span>
+</span><span id="1-456">                    <span class="n">socket_options</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">default_option</span><span class="p">)</span>
 </span><span id="1-457">
-</span><span id="1-458">    <span class="k">def</span> <span class="nf">_get_pool_options</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">ca_certs</span><span class="p">):</span>
-</span><span id="1-459">        <span class="c1"># type: (Optional[Any]) -&gt; Dict[str, Any]</span>
-</span><span id="1-460">        <span class="n">options</span> <span class="o">=</span> <span class="p">{</span>
-</span><span id="1-461">            <span class="s2">&quot;num_pools&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">_num_pools</span><span class="p">,</span>
-</span><span id="1-462">            <span class="s2">&quot;cert_reqs&quot;</span><span class="p">:</span> <span class="s2">&quot;CERT_REQUIRED&quot;</span><span class="p">,</span>
-</span><span id="1-463">            <span class="s2">&quot;ca_certs&quot;</span><span class="p">:</span> <span class="n">ca_certs</span> <span class="ow">or</span> <span class="n">certifi</span><span class="o">.</span><span class="n">where</span><span class="p">(),</span>
-</span><span id="1-464">        <span class="p">}</span>
-</span><span id="1-465">
-</span><span id="1-466">        <span class="n">socket_options</span> <span class="o">=</span> <span class="kc">None</span>  <span class="c1"># type: Optional[List[Tuple[int, int, int | bytes]]]</span>
-</span><span id="1-467">
-</span><span id="1-468">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;socket_options&quot;</span><span class="p">]</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-469">            <span class="n">socket_options</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;socket_options&quot;</span><span class="p">]</span>
-</span><span id="1-470">
-</span><span id="1-471">        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">options</span><span class="p">[</span><span class="s2">&quot;keep_alive&quot;</span><span class="p">]:</span>
-</span><span id="1-472">            <span class="k">if</span> <span class="n">socket_options</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-473">                <span class="n">socket_options</span> <span class="o">=</span> <span class="p">[]</span>
-</span><span id="1-474">
-</span><span id="1-475">            <span class="n">used_options</span> <span class="o">=</span> <span class="p">{(</span><span class="n">o</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">o</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span> <span class="k">for</span> <span class="n">o</span> <span class="ow">in</span> <span class="n">socket_options</span><span class="p">}</span>
-</span><span id="1-476">            <span class="k">for</span> <span class="n">default_option</span> <span class="ow">in</span> <span class="n">KEEP_ALIVE_SOCKET_OPTIONS</span><span class="p">:</span>
-</span><span id="1-477">                <span class="k">if</span> <span class="p">(</span><span class="n">default_option</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="n">default_option</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">used_options</span><span class="p">:</span>
-</span><span id="1-478">                    <span class="n">socket_options</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">default_option</span><span class="p">)</span>
-</span><span id="1-479">
-</span><span id="1-480">        <span class="k">if</span> <span class="n">socket_options</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-481">            <span class="n">options</span><span class="p">[</span><span class="s2">&quot;socket_options&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">socket_options</span>
-</span><span id="1-482">
-</span><span id="1-483">        <span class="k">return</span> <span class="n">options</span>
-</span><span id="1-484">
-</span><span id="1-485">    <span class="k">def</span> <span class="nf">_in_no_proxy</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">parsed_dsn</span><span class="p">):</span>
-</span><span id="1-486">        <span class="c1"># type: (Dsn) -&gt; bool</span>
-</span><span id="1-487">        <span class="n">no_proxy</span> <span class="o">=</span> <span class="n">getproxies</span><span class="p">()</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;no&quot;</span><span class="p">)</span>
-</span><span id="1-488">        <span class="k">if</span> <span class="ow">not</span> <span class="n">no_proxy</span><span class="p">:</span>
-</span><span id="1-489">            <span class="k">return</span> <span class="kc">False</span>
-</span><span id="1-490">        <span class="k">for</span> <span class="n">host</span> <span class="ow">in</span> <span class="n">no_proxy</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s2">&quot;,&quot;</span><span class="p">):</span>
-</span><span id="1-491">            <span class="n">host</span> <span class="o">=</span> <span class="n">host</span><span class="o">.</span><span class="n">strip</span><span class="p">()</span>
-</span><span id="1-492">            <span class="k">if</span> <span class="n">parsed_dsn</span><span class="o">.</span><span class="n">host</span><span class="o">.</span><span class="n">endswith</span><span class="p">(</span><span class="n">host</span><span class="p">)</span> <span class="ow">or</span> <span class="n">parsed_dsn</span><span class="o">.</span><span class="n">netloc</span><span class="o">.</span><span class="n">endswith</span><span class="p">(</span><span class="n">host</span><span class="p">):</span>
-</span><span id="1-493">                <span class="k">return</span> <span class="kc">True</span>
-</span><span id="1-494">        <span class="k">return</span> <span class="kc">False</span>
+</span><span id="1-458">        <span class="k">if</span> <span class="n">socket_options</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-459">            <span class="n">options</span><span class="p">[</span><span class="s2">&quot;socket_options&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">socket_options</span>
+</span><span id="1-460">
+</span><span id="1-461">        <span class="k">return</span> <span class="n">options</span>
+</span><span id="1-462">
+</span><span id="1-463">    <span class="k">def</span> <span class="nf">_in_no_proxy</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">parsed_dsn</span><span class="p">):</span>
+</span><span id="1-464">        <span class="c1"># type: (Dsn) -&gt; bool</span>
+</span><span id="1-465">        <span class="n">no_proxy</span> <span class="o">=</span> <span class="n">getproxies</span><span class="p">()</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;no&quot;</span><span class="p">)</span>
+</span><span id="1-466">        <span class="k">if</span> <span class="ow">not</span> <span class="n">no_proxy</span><span class="p">:</span>
+</span><span id="1-467">            <span class="k">return</span> <span class="kc">False</span>
+</span><span id="1-468">        <span class="k">for</span> <span class="n">host</span> <span class="ow">in</span> <span class="n">no_proxy</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s2">&quot;,&quot;</span><span class="p">):</span>
+</span><span id="1-469">            <span class="n">host</span> <span class="o">=</span> <span class="n">host</span><span class="o">.</span><span class="n">strip</span><span class="p">()</span>
+</span><span id="1-470">            <span class="k">if</span> <span class="n">parsed_dsn</span><span class="o">.</span><span class="n">host</span><span class="o">.</span><span class="n">endswith</span><span class="p">(</span><span class="n">host</span><span class="p">)</span> <span class="ow">or</span> <span class="n">parsed_dsn</span><span class="o">.</span><span class="n">netloc</span><span class="o">.</span><span class="n">endswith</span><span class="p">(</span><span class="n">host</span><span class="p">):</span>
+</span><span id="1-471">                <span class="k">return</span> <span class="kc">True</span>
+</span><span id="1-472">        <span class="k">return</span> <span class="kc">False</span>
+</span><span id="1-473">
+</span><span id="1-474">    <span class="k">def</span> <span class="nf">_make_pool</span><span class="p">(</span>
+</span><span id="1-475">        <span class="bp">self</span><span class="p">,</span>
+</span><span id="1-476">        <span class="n">parsed_dsn</span><span class="p">,</span>  <span class="c1"># type: Dsn</span>
+</span><span id="1-477">        <span class="n">http_proxy</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
+</span><span id="1-478">        <span class="n">https_proxy</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
+</span><span id="1-479">        <span class="n">ca_certs</span><span class="p">,</span>  <span class="c1"># type: Optional[Any]</span>
+</span><span id="1-480">        <span class="n">proxy_headers</span><span class="p">,</span>  <span class="c1"># type: Optional[Dict[str, str]]</span>
+</span><span id="1-481">    <span class="p">):</span>
+</span><span id="1-482">        <span class="c1"># type: (...) -&gt; Union[PoolManager, ProxyManager]</span>
+</span><span id="1-483">        <span class="n">proxy</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="1-484">        <span class="n">no_proxy</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_in_no_proxy</span><span class="p">(</span><span class="n">parsed_dsn</span><span class="p">)</span>
+</span><span id="1-485">
+</span><span id="1-486">        <span class="c1"># try HTTPS first</span>
+</span><span id="1-487">        <span class="k">if</span> <span class="n">parsed_dsn</span><span class="o">.</span><span class="n">scheme</span> <span class="o">==</span> <span class="s2">&quot;https&quot;</span> <span class="ow">and</span> <span class="p">(</span><span class="n">https_proxy</span> <span class="o">!=</span> <span class="s2">&quot;&quot;</span><span class="p">):</span>
+</span><span id="1-488">            <span class="n">proxy</span> <span class="o">=</span> <span class="n">https_proxy</span> <span class="ow">or</span> <span class="p">(</span><span class="ow">not</span> <span class="n">no_proxy</span> <span class="ow">and</span> <span class="n">getproxies</span><span class="p">()</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;https&quot;</span><span class="p">))</span>
+</span><span id="1-489">
+</span><span id="1-490">        <span class="c1"># maybe fallback to HTTP proxy</span>
+</span><span id="1-491">        <span class="k">if</span> <span class="ow">not</span> <span class="n">proxy</span> <span class="ow">and</span> <span class="p">(</span><span class="n">http_proxy</span> <span class="o">!=</span> <span class="s2">&quot;&quot;</span><span class="p">):</span>
+</span><span id="1-492">            <span class="n">proxy</span> <span class="o">=</span> <span class="n">http_proxy</span> <span class="ow">or</span> <span class="p">(</span><span class="ow">not</span> <span class="n">no_proxy</span> <span class="ow">and</span> <span class="n">getproxies</span><span class="p">()</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;http&quot;</span><span class="p">))</span>
+</span><span id="1-493">
+</span><span id="1-494">        <span class="n">opts</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_pool_options</span><span class="p">(</span><span class="n">ca_certs</span><span class="p">)</span>
 </span><span id="1-495">
-</span><span id="1-496">    <span class="k">def</span> <span class="nf">_make_pool</span><span class="p">(</span>
-</span><span id="1-497">        <span class="bp">self</span><span class="p">,</span>
-</span><span id="1-498">        <span class="n">parsed_dsn</span><span class="p">,</span>  <span class="c1"># type: Dsn</span>
-</span><span id="1-499">        <span class="n">http_proxy</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
-</span><span id="1-500">        <span class="n">https_proxy</span><span class="p">,</span>  <span class="c1"># type: Optional[str]</span>
-</span><span id="1-501">        <span class="n">ca_certs</span><span class="p">,</span>  <span class="c1"># type: Optional[Any]</span>
-</span><span id="1-502">        <span class="n">proxy_headers</span><span class="p">,</span>  <span class="c1"># type: Optional[Dict[str, str]]</span>
-</span><span id="1-503">    <span class="p">):</span>
-</span><span id="1-504">        <span class="c1"># type: (...) -&gt; Union[PoolManager, ProxyManager]</span>
-</span><span id="1-505">        <span class="n">proxy</span> <span class="o">=</span> <span class="kc">None</span>
-</span><span id="1-506">        <span class="n">no_proxy</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_in_no_proxy</span><span class="p">(</span><span class="n">parsed_dsn</span><span class="p">)</span>
-</span><span id="1-507">
-</span><span id="1-508">        <span class="c1"># try HTTPS first</span>
-</span><span id="1-509">        <span class="k">if</span> <span class="n">parsed_dsn</span><span class="o">.</span><span class="n">scheme</span> <span class="o">==</span> <span class="s2">&quot;https&quot;</span> <span class="ow">and</span> <span class="p">(</span><span class="n">https_proxy</span> <span class="o">!=</span> <span class="s2">&quot;&quot;</span><span class="p">):</span>
-</span><span id="1-510">            <span class="n">proxy</span> <span class="o">=</span> <span class="n">https_proxy</span> <span class="ow">or</span> <span class="p">(</span><span class="ow">not</span> <span class="n">no_proxy</span> <span class="ow">and</span> <span class="n">getproxies</span><span class="p">()</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;https&quot;</span><span class="p">))</span>
+</span><span id="1-496">        <span class="k">if</span> <span class="n">proxy</span><span class="p">:</span>
+</span><span id="1-497">            <span class="k">if</span> <span class="n">proxy_headers</span><span class="p">:</span>
+</span><span id="1-498">                <span class="n">opts</span><span class="p">[</span><span class="s2">&quot;proxy_headers&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">proxy_headers</span>
+</span><span id="1-499">
+</span><span id="1-500">            <span class="k">if</span> <span class="n">proxy</span><span class="o">.</span><span class="n">startswith</span><span class="p">(</span><span class="s2">&quot;socks&quot;</span><span class="p">):</span>
+</span><span id="1-501">                <span class="n">use_socks_proxy</span> <span class="o">=</span> <span class="kc">True</span>
+</span><span id="1-502">                <span class="k">try</span><span class="p">:</span>
+</span><span id="1-503">                    <span class="c1"># Check if PySocks depencency is available</span>
+</span><span id="1-504">                    <span class="kn">from</span> <span class="nn">urllib3.contrib.socks</span> <span class="kn">import</span> <span class="n">SOCKSProxyManager</span>
+</span><span id="1-505">                <span class="k">except</span> <span class="ne">ImportError</span><span class="p">:</span>
+</span><span id="1-506">                    <span class="n">use_socks_proxy</span> <span class="o">=</span> <span class="kc">False</span>
+</span><span id="1-507">                    <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
+</span><span id="1-508">                        <span class="s2">&quot;You have configured a SOCKS proxy (</span><span class="si">%s</span><span class="s2">) but support for SOCKS proxies is not installed. Disabling proxy support. Please add `PySocks` (or `urllib3` with the `[socks]` extra) to your dependencies.&quot;</span><span class="p">,</span>
+</span><span id="1-509">                        <span class="n">proxy</span><span class="p">,</span>
+</span><span id="1-510">                    <span class="p">)</span>
 </span><span id="1-511">
-</span><span id="1-512">        <span class="c1"># maybe fallback to HTTP proxy</span>
-</span><span id="1-513">        <span class="k">if</span> <span class="ow">not</span> <span class="n">proxy</span> <span class="ow">and</span> <span class="p">(</span><span class="n">http_proxy</span> <span class="o">!=</span> <span class="s2">&quot;&quot;</span><span class="p">):</span>
-</span><span id="1-514">            <span class="n">proxy</span> <span class="o">=</span> <span class="n">http_proxy</span> <span class="ow">or</span> <span class="p">(</span><span class="ow">not</span> <span class="n">no_proxy</span> <span class="ow">and</span> <span class="n">getproxies</span><span class="p">()</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s2">&quot;http&quot;</span><span class="p">))</span>
-</span><span id="1-515">
-</span><span id="1-516">        <span class="n">opts</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_pool_options</span><span class="p">(</span><span class="n">ca_certs</span><span class="p">)</span>
-</span><span id="1-517">
-</span><span id="1-518">        <span class="k">if</span> <span class="n">proxy</span><span class="p">:</span>
-</span><span id="1-519">            <span class="k">if</span> <span class="n">proxy_headers</span><span class="p">:</span>
-</span><span id="1-520">                <span class="n">opts</span><span class="p">[</span><span class="s2">&quot;proxy_headers&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">proxy_headers</span>
-</span><span id="1-521">
-</span><span id="1-522">            <span class="k">if</span> <span class="n">proxy</span><span class="o">.</span><span class="n">startswith</span><span class="p">(</span><span class="s2">&quot;socks&quot;</span><span class="p">):</span>
-</span><span id="1-523">                <span class="n">use_socks_proxy</span> <span class="o">=</span> <span class="kc">True</span>
-</span><span id="1-524">                <span class="k">try</span><span class="p">:</span>
-</span><span id="1-525">                    <span class="c1"># Check if PySocks depencency is available</span>
-</span><span id="1-526">                    <span class="kn">from</span> <span class="nn">urllib3.contrib.socks</span> <span class="kn">import</span> <span class="n">SOCKSProxyManager</span>
-</span><span id="1-527">                <span class="k">except</span> <span class="ne">ImportError</span><span class="p">:</span>
-</span><span id="1-528">                    <span class="n">use_socks_proxy</span> <span class="o">=</span> <span class="kc">False</span>
-</span><span id="1-529">                    <span class="n">logger</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
-</span><span id="1-530">                        <span class="s2">&quot;You have configured a SOCKS proxy (</span><span class="si">%s</span><span class="s2">) but support for SOCKS proxies is not installed. Disabling proxy support. Please add `PySocks` (or `urllib3` with the `[socks]` extra) to your dependencies.&quot;</span><span class="p">,</span>
-</span><span id="1-531">                        <span class="n">proxy</span><span class="p">,</span>
-</span><span id="1-532">                    <span class="p">)</span>
-</span><span id="1-533">
-</span><span id="1-534">                <span class="k">if</span> <span class="n">use_socks_proxy</span><span class="p">:</span>
-</span><span id="1-535">                    <span class="k">return</span> <span class="n">SOCKSProxyManager</span><span class="p">(</span><span class="n">proxy</span><span class="p">,</span> <span class="o">**</span><span class="n">opts</span><span class="p">)</span>
-</span><span id="1-536">                <span class="k">else</span><span class="p">:</span>
-</span><span id="1-537">                    <span class="k">return</span> <span class="n">urllib3</span><span class="o">.</span><span class="n">PoolManager</span><span class="p">(</span><span class="o">**</span><span class="n">opts</span><span class="p">)</span>
-</span><span id="1-538">            <span class="k">else</span><span class="p">:</span>
-</span><span id="1-539">                <span class="k">return</span> <span class="n">urllib3</span><span class="o">.</span><span class="n">ProxyManager</span><span class="p">(</span><span class="n">proxy</span><span class="p">,</span> <span class="o">**</span><span class="n">opts</span><span class="p">)</span>
-</span><span id="1-540">        <span class="k">else</span><span class="p">:</span>
-</span><span id="1-541">            <span class="k">return</span> <span class="n">urllib3</span><span class="o">.</span><span class="n">PoolManager</span><span class="p">(</span><span class="o">**</span><span class="n">opts</span><span class="p">)</span>
-</span><span id="1-542">
-<div class="viewcode-block" id="HttpTransport.capture_event">
-<a class="viewcode-back" href="../../apidocs.html#sentry_sdk.HttpTransport.capture_event">[docs]</a>
-</span><span id="1-543">    <span class="k">def</span> <span class="nf">capture_event</span><span class="p">(</span>
-</span><span id="1-544">        <span class="bp">self</span><span class="p">,</span> <span class="n">event</span>  <span class="c1"># type: Event</span>
-</span><span id="1-545">    <span class="p">):</span>
-</span><span id="1-546">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-547">        <span class="n">hub</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">hub_cls</span><span class="o">.</span><span class="n">current</span>
-</span><span id="1-548">
-</span><span id="1-549">        <span class="k">def</span> <span class="nf">send_event_wrapper</span><span class="p">():</span>
-</span><span id="1-550">            <span class="c1"># type: () -&gt; None</span>
-</span><span id="1-551">            <span class="k">with</span> <span class="n">hub</span><span class="p">:</span>
-</span><span id="1-552">                <span class="k">with</span> <span class="n">capture_internal_exceptions</span><span class="p">():</span>
-</span><span id="1-553">                    <span class="bp">self</span><span class="o">.</span><span class="n">_send_event</span><span class="p">(</span><span class="n">event</span><span class="p">)</span>
-</span><span id="1-554">                    <span class="bp">self</span><span class="o">.</span><span class="n">_flush_client_reports</span><span class="p">()</span>
-</span><span id="1-555">
-</span><span id="1-556">        <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_worker</span><span class="o">.</span><span class="n">submit</span><span class="p">(</span><span class="n">send_event_wrapper</span><span class="p">):</span>
-</span><span id="1-557">            <span class="bp">self</span><span class="o">.</span><span class="n">on_dropped_event</span><span class="p">(</span><span class="s2">&quot;full_queue&quot;</span><span class="p">)</span>
-</span><span id="1-558">            <span class="bp">self</span><span class="o">.</span><span class="n">record_lost_event</span><span class="p">(</span><span class="s2">&quot;queue_overflow&quot;</span><span class="p">,</span> <span class="n">data_category</span><span class="o">=</span><span class="s2">&quot;error&quot;</span><span class="p">)</span></div>
-
-</span><span id="1-559">
+</span><span id="1-512">                <span class="k">if</span> <span class="n">use_socks_proxy</span><span class="p">:</span>
+</span><span id="1-513">                    <span class="k">return</span> <span class="n">SOCKSProxyManager</span><span class="p">(</span><span class="n">proxy</span><span class="p">,</span> <span class="o">**</span><span class="n">opts</span><span class="p">)</span>
+</span><span id="1-514">                <span class="k">else</span><span class="p">:</span>
+</span><span id="1-515">                    <span class="k">return</span> <span class="n">urllib3</span><span class="o">.</span><span class="n">PoolManager</span><span class="p">(</span><span class="o">**</span><span class="n">opts</span><span class="p">)</span>
+</span><span id="1-516">            <span class="k">else</span><span class="p">:</span>
+</span><span id="1-517">                <span class="k">return</span> <span class="n">urllib3</span><span class="o">.</span><span class="n">ProxyManager</span><span class="p">(</span><span class="n">proxy</span><span class="p">,</span> <span class="o">**</span><span class="n">opts</span><span class="p">)</span>
+</span><span id="1-518">        <span class="k">else</span><span class="p">:</span>
+</span><span id="1-519">            <span class="k">return</span> <span class="n">urllib3</span><span class="o">.</span><span class="n">PoolManager</span><span class="p">(</span><span class="o">**</span><span class="n">opts</span><span class="p">)</span>
+</span><span id="1-520">
 <div class="viewcode-block" id="HttpTransport.capture_envelope">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.HttpTransport.capture_envelope">[docs]</a>
-</span><span id="1-560">    <span class="k">def</span> <span class="nf">capture_envelope</span><span class="p">(</span>
-</span><span id="1-561">        <span class="bp">self</span><span class="p">,</span> <span class="n">envelope</span>  <span class="c1"># type: Envelope</span>
-</span><span id="1-562">    <span class="p">):</span>
-</span><span id="1-563">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-564">        <span class="n">hub</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">hub_cls</span><span class="o">.</span><span class="n">current</span>
-</span><span id="1-565">
-</span><span id="1-566">        <span class="k">def</span> <span class="nf">send_envelope_wrapper</span><span class="p">():</span>
-</span><span id="1-567">            <span class="c1"># type: () -&gt; None</span>
-</span><span id="1-568">            <span class="k">with</span> <span class="n">hub</span><span class="p">:</span>
-</span><span id="1-569">                <span class="k">with</span> <span class="n">capture_internal_exceptions</span><span class="p">():</span>
-</span><span id="1-570">                    <span class="bp">self</span><span class="o">.</span><span class="n">_send_envelope</span><span class="p">(</span><span class="n">envelope</span><span class="p">)</span>
-</span><span id="1-571">                    <span class="bp">self</span><span class="o">.</span><span class="n">_flush_client_reports</span><span class="p">()</span>
-</span><span id="1-572">
-</span><span id="1-573">        <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_worker</span><span class="o">.</span><span class="n">submit</span><span class="p">(</span><span class="n">send_envelope_wrapper</span><span class="p">):</span>
-</span><span id="1-574">            <span class="bp">self</span><span class="o">.</span><span class="n">on_dropped_event</span><span class="p">(</span><span class="s2">&quot;full_queue&quot;</span><span class="p">)</span>
-</span><span id="1-575">            <span class="k">for</span> <span class="n">item</span> <span class="ow">in</span> <span class="n">envelope</span><span class="o">.</span><span class="n">items</span><span class="p">:</span>
-</span><span id="1-576">                <span class="bp">self</span><span class="o">.</span><span class="n">record_lost_event</span><span class="p">(</span><span class="s2">&quot;queue_overflow&quot;</span><span class="p">,</span> <span class="n">item</span><span class="o">=</span><span class="n">item</span><span class="p">)</span></div>
+</span><span id="1-521">    <span class="k">def</span> <span class="nf">capture_envelope</span><span class="p">(</span>
+</span><span id="1-522">        <span class="bp">self</span><span class="p">,</span> <span class="n">envelope</span>  <span class="c1"># type: Envelope</span>
+</span><span id="1-523">    <span class="p">):</span>
+</span><span id="1-524">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-525">        <span class="n">hub</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">hub_cls</span><span class="o">.</span><span class="n">current</span>
+</span><span id="1-526">
+</span><span id="1-527">        <span class="k">def</span> <span class="nf">send_envelope_wrapper</span><span class="p">():</span>
+</span><span id="1-528">            <span class="c1"># type: () -&gt; None</span>
+</span><span id="1-529">            <span class="k">with</span> <span class="n">hub</span><span class="p">:</span>
+</span><span id="1-530">                <span class="k">with</span> <span class="n">capture_internal_exceptions</span><span class="p">():</span>
+</span><span id="1-531">                    <span class="bp">self</span><span class="o">.</span><span class="n">_send_envelope</span><span class="p">(</span><span class="n">envelope</span><span class="p">)</span>
+</span><span id="1-532">                    <span class="bp">self</span><span class="o">.</span><span class="n">_flush_client_reports</span><span class="p">()</span>
+</span><span id="1-533">
+</span><span id="1-534">        <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">_worker</span><span class="o">.</span><span class="n">submit</span><span class="p">(</span><span class="n">send_envelope_wrapper</span><span class="p">):</span>
+</span><span id="1-535">            <span class="bp">self</span><span class="o">.</span><span class="n">on_dropped_event</span><span class="p">(</span><span class="s2">&quot;full_queue&quot;</span><span class="p">)</span>
+</span><span id="1-536">            <span class="k">for</span> <span class="n">item</span> <span class="ow">in</span> <span class="n">envelope</span><span class="o">.</span><span class="n">items</span><span class="p">:</span>
+</span><span id="1-537">                <span class="bp">self</span><span class="o">.</span><span class="n">record_lost_event</span><span class="p">(</span><span class="s2">&quot;queue_overflow&quot;</span><span class="p">,</span> <span class="n">item</span><span class="o">=</span><span class="n">item</span><span class="p">)</span></div>
 
-</span><span id="1-577">
+</span><span id="1-538">
 <div class="viewcode-block" id="HttpTransport.flush">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.HttpTransport.flush">[docs]</a>
-</span><span id="1-578">    <span class="k">def</span> <span class="nf">flush</span><span class="p">(</span>
-</span><span id="1-579">        <span class="bp">self</span><span class="p">,</span>
-</span><span id="1-580">        <span class="n">timeout</span><span class="p">,</span>  <span class="c1"># type: float</span>
-</span><span id="1-581">        <span class="n">callback</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Any]</span>
-</span><span id="1-582">    <span class="p">):</span>
-</span><span id="1-583">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-584">        <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;Flushing HTTP transport&quot;</span><span class="p">)</span>
-</span><span id="1-585">
-</span><span id="1-586">        <span class="k">if</span> <span class="n">timeout</span> <span class="o">&gt;</span> <span class="mi">0</span><span class="p">:</span>
-</span><span id="1-587">            <span class="bp">self</span><span class="o">.</span><span class="n">_worker</span><span class="o">.</span><span class="n">submit</span><span class="p">(</span><span class="k">lambda</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">_flush_client_reports</span><span class="p">(</span><span class="n">force</span><span class="o">=</span><span class="kc">True</span><span class="p">))</span>
-</span><span id="1-588">            <span class="bp">self</span><span class="o">.</span><span class="n">_worker</span><span class="o">.</span><span class="n">flush</span><span class="p">(</span><span class="n">timeout</span><span class="p">,</span> <span class="n">callback</span><span class="p">)</span></div>
+</span><span id="1-539">    <span class="k">def</span> <span class="nf">flush</span><span class="p">(</span>
+</span><span id="1-540">        <span class="bp">self</span><span class="p">,</span>
+</span><span id="1-541">        <span class="n">timeout</span><span class="p">,</span>  <span class="c1"># type: float</span>
+</span><span id="1-542">        <span class="n">callback</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span>  <span class="c1"># type: Optional[Any]</span>
+</span><span id="1-543">    <span class="p">):</span>
+</span><span id="1-544">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-545">        <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;Flushing HTTP transport&quot;</span><span class="p">)</span>
+</span><span id="1-546">
+</span><span id="1-547">        <span class="k">if</span> <span class="n">timeout</span> <span class="o">&gt;</span> <span class="mi">0</span><span class="p">:</span>
+</span><span id="1-548">            <span class="bp">self</span><span class="o">.</span><span class="n">_worker</span><span class="o">.</span><span class="n">submit</span><span class="p">(</span><span class="k">lambda</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">_flush_client_reports</span><span class="p">(</span><span class="n">force</span><span class="o">=</span><span class="kc">True</span><span class="p">))</span>
+</span><span id="1-549">            <span class="bp">self</span><span class="o">.</span><span class="n">_worker</span><span class="o">.</span><span class="n">flush</span><span class="p">(</span><span class="n">timeout</span><span class="p">,</span> <span class="n">callback</span><span class="p">)</span></div>
 
-</span><span id="1-589">
+</span><span id="1-550">
 <div class="viewcode-block" id="HttpTransport.kill">
 <a class="viewcode-back" href="../../apidocs.html#sentry_sdk.HttpTransport.kill">[docs]</a>
-</span><span id="1-590">    <span class="k">def</span> <span class="nf">kill</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="1-591">        <span class="c1"># type: () -&gt; None</span>
-</span><span id="1-592">        <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;Killing HTTP transport&quot;</span><span class="p">)</span>
-</span><span id="1-593">        <span class="bp">self</span><span class="o">.</span><span class="n">_worker</span><span class="o">.</span><span class="n">kill</span><span class="p">()</span></div>
+</span><span id="1-551">    <span class="k">def</span> <span class="nf">kill</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="1-552">        <span class="c1"># type: () -&gt; None</span>
+</span><span id="1-553">        <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;Killing HTTP transport&quot;</span><span class="p">)</span>
+</span><span id="1-554">        <span class="bp">self</span><span class="o">.</span><span class="n">_worker</span><span class="o">.</span><span class="n">kill</span><span class="p">()</span></div>
 </div>
 
-</span><span id="1-594">
-</span><span id="1-595">
-</span><span id="1-596"><span class="k">class</span> <span class="nc">_FunctionTransport</span><span class="p">(</span><span class="n">Transport</span><span class="p">):</span>
-</span><span id="1-597">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
-</span><span id="1-598">        <span class="bp">self</span><span class="p">,</span> <span class="n">func</span>  <span class="c1"># type: Callable[[Event], None]</span>
-</span><span id="1-599">    <span class="p">):</span>
-</span><span id="1-600">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-601">        <span class="n">Transport</span><span class="o">.</span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
-</span><span id="1-602">        <span class="bp">self</span><span class="o">.</span><span class="n">_func</span> <span class="o">=</span> <span class="n">func</span>
-</span><span id="1-603">
-</span><span id="1-604">    <span class="k">def</span> <span class="nf">capture_event</span><span class="p">(</span>
-</span><span id="1-605">        <span class="bp">self</span><span class="p">,</span> <span class="n">event</span>  <span class="c1"># type: Event</span>
-</span><span id="1-606">    <span class="p">):</span>
-</span><span id="1-607">        <span class="c1"># type: (...) -&gt; None</span>
-</span><span id="1-608">        <span class="bp">self</span><span class="o">.</span><span class="n">_func</span><span class="p">(</span><span class="n">event</span><span class="p">)</span>
-</span><span id="1-609">        <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-555">
+</span><span id="1-556">
+</span><span id="1-557"><span class="k">class</span> <span class="nc">_FunctionTransport</span><span class="p">(</span><span class="n">Transport</span><span class="p">):</span>
+</span><span id="1-558"><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="1-559"><span class="sd">    DEPRECATED: Users wishing to provide a custom transport should subclass</span>
+</span><span id="1-560"><span class="sd">    the Transport class, rather than providing a function.</span>
+</span><span id="1-561"><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="1-562">
+</span><span id="1-563">    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
+</span><span id="1-564">        <span class="bp">self</span><span class="p">,</span> <span class="n">func</span>  <span class="c1"># type: Callable[[Event], None]</span>
+</span><span id="1-565">    <span class="p">):</span>
+</span><span id="1-566">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-567">        <span class="n">Transport</span><span class="o">.</span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span>
+</span><span id="1-568">        <span class="bp">self</span><span class="o">.</span><span class="n">_func</span> <span class="o">=</span> <span class="n">func</span>
+</span><span id="1-569">
+</span><span id="1-570">    <span class="k">def</span> <span class="nf">capture_event</span><span class="p">(</span>
+</span><span id="1-571">        <span class="bp">self</span><span class="p">,</span> <span class="n">event</span>  <span class="c1"># type: Event</span>
+</span><span id="1-572">    <span class="p">):</span>
+</span><span id="1-573">        <span class="c1"># type: (...) -&gt; None</span>
+</span><span id="1-574">        <span class="bp">self</span><span class="o">.</span><span class="n">_func</span><span class="p">(</span><span class="n">event</span><span class="p">)</span>
+</span><span id="1-575">        <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-576">
+</span><span id="1-577">    <span class="k">def</span> <span class="nf">capture_envelope</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">envelope</span><span class="p">:</span> <span class="n">Envelope</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-578">        <span class="c1"># Since function transports expect to be called with an event, we need</span>
+</span><span id="1-579">        <span class="c1"># to iterate over the envelope and call the function for each event, via</span>
+</span><span id="1-580">        <span class="c1"># the deprecated capture_event method.</span>
+</span><span id="1-581">        <span class="n">event</span> <span class="o">=</span> <span class="n">envelope</span><span class="o">.</span><span class="n">get_event</span><span class="p">()</span>
+</span><span id="1-582">        <span class="k">if</span> <span class="n">event</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="1-583">            <span class="bp">self</span><span class="o">.</span><span class="n">capture_event</span><span class="p">(</span><span class="n">event</span><span class="p">)</span>
+</span><span id="1-584">
+</span><span id="1-585">
+</span><span id="1-586"><span class="k">def</span> <span class="nf">make_transport</span><span class="p">(</span><span class="n">options</span><span class="p">):</span>
+</span><span id="1-587">    <span class="c1"># type: (Dict[str, Any]) -&gt; Optional[Transport]</span>
+</span><span id="1-588">    <span class="n">ref_transport</span> <span class="o">=</span> <span class="n">options</span><span class="p">[</span><span class="s2">&quot;transport&quot;</span><span class="p">]</span>
+</span><span id="1-589">
+</span><span id="1-590">    <span class="c1"># By default, we use the http transport class</span>
+</span><span id="1-591">    <span class="n">transport_cls</span> <span class="o">=</span> <span class="n">HttpTransport</span>  <span class="c1"># type: Type[Transport]</span>
+</span><span id="1-592">
+</span><span id="1-593">    <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">ref_transport</span><span class="p">,</span> <span class="n">Transport</span><span class="p">):</span>
+</span><span id="1-594">        <span class="k">return</span> <span class="n">ref_transport</span>
+</span><span id="1-595">    <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">ref_transport</span><span class="p">,</span> <span class="nb">type</span><span class="p">)</span> <span class="ow">and</span> <span class="nb">issubclass</span><span class="p">(</span><span class="n">ref_transport</span><span class="p">,</span> <span class="n">Transport</span><span class="p">):</span>
+</span><span id="1-596">        <span class="n">transport_cls</span> <span class="o">=</span> <span class="n">ref_transport</span>
+</span><span id="1-597">    <span class="k">elif</span> <span class="nb">callable</span><span class="p">(</span><span class="n">ref_transport</span><span class="p">):</span>
+</span><span id="1-598">        <span class="n">warnings</span><span class="o">.</span><span class="n">warn</span><span class="p">(</span>
+</span><span id="1-599">            <span class="s2">&quot;Function transports are deprecated and will be removed in a future release.&quot;</span>
+</span><span id="1-600">            <span class="s2">&quot;Please provide a Transport instance or subclass, instead.&quot;</span><span class="p">,</span>
+</span><span id="1-601">            <span class="ne">DeprecationWarning</span><span class="p">,</span>
+</span><span id="1-602">            <span class="n">stacklevel</span><span class="o">=</span><span class="mi">2</span><span class="p">,</span>
+</span><span id="1-603">        <span class="p">)</span>
+</span><span id="1-604">        <span class="k">return</span> <span class="n">_FunctionTransport</span><span class="p">(</span><span class="n">ref_transport</span><span class="p">)</span>
+</span><span id="1-605">
+</span><span id="1-606">    <span class="c1"># if a transport class is given only instantiate it if the dsn is not</span>
+</span><span id="1-607">    <span class="c1"># empty or None</span>
+</span><span id="1-608">    <span class="k">if</span> <span class="n">options</span><span class="p">[</span><span class="s2">&quot;dsn&quot;</span><span class="p">]:</span>
+</span><span id="1-609">        <span class="k">return</span> <span class="n">transport_cls</span><span class="p">(</span><span class="n">options</span><span class="p">)</span>
 </span><span id="1-610">
-</span><span id="1-611">
-</span><span id="1-612"><span class="k">def</span> <span class="nf">make_transport</span><span class="p">(</span><span class="n">options</span><span class="p">):</span>
-</span><span id="1-613">    <span class="c1"># type: (Dict[str, Any]) -&gt; Optional[Transport]</span>
-</span><span id="1-614">    <span class="n">ref_transport</span> <span class="o">=</span> <span class="n">options</span><span class="p">[</span><span class="s2">&quot;transport&quot;</span><span class="p">]</span>
-</span><span id="1-615">
-</span><span id="1-616">    <span class="c1"># If no transport is given, we use the http transport class</span>
-</span><span id="1-617">    <span class="k">if</span> <span class="n">ref_transport</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="1-618">        <span class="n">transport_cls</span> <span class="o">=</span> <span class="n">HttpTransport</span>  <span class="c1"># type: Type[Transport]</span>
-</span><span id="1-619">    <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">ref_transport</span><span class="p">,</span> <span class="n">Transport</span><span class="p">):</span>
-</span><span id="1-620">        <span class="k">return</span> <span class="n">ref_transport</span>
-</span><span id="1-621">    <span class="k">elif</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">ref_transport</span><span class="p">,</span> <span class="nb">type</span><span class="p">)</span> <span class="ow">and</span> <span class="nb">issubclass</span><span class="p">(</span><span class="n">ref_transport</span><span class="p">,</span> <span class="n">Transport</span><span class="p">):</span>
-</span><span id="1-622">        <span class="n">transport_cls</span> <span class="o">=</span> <span class="n">ref_transport</span>
-</span><span id="1-623">    <span class="k">elif</span> <span class="nb">callable</span><span class="p">(</span><span class="n">ref_transport</span><span class="p">):</span>
-</span><span id="1-624">        <span class="k">return</span> <span class="n">_FunctionTransport</span><span class="p">(</span><span class="n">ref_transport</span><span class="p">)</span>
-</span><span id="1-625">
-</span><span id="1-626">    <span class="c1"># if a transport class is given only instantiate it if the dsn is not</span>
-</span><span id="1-627">    <span class="c1"># empty or None</span>
-</span><span id="1-628">    <span class="k">if</span> <span class="n">options</span><span class="p">[</span><span class="s2">&quot;dsn&quot;</span><span class="p">]:</span>
-</span><span id="1-629">        <span class="k">return</span> <span class="n">transport_cls</span><span class="p">(</span><span class="n">options</span><span class="p">)</span>
-</span><span id="1-630">
-</span><span id="1-631">    <span class="k">return</span> <span class="kc">None</span>
+</span><span id="1-611">    <span class="k">return</span> <span class="kc">None</span>
 </span></pre></div>
         </article>
         
@@ -831,7 +808,7 @@ <h1>Source code for sentry_sdk.transport</h1><div class="highlight"><pre>
     </div>
   </div>
 </footer></div>
-      <script src="../../_static/documentation_options.js?v=fca6d697"></script>
+      <script src="../../_static/documentation_options.js?v=aa9da443"></script>
       <script src="../../_static/doctools.js?v=888ff710"></script>
       <script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
       <script src="../../_static/shibuya.js?v=999236dc"></script>
diff --git a/_sources/api.rst.txt b/_sources/api.rst.txt
index f504bbb642..034652e05c 100644
--- a/_sources/api.rst.txt
+++ b/_sources/api.rst.txt
@@ -41,13 +41,18 @@ Distributed Tracing
 .. autofunction:: sentry_sdk.api.get_traceparent
 
 
+Client Management
+=================
+
+.. autofunction:: sentry_sdk.api.is_initialized
+.. autofunction:: sentry_sdk.api.get_client
+
+
 Managing Scope (advanced)
 =========================
 
 .. autofunction:: sentry_sdk.api.configure_scope
 .. autofunction:: sentry_sdk.api.push_scope
 
+.. autofunction:: sentry_sdk.api.new_scope
 
-.. Not documented (On purpose. Not sure if anyone should use those)
-.. last_event_id()
-.. flush()
diff --git a/_sources/apidocs.rst.txt b/_sources/apidocs.rst.txt
index 855778484d..27c8ef2f73 100644
--- a/_sources/apidocs.rst.txt
+++ b/_sources/apidocs.rst.txt
@@ -11,6 +11,12 @@ API Docs
 .. autoclass:: sentry_sdk.Client
     :members:
 
+.. autoclass:: sentry_sdk.client.BaseClient
+    :members:
+
+.. autoclass:: sentry_sdk.client.NonRecordingClient
+    :members:
+
 .. autoclass:: sentry_sdk.client._Client
     :members:
 
diff --git a/_static/documentation_options.js b/_static/documentation_options.js
index fad5ce5379..ba58d30333 100644
--- a/_static/documentation_options.js
+++ b/_static/documentation_options.js
@@ -1,5 +1,5 @@
 const DOCUMENTATION_OPTIONS = {
-    VERSION: '1.44.1',
+    VERSION: '2.0.0rc4',
     LANGUAGE: 'en',
     COLLAPSE_INDEX: false,
     BUILDER: 'html',
diff --git a/api.html b/api.html
index df4dcc7958..3b985c63d4 100644
--- a/api.html
+++ b/api.html
@@ -4,7 +4,7 @@
 <head>
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-      <title>Top Level API - sentry-python 1.44.1 documentation</title>
+      <title>Top Level API - sentry-python 2.0.0rc4 documentation</title>
     <link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="next" title="Integrations" href="integrations.html" /><link rel="prev" title="sentry-python - Sentry SDK for Python" href="index.html" />
 
   <script>
@@ -117,9 +117,15 @@ <h3>On this page</h3>
 <li><a class="reference internal" href="#sentry_sdk.api.get_traceparent"><code class="docutils literal notranslate"><span class="pre">get_traceparent()</span></code></a></li>
 </ul>
 </li>
+<li><a class="reference internal" href="#client-management">Client Management</a><ul>
+<li><a class="reference internal" href="#sentry_sdk.api.is_initialized"><code class="docutils literal notranslate"><span class="pre">is_initialized()</span></code></a></li>
+<li><a class="reference internal" href="#sentry_sdk.api.get_client"><code class="docutils literal notranslate"><span class="pre">get_client()</span></code></a></li>
+</ul>
+</li>
 <li><a class="reference internal" href="#managing-scope-advanced">Managing Scope (advanced)</a><ul>
 <li><a class="reference internal" href="#sentry_sdk.api.configure_scope"><code class="docutils literal notranslate"><span class="pre">configure_scope()</span></code></a></li>
 <li><a class="reference internal" href="#sentry_sdk.api.push_scope"><code class="docutils literal notranslate"><span class="pre">push_scope()</span></code></a></li>
+<li><a class="reference internal" href="#sentry_sdk.api.new_scope"><code class="docutils literal notranslate"><span class="pre">new_scope()</span></code></a></li>
 </ul>
 </li>
 </ul>
@@ -172,9 +178,9 @@ <h2>Capturing Data<a class="headerlink" href="#capturing-data" title="Link to th
 <dl class="py function">
 <dt class="sig sig-object py" id="sentry_sdk.api.capture_event">
 <span class="sig-prename descclassname"><span class="pre">sentry_sdk.api.</span></span><span class="sig-name descname"><span class="pre">capture_event</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">event</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">hint</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">scope</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">scope_kwargs</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/api.html#capture_event"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.api.capture_event" title="Link to this definition">¶</a></dt>
-<dd><p>Alias for <a class="reference internal" href="apidocs.html#sentry_sdk.Hub.capture_event" title="sentry_sdk.Hub.capture_event"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Hub.capture_event()</span></code></a></p>
+<dd><p>Alias for <a class="reference internal" href="apidocs.html#sentry_sdk.Scope.capture_event" title="sentry_sdk.Scope.capture_event"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Scope.capture_event()</span></code></a></p>
 <p>Captures an event.</p>
-<p>Alias of <a class="reference internal" href="apidocs.html#sentry_sdk.Scope.capture_event" title="sentry_sdk.Scope.capture_event"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Scope.capture_event()</span></code></a>.</p>
+<p>Merges given scope data and calls <a class="reference internal" href="apidocs.html#sentry_sdk.client._Client.capture_event" title="sentry_sdk.client._Client.capture_event"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.client._Client.capture_event()</span></code></a>.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
 <dd class="field-odd"><ul class="simple">
@@ -190,15 +196,17 @@ <h2>Capturing Data<a class="headerlink" href="#capturing-data" title="Link to th
 <dt class="field-even">Return type<span class="colon">:</span></dt>
 <dd class="field-even"><p><span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a>]</span></p>
 </dd>
+<dt class="field-odd">Returns<span class="colon">:</span></dt>
+<dd class="field-odd"><p>An <cite>event_id</cite> if the SDK decided to send the event (see <a class="reference internal" href="apidocs.html#sentry_sdk.client._Client.capture_event" title="sentry_sdk.client._Client.capture_event"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.client._Client.capture_event()</span></code></a>).</p>
+</dd>
 </dl>
 </dd></dl>
 
 <dl class="py function">
 <dt class="sig sig-object py" id="sentry_sdk.api.capture_exception">
 <span class="sig-prename descclassname"><span class="pre">sentry_sdk.api.</span></span><span class="sig-name descname"><span class="pre">capture_exception</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">error</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">scope</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">scope_kwargs</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/api.html#capture_exception"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.api.capture_exception" title="Link to this definition">¶</a></dt>
-<dd><p>Alias for <a class="reference internal" href="apidocs.html#sentry_sdk.Hub.capture_exception" title="sentry_sdk.Hub.capture_exception"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Hub.capture_exception()</span></code></a></p>
+<dd><p>Alias for <a class="reference internal" href="apidocs.html#sentry_sdk.Scope.capture_exception" title="sentry_sdk.Scope.capture_exception"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Scope.capture_exception()</span></code></a></p>
 <p>Captures an exception.</p>
-<p>Alias of <a class="reference internal" href="apidocs.html#sentry_sdk.Scope.capture_exception" title="sentry_sdk.Scope.capture_exception"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Scope.capture_exception()</span></code></a>.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
 <dd class="field-odd"><ul class="simple">
@@ -214,7 +222,7 @@ <h2>Capturing Data<a class="headerlink" href="#capturing-data" title="Link to th
 <dd class="field-even"><p><span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a>]</span></p>
 </dd>
 <dt class="field-odd">Returns<span class="colon">:</span></dt>
-<dd class="field-odd"><p>An <cite>event_id</cite> if the SDK decided to send the event (see <code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Client.capture_event()</span></code>).</p>
+<dd class="field-odd"><p>An <cite>event_id</cite> if the SDK decided to send the event (see <a class="reference internal" href="apidocs.html#sentry_sdk.client._Client.capture_event" title="sentry_sdk.client._Client.capture_event"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.client._Client.capture_event()</span></code></a>).</p>
 </dd>
 </dl>
 </dd></dl>
@@ -222,13 +230,12 @@ <h2>Capturing Data<a class="headerlink" href="#capturing-data" title="Link to th
 <dl class="py function">
 <dt class="sig sig-object py" id="sentry_sdk.api.capture_message">
 <span class="sig-prename descclassname"><span class="pre">sentry_sdk.api.</span></span><span class="sig-name descname"><span class="pre">capture_message</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">message</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">level</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">scope</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">scope_kwargs</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/api.html#capture_message"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.api.capture_message" title="Link to this definition">¶</a></dt>
-<dd><p>Alias for <a class="reference internal" href="apidocs.html#sentry_sdk.Hub.capture_message" title="sentry_sdk.Hub.capture_message"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Hub.capture_message()</span></code></a></p>
+<dd><p>Alias for <a class="reference internal" href="apidocs.html#sentry_sdk.Scope.capture_message" title="sentry_sdk.Scope.capture_message"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Scope.capture_message()</span></code></a></p>
 <p>Captures a message.</p>
-<p>Alias of <a class="reference internal" href="apidocs.html#sentry_sdk.Scope.capture_message" title="sentry_sdk.Scope.capture_message"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Scope.capture_message()</span></code></a>.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
 <dd class="field-odd"><ul class="simple">
-<li><p><strong>message</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a></span>) – The string to send as the message to Sentry.</p></li>
+<li><p><strong>message</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a></span>) – The string to send as the message.</p></li>
 <li><p><strong>level</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Literal" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Literal</span></code></a>[<code class="docutils literal notranslate"><span class="pre">'fatal'</span></code>, <code class="docutils literal notranslate"><span class="pre">'critical'</span></code>, <code class="docutils literal notranslate"><span class="pre">'error'</span></code>, <code class="docutils literal notranslate"><span class="pre">'warning'</span></code>, <code class="docutils literal notranslate"><span class="pre">'info'</span></code>, <code class="docutils literal notranslate"><span class="pre">'debug'</span></code>]]</span>) – If no level is provided, the default level is <cite>info</cite>.</p></li>
 <li><p><strong>scope</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Any" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Any</span></code></a>]</span>) – An optional <a class="reference internal" href="apidocs.html#sentry_sdk.Scope" title="sentry_sdk.Scope"><code class="xref py py-class docutils literal notranslate"><span class="pre">sentry_sdk.Scope</span></code></a> to apply to events.
 The <cite>scope</cite> and <cite>scope_kwargs</cite> parameters are mutually exclusive.</p></li>
@@ -241,7 +248,7 @@ <h2>Capturing Data<a class="headerlink" href="#capturing-data" title="Link to th
 <dd class="field-even"><p><span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a>]</span></p>
 </dd>
 <dt class="field-odd">Returns<span class="colon">:</span></dt>
-<dd class="field-odd"><p>An <cite>event_id</cite> if the SDK decided to send the event (see <code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Client.capture_event()</span></code>).</p>
+<dd class="field-odd"><p>An <cite>event_id</cite> if the SDK decided to send the event (see <a class="reference internal" href="apidocs.html#sentry_sdk.client._Client.capture_event" title="sentry_sdk.client._Client.capture_event"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.client._Client.capture_event()</span></code></a>).</p>
 </dd>
 </dl>
 </dd></dl>
@@ -252,7 +259,7 @@ <h2>Enriching Events<a class="headerlink" href="#enriching-events" title="Link t
 <dl class="py function">
 <dt class="sig sig-object py" id="sentry_sdk.api.add_breadcrumb">
 <span class="sig-prename descclassname"><span class="pre">sentry_sdk.api.</span></span><span class="sig-name descname"><span class="pre">add_breadcrumb</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">crumb</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">hint</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/api.html#add_breadcrumb"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.api.add_breadcrumb" title="Link to this definition">¶</a></dt>
-<dd><p>Alias for <a class="reference internal" href="apidocs.html#sentry_sdk.Hub.add_breadcrumb" title="sentry_sdk.Hub.add_breadcrumb"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Hub.add_breadcrumb()</span></code></a></p>
+<dd><p>Alias for <a class="reference internal" href="apidocs.html#sentry_sdk.Scope.add_breadcrumb" title="sentry_sdk.Scope.add_breadcrumb"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Scope.add_breadcrumb()</span></code></a></p>
 <p>Adds a breadcrumb.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
@@ -353,7 +360,7 @@ <h2>Performance Monitoring<a class="headerlink" href="#performance-monitoring" t
 
 <dl class="py function">
 <dt class="sig sig-object py" id="sentry_sdk.api.get_current_span">
-<span class="sig-prename descclassname"><span class="pre">sentry_sdk.api.</span></span><span class="sig-name descname"><span class="pre">get_current_span</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">hub</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/api.html#get_current_span"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.api.get_current_span" title="Link to this definition">¶</a></dt>
+<span class="sig-prename descclassname"><span class="pre">sentry_sdk.api.</span></span><span class="sig-name descname"><span class="pre">get_current_span</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">scope</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/api.html#get_current_span"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.api.get_current_span" title="Link to this definition">¶</a></dt>
 <dd><p>Returns the currently active span if there is one running, otherwise <cite>None</cite></p>
 <dl class="field-list simple">
 <dt class="field-odd">Return type<span class="colon">:</span></dt>
@@ -364,8 +371,8 @@ <h2>Performance Monitoring<a class="headerlink" href="#performance-monitoring" t
 
 <dl class="py function">
 <dt class="sig sig-object py" id="sentry_sdk.api.start_span">
-<span class="sig-prename descclassname"><span class="pre">sentry_sdk.api.</span></span><span class="sig-name descname"><span class="pre">start_span</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">span</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/api.html#start_span"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.api.start_span" title="Link to this definition">¶</a></dt>
-<dd><p>Alias for <a class="reference internal" href="apidocs.html#sentry_sdk.Hub.start_span" title="sentry_sdk.Hub.start_span"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Hub.start_span()</span></code></a></p>
+<span class="sig-prename descclassname"><span class="pre">sentry_sdk.api.</span></span><span class="sig-name descname"><span class="pre">start_span</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/api.html#start_span"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.api.start_span" title="Link to this definition">¶</a></dt>
+<dd><p>Alias for <a class="reference internal" href="apidocs.html#sentry_sdk.Scope.start_span" title="sentry_sdk.Scope.start_span"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Scope.start_span()</span></code></a></p>
 <p>Start a span whose parent is the currently active span or transaction, if any.</p>
 <p>The return value is a <a class="reference internal" href="apidocs.html#sentry_sdk.tracing.Span" title="sentry_sdk.tracing.Span"><code class="xref py py-class docutils literal notranslate"><span class="pre">sentry_sdk.tracing.Span</span></code></a> instance,
 typically used as a context manager to start and stop timing in a <cite>with</cite>
@@ -385,8 +392,8 @@ <h2>Performance Monitoring<a class="headerlink" href="#performance-monitoring" t
 
 <dl class="py function">
 <dt class="sig sig-object py" id="sentry_sdk.api.start_transaction">
-<span class="sig-prename descclassname"><span class="pre">sentry_sdk.api.</span></span><span class="sig-name descname"><span class="pre">start_transaction</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">transaction</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/api.html#start_transaction"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.api.start_transaction" title="Link to this definition">¶</a></dt>
-<dd><p>Alias for <a class="reference internal" href="apidocs.html#sentry_sdk.Hub.start_transaction" title="sentry_sdk.Hub.start_transaction"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Hub.start_transaction()</span></code></a></p>
+<span class="sig-prename descclassname"><span class="pre">sentry_sdk.api.</span></span><span class="sig-name descname"><span class="pre">start_transaction</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">transaction</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">instrumenter</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">'sentry'</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">custom_sampling_context</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/api.html#start_transaction"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.api.start_transaction" title="Link to this definition">¶</a></dt>
+<dd><p>Alias for <a class="reference internal" href="apidocs.html#sentry_sdk.Scope.start_transaction" title="sentry_sdk.Scope.start_transaction"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Scope.start_transaction()</span></code></a></p>
 <p>Start and return a transaction.</p>
 <p>Start an existing transaction if given, otherwise create and start a new
 transaction with kwargs.</p>
@@ -401,10 +408,20 @@ <h2>Performance Monitoring<a class="headerlink" href="#performance-monitoring" t
 call the <cite>.finish()</cite> method.</p>
 <p>When the transaction is finished, it will be sent to Sentry with all its
 finished child spans.</p>
-<p>For supported <cite>**kwargs</cite> see <a class="reference internal" href="apidocs.html#sentry_sdk.tracing.Transaction" title="sentry_sdk.tracing.Transaction"><code class="xref py py-class docutils literal notranslate"><span class="pre">sentry_sdk.tracing.Transaction</span></code></a>.</p>
 <dl class="field-list simple">
-<dt class="field-odd">Return type<span class="colon">:</span></dt>
-<dd class="field-odd"><p><span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Union" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Union</span></code></a>[<a class="reference internal" href="apidocs.html#sentry_sdk.tracing.Transaction" title="sentry_sdk.tracing.Transaction"><code class="xref py py-class docutils literal notranslate"><span class="pre">Transaction</span></code></a>, <code class="xref py py-class docutils literal notranslate"><span class="pre">NoOpSpan</span></code>]</span></p>
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>transaction</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference internal" href="apidocs.html#sentry_sdk.tracing.Transaction" title="sentry_sdk.tracing.Transaction"><code class="xref py py-class docutils literal notranslate"><span class="pre">Transaction</span></code></a>]</span>) – The transaction to start. If omitted, we create and
+start a new transaction.</p></li>
+<li><p><strong>instrumenter</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a></span>) – This parameter is meant for internal use only.</p></li>
+<li><p><strong>custom_sampling_context</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Dict" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">Dict</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a>, <a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Any" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Any</span></code></a>]]</span>) – The transaction’s custom sampling context.</p></li>
+<li><p><strong>kwargs</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">Unpack</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">TransactionKwargs</span></code>]</span>) – Optional keyword arguments to be passed to the Transaction
+constructor. See <a class="reference internal" href="apidocs.html#sentry_sdk.tracing.Transaction" title="sentry_sdk.tracing.Transaction"><code class="xref py py-class docutils literal notranslate"><span class="pre">sentry_sdk.tracing.Transaction</span></code></a> for
+available arguments.</p></li>
+</ul>
+</dd>
+<dt class="field-even">Return type<span class="colon">:</span></dt>
+<dd class="field-even"><p><span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Union" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Union</span></code></a>[<a class="reference internal" href="apidocs.html#sentry_sdk.tracing.Transaction" title="sentry_sdk.tracing.Transaction"><code class="xref py py-class docutils literal notranslate"><span class="pre">Transaction</span></code></a>, <code class="xref py py-class docutils literal notranslate"><span class="pre">NoOpSpan</span></code>]</span></p>
 </dd>
 </dl>
 </dd></dl>
@@ -434,14 +451,42 @@ <h2>Distributed Tracing<a class="headerlink" href="#distributed-tracing" title="
 </dl>
 </dd></dl>
 
+</section>
+<section id="client-management">
+<h2>Client Management<a class="headerlink" href="#client-management" title="Link to this heading">¶</a></h2>
+<dl class="py function">
+<dt class="sig sig-object py" id="sentry_sdk.api.is_initialized">
+<span class="sig-prename descclassname"><span class="pre">sentry_sdk.api.</span></span><span class="sig-name descname"><span class="pre">is_initialized</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/api.html#is_initialized"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.api.is_initialized" title="Link to this definition">¶</a></dt>
+<dd><div class="versionadded">
+<p><span class="versionmodified added">New in version 2.0.0.</span></p>
+</div>
+<p>Returns whether Sentry has been initialized or not.</p>
+<p>If a client is available and the client is active
+(meaning it is configured to send data) then
+Sentry is initialized.
+:rtype: <span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">bool</span></code></a></span></p>
+</dd></dl>
+
+<dl class="py function">
+<dt class="sig sig-object py" id="sentry_sdk.api.get_client">
+<span class="sig-prename descclassname"><span class="pre">sentry_sdk.api.</span></span><span class="sig-name descname"><span class="pre">get_client</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/api.html#get_client"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.api.get_client" title="Link to this definition">¶</a></dt>
+<dd><p>Alias for <a class="reference internal" href="apidocs.html#sentry_sdk.Scope.get_client" title="sentry_sdk.Scope.get_client"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Scope.get_client()</span></code></a>
+:rtype: <span class="sphinx_autodoc_typehints-type"><a class="reference internal" href="apidocs.html#sentry_sdk.client.BaseClient" title="sentry_sdk.client.BaseClient"><code class="xref py py-class docutils literal notranslate"><span class="pre">BaseClient</span></code></a></span></p>
+<div class="versionadded">
+<p><span class="versionmodified added">New in version 2.0.0.</span></p>
+</div>
+<p>Returns the currently used <a class="reference internal" href="apidocs.html#sentry_sdk.Client" title="sentry_sdk.Client"><code class="xref py py-class docutils literal notranslate"><span class="pre">sentry_sdk.Client</span></code></a>.
+This checks the current scope, the isolation scope and the global scope for a client.
+If no client is available a <a class="reference internal" href="apidocs.html#sentry_sdk.client.NonRecordingClient" title="sentry_sdk.client.NonRecordingClient"><code class="xref py py-class docutils literal notranslate"><span class="pre">sentry_sdk.client.NonRecordingClient</span></code></a> is returned.</p>
+</dd></dl>
+
 </section>
 <section id="managing-scope-advanced">
 <h2>Managing Scope (advanced)<a class="headerlink" href="#managing-scope-advanced" title="Link to this heading">¶</a></h2>
 <dl class="py function">
 <dt class="sig sig-object py" id="sentry_sdk.api.configure_scope">
 <span class="sig-prename descclassname"><span class="pre">sentry_sdk.api.</span></span><span class="sig-name descname"><span class="pre">configure_scope</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">callback</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/api.html#configure_scope"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.api.configure_scope" title="Link to this definition">¶</a></dt>
-<dd><p>Alias for <a class="reference internal" href="apidocs.html#sentry_sdk.Hub.configure_scope" title="sentry_sdk.Hub.configure_scope"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Hub.configure_scope()</span></code></a></p>
-<p>Reconfigures the scope.</p>
+<dd><p>Reconfigures the scope.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
 <dd class="field-odd"><p><strong>callback</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Callable" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Callable</span></code></a>[[<a class="reference internal" href="apidocs.html#sentry_sdk.Scope" title="sentry_sdk.scope.Scope"><code class="xref py py-class docutils literal notranslate"><span class="pre">Scope</span></code></a>], <a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></a>]]</span>) – If provided, call the callback with the current scope.</p>
@@ -458,8 +503,7 @@ <h2>Managing Scope (advanced)<a class="headerlink" href="#managing-scope-advance
 <dl class="py function">
 <dt class="sig sig-object py" id="sentry_sdk.api.push_scope">
 <span class="sig-prename descclassname"><span class="pre">sentry_sdk.api.</span></span><span class="sig-name descname"><span class="pre">push_scope</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">callback</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/api.html#push_scope"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.api.push_scope" title="Link to this definition">¶</a></dt>
-<dd><p>Alias for <a class="reference internal" href="apidocs.html#sentry_sdk.Hub.push_scope" title="sentry_sdk.Hub.push_scope"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Hub.push_scope()</span></code></a></p>
-<p>Pushes a new layer on the scope stack.</p>
+<dd><p>Pushes a new layer on the scope stack.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
 <dd class="field-odd"><p><strong>callback</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Callable" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Callable</span></code></a>[[<a class="reference internal" href="apidocs.html#sentry_sdk.Scope" title="sentry_sdk.scope.Scope"><code class="xref py py-class docutils literal notranslate"><span class="pre">Scope</span></code></a>], <a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></a>]]</span>) – If provided, this method pushes a scope, calls
@@ -475,6 +519,31 @@ <h2>Managing Scope (advanced)<a class="headerlink" href="#managing-scope-advance
 </dl>
 </dd></dl>
 
+<dl class="py function">
+<dt class="sig sig-object py" id="sentry_sdk.api.new_scope">
+<span class="sig-prename descclassname"><span class="pre">sentry_sdk.api.</span></span><span class="sig-name descname"><span class="pre">new_scope</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/scope.html#new_scope"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.api.new_scope" title="Link to this definition">¶</a></dt>
+<dd><div class="versionadded">
+<p><span class="versionmodified added">New in version 2.0.0.</span></p>
+</div>
+<p>Context manager that forks the current scope and runs the wrapped code in it.
+After the wrapped code is executed, the original scope is restored.</p>
+<p>Example Usage:</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span id="1-1"><span class="kn">import</span> <span class="nn">sentry_sdk</span>
+</span><span id="1-2">
+</span><span id="1-3"><span class="k">with</span> <span class="n">sentry_sdk</span><span class="o">.</span><span class="n">new_scope</span><span class="p">()</span> <span class="k">as</span> <span class="n">scope</span><span class="p">:</span>
+</span><span id="1-4">    <span class="n">scope</span><span class="o">.</span><span class="n">set_tag</span><span class="p">(</span><span class="s2">&quot;color&quot;</span><span class="p">,</span> <span class="s2">&quot;green&quot;</span><span class="p">)</span>
+</span><span id="1-5">    <span class="n">sentry_sdk</span><span class="o">.</span><span class="n">capture_message</span><span class="p">(</span><span class="s2">&quot;hello&quot;</span><span class="p">)</span> <span class="c1"># will include `color` tag.</span>
+</span><span id="1-6">
+</span><span id="1-7"><span class="n">sentry_sdk</span><span class="o">.</span><span class="n">capture_message</span><span class="p">(</span><span class="s2">&quot;hello, again&quot;</span><span class="p">)</span> <span class="c1"># will NOT include `color` tag.</span>
+</span></pre></div>
+</div>
+<dl class="field-list simple">
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p><span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Generator" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">Generator</span></code></a>[<a class="reference internal" href="apidocs.html#sentry_sdk.Scope" title="sentry_sdk.scope.Scope"><code class="xref py py-class docutils literal notranslate"><span class="pre">Scope</span></code></a>, <a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></a>, <a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></a>]</span></p>
+</dd>
+</dl>
+</dd></dl>
+
 </section>
 </section>
 
@@ -527,7 +596,7 @@ <h2>Managing Scope (advanced)<a class="headerlink" href="#managing-scope-advance
     </div>
   </div>
 </footer></div>
-      <script src="_static/documentation_options.js?v=fca6d697"></script>
+      <script src="_static/documentation_options.js?v=aa9da443"></script>
       <script src="_static/doctools.js?v=888ff710"></script>
       <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
       <script src="_static/shibuya.js?v=999236dc"></script>
diff --git a/apidocs.html b/apidocs.html
index bfce4c6162..bdc5029f11 100644
--- a/apidocs.html
+++ b/apidocs.html
@@ -4,7 +4,7 @@
 <head>
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-      <title>API Docs - sentry-python 1.44.1 documentation</title>
+      <title>API Docs - sentry-python 2.0.0rc4 documentation</title>
     <link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="prev" title="Integrations" href="integrations.html" />
 
   <script>
@@ -132,8 +132,14 @@ <h3>On this page</h3>
 <li><a class="reference internal" href="#sentry_sdk.Scope.continue_trace"><code class="docutils literal notranslate"><span class="pre">Scope.continue_trace()</span></code></a></li>
 <li><a class="reference internal" href="#sentry_sdk.Scope.end_session"><code class="docutils literal notranslate"><span class="pre">Scope.end_session()</span></code></a></li>
 <li><a class="reference internal" href="#sentry_sdk.Scope.fingerprint"><code class="docutils literal notranslate"><span class="pre">Scope.fingerprint</span></code></a></li>
+<li><a class="reference internal" href="#sentry_sdk.Scope.fork"><code class="docutils literal notranslate"><span class="pre">Scope.fork()</span></code></a></li>
 <li><a class="reference internal" href="#sentry_sdk.Scope.generate_propagation_context"><code class="docutils literal notranslate"><span class="pre">Scope.generate_propagation_context()</span></code></a></li>
+<li><a class="reference internal" href="#sentry_sdk.Scope.get_baggage"><code class="docutils literal notranslate"><span class="pre">Scope.get_baggage()</span></code></a></li>
+<li><a class="reference internal" href="#sentry_sdk.Scope.get_client"><code class="docutils literal notranslate"><span class="pre">Scope.get_client()</span></code></a></li>
+<li><a class="reference internal" href="#sentry_sdk.Scope.get_current_scope"><code class="docutils literal notranslate"><span class="pre">Scope.get_current_scope()</span></code></a></li>
 <li><a class="reference internal" href="#sentry_sdk.Scope.get_dynamic_sampling_context"><code class="docutils literal notranslate"><span class="pre">Scope.get_dynamic_sampling_context()</span></code></a></li>
+<li><a class="reference internal" href="#sentry_sdk.Scope.get_global_scope"><code class="docutils literal notranslate"><span class="pre">Scope.get_global_scope()</span></code></a></li>
+<li><a class="reference internal" href="#sentry_sdk.Scope.get_isolation_scope"><code class="docutils literal notranslate"><span class="pre">Scope.get_isolation_scope()</span></code></a></li>
 <li><a class="reference internal" href="#sentry_sdk.Scope.get_trace_context"><code class="docutils literal notranslate"><span class="pre">Scope.get_trace_context()</span></code></a></li>
 <li><a class="reference internal" href="#sentry_sdk.Scope.get_traceparent"><code class="docutils literal notranslate"><span class="pre">Scope.get_traceparent()</span></code></a></li>
 <li><a class="reference internal" href="#sentry_sdk.Scope.iter_headers"><code class="docutils literal notranslate"><span class="pre">Scope.iter_headers()</span></code></a></li>
@@ -143,8 +149,13 @@ <h3>On this page</h3>
 <li><a class="reference internal" href="#sentry_sdk.Scope.remove_extra"><code class="docutils literal notranslate"><span class="pre">Scope.remove_extra()</span></code></a></li>
 <li><a class="reference internal" href="#sentry_sdk.Scope.remove_tag"><code class="docutils literal notranslate"><span class="pre">Scope.remove_tag()</span></code></a></li>
 <li><a class="reference internal" href="#sentry_sdk.Scope.resume_auto_session_tracking"><code class="docutils literal notranslate"><span class="pre">Scope.resume_auto_session_tracking()</span></code></a></li>
+<li><a class="reference internal" href="#sentry_sdk.Scope.run_error_processors"><code class="docutils literal notranslate"><span class="pre">Scope.run_error_processors()</span></code></a></li>
+<li><a class="reference internal" href="#sentry_sdk.Scope.run_event_processors"><code class="docutils literal notranslate"><span class="pre">Scope.run_event_processors()</span></code></a></li>
+<li><a class="reference internal" href="#sentry_sdk.Scope.set_client"><code class="docutils literal notranslate"><span class="pre">Scope.set_client()</span></code></a></li>
 <li><a class="reference internal" href="#sentry_sdk.Scope.set_context"><code class="docutils literal notranslate"><span class="pre">Scope.set_context()</span></code></a></li>
+<li><a class="reference internal" href="#sentry_sdk.Scope.set_current_scope"><code class="docutils literal notranslate"><span class="pre">Scope.set_current_scope()</span></code></a></li>
 <li><a class="reference internal" href="#sentry_sdk.Scope.set_extra"><code class="docutils literal notranslate"><span class="pre">Scope.set_extra()</span></code></a></li>
+<li><a class="reference internal" href="#sentry_sdk.Scope.set_isolation_scope"><code class="docutils literal notranslate"><span class="pre">Scope.set_isolation_scope()</span></code></a></li>
 <li><a class="reference internal" href="#sentry_sdk.Scope.set_level"><code class="docutils literal notranslate"><span class="pre">Scope.set_level()</span></code></a></li>
 <li><a class="reference internal" href="#sentry_sdk.Scope.set_new_propagation_context"><code class="docutils literal notranslate"><span class="pre">Scope.set_new_propagation_context()</span></code></a></li>
 <li><a class="reference internal" href="#sentry_sdk.Scope.set_tag"><code class="docutils literal notranslate"><span class="pre">Scope.set_tag()</span></code></a></li>
@@ -163,12 +174,19 @@ <h3>On this page</h3>
 </ul>
 </li>
 <li><a class="reference internal" href="#sentry_sdk.Client"><code class="docutils literal notranslate"><span class="pre">Client</span></code></a></li>
+<li><a class="reference internal" href="#sentry_sdk.client.BaseClient"><code class="docutils literal notranslate"><span class="pre">BaseClient</span></code></a><ul>
+<li><a class="reference internal" href="#sentry_sdk.client.BaseClient.is_active"><code class="docutils literal notranslate"><span class="pre">BaseClient.is_active()</span></code></a></li>
+</ul>
+</li>
+<li><a class="reference internal" href="#sentry_sdk.client.NonRecordingClient"><code class="docutils literal notranslate"><span class="pre">NonRecordingClient</span></code></a></li>
 <li><a class="reference internal" href="#sentry_sdk.client._Client"><code class="docutils literal notranslate"><span class="pre">_Client</span></code></a><ul>
 <li><a class="reference internal" href="#sentry_sdk.client._Client.capture_event"><code class="docutils literal notranslate"><span class="pre">_Client.capture_event()</span></code></a></li>
 <li><a class="reference internal" href="#sentry_sdk.client._Client.close"><code class="docutils literal notranslate"><span class="pre">_Client.close()</span></code></a></li>
 <li><a class="reference internal" href="#sentry_sdk.client._Client.dsn"><code class="docutils literal notranslate"><span class="pre">_Client.dsn</span></code></a></li>
 <li><a class="reference internal" href="#sentry_sdk.client._Client.flush"><code class="docutils literal notranslate"><span class="pre">_Client.flush()</span></code></a></li>
 <li><a class="reference internal" href="#sentry_sdk.client._Client.get_integration"><code class="docutils literal notranslate"><span class="pre">_Client.get_integration()</span></code></a></li>
+<li><a class="reference internal" href="#sentry_sdk.client._Client.is_active"><code class="docutils literal notranslate"><span class="pre">_Client.is_active()</span></code></a></li>
+<li><a class="reference internal" href="#sentry_sdk.client._Client.should_send_default_pii"><code class="docutils literal notranslate"><span class="pre">_Client.should_send_default_pii()</span></code></a></li>
 </ul>
 </li>
 <li><a class="reference internal" href="#sentry_sdk.Transport"><code class="docutils literal notranslate"><span class="pre">Transport</span></code></a><ul>
@@ -181,7 +199,6 @@ <h3>On this page</h3>
 </li>
 <li><a class="reference internal" href="#sentry_sdk.HttpTransport"><code class="docutils literal notranslate"><span class="pre">HttpTransport</span></code></a><ul>
 <li><a class="reference internal" href="#sentry_sdk.HttpTransport.capture_envelope"><code class="docutils literal notranslate"><span class="pre">HttpTransport.capture_envelope()</span></code></a></li>
-<li><a class="reference internal" href="#sentry_sdk.HttpTransport.capture_event"><code class="docutils literal notranslate"><span class="pre">HttpTransport.capture_event()</span></code></a></li>
 <li><a class="reference internal" href="#sentry_sdk.HttpTransport.flush"><code class="docutils literal notranslate"><span class="pre">HttpTransport.flush()</span></code></a></li>
 <li><a class="reference internal" href="#sentry_sdk.HttpTransport.kill"><code class="docutils literal notranslate"><span class="pre">HttpTransport.kill()</span></code></a></li>
 <li><a class="reference internal" href="#sentry_sdk.HttpTransport.record_lost_event"><code class="docutils literal notranslate"><span class="pre">HttpTransport.record_lost_event()</span></code></a></li>
@@ -203,7 +220,6 @@ <h3>On this page</h3>
 <li><a class="reference internal" href="#sentry_sdk.tracing.Span.finish"><code class="docutils literal notranslate"><span class="pre">Span.finish()</span></code></a></li>
 <li><a class="reference internal" href="#sentry_sdk.tracing.Span.from_traceparent"><code class="docutils literal notranslate"><span class="pre">Span.from_traceparent()</span></code></a></li>
 <li><a class="reference internal" href="#sentry_sdk.tracing.Span.iter_headers"><code class="docutils literal notranslate"><span class="pre">Span.iter_headers()</span></code></a></li>
-<li><a class="reference internal" href="#sentry_sdk.tracing.Span.new_span"><code class="docutils literal notranslate"><span class="pre">Span.new_span()</span></code></a></li>
 <li><a class="reference internal" href="#sentry_sdk.tracing.Span.start_child"><code class="docutils literal notranslate"><span class="pre">Span.start_child()</span></code></a></li>
 <li><a class="reference internal" href="#sentry_sdk.tracing.Span.timestamp"><code class="docutils literal notranslate"><span class="pre">Span.timestamp</span></code></a></li>
 <li><a class="reference internal" href="#sentry_sdk.tracing.Span.to_baggage"><code class="docutils literal notranslate"><span class="pre">Span.to_baggage()</span></code></a></li>
@@ -276,14 +292,21 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 <dl class="py class">
 <dt class="sig sig-object py" id="sentry_sdk.Hub">
 <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">sentry_sdk.</span></span><span class="sig-name descname"><span class="pre">Hub</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">client_or_hub</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">scope</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/hub.html#Hub"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Hub" title="Link to this definition">¶</a></dt>
-<dd><p>The hub wraps the concurrency management of the SDK.  Each thread has
+<dd><div class="deprecated">
+<p><span class="versionmodified deprecated">Deprecated since version 2.0.0: </span>The Hub is deprecated. Its functionality will be merged into <a class="reference internal" href="#sentry_sdk.Scope" title="sentry_sdk.scope.Scope"><code class="xref py py-class docutils literal notranslate"><span class="pre">sentry_sdk.scope.Scope</span></code></a>.</p>
+</div>
+<p>The hub wraps the concurrency management of the SDK.  Each thread has
 its own hub but the hub might transfer with the flow of execution if
 context vars are available.</p>
 <p>If the hub is used with a with statement it’s temporarily activated.</p>
 <dl class="py method">
 <dt class="sig sig-object py" id="sentry_sdk.Hub.add_breadcrumb">
 <span class="sig-name descname"><span class="pre">add_breadcrumb</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">crumb</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">hint</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/hub.html#Hub.add_breadcrumb"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Hub.add_breadcrumb" title="Link to this definition">¶</a></dt>
-<dd><p>Adds a breadcrumb.</p>
+<dd><div class="deprecated">
+<p><span class="versionmodified deprecated">Deprecated since version 2.0.0: </span>This function is deprecated and will be removed in a future release.
+Please use <a class="reference internal" href="#sentry_sdk.Scope.add_breadcrumb" title="sentry_sdk.Scope.add_breadcrumb"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Scope.add_breadcrumb()</span></code></a> instead.</p>
+</div>
+<p>Adds a breadcrumb.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
 <dd class="field-odd"><ul class="simple">
@@ -301,18 +324,22 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 <dl class="py method">
 <dt class="sig sig-object py" id="sentry_sdk.Hub.bind_client">
 <span class="sig-name descname"><span class="pre">bind_client</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">new</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/hub.html#Hub.bind_client"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Hub.bind_client" title="Link to this definition">¶</a></dt>
-<dd><p>Binds a new client to the hub.</p>
-<dl class="field-list simple">
-<dt class="field-odd">Return type<span class="colon">:</span></dt>
-<dd class="field-odd"><p><span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></a></span></p>
-</dd>
-</dl>
+<dd><div class="deprecated">
+<p><span class="versionmodified deprecated">Deprecated since version 2.0.0: </span>This function is deprecated and will be removed in a future release.
+Please use <a class="reference internal" href="#sentry_sdk.Scope.set_client" title="sentry_sdk.Scope.set_client"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Scope.set_client()</span></code></a> instead.</p>
+</div>
+<p>Binds a new client to the hub.
+:rtype: <span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></a></span></p>
 </dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="sentry_sdk.Hub.capture_event">
 <span class="sig-name descname"><span class="pre">capture_event</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">event</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">hint</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">scope</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">scope_kwargs</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/hub.html#Hub.capture_event"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Hub.capture_event" title="Link to this definition">¶</a></dt>
-<dd><p>Captures an event.</p>
+<dd><div class="deprecated">
+<p><span class="versionmodified deprecated">Deprecated since version 2.0.0: </span>This function is deprecated and will be removed in a future release.
+Please use <a class="reference internal" href="#sentry_sdk.Scope.capture_event" title="sentry_sdk.Scope.capture_event"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Scope.capture_event()</span></code></a> instead.</p>
+</div>
+<p>Captures an event.</p>
 <p>Alias of <a class="reference internal" href="#sentry_sdk.Scope.capture_event" title="sentry_sdk.Scope.capture_event"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Scope.capture_event()</span></code></a>.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
@@ -335,7 +362,11 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 <dl class="py method">
 <dt class="sig sig-object py" id="sentry_sdk.Hub.capture_exception">
 <span class="sig-name descname"><span class="pre">capture_exception</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">error</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">scope</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">scope_kwargs</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/hub.html#Hub.capture_exception"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Hub.capture_exception" title="Link to this definition">¶</a></dt>
-<dd><p>Captures an exception.</p>
+<dd><div class="deprecated">
+<p><span class="versionmodified deprecated">Deprecated since version 2.0.0: </span>This function is deprecated and will be removed in a future release.
+Please use <a class="reference internal" href="#sentry_sdk.Scope.capture_exception" title="sentry_sdk.Scope.capture_exception"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Scope.capture_exception()</span></code></a> instead.</p>
+</div>
+<p>Captures an exception.</p>
 <p>Alias of <a class="reference internal" href="#sentry_sdk.Scope.capture_exception" title="sentry_sdk.Scope.capture_exception"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Scope.capture_exception()</span></code></a>.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
@@ -352,7 +383,7 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 <dd class="field-even"><p><span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a>]</span></p>
 </dd>
 <dt class="field-odd">Returns<span class="colon">:</span></dt>
-<dd class="field-odd"><p>An <cite>event_id</cite> if the SDK decided to send the event (see <code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Client.capture_event()</span></code>).</p>
+<dd class="field-odd"><p>An <cite>event_id</cite> if the SDK decided to send the event (see <a class="reference internal" href="#sentry_sdk.client._Client.capture_event" title="sentry_sdk.client._Client.capture_event"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.client._Client.capture_event()</span></code></a>).</p>
 </dd>
 </dl>
 </dd></dl>
@@ -360,7 +391,11 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 <dl class="py method">
 <dt class="sig sig-object py" id="sentry_sdk.Hub.capture_message">
 <span class="sig-name descname"><span class="pre">capture_message</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">message</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">level</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">scope</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">scope_kwargs</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/hub.html#Hub.capture_message"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Hub.capture_message" title="Link to this definition">¶</a></dt>
-<dd><p>Captures a message.</p>
+<dd><div class="deprecated">
+<p><span class="versionmodified deprecated">Deprecated since version 2.0.0: </span>This function is deprecated and will be removed in a future release.
+Please use <a class="reference internal" href="#sentry_sdk.Scope.capture_message" title="sentry_sdk.Scope.capture_message"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Scope.capture_message()</span></code></a> instead.</p>
+</div>
+<p>Captures a message.</p>
 <p>Alias of <a class="reference internal" href="#sentry_sdk.Scope.capture_message" title="sentry_sdk.Scope.capture_message"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Scope.capture_message()</span></code></a>.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
@@ -378,21 +413,28 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 <dd class="field-even"><p><span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a>]</span></p>
 </dd>
 <dt class="field-odd">Returns<span class="colon">:</span></dt>
-<dd class="field-odd"><p>An <cite>event_id</cite> if the SDK decided to send the event (see <code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Client.capture_event()</span></code>).</p>
+<dd class="field-odd"><p>An <cite>event_id</cite> if the SDK decided to send the event (see <a class="reference internal" href="#sentry_sdk.client._Client.capture_event" title="sentry_sdk.client._Client.capture_event"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.client._Client.capture_event()</span></code></a>).</p>
 </dd>
 </dl>
 </dd></dl>
 
 <dl class="py property">
 <dt class="sig sig-object py" id="sentry_sdk.Hub.client">
-<em class="property"><span class="pre">property</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">client</span></span><em class="property"><span class="p"><span class="pre">:</span></span><span class="w"> </span><a class="reference internal" href="#sentry_sdk.Client" title="sentry_sdk.client.Client"><span class="pre">Client</span></a><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><span class="pre">None</span></a></em><a class="headerlink" href="#sentry_sdk.Hub.client" title="Link to this definition">¶</a></dt>
-<dd><p>Returns the current client on the hub.</p>
+<em class="property"><span class="pre">property</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">client</span></span><em class="property"><span class="p"><span class="pre">:</span></span><span class="w"> </span><a class="reference internal" href="#sentry_sdk.client.BaseClient" title="sentry_sdk.client.BaseClient"><span class="pre">BaseClient</span></a><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><span class="pre">None</span></a></em><a class="headerlink" href="#sentry_sdk.Hub.client" title="Link to this definition">¶</a></dt>
+<dd><div class="deprecated">
+<p><span class="versionmodified deprecated">Deprecated since version 2.0.0: </span>This property is deprecated and will be removed in a future release.
+Please use <a class="reference internal" href="api.html#sentry_sdk.api.get_client" title="sentry_sdk.api.get_client"><code class="xref py py-func docutils literal notranslate"><span class="pre">sentry_sdk.api.get_client()</span></code></a> instead.</p>
+</div>
+<p>Returns the current client on the hub.</p>
 </dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="sentry_sdk.Hub.configure_scope">
 <span class="sig-name descname"><span class="pre">configure_scope</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">callback</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">continue_trace</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">True</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/hub.html#Hub.configure_scope"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Hub.configure_scope" title="Link to this definition">¶</a></dt>
-<dd><p>Reconfigures the scope.</p>
+<dd><div class="deprecated">
+<p><span class="versionmodified deprecated">Deprecated since version 2.0.0: </span>This function is deprecated and will be removed in a future release.</p>
+</div>
+<p>Reconfigures the scope.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
 <dd class="field-odd"><p><strong>callback</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Callable" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Callable</span></code></a>[[<a class="reference internal" href="#sentry_sdk.Scope" title="sentry_sdk.scope.Scope"><code class="xref py py-class docutils literal notranslate"><span class="pre">Scope</span></code></a>], <a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></a>]]</span>) – If provided, call the callback with the current scope.</p>
@@ -409,84 +451,84 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 <dl class="py method">
 <dt class="sig sig-object py" id="sentry_sdk.Hub.continue_trace">
 <span class="sig-name descname"><span class="pre">continue_trace</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">environ_or_headers</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">op</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">name</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">source</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/hub.html#Hub.continue_trace"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Hub.continue_trace" title="Link to this definition">¶</a></dt>
-<dd><p>Sets the propagation context from environment or headers and returns a transaction.</p>
-<dl class="field-list simple">
-<dt class="field-odd">Return type<span class="colon">:</span></dt>
-<dd class="field-odd"><p><span class="sphinx_autodoc_typehints-type"><a class="reference internal" href="#sentry_sdk.tracing.Transaction" title="sentry_sdk.tracing.Transaction"><code class="xref py py-class docutils literal notranslate"><span class="pre">Transaction</span></code></a></span></p>
-</dd>
-</dl>
+<dd><div class="deprecated">
+<p><span class="versionmodified deprecated">Deprecated since version 2.0.0: </span>This function is deprecated and will be removed in a future release.
+Please use <a class="reference internal" href="#sentry_sdk.Scope.continue_trace" title="sentry_sdk.Scope.continue_trace"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Scope.continue_trace()</span></code></a> instead.</p>
+</div>
+<p>Sets the propagation context from environment or headers and returns a transaction.
+:rtype: <span class="sphinx_autodoc_typehints-type"><a class="reference internal" href="#sentry_sdk.tracing.Transaction" title="sentry_sdk.tracing.Transaction"><code class="xref py py-class docutils literal notranslate"><span class="pre">Transaction</span></code></a></span></p>
 </dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="sentry_sdk.Hub.end_session">
 <span class="sig-name descname"><span class="pre">end_session</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/hub.html#Hub.end_session"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Hub.end_session" title="Link to this definition">¶</a></dt>
-<dd><p>Ends the current session if there is one.</p>
-<dl class="field-list simple">
-<dt class="field-odd">Return type<span class="colon">:</span></dt>
-<dd class="field-odd"><p><span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></a></span></p>
-</dd>
-</dl>
+<dd><div class="deprecated">
+<p><span class="versionmodified deprecated">Deprecated since version 2.0.0: </span>This function is deprecated and will be removed in a future release.
+Please use <a class="reference internal" href="#sentry_sdk.Scope.end_session" title="sentry_sdk.Scope.end_session"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Scope.end_session()</span></code></a> instead.</p>
+</div>
+<p>Ends the current session if there is one.
+:rtype: <span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></a></span></p>
 </dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="sentry_sdk.Hub.flush">
 <span class="sig-name descname"><span class="pre">flush</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">timeout</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">callback</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/hub.html#Hub.flush"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Hub.flush" title="Link to this definition">¶</a></dt>
-<dd><p>Alias for <code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Client.flush()</span></code></p>
-<dl class="field-list simple">
-<dt class="field-odd">Return type<span class="colon">:</span></dt>
-<dd class="field-odd"><p><span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></a></span></p>
-</dd>
-</dl>
+<dd><div class="deprecated">
+<p><span class="versionmodified deprecated">Deprecated since version 2.0.0: </span>This function is deprecated and will be removed in a future release.
+Please use <a class="reference internal" href="#sentry_sdk.client._Client.flush" title="sentry_sdk.client._Client.flush"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.client._Client.flush()</span></code></a> instead.</p>
+</div>
+<p>Alias for <a class="reference internal" href="#sentry_sdk.client._Client.flush" title="sentry_sdk.client._Client.flush"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.client._Client.flush()</span></code></a>
+:rtype: <span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></a></span></p>
 </dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="sentry_sdk.Hub.get_baggage">
 <span class="sig-name descname"><span class="pre">get_baggage</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/hub.html#Hub.get_baggage"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Hub.get_baggage" title="Link to this definition">¶</a></dt>
-<dd><p>Returns Baggage either from the active span or from the scope.</p>
-<dl class="field-list simple">
-<dt class="field-odd">Return type<span class="colon">:</span></dt>
-<dd class="field-odd"><p><span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a>]</span></p>
-</dd>
-</dl>
+<dd><div class="deprecated">
+<p><span class="versionmodified deprecated">Deprecated since version 2.0.0: </span>This function is deprecated and will be removed in a future release.
+Please use <a class="reference internal" href="#sentry_sdk.Scope.get_baggage" title="sentry_sdk.Scope.get_baggage"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Scope.get_baggage()</span></code></a> instead.</p>
+</div>
+<p>Returns Baggage either from the active span or from the scope.
+:rtype: <span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a>]</span></p>
 </dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="sentry_sdk.Hub.get_integration">
 <span class="sig-name descname"><span class="pre">get_integration</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">name_or_class</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/hub.html#Hub.get_integration"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Hub.get_integration" title="Link to this definition">¶</a></dt>
-<dd><p>Returns the integration for this hub by name or class.  If there
+<dd><div class="deprecated">
+<p><span class="versionmodified deprecated">Deprecated since version 2.0.0: </span>This function is deprecated and will be removed in a future release.
+Please use <a class="reference internal" href="#sentry_sdk.client._Client.get_integration" title="sentry_sdk.client._Client.get_integration"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.client._Client.get_integration()</span></code></a> instead.</p>
+</div>
+<p>Returns the integration for this hub by name or class.  If there
 is no client bound or the client does not have that integration
 then <cite>None</cite> is returned.</p>
 <p>If the return value is not <cite>None</cite> the hub is guaranteed to have a
-client attached.</p>
-<dl class="field-list simple">
-<dt class="field-odd">Return type<span class="colon">:</span></dt>
-<dd class="field-odd"><p><span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Any" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Any</span></code></a></span></p>
-</dd>
-</dl>
+client attached.
+:rtype: <span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Any" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Any</span></code></a></span></p>
 </dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="sentry_sdk.Hub.get_traceparent">
 <span class="sig-name descname"><span class="pre">get_traceparent</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/hub.html#Hub.get_traceparent"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Hub.get_traceparent" title="Link to this definition">¶</a></dt>
-<dd><p>Returns the traceparent either from the active span or from the scope.</p>
-<dl class="field-list simple">
-<dt class="field-odd">Return type<span class="colon">:</span></dt>
-<dd class="field-odd"><p><span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a>]</span></p>
-</dd>
-</dl>
+<dd><div class="deprecated">
+<p><span class="versionmodified deprecated">Deprecated since version 2.0.0: </span>This function is deprecated and will be removed in a future release.
+Please use <a class="reference internal" href="#sentry_sdk.Scope.get_traceparent" title="sentry_sdk.Scope.get_traceparent"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Scope.get_traceparent()</span></code></a> instead.</p>
+</div>
+<p>Returns the traceparent either from the active span or from the scope.
+:rtype: <span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a>]</span></p>
 </dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="sentry_sdk.Hub.iter_trace_propagation_headers">
 <span class="sig-name descname"><span class="pre">iter_trace_propagation_headers</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">span</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/hub.html#Hub.iter_trace_propagation_headers"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Hub.iter_trace_propagation_headers" title="Link to this definition">¶</a></dt>
-<dd><p>Return HTTP headers which allow propagation of trace data. Data taken
+<dd><div class="deprecated">
+<p><span class="versionmodified deprecated">Deprecated since version 2.0.0: </span>This function is deprecated and will be removed in a future release.
+Please use <a class="reference internal" href="#sentry_sdk.Scope.iter_trace_propagation_headers" title="sentry_sdk.Scope.iter_trace_propagation_headers"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Scope.iter_trace_propagation_headers()</span></code></a> instead.</p>
+</div>
+<p>Return HTTP headers which allow propagation of trace data. Data taken
 from the span representing the request, if available, or the current
-span on the scope if not.</p>
-<dl class="field-list simple">
-<dt class="field-odd">Return type<span class="colon">:</span></dt>
-<dd class="field-odd"><p><span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Generator" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">Generator</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Tuple" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Tuple</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a>, <a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a>], <a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></a>, <a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></a>]</span></p>
-</dd>
-</dl>
+span on the scope if not.
+:rtype: <span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Generator" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">Generator</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Tuple" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Tuple</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a>, <a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a>], <a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></a>, <a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></a>]</span></p>
 </dd></dl>
 
 <dl class="py method">
@@ -502,19 +544,21 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 <dl class="py method">
 <dt class="sig sig-object py" id="sentry_sdk.Hub.pop_scope_unsafe">
 <span class="sig-name descname"><span class="pre">pop_scope_unsafe</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/hub.html#Hub.pop_scope_unsafe"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Hub.pop_scope_unsafe" title="Link to this definition">¶</a></dt>
-<dd><p>Pops a scope layer from the stack.</p>
-<p>Try to use the context manager <a class="reference internal" href="#sentry_sdk.Hub.push_scope" title="sentry_sdk.Hub.push_scope"><code class="xref py py-meth docutils literal notranslate"><span class="pre">push_scope()</span></code></a> instead.</p>
-<dl class="field-list simple">
-<dt class="field-odd">Return type<span class="colon">:</span></dt>
-<dd class="field-odd"><p><span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Tuple" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Tuple</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference internal" href="#sentry_sdk.Client" title="sentry_sdk.client.Client"><code class="xref py py-class docutils literal notranslate"><span class="pre">Client</span></code></a>], <a class="reference internal" href="#sentry_sdk.Scope" title="sentry_sdk.scope.Scope"><code class="xref py py-class docutils literal notranslate"><span class="pre">Scope</span></code></a>]</span></p>
-</dd>
-</dl>
+<dd><div class="deprecated">
+<p><span class="versionmodified deprecated">Deprecated since version 2.0.0: </span>This function is deprecated and will be removed in a future release.</p>
+</div>
+<p>Pops a scope layer from the stack.</p>
+<p>Try to use the context manager <a class="reference internal" href="#sentry_sdk.Hub.push_scope" title="sentry_sdk.Hub.push_scope"><code class="xref py py-meth docutils literal notranslate"><span class="pre">push_scope()</span></code></a> instead.
+:rtype: <span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Tuple" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Tuple</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference internal" href="#sentry_sdk.Client" title="sentry_sdk.client.Client"><code class="xref py py-class docutils literal notranslate"><span class="pre">Client</span></code></a>], <a class="reference internal" href="#sentry_sdk.Scope" title="sentry_sdk.scope.Scope"><code class="xref py py-class docutils literal notranslate"><span class="pre">Scope</span></code></a>]</span></p>
 </dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="sentry_sdk.Hub.push_scope">
 <span class="sig-name descname"><span class="pre">push_scope</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">callback</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">continue_trace</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">True</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/hub.html#Hub.push_scope"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Hub.push_scope" title="Link to this definition">¶</a></dt>
-<dd><p>Pushes a new layer on the scope stack.</p>
+<dd><div class="deprecated">
+<p><span class="versionmodified deprecated">Deprecated since version 2.0.0: </span>This function is deprecated and will be removed in a future release.</p>
+</div>
+<p>Pushes a new layer on the scope stack.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
 <dd class="field-odd"><p><strong>callback</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Callable" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Callable</span></code></a>[[<a class="reference internal" href="#sentry_sdk.Scope" title="sentry_sdk.scope.Scope"><code class="xref py py-class docutils literal notranslate"><span class="pre">Scope</span></code></a>], <a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></a>]]</span>) – If provided, this method pushes a scope, calls
@@ -533,49 +577,55 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 <dl class="py method">
 <dt class="sig sig-object py" id="sentry_sdk.Hub.resume_auto_session_tracking">
 <span class="sig-name descname"><span class="pre">resume_auto_session_tracking</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/hub.html#Hub.resume_auto_session_tracking"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Hub.resume_auto_session_tracking" title="Link to this definition">¶</a></dt>
-<dd><p>Resumes automatic session tracking for the current scope if
+<dd><div class="deprecated">
+<p><span class="versionmodified deprecated">Deprecated since version 2.0.0: </span>This function is deprecated and will be removed in a future release.
+Please use <a class="reference internal" href="#sentry_sdk.Scope.resume_auto_session_tracking" title="sentry_sdk.Scope.resume_auto_session_tracking"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Scope.resume_auto_session_tracking()</span></code></a> instead.</p>
+</div>
+<p>Resumes automatic session tracking for the current scope if
 disabled earlier.  This requires that generally automatic session
-tracking is enabled.</p>
-<dl class="field-list simple">
-<dt class="field-odd">Return type<span class="colon">:</span></dt>
-<dd class="field-odd"><p><span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></a></span></p>
-</dd>
-</dl>
+tracking is enabled.
+:rtype: <span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></a></span></p>
 </dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="sentry_sdk.Hub.run">
 <span class="sig-name descname"><span class="pre">run</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">callback</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/hub.html#Hub.run"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Hub.run" title="Link to this definition">¶</a></dt>
-<dd><p>Runs a callback in the context of the hub.  Alternatively the
-with statement can be used on the hub directly.</p>
-<dl class="field-list simple">
-<dt class="field-odd">Return type<span class="colon">:</span></dt>
-<dd class="field-odd"><p><span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.TypeVar" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">TypeVar</span></code></a>(<code class="docutils literal notranslate"><span class="pre">T</span></code>)</span></p>
-</dd>
-</dl>
+<dd><div class="deprecated">
+<p><span class="versionmodified deprecated">Deprecated since version 2.0.0: </span>This function is deprecated and will be removed in a future release.</p>
+</div>
+<p>Runs a callback in the context of the hub.  Alternatively the
+with statement can be used on the hub directly.
+:rtype: <span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.TypeVar" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">TypeVar</span></code></a>(<code class="docutils literal notranslate"><span class="pre">T</span></code>)</span></p>
 </dd></dl>
 
 <dl class="py property">
 <dt class="sig sig-object py" id="sentry_sdk.Hub.scope">
 <em class="property"><span class="pre">property</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">scope</span></span><em class="property"><span class="p"><span class="pre">:</span></span><span class="w"> </span><a class="reference internal" href="#sentry_sdk.Scope" title="sentry_sdk.scope.Scope"><span class="pre">Scope</span></a></em><a class="headerlink" href="#sentry_sdk.Hub.scope" title="Link to this definition">¶</a></dt>
-<dd><p>Returns the current scope on the hub.</p>
+<dd><div class="deprecated">
+<p><span class="versionmodified deprecated">Deprecated since version 2.0.0: </span>This property is deprecated and will be removed in a future release.
+Returns the current scope on the hub.</p>
+</div>
 </dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="sentry_sdk.Hub.start_session">
 <span class="sig-name descname"><span class="pre">start_session</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">session_mode</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">'application'</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/hub.html#Hub.start_session"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Hub.start_session" title="Link to this definition">¶</a></dt>
-<dd><p>Starts a new session.</p>
-<dl class="field-list simple">
-<dt class="field-odd">Return type<span class="colon">:</span></dt>
-<dd class="field-odd"><p><span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></a></span></p>
-</dd>
-</dl>
+<dd><div class="deprecated">
+<p><span class="versionmodified deprecated">Deprecated since version 2.0.0: </span>This function is deprecated and will be removed in a future release.
+Please use <a class="reference internal" href="#sentry_sdk.Scope.start_session" title="sentry_sdk.Scope.start_session"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Scope.start_session()</span></code></a> instead.</p>
+</div>
+<p>Starts a new session.
+:rtype: <span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></a></span></p>
 </dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="sentry_sdk.Hub.start_span">
-<span class="sig-name descname"><span class="pre">start_span</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">span</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">instrumenter</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">'sentry'</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/hub.html#Hub.start_span"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Hub.start_span" title="Link to this definition">¶</a></dt>
-<dd><p>Start a span whose parent is the currently active span or transaction, if any.</p>
+<span class="sig-name descname"><span class="pre">start_span</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">instrumenter</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">'sentry'</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/hub.html#Hub.start_span"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Hub.start_span" title="Link to this definition">¶</a></dt>
+<dd><div class="deprecated">
+<p><span class="versionmodified deprecated">Deprecated since version 2.0.0: </span>This function is deprecated and will be removed in a future release.
+Please use <a class="reference internal" href="#sentry_sdk.Scope.start_span" title="sentry_sdk.Scope.start_span"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Scope.start_span()</span></code></a> instead.</p>
+</div>
+<p>Start a span whose parent is the currently active span or transaction, if any.</p>
 <p>The return value is a <a class="reference internal" href="#sentry_sdk.tracing.Span" title="sentry_sdk.tracing.Span"><code class="xref py py-class docutils literal notranslate"><span class="pre">sentry_sdk.tracing.Span</span></code></a> instance,
 typically used as a context manager to start and stop timing in a <cite>with</cite>
 block.</p>
@@ -584,18 +634,18 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 for every incoming HTTP request. Use
 <code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.start_transaction()</span></code> to start a new transaction when
 one is not already in progress.</p>
-<p>For supported <cite>**kwargs</cite> see <a class="reference internal" href="#sentry_sdk.tracing.Span" title="sentry_sdk.tracing.Span"><code class="xref py py-class docutils literal notranslate"><span class="pre">sentry_sdk.tracing.Span</span></code></a>.</p>
-<dl class="field-list simple">
-<dt class="field-odd">Return type<span class="colon">:</span></dt>
-<dd class="field-odd"><p><span class="sphinx_autodoc_typehints-type"><a class="reference internal" href="#sentry_sdk.tracing.Span" title="sentry_sdk.tracing.Span"><code class="xref py py-class docutils literal notranslate"><span class="pre">Span</span></code></a></span></p>
-</dd>
-</dl>
+<p>For supported <cite>**kwargs</cite> see <a class="reference internal" href="#sentry_sdk.tracing.Span" title="sentry_sdk.tracing.Span"><code class="xref py py-class docutils literal notranslate"><span class="pre">sentry_sdk.tracing.Span</span></code></a>.
+:rtype: <span class="sphinx_autodoc_typehints-type"><a class="reference internal" href="#sentry_sdk.tracing.Span" title="sentry_sdk.tracing.Span"><code class="xref py py-class docutils literal notranslate"><span class="pre">Span</span></code></a></span></p>
 </dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="sentry_sdk.Hub.start_transaction">
-<span class="sig-name descname"><span class="pre">start_transaction</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">transaction</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">instrumenter</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">'sentry'</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/hub.html#Hub.start_transaction"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Hub.start_transaction" title="Link to this definition">¶</a></dt>
-<dd><p>Start and return a transaction.</p>
+<span class="sig-name descname"><span class="pre">start_transaction</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">transaction</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">instrumenter</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">'sentry'</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">custom_sampling_context</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/hub.html#Hub.start_transaction"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Hub.start_transaction" title="Link to this definition">¶</a></dt>
+<dd><div class="deprecated">
+<p><span class="versionmodified deprecated">Deprecated since version 2.0.0: </span>This function is deprecated and will be removed in a future release.
+Please use <a class="reference internal" href="#sentry_sdk.Scope.start_transaction" title="sentry_sdk.Scope.start_transaction"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Scope.start_transaction()</span></code></a> instead.</p>
+</div>
+<p>Start and return a transaction.</p>
 <p>Start an existing transaction if given, otherwise create and start a new
 transaction with kwargs.</p>
 <p>This is the entry point to manual tracing instrumentation.</p>
@@ -609,44 +659,40 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 call the <cite>.finish()</cite> method.</p>
 <p>When the transaction is finished, it will be sent to Sentry with all its
 finished child spans.</p>
-<p>For supported <cite>**kwargs</cite> see <a class="reference internal" href="#sentry_sdk.tracing.Transaction" title="sentry_sdk.tracing.Transaction"><code class="xref py py-class docutils literal notranslate"><span class="pre">sentry_sdk.tracing.Transaction</span></code></a>.</p>
-<dl class="field-list simple">
-<dt class="field-odd">Return type<span class="colon">:</span></dt>
-<dd class="field-odd"><p><span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Union" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Union</span></code></a>[<a class="reference internal" href="#sentry_sdk.tracing.Transaction" title="sentry_sdk.tracing.Transaction"><code class="xref py py-class docutils literal notranslate"><span class="pre">Transaction</span></code></a>, <code class="xref py py-class docutils literal notranslate"><span class="pre">NoOpSpan</span></code>]</span></p>
-</dd>
-</dl>
+<p>For supported <cite>**kwargs</cite> see <a class="reference internal" href="#sentry_sdk.tracing.Transaction" title="sentry_sdk.tracing.Transaction"><code class="xref py py-class docutils literal notranslate"><span class="pre">sentry_sdk.tracing.Transaction</span></code></a>.
+:rtype: <span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Union" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Union</span></code></a>[<a class="reference internal" href="#sentry_sdk.tracing.Transaction" title="sentry_sdk.tracing.Transaction"><code class="xref py py-class docutils literal notranslate"><span class="pre">Transaction</span></code></a>, <code class="xref py py-class docutils literal notranslate"><span class="pre">NoOpSpan</span></code>]</span></p>
 </dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="sentry_sdk.Hub.stop_auto_session_tracking">
 <span class="sig-name descname"><span class="pre">stop_auto_session_tracking</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/hub.html#Hub.stop_auto_session_tracking"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Hub.stop_auto_session_tracking" title="Link to this definition">¶</a></dt>
-<dd><p>Stops automatic session tracking.</p>
+<dd><div class="deprecated">
+<p><span class="versionmodified deprecated">Deprecated since version 2.0.0: </span>This function is deprecated and will be removed in a future release.
+Please use <a class="reference internal" href="#sentry_sdk.Scope.stop_auto_session_tracking" title="sentry_sdk.Scope.stop_auto_session_tracking"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Scope.stop_auto_session_tracking()</span></code></a> instead.</p>
+</div>
+<p>Stops automatic session tracking.</p>
 <p>This temporarily session tracking for the current scope when called.
-To resume session tracking call <cite>resume_auto_session_tracking</cite>.</p>
-<dl class="field-list simple">
-<dt class="field-odd">Return type<span class="colon">:</span></dt>
-<dd class="field-odd"><p><span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></a></span></p>
-</dd>
-</dl>
+To resume session tracking call <cite>resume_auto_session_tracking</cite>.
+:rtype: <span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></a></span></p>
 </dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="sentry_sdk.Hub.trace_propagation_meta">
 <span class="sig-name descname"><span class="pre">trace_propagation_meta</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">span</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/hub.html#Hub.trace_propagation_meta"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Hub.trace_propagation_meta" title="Link to this definition">¶</a></dt>
-<dd><p>Return meta tags which should be injected into HTML templates
-to allow propagation of trace information.</p>
-<dl class="field-list simple">
-<dt class="field-odd">Return type<span class="colon">:</span></dt>
-<dd class="field-odd"><p><span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a></span></p>
-</dd>
-</dl>
+<dd><div class="deprecated">
+<p><span class="versionmodified deprecated">Deprecated since version 2.0.0: </span>This function is deprecated and will be removed in a future release.
+Please use <a class="reference internal" href="#sentry_sdk.Scope.trace_propagation_meta" title="sentry_sdk.Scope.trace_propagation_meta"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Scope.trace_propagation_meta()</span></code></a> instead.</p>
+</div>
+<p>Return meta tags which should be injected into HTML templates
+to allow propagation of trace information.
+:rtype: <span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a></span></p>
 </dd></dl>
 
 </dd></dl>
 
 <dl class="py class">
 <dt class="sig sig-object py" id="sentry_sdk.Scope">
-<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">sentry_sdk.</span></span><span class="sig-name descname"><span class="pre">Scope</span></span><a class="reference internal" href="_modules/sentry_sdk/scope.html#Scope"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Scope" title="Link to this definition">¶</a></dt>
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">sentry_sdk.</span></span><span class="sig-name descname"><span class="pre">Scope</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">ty</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">client</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/scope.html#Scope"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Scope" title="Link to this definition">¶</a></dt>
 <dd><p>The scope holds extra information that should be sent with all
 events that belong to it.</p>
 <dl class="py method">
@@ -722,15 +768,14 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 
 <dl class="py method">
 <dt class="sig sig-object py" id="sentry_sdk.Scope.capture_event">
-<span class="sig-name descname"><span class="pre">capture_event</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">event</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">hint</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">client</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">scope</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">scope_kwargs</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/scope.html#Scope.capture_event"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Scope.capture_event" title="Link to this definition">¶</a></dt>
+<span class="sig-name descname"><span class="pre">capture_event</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">event</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">hint</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">scope</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">scope_kwargs</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/scope.html#Scope.capture_event"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Scope.capture_event" title="Link to this definition">¶</a></dt>
 <dd><p>Captures an event.</p>
-<p>Merges given scope data and calls <code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Client.capture_event()</span></code>.</p>
+<p>Merges given scope data and calls <a class="reference internal" href="#sentry_sdk.client._Client.capture_event" title="sentry_sdk.client._Client.capture_event"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.client._Client.capture_event()</span></code></a>.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
 <dd class="field-odd"><ul class="simple">
 <li><p><strong>event</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">Event</span></code></span>) – A ready-made event that can be directly sent to Sentry.</p></li>
 <li><p><strong>hint</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Dict" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">Dict</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a>, <a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Any" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Any</span></code></a>]]</span>) – Contains metadata about the event that can be read from <cite>before_send</cite>, such as the original exception object or a HTTP request object.</p></li>
-<li><p><strong>client</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference internal" href="#sentry_sdk.Client" title="sentry_sdk.client.Client"><code class="xref py py-class docutils literal notranslate"><span class="pre">Client</span></code></a>]</span>) – The client to use for sending the event to Sentry.</p></li>
 <li><p><strong>scope</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference internal" href="#sentry_sdk.Scope" title="sentry_sdk.scope.Scope"><code class="xref py py-class docutils literal notranslate"><span class="pre">Scope</span></code></a>]</span>) – An optional <a class="reference internal" href="#sentry_sdk.Scope" title="sentry_sdk.Scope"><code class="xref py py-class docutils literal notranslate"><span class="pre">sentry_sdk.Scope</span></code></a> to apply to events.
 The <cite>scope</cite> and <cite>scope_kwargs</cite> parameters are mutually exclusive.</p></li>
 <li><p><strong>scope_kwargs</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Any" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Any</span></code></a></span>) – Optional data to apply to event.
@@ -742,20 +787,19 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 <dd class="field-even"><p><span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a>]</span></p>
 </dd>
 <dt class="field-odd">Returns<span class="colon">:</span></dt>
-<dd class="field-odd"><p>An <cite>event_id</cite> if the SDK decided to send the event (see <code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Client.capture_event()</span></code>).</p>
+<dd class="field-odd"><p>An <cite>event_id</cite> if the SDK decided to send the event (see <a class="reference internal" href="#sentry_sdk.client._Client.capture_event" title="sentry_sdk.client._Client.capture_event"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.client._Client.capture_event()</span></code></a>).</p>
 </dd>
 </dl>
 </dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="sentry_sdk.Scope.capture_exception">
-<span class="sig-name descname"><span class="pre">capture_exception</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">error</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">client</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">scope</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">scope_kwargs</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/scope.html#Scope.capture_exception"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Scope.capture_exception" title="Link to this definition">¶</a></dt>
+<span class="sig-name descname"><span class="pre">capture_exception</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">error</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">scope</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">scope_kwargs</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/scope.html#Scope.capture_exception"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Scope.capture_exception" title="Link to this definition">¶</a></dt>
 <dd><p>Captures an exception.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
 <dd class="field-odd"><ul class="simple">
 <li><p><strong>error</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Union" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Union</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/exceptions.html#BaseException" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">BaseException</span></code></a>, <a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Tuple" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Tuple</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Type" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">Type</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/exceptions.html#BaseException" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">BaseException</span></code></a>]], <a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/exceptions.html#BaseException" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">BaseException</span></code></a>], <a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/types.html#types.TracebackType" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">TracebackType</span></code></a>]], <a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></a>]</span>) – An exception to capture. If <cite>None</cite>, <cite>sys.exc_info()</cite> will be used.</p></li>
-<li><p><strong>client</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference internal" href="#sentry_sdk.Client" title="sentry_sdk.client.Client"><code class="xref py py-class docutils literal notranslate"><span class="pre">Client</span></code></a>]</span>) – The client to use for sending the event to Sentry.</p></li>
 <li><p><strong>scope</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference internal" href="#sentry_sdk.Scope" title="sentry_sdk.scope.Scope"><code class="xref py py-class docutils literal notranslate"><span class="pre">Scope</span></code></a>]</span>) – An optional <a class="reference internal" href="#sentry_sdk.Scope" title="sentry_sdk.Scope"><code class="xref py py-class docutils literal notranslate"><span class="pre">sentry_sdk.Scope</span></code></a> to apply to events.
 The <cite>scope</cite> and <cite>scope_kwargs</cite> parameters are mutually exclusive.</p></li>
 <li><p><strong>scope_kwargs</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Any" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Any</span></code></a></span>) – Optional data to apply to event.
@@ -767,21 +811,20 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 <dd class="field-even"><p><span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a>]</span></p>
 </dd>
 <dt class="field-odd">Returns<span class="colon">:</span></dt>
-<dd class="field-odd"><p>An <cite>event_id</cite> if the SDK decided to send the event (see <code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Client.capture_event()</span></code>).</p>
+<dd class="field-odd"><p>An <cite>event_id</cite> if the SDK decided to send the event (see <a class="reference internal" href="#sentry_sdk.client._Client.capture_event" title="sentry_sdk.client._Client.capture_event"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.client._Client.capture_event()</span></code></a>).</p>
 </dd>
 </dl>
 </dd></dl>
 
 <dl class="py method">
 <dt class="sig sig-object py" id="sentry_sdk.Scope.capture_message">
-<span class="sig-name descname"><span class="pre">capture_message</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">message</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">level</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">client</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">scope</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">scope_kwargs</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/scope.html#Scope.capture_message"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Scope.capture_message" title="Link to this definition">¶</a></dt>
+<span class="sig-name descname"><span class="pre">capture_message</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">message</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">level</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">scope</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">scope_kwargs</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/scope.html#Scope.capture_message"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Scope.capture_message" title="Link to this definition">¶</a></dt>
 <dd><p>Captures a message.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
 <dd class="field-odd"><ul class="simple">
 <li><p><strong>message</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a></span>) – The string to send as the message.</p></li>
 <li><p><strong>level</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Literal" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Literal</span></code></a>[<code class="docutils literal notranslate"><span class="pre">'fatal'</span></code>, <code class="docutils literal notranslate"><span class="pre">'critical'</span></code>, <code class="docutils literal notranslate"><span class="pre">'error'</span></code>, <code class="docutils literal notranslate"><span class="pre">'warning'</span></code>, <code class="docutils literal notranslate"><span class="pre">'info'</span></code>, <code class="docutils literal notranslate"><span class="pre">'debug'</span></code>]]</span>) – If no level is provided, the default level is <cite>info</cite>.</p></li>
-<li><p><strong>client</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference internal" href="#sentry_sdk.Client" title="sentry_sdk.client.Client"><code class="xref py py-class docutils literal notranslate"><span class="pre">Client</span></code></a>]</span>) – The client to use for sending the event to Sentry.</p></li>
 <li><p><strong>scope</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference internal" href="#sentry_sdk.Scope" title="sentry_sdk.scope.Scope"><code class="xref py py-class docutils literal notranslate"><span class="pre">Scope</span></code></a>]</span>) – An optional <a class="reference internal" href="#sentry_sdk.Scope" title="sentry_sdk.Scope"><code class="xref py py-class docutils literal notranslate"><span class="pre">sentry_sdk.Scope</span></code></a> to apply to events.
 The <cite>scope</cite> and <cite>scope_kwargs</cite> parameters are mutually exclusive.</p></li>
 <li><p><strong>scope_kwargs</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Any" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Any</span></code></a></span>) – Optional data to apply to event.
@@ -793,7 +836,7 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 <dd class="field-even"><p><span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a>]</span></p>
 </dd>
 <dt class="field-odd">Returns<span class="colon">:</span></dt>
-<dd class="field-odd"><p>An <cite>event_id</cite> if the SDK decided to send the event (see <code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.Client.capture_event()</span></code>).</p>
+<dd class="field-odd"><p>An <cite>event_id</cite> if the SDK decided to send the event (see <a class="reference internal" href="#sentry_sdk.client._Client.capture_event" title="sentry_sdk.client._Client.capture_event"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.client._Client.capture_event()</span></code></a>).</p>
 </dd>
 </dl>
 </dd></dl>
@@ -848,10 +891,21 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 <dd><p>When set this overrides the default fingerprint.</p>
 </dd></dl>
 
+<dl class="py method">
+<dt class="sig sig-object py" id="sentry_sdk.Scope.fork">
+<span class="sig-name descname"><span class="pre">fork</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/scope.html#Scope.fork"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Scope.fork" title="Link to this definition">¶</a></dt>
+<dd><div class="versionadded">
+<p><span class="versionmodified added">New in version 2.0.0.</span></p>
+</div>
+<p>Returns a fork of this scope.
+:rtype: <span class="sphinx_autodoc_typehints-type"><a class="reference internal" href="#sentry_sdk.Scope" title="sentry_sdk.scope.Scope"><code class="xref py py-class docutils literal notranslate"><span class="pre">Scope</span></code></a></span></p>
+</dd></dl>
+
 <dl class="py method">
 <dt class="sig sig-object py" id="sentry_sdk.Scope.generate_propagation_context">
 <span class="sig-name descname"><span class="pre">generate_propagation_context</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">incoming_data</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/scope.html#Scope.generate_propagation_context"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Scope.generate_propagation_context" title="Link to this definition">¶</a></dt>
-<dd><p>Makes sure <cite>_propagation_context</cite> is set.
+<dd><p>Makes sure the propagation context (<cite>_propagation_context</cite>) is set.
+The propagation context only lives on the current scope.
 If there is <cite>incoming_data</cite> overwrite existing <cite>_propagation_context</cite>.
 if there is no <cite>incoming_data</cite> create new <cite>_propagation_context</cite>, but do NOT overwrite if already existing.</p>
 <dl class="field-list simple">
@@ -861,6 +915,40 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 </dl>
 </dd></dl>
 
+<dl class="py method">
+<dt class="sig sig-object py" id="sentry_sdk.Scope.get_baggage">
+<span class="sig-name descname"><span class="pre">get_baggage</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/scope.html#Scope.get_baggage"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Scope.get_baggage" title="Link to this definition">¶</a></dt>
+<dd><p>Returns the Sentry “baggage” header containing trace information from the
+currently active span or the scopes Propagation Context.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p><span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<code class="xref py py-class docutils literal notranslate"><span class="pre">Baggage</span></code>]</span></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="sentry_sdk.Scope.get_client">
+<em class="property"><span class="pre">classmethod</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">get_client</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/scope.html#Scope.get_client"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Scope.get_client" title="Link to this definition">¶</a></dt>
+<dd><div class="versionadded">
+<p><span class="versionmodified added">New in version 2.0.0.</span></p>
+</div>
+<p>Returns the currently used <a class="reference internal" href="#sentry_sdk.Client" title="sentry_sdk.Client"><code class="xref py py-class docutils literal notranslate"><span class="pre">sentry_sdk.Client</span></code></a>.
+This checks the current scope, the isolation scope and the global scope for a client.
+If no client is available a <a class="reference internal" href="#sentry_sdk.client.NonRecordingClient" title="sentry_sdk.client.NonRecordingClient"><code class="xref py py-class docutils literal notranslate"><span class="pre">sentry_sdk.client.NonRecordingClient</span></code></a> is returned.
+:rtype: <span class="sphinx_autodoc_typehints-type"><a class="reference internal" href="#sentry_sdk.client.BaseClient" title="sentry_sdk.client.BaseClient"><code class="xref py py-class docutils literal notranslate"><span class="pre">BaseClient</span></code></a></span></p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="sentry_sdk.Scope.get_current_scope">
+<em class="property"><span class="pre">classmethod</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">get_current_scope</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/scope.html#Scope.get_current_scope"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Scope.get_current_scope" title="Link to this definition">¶</a></dt>
+<dd><div class="versionadded">
+<p><span class="versionmodified added">New in version 2.0.0.</span></p>
+</div>
+<p>Returns the current scope.
+:rtype: <span class="sphinx_autodoc_typehints-type"><a class="reference internal" href="#sentry_sdk.Scope" title="sentry_sdk.scope.Scope"><code class="xref py py-class docutils literal notranslate"><span class="pre">Scope</span></code></a></span></p>
+</dd></dl>
+
 <dl class="py method">
 <dt class="sig sig-object py" id="sentry_sdk.Scope.get_dynamic_sampling_context">
 <span class="sig-name descname"><span class="pre">get_dynamic_sampling_context</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/scope.html#Scope.get_dynamic_sampling_context"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Scope.get_dynamic_sampling_context" title="Link to this definition">¶</a></dt>
@@ -873,6 +961,26 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 </dl>
 </dd></dl>
 
+<dl class="py method">
+<dt class="sig sig-object py" id="sentry_sdk.Scope.get_global_scope">
+<em class="property"><span class="pre">classmethod</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">get_global_scope</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/scope.html#Scope.get_global_scope"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Scope.get_global_scope" title="Link to this definition">¶</a></dt>
+<dd><div class="versionadded">
+<p><span class="versionmodified added">New in version 2.0.0.</span></p>
+</div>
+<p>Returns the global scope.
+:rtype: <span class="sphinx_autodoc_typehints-type"><a class="reference internal" href="#sentry_sdk.Scope" title="sentry_sdk.scope.Scope"><code class="xref py py-class docutils literal notranslate"><span class="pre">Scope</span></code></a></span></p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="sentry_sdk.Scope.get_isolation_scope">
+<em class="property"><span class="pre">classmethod</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">get_isolation_scope</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/scope.html#Scope.get_isolation_scope"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Scope.get_isolation_scope" title="Link to this definition">¶</a></dt>
+<dd><div class="versionadded">
+<p><span class="versionmodified added">New in version 2.0.0.</span></p>
+</div>
+<p>Returns the isolation scope.
+:rtype: <span class="sphinx_autodoc_typehints-type"><a class="reference internal" href="#sentry_sdk.Scope" title="sentry_sdk.scope.Scope"><code class="xref py py-class docutils literal notranslate"><span class="pre">Scope</span></code></a></span></p>
+</dd></dl>
+
 <dl class="py method">
 <dt class="sig sig-object py" id="sentry_sdk.Scope.get_trace_context">
 <span class="sig-name descname"><span class="pre">get_trace_context</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/scope.html#Scope.get_trace_context"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Scope.get_trace_context" title="Link to this definition">¶</a></dt>
@@ -983,6 +1091,46 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 </dl>
 </dd></dl>
 
+<dl class="py method">
+<dt class="sig sig-object py" id="sentry_sdk.Scope.run_error_processors">
+<span class="sig-name descname"><span class="pre">run_error_processors</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">event</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">hint</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/scope.html#Scope.run_error_processors"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Scope.run_error_processors" title="Link to this definition">¶</a></dt>
+<dd><p>Runs the error processors on the event and returns the modified event.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p><span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<code class="xref py py-class docutils literal notranslate"><span class="pre">Event</span></code>]</span></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="sentry_sdk.Scope.run_event_processors">
+<span class="sig-name descname"><span class="pre">run_event_processors</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">event</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">hint</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/scope.html#Scope.run_event_processors"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Scope.run_event_processors" title="Link to this definition">¶</a></dt>
+<dd><p>Runs the event processors on the event and returns the modified event.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Return type<span class="colon">:</span></dt>
+<dd class="field-odd"><p><span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<code class="xref py py-class docutils literal notranslate"><span class="pre">Event</span></code>]</span></p>
+</dd>
+</dl>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="sentry_sdk.Scope.set_client">
+<span class="sig-name descname"><span class="pre">set_client</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">client</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/scope.html#Scope.set_client"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Scope.set_client" title="Link to this definition">¶</a></dt>
+<dd><div class="versionadded">
+<p><span class="versionmodified added">New in version 2.0.0.</span></p>
+</div>
+<p>Sets the client for this scope.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>client</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference internal" href="#sentry_sdk.client.BaseClient" title="sentry_sdk.client.BaseClient"><code class="xref py py-class docutils literal notranslate"><span class="pre">BaseClient</span></code></a>]</span>) – The client to use in this scope.
+If <cite>None</cite> the client of the scope will be replaced by a <code class="xref py py-class docutils literal notranslate"><span class="pre">sentry_sdk.NonRecordingClient</span></code>.</p>
+</dd>
+<dt class="field-even">Return type<span class="colon">:</span></dt>
+<dd class="field-even"><p><span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></a></span></p>
+</dd>
+</dl>
+</dd></dl>
+
 <dl class="py method">
 <dt class="sig sig-object py" id="sentry_sdk.Scope.set_context">
 <span class="sig-name descname"><span class="pre">set_context</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">key</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">value</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/scope.html#Scope.set_context"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Scope.set_context" title="Link to this definition">¶</a></dt>
@@ -994,6 +1142,18 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 </dl>
 </dd></dl>
 
+<dl class="py method">
+<dt class="sig sig-object py" id="sentry_sdk.Scope.set_current_scope">
+<em class="property"><span class="pre">classmethod</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">set_current_scope</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">new_current_scope</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/scope.html#Scope.set_current_scope"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Scope.set_current_scope" title="Link to this definition">¶</a></dt>
+<dd><div class="versionadded">
+<p><span class="versionmodified added">New in version 2.0.0.</span></p>
+</div>
+<p>Sets the given scope as the new current scope overwriting the existing current scope.
+:type new_current_scope: <span class="sphinx_autodoc_typehints-type"><a class="reference internal" href="#sentry_sdk.Scope" title="sentry_sdk.scope.Scope"><code class="xref py py-class docutils literal notranslate"><span class="pre">Scope</span></code></a></span>
+:param new_current_scope: The scope to set as the new current scope.
+:rtype: <span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></a></span></p>
+</dd></dl>
+
 <dl class="py method">
 <dt class="sig sig-object py" id="sentry_sdk.Scope.set_extra">
 <span class="sig-name descname"><span class="pre">set_extra</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">key</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">value</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/scope.html#Scope.set_extra"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Scope.set_extra" title="Link to this definition">¶</a></dt>
@@ -1005,6 +1165,18 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 </dl>
 </dd></dl>
 
+<dl class="py method">
+<dt class="sig sig-object py" id="sentry_sdk.Scope.set_isolation_scope">
+<em class="property"><span class="pre">classmethod</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">set_isolation_scope</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">new_isolation_scope</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/scope.html#Scope.set_isolation_scope"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Scope.set_isolation_scope" title="Link to this definition">¶</a></dt>
+<dd><div class="versionadded">
+<p><span class="versionmodified added">New in version 2.0.0.</span></p>
+</div>
+<p>Sets the given scope as the new isolation scope overwriting the existing isolation scope.
+:type new_isolation_scope: <span class="sphinx_autodoc_typehints-type"><a class="reference internal" href="#sentry_sdk.Scope" title="sentry_sdk.scope.Scope"><code class="xref py py-class docutils literal notranslate"><span class="pre">Scope</span></code></a></span>
+:param new_isolation_scope: The scope to set as the new isolation scope.
+:rtype: <span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></a></span></p>
+</dd></dl>
+
 <dl class="py method">
 <dt class="sig sig-object py" id="sentry_sdk.Scope.set_level">
 <span class="sig-name descname"><span class="pre">set_level</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">value</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/scope.html#Scope.set_level"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Scope.set_level" title="Link to this definition">¶</a></dt>
@@ -1088,7 +1260,7 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 
 <dl class="py method">
 <dt class="sig sig-object py" id="sentry_sdk.Scope.start_span">
-<span class="sig-name descname"><span class="pre">start_span</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">span</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">instrumenter</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">'sentry'</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/scope.html#Scope.start_span"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Scope.start_span" title="Link to this definition">¶</a></dt>
+<span class="sig-name descname"><span class="pre">start_span</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">instrumenter</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">'sentry'</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/scope.html#Scope.start_span"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Scope.start_span" title="Link to this definition">¶</a></dt>
 <dd><p>Start a span whose parent is the currently active span or transaction, if any.</p>
 <p>The return value is a <a class="reference internal" href="#sentry_sdk.tracing.Span" title="sentry_sdk.tracing.Span"><code class="xref py py-class docutils literal notranslate"><span class="pre">sentry_sdk.tracing.Span</span></code></a> instance,
 typically used as a context manager to start and stop timing in a <cite>with</cite>
@@ -1108,7 +1280,7 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 
 <dl class="py method">
 <dt class="sig sig-object py" id="sentry_sdk.Scope.start_transaction">
-<span class="sig-name descname"><span class="pre">start_transaction</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">transaction</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">instrumenter</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">'sentry'</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/scope.html#Scope.start_transaction"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Scope.start_transaction" title="Link to this definition">¶</a></dt>
+<span class="sig-name descname"><span class="pre">start_transaction</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">transaction</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">instrumenter</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">'sentry'</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">custom_sampling_context</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/scope.html#Scope.start_transaction"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Scope.start_transaction" title="Link to this definition">¶</a></dt>
 <dd><p>Start and return a transaction.</p>
 <p>Start an existing transaction if given, otherwise create and start a new
 transaction with kwargs.</p>
@@ -1123,10 +1295,20 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 call the <cite>.finish()</cite> method.</p>
 <p>When the transaction is finished, it will be sent to Sentry with all its
 finished child spans.</p>
-<p>For supported <cite>**kwargs</cite> see <a class="reference internal" href="#sentry_sdk.tracing.Transaction" title="sentry_sdk.tracing.Transaction"><code class="xref py py-class docutils literal notranslate"><span class="pre">sentry_sdk.tracing.Transaction</span></code></a>.</p>
 <dl class="field-list simple">
-<dt class="field-odd">Return type<span class="colon">:</span></dt>
-<dd class="field-odd"><p><span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Union" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Union</span></code></a>[<a class="reference internal" href="#sentry_sdk.tracing.Transaction" title="sentry_sdk.tracing.Transaction"><code class="xref py py-class docutils literal notranslate"><span class="pre">Transaction</span></code></a>, <code class="xref py py-class docutils literal notranslate"><span class="pre">NoOpSpan</span></code>]</span></p>
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>transaction</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference internal" href="#sentry_sdk.tracing.Transaction" title="sentry_sdk.tracing.Transaction"><code class="xref py py-class docutils literal notranslate"><span class="pre">Transaction</span></code></a>]</span>) – The transaction to start. If omitted, we create and
+start a new transaction.</p></li>
+<li><p><strong>instrumenter</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a></span>) – This parameter is meant for internal use only.</p></li>
+<li><p><strong>custom_sampling_context</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Dict" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">Dict</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a>, <a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Any" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Any</span></code></a>]]</span>) – The transaction’s custom sampling context.</p></li>
+<li><p><strong>kwargs</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">Unpack</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">TransactionKwargs</span></code>]</span>) – Optional keyword arguments to be passed to the Transaction
+constructor. See <a class="reference internal" href="#sentry_sdk.tracing.Transaction" title="sentry_sdk.tracing.Transaction"><code class="xref py py-class docutils literal notranslate"><span class="pre">sentry_sdk.tracing.Transaction</span></code></a> for
+available arguments.</p></li>
+</ul>
+</dd>
+<dt class="field-even">Return type<span class="colon">:</span></dt>
+<dd class="field-even"><p><span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Union" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Union</span></code></a>[<a class="reference internal" href="#sentry_sdk.tracing.Transaction" title="sentry_sdk.tracing.Transaction"><code class="xref py py-class docutils literal notranslate"><span class="pre">Transaction</span></code></a>, <code class="xref py py-class docutils literal notranslate"><span class="pre">NoOpSpan</span></code>]</span></p>
 </dd>
 </dl>
 </dd></dl>
@@ -1197,6 +1379,34 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">sentry_sdk.</span></span><span class="sig-name descname"><span class="pre">Client</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">dsn</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">max_breadcrumbs</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">100</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">release</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">environment</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">server_name</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">shutdown_timeout</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">2</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">integrations</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">[]</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">in_app_include</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">[]</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">in_app_exclude</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">[]</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">default_integrations</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">True</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">dist</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">transport</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">transport_queue_size</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">100</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">sample_rate</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">1.0</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">send_default_pii</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">http_proxy</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">https_proxy</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">ignore_errors</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">[]</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">max_request_body_size</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">'medium'</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">socket_options</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">keep_alive</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">before_send</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">before_breadcrumb</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">debug</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">attach_stacktrace</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">False</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">ca_certs</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">propagate_traces</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">True</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">traces_sample_rate</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">traces_sampler</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">profiles_sample_rate</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">profiles_sampler</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">profiler_mode</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">auto_enabling_integrations</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">True</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">auto_session_tracking</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">True</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">send_client_reports</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">True</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">_experiments</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">{}</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">proxy_headers</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">instrumenter</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">'sentry'</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">before_send_transaction</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">project_root</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">enable_tracing</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">include_local_variables</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">True</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">include_source_context</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">True</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">trace_propagation_targets</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">['.*']</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">functions_to_trace</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">[]</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">event_scrubber</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">max_value_length</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">1024</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">enable_backpressure_handling</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">True</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">error_sampler</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">enable_db_query_source</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">True</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">db_query_source_threshold_ms</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">100</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">spotlight</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/client.html#Client"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Client" title="Link to this definition">¶</a></dt>
 <dd></dd></dl>
 
+<dl class="py class">
+<dt class="sig sig-object py" id="sentry_sdk.client.BaseClient">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">sentry_sdk.client.</span></span><span class="sig-name descname"><span class="pre">BaseClient</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">options</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/client.html#BaseClient"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.client.BaseClient" title="Link to this definition">¶</a></dt>
+<dd><div class="versionadded">
+<p><span class="versionmodified added">New in version 2.0.0.</span></p>
+</div>
+<p>The basic definition of a client that is used for sending data to Sentry.</p>
+<dl class="py method">
+<dt class="sig sig-object py" id="sentry_sdk.client.BaseClient.is_active">
+<span class="sig-name descname"><span class="pre">is_active</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/client.html#BaseClient.is_active"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.client.BaseClient.is_active" title="Link to this definition">¶</a></dt>
+<dd><div class="versionadded">
+<p><span class="versionmodified added">New in version 2.0.0.</span></p>
+</div>
+<p>Returns whether the client is active (able to send data to Sentry)
+:rtype: <span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">bool</span></code></a></span></p>
+</dd></dl>
+
+</dd></dl>
+
+<dl class="py class">
+<dt class="sig sig-object py" id="sentry_sdk.client.NonRecordingClient">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">sentry_sdk.client.</span></span><span class="sig-name descname"><span class="pre">NonRecordingClient</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">options</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/client.html#NonRecordingClient"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.client.NonRecordingClient" title="Link to this definition">¶</a></dt>
+<dd><div class="versionadded">
+<p><span class="versionmodified added">New in version 2.0.0.</span></p>
+</div>
+<p>A client that does not send any events to Sentry. This is used as a fallback when the Sentry SDK is not yet initialized.</p>
+</dd></dl>
+
 <dl class="py class">
 <dt class="sig sig-object py" id="sentry_sdk.client._Client">
 <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">sentry_sdk.client.</span></span><span class="sig-name descname"><span class="pre">_Client</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/client.html#_Client"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.client._Client" title="Link to this definition">¶</a></dt>
@@ -1204,7 +1414,7 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 forwarding them to sentry through the configured transport.  It takes
 the client options as keyword arguments and optionally the DSN as first
 argument.</p>
-<p>Alias of <a class="reference internal" href="#sentry_sdk.Client" title="sentry_sdk.client.Client"><code class="xref py py-class docutils literal notranslate"><span class="pre">Client</span></code></a>. (Was created for better intelisense support)</p>
+<p>Alias of <a class="reference internal" href="#sentry_sdk.Client" title="sentry_sdk.Client"><code class="xref py py-class docutils literal notranslate"><span class="pre">sentry_sdk.Client</span></code></a>. (Was created for better intelisense support)</p>
 <dl class="py method">
 <dt class="sig sig-object py" id="sentry_sdk.client._Client.capture_event">
 <span class="sig-name descname"><span class="pre">capture_event</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">event</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">hint</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">scope</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/client.html#_Client.capture_event"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.client._Client.capture_event" title="Link to this definition">¶</a></dt>
@@ -1214,8 +1424,7 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 <dd class="field-odd"><ul class="simple">
 <li><p><strong>event</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">Event</span></code></span>) – A ready-made event that can be directly sent to Sentry.</p></li>
 <li><p><strong>hint</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Dict" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">Dict</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a>, <a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Any" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Any</span></code></a>]]</span>) – Contains metadata about the event that can be read from <cite>before_send</cite>, such as the original exception object or a HTTP request object.</p></li>
-<li><p><strong>scope</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference internal" href="#sentry_sdk.Scope" title="sentry_sdk.scope.Scope"><code class="xref py py-class docutils literal notranslate"><span class="pre">Scope</span></code></a>]</span>) – An optional <a class="reference internal" href="#sentry_sdk.Scope" title="sentry_sdk.Scope"><code class="xref py py-class docutils literal notranslate"><span class="pre">sentry_sdk.Scope</span></code></a> to apply to events.
-The <cite>scope</cite> and <cite>scope_kwargs</cite> parameters are mutually exclusive.</p></li>
+<li><p><strong>scope</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference internal" href="#sentry_sdk.Scope" title="sentry_sdk.scope.Scope"><code class="xref py py-class docutils literal notranslate"><span class="pre">Scope</span></code></a>]</span>) – An optional <a class="reference internal" href="#sentry_sdk.Scope" title="sentry_sdk.Scope"><code class="xref py py-class docutils literal notranslate"><span class="pre">sentry_sdk.Scope</span></code></a> to apply to events.</p></li>
 </ul>
 </dd>
 <dt class="field-even">Return type<span class="colon">:</span></dt>
@@ -1274,6 +1483,26 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 </dl>
 </dd></dl>
 
+<dl class="py method">
+<dt class="sig sig-object py" id="sentry_sdk.client._Client.is_active">
+<span class="sig-name descname"><span class="pre">is_active</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/client.html#_Client.is_active"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.client._Client.is_active" title="Link to this definition">¶</a></dt>
+<dd><div class="versionadded">
+<p><span class="versionmodified added">New in version 2.0.0.</span></p>
+</div>
+<p>Returns whether the client is active (able to send data to Sentry)
+:rtype: <span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">bool</span></code></a></span></p>
+</dd></dl>
+
+<dl class="py method">
+<dt class="sig sig-object py" id="sentry_sdk.client._Client.should_send_default_pii">
+<span class="sig-name descname"><span class="pre">should_send_default_pii</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/client.html#_Client.should_send_default_pii"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.client._Client.should_send_default_pii" title="Link to this definition">¶</a></dt>
+<dd><div class="versionadded">
+<p><span class="versionmodified added">New in version 2.0.0.</span></p>
+</div>
+<p>Returns whether the client should send default PII (Personally Identifiable Information) data to Sentry.
+:rtype: <span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">bool</span></code></a></span></p>
+</dd></dl>
+
 </dd></dl>
 
 <dl class="py class">
@@ -1283,12 +1512,11 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 <p>A transport is used to send an event to sentry.</p>
 <dl class="py method">
 <dt class="sig sig-object py" id="sentry_sdk.Transport.capture_envelope">
-<span class="sig-name descname"><span class="pre">capture_envelope</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">envelope</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/transport.html#Transport.capture_envelope"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Transport.capture_envelope" title="Link to this definition">¶</a></dt>
+<em class="property"><span class="pre">abstract</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">capture_envelope</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">envelope</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/transport.html#Transport.capture_envelope"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Transport.capture_envelope" title="Link to this definition">¶</a></dt>
 <dd><p>Send an envelope to Sentry.</p>
 <p>Envelopes are a data container format that can hold any type of data
-submitted to Sentry. We use it for transactions and sessions, but
-regular “error” events should go through <cite>capture_event</cite> for backwards
-compat.</p>
+submitted to Sentry. We use it to send all event data (including errors,
+transactions, crons checkins, etc.) to Sentry.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Return type<span class="colon">:</span></dt>
 <dd class="field-odd"><p><span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></a></span></p>
@@ -1299,7 +1527,8 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 <dl class="py method">
 <dt class="sig sig-object py" id="sentry_sdk.Transport.capture_event">
 <span class="sig-name descname"><span class="pre">capture_event</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">event</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/transport.html#Transport.capture_event"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Transport.capture_event" title="Link to this definition">¶</a></dt>
-<dd><p>This gets invoked with the event dictionary when an event should
+<dd><p>DEPRECATED: Please use capture_envelope instead.</p>
+<p>This gets invoked with the event dictionary when an event should
 be sent to sentry.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Return type<span class="colon">:</span></dt>
@@ -1312,6 +1541,8 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 <dt class="sig sig-object py" id="sentry_sdk.Transport.flush">
 <span class="sig-name descname"><span class="pre">flush</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">timeout</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">callback</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/transport.html#Transport.flush"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Transport.flush" title="Link to this definition">¶</a></dt>
 <dd><p>Wait <cite>timeout</cite> seconds for the current events to be sent out.</p>
+<p>The default implementation is a no-op, since this method may only be relevant to some transports.
+Subclasses should override this method if necessary.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Return type<span class="colon">:</span></dt>
 <dd class="field-odd"><p><span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></a></span></p>
@@ -1323,6 +1554,8 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 <dt class="sig sig-object py" id="sentry_sdk.Transport.kill">
 <span class="sig-name descname"><span class="pre">kill</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/transport.html#Transport.kill"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.Transport.kill" title="Link to this definition">¶</a></dt>
 <dd><p>Forcefully kills the transport.</p>
+<p>The default implementation is a no-op, since this method may only be relevant to some transports.
+Subclasses should override this method if necessary.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Return type<span class="colon">:</span></dt>
 <dd class="field-odd"><p><span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></a></span></p>
@@ -1353,21 +1586,8 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 <span class="sig-name descname"><span class="pre">capture_envelope</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">envelope</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/transport.html#HttpTransport.capture_envelope"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.HttpTransport.capture_envelope" title="Link to this definition">¶</a></dt>
 <dd><p>Send an envelope to Sentry.</p>
 <p>Envelopes are a data container format that can hold any type of data
-submitted to Sentry. We use it for transactions and sessions, but
-regular “error” events should go through <cite>capture_event</cite> for backwards
-compat.</p>
-<dl class="field-list simple">
-<dt class="field-odd">Return type<span class="colon">:</span></dt>
-<dd class="field-odd"><p><span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></a></span></p>
-</dd>
-</dl>
-</dd></dl>
-
-<dl class="py method">
-<dt class="sig sig-object py" id="sentry_sdk.HttpTransport.capture_event">
-<span class="sig-name descname"><span class="pre">capture_event</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">event</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/transport.html#HttpTransport.capture_event"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.HttpTransport.capture_event" title="Link to this definition">¶</a></dt>
-<dd><p>This gets invoked with the event dictionary when an event should
-be sent to sentry.</p>
+submitted to Sentry. We use it to send all event data (including errors,
+transactions, crons checkins, etc.) to Sentry.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Return type<span class="colon">:</span></dt>
 <dd class="field-odd"><p><span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></a></span></p>
@@ -1379,6 +1599,8 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 <dt class="sig sig-object py" id="sentry_sdk.HttpTransport.flush">
 <span class="sig-name descname"><span class="pre">flush</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">timeout</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">callback</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/transport.html#HttpTransport.flush"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.HttpTransport.flush" title="Link to this definition">¶</a></dt>
 <dd><p>Wait <cite>timeout</cite> seconds for the current events to be sent out.</p>
+<p>The default implementation is a no-op, since this method may only be relevant to some transports.
+Subclasses should override this method if necessary.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Return type<span class="colon">:</span></dt>
 <dd class="field-odd"><p><span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></a></span></p>
@@ -1390,6 +1612,8 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 <dt class="sig sig-object py" id="sentry_sdk.HttpTransport.kill">
 <span class="sig-name descname"><span class="pre">kill</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/transport.html#HttpTransport.kill"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.HttpTransport.kill" title="Link to this definition">¶</a></dt>
 <dd><p>Forcefully kills the transport.</p>
+<p>The default implementation is a no-op, since this method may only be relevant to some transports.
+Subclasses should override this method if necessary.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Return type<span class="colon">:</span></dt>
 <dd class="field-odd"><p><span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></a></span></p>
@@ -1413,9 +1637,27 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 
 <dl class="py class">
 <dt class="sig sig-object py" id="sentry_sdk.tracing.Transaction">
-<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">sentry_sdk.tracing.</span></span><span class="sig-name descname"><span class="pre">Transaction</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Any" title="(in Python v3.12)"><span class="pre">Any</span></a></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/tracing.html#Transaction"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.tracing.Transaction" title="Link to this definition">¶</a></dt>
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">sentry_sdk.tracing.</span></span><span class="sig-name descname"><span class="pre">Transaction</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">name</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">''</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">parent_sampled</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">baggage</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">source</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">'custom'</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/tracing.html#Transaction"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.tracing.Transaction" title="Link to this definition">¶</a></dt>
 <dd><p>The Transaction is the root element that holds all the spans
 for Sentry performance instrumentation.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>name</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a></span>) – Identifier of the transaction.
+Will show up in the Sentry UI.</p></li>
+<li><p><strong>parent_sampled</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">bool</span></code></a>]</span>) – Whether the parent transaction was sampled.
+If True this transaction will be kept, if False it will be discarded.</p></li>
+<li><p><strong>baggage</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<code class="xref py py-class docutils literal notranslate"><span class="pre">Baggage</span></code>]</span>) – The W3C baggage header value.
+(see <a class="reference external" href="https://www.w3.org/TR/baggage/">https://www.w3.org/TR/baggage/</a>)</p></li>
+<li><p><strong>source</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a></span>) – A string describing the source of the transaction name.
+This will be used to determine the transaction’s type.
+See <a class="reference external" href="https://develop.sentry.dev/sdk/event-payloads/transaction/#transaction-annotations">https://develop.sentry.dev/sdk/event-payloads/transaction/#transaction-annotations</a>
+for more information. Default “custom”.</p></li>
+<li><p><strong>kwargs</strong> (<span class="sphinx_autodoc_typehints-type"><code class="xref py py-class docutils literal notranslate"><span class="pre">Unpack</span></code>[<code class="xref py py-class docutils literal notranslate"><span class="pre">SpanKwargs</span></code>]</span>) – Additional arguments to be passed to the Span constructor.
+See <a class="reference internal" href="#sentry_sdk.tracing.Span" title="sentry_sdk.tracing.Span"><code class="xref py py-class docutils literal notranslate"><span class="pre">sentry_sdk.tracing.Span</span></code></a> for available arguments.</p></li>
+</ul>
+</dd>
+</dl>
 <dl class="py property">
 <dt class="sig sig-object py" id="sentry_sdk.tracing.Transaction.containing_transaction">
 <em class="property"><span class="pre">property</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">containing_transaction</span></span><em class="property"><span class="p"><span class="pre">:</span></span><span class="w"> </span><a class="reference internal" href="#sentry_sdk.tracing.Transaction" title="sentry_sdk.tracing.Transaction"><span class="pre">Transaction</span></a></em><a class="headerlink" href="#sentry_sdk.tracing.Transaction.containing_transaction" title="Link to this definition">¶</a></dt>
@@ -1431,9 +1673,9 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
 <dd class="field-odd"><ul class="simple">
-<li><p><strong>hub</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference internal" href="#sentry_sdk.Hub" title="sentry_sdk.hub.Hub"><code class="xref py py-class docutils literal notranslate"><span class="pre">Hub</span></code></a>]</span>) – The hub to use for this transaction.
+<li><p><strong>hub</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Union" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Union</span></code></a>[<a class="reference internal" href="#sentry_sdk.Hub" title="sentry_sdk.hub.Hub"><code class="xref py py-class docutils literal notranslate"><span class="pre">Hub</span></code></a>, <a class="reference internal" href="#sentry_sdk.Scope" title="sentry_sdk.scope.Scope"><code class="xref py py-class docutils literal notranslate"><span class="pre">Scope</span></code></a>, <a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></a>]</span>) – The hub to use for this transaction.
 If not provided, the current hub will be used.</p></li>
-<li><p><strong>end_timestamp</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Union" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Union</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">float</span></code></a>, <a class="reference external" href="https://docs.python.org/3/library/datetime.html#datetime.datetime" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">datetime</span></code></a>, <a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></a>]</span>) – Optional timestamp that should
+<li><p><strong>end_timestamp</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Union" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Union</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/datetime.html#datetime.datetime" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">datetime</span></code></a>, <a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">float</span></code></a>, <a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></a>]</span>) – Optional timestamp that should
 be used as timestamp instead of the current time.</p></li>
 </ul>
 </dd>
@@ -1509,9 +1751,36 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 
 <dl class="py class">
 <dt class="sig sig-object py" id="sentry_sdk.tracing.Span">
-<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">sentry_sdk.tracing.</span></span><span class="sig-name descname"><span class="pre">Span</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span><span class="p"><span class="pre">:</span></span><span class="w"> </span><span class="n"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Any" title="(in Python v3.12)"><span class="pre">Any</span></a></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/tracing.html#Span"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.tracing.Span" title="Link to this definition">¶</a></dt>
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">sentry_sdk.tracing.</span></span><span class="sig-name descname"><span class="pre">Span</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">trace_id</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">span_id</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">parent_span_id</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">same_process_as_parent</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">True</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">sampled</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">op</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">description</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">hub</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">status</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">containing_transaction</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">start_timestamp</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">scope</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/tracing.html#Span"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.tracing.Span" title="Link to this definition">¶</a></dt>
 <dd><p>A span holds timing information of a block of code.
 Spans can have multiple child spans thus forming a span tree.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>trace_id</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a>]</span>) – The trace ID of the root span. If this new span is to be the root span,
+omit this parameter, and a new trace ID will be generated.</p></li>
+<li><p><strong>span_id</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a>]</span>) – The span ID of this span. If omitted, a new span ID will be generated.</p></li>
+<li><p><strong>parent_span_id</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a>]</span>) – The span ID of the parent span, if applicable.</p></li>
+<li><p><strong>same_process_as_parent</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">bool</span></code></a></span>) – Whether this span is in the same process as the parent span.</p></li>
+<li><p><strong>sampled</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/functions.html#bool" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">bool</span></code></a>]</span>) – Whether the span should be sampled. Overrides the default sampling decision
+for this span when provided.</p></li>
+<li><p><strong>op</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a>]</span>) – The span’s operation. A list of recommended values is available here:
+<a class="reference external" href="https://develop.sentry.dev/sdk/performance/span-operations/">https://develop.sentry.dev/sdk/performance/span-operations/</a></p></li>
+<li><p><strong>description</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a>]</span>) – A description of what operation is being performed within the span.</p></li>
+<li><p><strong>hub</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference internal" href="#sentry_sdk.Hub" title="sentry_sdk.hub.Hub"><code class="xref py py-class docutils literal notranslate"><span class="pre">Hub</span></code></a>]</span>) – <p>The hub to use for this span.</p>
+<div class="deprecated">
+<p><span class="versionmodified deprecated">Deprecated since version 2.0.0: </span>Please use the <cite>scope</cite> parameter, instead.</p>
+</div>
+</p></li>
+<li><p><strong>status</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a>]</span>) – The span’s status. Possible values are listed at
+<a class="reference external" href="https://develop.sentry.dev/sdk/event-payloads/span/">https://develop.sentry.dev/sdk/event-payloads/span/</a></p></li>
+<li><p><strong>containing_transaction</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference internal" href="#sentry_sdk.tracing.Transaction" title="sentry_sdk.tracing.Transaction"><code class="xref py py-class docutils literal notranslate"><span class="pre">Transaction</span></code></a>]</span>) – The transaction that this span belongs to.</p></li>
+<li><p><strong>start_timestamp</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Union" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Union</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/datetime.html#datetime.datetime" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">datetime</span></code></a>, <a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">float</span></code></a>, <a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></a>]</span>) – The timestamp when the span started. If omitted, the current time
+will be used.</p></li>
+<li><p><strong>scope</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference internal" href="#sentry_sdk.Scope" title="sentry_sdk.scope.Scope"><code class="xref py py-class docutils literal notranslate"><span class="pre">Scope</span></code></a>]</span>) – The scope to use for this span. If not provided, we use the current scope.</p></li>
+</ul>
+</dd>
+</dl>
 <dl class="py property">
 <dt class="sig sig-object py" id="sentry_sdk.tracing.Span.containing_transaction">
 <em class="property"><span class="pre">property</span><span class="w"> </span></em><span class="sig-name descname"><span class="pre">containing_transaction</span></span><em class="property"><span class="p"><span class="pre">:</span></span><span class="w"> </span><a class="reference internal" href="#sentry_sdk.tracing.Transaction" title="sentry_sdk.tracing.Transaction"><span class="pre">Transaction</span></a><span class="w"> </span><span class="p"><span class="pre">|</span></span><span class="w"> </span><a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><span class="pre">None</span></a></em><a class="headerlink" href="#sentry_sdk.tracing.Span.containing_transaction" title="Link to this definition">¶</a></dt>
@@ -1532,7 +1801,7 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 rather than the form <code class="docutils literal notranslate"><span class="pre">header-name</span></code>.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
-<dd class="field-odd"><p><strong>environ</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Mapping" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">Mapping</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a>, <a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a>]</span>) – The ASGI/WSGI environ to pull information from.</p>
+<dd class="field-odd"><p><strong>environ</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/collections.abc.html#collections.abc.Mapping" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">Mapping</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a>, <a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a>]</span>) – The ASGI/WSGI environ to pull information from.</p>
 </dd>
 <dt class="field-even">Return type<span class="colon">:</span></dt>
 <dd class="field-even"><p><span class="sphinx_autodoc_typehints-type"><a class="reference internal" href="#sentry_sdk.tracing.Transaction" title="sentry_sdk.tracing.Transaction"><code class="xref py py-class docutils literal notranslate"><span class="pre">Transaction</span></code></a></span></p>
@@ -1547,7 +1816,7 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 the <code class="docutils literal notranslate"><span class="pre">sentry-trace</span></code> and <code class="docutils literal notranslate"><span class="pre">baggage</span></code> headers).</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
-<dd class="field-odd"><p><strong>headers</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Mapping" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">Mapping</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a>, <a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a>]</span>) – The dictionary with the HTTP headers to pull information from.</p>
+<dd class="field-odd"><p><strong>headers</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/collections.abc.html#collections.abc.Mapping" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">Mapping</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a>, <a class="reference external" href="https://docs.python.org/3/library/stdtypes.html#str" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a>]</span>) – The dictionary with the HTTP headers to pull information from.</p>
 </dd>
 <dt class="field-even">Return type<span class="colon">:</span></dt>
 <dd class="field-even"><p><span class="sphinx_autodoc_typehints-type"><a class="reference internal" href="#sentry_sdk.tracing.Transaction" title="sentry_sdk.tracing.Transaction"><code class="xref py py-class docutils literal notranslate"><span class="pre">Transaction</span></code></a></span></p>
@@ -1557,16 +1826,16 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 
 <dl class="py method">
 <dt class="sig sig-object py" id="sentry_sdk.tracing.Span.finish">
-<span class="sig-name descname"><span class="pre">finish</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">hub</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">end_timestamp</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/tracing.html#Span.finish"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.tracing.Span.finish" title="Link to this definition">¶</a></dt>
-<dd><p>Sets the end timestamp of the span.
-Additionally it also creates a breadcrumb from the span,
+<span class="sig-name descname"><span class="pre">finish</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">scope</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">end_timestamp</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/tracing.html#Span.finish"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.tracing.Span.finish" title="Link to this definition">¶</a></dt>
+<dd><p>Sets the end timestamp of the span.</p>
+<p>Additionally it also creates a breadcrumb from the span,
 if the span represents a database or HTTP request.</p>
 <dl class="field-list simple">
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
 <dd class="field-odd"><ul class="simple">
-<li><p><strong>hub</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference internal" href="#sentry_sdk.Hub" title="sentry_sdk.hub.Hub"><code class="xref py py-class docutils literal notranslate"><span class="pre">Hub</span></code></a>]</span>) – The hub to use for this transaction.
-If not provided, the current hub will be used.</p></li>
-<li><p><strong>end_timestamp</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Union" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Union</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">float</span></code></a>, <a class="reference external" href="https://docs.python.org/3/library/datetime.html#datetime.datetime" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">datetime</span></code></a>, <a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></a>]</span>) – Optional timestamp that should
+<li><p><strong>scope</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Optional" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Optional</span></code></a>[<a class="reference internal" href="#sentry_sdk.Scope" title="sentry_sdk.scope.Scope"><code class="xref py py-class docutils literal notranslate"><span class="pre">Scope</span></code></a>]</span>) – The scope to use for this transaction.
+If not provided, the current scope will be used.</p></li>
+<li><p><strong>end_timestamp</strong> (<span class="sphinx_autodoc_typehints-type"><a class="reference external" href="https://docs.python.org/3/library/typing.html#typing.Union" title="(in Python v3.12)"><code class="xref py py-data docutils literal notranslate"><span class="pre">Union</span></code></a>[<a class="reference external" href="https://docs.python.org/3/library/datetime.html#datetime.datetime" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">datetime</span></code></a>, <a class="reference external" href="https://docs.python.org/3/library/functions.html#float" title="(in Python v3.12)"><code class="xref py py-class docutils literal notranslate"><span class="pre">float</span></code></a>, <a class="reference external" href="https://docs.python.org/3/library/constants.html#None" title="(in Python v3.12)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">None</span></code></a>]</span>) – Optional timestamp that should
 be used as timestamp instead of the current time.</p></li>
 </ul>
 </dd>
@@ -1606,17 +1875,6 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 </dl>
 </dd></dl>
 
-<dl class="py method">
-<dt class="sig sig-object py" id="sentry_sdk.tracing.Span.new_span">
-<span class="sig-name descname"><span class="pre">new_span</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/tracing.html#Span.new_span"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.tracing.Span.new_span" title="Link to this definition">¶</a></dt>
-<dd><p>DEPRECATED: use <a class="reference internal" href="#sentry_sdk.tracing.Span.start_child" title="sentry_sdk.tracing.Span.start_child"><code class="xref py py-meth docutils literal notranslate"><span class="pre">sentry_sdk.tracing.Span.start_child()</span></code></a> instead.</p>
-<dl class="field-list simple">
-<dt class="field-odd">Return type<span class="colon">:</span></dt>
-<dd class="field-odd"><p><span class="sphinx_autodoc_typehints-type"><a class="reference internal" href="#sentry_sdk.tracing.Span" title="sentry_sdk.tracing.Span"><code class="xref py py-class docutils literal notranslate"><span class="pre">Span</span></code></a></span></p>
-</dd>
-</dl>
-</dd></dl>
-
 <dl class="py method">
 <dt class="sig sig-object py" id="sentry_sdk.tracing.Span.start_child">
 <span class="sig-name descname"><span class="pre">start_child</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">instrumenter</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">'sentry'</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/tracing.html#Span.start_child"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.tracing.Span.start_child" title="Link to this definition">¶</a></dt>
@@ -1745,7 +2003,10 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
 <dl class="py class">
 <dt class="sig sig-object py" id="sentry_sdk.envelope.Envelope">
 <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">sentry_sdk.envelope.</span></span><span class="sig-name descname"><span class="pre">Envelope</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">headers</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">items</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="_modules/sentry_sdk/envelope.html#Envelope"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#sentry_sdk.envelope.Envelope" title="Link to this definition">¶</a></dt>
-<dd></dd></dl>
+<dd><p>Represents a Sentry Envelope. The calling code is responsible for adhering to the constraints
+documented in the Sentry docs: <a class="reference external" href="https://develop.sentry.dev/sdk/envelopes/#data-model">https://develop.sentry.dev/sdk/envelopes/#data-model</a>. In particular,
+each envelope may have at most one Item with type “event” or “transaction” (but not both).</p>
+</dd></dl>
 
 <dl class="py class">
 <dt class="sig sig-object py" id="sentry_sdk.envelope.Item">
@@ -1806,7 +2067,7 @@ <h1>API Docs<a class="headerlink" href="#api-docs" title="Link to this heading">
     </div>
   </div>
 </footer></div>
-      <script src="_static/documentation_options.js?v=fca6d697"></script>
+      <script src="_static/documentation_options.js?v=aa9da443"></script>
       <script src="_static/doctools.js?v=888ff710"></script>
       <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
       <script src="_static/shibuya.js?v=999236dc"></script>
diff --git a/genindex.html b/genindex.html
index 09250875fd..44990a7333 100644
--- a/genindex.html
+++ b/genindex.html
@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-      <title>Index - sentry-python 1.44.1 documentation</title>
+      <title>Index - sentry-python 2.0.0rc4 documentation</title>
     <link rel="index" title="Index" href="#" /><link rel="search" title="Search" href="search.html" />
 
   <script>
@@ -128,10 +128,12 @@ <h2 id="A">A</h2>
 <h2 id="B">B</h2>
 <table style="width: 100%" class="indextable genindextable"><tr>
   <td style="width: 33%; vertical-align: top;"><ul>
-      <li><a href="apidocs.html#sentry_sdk.Hub.bind_client">bind_client() (sentry_sdk.Hub method)</a>
+      <li><a href="apidocs.html#sentry_sdk.client.BaseClient">BaseClient (class in sentry_sdk.client)</a>
 </li>
   </ul></td>
   <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="apidocs.html#sentry_sdk.Hub.bind_client">bind_client() (sentry_sdk.Hub method)</a>
+</li>
       <li><a href="integrations.html#sentry_sdk.integrations.logging.BreadcrumbHandler">BreadcrumbHandler (class in sentry_sdk.integrations.logging)</a>
 </li>
   </ul></td>
@@ -150,8 +152,6 @@ <h2 id="C">C</h2>
 
       <ul>
         <li><a href="apidocs.html#sentry_sdk.client._Client.capture_event">(sentry_sdk.client._Client method)</a>
-</li>
-        <li><a href="apidocs.html#sentry_sdk.HttpTransport.capture_event">(sentry_sdk.HttpTransport method)</a>
 </li>
         <li><a href="apidocs.html#sentry_sdk.Hub.capture_event">(sentry_sdk.Hub method)</a>
 </li>
@@ -176,10 +176,10 @@ <h2 id="C">C</h2>
         <li><a href="apidocs.html#sentry_sdk.Scope.capture_message">(sentry_sdk.Scope method)</a>
 </li>
       </ul></li>
-  </ul></td>
-  <td style="width: 33%; vertical-align: top;"><ul>
       <li><a href="apidocs.html#sentry_sdk.monitor.Monitor.check_health">check_health() (sentry_sdk.monitor.Monitor method)</a>
 </li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
       <li><a href="apidocs.html#sentry_sdk.Scope.clear">clear() (sentry_sdk.Scope method)</a>
 </li>
       <li><a href="apidocs.html#sentry_sdk.Scope.clear_breadcrumbs">clear_breadcrumbs() (sentry_sdk.Scope method)</a>
@@ -268,6 +268,8 @@ <h2 id="F">F</h2>
       </ul></li>
   </ul></td>
   <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="apidocs.html#sentry_sdk.Scope.fork">fork() (sentry_sdk.Scope method)</a>
+</li>
       <li><a href="apidocs.html#sentry_sdk.tracing.Span.from_traceparent">from_traceparent() (sentry_sdk.tracing.Span class method)</a>
 </li>
   </ul></td>
@@ -282,17 +284,29 @@ <h2 id="G">G</h2>
 
       <ul>
         <li><a href="apidocs.html#sentry_sdk.Hub.get_baggage">(sentry_sdk.Hub method)</a>
+</li>
+        <li><a href="apidocs.html#sentry_sdk.Scope.get_baggage">(sentry_sdk.Scope method)</a>
 </li>
         <li><a href="apidocs.html#sentry_sdk.tracing.Transaction.get_baggage">(sentry_sdk.tracing.Transaction method)</a>
 </li>
       </ul></li>
-      <li><a href="api.html#sentry_sdk.api.get_current_span">get_current_span() (in module sentry_sdk.api)</a>
+      <li><a href="api.html#sentry_sdk.api.get_client">get_client() (in module sentry_sdk.api)</a>
+
+      <ul>
+        <li><a href="apidocs.html#sentry_sdk.Scope.get_client">(sentry_sdk.Scope class method)</a>
 </li>
-      <li><a href="apidocs.html#sentry_sdk.Scope.get_dynamic_sampling_context">get_dynamic_sampling_context() (sentry_sdk.Scope method)</a>
+      </ul></li>
+      <li><a href="apidocs.html#sentry_sdk.Scope.get_current_scope">get_current_scope() (sentry_sdk.Scope class method)</a>
+</li>
+      <li><a href="api.html#sentry_sdk.api.get_current_span">get_current_span() (in module sentry_sdk.api)</a>
 </li>
   </ul></td>
   <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="apidocs.html#sentry_sdk.Scope.get_dynamic_sampling_context">get_dynamic_sampling_context() (sentry_sdk.Scope method)</a>
+</li>
       <li><a href="apidocs.html#sentry_sdk.envelope.Item.get_event">get_event() (sentry_sdk.envelope.Item method)</a>
+</li>
+      <li><a href="apidocs.html#sentry_sdk.Scope.get_global_scope">get_global_scope() (sentry_sdk.Scope class method)</a>
 </li>
       <li><a href="apidocs.html#sentry_sdk.client._Client.get_integration">get_integration() (sentry_sdk.client._Client method)</a>
 
@@ -300,6 +314,8 @@ <h2 id="G">G</h2>
         <li><a href="apidocs.html#sentry_sdk.Hub.get_integration">(sentry_sdk.Hub method)</a>
 </li>
       </ul></li>
+      <li><a href="apidocs.html#sentry_sdk.Scope.get_isolation_scope">get_isolation_scope() (sentry_sdk.Scope class method)</a>
+</li>
       <li><a href="apidocs.html#sentry_sdk.Scope.get_trace_context">get_trace_context() (sentry_sdk.Scope method)</a>
 </li>
       <li><a href="api.html#sentry_sdk.api.get_traceparent">get_traceparent() (in module sentry_sdk.api)</a>
@@ -330,6 +346,16 @@ <h2 id="I">I</h2>
   <td style="width: 33%; vertical-align: top;"><ul>
       <li><a href="integrations.html#sentry_sdk.integrations.logging.ignore_logger">ignore_logger() (in module sentry_sdk.integrations.logging)</a>
 </li>
+      <li><a href="apidocs.html#sentry_sdk.client._Client.is_active">is_active() (sentry_sdk.client._Client method)</a>
+
+      <ul>
+        <li><a href="apidocs.html#sentry_sdk.client.BaseClient.is_active">(sentry_sdk.client.BaseClient method)</a>
+</li>
+      </ul></li>
+      <li><a href="api.html#sentry_sdk.api.is_initialized">is_initialized() (in module sentry_sdk.api)</a>
+</li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
       <li><a href="apidocs.html#sentry_sdk.envelope.Item">Item (class in sentry_sdk.envelope)</a>
 </li>
       <li><a href="apidocs.html#sentry_sdk.Scope.iter_headers">iter_headers() (sentry_sdk.Scope method)</a>
@@ -338,8 +364,6 @@ <h2 id="I">I</h2>
         <li><a href="apidocs.html#sentry_sdk.tracing.Span.iter_headers">(sentry_sdk.tracing.Span method)</a>
 </li>
       </ul></li>
-  </ul></td>
-  <td style="width: 33%; vertical-align: top;"><ul>
       <li><a href="apidocs.html#sentry_sdk.Hub.iter_trace_propagation_headers">iter_trace_propagation_headers() (sentry_sdk.Hub method)</a>
 
       <ul>
@@ -393,7 +417,11 @@ <h2 id="M">M</h2>
 <h2 id="N">N</h2>
 <table style="width: 100%" class="indextable genindextable"><tr>
   <td style="width: 33%; vertical-align: top;"><ul>
-      <li><a href="apidocs.html#sentry_sdk.tracing.Span.new_span">new_span() (sentry_sdk.tracing.Span method)</a>
+      <li><a href="api.html#sentry_sdk.api.new_scope">new_scope() (in module sentry_sdk.api)</a>
+</li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
+      <li><a href="apidocs.html#sentry_sdk.client.NonRecordingClient">NonRecordingClient (class in sentry_sdk.client)</a>
 </li>
   </ul></td>
 </tr></table>
@@ -429,10 +457,10 @@ <h2 id="R">R</h2>
 </li>
       <li><a href="apidocs.html#sentry_sdk.Scope.remove_extra">remove_extra() (sentry_sdk.Scope method)</a>
 </li>
-  </ul></td>
-  <td style="width: 33%; vertical-align: top;"><ul>
       <li><a href="apidocs.html#sentry_sdk.Scope.remove_tag">remove_tag() (sentry_sdk.Scope method)</a>
 </li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
       <li><a href="apidocs.html#sentry_sdk.Hub.resume_auto_session_tracking">resume_auto_session_tracking() (sentry_sdk.Hub method)</a>
 
       <ul>
@@ -440,6 +468,10 @@ <h2 id="R">R</h2>
 </li>
       </ul></li>
       <li><a href="apidocs.html#sentry_sdk.Hub.run">run() (sentry_sdk.Hub method)</a>
+</li>
+      <li><a href="apidocs.html#sentry_sdk.Scope.run_error_processors">run_error_processors() (sentry_sdk.Scope method)</a>
+</li>
+      <li><a href="apidocs.html#sentry_sdk.Scope.run_event_processors">run_event_processors() (sentry_sdk.Scope method)</a>
 </li>
   </ul></td>
 </tr></table>
@@ -463,6 +495,8 @@ <h2 id="S">S</h2>
 </li>
       </ul></li>
       <li><a href="apidocs.html#sentry_sdk.session.Session">Session (class in sentry_sdk.session)</a>
+</li>
+      <li><a href="apidocs.html#sentry_sdk.Scope.set_client">set_client() (sentry_sdk.Scope method)</a>
 </li>
       <li><a href="api.html#sentry_sdk.api.set_context">set_context() (in module sentry_sdk.api)</a>
 
@@ -472,6 +506,8 @@ <h2 id="S">S</h2>
         <li><a href="apidocs.html#sentry_sdk.tracing.Transaction.set_context">(sentry_sdk.tracing.Transaction method)</a>
 </li>
       </ul></li>
+      <li><a href="apidocs.html#sentry_sdk.Scope.set_current_scope">set_current_scope() (sentry_sdk.Scope class method)</a>
+</li>
       <li><a href="api.html#sentry_sdk.api.set_extra">set_extra() (in module sentry_sdk.api)</a>
 
       <ul>
@@ -479,6 +515,8 @@ <h2 id="S">S</h2>
 </li>
       </ul></li>
       <li><a href="apidocs.html#sentry_sdk.tracing.Transaction.set_http_status">set_http_status() (sentry_sdk.tracing.Transaction method)</a>
+</li>
+      <li><a href="apidocs.html#sentry_sdk.Scope.set_isolation_scope">set_isolation_scope() (sentry_sdk.Scope class method)</a>
 </li>
       <li><a href="api.html#sentry_sdk.api.set_level">set_level() (in module sentry_sdk.api)</a>
 
@@ -488,14 +526,14 @@ <h2 id="S">S</h2>
       </ul></li>
       <li><a href="apidocs.html#sentry_sdk.Scope.set_new_propagation_context">set_new_propagation_context() (sentry_sdk.Scope method)</a>
 </li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
       <li><a href="api.html#sentry_sdk.api.set_tag">set_tag() (in module sentry_sdk.api)</a>
 
       <ul>
         <li><a href="apidocs.html#sentry_sdk.Scope.set_tag">(sentry_sdk.Scope method)</a>
 </li>
       </ul></li>
-  </ul></td>
-  <td style="width: 33%; vertical-align: top;"><ul>
       <li><a href="apidocs.html#sentry_sdk.Scope.set_transaction_name">set_transaction_name() (sentry_sdk.Scope method)</a>
 </li>
       <li><a href="api.html#sentry_sdk.api.set_user">set_user() (in module sentry_sdk.api)</a>
@@ -504,6 +542,8 @@ <h2 id="S">S</h2>
         <li><a href="apidocs.html#sentry_sdk.Scope.set_user">(sentry_sdk.Scope method)</a>
 </li>
       </ul></li>
+      <li><a href="apidocs.html#sentry_sdk.client._Client.should_send_default_pii">should_send_default_pii() (sentry_sdk.client._Client method)</a>
+</li>
       <li><a href="apidocs.html#sentry_sdk.tracing.Span">Span (class in sentry_sdk.tracing)</a>
 </li>
       <li><a href="apidocs.html#sentry_sdk.Scope.span">span (sentry_sdk.Scope property)</a>
@@ -612,7 +652,7 @@ <h2 id="U">U</h2>
     </div>
   </div>
 </footer></div>
-      <script src="_static/documentation_options.js?v=fca6d697"></script>
+      <script src="_static/documentation_options.js?v=aa9da443"></script>
       <script src="_static/doctools.js?v=888ff710"></script>
       <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
       <script src="_static/shibuya.js?v=999236dc"></script>
diff --git a/index.html b/index.html
index 9e0b22a995..318b127bfa 100644
--- a/index.html
+++ b/index.html
@@ -4,7 +4,7 @@
 <head>
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-      <title>sentry-python 1.44.1 documentation</title>
+      <title>sentry-python 2.0.0rc4 documentation</title>
     <link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="next" title="Top Level API" href="api.html" />
 
   <script>
@@ -177,7 +177,7 @@ <h1>sentry-python - Sentry SDK for Python<a class="headerlink" href="#sentry-pyt
     </div>
   </div>
 </footer></div>
-      <script src="_static/documentation_options.js?v=fca6d697"></script>
+      <script src="_static/documentation_options.js?v=aa9da443"></script>
       <script src="_static/doctools.js?v=888ff710"></script>
       <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
       <script src="_static/shibuya.js?v=999236dc"></script>
diff --git a/integrations.html b/integrations.html
index fe3eac4474..e4930f451c 100644
--- a/integrations.html
+++ b/integrations.html
@@ -4,7 +4,7 @@
 <head>
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-      <title>Integrations - sentry-python 1.44.1 documentation</title>
+      <title>Integrations - sentry-python 2.0.0rc4 documentation</title>
     <link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="next" title="API Docs" href="apidocs.html" /><link rel="prev" title="Top Level API" href="api.html" />
 
   <script>
@@ -225,7 +225,7 @@ <h1>Integrations<a class="headerlink" href="#integrations" title="Link to this h
     </div>
   </div>
 </footer></div>
-      <script src="_static/documentation_options.js?v=fca6d697"></script>
+      <script src="_static/documentation_options.js?v=aa9da443"></script>
       <script src="_static/doctools.js?v=888ff710"></script>
       <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
       <script src="_static/shibuya.js?v=999236dc"></script>
diff --git a/objects.inv b/objects.inv
index 3d072fab38b22b78a71d3c180768380716ee68f9..8374e8d58c0e8fd60c717bb78d980dcfa8986db3 100644
GIT binary patch
delta 1370
zcmV-g1*Q7V3c?GJK?5=_Fp)((f5DR5C=iD4ehO7>u2$_{b4xa<%G7SQrsBC%NWwBP
z5)`1xI8VQgkYq{r%+PJ0GPe1C1T@`0C{DEAo|vnS`QJ*yhs>NlmWn%<{grVeD_y$$
z;2ZVFhitoX=hol6H&2$g&S*=6@{$|hS;0j6ER;4Ps5HVKbcK@HtIi#Wf9z2zMMSMA
zwXK-a&NJ~m%v_pIS0qnZSLD2^SYZXPO4~IBrkA{sZN<uIU6Z+KWuD38ODT+(x+T$#
zaE{jk$4<jE7J|w8QwpTpy{to*u0%y(WW8)V!Mx=q4i&I04#tR`A7rQlQ47xsUf0;!
z44iDes4YjYVqp6@G2CL~e@A*@Bh11w^1APy9U%OLbtoy=Uc=60vO<wYn-~wQYaQR?
zX3oG85u(Wo*ENFi&g(HW`gu6Yw#Er{xYe2-6|rrc=hl-Vcpwd@U_K;YUV40|u%Nfk
z>}6O2%9AB_<3y(<{=RXa`nmVKJT#b%bcP9a;|vRHwGHDfVb-*ze<<|3kE~#fIx$!^
zTp5Zmt%R*ubP-$f*fKWIN^nbIW~=S6Jgt^Rm{QFmxrZ$%tg#YRxCd6-BeJ_%v;ykc
zau0{0ix-cU!q?R^iL_)hu(P40BJ0bUuTCv*WXT+FjDpF(Vf3}q1y|%Jkxr|)091vT
zj_CuSSd>WjCIxFre`e_I{w9hkNNx(faja<cGj-wy7(mNusOL2ryn{6wq`G!p)*MA*
zS=X=<j+z2`khE^@#^e!r%A&iQw|Y>R0v*Y<;@2H=eNe(jtrH8w${_JlhTb`WH3Or&
zMr8$>rC+cZQ$GhOwtnPqHuh2I9@aizjRQ6PovDH`*<0PPf8#H1Yiv%L3sAP%7-xx3
zjlTN3!?oWP36!~~UKtXv3-57N2)|u9$L+f|Mp+NP3SP_-mYW}cknHT}lS*D*#if(0
z!%HH#GVuuNT)i>SSbv8^i9lCgHIbB#$yR#FmHaI#1Q_Zjb`_TQUWw4k&>*PEj3AiF
zMj)7>@FR#Zf0L#ni{gobRs|=8oi3AH{%LWsl#;`*(|Nd|8FD#;^G%bS-Qq6FKXWH=
zFP|>J5b9wfo&~n^b;sKk<t|>3T~ql_w?FzM57vV;6m|<mtcPn6s850lR}SNORxqv{
zuVCt%ij@pGfJOm#(47hwVQs}KvFDwF6QY#Ka^n`tf4|OrQA#XK;KQ)@&`>{zxY#*#
z#qvGo8~Y}-TfnpBa=FrVJsNghbxLG^W{U>BT>NSK;eDa}^W>Gj@wQSi8IN;vshlGD
zHO$T3)MVXi*sS5>MWuLGvC&Y`wavfBe^b|ch2`Zzl*e%Gq<s3$gWbKCFa`Nz{3EsV
z-W9Che}B9YFtO!I!gfUgUH40|8$P8!z%@F4%_>=@$Nig1N;-s6JhA4x^N~AcD8UJa
zAleOv0n7AmnS(8CYeqY;Ua0lnyFYkBR*@EwgWr(C-iR)w_Aov~MOm_;cgo%HLWOii
zyikZ1uRKUq(FDANLzw4{2{>3cD~rwxl!8XTf8$v5KOG?)o|bWm3Go?vzet~p5<_b)
zL3wv{O^0$D{F=_ed&3}FeCKY`A}slEN%G2nD0|CSEQnWRaguX6Xp=c#eT0Ss(l^hZ
zw8{SMPm-S=A2x&1s^uge+GJng)20>>iIsTiTPj`v4{gV9W8;VL=jPmO5S+D$&$=}y
zOqkm?+h)7|bGG~PPqqg)@YsL9nY)Ok(8^svkLPbTV6v_}qB(8HA0qQT+O+tvvtQrA
c;<GJjC%7#SOE7*HnO*$-5w^<ae=!=ll^77QkpKVy

delta 1253
zcmV<B1RDFo3(g9VK?E@_G&GS!JbzJ-+b9sn-}5OfU0-9}z4oowR_f}m(n{HPgl%He
zV1oc}H{ZSkIF50$S%&1PYn$KSco=4eNevsUJ`&R$%CCaMMWK$LYe9`E{wb*9jjT=C
z*<Sqhsn~AJdGrr!)r+QsQBvnYWlfbGH6v_zWkM?ERC;DR+2qN*PSelO*nf-BbeZgd
z3z3OxR!iLwA&tdOf2@*?K2{}d8d7OSn_7>3g?UR^@u4C0>>J5k=CUlwx0)%-<&Z`9
z%oy4-96Nue(%_KV9#bGW?0M^6X=;=g2iEdoWW;J(<4^|6V&EIG_CdNj5G}K$qHT+{
zrsMcvS*s~}6&>qsqNv9D4}Z5z2bj2Jq^*BF>A?M&HYh3BUenGbyg`vls^AY~91Pv#
zET>?JGQ3GMGxm(o(aMu+csm^U(Bgzf+-l8JMQj^mskT`jJduj#VAcg+T3h@}VL|V=
z?4?@*N|PmaCqt(Mem~fUerhePyB@QV&TvNFIKxb9sonS1U^S_86o35g%T`cI90{x%
zE)4}ZFNLjGbP|hsY#N(r!Klt*7OQQrd|oaKa85Q0<Q}#l(@Jwx;tp)f1_sF~-jMD)
z*c*1eUBYUP1MPWD4DFSGY26_e;>4XiGIs{rXHRUdT%h+S-XJDm*9r8BYSzowT*FN;
zfSTr^mbPf{0XaKJ8Gl&!ybpI|&R08bUMD0su-^~Zc1{Uzbi<-TfWWq884{ym*dTkV
zT2M}%S1Ls;rdV2nIpxxczq?=xLXRk!%GGzE%s;Be<%qqOJvscQy2XaFr2wv~pZLko
z5@(HW%RHbZb8kB)w-uAwhIvE_2A*B1kN4vcyv)Pzf)`f8a(~OR63H$~%2e{Q#gR^~
zio!&2)pS5m^{8FhGsipxx~iHI$@sLM2(6Mef|?UGf|-*vf|=4Pf;h#gR3u7GC}<VV
zQ`q?kY|1auaX2MHUZ+cUuACwzf#SDMjvb-Vc+qm-t|)WSoxi3+aGm>@%8b`*5s05G
z7j6tDC$C^!x_?-~xgE;WqL<$nc{0WJGx#)l3mWos#;sL1R`KrzH{8sPi{OQMOetjB
zo(eeGjDi(^7tsJO7anateJoV|JLk?HbZA5fA19k!DyK+(ceZ($8gB;)o5NjR#I_F=
zdpU3`b@?;=o4VdBtgJg$AKWQg*mO^a-L&Umg7P{1k$?JfpU2jH#v2Y3My@3ESXJ<9
zzZARaDt!Xi=y01fyiWJ~n@WNkgi<)cl)Lj0Eag*NIpLgWH>Ef%<Etmi2iHo<JHTA1
z`C7~$L?Ehgjfi<Sq_7R1NNNw?hlt=Y>)xKz>WWmdI$n{2>t&#h*byB{n!4kn$rG>~
zN_tCs<$rJ}RWz?g%TNju{R`ik|79|q=_U4R%m!JYkJ~3p(M-o&O62@<dQB&%v-h4(
zXRRXOEp{|_X=N<=bmV^LzmD9hN+RMNS)Alj4#pJ5HlJbOg!tjbi&Vw`{^a!K`DrsL
ztwzq`ZcOnFt~M<LPi)wmA1P=BJd8cv4TGQDpH`dmut{(+BFuHGj$qrN*cLl~UF^R7
zSL~sdc=q=<%NisWTGb}-#`B#GlxSC`sE*sygTVX@MP8Wf;^_xim|IL6Ms?lAV7M2U
PU3mTsTV?YHn_EC5=E`ng

diff --git a/py-modindex.html b/py-modindex.html
index 7d30c7dcc8..dfbd4badd2 100644
--- a/py-modindex.html
+++ b/py-modindex.html
@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-      <title>Python Module Index - sentry-python 1.44.1 documentation</title>
+      <title>Python Module Index - sentry-python 2.0.0rc4 documentation</title>
     <link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" />
 
   <script>
@@ -117,7 +117,7 @@ <h1>Python Module Index</h1>
     </div>
   </div>
 </footer></div>
-      <script src="_static/documentation_options.js?v=fca6d697"></script>
+      <script src="_static/documentation_options.js?v=aa9da443"></script>
       <script src="_static/doctools.js?v=888ff710"></script>
       <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
       <script src="_static/shibuya.js?v=999236dc"></script>
diff --git a/search.html b/search.html
index d63a4ec0f9..80951c35a1 100644
--- a/search.html
+++ b/search.html
@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-      <title>Search - sentry-python 1.44.1 documentation</title>
+      <title>Search - sentry-python 2.0.0rc4 documentation</title>
     <link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="#" />
 
   <script>
@@ -120,7 +120,7 @@ <h1 id="search-documentation">Search</h1>
   </div>
 </footer></div>
     
-      <script src="_static/documentation_options.js?v=fca6d697"></script>
+      <script src="_static/documentation_options.js?v=aa9da443"></script>
       <script src="_static/doctools.js?v=888ff710"></script>
       <script src="_static/sphinx_highlight.js?v=dc90522c"></script>
       <script src="_static/shibuya.js?v=999236dc"></script>
diff --git a/searchindex.js b/searchindex.js
index 10a5d9cf49..18a69f18cc 100644
--- a/searchindex.js
+++ b/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"docnames": ["api", "apidocs", "index", "integrations"], "filenames": ["api.rst", "apidocs.rst", "index.rst", "integrations.rst"], "titles": ["Top Level API", "API Docs", "sentry-python - Sentry SDK for Python", "Integrations"], "terms": {"thi": [0, 1, 2, 3], "i": [0, 1, 2, 3], "user": [0, 1, 3], "face": 0, "sdk": [0, 1], "It": [0, 1], "": [0, 1, 2], "expos": [0, 3], "sentry_sdk": [0, 1, 3], "With": 0, "you": [0, 1, 3], "can": [0, 1], "implement": 0, "custom": [0, 1], "error": [0, 1], "report": 0, "solut": 0, "capture_ev": [0, 1], "hint": [0, 1], "none": [0, 1, 3], "scope_kwarg": [0, 1], "sourc": [0, 1, 3], "alia": [0, 1], "hub": [0, 1], "an": [0, 1], "paramet": [0, 1, 3], "A": [0, 1, 3], "readi": [0, 1], "made": [0, 1], "directli": [0, 1], "sent": [0, 1], "sentri": [0, 1, 3], "option": [0, 1], "dict": [0, 1], "str": [0, 1, 3], "ani": [0, 1], "contain": [0, 1], "metadata": [0, 1], "about": [0, 1], "read": [0, 1], "from": [0, 1], "before_send": [0, 1], "origin": [0, 1], "except": [0, 1], "object": [0, 1], "http": [0, 1], "request": [0, 1], "appli": [0, 1], "The": [0, 1, 3], "ar": [0, 1], "mutual": [0, 1], "exclus": [0, 1], "For": [0, 1, 2], "support": [0, 1], "see": [0, 1], "update_from_kwarg": [0, 1], "return": [0, 1, 3], "type": [0, 1, 3], "capture_except": [0, 1], "union": [0, 1], "baseexcept": [0, 1], "tupl": [0, 1], "tracebacktyp": [0, 1], "If": [0, 1], "sy": [0, 1], "exc_info": [0, 1], "us": [0, 1, 3], "event_id": [0, 1], "decid": [0, 1], "send": [0, 1], "client": [0, 1], "capture_messag": [0, 1], "messag": [0, 1], "string": [0, 1, 3], "liter": [0, 1], "fatal": [0, 1], "critic": [0, 1], "warn": [0, 1], "info": [0, 1], "debug": [0, 1], "provid": [0, 1], "default": [0, 1, 3], "add_breadcrumb": [0, 1], "crumb": [0, 1], "kwarg": [0, 1], "add": [0, 1], "breadcrumb": [0, 1, 3], "dictionari": [0, 1], "v7": [0, 1], "v8": [0, 1], "protocol": [0, 1], "expect": [0, 1], "valu": [0, 1], "before_breadcrumb": [0, 1], "emit": [0, 1, 3], "set_context": [0, 1], "kei": [0, 1], "bind": [0, 1], "context": [0, 1], "certain": [0, 1], "specif": [0, 1, 3], "set_extra": [0, 1], "set": [0, 1], "extra": [0, 1], "set_level": [0, 1], "set_tag": [0, 1], "tag": [0, 1], "set_us": [0, 1], "continue_trac": [0, 1], "environ_or_head": [0, 1], "op": [0, 1], "name": [0, 1, 3], "propag": [0, 1], "environ": [0, 1], "header": [0, 1], "transact": [0, 1], "get_current_span": 0, "current": [0, 1], "activ": [0, 1], "span": [0, 1], "one": [0, 1], "run": [0, 1], "otherwis": [0, 1], "start_span": [0, 1], "start": [0, 1], "whose": [0, 1], "parent": [0, 1], "instanc": [0, 1], "typic": [0, 1], "stop": [0, 1], "time": [0, 1], "block": [0, 1], "onli": [0, 1], "most": [0, 1], "integr": [0, 1, 2], "appropri": [0, 1], "exampl": [0, 1], "everi": [0, 1], "incom": [0, 1], "start_transact": [0, 1], "new": [0, 1], "when": [0, 1], "alreadi": [0, 1], "progress": [0, 1], "exist": [0, 1], "given": [0, 1], "creat": [0, 1], "entri": [0, 1], "point": [0, 1], "manual": [0, 1], "instrument": [0, 1], "tree": [0, 1], "structur": [0, 1], "built": [0, 1], "ad": [0, 1], "child": [0, 1], "other": [0, 1, 2, 3], "To": [0, 1], "within": [0, 1], "call": [0, 1, 3], "respect": [0, 1], "start_child": [0, 1], "method": [0, 1], "must": [0, 1], "finish": [0, 1], "befor": [0, 1], "unfinish": [0, 1], "discard": [0, 1], "automat": [0, 1], "end": [0, 1], "all": [0, 1], "its": [0, 1], "noopspan": [0, 1], "get_baggag": [0, 1], "baggag": [0, 1], "either": [0, 1], "get_tracepar": [0, 1], "tracepar": [0, 1], "configure_scop": [0, 1], "callback": [0, 1], "reconfigur": [0, 1], "callabl": [0, 1], "contextmanag": [0, 1], "push_scop": [0, 1], "push": [0, 1], "layer": [0, 1], "stack": [0, 1], "pop": [0, 1], "again": [0, 1], "should": [0, 1], "class": [1, 3], "client_or_hub": 1, "scope": 1, "wrap": 1, "concurr": 1, "manag": 1, "each": [1, 3], "thread": 1, "ha": 1, "own": 1, "might": 1, "transfer": 1, "flow": 1, "execut": 1, "var": 1, "avail": 1, "statement": 1, "temporarili": 1, "data": 1, "bind_client": 1, "event": [1, 3], "captur": 1, "level": [1, 2, 3], "properti": 1, "true": 1, "end_sess": 1, "session": 1, "flush": 1, "timeout": 1, "get_integr": 1, "name_or_class": 1, "bound": 1, "doe": 1, "have": [1, 3], "guarante": 1, "attach": 1, "iter_trace_propagation_head": 1, "which": [1, 3], "allow": 1, "trace": 1, "taken": 1, "repres": 1, "gener": 1, "last_event_id": 1, "last": 1, "id": 1, "rtype": 1, "deprec": 1, "sinc": 1, "version": 1, "1": 1, "40": 1, "5": 1, "function": 1, "remov": 1, "futur": 1, "releas": 1, "pop_scope_unsaf": 1, "try": 1, "instead": 1, "resume_auto_session_track": 1, "resum": 1, "track": 1, "disabl": [1, 3], "earlier": 1, "requir": 1, "enabl": [1, 3], "altern": 1, "typevar": 1, "t": 1, "start_sess": 1, "session_mod": 1, "applic": 1, "stop_auto_session_track": 1, "trace_propagation_meta": 1, "meta": 1, "inject": 1, "html": 1, "templat": 1, "inform": 1, "hold": 1, "belong": 1, "add_attach": 1, "byte": 1, "filenam": 1, "path": 1, "content_typ": 1, "add_to_transact": 1, "fals": 1, "add_error_processor": 1, "func": 1, "cl": 1, "regist": 1, "local": 1, "processor": 1, "work": 1, "similar": 1, "invok": 1, "tripl": 1, "second": 1, "argument": 1, "process": 1, "add_event_processor": 1, "behav": 1, "like": 1, "apply_to_ev": 1, "merg": 1, "clear": 1, "entir": 1, "clear_breadcrumb": 1, "buffer": 1, "arg": 1, "fingerprint": 1, "overrid": 1, "generate_propagation_context": 1, "incoming_data": 1, "make": 1, "sure": 1, "_propagation_context": 1, "overwrit": 1, "do": [1, 3], "NOT": 1, "get_dynamic_sampling_context": 1, "dynam": 1, "sampl": 1, "get_trace_context": 1, "aka": 1, "iter_head": 1, "iter": 1, "0": [1, 3], "remove_context": 1, "remove_extra": 1, "remove_tag": 1, "set_new_propagation_context": 1, "set_transaction_nam": 1, "get": 1, "root": 1, "updat": 1, "attribut": 1, "update_from_scop": 1, "anoth": 1, "favor": 1, "dsn": 1, "max_breadcrumb": 1, "100": 1, "server_nam": 1, "shutdown_timeout": 1, "2": 1, "in_app_includ": 1, "in_app_exclud": 1, "default_integr": 1, "dist": 1, "transport": 1, "transport_queue_s": 1, "sample_r": 1, "send_default_pii": 1, "http_proxi": 1, "https_proxi": 1, "ignore_error": 1, "max_request_body_s": 1, "medium": 1, "socket_opt": 1, "keep_al": 1, "attach_stacktrac": 1, "ca_cert": 1, "propagate_trac": 1, "traces_sample_r": 1, "traces_sampl": 1, "profiles_sample_r": 1, "profiles_sampl": 1, "profiler_mod": 1, "auto_enabling_integr": 1, "auto_session_track": 1, "send_client_report": 1, "_experi": 1, "proxy_head": 1, "before_send_transact": 1, "project_root": 1, "enable_trac": 1, "include_local_vari": 1, "include_source_context": 1, "trace_propagation_target": 1, "functions_to_trac": 1, "event_scrubb": 1, "max_value_length": 1, "1024": 1, "enable_backpressure_handl": 1, "error_sampl": 1, "enable_db_query_sourc": 1, "db_query_source_threshold_m": 1, "spotlight": 1, "_client": 1, "intern": 1, "respons": 1, "forward": 1, "them": 1, "through": 1, "configur": 1, "take": 1, "keyword": 1, "first": 1, "wa": 1, "better": 1, "intelisens": 1, "mai": 1, "reason": 1, "In": 1, "situat": 1, "init": 1, "help": 1, "close": 1, "shut": 1, "down": 1, "same": [1, 3], "semant": 1, "wait": 1, "float": 1, "int": 1, "number": 1, "pend": 1, "baseclass": 1, "capture_envelop": 1, "envelop": 1, "format": 1, "submit": 1, "we": 1, "regular": 1, "go": 1, "backward": 1, "compat": 1, "out": 1, "kill": 1, "forcefulli": 1, "record_lost_ev": 1, "data_categori": 1, "item": 1, "increment": 1, "counter": 1, "loss": 1, "categori": 1, "httptransport": 1, "element": 1, "perform": 1, "containing_transact": 1, "case": 1, "itself": 1, "end_timestamp": 1, "also": 1, "datetim": 1, "timestamp": 1, "associ": 1, "frozen": 1, "multipl": 1, "thei": 1, "follow": 1, "describ": 1, "interfac": 1, "document": [1, 2], "set_http_statu": 1, "http_statu": 1, "statu": 1, "accord": 1, "code": 1, "to_json": 1, "json": 1, "represent": 1, "thu": 1, "form": 1, "so": 1, "could": 1, "think": 1, "classmethod": 1, "continue_from_environ": 1, "param": 1, "pull": 1, "differ": 1, "continue_from_head": 1, "assum": 1, "http_header_nam": 1, "would": [1, 3], "wsgi": 1, "asgi": 1, "rather": 1, "than": 1, "map": 1, "includ": 1, "addition": 1, "databas": 1, "alwai": 1, "match": 1, "from_tracepar": 1, "doesn": 1, "yet": 1, "caus": 1, "store": 1, "new_span": 1, "sub": 1, "initi": 1, "decis": 1, "pointer": 1, "record": [1, 3], "inherit": 1, "to_baggag": 1, "profil": 1, "schedul": 1, "sid": 1, "did": 1, "durat": 1, "user_ag": 1, "ip_address": 1, "to_envelope_item": 1, "scrubber": 1, "eventscrubb": 1, "denylist": 1, "recurs": 1, "scrub_dict": 1, "d": 1, "pass": [1, 3], "scrub": 1, "sensit": 1, "nest": 1, "list": 1, "self": 1, "noth": 1, "scrub_list": 1, "lst": 1, "search": 1, "find": 1, "monitor": 1, "interv": 1, "10": 1, "health": 1, "check": 1, "separ": 1, "onc": 1, "state": 1, "part": 1, "act": 1, "accordingli": 1, "check_health": 1, "actual": 1, "rate": 1, "limit": 1, "todo": 1, "augment": 1, "more": 1, "payload": 1, "get_ev": 1, "api": 2, "full": 2, "resourc": 2, "visit": 2, "github": 2, "repositori": 2, "top": 2, "doc": 2, "tbd": 3, "ignore_logg": 3, "both": 3, "logger": 3, "among": 3, "mani": 3, "our": 3, "prevent": 3, "action": 3, "being": 3, "wai": 3, "quiet": 3, "spammi": 3, "ignor": 3, "getlogg": 3, "eventhandl": 3, "handler": 3, "note": 3, "breadcrumbhandl": 3}, "objects": {"sentry_sdk": [[1, 0, 1, "", "Client"], [1, 0, 1, "", "HttpTransport"], [1, 0, 1, "", "Hub"], [1, 0, 1, "", "Scope"], [1, 0, 1, "", "Transport"]], "sentry_sdk.HttpTransport": [[1, 1, 1, "", "capture_envelope"], [1, 1, 1, "", "capture_event"], [1, 1, 1, "", "flush"], [1, 1, 1, "", "kill"], [1, 1, 1, "", "record_lost_event"]], "sentry_sdk.Hub": [[1, 1, 1, "", "add_breadcrumb"], [1, 1, 1, "", "bind_client"], [1, 1, 1, "", "capture_event"], [1, 1, 1, "", "capture_exception"], [1, 1, 1, "", "capture_message"], [1, 2, 1, "", "client"], [1, 1, 1, "", "configure_scope"], [1, 1, 1, "", "continue_trace"], [1, 1, 1, "", "end_session"], [1, 1, 1, "", "flush"], [1, 1, 1, "", "get_baggage"], [1, 1, 1, "", "get_integration"], [1, 1, 1, "", "get_traceparent"], [1, 1, 1, "", "iter_trace_propagation_headers"], [1, 1, 1, "", "last_event_id"], [1, 1, 1, "", "pop_scope_unsafe"], [1, 1, 1, "", "push_scope"], [1, 1, 1, "", "resume_auto_session_tracking"], [1, 1, 1, "", "run"], [1, 2, 1, "", "scope"], [1, 1, 1, "", "start_session"], [1, 1, 1, "", "start_span"], [1, 1, 1, "", "start_transaction"], [1, 1, 1, "", "stop_auto_session_tracking"], [1, 1, 1, "", "trace_propagation_meta"]], "sentry_sdk.Scope": [[1, 1, 1, "", "add_attachment"], [1, 1, 1, "", "add_breadcrumb"], [1, 1, 1, "", "add_error_processor"], [1, 1, 1, "", "add_event_processor"], [1, 1, 1, "", "apply_to_event"], [1, 1, 1, "", "capture_event"], [1, 1, 1, "", "capture_exception"], [1, 1, 1, "", "capture_message"], [1, 1, 1, "", "clear"], [1, 1, 1, "", "clear_breadcrumbs"], [1, 1, 1, "", "continue_trace"], [1, 1, 1, "", "end_session"], [1, 2, 1, "", "fingerprint"], [1, 1, 1, "", "generate_propagation_context"], [1, 1, 1, "", "get_dynamic_sampling_context"], [1, 1, 1, "", "get_trace_context"], [1, 1, 1, "", "get_traceparent"], [1, 1, 1, "", "iter_headers"], [1, 1, 1, "", "iter_trace_propagation_headers"], [1, 2, 1, "", "level"], [1, 1, 1, "", "remove_context"], [1, 1, 1, "", "remove_extra"], [1, 1, 1, "", "remove_tag"], [1, 1, 1, "", "resume_auto_session_tracking"], [1, 1, 1, "", "set_context"], [1, 1, 1, "", "set_extra"], [1, 1, 1, "", "set_level"], [1, 1, 1, "", "set_new_propagation_context"], [1, 1, 1, "", "set_tag"], [1, 1, 1, "", "set_transaction_name"], [1, 1, 1, "", "set_user"], [1, 2, 1, "", "span"], [1, 1, 1, "", "start_session"], [1, 1, 1, "", "start_span"], [1, 1, 1, "", "start_transaction"], [1, 1, 1, "", "stop_auto_session_tracking"], [1, 1, 1, "", "trace_propagation_meta"], [1, 2, 1, "", "transaction"], [1, 1, 1, "", "update_from_kwargs"], [1, 1, 1, "", "update_from_scope"], [1, 2, 1, "", "user"]], "sentry_sdk.Transport": [[1, 1, 1, "", "capture_envelope"], [1, 1, 1, "", "capture_event"], [1, 1, 1, "", "flush"], [1, 1, 1, "", "kill"], [1, 1, 1, "", "record_lost_event"]], "sentry_sdk.api": [[0, 3, 1, "", "add_breadcrumb"], [0, 3, 1, "", "capture_event"], [0, 3, 1, "", "capture_exception"], [0, 3, 1, "", "capture_message"], [0, 3, 1, "", "configure_scope"], [0, 3, 1, "", "continue_trace"], [0, 3, 1, "", "get_baggage"], [0, 3, 1, "", "get_current_span"], [0, 3, 1, "", "get_traceparent"], [0, 3, 1, "", "push_scope"], [0, 3, 1, "", "set_context"], [0, 3, 1, "", "set_extra"], [0, 3, 1, "", "set_level"], [0, 3, 1, "", "set_tag"], [0, 3, 1, "", "set_user"], [0, 3, 1, "", "start_span"], [0, 3, 1, "", "start_transaction"]], "sentry_sdk.attachments": [[1, 0, 1, "", "Attachment"]], "sentry_sdk.attachments.Attachment": [[1, 1, 1, "", "to_envelope_item"]], "sentry_sdk.client": [[1, 0, 1, "", "_Client"]], "sentry_sdk.client._Client": [[1, 1, 1, "", "capture_event"], [1, 1, 1, "", "close"], [1, 2, 1, "", "dsn"], [1, 1, 1, "", "flush"], [1, 1, 1, "", "get_integration"]], "sentry_sdk.envelope": [[1, 0, 1, "", "Envelope"], [1, 0, 1, "", "Item"]], "sentry_sdk.envelope.Item": [[1, 1, 1, "", "get_event"]], "sentry_sdk.integrations": [[3, 4, 0, "-", "logging"]], "sentry_sdk.integrations.logging": [[3, 0, 1, "", "BreadcrumbHandler"], [3, 0, 1, "", "EventHandler"], [3, 3, 1, "", "ignore_logger"]], "sentry_sdk.monitor": [[1, 0, 1, "", "Monitor"]], "sentry_sdk.monitor.Monitor": [[1, 1, 1, "", "check_health"]], "sentry_sdk.profiler": [[1, 0, 1, "", "Profile"]], "sentry_sdk.scrubber": [[1, 0, 1, "", "EventScrubber"]], "sentry_sdk.scrubber.EventScrubber": [[1, 1, 1, "", "scrub_dict"], [1, 1, 1, "", "scrub_list"]], "sentry_sdk.session": [[1, 0, 1, "", "Session"]], "sentry_sdk.tracing": [[1, 0, 1, "", "Span"], [1, 0, 1, "", "Transaction"]], "sentry_sdk.tracing.Span": [[1, 2, 1, "", "containing_transaction"], [1, 1, 1, "", "continue_from_environ"], [1, 1, 1, "", "continue_from_headers"], [1, 1, 1, "", "finish"], [1, 1, 1, "", "from_traceparent"], [1, 1, 1, "", "iter_headers"], [1, 1, 1, "", "new_span"], [1, 1, 1, "", "start_child"], [1, 5, 1, "", "timestamp"], [1, 1, 1, "", "to_baggage"], [1, 1, 1, "", "to_json"]], "sentry_sdk.tracing.Transaction": [[1, 2, 1, "", "containing_transaction"], [1, 1, 1, "", "finish"], [1, 1, 1, "", "get_baggage"], [1, 1, 1, "", "set_context"], [1, 1, 1, "", "set_http_status"], [1, 1, 1, "", "to_json"]]}, "objtypes": {"0": "py:class", "1": "py:method", "2": "py:property", "3": "py:function", "4": "py:module", "5": "py:attribute"}, "objnames": {"0": ["py", "class", "Python class"], "1": ["py", "method", "Python method"], "2": ["py", "property", "Python property"], "3": ["py", "function", "Python function"], "4": ["py", "module", "Python module"], "5": ["py", "attribute", "Python attribute"]}, "titleterms": {"top": 0, "level": 0, "api": [0, 1], "captur": 0, "data": 0, "enrich": 0, "event": 0, "perform": 0, "monitor": 0, "distribut": 0, "trace": 0, "manag": 0, "scope": 0, "advanc": 0, "doc": 1, "sentri": 2, "python": 2, "sdk": 2, "integr": 3, "log": 3}, "envversion": {"sphinx.domains.c": 3, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 9, "sphinx.domains.index": 1, "sphinx.domains.javascript": 3, "sphinx.domains.math": 2, "sphinx.domains.python": 4, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx.ext.viewcode": 1, "sphinx.ext.intersphinx": 1, "sphinx": 60}, "alltitles": {"Top Level API": [[0, "top-level-api"]], "Capturing Data": [[0, "capturing-data"]], "Enriching Events": [[0, "enriching-events"]], "Performance Monitoring": [[0, "performance-monitoring"]], "Distributed Tracing": [[0, "distributed-tracing"]], "Managing Scope (advanced)": [[0, "managing-scope-advanced"]], "API Docs": [[1, "api-docs"]], "sentry-python - Sentry SDK for Python": [[2, "sentry-python-sentry-sdk-for-python"]], "Integrations": [[3, "integrations"]], "Logging": [[3, "module-sentry_sdk.integrations.logging"]]}, "indexentries": {"add_breadcrumb() (in module sentry_sdk.api)": [[0, "sentry_sdk.api.add_breadcrumb"]], "capture_event() (in module sentry_sdk.api)": [[0, "sentry_sdk.api.capture_event"]], "capture_exception() (in module sentry_sdk.api)": [[0, "sentry_sdk.api.capture_exception"]], "capture_message() (in module sentry_sdk.api)": [[0, "sentry_sdk.api.capture_message"]], "configure_scope() (in module sentry_sdk.api)": [[0, "sentry_sdk.api.configure_scope"]], "continue_trace() (in module sentry_sdk.api)": [[0, "sentry_sdk.api.continue_trace"]], "get_baggage() (in module sentry_sdk.api)": [[0, "sentry_sdk.api.get_baggage"]], "get_current_span() (in module sentry_sdk.api)": [[0, "sentry_sdk.api.get_current_span"]], "get_traceparent() (in module sentry_sdk.api)": [[0, "sentry_sdk.api.get_traceparent"]], "push_scope() (in module sentry_sdk.api)": [[0, "sentry_sdk.api.push_scope"]], "set_context() (in module sentry_sdk.api)": [[0, "sentry_sdk.api.set_context"]], "set_extra() (in module sentry_sdk.api)": [[0, "sentry_sdk.api.set_extra"]], "set_level() (in module sentry_sdk.api)": [[0, "sentry_sdk.api.set_level"]], "set_tag() (in module sentry_sdk.api)": [[0, "sentry_sdk.api.set_tag"]], "set_user() (in module sentry_sdk.api)": [[0, "sentry_sdk.api.set_user"]], "start_span() (in module sentry_sdk.api)": [[0, "sentry_sdk.api.start_span"]], "start_transaction() (in module sentry_sdk.api)": [[0, "sentry_sdk.api.start_transaction"]], "attachment (class in sentry_sdk.attachments)": [[1, "sentry_sdk.attachments.Attachment"]], "client (class in sentry_sdk)": [[1, "sentry_sdk.Client"]], "envelope (class in sentry_sdk.envelope)": [[1, "sentry_sdk.envelope.Envelope"]], "eventscrubber (class in sentry_sdk.scrubber)": [[1, "sentry_sdk.scrubber.EventScrubber"]], "httptransport (class in sentry_sdk)": [[1, "sentry_sdk.HttpTransport"]], "hub (class in sentry_sdk)": [[1, "sentry_sdk.Hub"]], "item (class in sentry_sdk.envelope)": [[1, "sentry_sdk.envelope.Item"]], "monitor (class in sentry_sdk.monitor)": [[1, "sentry_sdk.monitor.Monitor"]], "profile (class in sentry_sdk.profiler)": [[1, "sentry_sdk.profiler.Profile"]], "scope (class in sentry_sdk)": [[1, "sentry_sdk.Scope"]], "session (class in sentry_sdk.session)": [[1, "sentry_sdk.session.Session"]], "span (class in sentry_sdk.tracing)": [[1, "sentry_sdk.tracing.Span"]], "transaction (class in sentry_sdk.tracing)": [[1, "sentry_sdk.tracing.Transaction"]], "transport (class in sentry_sdk)": [[1, "sentry_sdk.Transport"]], "_client (class in sentry_sdk.client)": [[1, "sentry_sdk.client._Client"]], "add_attachment() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.add_attachment"]], "add_breadcrumb() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.add_breadcrumb"]], "add_breadcrumb() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.add_breadcrumb"]], "add_error_processor() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.add_error_processor"]], "add_event_processor() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.add_event_processor"]], "apply_to_event() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.apply_to_event"]], "bind_client() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.bind_client"]], "capture_envelope() (sentry_sdk.httptransport method)": [[1, "sentry_sdk.HttpTransport.capture_envelope"]], "capture_envelope() (sentry_sdk.transport method)": [[1, "sentry_sdk.Transport.capture_envelope"]], "capture_event() (sentry_sdk.httptransport method)": [[1, "sentry_sdk.HttpTransport.capture_event"]], "capture_event() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.capture_event"]], "capture_event() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.capture_event"]], "capture_event() (sentry_sdk.transport method)": [[1, "sentry_sdk.Transport.capture_event"]], "capture_event() (sentry_sdk.client._client method)": [[1, "sentry_sdk.client._Client.capture_event"]], "capture_exception() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.capture_exception"]], "capture_exception() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.capture_exception"]], "capture_message() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.capture_message"]], "capture_message() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.capture_message"]], "check_health() (sentry_sdk.monitor.monitor method)": [[1, "sentry_sdk.monitor.Monitor.check_health"]], "clear() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.clear"]], "clear_breadcrumbs() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.clear_breadcrumbs"]], "client (sentry_sdk.hub property)": [[1, "sentry_sdk.Hub.client"]], "close() (sentry_sdk.client._client method)": [[1, "sentry_sdk.client._Client.close"]], "configure_scope() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.configure_scope"]], "containing_transaction (sentry_sdk.tracing.span property)": [[1, "sentry_sdk.tracing.Span.containing_transaction"]], "containing_transaction (sentry_sdk.tracing.transaction property)": [[1, "sentry_sdk.tracing.Transaction.containing_transaction"]], "continue_from_environ() (sentry_sdk.tracing.span class method)": [[1, "sentry_sdk.tracing.Span.continue_from_environ"]], "continue_from_headers() (sentry_sdk.tracing.span class method)": [[1, "sentry_sdk.tracing.Span.continue_from_headers"]], "continue_trace() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.continue_trace"]], "continue_trace() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.continue_trace"]], "dsn (sentry_sdk.client._client property)": [[1, "sentry_sdk.client._Client.dsn"]], "end_session() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.end_session"]], "end_session() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.end_session"]], "fingerprint (sentry_sdk.scope property)": [[1, "sentry_sdk.Scope.fingerprint"]], "finish() (sentry_sdk.tracing.span method)": [[1, "sentry_sdk.tracing.Span.finish"]], "finish() (sentry_sdk.tracing.transaction method)": [[1, "sentry_sdk.tracing.Transaction.finish"]], "flush() (sentry_sdk.httptransport method)": [[1, "sentry_sdk.HttpTransport.flush"]], "flush() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.flush"]], "flush() (sentry_sdk.transport method)": [[1, "sentry_sdk.Transport.flush"]], "flush() (sentry_sdk.client._client method)": [[1, "sentry_sdk.client._Client.flush"]], "from_traceparent() (sentry_sdk.tracing.span class method)": [[1, "sentry_sdk.tracing.Span.from_traceparent"]], "generate_propagation_context() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.generate_propagation_context"]], "get_baggage() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.get_baggage"]], "get_baggage() (sentry_sdk.tracing.transaction method)": [[1, "sentry_sdk.tracing.Transaction.get_baggage"]], "get_dynamic_sampling_context() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.get_dynamic_sampling_context"]], "get_event() (sentry_sdk.envelope.item method)": [[1, "sentry_sdk.envelope.Item.get_event"]], "get_integration() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.get_integration"]], "get_integration() (sentry_sdk.client._client method)": [[1, "sentry_sdk.client._Client.get_integration"]], "get_trace_context() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.get_trace_context"]], "get_traceparent() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.get_traceparent"]], "get_traceparent() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.get_traceparent"]], "iter_headers() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.iter_headers"]], "iter_headers() (sentry_sdk.tracing.span method)": [[1, "sentry_sdk.tracing.Span.iter_headers"]], "iter_trace_propagation_headers() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.iter_trace_propagation_headers"]], "iter_trace_propagation_headers() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.iter_trace_propagation_headers"]], "kill() (sentry_sdk.httptransport method)": [[1, "sentry_sdk.HttpTransport.kill"]], "kill() (sentry_sdk.transport method)": [[1, "sentry_sdk.Transport.kill"]], "last_event_id() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.last_event_id"]], "level (sentry_sdk.scope property)": [[1, "sentry_sdk.Scope.level"]], "new_span() (sentry_sdk.tracing.span method)": [[1, "sentry_sdk.tracing.Span.new_span"]], "pop_scope_unsafe() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.pop_scope_unsafe"]], "push_scope() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.push_scope"]], "record_lost_event() (sentry_sdk.httptransport method)": [[1, "sentry_sdk.HttpTransport.record_lost_event"]], "record_lost_event() (sentry_sdk.transport method)": [[1, "sentry_sdk.Transport.record_lost_event"]], "remove_context() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.remove_context"]], "remove_extra() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.remove_extra"]], "remove_tag() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.remove_tag"]], "resume_auto_session_tracking() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.resume_auto_session_tracking"]], "resume_auto_session_tracking() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.resume_auto_session_tracking"]], "run() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.run"]], "scope (sentry_sdk.hub property)": [[1, "sentry_sdk.Hub.scope"]], "scrub_dict() (sentry_sdk.scrubber.eventscrubber method)": [[1, "sentry_sdk.scrubber.EventScrubber.scrub_dict"]], "scrub_list() (sentry_sdk.scrubber.eventscrubber method)": [[1, "sentry_sdk.scrubber.EventScrubber.scrub_list"]], "set_context() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.set_context"]], "set_context() (sentry_sdk.tracing.transaction method)": [[1, "sentry_sdk.tracing.Transaction.set_context"]], "set_extra() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.set_extra"]], "set_http_status() (sentry_sdk.tracing.transaction method)": [[1, "sentry_sdk.tracing.Transaction.set_http_status"]], "set_level() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.set_level"]], "set_new_propagation_context() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.set_new_propagation_context"]], "set_tag() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.set_tag"]], "set_transaction_name() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.set_transaction_name"]], "set_user() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.set_user"]], "span (sentry_sdk.scope property)": [[1, "sentry_sdk.Scope.span"]], "start_child() (sentry_sdk.tracing.span method)": [[1, "sentry_sdk.tracing.Span.start_child"]], "start_session() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.start_session"]], "start_session() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.start_session"]], "start_span() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.start_span"]], "start_span() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.start_span"]], "start_transaction() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.start_transaction"]], "start_transaction() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.start_transaction"]], "stop_auto_session_tracking() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.stop_auto_session_tracking"]], "stop_auto_session_tracking() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.stop_auto_session_tracking"]], "timestamp (sentry_sdk.tracing.span attribute)": [[1, "sentry_sdk.tracing.Span.timestamp"]], "to_baggage() (sentry_sdk.tracing.span method)": [[1, "sentry_sdk.tracing.Span.to_baggage"]], "to_envelope_item() (sentry_sdk.attachments.attachment method)": [[1, "sentry_sdk.attachments.Attachment.to_envelope_item"]], "to_json() (sentry_sdk.tracing.span method)": [[1, "sentry_sdk.tracing.Span.to_json"]], "to_json() (sentry_sdk.tracing.transaction method)": [[1, "sentry_sdk.tracing.Transaction.to_json"]], "trace_propagation_meta() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.trace_propagation_meta"]], "trace_propagation_meta() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.trace_propagation_meta"]], "transaction (sentry_sdk.scope property)": [[1, "sentry_sdk.Scope.transaction"]], "update_from_kwargs() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.update_from_kwargs"]], "update_from_scope() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.update_from_scope"]], "user (sentry_sdk.scope property)": [[1, "sentry_sdk.Scope.user"]], "breadcrumbhandler (class in sentry_sdk.integrations.logging)": [[3, "sentry_sdk.integrations.logging.BreadcrumbHandler"]], "eventhandler (class in sentry_sdk.integrations.logging)": [[3, "sentry_sdk.integrations.logging.EventHandler"]], "ignore_logger() (in module sentry_sdk.integrations.logging)": [[3, "sentry_sdk.integrations.logging.ignore_logger"]], "module": [[3, "module-sentry_sdk.integrations.logging"]], "sentry_sdk.integrations.logging": [[3, "module-sentry_sdk.integrations.logging"]]}})
\ No newline at end of file
+Search.setIndex({"docnames": ["api", "apidocs", "index", "integrations"], "filenames": ["api.rst", "apidocs.rst", "index.rst", "integrations.rst"], "titles": ["Top Level API", "API Docs", "sentry-python - Sentry SDK for Python", "Integrations"], "terms": {"thi": [0, 1, 2, 3], "i": [0, 1, 2, 3], "user": [0, 1, 3], "face": 0, "sdk": [0, 1], "It": [0, 1], "": [0, 1, 2], "expos": [0, 3], "sentry_sdk": [0, 1, 3], "With": 0, "you": [0, 1, 3], "can": [0, 1], "implement": [0, 1], "custom": [0, 1], "error": [0, 1], "report": 0, "solut": 0, "capture_ev": [0, 1], "hint": [0, 1], "none": [0, 1, 3], "scope_kwarg": [0, 1], "sourc": [0, 1, 3], "alia": [0, 1], "an": [0, 1], "merg": [0, 1], "given": [0, 1], "call": [0, 1, 3], "_client": [0, 1], "paramet": [0, 1, 3], "A": [0, 1, 3], "readi": [0, 1], "made": [0, 1], "directli": [0, 1], "sent": [0, 1], "sentri": [0, 1, 3], "option": [0, 1], "dict": [0, 1], "str": [0, 1, 3], "ani": [0, 1], "contain": [0, 1], "metadata": [0, 1], "about": [0, 1], "read": [0, 1], "from": [0, 1], "before_send": [0, 1], "origin": [0, 1], "except": [0, 1], "object": [0, 1], "http": [0, 1], "request": [0, 1], "appli": [0, 1], "The": [0, 1, 3], "ar": [0, 1], "mutual": [0, 1], "exclus": [0, 1], "For": [0, 1, 2], "support": [0, 1], "see": [0, 1], "update_from_kwarg": [0, 1], "return": [0, 1, 3], "type": [0, 1, 3], "event_id": [0, 1], "decid": [0, 1], "send": [0, 1], "capture_except": [0, 1], "union": [0, 1], "baseexcept": [0, 1], "tupl": [0, 1], "tracebacktyp": [0, 1], "If": [0, 1], "sy": [0, 1], "exc_info": [0, 1], "us": [0, 1, 3], "capture_messag": [0, 1], "messag": [0, 1], "string": [0, 1, 3], "liter": [0, 1], "fatal": [0, 1], "critic": [0, 1], "warn": [0, 1], "info": [0, 1], "debug": [0, 1], "provid": [0, 1], "default": [0, 1, 3], "add_breadcrumb": [0, 1], "crumb": [0, 1], "kwarg": [0, 1], "add": [0, 1], "breadcrumb": [0, 1, 3], "dictionari": [0, 1], "v7": [0, 1], "v8": [0, 1], "protocol": [0, 1], "expect": [0, 1], "valu": [0, 1], "before_breadcrumb": [0, 1], "emit": [0, 1, 3], "set_context": [0, 1], "kei": [0, 1], "bind": [0, 1], "context": [0, 1], "certain": [0, 1], "specif": [0, 1, 3], "set_extra": [0, 1], "set": [0, 1], "extra": [0, 1], "set_level": [0, 1], "set_tag": [0, 1], "tag": [0, 1], "set_us": [0, 1], "continue_trac": [0, 1], "environ_or_head": [0, 1], "op": [0, 1], "name": [0, 1, 3], "propag": [0, 1], "environ": [0, 1], "header": [0, 1], "transact": [0, 1], "get_current_span": 0, "current": [0, 1], "activ": [0, 1], "span": [0, 1], "one": [0, 1], "run": [0, 1], "otherwis": [0, 1], "start_span": [0, 1], "start": [0, 1], "whose": [0, 1], "parent": [0, 1], "instanc": [0, 1], "typic": [0, 1], "stop": [0, 1], "time": [0, 1], "block": [0, 1], "onli": [0, 1], "most": [0, 1], "integr": [0, 1, 2], "appropri": [0, 1], "exampl": [0, 1], "everi": [0, 1], "incom": [0, 1], "start_transact": [0, 1], "new": [0, 1], "when": [0, 1], "alreadi": [0, 1], "progress": [0, 1], "instrument": [0, 1], "custom_sampling_context": [0, 1], "exist": [0, 1], "creat": [0, 1], "entri": [0, 1], "point": [0, 1], "manual": [0, 1], "tree": [0, 1], "structur": [0, 1], "built": [0, 1], "ad": [0, 1], "child": [0, 1], "other": [0, 1, 2, 3], "To": [0, 1], "within": [0, 1], "respect": [0, 1], "start_child": [0, 1], "method": [0, 1], "must": [0, 1], "finish": [0, 1], "befor": [0, 1], "unfinish": [0, 1], "discard": [0, 1], "automat": [0, 1], "end": [0, 1], "all": [0, 1], "its": [0, 1], "omit": [0, 1], "we": [0, 1], "meant": [0, 1], "intern": [0, 1], "sampl": [0, 1], "unpack": [0, 1], "transactionkwarg": [0, 1], "keyword": [0, 1], "argument": [0, 1], "pass": [0, 1, 3], "constructor": [0, 1], "avail": [0, 1], "noopspan": [0, 1], "get_baggag": [0, 1], "baggag": [0, 1], "either": [0, 1], "get_tracepar": [0, 1], "tracepar": [0, 1], "is_initi": 0, "version": [0, 1], "2": [0, 1], "0": [0, 1, 3], "whether": [0, 1], "ha": [0, 1], "been": 0, "initi": [0, 1], "mean": 0, "configur": [0, 1], "rtype": [0, 1], "bool": [0, 1], "get_client": [0, 1], "basecli": [0, 1], "check": [0, 1], "isol": [0, 1], "global": [0, 1], "nonrecordingcli": [0, 1], "configure_scop": [0, 1], "callback": [0, 1], "reconfigur": [0, 1], "callabl": [0, 1], "contextmanag": [0, 1], "push_scop": [0, 1], "push": [0, 1], "layer": [0, 1], "stack": [0, 1], "pop": [0, 1], "again": [0, 1], "should": [0, 1], "new_scop": 0, "fork": [0, 1], "wrap": [0, 1], "code": [0, 1], "after": 0, "execut": [0, 1], "restor": 0, "usag": 0, "import": 0, "color": 0, "green": 0, "hello": 0, "includ": [0, 1], "NOT": [0, 1], "gener": [0, 1], "class": [1, 3], "hub": 1, "client_or_hub": 1, "scope": 1, "deprec": 1, "sinc": 1, "Its": 1, "function": 1, "concurr": 1, "manag": 1, "each": [1, 3], "thread": 1, "own": 1, "might": 1, "transfer": 1, "flow": 1, "var": 1, "statement": 1, "temporarili": 1, "remov": 1, "futur": 1, "releas": 1, "pleas": 1, "instead": 1, "data": 1, "bind_client": 1, "set_client": 1, "client": 1, "event": [1, 3], "captur": 1, "level": [1, 2, 3], "properti": 1, "true": 1, "end_sess": 1, "session": 1, "flush": 1, "timeout": 1, "get_integr": 1, "name_or_class": 1, "bound": 1, "doe": 1, "have": [1, 3], "guarante": 1, "attach": 1, "iter_trace_propagation_head": 1, "which": [1, 3], "allow": 1, "trace": 1, "taken": 1, "repres": 1, "last_event_id": 1, "last": 1, "id": 1, "1": 1, "40": 1, "5": 1, "pop_scope_unsaf": 1, "try": 1, "resume_auto_session_track": 1, "resum": 1, "track": 1, "disabl": [1, 3], "earlier": 1, "requir": 1, "enabl": [1, 3], "altern": 1, "typevar": 1, "t": 1, "start_sess": 1, "session_mod": 1, "applic": 1, "stop_auto_session_track": 1, "trace_propagation_meta": 1, "meta": 1, "inject": 1, "html": 1, "templat": 1, "inform": 1, "ty": 1, "hold": 1, "belong": 1, "add_attach": 1, "byte": 1, "filenam": 1, "path": 1, "content_typ": 1, "add_to_transact": 1, "fals": 1, "add_error_processor": 1, "func": 1, "cl": 1, "regist": 1, "local": 1, "processor": 1, "work": 1, "similar": 1, "invok": 1, "tripl": 1, "second": 1, "process": 1, "add_event_processor": 1, "behav": 1, "like": 1, "apply_to_ev": 1, "clear": 1, "entir": 1, "clear_breadcrumb": 1, "buffer": 1, "arg": 1, "fingerprint": 1, "overrid": 1, "generate_propagation_context": 1, "incoming_data": 1, "make": 1, "sure": 1, "_propagation_context": 1, "live": 1, "overwrit": 1, "do": [1, 3], "classmethod": 1, "get_current_scop": 1, "get_dynamic_sampling_context": 1, "dynam": 1, "get_global_scop": 1, "get_isolation_scop": 1, "get_trace_context": 1, "aka": 1, "iter_head": 1, "iter": 1, "remove_context": 1, "remove_extra": 1, "remove_tag": 1, "run_error_processor": 1, "modifi": 1, "run_event_processor": 1, "replac": 1, "set_current_scop": 1, "new_current_scop": 1, "param": 1, "set_isolation_scop": 1, "new_isolation_scop": 1, "set_new_propagation_context": 1, "set_transaction_nam": 1, "get": 1, "root": 1, "updat": 1, "attribut": 1, "update_from_scop": 1, "anoth": 1, "favor": 1, "dsn": 1, "max_breadcrumb": 1, "100": 1, "server_nam": 1, "shutdown_timeout": 1, "in_app_includ": 1, "in_app_exclud": 1, "default_integr": 1, "dist": 1, "transport": 1, "transport_queue_s": 1, "sample_r": 1, "send_default_pii": 1, "http_proxi": 1, "https_proxi": 1, "ignore_error": 1, "max_request_body_s": 1, "medium": 1, "socket_opt": 1, "keep_al": 1, "attach_stacktrac": 1, "ca_cert": 1, "propagate_trac": 1, "traces_sample_r": 1, "traces_sampl": 1, "profiles_sample_r": 1, "profiles_sampl": 1, "profiler_mod": 1, "auto_enabling_integr": 1, "auto_session_track": 1, "send_client_report": 1, "_experi": 1, "proxy_head": 1, "before_send_transact": 1, "project_root": 1, "enable_trac": 1, "include_local_vari": 1, "include_source_context": 1, "trace_propagation_target": 1, "functions_to_trac": 1, "event_scrubb": 1, "max_value_length": 1, "1024": 1, "enable_backpressure_handl": 1, "error_sampl": 1, "enable_db_query_sourc": 1, "db_query_source_threshold_m": 1, "spotlight": 1, "basic": 1, "definit": 1, "is_act": 1, "abl": 1, "fallback": 1, "yet": 1, "respons": 1, "forward": 1, "them": 1, "through": 1, "take": 1, "first": 1, "wa": 1, "better": 1, "intelisens": 1, "mai": 1, "reason": 1, "In": 1, "situat": 1, "init": 1, "help": 1, "close": 1, "shut": 1, "down": 1, "same": [1, 3], "semant": 1, "wait": 1, "float": 1, "int": 1, "number": 1, "pend": 1, "should_send_default_pii": 1, "pii": 1, "person": 1, "identifi": 1, "baseclass": 1, "abstract": 1, "capture_envelop": 1, "envelop": 1, "format": 1, "submit": 1, "cron": 1, "checkin": 1, "etc": 1, "out": 1, "relev": 1, "some": 1, "subclass": 1, "necessari": 1, "kill": 1, "forcefulli": 1, "record_lost_ev": 1, "data_categori": 1, "item": 1, "increment": 1, "counter": 1, "loss": 1, "categori": 1, "httptransport": 1, "parent_sampl": 1, "element": 1, "perform": 1, "Will": 1, "show": 1, "up": 1, "ui": 1, "kept": 1, "w3c": 1, "www": 1, "w3": 1, "org": 1, "tr": 1, "describ": 1, "determin": 1, "develop": 1, "dev": 1, "payload": 1, "annot": 1, "more": 1, "spankwarg": 1, "addit": 1, "containing_transact": 1, "case": 1, "itself": 1, "end_timestamp": 1, "also": 1, "datetim": 1, "timestamp": 1, "associ": 1, "frozen": 1, "multipl": 1, "thei": 1, "follow": 1, "interfac": 1, "document": [1, 2], "set_http_statu": 1, "http_statu": 1, "statu": 1, "accord": 1, "to_json": 1, "json": 1, "compat": 1, "represent": 1, "trace_id": 1, "span_id": 1, "parent_span_id": 1, "same_process_as_par": 1, "descript": 1, "start_timestamp": 1, "thu": 1, "form": 1, "decis": 1, "oper": 1, "list": 1, "recommend": 1, "here": 1, "what": 1, "being": [1, 3], "possibl": 1, "so": 1, "could": 1, "think": 1, "continue_from_environ": 1, "pull": 1, "differ": 1, "continue_from_head": 1, "assum": 1, "http_header_nam": 1, "would": [1, 3], "wsgi": 1, "asgi": 1, "rather": 1, "than": 1, "map": 1, "addition": 1, "databas": 1, "alwai": 1, "match": 1, "from_tracepar": 1, "doesn": 1, "caus": 1, "store": 1, "sub": 1, "pointer": 1, "record": [1, 3], "inherit": 1, "to_baggag": 1, "profil": 1, "schedul": 1, "sid": 1, "did": 1, "durat": 1, "user_ag": 1, "ip_address": 1, "to_envelope_item": 1, "scrubber": 1, "eventscrubb": 1, "denylist": 1, "recurs": 1, "scrub_dict": 1, "d": 1, "scrub": 1, "sensit": 1, "nest": 1, "self": 1, "noth": 1, "scrub_list": 1, "lst": 1, "search": 1, "find": 1, "monitor": 1, "interv": 1, "10": 1, "health": 1, "separ": 1, "onc": 1, "state": 1, "part": 1, "act": 1, "accordingli": 1, "check_health": 1, "actual": 1, "rate": 1, "limit": 1, "todo": 1, "augment": 1, "adher": 1, "constraint": 1, "model": 1, "particular": 1, "both": [1, 3], "get_ev": 1, "api": 2, "full": 2, "resourc": 2, "visit": 2, "github": 2, "repositori": 2, "top": 2, "doc": 2, "tbd": 3, "ignore_logg": 3, "logger": 3, "among": 3, "mani": 3, "our": 3, "prevent": 3, "action": 3, "wai": 3, "quiet": 3, "spammi": 3, "ignor": 3, "getlogg": 3, "eventhandl": 3, "handler": 3, "note": 3, "breadcrumbhandl": 3}, "objects": {"sentry_sdk": [[1, 0, 1, "", "Client"], [1, 0, 1, "", "HttpTransport"], [1, 0, 1, "", "Hub"], [1, 0, 1, "", "Scope"], [1, 0, 1, "", "Transport"]], "sentry_sdk.HttpTransport": [[1, 1, 1, "", "capture_envelope"], [1, 1, 1, "", "flush"], [1, 1, 1, "", "kill"], [1, 1, 1, "", "record_lost_event"]], "sentry_sdk.Hub": [[1, 1, 1, "", "add_breadcrumb"], [1, 1, 1, "", "bind_client"], [1, 1, 1, "", "capture_event"], [1, 1, 1, "", "capture_exception"], [1, 1, 1, "", "capture_message"], [1, 2, 1, "", "client"], [1, 1, 1, "", "configure_scope"], [1, 1, 1, "", "continue_trace"], [1, 1, 1, "", "end_session"], [1, 1, 1, "", "flush"], [1, 1, 1, "", "get_baggage"], [1, 1, 1, "", "get_integration"], [1, 1, 1, "", "get_traceparent"], [1, 1, 1, "", "iter_trace_propagation_headers"], [1, 1, 1, "", "last_event_id"], [1, 1, 1, "", "pop_scope_unsafe"], [1, 1, 1, "", "push_scope"], [1, 1, 1, "", "resume_auto_session_tracking"], [1, 1, 1, "", "run"], [1, 2, 1, "", "scope"], [1, 1, 1, "", "start_session"], [1, 1, 1, "", "start_span"], [1, 1, 1, "", "start_transaction"], [1, 1, 1, "", "stop_auto_session_tracking"], [1, 1, 1, "", "trace_propagation_meta"]], "sentry_sdk.Scope": [[1, 1, 1, "", "add_attachment"], [1, 1, 1, "", "add_breadcrumb"], [1, 1, 1, "", "add_error_processor"], [1, 1, 1, "", "add_event_processor"], [1, 1, 1, "", "apply_to_event"], [1, 1, 1, "", "capture_event"], [1, 1, 1, "", "capture_exception"], [1, 1, 1, "", "capture_message"], [1, 1, 1, "", "clear"], [1, 1, 1, "", "clear_breadcrumbs"], [1, 1, 1, "", "continue_trace"], [1, 1, 1, "", "end_session"], [1, 2, 1, "", "fingerprint"], [1, 1, 1, "", "fork"], [1, 1, 1, "", "generate_propagation_context"], [1, 1, 1, "", "get_baggage"], [1, 1, 1, "", "get_client"], [1, 1, 1, "", "get_current_scope"], [1, 1, 1, "", "get_dynamic_sampling_context"], [1, 1, 1, "", "get_global_scope"], [1, 1, 1, "", "get_isolation_scope"], [1, 1, 1, "", "get_trace_context"], [1, 1, 1, "", "get_traceparent"], [1, 1, 1, "", "iter_headers"], [1, 1, 1, "", "iter_trace_propagation_headers"], [1, 2, 1, "", "level"], [1, 1, 1, "", "remove_context"], [1, 1, 1, "", "remove_extra"], [1, 1, 1, "", "remove_tag"], [1, 1, 1, "", "resume_auto_session_tracking"], [1, 1, 1, "", "run_error_processors"], [1, 1, 1, "", "run_event_processors"], [1, 1, 1, "", "set_client"], [1, 1, 1, "", "set_context"], [1, 1, 1, "", "set_current_scope"], [1, 1, 1, "", "set_extra"], [1, 1, 1, "", "set_isolation_scope"], [1, 1, 1, "", "set_level"], [1, 1, 1, "", "set_new_propagation_context"], [1, 1, 1, "", "set_tag"], [1, 1, 1, "", "set_transaction_name"], [1, 1, 1, "", "set_user"], [1, 2, 1, "", "span"], [1, 1, 1, "", "start_session"], [1, 1, 1, "", "start_span"], [1, 1, 1, "", "start_transaction"], [1, 1, 1, "", "stop_auto_session_tracking"], [1, 1, 1, "", "trace_propagation_meta"], [1, 2, 1, "", "transaction"], [1, 1, 1, "", "update_from_kwargs"], [1, 1, 1, "", "update_from_scope"], [1, 2, 1, "", "user"]], "sentry_sdk.Transport": [[1, 1, 1, "", "capture_envelope"], [1, 1, 1, "", "capture_event"], [1, 1, 1, "", "flush"], [1, 1, 1, "", "kill"], [1, 1, 1, "", "record_lost_event"]], "sentry_sdk.api": [[0, 3, 1, "", "add_breadcrumb"], [0, 3, 1, "", "capture_event"], [0, 3, 1, "", "capture_exception"], [0, 3, 1, "", "capture_message"], [0, 3, 1, "", "configure_scope"], [0, 3, 1, "", "continue_trace"], [0, 3, 1, "", "get_baggage"], [0, 3, 1, "", "get_client"], [0, 3, 1, "", "get_current_span"], [0, 3, 1, "", "get_traceparent"], [0, 3, 1, "", "is_initialized"], [0, 3, 1, "", "new_scope"], [0, 3, 1, "", "push_scope"], [0, 3, 1, "", "set_context"], [0, 3, 1, "", "set_extra"], [0, 3, 1, "", "set_level"], [0, 3, 1, "", "set_tag"], [0, 3, 1, "", "set_user"], [0, 3, 1, "", "start_span"], [0, 3, 1, "", "start_transaction"]], "sentry_sdk.attachments": [[1, 0, 1, "", "Attachment"]], "sentry_sdk.attachments.Attachment": [[1, 1, 1, "", "to_envelope_item"]], "sentry_sdk.client": [[1, 0, 1, "", "BaseClient"], [1, 0, 1, "", "NonRecordingClient"], [1, 0, 1, "", "_Client"]], "sentry_sdk.client.BaseClient": [[1, 1, 1, "", "is_active"]], "sentry_sdk.client._Client": [[1, 1, 1, "", "capture_event"], [1, 1, 1, "", "close"], [1, 2, 1, "", "dsn"], [1, 1, 1, "", "flush"], [1, 1, 1, "", "get_integration"], [1, 1, 1, "", "is_active"], [1, 1, 1, "", "should_send_default_pii"]], "sentry_sdk.envelope": [[1, 0, 1, "", "Envelope"], [1, 0, 1, "", "Item"]], "sentry_sdk.envelope.Item": [[1, 1, 1, "", "get_event"]], "sentry_sdk.integrations": [[3, 4, 0, "-", "logging"]], "sentry_sdk.integrations.logging": [[3, 0, 1, "", "BreadcrumbHandler"], [3, 0, 1, "", "EventHandler"], [3, 3, 1, "", "ignore_logger"]], "sentry_sdk.monitor": [[1, 0, 1, "", "Monitor"]], "sentry_sdk.monitor.Monitor": [[1, 1, 1, "", "check_health"]], "sentry_sdk.profiler": [[1, 0, 1, "", "Profile"]], "sentry_sdk.scrubber": [[1, 0, 1, "", "EventScrubber"]], "sentry_sdk.scrubber.EventScrubber": [[1, 1, 1, "", "scrub_dict"], [1, 1, 1, "", "scrub_list"]], "sentry_sdk.session": [[1, 0, 1, "", "Session"]], "sentry_sdk.tracing": [[1, 0, 1, "", "Span"], [1, 0, 1, "", "Transaction"]], "sentry_sdk.tracing.Span": [[1, 2, 1, "", "containing_transaction"], [1, 1, 1, "", "continue_from_environ"], [1, 1, 1, "", "continue_from_headers"], [1, 1, 1, "", "finish"], [1, 1, 1, "", "from_traceparent"], [1, 1, 1, "", "iter_headers"], [1, 1, 1, "", "start_child"], [1, 5, 1, "", "timestamp"], [1, 1, 1, "", "to_baggage"], [1, 1, 1, "", "to_json"]], "sentry_sdk.tracing.Transaction": [[1, 2, 1, "", "containing_transaction"], [1, 1, 1, "", "finish"], [1, 1, 1, "", "get_baggage"], [1, 1, 1, "", "set_context"], [1, 1, 1, "", "set_http_status"], [1, 1, 1, "", "to_json"]]}, "objtypes": {"0": "py:class", "1": "py:method", "2": "py:property", "3": "py:function", "4": "py:module", "5": "py:attribute"}, "objnames": {"0": ["py", "class", "Python class"], "1": ["py", "method", "Python method"], "2": ["py", "property", "Python property"], "3": ["py", "function", "Python function"], "4": ["py", "module", "Python module"], "5": ["py", "attribute", "Python attribute"]}, "titleterms": {"top": 0, "level": 0, "api": [0, 1], "captur": 0, "data": 0, "enrich": 0, "event": 0, "perform": 0, "monitor": 0, "distribut": 0, "trace": 0, "client": 0, "manag": 0, "scope": 0, "advanc": 0, "doc": 1, "sentri": 2, "python": 2, "sdk": 2, "integr": 3, "log": 3}, "envversion": {"sphinx.domains.c": 3, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 9, "sphinx.domains.index": 1, "sphinx.domains.javascript": 3, "sphinx.domains.math": 2, "sphinx.domains.python": 4, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx.ext.viewcode": 1, "sphinx.ext.intersphinx": 1, "sphinx": 60}, "alltitles": {"Top Level API": [[0, "top-level-api"]], "Capturing Data": [[0, "capturing-data"]], "Enriching Events": [[0, "enriching-events"]], "Performance Monitoring": [[0, "performance-monitoring"]], "Distributed Tracing": [[0, "distributed-tracing"]], "Client Management": [[0, "client-management"]], "Managing Scope (advanced)": [[0, "managing-scope-advanced"]], "API Docs": [[1, "api-docs"]], "sentry-python - Sentry SDK for Python": [[2, "sentry-python-sentry-sdk-for-python"]], "Integrations": [[3, "integrations"]], "Logging": [[3, "module-sentry_sdk.integrations.logging"]]}, "indexentries": {"add_breadcrumb() (in module sentry_sdk.api)": [[0, "sentry_sdk.api.add_breadcrumb"]], "capture_event() (in module sentry_sdk.api)": [[0, "sentry_sdk.api.capture_event"]], "capture_exception() (in module sentry_sdk.api)": [[0, "sentry_sdk.api.capture_exception"]], "capture_message() (in module sentry_sdk.api)": [[0, "sentry_sdk.api.capture_message"]], "configure_scope() (in module sentry_sdk.api)": [[0, "sentry_sdk.api.configure_scope"]], "continue_trace() (in module sentry_sdk.api)": [[0, "sentry_sdk.api.continue_trace"]], "get_baggage() (in module sentry_sdk.api)": [[0, "sentry_sdk.api.get_baggage"]], "get_client() (in module sentry_sdk.api)": [[0, "sentry_sdk.api.get_client"]], "get_current_span() (in module sentry_sdk.api)": [[0, "sentry_sdk.api.get_current_span"]], "get_traceparent() (in module sentry_sdk.api)": [[0, "sentry_sdk.api.get_traceparent"]], "is_initialized() (in module sentry_sdk.api)": [[0, "sentry_sdk.api.is_initialized"]], "new_scope() (in module sentry_sdk.api)": [[0, "sentry_sdk.api.new_scope"]], "push_scope() (in module sentry_sdk.api)": [[0, "sentry_sdk.api.push_scope"]], "set_context() (in module sentry_sdk.api)": [[0, "sentry_sdk.api.set_context"]], "set_extra() (in module sentry_sdk.api)": [[0, "sentry_sdk.api.set_extra"]], "set_level() (in module sentry_sdk.api)": [[0, "sentry_sdk.api.set_level"]], "set_tag() (in module sentry_sdk.api)": [[0, "sentry_sdk.api.set_tag"]], "set_user() (in module sentry_sdk.api)": [[0, "sentry_sdk.api.set_user"]], "start_span() (in module sentry_sdk.api)": [[0, "sentry_sdk.api.start_span"]], "start_transaction() (in module sentry_sdk.api)": [[0, "sentry_sdk.api.start_transaction"]], "attachment (class in sentry_sdk.attachments)": [[1, "sentry_sdk.attachments.Attachment"]], "baseclient (class in sentry_sdk.client)": [[1, "sentry_sdk.client.BaseClient"]], "client (class in sentry_sdk)": [[1, "sentry_sdk.Client"]], "envelope (class in sentry_sdk.envelope)": [[1, "sentry_sdk.envelope.Envelope"]], "eventscrubber (class in sentry_sdk.scrubber)": [[1, "sentry_sdk.scrubber.EventScrubber"]], "httptransport (class in sentry_sdk)": [[1, "sentry_sdk.HttpTransport"]], "hub (class in sentry_sdk)": [[1, "sentry_sdk.Hub"]], "item (class in sentry_sdk.envelope)": [[1, "sentry_sdk.envelope.Item"]], "monitor (class in sentry_sdk.monitor)": [[1, "sentry_sdk.monitor.Monitor"]], "nonrecordingclient (class in sentry_sdk.client)": [[1, "sentry_sdk.client.NonRecordingClient"]], "profile (class in sentry_sdk.profiler)": [[1, "sentry_sdk.profiler.Profile"]], "scope (class in sentry_sdk)": [[1, "sentry_sdk.Scope"]], "session (class in sentry_sdk.session)": [[1, "sentry_sdk.session.Session"]], "span (class in sentry_sdk.tracing)": [[1, "sentry_sdk.tracing.Span"]], "transaction (class in sentry_sdk.tracing)": [[1, "sentry_sdk.tracing.Transaction"]], "transport (class in sentry_sdk)": [[1, "sentry_sdk.Transport"]], "_client (class in sentry_sdk.client)": [[1, "sentry_sdk.client._Client"]], "add_attachment() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.add_attachment"]], "add_breadcrumb() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.add_breadcrumb"]], "add_breadcrumb() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.add_breadcrumb"]], "add_error_processor() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.add_error_processor"]], "add_event_processor() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.add_event_processor"]], "apply_to_event() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.apply_to_event"]], "bind_client() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.bind_client"]], "capture_envelope() (sentry_sdk.httptransport method)": [[1, "sentry_sdk.HttpTransport.capture_envelope"]], "capture_envelope() (sentry_sdk.transport method)": [[1, "sentry_sdk.Transport.capture_envelope"]], "capture_event() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.capture_event"]], "capture_event() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.capture_event"]], "capture_event() (sentry_sdk.transport method)": [[1, "sentry_sdk.Transport.capture_event"]], "capture_event() (sentry_sdk.client._client method)": [[1, "sentry_sdk.client._Client.capture_event"]], "capture_exception() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.capture_exception"]], "capture_exception() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.capture_exception"]], "capture_message() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.capture_message"]], "capture_message() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.capture_message"]], "check_health() (sentry_sdk.monitor.monitor method)": [[1, "sentry_sdk.monitor.Monitor.check_health"]], "clear() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.clear"]], "clear_breadcrumbs() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.clear_breadcrumbs"]], "client (sentry_sdk.hub property)": [[1, "sentry_sdk.Hub.client"]], "close() (sentry_sdk.client._client method)": [[1, "sentry_sdk.client._Client.close"]], "configure_scope() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.configure_scope"]], "containing_transaction (sentry_sdk.tracing.span property)": [[1, "sentry_sdk.tracing.Span.containing_transaction"]], "containing_transaction (sentry_sdk.tracing.transaction property)": [[1, "sentry_sdk.tracing.Transaction.containing_transaction"]], "continue_from_environ() (sentry_sdk.tracing.span class method)": [[1, "sentry_sdk.tracing.Span.continue_from_environ"]], "continue_from_headers() (sentry_sdk.tracing.span class method)": [[1, "sentry_sdk.tracing.Span.continue_from_headers"]], "continue_trace() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.continue_trace"]], "continue_trace() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.continue_trace"]], "dsn (sentry_sdk.client._client property)": [[1, "sentry_sdk.client._Client.dsn"]], "end_session() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.end_session"]], "end_session() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.end_session"]], "fingerprint (sentry_sdk.scope property)": [[1, "sentry_sdk.Scope.fingerprint"]], "finish() (sentry_sdk.tracing.span method)": [[1, "sentry_sdk.tracing.Span.finish"]], "finish() (sentry_sdk.tracing.transaction method)": [[1, "sentry_sdk.tracing.Transaction.finish"]], "flush() (sentry_sdk.httptransport method)": [[1, "sentry_sdk.HttpTransport.flush"]], "flush() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.flush"]], "flush() (sentry_sdk.transport method)": [[1, "sentry_sdk.Transport.flush"]], "flush() (sentry_sdk.client._client method)": [[1, "sentry_sdk.client._Client.flush"]], "fork() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.fork"]], "from_traceparent() (sentry_sdk.tracing.span class method)": [[1, "sentry_sdk.tracing.Span.from_traceparent"]], "generate_propagation_context() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.generate_propagation_context"]], "get_baggage() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.get_baggage"]], "get_baggage() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.get_baggage"]], "get_baggage() (sentry_sdk.tracing.transaction method)": [[1, "sentry_sdk.tracing.Transaction.get_baggage"]], "get_client() (sentry_sdk.scope class method)": [[1, "sentry_sdk.Scope.get_client"]], "get_current_scope() (sentry_sdk.scope class method)": [[1, "sentry_sdk.Scope.get_current_scope"]], "get_dynamic_sampling_context() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.get_dynamic_sampling_context"]], "get_event() (sentry_sdk.envelope.item method)": [[1, "sentry_sdk.envelope.Item.get_event"]], "get_global_scope() (sentry_sdk.scope class method)": [[1, "sentry_sdk.Scope.get_global_scope"]], "get_integration() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.get_integration"]], "get_integration() (sentry_sdk.client._client method)": [[1, "sentry_sdk.client._Client.get_integration"]], "get_isolation_scope() (sentry_sdk.scope class method)": [[1, "sentry_sdk.Scope.get_isolation_scope"]], "get_trace_context() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.get_trace_context"]], "get_traceparent() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.get_traceparent"]], "get_traceparent() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.get_traceparent"]], "is_active() (sentry_sdk.client.baseclient method)": [[1, "sentry_sdk.client.BaseClient.is_active"]], "is_active() (sentry_sdk.client._client method)": [[1, "sentry_sdk.client._Client.is_active"]], "iter_headers() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.iter_headers"]], "iter_headers() (sentry_sdk.tracing.span method)": [[1, "sentry_sdk.tracing.Span.iter_headers"]], "iter_trace_propagation_headers() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.iter_trace_propagation_headers"]], "iter_trace_propagation_headers() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.iter_trace_propagation_headers"]], "kill() (sentry_sdk.httptransport method)": [[1, "sentry_sdk.HttpTransport.kill"]], "kill() (sentry_sdk.transport method)": [[1, "sentry_sdk.Transport.kill"]], "last_event_id() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.last_event_id"]], "level (sentry_sdk.scope property)": [[1, "sentry_sdk.Scope.level"]], "pop_scope_unsafe() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.pop_scope_unsafe"]], "push_scope() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.push_scope"]], "record_lost_event() (sentry_sdk.httptransport method)": [[1, "sentry_sdk.HttpTransport.record_lost_event"]], "record_lost_event() (sentry_sdk.transport method)": [[1, "sentry_sdk.Transport.record_lost_event"]], "remove_context() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.remove_context"]], "remove_extra() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.remove_extra"]], "remove_tag() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.remove_tag"]], "resume_auto_session_tracking() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.resume_auto_session_tracking"]], "resume_auto_session_tracking() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.resume_auto_session_tracking"]], "run() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.run"]], "run_error_processors() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.run_error_processors"]], "run_event_processors() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.run_event_processors"]], "scope (sentry_sdk.hub property)": [[1, "sentry_sdk.Hub.scope"]], "scrub_dict() (sentry_sdk.scrubber.eventscrubber method)": [[1, "sentry_sdk.scrubber.EventScrubber.scrub_dict"]], "scrub_list() (sentry_sdk.scrubber.eventscrubber method)": [[1, "sentry_sdk.scrubber.EventScrubber.scrub_list"]], "set_client() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.set_client"]], "set_context() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.set_context"]], "set_context() (sentry_sdk.tracing.transaction method)": [[1, "sentry_sdk.tracing.Transaction.set_context"]], "set_current_scope() (sentry_sdk.scope class method)": [[1, "sentry_sdk.Scope.set_current_scope"]], "set_extra() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.set_extra"]], "set_http_status() (sentry_sdk.tracing.transaction method)": [[1, "sentry_sdk.tracing.Transaction.set_http_status"]], "set_isolation_scope() (sentry_sdk.scope class method)": [[1, "sentry_sdk.Scope.set_isolation_scope"]], "set_level() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.set_level"]], "set_new_propagation_context() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.set_new_propagation_context"]], "set_tag() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.set_tag"]], "set_transaction_name() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.set_transaction_name"]], "set_user() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.set_user"]], "should_send_default_pii() (sentry_sdk.client._client method)": [[1, "sentry_sdk.client._Client.should_send_default_pii"]], "span (sentry_sdk.scope property)": [[1, "sentry_sdk.Scope.span"]], "start_child() (sentry_sdk.tracing.span method)": [[1, "sentry_sdk.tracing.Span.start_child"]], "start_session() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.start_session"]], "start_session() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.start_session"]], "start_span() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.start_span"]], "start_span() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.start_span"]], "start_transaction() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.start_transaction"]], "start_transaction() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.start_transaction"]], "stop_auto_session_tracking() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.stop_auto_session_tracking"]], "stop_auto_session_tracking() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.stop_auto_session_tracking"]], "timestamp (sentry_sdk.tracing.span attribute)": [[1, "sentry_sdk.tracing.Span.timestamp"]], "to_baggage() (sentry_sdk.tracing.span method)": [[1, "sentry_sdk.tracing.Span.to_baggage"]], "to_envelope_item() (sentry_sdk.attachments.attachment method)": [[1, "sentry_sdk.attachments.Attachment.to_envelope_item"]], "to_json() (sentry_sdk.tracing.span method)": [[1, "sentry_sdk.tracing.Span.to_json"]], "to_json() (sentry_sdk.tracing.transaction method)": [[1, "sentry_sdk.tracing.Transaction.to_json"]], "trace_propagation_meta() (sentry_sdk.hub method)": [[1, "sentry_sdk.Hub.trace_propagation_meta"]], "trace_propagation_meta() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.trace_propagation_meta"]], "transaction (sentry_sdk.scope property)": [[1, "sentry_sdk.Scope.transaction"]], "update_from_kwargs() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.update_from_kwargs"]], "update_from_scope() (sentry_sdk.scope method)": [[1, "sentry_sdk.Scope.update_from_scope"]], "user (sentry_sdk.scope property)": [[1, "sentry_sdk.Scope.user"]], "breadcrumbhandler (class in sentry_sdk.integrations.logging)": [[3, "sentry_sdk.integrations.logging.BreadcrumbHandler"]], "eventhandler (class in sentry_sdk.integrations.logging)": [[3, "sentry_sdk.integrations.logging.EventHandler"]], "ignore_logger() (in module sentry_sdk.integrations.logging)": [[3, "sentry_sdk.integrations.logging.ignore_logger"]], "module": [[3, "module-sentry_sdk.integrations.logging"]], "sentry_sdk.integrations.logging": [[3, "module-sentry_sdk.integrations.logging"]]}})
\ No newline at end of file