revise September 2020 tracing articles

2026-07-31 11:47:30 +03:00
parent 8e16858f16
commit 6c96a2a338
7 changed files with 932 additions and 1 deletions
@@ -0,0 +1,55 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 720 1230" role="img" aria-labelledby="title desc">
+  <title id="title">Передача учебного trace context через две границы</title>
+  <desc id="desc">Вертикальная схема показывает, как gateway создаёт span A, передаёт traceparent с общим trace-id и своим span-id, catalog создаёт child span B, а затем передаёт свой span-id к inventory. Trace-id остаётся общим.</desc>
+  <style>
+    .bg { fill: #071a2b; }
+    .card { fill: #0d2a42; stroke: #35607f; stroke-width: 2; }
+    .blue { fill: #31b8ff; }
+    .cyan { fill: #b8ecff; }
+    .muted { fill: #b6d0e4; font-family: Inter, Arial, sans-serif; }
+    .text { fill: #eaf6ff; font-family: Inter, Arial, sans-serif; }
+    .title { font-size: 32px; font-weight: 700; }
+    .subtitle { font-size: 21px; }
+    .label { font-size: 27px; font-weight: 700; }
+    .meta { font-size: 21px; font-weight: 600; }
+    .code { fill: #eaf6ff; font-family: Menlo, Consolas, monospace; font-size: 20px; }
+  </style>
+  <rect class="bg" width="720" height="1230" rx="34" />
+  <text class="text title" x="48" y="66">Trace context на границе</text>
+  <text class="muted subtitle" x="48" y="104">Учебная version 00; без реального HTTP</text>
+
+  <rect class="card" x="42" y="140" width="636" height="150" rx="20" />
+  <circle class="blue" cx="94" cy="204" r="24" />
+  <text class="text label" x="136" y="194">1. gateway создаёт span A</text>
+  <text class="muted meta" x="136" y="230">trace-id: общий для истории</text>
+  <text class="muted meta" x="136" y="262">span-id: A · parent: нет</text>
+
+  <line class="blue" x1="360" y1="310" x2="360" y2="350" stroke-width="8" stroke-linecap="round" />
+  <polygon class="blue" points="344,344 376,344 360,370" />
+
+  <rect class="card" x="42" y="390" width="636" height="174" rx="20" />
+  <text class="text label" x="70" y="432">inject: короткий carrier</text>
+  <text class="code" x="70" y="474">traceparent: 00-trace-id-span-A-01</text>
+  <text class="muted meta" x="70" y="514">trace-id не меняется</text>
+  <text class="muted meta" x="70" y="544">parent-id — текущий span вызывающей стороны</text>
+
+  <line class="blue" x1="360" y1="584" x2="360" y2="624" stroke-width="8" stroke-linecap="round" />
+  <polygon class="blue" points="344,618 376,618 360,644" />
+
+  <rect class="card" x="42" y="664" width="636" height="166" rx="20" />
+  <circle class="blue" cx="94" cy="730" r="24" />
+  <text class="text label" x="136" y="720">2. catalog делает extract</text>
+  <text class="muted meta" x="136" y="756">создаёт span B с parent = A</text>
+  <text class="muted meta" x="136" y="790">trace-id остаётся тем же</text>
+
+  <line class="blue" x1="360" y1="850" x2="360" y2="890" stroke-width="8" stroke-linecap="round" />
+  <polygon class="blue" points="344,884 376,884 360,910" />
+
+  <rect class="card" x="42" y="930" width="636" height="188" rx="20" />
+  <circle class="blue" cx="94" cy="994" r="24" />
+  <text class="text label" x="136" y="984">3. inventory получает span B</text>
+  <text class="muted meta" x="136" y="1020">новый child получит parent = B</text>
+  <text class="muted meta" x="136" y="1054">меняется span-id, не trace-id</text>
+  <rect class="blue" x="70" y="1076" width="580" height="2" />
+  <text class="cyan meta" x="70" y="1106">Не передаём URL, пользователя, token или body</text>
+</svg>