huncode/progcode
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

revise August 2026 observability plan articles
Build and deploy / deploy (push) Successful in 17s
Details

Browse Source
This commit is contained in:
huncode
2026-07-31 19:48:30 +03:00
parent f312d7a598
commit c331bb5939
7 changed files with 370 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files
web/public/assets/editorial/2026/end-to-end-observability-2026-cardinality-sampling-tradeoff.svg
+12
View File
@@ -0,0 +1,12 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 720 900" role="img" aria-labelledby="title desc">
<title id="title">Cardinality и sampling — разные оси решения</title><desc id="desc">Слева низкокардинальные классы, справа индивидуальные данные; внизу sampling относится только к traces.</desc>
<rect width="720" height="900" fill="#101827"/><style>text{font-family:Arial,sans-serif;fill:#f8fafc}.h{font-size:29px;font-weight:700}.s{font-size:19px;fill:#cbd5e1}.n{font-size:23px;font-weight:700}.b{font-size:20px}.safe{fill:#103b39;stroke:#59dbc8;stroke-width:3}.risk{fill:#3b202b;stroke:#fb7185;stroke-width:3}.line{stroke:#94a3b8;stroke-width:4}</style>
<text x="40" y="55" class="h">Cardinality не лечится sampling</text><text x="40" y="85" class="s">Сначала форма поля, затем объём будущей trace-выборки.</text>
<line x1="360" y1="135" x2="360" y2="610" class="line"/><text x="65" y="145" class="n">МАЛЫЙ СЛОВАРЬ</text><text x="425" y="145" class="n">ЛИЧНЫЕ ПОЛЯ</text>
<rect x="48" y="180" width="270" height="115" rx="16" class="safe"/><text x="75" y="222" class="b">job-kind</text><text x="75" y="260" class="s">ограниченный класс</text>
<rect x="48" y="330" width="270" height="115" rx="16" class="safe"/><text x="75" y="372" class="b">outcome-class</text><text x="75" y="410" class="s">ограниченный исход</text>
<rect x="402" y="180" width="270" height="115" rx="16" class="risk"/><text x="429" y="222" class="b">email / raw user id</text><text x="429" y="260" class="s">не metric label</text>
<rect x="402" y="330" width="270" height="115" rx="16" class="risk"/><text x="429" y="372" class="b">URL query / text</text><text x="429" y="410" class="s">не свободный attribute</text>
<rect x="48" y="525" width="624" height="170" rx="16" class="safe"/><text x="78" y="570" class="n">SAMPLING — ОТДЕЛЬНЫЙ PLAN RULE</text><text x="78" y="610" class="b">fixed error-or-1-of-20</text><text x="78" y="650" class="s">Выбирает synthetic traces. Не разрешает новые поля.</text>
<text x="48" y="790" class="n">Сначала fields, потом trace rule</text><text x="48" y="830" class="s">Нет measured cost, coverage или production configuration.</text>
</svg>
Side by Side

After

Width:  |  Height:  |  Size: 2.4 KiB

web/public/assets/editorial/2026/end-to-end-observability-2026-investigation-evidence-loop.svg
+16
View File
@@ -0,0 +1,16 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 720 900" role="img" aria-labelledby="title desc">
<title id="title">Цикл планового investigation hand-off</title><desc id="desc">Вопрос проходит проверки context, data boundary и sampling; успех передаёт synthetic plan, ошибки возвращают named stop.</desc>
<rect width="720" height="900" fill="#101827"/><style>text{font-family:Arial,sans-serif;fill:#f8fafc}.h{font-size:29px;font-weight:700}.s{font-size:19px;fill:#cbd5e1}.n{font-size:22px;font-weight:700}.b{font-size:19px}.box{fill:#172b4d;stroke:#69a7ff;stroke-width:3}.ok{fill:#103b39;stroke:#59dbc8;stroke-width:3}.stop{fill:#3b202b;stroke:#fb7185;stroke-width:3}.a{stroke:#59dbc8;stroke-width:5;fill:none}.r{stroke:#fb7185;stroke-width:5;fill:none}</style>
<text x="40" y="55" class="h">Плановый evidence loop</text><text x="40" y="85" class="s">Не field report: только будущая область investigation.</text>
<rect x="52" y="140" width="270" height="110" rx="16" class="box"/><text x="78" y="182" class="n">1. ВОПРОС</text><text x="78" y="218" class="b">один named path</text>
<rect x="398" y="140" width="270" height="110" rx="16" class="box"/><text x="424" y="182" class="n">2. CONTEXT</text><text x="424" y="218" class="b">UI → API → worker</text>
<path d="M322 195h74" class="a"/><path d="M382 181l16 14-16 14" fill="#59dbc8"/>
<rect x="398" y="350" width="270" height="110" rx="16" class="box"/><text x="424" y="392" class="n">3. DATA BOUNDARY</text><text x="424" y="428" class="b">allow-list, no payload</text>
<path d="M533 250v96" class="a"/><path d="M519 332l14 16 14-16" fill="none" stroke="#59dbc8" stroke-width="5"/>
<rect x="52" y="350" width="270" height="110" rx="16" class="box"/><text x="78" y="392" class="n">4. SAMPLING</text><text x="78" y="428" class="b">rule + boundary</text>
<path d="M398 405h-74" class="a"/><path d="M338 391l-16 14 16 14" fill="#59dbc8"/>
<rect x="155" y="570" width="410" height="130" rx="16" class="ok"/><text x="190" y="618" class="n">5. SYNTHETIC HAND-OFF</text><text x="190" y="657" class="b">review only · production effect: not attempted</text>
<path d="M187 460c0 55 100 70 170 105" class="a"/><path d="M345 551l16 15-22 3" fill="#59dbc8"/>
<path d="M533 460c0 55-100 70-170 105" class="a"/><path d="M381 551l-16 15 22 3" fill="#59dbc8"/>
<path d="M668 195h28v265h-28" class="r"/><text x="205" y="770" class="n" fill="#fda4af">нет boundary → stop</text><text x="62" y="830" class="s">Stop называет недостающий факт; не подбирает похожий evidence.</text>
</svg>
Side by Side

After

Width:  |  Height:  |  Size: 2.6 KiB

web/public/assets/editorial/2026/end-to-end-observability-2026-signal-boundary-map.svg
+11
View File
@@ -0,0 +1,11 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 720 900" role="img" aria-labelledby="title desc">
<title id="title">Карта сигналов UI API worker</title><desc id="desc">Три границы одного планового пути с trace context, разными сигналами и списком запрещённых полей.</desc>
<rect width="720" height="900" fill="#101827"/><style>text{font-family:Arial,sans-serif;fill:#f8fafc}.h{font-size:29px;font-weight:700}.s{font-size:19px;fill:#cbd5e1}.n{font-size:22px;font-weight:700}.b{font-size:19px}.box{fill:#172b4d;stroke:#69a7ff;stroke-width:3}.warn{fill:#3b202b;stroke:#fb7185;stroke-width:3}.ok{fill:#103b39;stroke:#59dbc8;stroke-width:3}</style>
<text x="40" y="55" class="h">План: один context, три сигнала</text><text x="40" y="85" class="s">Август 2026 · источники до 31.07 · не production trace</text>
<rect x="48" y="130" width="624" height="150" rx="16" class="box"/><text x="76" y="170" class="n">1. UI</text><text x="76" y="207" class="b">span: ui.checkout.submit</text><text x="76" y="240" class="s">context: fixed-trace-7f · route-template</text>
<path d="M360 280v48" stroke="#59dbc8" stroke-width="5"/><path d="M346 314l14 16 14-16" fill="none" stroke="#59dbc8" stroke-width="5"/>
<rect x="48" y="340" width="624" height="150" rx="16" class="ok"/><text x="76" y="380" class="n">2. API</text><text x="76" y="417" class="b">log: api.accepted</text><text x="76" y="450" class="s">context переносится · outcome-class</text>
<path d="M360 490v48" stroke="#59dbc8" stroke-width="5"/><path d="M346 524l14 16 14-16" fill="none" stroke="#59dbc8" stroke-width="5"/>
<rect x="48" y="550" width="624" height="150" rx="16" class="box"/><text x="76" y="590" class="n">3. Worker</text><text x="76" y="627" class="b">metric: worker.jobs</text><text x="76" y="660" class="s">context проверен · job-kind + outcome-class</text>
<rect x="48" y="750" width="624" height="105" rx="16" class="warn"/><text x="76" y="790" class="n">НЕ ДОБАВЛЯТЬ</text><text x="76" y="825" class="b">email · raw user id · free text · URL query</text>
</svg>
Side by Side

After

Width:  |  Height:  |  Size: 2.2 KiB