From 94fb5a4bd6c279fb2a7925d24dfdcff90d393ff9 Mon Sep 17 00:00:00 2001 From: Mackenzie <63265430+mackjmr@users.noreply.github.com> Date: Wed, 10 Apr 2024 16:55:30 +0200 Subject: [PATCH] [DOCS-7627] Add OTel Kafka Metrics Docs (#21505) * Add OTel Kafka Metrics Docs * add example app * address feedback * update index * Update config/_default/menus/menus.en.yaml Co-authored-by: Brett Blue <84536271+brett0000FF@users.noreply.github.com> * Update content/en/opentelemetry/integrations/kafka_metrics.md Co-authored-by: Brett Blue <84536271+brett0000FF@users.noreply.github.com> * Update content/en/opentelemetry/integrations/kafka_metrics.md Co-authored-by: Brett Blue <84536271+brett0000FF@users.noreply.github.com> * Update content/en/opentelemetry/integrations/kafka_metrics.md Co-authored-by: Brett Blue <84536271+brett0000FF@users.noreply.github.com> * Update content/en/opentelemetry/integrations/kafka_metrics.md Co-authored-by: Brett Blue <84536271+brett0000FF@users.noreply.github.com> * Update content/en/opentelemetry/schema_semantics/metrics_mapping.md Co-authored-by: Brett Blue <84536271+brett0000FF@users.noreply.github.com> * Update content/en/opentelemetry/schema_semantics/metrics_mapping.md Co-authored-by: Brett Blue <84536271+brett0000FF@users.noreply.github.com> * Update content/en/opentelemetry/integrations/kafka_metrics.md Co-authored-by: Brett Blue <84536271+brett0000FF@users.noreply.github.com> * Update content/en/opentelemetry/integrations/kafka_metrics.md Co-authored-by: Brett Blue <84536271+brett0000FF@users.noreply.github.com> * Update content/en/opentelemetry/integrations/kafka_metrics.md Co-authored-by: Brett Blue <84536271+brett0000FF@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: Brett Blue <84536271+brett0000FF@users.noreply.github.com> --------- Co-authored-by: Brett Blue <84536271+brett0000FF@users.noreply.github.com> --- config/_default/menus/menus.en.yaml | 5 + .../en/opentelemetry/integrations/_index.md | 1 + .../integrations/kafka_metrics.md | 305 ++++++++++++++++++ .../schema_semantics/metrics_mapping.md | 53 +++ .../collector_exporter/kafka_metrics.png | Bin 0 -> 848180 bytes 5 files changed, 364 insertions(+) create mode 100644 content/en/opentelemetry/integrations/kafka_metrics.md create mode 100644 static/images/opentelemetry/collector_exporter/kafka_metrics.png diff --git a/config/_default/menus/menus.en.yaml b/config/_default/menus/menus.en.yaml index 7c4ed8e6e93d5..b09d8694a4446 100644 --- a/config/_default/menus/menus.en.yaml +++ b/config/_default/menus/menus.en.yaml @@ -630,6 +630,11 @@ main: identifier: otel_batch_memory parent: otel_collector_configuration weight: 3038 + - name: Kafka Metrics + url: opentelemetry/integrations/kafka_metrics/ + identifier: otel_gs_kafka_metrics + parent: otel_integrations + weight: 3039 - name: Schema and Semantics url: opentelemetry/schema_semantics/ identifier: otel_schema diff --git a/content/en/opentelemetry/integrations/_index.md b/content/en/opentelemetry/integrations/_index.md index b1dc5a0d487a1..594dc4c4cf430 100644 --- a/content/en/opentelemetry/integrations/_index.md +++ b/content/en/opentelemetry/integrations/_index.md @@ -10,4 +10,5 @@ kind: documentation {{< nextlink href="/opentelemetry/integrations/runtime_metrics/" >}}Runtime Metrics{{< /nextlink >}} {{< nextlink href="/opentelemetry/collector_exporter/collector_health_metrics/" >}}Collector Health Metrics{{< /nextlink >}} {{< nextlink href="/opentelemetry/collector_exporter/log_collection/" >}}Log Collection{{< /nextlink >}} + {{< nextlink href="/opentelemetry/integrations/kafka_metrics/" >}}Kafka Metrics{{< /nextlink >}} {{< /whatsnext >}} \ No newline at end of file diff --git a/content/en/opentelemetry/integrations/kafka_metrics.md b/content/en/opentelemetry/integrations/kafka_metrics.md new file mode 100644 index 0000000000000..7f7224f826850 --- /dev/null +++ b/content/en/opentelemetry/integrations/kafka_metrics.md @@ -0,0 +1,305 @@ +--- +title: Kafka Metrics +further_reading: +- link: "/opentelemetry/collector_exporter/" + tag: "Documentation" + text: "Setting Up the OpenTelemetry Collector" +--- + +
kn#}M zc>lW3&r+od*27jp;tZ-f^;)vEQ+_$PD=UTJP`L}YP)oofS zC@3g`=zO$E(UXbKt^mzoU1F{K&C4v`JDc-4&sB9hX6Xw86b Rs8b@}~0Ro9Rx>3wtYyaa9qcRh*&(z{|zC@avm#x32w7+8$ B)|qPJ%dj#S;N&D6L|Y2W6VBXb9o-Dj zt#`&ZhQyc;tWgt4e{=ura`5K%%MAAoq(g=T4KXBZ6u1WH@&@kOO(cJA9GdR?QQ*G0 zSy)!jqc`E7(+NqK+R(BN2n~FjWK4TQ=8;a+vE|xM@X1~g+KBUk5F4X{f_&zl)E 3TQCr%sE5bf+E8iEY@Oe~7RY1(Zix%j8>c6CEGOJ{sphME^>#$Pm z|4E6mtvx|EG2O2AAag3Q`m?|fOg){}BWW@I!1vi%VOi(C>}T`Qjvt`a5tWbk5a?@f zSgjqpK|PV8@SHyo$Q0-?VKBFddLAMVkLwOEwcoetBoqcSbcg4nzhB>$zRyLU9H#mv zi$0ZK?;*YjLMPUNwGbbGGcT5xKG|?wnxD1OV_ @#<=M KiN` z@fpqk5!w(^sPxJu{mzRdTZ?M_wIYN5%8R#$Tq9Fg09vRkQ#y!|Ab}AccKDM`-WgL= z G`OcR^?{`+@;Gf$P!D`abDx{-jQ z+HE&3poBD?0y}MoyP&SnE?R}bvh)G7)y+_$vh1wA`mNnyjRN`99Pe4w?3UV0c8ZsF z`YNPVTfd|W@3E1QrevOEg_FtuvK*16`Lcz5?m$#d`Z*izMBm1XN!_*LdVjRsfh|@y z!e!tHAyvr8^XtQ_^7h#2J;^!&y+ UEBjQG76S1YSF&APYcfBmslqv-Mv`zIbq*f)3E#RB^@sY0XS{0$pMAN0 zFYvQq+jAOWF2H==9;|VGI7V*d3`n1l!MEL0xyZAbzKT#ylgat&E7EwKnN
`FGl6Rw97LWey|Ju)^b*E!8zh0%vb?Cb0C KYUzYq4RW&Xm&`h0Lu@Ec4waLgfB)N%TCOJo{eB4AYhk%?RDDXM6=^A zMd+C&f`?rD0sgqO&v0bMHdL3@QV+@kT Q36C4R3f zG=A QP_mU}WCcOZFD;jn$e@v_x-Kg(_9}uyRJa?cpa&H?0-1+i3b#~5f;x| zB0d*tC;ap)8@N4lQ?zSc?M{pamfNB2(6oGT4#oiYz|(@beAsgloMqHg3;MacsnwfC z0v7FBC4UzW*W3%T+$AepGwQ+i2p%X+1jrWsa9P1gw{+1wQY6rKb&QmYQx-uP!1Mq_ zkKyRo7Q@$cKVTYyzN+-qVyGD3FY~%_VRWWFC#$cZDk}meJy1!N__C`6UG&otJK3l| zWGVT!zT$kw<(oGD`kUJg<8p;x7vnp(^f8lG<2TL^
+ N z7pj>^wY^MC65#(U(O%xyB9?guzB%AaA9jZRWO=Wc`5MK;hnxVCFMtp>8CDyy5rjF8 zZJ%%lP6yvlCnkgxJJ^1MUMG-2reKY=J8?SRz-u6}+S(Q8l!*&QKhvDQsrFC0f(&2Z ze_5mPy0}f?*@64z0|G7a{2&O5UppPKy8`^El{(`YBru|O27% qKC%1lIz+$;35{ z?067DSQ*o{ZVDaNL74#;-H-a5<#MCf5}ifdR#cWhojn`88 LYoUr(T^C?^SJ!exX z)4ZgExlC8KxGvhLyIsooRziOEwSv!a#hEK6J{;{rpjEHH8Fx13nVB=2R =LvyC?iiap4NEE4mfqf+g _kENXLJ0e-=W$kOkePcYO}H#BK- zL~hXpQ2?aSSuf2$AL2TAZ$;=!Uo-iM?ntDK?-t{tDTPOz#>Uqst;uqjEfxn9)+i z+CZij&j(={i{tyw;xluacpam6f&PIlN#j+b;2QJnXJmEjBZ7APT_fC#DF_foO36Vd z>DiOnXKo#hnd^n*nTmIdN2J|y8X1WSi7D`r?coMi2a~;io_+xJxdOcCYu-Kdn?~B2 z1YQC7&s`5WqNyk)PZ~GODc*}P3nQazBu+iIw!(vc7mXYo%-r>-n+(`zwUqP-6MXnk z-$(=n;4_5;MjR1n-B8hbXkm=`Mr&d (ASr zCP(Q3kXc}ZTzdDzb%7rdiCD(tCCiy&(e1WQL!*2Vx)X&7ek3z6(vGQ{%U~3Sy1$k} z#BI(8GRQC`10x!%g&Xx8kGv@#gjQ-eUR*{b$g>7cig9edF}@$&l*=%x^@KJ`WokyF zZddP5q`_eW)&zVTgG7xOOoQ!FF19F!_}qHFZ@smUnPw~a!j5@U{W}lRKLI9aLA8ux zF5xr(vnTn)1TYU^{PF#vUl<=Fu3Hf;sZ2j?H;Evu$5|OleArjq0ONsb+-f;g)a@or z&$dWd62_azeIi`+1^hX4j;{dWqIYsdkf%E9I!OmwK&%i3IMi7sG;t3Vn)4Sk46gBE z%Rv`u@8x% t1TMt)9=sgsH~&m^%d5)|QsEkGb}oHw?HLzJ48f4j|8p zqQ$Y!`x7xRjKt9)i1O9P?zt-fJx;XiI>2^f=I6+J)m!2{p|sCas}D!D9l6hm6(x5L zB||r2t}`v1^apjTF5>7yKbdt{wMq{f_*K9Q#_zw?3Gh{C41}KPVb-wRkncd6PdH`q zK{|V|QMGUPT%FbUMfXIxQ>5XV$5=A+vG{GXoiDOJB?V3{Uvn#z?W;^Od)RmOiqcBG zocX4un;97AH2E}56Eveeg?L<&Io}8grT19_q|ii#nHZ^>3{l0&VxCA(>v@S*j|T)4 zxA06h<#LTKlWQlkU6ODd?qfy13Ekxw *>jW3P=mEbXo~KPQ<_MDsAPqPS z)od<@6T*HvrAqbliCEOjT?9YIrO2K>jiAVG^|CZIb&5zR07_ndEAd?PNL2CxGW~Ad z_o~?aY~brpOD`SJU(9^_FD;;c5RSRg8t=b;1t9j%&?||Fz^6Rwjospo!1yZ~< eq|4itiXX zxl)b--@}02p0KvbLz4|)0@1&mbA-`(Cja1>fAu=jR3PgTwUd+aRA`t}(j5@s1o+)o z^(ci|t=&Pqhp1g`x}SuL_rntwxjB+$qK;$kSaZ>ueqxTdIqYj!qnd^rX#+5thA5^! zb8^gsdr5k}Ze@!eoEKZU@*<7AF56l99^$j}qfnI9TAT(k>G8!JL=@Fh^Jp!Cf4AN> zRzBB (%=FAY%rm}t;GtT4fTV@aUb>bkqtnvYnk|Nz*r)}zVp!K%<_ySZ~49! z2_BNX;E9ru?w|(>`>m9fzmNSqV_e#?ql2=kr}8`pGJv_zfd0~l4L`r RY>%ue?*rMi?p9*z2{e@ip`V*x_4VDNAIG%P&dc&{QU(7RWXJg+&6g69 zbMLUWnE5^^07BXnk-&L`8|g4yc+%eU4qS cn69Odk zYYU=8yNf~~e5k{Of<}@w#MFnBFrCGv{2F^b1^-CX+D{NJQ>RNd3Z0zp3oI zC!#}J- Rjxb=vHY3~KKpB!qf8 z=fVzi2{wFoK`wS<5}#qG;Dm`haU{_$RICFBV5!gs8DazlY*c=icU27DeNvB1gUn_x zsXKb*OsXehtP9(v%bqN0%VQ +9*m6u#K_*u+8&>{A3f#Ib;C95c&p@b z1;Ytj8z3OCsNiJ((gVlph@ea YmtkuH61F9TM+r9 zD?b3OFmr!yl6oy$j5X|nT3l2&pm4LUwpdxvQ&V# U(SDdI={1JO3Kf=uSZIlq^({+qA*Z`lHuJ_SpYu&sA!|mCegI(I zcDL=hj^7nvA#X&RyKUYN?BcVrRFSH5#{E8~2th><+4RlkOLcp}pC}LxVt{(r$AUPu z1s>s4F+R1eT~&6!#wtyfZW`v+uv+OcliIU|x9;ZgkZ?|_b5?FQdfl7JJyex~<-poT z5 %SmL0;<23d0s-2dxNa6fs*0R;RljEIl)$vuH`4`mkPygpRA}CS97fXo zdAHuiPpsztc_-W9;$UE2XNQU{Cs}cpl4v5DUF1{=+GnSw7a55L5%XnYH;rVUeQF-* zVMk|`8_CH!h|vbD$vXy6QE}}~s`XO+BxW8yTf<1mWDJ7n9mat1-I9Sm;KuQntc}yg zZ@ET1+S>uurz9CvKDHgi@9;q{D<*eusb7Z=Cr>xt%eCTBspTTJ!fh$@X%HG>_{i=r zMfO~?*>rMDs%t%sa?4orBu1ibkb%RrdFn50q3dCDLqoEfK!WB(ykW_!J0%j_9wgQP zs*m8db?Ehoa|FlX#s(-YOouVloTBfO_nA*PnVwdI!FIoltcX|YwdW#MUoR}j)Wy~7 zXFzeFwsWG7iRS2Q<<3h1n|N&iuSwsKI|!w`dBdz)^{wl(vdkvea-J~x4qZf#PQOme z&KL6}9cCi-8ec?)=D>+?ua;yRmd|l9H2aYIO8LF}X|ZL!F6bA9C^_pX@frW<^A$Hu zT*5~Cu}We9-t7r9$)9I`5LQv7C&Q%|^9L|uM3e;Mv5^-S0wayk{w5t#$WIZ=`Gce& zX2%6*c9 &R6SS^ zA@!^IP|@twPDe*!tRAbO!q=}6M6*{ >7vX2QWlt2@T)lqJE#|)awpEWi5K| z5DjDN{L=^$BQ5$lOIt4 nTqs*nFNu|=@T3I=zkfKa&+hx{=!Y=q6 zJu(%)as?nKV2-fL#MIWPh951k>t4 zy zUKNP-Fqr_+>@yGC;MID@zs>p1@b`l)0j%wle{RbW$23DT;UT;5OY0n_1Niz3nmFBy zQVfNg9Wis1v7w^ulR`t!?7XE^CSl^HPP{To&dLFgY;zfeu4k=YoA&Kx$4rdWT+=8j z{gkF$rjjO%Q%cx<*EBGm0x z#;EQodHU%^8kU4G<;;sOP=<4YX)tS&sL^Z-FJ#e%d5%An_JZTu_ld%;Ii+8}mW~UG zY ;7JV ?xwg=B7Kc$@hf)#dG=@KPCVZH;37 VNYl$FY_yBqZC@HC*UZeP}p_8ml7XclB2sWo*0q)QK< 2vmkY*g$m?(BGhv-{)}H^>TJoICMCvdRK;N$4OlJu$fH^6x2F$z z{3Yz4oL4!pHb#6y66}K(erPInKW$D#)WOL8U89Xe>23Sv=VpL)(h*u3U{a$25{MBS zIn-_vhgITK(dPVc@0qq^COuV~XUieWOsG#4{4k<~*v`74JrcC9W0nSNp^Mtgvn&=7 zbpj$w&3QEbBGTsfyPuqqeP_e(#UuyWEaV(6#`XR_izBvEHfNbsf>J{mF)73HgIlVS z@~~&M&8iV1!Eqpdj4*;K2_gjTGXzT^>#t!njy4Fj)sOCoPan}Ige+Ak@hp8ypd4(d z)Y%)Ms@ext^aAiTR{&QzYOv^(`wuObkDmG3uqW3{l^r=gALw?fG~agjQY;*lTwab1 z&c1LVV(y4~oa_-sVl9Cnv1I?vt=uQ-Eq9a|wR=-bbF|&s%+B$v$27ECdE(?h`}~P9 zgABV>+gZFQQ4;c?V^uz&vuiW(zY+EK@Gqg8(*!=ECj2-;$ob|RPGn7%xM{5B;0J;g z(BEk1S6E_(%h*SpCQ(34GVoIQjaPs?sA4gcV-w;|SmM`e#DK8T7$1aKsjuiEJkeLF zYc5uZY+|$d(>3;W*L9X(!Ew_az=d=W6NDJ2XmMLh(ebQ(;#Xgsav0^D^d-fyn2g== z-q@Ff6-Y3XJ;eQ~!Mm=XI^MTf4AJ5^*7qBP`1*yRO0W5fd+E`UvszZgImdMs2@jU} zsn?0KBhHrspWgyy+_PD0@$YksQMLc!%+=!B^r)^#U#kW)%h<3kJwVPjkQpBoZfY-E z%UdV==Ml> z9$p+2n@&q9WUQY5_BrJ_6U`@Ldv4~5Oo|*&%HNP*0Yb$xtswvsP$3LuDYrPVu`_rD zAaf)p- YRc7w@27$$_QlM#v#LI`Ew$1a4j8|#cM`;28wjOllM?)$m# h=Qy6{pXd1f zp5yrb;oy(!Fmqk!d7bC`d~I(;Wv=|Ek~gL3!SG|D6J}uiixD^eg1&|TaM2(45(RI! z=ThK#ZCLK1ZP+FF!_hmyy!!SOs9X@#fN!7a9=d$h3 z@#lo#LOricpv5!Cc=GjHHLD5A}h(0 zewd4H^Q!UYV>Kb4J+|?cb@d;3B$6F$M`XjS6MrbDt^ed597T`xlvG={3=c1mWjM=% zO5vk8)XTj0c`rKyee_M!92?Rk&ENTn(Rn5 sQH=NrQpTB4&i8^Tx9k|vh(4Z!@{NqU`^ zN8#EuA`4-R)Ony _qY@ugrUc+v$w+j~Q&twVYplB`;yluG^WG~-XTml)_S zTlcA-b>LPhxwqDXAy}9)O}l1`kzqt-10lzWa?ZUGtDoD+Q7O8rRZM}21u5Ch;Zv3) z3xo$3Ej$BB61*$lXVmhJ lC(LJ^ie6wP<_cM31bD<7!7A1&b%H-E54! z(|+NphU&`vX!M?NlITpm)bmU9KN?N|BZ&d@ENTl?JcTX)?z!t%|0|S3`~m&4G->(% za9BXC1~Xa0;MKt{6SZH5v$Z 8iH(}6uo6{Qx}9KJt*DQQf+Hy$`S&Z+7mHr` z#|oPTLh&3CH?FD6`eL7I#W6osjAaxcXrB$$K4C=m6(as~xoLgz&*TE8Ac)X=nn3ys zI@Sw%$aOOO{?p`6tHC!2MWp345BUs0QM8Q?tHxDf7k+bb9w|jQa9NND_gkHRnoP>n zyrz3O4N8tAaCM-tflF&!st#_1z@>_pE=`1*x0PiHn oJUtwxTG51N1(Y~ z&bHAQtSf};$ia0N)3*ROAf7(S4t@{ 7rMxH z2#s0J!beK;b(sVCHPZZPnrE}T7T}S+aHiu4uaK%|zWij-%Fu9?=f3&yeWj$}49d&X zEFIBdVkBTc%BL8m&6Tl1#{6$A#`XxvMQ6QuBV+&O$(<7J$Os<;4i)?HnJwGk*!oY$ zITpxvTkx_m+4nC90^oed($c45WJa7PxE)CcsP+<-t}>} 2v9!CT^0Fvde^=k{|dBx+8YKmF_7xR)nZaY9i>z;K9HN zC_)Py0_9K37Rl-CeUSLpGmDA(IQ-kBpW>^vnlJ(g)V6q@^6<3aFK9&^2~aA9;eSB| zN|xK9909K%*d4T(cEP5?=H 1)CZ1I)jp z@3_F;d;>Yq*`x1X`eKustRkL&p>+*=VEG2&K_11y!gHAXnd8F5;zH&$2KpXHkDC{~ z-w}AEYP<5-vDQ%Z*)6RPv_n*&;I1}(g>i$OF YgznxQ2BFuS6kDwbVHV8QoVh{9af(VnHyjZ_cbyKvahTvdxneSV_a zMUoM@ca6VMhT&b$-2v}6pYW}-c@Lp45=N)~!!E%50kDlSr}QdWlXu(FAye7fzZAu? zmR;;WNZfVSW)Qi;$^c5Wf1GRw1~5whFUSr6W@0F!hyVlMF|`k1>6l7N;a=FUgwTBO z{xBxJ>Bf>KI0zCjsSaEh7=^(}0jS8#i9GZ6g2>i_$CTEt#EqGpQEl%Y?{4cHedonp zKX_dmz#Z(td5tOr$UB=Su-?Xb$L8iYyDapZOcEbK_N+jZV#%48GQY8s#a_piOYEs{ z05M%OKxu;h_49w`GvL5O2vz Y{7a2v1)X6niOrtNE?RN*GRf)=8_e+;oTYeVw4fwm zCx#yDf6>6SK7yf68kYPs%67 DRudAPoJZ-Pq;<~xGKId2LPFi6~^ z(=_I-g)PW77<_T u0OzjO80e5kJ;w*DY^LLGvtcE$M9yL3M-7CXe}q!#lV^^alm55 zyx!Q-6X_pNBGOtTYD_Cq8c{DD)Wh)oyQt-mdJc__@+OHD9@q`x_9{QnjN01~jx>p5 zTzyUW?!?MT6GJZ+{`(gD;`W%Cok1!hn0SJ)I8E_W;O+CO_1&;exS(>+@Nt@WhQv&E zK-wdHpPN@$jYAcPIUU$@IVU=R#X2ob(V%EOL#t<=CDOwgt4;hW5LX$Q-LU!@NL2~> zNiia18j%ffGfTN{*vEuH_Ckf~svy01FTSOLyF*r)+J;Lt!NW<-0RPEY5vht{I4#;j z&ZzlfgJ!gb6^3qS)_U1a4SCnQOk|=*Ivxhk{wcaoE-pl9oo0mz2^bi`F1uT=WTi&u z6eeQUl|3KC8OeZ3qj<0;-r;t)PE6d9+%O95rwtu#!VW4It6PGtX{c+2#!nSWFH2s% z18>u;&F w^Z5&z@kW-H zFUGz3llk?`()oK)B88V^#wbw27kDRLB7zcnT0}A>-w|A)4le)6aXq 4I&_;ewmq0`ztY%~E*iv%ta)smjL^^btH(cbApEG8KITjrnd_im&wwiV^~Qhj}Qn z0F>v(^-4<}nr8%P6}HbVzmIjm{^}FdSNHyK)Hmb<-DHl|&}qW$#$@yV)Vlw$##pWA zf?L1Zq1<^o`oJ(y-ww3xVE8452ci8;C>k(dM{JCCk`@i<9=ZJ-^kx?c=lwC U@qf3`nKIg@K{|W3( zpnra3qRHVzq4tFf2O@X{UPwIOZR%rt8AH*^H+S#cp+n!)=`6nDYdh$&(P;9%e0`Ev zzY5B6n26 nGP87k`h>_4C}%d=qv9v}x`$ zxj~Utb@5@m8zbailE=iQRM}UmLs3B@h7SG-2l6HiL+s%D=t>FQRP~+(ELYEizD4Hq z@G}r*aw~`M(SwE?->R>8S)hLC>nlnAQCDWZxs=?pFdfXjPD(3`!gLQah7GsMqHyyy zi(CYks2v6)?MG6a%O>nO^QK>wvs>ooLJ|aZI!68Fz*eK%ho0iAnoTnG6HlCDBR{=f zlJ4(}V5rET(4Hu|2I~Xs9Aib-wgpTOo_F)paG3f`hk0a0D%%eDD$dY@=IEh@<(T ~A-^<0!;7QIq8NQ_CN~Ks$VKa~8WDcJk&RcQq!1_tl<|8#K04Af{3&5fB>0abS$- zEu{#Oe>UzEe1;q0SLSn`eSSLlqBh+^aXvK5*=PPKOg3iuDemTZ5a=QO>WvEFqIRLz z5Edj(hbYkwiBoPb-qaC@(EO~*z%GH6%W+o!4Dvd2=SG{>8{kAIa&pmC!!x~OP8SkK zcM_IgJcJ&shADP@zO3$#Wpt(;PYf~WfJM}TFDm#$E^lab562=*%ePOw3jEGgmH6HL z$vM?>eRd8s1ftbl%<0G_1hzv6F^Og;kW*=B4!Ca*Jh8Mg-D>h~vnl76xs;41OWsa7 z0*D |wwEydh U#YAq1i*o=Yjkr(fYcMs7O8%Rxw&6OH KRF#xAYS2$D5i=zKsU2EtgQy ztqc^gckglMj9Q*44^JN?67>0x@0D~)Gzc7r)&aI*@mNB-UgOuV4Vh+R{)UMYxu2hY z81~onch*`wV@NB3HWWphULfR - z>D>>sd`+=(h9sEoQd0}kGG@`KcWY%er9uziP1uV(N-Q06G1Lxtf9}_em!{>0d`h9U zYomE~qJ6e)*(=4FF3en#7(+hcOlwHf=?9g}3e+` Asp$_D>l|n( 1r`@3TSILl{snb6&6(cxke!&Ac!=%OxD?PFK7%=mjPn}8 zMl}8oVs5X9*(Ms1g2~BFOnhdL@tvK6uln?vXL^X2XU{A>(|ON6%t|pGql#09b?C@J z1wTw V5TRyGvfnnbSP@V^szDsKZ6*iCG+Go+3j!14>;A*MGgn#Ts50 zFce)*6GeCJ83N`+n#JAeOnpL3j|>ok@y)%=8>W&T$eH05>2Ceh&fZA4Z 58?VL4ZV|NlfS^6R2Ekx zr(e_c@*Ss Zad;(M@{u(A>BXDvu*7`cbzb(g+D|4lU`~F!8mM~8@ZG{Y z`e-R<#(Kd^6ZW06=Qoj_XCIT9KTCr?+D^ZuKlS6-s6xoFQrsh#=t `THsWe4 zIkLdb+W1FZofOSzAv(woJV$T!eq8_DZVJ!FoXl^9I3z7h3x*evWE4}`5O3=0)bJ8F zvf(do_2xL1zjD8qJ@d$mzx5FHUL|BW9$C2-4M3_uX$a${Xn%Ek0&ycJZ7?|b{BVh? z whv6_?!~t9P8{U0l0%G%=U$y0Z0pZUZ4b?18k2Pu1}LJm5t@D#?^P9EF7PxP z6b$0P> kypAdnv%VkB(pwzk&L`gC=4$myXYl!KLf64 zmNvn&s$!K)MTvbo?#`o!(u@_l?s1Y|2G9J5fxbC&$))QP*^~ev2i>~`1EoPu_D|k8 ziv?AF9<3vEH=Q>XMYH?(+ErQcQlkpUIeIMwQr(%^Dfi1-%KDvGlY5wdCVf1lPaafl z%?oi2yBanGVO2p!<**<81+kIC8Aq+9%8HV8l{+dcSfwlEBF^bE_nVyah6IL<2vs9H zN`YZ)tcyaZmgrV&Xl&`+_inrJ>E2UkL!P%KsXgXlq!;?v-IuA-)Sm2f1WZSZnHj-) zBP0Fw!MGJ(Y{KOO?4hVL`_1#OW(TUz(HGla3v(e~IMLalYLla2dE_I#alb*%>rV9< zy0kN1ii^@g=)!ZWSNIWALyBYmtyUqu!mFsp0LVA>E=|~ZgkC)%0c$otfd9p=II9;a z)=+EZc;k_hgT2r4<;0hZOQ^}XKchH zj;2Jb^UzJvwIC5&Dd znYMrrQ_i QK2NCImLubW)lSSh!sFOtNW~*kV1gV0v2PXXugt z#O4v<2kOORn$^larD&Mh>z^*a^o#)pxNifFqIN$9s9@6gCKlC!siU}#P!#}9B?vj) zXtR!azNd`w{Z4hsYIZnvR@>6n*f)GesMvz=)(9mCVKV`2OQm2`r+azHc`}hQtce6~ z5bNwWCzC9dD72|m3AE8)kVFylX9~k0ovZUdn_i+KY*runbVcMQL6mADQ;U4x5r*PFxngQt zTUB18X+m(j)kDdNB@*bnwEUN7>}iD_8EU0i1CUpc5TS~yS{U}MVoiWxx5TlAIjh3$ zfpM>3t;udtk6Wqyb$%oGQ`24avDLGF`5z@w4{IK<)jfMksTb_T3%%5lsv}a%i1awi zBr!tN &*%8`A(S%zHvu;nvEd32orAFI3FlX*ddfM6gCeB7^HHC#7Gq#PKLz* z2kBbo#Wt$yFhZP=7E=~BmcyZCSd8uU_0Kc%s4diE5{ACj%(}IxCeo&TQ$oNv7}B{g zy=qE}Fha&2WlJ?o*2v5-%2gzeUC}yXz03WhyyEpw;S$+fCO>tK+;_D8UrwJ-%Z&k2 zdWSmB )bSDP*n;wW^%#m_ z9{7FHMp~y*hpD;KY}3zd?|PPCe%4F$uUfeg&%P1`qQ3#DmCBoG8X=q~Olp^{J^@JX z12OoF>^a{E=Ig5&8DBpL4ClJ$#kKtde1c^D9GzBUmN&G5{(@d$PStHD4=zK7G1~x! zEb(w@_#_IDXgAJdAOr|i-ygX-13>tTVU|nGlsG^ixFWI&_|h;1rYrjg3Z&I|WiKhyy)JaD`5+PX050flujS zPCsJ?WY~n0_wM#ez c^y9SRwHGI?PFA`bz5xF3Dc!`w*Uz zbT-Vir OG181E-;r zkNkHp-{+Wt3o;tv``?R1o(*#V!V=9B2%K*T)oD(!j5+Ys@7RWYY}}WBrDHdhI)*~) z-_Web*H_GpKK+HbMQjAV&8;!HLm9|c$m4y_0>k`Su}l#kRwd={6>+YM<+N?GI($Ns zV5pPaJT<&$Ht1cb3){ <_vZ1RsVjBS z@;$b5cvO9DKTS|;)NtCZbiE~QZPm(CL#fLwN%-m4#?{~^`6lSMV;f@TJ+d5qEaft; zI81tmtbvST^h!%RH(hS!l5pqu-dBI7dj^6Akd~A*;bthQn2f}gK>`0LEY8}-AQT6C zozClLseDC_J(2(0Rp()lq1X2_hnhm#oBK`Og2H3X5WKNvw{>Ss>x6t^(}$#N#~s_R znjjO<*7XV~3^g)G9i9LvT>nt6Z8JAZ{E5-H#qS=HqhWJJ$_jdIEmb!t{^b%XJ!kmE z2ch`(X6<{bPqEF8E#pqwj-!=cqt#z#LTeTd5D=b4V(Dd*8Zo+U$(kQKI4AarVmq#+ zSoyV*uz4LZqH6Cpt t-hF*~esH?!(++7KyR_eY{&+|DdJ@tD zCwAf9v9V#1zvD=wb&JM!SRHARXd1hE`bpKsZC4^rfw>@Vy~!%&yG31`4>37GG4 lq8( z!>?-XB#3s&y!z>-@QI&8>?tQxuRP8ttPLO)eN4_o#_d&L`ADdi(~o7%vZ?~- Vt;*P7{IL1RKikHSCl5QAuhYx(yKom`l={BZM6 z8PpB>6XFh}2V fPG?3}W^nJ0H3Mdc`k;Vpvhy zDjPP=+uLm#InP5j_5H-hmK*wJb|Lgj|74jPO_Y(rO5t30-5c9hdu?Sq6bE4&VW+_S zDDDW-WCn}OP^K(-DqtLjaPp$LksZ&aCc=)7ig$_i{X!|NwKFZKlCX<#3k9q)DU9s< z%#RbW^$1EtU&xna8ga|*Lh&9;#oZl4PD<}XI04%Y8;mS@E>-K%dpW;QuTi6yLO4zr z$B!XF)MpfEH`p12bv_{lrb8HW6T>EL?4Z`NnaH+z-XoL1ahFVI$Ix9?mI<&0%n?zR8`cwAn5Dq2_CF77J<;RCMV@Cy( zMus*vu%lqrdceyne_s7)?Bj+jspwOvSJpvm@A^Uq6l!_e5GLo|b?VPz#cCaO#^i zE~%2*dJ#aJ{$3G_blT-5cR;Yv&fsZGebbog=34xNfB*nti-KtmZncF{1Zf@^Tyaoi z##(k|81$a%F7-xxu=aS~vru;1>mSt l-B1WN azx@EN&mKBfWVR_d_^9m0wnDHH+O1S>tIWkysQ4hTqsa!iJF2X^ z7;twNm8|}`yZHqt3n%TQOGBDBIEc(!-AgDQ@U|kZ<;4b oZr1)~Q>A*5H zu0dL97CGqb!(*$3k``E0g|IqDOA?(h=0UaM66NNMJ33CgnI6LCKxUJ$vLqws#jWa> zQ<_1?O^Z3*%na~>CI45z@tn#~7>*D5Gks`lVzrW?t;3e`Vx8-4a@U?g11(B6Ewmo7 zxcB^PDnUgi#9C|P@l~!}gIVu*W6dV)@w|GIU5qm`m#% #W>+?r>tg{Tg{&$XM|-H217!P2D`!V;;52 m$!7ciV`SD-%%v;%}sk<5VULz>4utKdOYq#1PX+<0izt2*#`78F_NdC z{z_Kf9->y(#75CE`%^ZQ@x`k6i-Z-%ehw+K#9T@7GJ(ep$C`7hRdXJmf})+beP6jS zm}FU_o5!$$X-QgH786kOI >2?sD;O4PLHG`y=E4T#YQMogIL(06Rzsv#!fs#R z9%=PBeW!E74MU6Y3@s){bU;tpY$~CAH8u8imm}KK?)J%`uifICj2`m&Xbu6G@M@09 zc9h_zpj6$@#W6n=i=GNs@DrrCg0#VWgc`Oj2 3* zZ4@3%8s6HsemY-W`DIY*%`iJ!G+LN_>wFaacbhjv4 sUw+Fr5AmuJv>QYYUG zivqF^8bg%VKD)3xnO?BY7FXGL^mZ5CR}pMnh&DCS)cL&C>;gDggr1Uv@TRetDoB#p zgo+FU;uK=g=p45yDI#u$c_qu{=4d6deAOw?UYU>;no>a>6{PzKm=5A`Yi+|ZeT%=f zEQL}&&kqKPE$`iaT&ho(`}(ZaTY+UsXX)G|9I+;(S%JyJZR|-Cmb$C1p#7y)-d264 ztWGB+Zo|IdQD%oV>8K&7K_QT^53M~__-Z+t^9@GHGI;qHv;!=rg`07Il3G8U#v_69 zkp3^o+w@fZsU?gJXc$z*@fT#bfm~-Ajzlhd0#kq=seH_k7bio0M;-e24ke@i(V;|= zwx23Z;U_?Pv^9E-iLZP;M+^6J(etMAdPC}kcc0a?(bNy;(r2tU^DTnu5jrD1i9kBm zMe)hR4vs&|A}>eoP6u&cQrBeLwe@G;*?wkax2A|+I0v`v4ZhRJ9DnfL--zedS@EZ- zq7FXSJ4J$(-gJH|H^N!A51*q5j8;@H(3kZL>ccdg>)-WvCA@lYjr}Y=C~DSVUiPNy z#@mO1(6gyK0C#>hTa1V#`I1$MtG4pUII19ZHk8BJ1`uDA!X%%vD #C^_XdG^?z`I$*x)_jMdSCB$CCLHjpXsoAcfV&~gz2!4*RVt+E3}}#WfNfc= zO^`?ml*!9>#t`)8UWDY+upuB}qN0@xi{Ke+Rs|ks *hg z$XTa19A-6l?PRd7`S0VCVGej(Ks<~)5&xZ09oz`l-sP3J^kxoXYYGzis962Zd+Q{8 zM`qq~k-3ALD&e-ky+~Mo0dKln!)a0XVo=MFqduyv>-n50C;77Gl^>4b34-UeqvO1M zLhlrJd!UrbWrPsiaL?|=PMlC2uK{Tya zOYS3Cq|+J_Nl}23 Tmm*aZ?9 z2;nkY>Y@tHEq(4!9Sa-xyJ3W^j9g~CL(f8K?%kctI2?o+0(7|azV1YsL(AwPgWWuy z@v)Xqw{)tXzZQr6UEylU+}iV!1mvrnD)n}7xOEn_f>7GIn>)Ml;tSVxOiO*zlkqzF z-#Ze?>QX0VbuZ{%zUUH?C#G*Pp2)&yY;wBPsmz>Qfu^hXRZfbxuLfu%efeHbYLldw z_a|EW@^Um=c8rSntb2zz!Ij{x?IOet4EdqU;sBhYUed=@mn>WL<%rd$9-d)T@aCz& z7bW`l;b>6%6~aPI(uajhV21@(xCAa6<*VYoo`&U!N-Z(=7q Ec{yvOg3W>ZzK#CFKo!k;tF?J@?nIXdWw*TXZjOEyiWXnHcX}Z h-=}GrJtUOP;@{Qm+^JMYP@|4sQva$Rln7sMDpg z#j#3EgXg|Zj<+`YZr5@Olf3ZR*c(@Av 7=CC(jMW)x_!}@ zA2-`yF0hGINHh1hO @-W>X*V^m8$Z(WeDhLBi>dH)G(U4YhovFqPB$2PzyGBmV@$fs*k^je >AEY}AyJxh;Z^SX6o13G({#brPgObyJ1NAz4Y zGHy-GtFLWHbc%j56H%UY{;PI7N0FX{_@To?Ln|Q`Kp0{&Jgxj>4Dtv#o$A|&C&yP? z)Ezy%ZMbnJ=#?btDGj!z38%0%M=)LVsIo;|Bb2o!hxqbD+f *>#i0(mX(r7i=5`r3l8i+O`9%q zwQHN61mYH6ef&Cp(}}CfP<5`K-u8 (%ZO35TK(|(0k^8yCH*HePEH3aa5ui@0 zirO)W)~(6q6l1~>X^`}a$7A`#b{zATCo(5(-gUgyiGKB5OKqIASHGbbhXtvB_)%4k z$(Vi8#>j?RoU79VVjo}Pm!z^cK(C`)i%HVs?9m8=FUWRHjN_b(d5Q&$!O+>+XZK>+ z;n+3SUWv=G*CKzJxe7!DhgF@3h7DyLz4Y6S=8cIcOYgKcpPaF;iGapCbBQrITV^mm za^ot}z>1om_Ijg>zA)RerHKeepovIstpxJ?NC3wnuwIFL^1&0_8AYxf=F5$?J) zt9SaYtQcGk|FRGbIZvS{_;!2)Y!f}{r^$KUvMF+y9MvAtw<|+`<_(rfbK%&Qb8(q1 zag{AY7x0#yLbMbJA*(mMRoD%K#fr^zi`G*8etN;5Xb2Frysotg@?{?)+rsDwMV$(a zZu4ge+9;A&%%^;@8q9mqdF!U?1oi%*?X>4%&f3uOy!fUkvK78-nE0GZOdBjoBLWJ( zOp&=rE#_sIAn`cYG)U|G4h;YKor`=Y^W}D2FBv#Rg$*s7XM3P?neYMXTVg%v 1f&)>6pSz7VinoonSoTq3OWzM^uu0yfqR z^YPL70cNa3!<@IUsK?2UX!4)CKke17ucLj}#~vCsy+vD#^it(1bYxTF{D8?QRmK%E zlXiR`ZRCz|Z>Zgyf50*1S@62{rVu=N-L9Zuz1CVS(=C7fTaa47wO%^K<=XG~2cH|B z8@7QQ(e8)rwp*N*4XY52uuBLP@(k{Gvm8-Z7xi@1KFdo)AN|Dc#$y&9vGAp2xG4WM zI)47R&QYWbDpCW|NlS1RV(Ru@9NgI~vK`dM>+dQ0{A%e!8}cw2N$K+$ioGzbaLY?_ zmN#!f#e4xTW(ifAM}Ka7LrAD9x#nM&`Jfq2BS2#&|0G25%F$BXQGCVp!eaMiQnNZy zl>D4Q>lTjh$yRmo_HxF&rVYG#FuAN*N%XAcAi^tQNvBhAR8ReePTpgDtpP1j0f!84 zy#_Zy(o*zB!8Hd)??uv#kQ%N^gxUkmMfj|J(%^8Ij6qxWSwcmpDKP%$2*&?D{(u*K z)lfa{%gXl!8O>U&*a1bYNgF+xrYEH`vqbPeon+{NtPij;d7y%f+_qC3VLCT)vK?r+ zlKK2Tq`@$a6Ki<#-FHECYf^3EC~a?g{!Uf9hKi5=29E&uv(&eQTl_4+V`C3y=#uw$ zJ9ej`i>B>J)>(2B4i%kwdtBjaNKm%s$+QDJD>C)kpk{YsKf@oLr`~b6)+^MGg(|MD z3YMqjB0EAHb|byqu|BN>4^@3XmF5D^^A=nc1)7Vz`+znM4b;;K44KVw0ZNy_d4bbp zpxn9u=dvRE=9AR`#c$W$ ;}6b=E5(`4ZV@8lxYSpUJ+-u{BRmFo>e^k d-FC%^=P<+g`tQ) zQ&PgU{(d+R46E(#F2#=U#_vwCkscAFDA _rf7XuoCz89* zrE;TJdE|CPte&Ud)40y`<;%5O^brgjGE1iatg|}*w$5(sei>f;Rx}{vh1LYNM4JE- zOYfCL`fB$YQWX2!jH%*V+P_x77j)<;l4PkO(?Wy-VXiic kVe@4o-+k)jFL}` =$~*&d;G`QN71{>v%tO-x?8a!YT2 znL{!`A{-$@81AqR3~#>daGIIBF8OQ5=1-;ZN@>##zEzii0Y$K~P=CX4Joqe?7vV!V zt%z!s0^a(WVB4&bc|B&Vyj< ^WZ z5E|8FqmtihM^x5tHFcHI9czBSK5@pCg66Ke$c9^9deW*N=#ug0IgBiRw3RBihE4A{ zdT8+Bk4*7=5Yog6psP@pbAD!KQ0M!_-8-mjWC+0l2Wt-%H|D~jV&wezf=GV`SroKR zl _8Q-mSezdZDXN?je7=U3rHr>ZNbd zE~2{d@ZQdm4DfxstRX<3Gm_EBq4~IF2diz6hrpG3Oj8=j;C^oUs^HKQ!NY9=bx7!} zT&w6hgiE$r;bKvopOJq}WkX#W{CNajRM|Ku_6Fy|1-7?5sBqLRlviHykZs>T?>vfP zOJ*cwF12K56;UjHV(R1$-ixM jo5L@PKB650RE?RxvjSohKrm2s$uRt3293BZh?Jiyf|wz>mKcgl&^ zTt8@epm;1EefgLm sdG-zGbZ^=i={k3tdM(Pw$IDW9_(|n`R}@-0$P^ z?+S!(eSDL9t2 ^&WP+yDMEk z$SLhX)sODE5p|!qnb<2)Ktt+FGSiZInVvhMXaF#J)A1itlmDmR&EOtn6{>w$2+9VJ z>1q{XbGKyTwZdn^t#5;bt|g9}f_xJu>mM4c)v_7xcnh8*!xmA|jUE}65h|~%n}Xh{ zWM0rhU;e;_zCAS6*Ry(km}BOb-o?Z#d2v$zS1$3t=M!7*@1MBkOKh7i<+Z(BGLp$& z0>l}PVImx-w3dKLqh?_%7D>#eF5tO3XI^_Yn|q$0nYEeyc2~jv_C3U+0J`ulUBb0C zv49AqJ^`cMxu`6m^|-;|di_FPpfO~?2yr6Bh*vX!2&FYX@edL&@FHRU c+6Tm`&6W+p%qRt6RQ7i6_Je0&}_(1-U@ zhF5#r-`Aa<83y)Ommk1C${}=PY79;pkbfSJV*ZGu$j=wB`P5fnN{QP7CB^jAWdQtJ zI)_Tnyw7~7uJ#x7(FzC%kOe|nkA11!b)?S#Uce0C1sQ;~R`eGTZe(-v82K~iFDTU* z@VKFY9qT_oypz&-YCMSf&50ym&~eCX{QyL3%bk{hf9nEG$P2Ro(S!=}zkhr11fq%> zQ4D+};FG%s=r(;}$7ge>XNKSX2IBp2@kn>nF$>TvytoLtXDsyJZsjlsP;7rJL6Z5w zKfq(NGt_Vw;51RSssYHG{^#2?peVw&AN~d17NVM~>{1Q$|8?8{b+ic!XW zlz{)+82!)VU}vYy^X9pD310f)+qA*{Ok}+FeZhxaPlCPD1hbxW zA3W^~qyJI9D^iVCbbbz~I?=&sx0-{s|2}&E%fy^4qE@Zs9B`Ndv~tX!Y{+qDCh{jR zIS8DHUcFF2y!gLP+y6c_|APKMnTp3DBw2kVHm9xN*41;LZ3JRS{%w5}6G_vl3Q|$P zdBk}Zw#44YqhGa$ IjHg+r(JpJBpA0@oaTF&@Ahi*C4sfvJ0C|RZQj(@J#zo>?- z?Og!&0i<}&*sXtyyBzyZRQ`W&1DlfGP$#+BiOWy*kJL62Mei+sj~5T%eBc8lWF`+? z(l9UiH`jw?xlvcPI$`(Kp#bx}iB)*HmY$#NmyVtx!RN}+(hLuGki7z)od5TCQf~u$ ztsytrWi%Y^-T6Y*h>vc}?sn-iw$&_NJujI5j{nD^FgSjA-7i#W$*i6aJ$J$0U*e-sY+GT9*LR)* zy%%5MNbB)jn>m;T5L^y y dDi5uRef?k|YnfeQouNiaW{Q&f2f)&ps7QYDp8XWl()wcY&KPz>#k#100 zvRuZZb==?Bkqpzz+=@RVn{Em6a=Li*kY>jK*rdg7^Z)Ri+J>&d;<8nV-MwAR%m_iU zZxAP{c$0H)VQ$0scAb!8_3Ko@rwV&bO=onx=mkHao{ctN^E>&z%V&XUR9sUW)cKux zCCO5tDtXv?59kubMEoJBO<3z*h*5j6$(xo)M^X>=7%BVKRGle%<~~r_R;t~d>%Fmc zt5i>0pf7dH1zu_kD4QYCg5pG29Kr K8&n=fOaIR<-Qmu3+Y* zFinaIQT-Ld30FbBEndHetisxSudrQ-eU-b=2NK?SP*mJ5F;b7=nxX#0uv4z+aBd2+ z)Dg&ITJQX|JvLZ|X` g@&qJN^SRrHjXqPfCl<-$i>54YoKDR^g9G869;+Y8k$g%Xu>qWy zra?X>H+SPOcnCcl^?-b|xXX*R4$4qVErPWBg5PuREq{2fI`!nn@aISLK9Y@70f7xT zUW25tEAahZ9Z|wg0Z~;)2$~U=uUZxzFP`PqzNmXrd?y{m^CR+u)cQV6b-3NHa&lGo zu|f|fChVN2>EPFKzs;jDc3s~1_uIMseOU!5t84CG1(KkHVY2HvtgRBiu{n`7$X6Ce z>VvDg4yCR6?$5)mzNVjtzrS{^NAbhK4SowuVyhs+l(2o&slX4vH>YL$1uopTrFtPS z%QKtk6#hJj)eug9HFn5G^hHq7#~RIDF7iNE2Ba4Wf~)oH_y0O cW(lOXQEJm*_{YXjiME%uxY9F>1;w zzjNp*e0b9f@N~R 7P_Oc+r#7EEts+`Z+_V5gXNgn18oVNi^Pf?e>$Np=+Ca z*#)|ekqKsA>Ks|s*Yk-OTY`QuF7Xj8jyDkXY<%})^|;D+`?^=yg0?GzUIfa@bFF8s zM?5`-g0W@roF(8Wq5;pxK_dO9{EWqiM*4rx_dx}^(p-O0HqW!DHxDhn=Z-QL3&Pi` zT-3$Ct!s2n`9k3zEpyy|W;AFB^BAl&s1HifV=aF3!Lh{U$|9R>U{o_7-dJ;KGO^h$ z$Ytd>wk102;uor;%MUbNSET*(&FUj35NYt@N5kxvk5Ak+>|z~?+>ayOCu<3L#sR;- zsq9I1-q8DF>Agl<5G2u?^IA}t0FLp?0=Jg}DS>uUW82m7JmP%$(MA!zGE$4%v G=bRNDs{ZDwTEmN_OZ^`{y6 zn7-Z8*;$15f!@$uVb%9uFf;VbUB<8|P_+=kDIF;PrME=EtcpzwjnILCBAc1v3-?yu zJ4o`}_xWh=qb`4LMA?=(kzzv(d`#X~=s?jxS==lFHAF3keO0Ri&wZEuQEAM}!j!Zi zd^P~9{J|w-ADI{?PA vCD-aBF_)+UUvGUd$TVM*XXX@pc9N~x051=;}ihN1mQFF zs{1c8`l6AEr@{TPE=H*0UXI5bBYvdR6-0aVb^f*MHbN|jt4n3f_~;yB3T`5cvjt4@ zb<;?Cw=V{~lB+>|qK`1&1#Cdk8z9=^Ztz*S8J;U1uo}l>E~~tzsGdtNs?8~Mi@?bj zo^E=fgB(%IJajKVu8lD{rH;px0U0GP1r>=Bi3l*>Xo1Zxv=++D;?DV?E-iVh?qyNh zyTr%*j(a|)KG5&<-4(AT7QtP^JOY+f2|=Mr1&=M4y=SLCE*qZ__L% $`E`1F_BB?kutB zCD;iP8w^Rp-96MCd=xTByjy9Y SRL11w%DfP_PIK92R7;|M#KXd`xjc-1>YWlE znS3~iiY}|(y K$u!o@+R1W^&OwJqy*iCu3PGZK i{t!eb>}8;xcJuz4G_!#;s=__#KI;Pf2p+46zPRKT7otEv2nCRZq4`0whHw zzJ;wlOaj;=1KW=-*gM4y@ioN{v?+`4YF=ekQVbvSA2ONFxkG*rFb+#Gaas`E!Udq7 zHqM1lt1Ry61zl`T^O^2l&f1hZ`!-^5FX`Qy)}z*NA{YloQOxi_J8Ca5x2vE+hUR2# z(vFNwyynjW#~Ya|es31hHv~Vhj?MkpGW!K|RM}Z*$8b ^oy8lI*e@J7ESfm>KWS zeO>qS)b%{iec%7>eXjre>hqbApE+mFIe+JQEZ^fezJ~*ss(SC@{k*#MvD}_=_eiB& z?D@7D@fOE$B(47iWoksQuT|!h%I;H%IACWy$yDJIIm^;0VOC8Biu}=m71zLjaBLv4 zCV;;Bf*rj$5t+)4b_EeimuCXMtje*fu%GemOt;UV3Q$^@3}>?Vs<+{NzX0Q7GMq0* z?HQ!-MqhqT;MV2M*)#0V@{|udhu%MYLpDKtg*x(wl`cl86&W(kAft%hYn0mZR8~g2 zx_A5eR`g9yOiWA`{d_+16Fu2 z<+<@8a`AkPq_$MbgBGrjuHOsae;v4#7CN&bDCT(HcErFT(RIu}C95)C6aaw>-kPjt zVQ=k;-ePZ@jNEE?gn@ Tb)?rh5 zg7%axqCwiofeD|g?NZhu<2{{P7N4igs9rmtCX;d7xl~8l=FftSnsE#lPhpTDO63d9 zmr*dMPR@KJXkL~qX^-Z9$7uwi{y^pIeR!^4br~?&ol+>)eXX(xgL0P#e4Vn}@?i#^ z-pq6Lp$wJc*I4ErdxWU!Jk`%5ZQOSzbJ0V^M*t=AWSG;X0PD0`kmi5^%I6-5!NVfq zc1qs-AeXxqZjBR8+ni*#q*6$+*HKfM7 +5U!vF(FG;WF5)Y)de`%1-ijD4n>) z#e|#moe%Y_K7*cw>%GO=&5pDSaL<}#p(Dp V(rn{vM*zm0v=v9=SPP)n}0DZ{Qijje47q79S9+Yf@vS2p%IH{ zDL|o-FW_4%8(3=UE1jGpvy1N`@v2t>n=901CAr>4w%NNY0@>t|)!=qEXi!kca0;!c zy+J!_*1;@*{9{?wi ~5O zXLbk~V9y=&L^CYWCoCkXs4MzZL?~#(OCn?4EN;Vh51qWZ8-eXWw}V-f=azTWf_ zk3=i7Z8$u*60TbA$uon7tN;YLP02iHvL-xR^OQj8;prSZ-T^h5ckH#d b-~N)t zFF%9#LNE*fd>Qg7yK3rzTHi9`L+wBMWUpr=T+)49e?6ClHbJJwb-y@ `@?vyrV-We8In>tY_9A?{VrdL5&aVcDve+cQ#&aBewue;S6x8mspA zhRwj%Pfngbe^riaWs0{>jdGN$va&Mfi%nO)%k4)?-4jn0tcWM(z4anwgfV1u@D>=~ zLo~`$p|yqs-;kQs;^xFKe_j1a2CiL@#IZVd@gO?1e%4P7CALxhan$w*M3(QW(yx7J zlD@kp$sH`jI~yss&77PoLcZCbY0% $^3T4)PA%lKM zNP(uIwq+>8h0`{Z-Hg$ZjaiPFe#U9vrfm*nBLcI$$Kn>sXgkCPxY`FgLy5aI{B;E7 zpPW7IWFkHTKkXT-jGe^@wX;T~#AbLt7kyQn@;Rbz&dz?Jdkey3T+s13UA6==`osSE zp}{wM!ibYqdCO)+Y`4oZr87-)$;ltIYi~q5sk>-~qJ9
}K&;pOGH! zBK!x(5F8Dp))Z$8Y=}8htq#`!^eRRP?N3>> lOtizI*BE2pt zDZR$clgIx}YoN!F2eYmDSmG<5*0ZbloKY?BnYc*cVfM2 H zoScP|v+#R}>;FGzA KHaoRa|=owZJ+~`vx>adFw#Z%<*s^n;JCf7A|KOUh*_Oud8~Vw z`)p4R;P+wfh#x7x)ln$;6iQT4zN;$aHJa?uVfRl^A!QzDBAT+{fBtpIq(fN5G&^7A zLl{tm`TWVwu#hx6yw~8+ cOz2#l>kLf)Z2t2O03 zUDaB?iHF1yD7kDTK>zLfkKgd0vpqir#A;|~B2w`peMY^zE=Qo=AH8_|5oitQ5_tsL z#sgR2@Pi?27T1P9^0Vup-u0ia55ldWxFe9!5omgvP|hA!<-#Gx@EPEP`{^p*uIr0v zKbI7*>-fv_#x1|CEayWgYkw<5mLk}CCNk4wQ!luYO;y_RvQb}4D|Pd`&jG$$HMntl zzVg;6hw3sJ>M10q?5kUkEyJK#y}{}i)n^s~eYngJbwwb|{G-Q)!b8uY^WKj1!QX70 ze~%;oYR35fPZ%zY@F0^RmvM0*82Qb*-?7|S=piTD@W(@gFA=;2O>7SX@bgclpMQaO z%Es7DdH^Q09biK99-GhLqv7Af=Y +yt$JL5Ds zm4h@ZbZI$&MbZU?VjSsxjcNvP8cs9F)1K~gtz-2ukcoU}@{2DeNEKANS|qqDq^%^0 z;f)RA7;wm@kmwPJ)>Ct{CDwqeVI@h8DlrnIda6*JOoEJ~_fDZ+Rdw`=wuYk0zo$`d zMR8)6^w7vK9McCIj65$gxG*zdrYqlAN2ZRs^AXX0?*qHRMH@O6PWo*g9bWDCwZZIE z+u;WTMTM%0Uehhm;2YDlJ7?U2*V)vQ$53iE>+ko ?zE>a>RdZ2SSfocbgoXQ5F4g9=+ xf(DX`uh@?{4 zPLYA6G TTl)+K(CGpc9ZuRW!?n@oNo^hW}Jb&8X7dSjXTH-P%7 z3?r9_nr85feTZ?}2yOeWrCt5-LS<}O7%La?h3~D&HzhhreAelKqKv1i0s*0yGp-e0 zM}Y&L$Z>m$YoT>>WGaSh()d+*q
6#MQ*Ph_^|RR))z4=V1+Y zl>?{sORGww=h}a$1&`gZ_@Z?4NqD$rIyxwD-Irt5p0C+mq;B{?G5 EWV>ta %yx`VmrqQQi)bX-TN#@?{d+yfr%~vyq zKB&Gub=WyoTf|0L8|kg5u5j}o<#98#c@7XB!FCzSfobFc(`ZlG2FQYn3J`=ILsNq2 z-Cb#e%W1`zf8MJn|Nr&u{uS2)68aTL@pi(9 3}XV0OKO%0P4v~Aw0dEEsUxj zs(rUoiBOsoAu{s$0jr+G18+a|{wnbiF+H>P*+3sEBEu;mV6Unl0+O?2gvqckV4<4M zJ0WG<0D;5RgMa^F(PywF*gE;AtG@LBYilezzU94&^^F_rh}Ghnu-`ts=5cR|g!%{$ z6K&%_=hq^yZ`RaLyk*r{-?_jdFcYIl{q>EelGAvoe~&v|%DaBJy)ANkYv=bLKTs(o zIF~$}GS)E@i!=%)cXTwEks8mts?har&WOxPmfkA4e08Uq>5*nlbq>Bf7qCsb`~LVj zY)tPg*itK10BO}zefoL|`R;s@gRGwHmb9LqiI7R3QB`opP{f7iP{_jcnBHz=9X f4_vng_ezu4QYv3C`#yVfj H=FTMK=t6u1PW5CVlRe6w3f_7c8s-eWTg?9L55S{zRBO>XiXAsEfVa2mAMT$ty zIg`t_Nh%h!v1ApkUQWySkd|ZX9q~5m 0!_=8R+;wlrnBx9)O{r|go@WRZ2U znCne7>QOR$klqZt2O;apw}opj@;FCyN|F^wQ!JS(il}mj-gv7^9!z;%xDn*6%J+c* zjYqD3JML%BSqDX{H8Rp+W2W`16TTQbU%BlrJfXl69Yb8)&{t;e0^yJ7(k_zBVy-O8 z6s?q-OAFoK+zrD1AZru=Hy_j;K cX&p$BF%Fta+p1SC&D0845=*XL;q^PW zz!UdvhnHTjH-)G{RsqxQ$kuW;bPS5S=)L|WxUG-`sHnfO#A)4XQzX9U|HS)i`~!QF zj<2o&dB&^%lVBnP5Qz~wPw3}lzzhe?uKBs#Hgsfy88tm3EiHb|-SXkh>ofcMr _nzb5 c$r@7Rsl8Ja;ugmmx9(f@H` mq+Xr z;UV5apGa;{K=_PDT;WvKd)@@32S;RzIZKR9hJ?1pL5w 0a>G7yg|@&UrD$hMBT;Z `HYJw8}QI+ff*TB{Glor(b-~3bXC-2`Ih}C*3|hYg%ssm}K$R zX~++VXW+99U|Sf8FEu lhVlf)P*QN7_Y`1^ud7TGqr}JC&1_^z}GMYN<4wc_`?Oi*iQhF zr$2mR3sdP>Aq>k#f(abHas&S4*u^8zeRO-gottC&6u=x}aY`ke>j{I!O?l3=x{2wi zm05^sj?}$F3&!&CccVW R?KX3bA0%CD{#5^9cYR{W;PK2Pf7{eW^m83g<_WY zW^rx)A?hgQCR2DASR1ZYrlC)`_*O-f`o6VM2akKHNJ$dI#WN(dUqcC0(3*RpkTwD{ z?tWBj@yDP-i71_LQ+Bi |}BUfCei z_!=oo?wfDaxog0m`3j$$V|6w)>vQS&m(=LNd0K*Z 8k5xKr~*qK7-EQ^;QNuT~*gJX88H*^TFZXMb5*WhnAFyb{QfD zU9p!Xc$u&DepFP4v95tj>IhU`GWXDAt?>=a!>PCYdw3e$3Z^FFBKCIXk3ik>Txhum z&O>X{r~DzvHrN?8r#! WHVk8IVer^)kD-05BlGHeHJ6whfikc4p4kl&z`hRv(XHZe{x02^Eu%8i z4G&0(XQWe-OLVe`lm`f7)PTUe(EaL`I0?~2%aw}iZc8aRS<#Gfy(em}f?j3|dXl8a zJCi~Kv_@%=2IO1!dqH)|kC|Cw5lPo^mDCq0D{Po@<1R}*A2gTvG?Z7MvX-jcUIS}E ztQXvYod+bF03zevn8by8qN`iZ*<6ZG>{q^=mEAAYY )U&c4iUi;+yPQL;*akP zdbHAnbRkIw+G?bK+w_$u(cMiG@yOpJK1(0zp+r2#F ^WO#Mw8!}$BU$yMjloXXp6~GE2@kO{e6(?UZTy94#t&Vlf z8T)j#vsB&9>@9jchubB->C04A 3SKbYhLD$XN>joL>F!fUSqgvDZwW*GCXvB z#W{U&KdZTga1I*fy&1^1=M4{=VT~wS-+ejpSYw=T@8w*PfjWo=d%r;po7E91KDtaH zn#U*;(ZZ#qg%v(fHGqTbBvF)M)aToisVm+t8KKult^3Kx9 hj+Kfb(>5bf+oFpTWNPs8W5qDY`=ekU2IjRL1jH2Y2J!7_}wXvDmwtLPK z X zFg?fj%7FTFocWAlz1?>@6#>VcHL+^7;CZt-Cy6GKgV;!N=7l}pq*&iu7|Tj@)E!Ls z^xeIwbHizY>!|40#)hWkBA}aoZE^Q!dnH$0#(e!T;9xgDwY%u00HMVSJ6WkE!|IqR zrCW~_@zebBl4BF#O=1%SZ BOd9xzb SOPH`~ zjjUEd8w(|Mn7E-@mE8@Eex3(>Y;OW?)P^5{YV6)&+ !e*kV)mz4H@hGS; zmXtA;T$+BDeD_)>wAE*x5d<>FD$LL@tN^s_<|P=?h*ksf7n%pMQZ{B5p;|JZiMeUZ zD
-h;YIM{jl*(O3%_p)
f!A(cTQJ-Fsflj(OH;BBfQCY7+j8mfKVF6FUO-jmx<_6U&K*nUjqujhZQsw=WCCcOe&8r7VF)$c%g?3zkNJBfeW zl4}=~=j+{aKLX|RCD(dTk9$}|)eM*Of6R}Lle#Be!SE*#3-H`$rvdN~jt3n1KExep zi+|n^F*u#{pY28?T|hK&M};8Q0j00Vdc{{{2me6L)xCThzD_z@f6j)xUCq?b14XZ0 zT;ik3t8rdhSl2HJM9JxSRmJGQ@1mjwla*7s3(D~o& #W|Mu)#Kgq9`*eEN zWE)RfAJN6G+51CWH%Ix{f*qgWOBLxCATP}yrG@e<{Ua#i_-_nqnq@#$^8K3PK$Mzt zb;#VqG>I6l)tjz-*mz0KAMT+b+*52Rg3vcjE~CL0RHrb EGk_ZB+V~c259uFB)upPs=5#!K+dBDB>YRFQ<{OS$Bx+)as$8Q zA^p0@4%bo@?>a>L;`%ZO_{Y$<9#=8Av@3YH?6%9;YhiA0#nb!rt5Wp4$C6$Y*`&Yi z@v+GL=)&DTh94gQwl3^I3
k$AN*=V!L%~(1djE@(9#~3R6;L>;*DPuE h1}lHBy%;estmUIr~%FEpnGi z)z+o X{nOy5N6yxGc^B#YL&@BUc(RUeS1?g;kpgVWZj+06nOS$VoO^)-?_lbzh5 z!h0Ff$X84 %lp^gsdq^yh|; zLrx}?N1)#}@vj_^y9R(Khlb%g;NKx`#|aZO0Wg3iryLR6Amhn)w|b~RP?QbQf`T#h za=fdFR8=g~Ak`o5A)arNkEna>U_OwNZ=F8}5iWO`hX-&H4Lrdq`jLfPMHsf4oU5|F zSm(uiqyJ`?F7)d8GXL-R&-i|tLb $MM%D)BGZn$}18>UfGGCbECL>`#A3!5EsB!DGKOc6fW4a91l0rA>sn=%0KUCmo ze_x)-nRy``|Bc%brPM*TN=|Z4R&5uaxcd^@g!0Vfyf*X*y_?7{_G2)fj{Xt3 O06JlU)c#x z`Aa _Sqzu5U *;==m(g^ ?Hm;@(itR5}c%eLpJ;OQ`+Vw%J z&XPu<_8Yg&?ZCQHN7$8C%+)5s|v z5!D4lRT4xo+0}9FnX_4;_-hEDO7RJd3|rX>1QC%| 1CDLlm&B*)k!B(;)&0?%!--4gUjs3>gg1>kbE!{|K8G_Z;2IpzL^@>n2Hg)C$J zf=@8BI=r}lMmqIk3dJ4si_urwCNs*oY(G^N^zvhk=QhcKW|(<6;#r#KP{wk{V9s-x z(5Z3TUDo&W@p<;5PS;y_99CEZdIBf{Ms-PpACdNk5iSgrr;Js$$x-67ad4D+5aGQ3 zI&${BvEZT_wcz3n`NdD7U6HjdwDFHXeqCQub=2?qBF_`9`VYcS%kkPEDa0I4d(y~P z*H;8jJtP-mNT%*r_aeFYs_fntkKvayx=XLgYJJVI`)PvZg}y=nweI;g6M??j-!e0H z4Q|=)ihl~v$o^tZ+i?F{?K^eJ0>_*f1E>}aO1!ZLqKuEi`F&i0p086wMetK{sKZJc zVs)8lL~rcUF@H~X)hzi|dc{g{ye|0zl{UC2s&QRN3HxwHJxmyz)vBlGG4}Y~fS}l= zSk 6mtkrXwJq3gI^u;Qv{VEgo78b`$ zz8BDn{&qMsH1wrEJ7HkDWa*_0bw*R#@~$}Ra_HEk`v(Ck-rx2BRdSu~vlmYSUKkOG zv{om_A`I}kNGk-b^_ajqAug>qzZ^fo*stbj%^P?j&`alza$NwE7fT1jd-0qCi>%50 z6z7q}O&op0>Q={WM@!hG+~BmaA$H_`4CHAORX-0CuQ`=GW!1CmFTzJw7}tdSjt& z4Z`S@7CSika{Smt1*hnMU?E-mnBm*NDTyqas{y=b#W@!kC5XBC60Z2FK!n_);Vo+Z z!| _3+7lJ8RLx)_f^mDI1lhe6IGSgN2G11ZtL6*)`=W8 z%K4G2sq0OL+JBpsh&zkrn2Q=~nf(sul)L7uj!}A-?U`Wr&b6ERELQ)U%`o~ix}!oM z@=O;yZP^=cCoA5(27HP?KTfp@ZPh* WQypgM8)OJ_nnckKvJhfkNsj5s! z*7aC&XK{Y`+`I$Fip|2ncJHFCaF@Zs0DGr8YTs8{tl4@D5p?z5`g?rYR$V8@mP`p{ zvYe$(BR}~P0FVPXZ2 B&lV_{b71cDZUiwX>F;ZC>e|W0?R_;cN zg<@~P?y?nWdF84HyhyjU02{yi04-OJlD##jGw5(OYjI+-YrE%C&z%J(*BD0gS42wc zAfm5&v4qbJ5R6h0+y=4kXSQ{C$lb;|c*Df6H3t9oG7cYdc2Ult@bsw}Dk{AM|1V%> ze|~^yj_LxI2sIthATV5~Jlh>M`kk-;d)@jCj3A%SvmSR9?VDS#jc m~ $X^ksKq!%r#`1-54G>zr*Zol^MLgj z)D#s0D+6F^0jBm8Cc-6b S!iA(c6olt z0ORm)l4HgQy+B$Z&tTzgWA~ Dm9zha4RyD%k%b(6;@>M>{0hj HHg?u!b{*Ej%B4V$o_ucOsjKJXK6Q>oKdWaT$xqQk7g-|I zQp^1LhQV~Oz?|h(U0H=kS0`ehgS93`LIJj9p>$s$edA@vp$}~2{2`@r&A>V?LVn 9W5O-!2-n+#7-s!hB9 |=$_8qz;Vj>7F?y(Np=tPWq+wuPoTV9NWB&z-R&3qICrRA)npk*&A9cEq z?LYNiW1>1}!lZ!M4+r{18=a?5tDNxA Fk16+@Pu?q>-z+dcU}lkl%8E`NjZZPLVx#XLBGoSwyqP_`Q1ZJG$^kN=io5) z3~*kFj5)s<+TVwpZ8ikKOrPxP-WYbiyGKo8!}3-k{&nuNhf&T>v75TfY1Lm|{5fc4 zq}PJnKM(BKL%SnTx=F3UI4w@qyTlZo{tv^@&! zVk31rdCKAqQAvDQC)3@QAimd3goj&5A165