Tracing documentation (#1331)

Author: domwst

ydb/docs/ru/core/cluster/toc_i.yaml

@@ -19,6 +19,8 @@ items:
       href: ../administration/grafana-dashboards.md
     - name: Справочник метрик
       href: ../reference/observability/metrics/index.md
+    - name: Трассировка
+      include: { mode: link, path: ../reference/observability/tracing/toc_p.yaml }
 - name: Обновление
   href: ../administration/upgrade.md
 - name: Изменение конфигурации актор-системы

ydb/docs/ru/core/concepts/_includes/index/how_it_works.md

@@ -2,7 +2,7 @@
 
 Полное объяснение того, как работает YDB, получилось бы слишком объемным. Ниже вы можете ознакомиться с несколькими основными моментами, а затем продолжить изучение документации, чтобы узнать больше.
 
-### Архитектура YDB
+### Архитектура YDB {#ydb-architecture}
 
 ![Архитектура YDB](https://storage.yandexcloud.net/ydb-www-prod-site-assets/howitworks/grps.png)
 

ydb/docs/ru/core/maintenance/manual/dynamic-config.md

@@ -127,7 +127,9 @@ vim dynconfig.yaml
 * `log_config`;
 * `immediate_controls_config`;
 * `table_service_config`;
-* `monitoring_config`.
+* `monitoring_config`;
+* `tracing_config.sampling`;
+* `tracing_config.external_throttling`.
 
 В будущем список может быть расширен.
 

ydb/docs/ru/core/reference/observability/tracing/_images/spans.png

@@ -0,0 +1,22 @@
+# Передача внешнего trace-id в {{ ydb-short-name }}
+
+## gRPC API
+
+{{ ydb-short-name }} поддерживает передачу внешних trace-id для построения цельной трассы операции. Передача trace-id производится согласно [спецификации trace context](https://w3c.github.io/trace-context/#traceparent-header) — через заголовок `traceparent` gRPC запроса должна передаваться строка вида `00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01`. Она состоит из 4 частей, разделенных символом `-`:
+
+1. Версия – на момент написания документации спецификация определяет только версию 00.
+1. Trace id – идентификатор трассы, частью которой является запрос.
+1. Parent id – идентификатор родительского спана.
+1. Флаги – набор рекомендаций по работе с переданными в заголовке данными.
+
+Только версия 00 поддерживается, флаги игнорируются. Если заголовок не соответствует спецификации, он игнорируется. Все получаемые таким образом трассы имеют [уровень детализации](./setup.md#tracing-levels) 13 (все компоненты трассируются с уровнем `Detailed`).
+
+{% note warning %}
+
+При наличии секции [`external_throttling`](./setup.md#external-throttling) и потоке запросов, превышающем установленные лимиты, могут трассироваться не все запросы. При отсутствии секции [`external_throttling`](./setup.md#external-throttling) заголовок `traceparent` **игноруется** и никакие внешние трассы не продолжаются.
+
+{% endnote %}
+
+## Поддержка SDK
+
+Некоторые SDK поддерживают передачу trace-id, их список, а так же примеры использования вы можете найти на странице [{#T}](../../../reference/ydb-sdk/recipes/debug-jaeger.md).

ydb/docs/ru/core/reference/observability/tracing/external-traces.md

@@ -0,0 +1,5 @@
+items:
+- name: Настройка
+  href: setup.md
+- name: Передача внешнего trace-id
+  href: external-traces.md

ydb/docs/ru/core/reference/observability/tracing/setup.md

@@ -0,0 +1,2 @@
+items:
+  - include: { mode: link, path: toc_i.yaml }