Document embedded and service tracing across all languages

docs/monitoring.md

@@ -71,6 +71,32 @@ alongside this guide. That contract separates at-least-once transport
 uncertainty from duplicate durable outcomes so duplicate-looking evidence does
 not turn into the wrong operational conclusion.
 
+:::tip Embedded Laravel trace correlation
+
+To correlate application logs with a workflow run and activity attempt, configure
+the optional [embedded tracing integration](https://github.com/durable-workflow/workflow/blob/main/docs/embedded-tracing.md).
+It persists W3C context across queue workers, retries and recovery and uses your
+application's OpenTelemetry provider and Laravel log channels. Follow the guide
+to enable tracing, add the log tap, run the schema migrations and configure
+bounded exports. Review its span diagram and runtime/SDK capability matrix
+before rollout.
+
+:::
+
+### Service-mode tracing
+
+Configure the application's provider, sampling, propagators and bounded exporter before enabling SDK telemetry. Use the [PHP tracing guide](https://php.durable-workflow.com/operate/tracing/), [Python telemetry guide](https://python.durable-workflow.com/telemetry/) or [Rust telemetry API](https://rust.durable-workflow.com/durable_workflow/telemetry/).
+
+| Runtime | Propagation boundary |
+| --- | --- |
+| Embedded Laravel | The application's optional Core integration persists context across its queue workers. |
+| PHP Server | The [Server trace-context guide](https://github.com/durable-workflow/server/blob/2.10.0/docs/observability-context.md) requires an application image with the optional API, enabled flag and actual nullable schema. |
+| PHP, Python and Rust SDKs | Opt-in task/attempt spans and scoped log correlation. Durable caller propagation requires the exact advertised Server capability. Missing or malformed capability uses independent task traces. |
+| Native Rust Server | This PHP tracing release does not qualify native carrier support or catalog conversion. |
+| Cloud | This release includes no Cloud deployment. Confirm support with the managed runtime. |
+
+Trace IDs, durable run/activity/attempt IDs and application request IDs remain distinct. Baggage is allowlisted and empty by default; links carry no baggage. Providers and exporters remain application-owned. Abrupt termination can lose telemetry, and replay does not promise exactly-once export. Use durable history for business outcomes.
+
 ### Dashboard View
 
 ![Waterline dashboard](https://raw.githubusercontent.com/durable-workflow/waterline/refs/heads/main/docs/screenshots/dashboard.png)

i18n/de/docusaurus-plugin-content-docs/current/monitoring.md

@@ -39,6 +39,33 @@ Die Einrichtung von Workern und Clients bleibt ebenfalls von der Operatoroberfl
 
 Zeigt Worker-Telemetrie wiederholte Übernahmen, Rennen um verspätete Abschlüsse oder feststeckende Leases, lesen Sie zusätzlich [Ausführungsgarantien und Idempotenz](./constraints/execution-guarantees.md). Dieser Vertrag trennt Unsicherheit des At-least-once-Transports von doppelten dauerhaften Ergebnissen, damit scheinbar doppelte Nachweise nicht zu falschen Betriebsentscheidungen führen.
 
+:::tip Trace-Korrelation in Embedded Laravel
+
+Um Anwendungslogs einem Workflow-Lauf und Aktivitätsversuch zuzuordnen, konfigurieren
+Sie die optionale [Tracing-Integration im eingebetteten Modus (Englisch)](https://github.com/durable-workflow/workflow/blob/main/docs/embedded-tracing.md).
+Sie bewahrt den W3C-Kontext über Warteschlangen-Worker, Wiederholungen und
+Wiederherstellung hinweg und nutzt den OpenTelemetry-Provider sowie die
+Laravel-Logkanäle Ihrer Anwendung. Der Leitfaden erklärt, wie Sie Tracing
+aktivieren, den Log-Tap hinzufügen, die Schema-Migrationen ausführen und Exporte
+begrenzen. Prüfen Sie vor dem Rollout das Span-Diagramm und die
+Fähigkeitsmatrix für Laufzeiten und SDKs.
+
+:::
+
+### Tracing im Service-Modus {#service-mode-tracing}
+
+Konfigurieren Sie Provider, Sampling, Propagatoren und begrenzten Export, bevor Sie SDK-Telemetrie aktivieren. Nutzen Sie den [PHP-Leitfaden](https://php.durable-workflow.com/operate/tracing/), den [Python-Leitfaden](https://python.durable-workflow.com/telemetry/) oder die [Rust-API](https://rust.durable-workflow.com/durable_workflow/telemetry/) auf Englisch.
+
+| Runtime | Propagationsgrenze |
+| --- | --- |
+| Eingebettetes Laravel | Die optionale Core-Integration der Anwendung speichert Kontext über ihre Queue-Worker hinweg. |
+| PHP Server | Der [Server-Leitfaden](https://github.com/durable-workflow/server/blob/2.10.0/docs/observability-context.md) erfordert ein Anwendungsimage mit optionaler API, aktiviertem Schalter und tatsächlichem nullable Schema. |
+| PHP-, Python- und Rust-SDKs | Optionale Task-/Versuchs-Spans und begrenzter Log-Kontext. Dauerhafte Aufruferpropagation erfordert die exakt angekündigte Server-Fähigkeit. Fehlt sie oder ist sie fehlerhaft, entstehen unabhängige Task-Traces. |
+| Nativer Rust Server | Diese PHP-Tracing-Version qualifiziert weder native Carrier noch Katalogkonvertierung. |
+| Cloud | Diese Version enthält kein Cloud-Deployment. Prüfen Sie die Unterstützung der verwalteten Runtime. |
+
+Trace-, Run-, Activity-, Versuchs- und Anfrage-IDs bleiben getrennt. Baggage ist auf eine standardmäßig leere Positivliste beschränkt; Links enthalten kein Baggage. Provider und Exporter gehören der Anwendung. Abrupte Beendigung kann Telemetrie verlieren; Replay garantiert keinen genau einmaligen Export. Für Geschäftsergebnisse gilt die dauerhafte History.
+
 ### Dashboard-Ansicht {#dashboard-view}
 
 ![Waterline-Dashboard](https://raw.githubusercontent.com/durable-workflow/waterline/refs/heads/main/docs/screenshots/dashboard.png)

i18n/de/source-hashes.json

@@ -62,7 +62,7 @@
   "laravel-adoption.md": "978f2333bf5ce38ebc58619ca3f50a087572a3b0c28d52bc06843bc341010684",
   "mcp-workflows.md": "1c0b5bb7f2e5c7ca835dfdfa57bbe8f6624172c855f4e225057ac2377abf360e",
   "migration.md": "53659987d64f3fc66c935bed55ec4227689185a23970f31327773fa408f5cf22",
-  "monitoring.md": "28bc87ab65b4ef8e466f12114cc56dd60f4216f1f163ec84defec1a030ec320e",
+  "monitoring.md": "e8a0051bf533658287b028cb20dbc1cfff710797ba5bccccd2f41b699606d7bb",
   "operator-operating-envelope.md": "c106e192b3716b8e2d14ffc84b3b2837b25792a7c3a9493d14dc6dd29ae9dee5",
   "platform-conformance.md": "2eec7eba9a65c010e03c4b2eb78afe4dddd6fd8170218b3194c49e3777124c91",
   "platform-protocol-specs.md": "ba9c69adfca7fb4a0dd982464b0ca69dd5a21de1e340edbe23b075ec0fb0c35c",

i18n/es/docusaurus-plugin-content-docs/current/monitoring.md

@@ -70,6 +70,32 @@ junto con esta guía. Ese contrato distingue la incertidumbre del transporte con
 entrega al menos una vez de los resultados duraderos duplicados, para evitar
 conclusiones operativas incorrectas ante evidencia que parece duplicada.
 
+:::tip Correlación de trazas en Laravel embebido
+
+Para relacionar los logs de la aplicación con una ejecución de workflow y un
+intento de actividad, configura la [integración opcional de trazas del modo embebido (en inglés)](https://github.com/durable-workflow/workflow/blob/main/docs/embedded-tracing.md).
+Conserva el contexto W3C entre workers de cola, reintentos y recuperación, y usa
+el proveedor OpenTelemetry y los canales de logs de Laravel de tu aplicación.
+La guía explica cómo activar las trazas, añadir el tap de logs, ejecutar las
+migraciones del esquema y limitar las exportaciones. Revisa el diagrama de spans
+y la matriz de capacidades de runtimes y SDKs antes del despliegue.
+
+:::
+
+### Trazas en modo servicio {#service-mode-tracing}
+
+Configure el proveedor, muestreo, propagadores y exportación acotada antes de activar la telemetría del SDK. Consulte la [guía PHP](https://php.durable-workflow.com/operate/tracing/), la [guía Python](https://python.durable-workflow.com/telemetry/) o la [API Rust](https://rust.durable-workflow.com/durable_workflow/telemetry/) en inglés.
+
+| Runtime | Límite de propagación |
+| --- | --- |
+| Laravel embebido | La integración Core opcional conserva contexto entre los workers de cola de la aplicación. |
+| Servidor PHP | La [guía del servidor](https://github.com/durable-workflow/server/blob/2.10.0/docs/observability-context.md) exige una imagen de aplicación con la API opcional, la opción activada y el esquema nullable real. |
+| SDK PHP, Python y Rust | Spans opcionales de tarea/intento y correlación acotada de logs. La propagación duradera exige la capacidad exacta anunciada por el servidor. Si falta o es inválida, se usan trazas de tarea independientes. |
+| Servidor Rust nativo | Esta versión PHP no cualifica carriers nativos ni conversión del catálogo. |
+| Cloud | Esta versión no incluye despliegue en Cloud. Confirme el soporte del runtime gestionado. |
+
+Los identificadores de traza, run, actividad, intento y petición siguen separados. Baggage usa una lista permitida, vacía por defecto; los enlaces no contienen baggage. La aplicación controla proveedores y exportadores. Una terminación abrupta puede perder telemetría; el replay no garantiza exportación exactamente una vez. Use el historial duradero para los resultados de negocio.
+
 ### Vista del panel {#dashboard-view}
 
 ![Panel de Waterline](https://raw.githubusercontent.com/durable-workflow/waterline/refs/heads/main/docs/screenshots/dashboard.png)

i18n/es/source-hashes.json

@@ -62,7 +62,7 @@
   "laravel-adoption.md": "978f2333bf5ce38ebc58619ca3f50a087572a3b0c28d52bc06843bc341010684",
   "mcp-workflows.md": "1c0b5bb7f2e5c7ca835dfdfa57bbe8f6624172c855f4e225057ac2377abf360e",
   "migration.md": "53659987d64f3fc66c935bed55ec4227689185a23970f31327773fa408f5cf22",
-  "monitoring.md": "28bc87ab65b4ef8e466f12114cc56dd60f4216f1f163ec84defec1a030ec320e",
+  "monitoring.md": "e8a0051bf533658287b028cb20dbc1cfff710797ba5bccccd2f41b699606d7bb",
   "operator-operating-envelope.md": "c106e192b3716b8e2d14ffc84b3b2837b25792a7c3a9493d14dc6dd29ae9dee5",
   "platform-conformance.md": "2eec7eba9a65c010e03c4b2eb78afe4dddd6fd8170218b3194c49e3777124c91",
   "platform-protocol-specs.md": "ba9c69adfca7fb4a0dd982464b0ca69dd5a21de1e340edbe23b075ec0fb0c35c",

i18n/fr/docusaurus-plugin-content-docs/current/monitoring.md

@@ -70,6 +70,33 @@ Ce contrat distingue l'incertitude du transport au moins une fois des résultats
 durables dupliqués, pour éviter les mauvaises conclusions face à des preuves
 qui ressemblent à des doublons.
 
+:::tip Corrélation des traces dans Laravel embarqué
+
+Pour relier les logs de l'application à une exécution de workflow et à une
+tentative d'activité, configurez l'[intégration facultative de traçage en mode embarqué (en anglais)](https://github.com/durable-workflow/workflow/blob/main/docs/embedded-tracing.md).
+Elle conserve le contexte W3C entre les workers de file, les nouvelles tentatives
+et la reprise, et utilise le fournisseur OpenTelemetry ainsi que les canaux de
+logs Laravel de votre application. Le guide explique comment activer le traçage,
+ajouter le tap de logs, exécuter les migrations du schéma et borner les exports.
+Consultez le diagramme des spans et la matrice des capacités des runtimes et SDK
+avant le déploiement.
+
+:::
+
+### Traçage en mode service {#service-mode-tracing}
+
+Configurez le fournisseur, l'échantillonnage, les propagateurs et un export borné avant d'activer la télémétrie du SDK. Consultez le [guide PHP](https://php.durable-workflow.com/operate/tracing/), le [guide Python](https://python.durable-workflow.com/telemetry/) ou l'[API Rust](https://rust.durable-workflow.com/durable_workflow/telemetry/) (en anglais).
+
+| Runtime | Limite de propagation |
+| --- | --- |
+| Laravel embarqué | L'intégration Core facultative conserve le contexte entre les workers de l'application. |
+| Serveur PHP | Le [guide du serveur](https://github.com/durable-workflow/server/blob/2.10.0/docs/observability-context.md) exige une image applicative avec l'API facultative, l'option activée et le schéma nullable réel. |
+| SDK PHP, Python et Rust | Spans de tâches/tentatives et corrélation des logs sur activation. La propagation durable exige la capacité exacte annoncée par le serveur. Une capacité absente ou mal formée produit des traces de tâches indépendantes. |
+| Serveur Rust natif | Cette version PHP ne qualifie ni les carriers natifs ni la conversion du catalogue. |
+| Cloud | Cette version ne déploie rien dans Cloud. Vérifiez le support du runtime géré. |
+
+Les identifiants de trace, de run, d'activité, de tentative et de requête restent distincts. Le baggage utilise une liste autorisée, vide par défaut; les liens n'en contiennent pas. L'application possède les fournisseurs et exporteurs. Un arrêt brutal peut perdre la télémétrie; le replay ne garantit pas un export exactement une fois. L'historique durable fait foi pour les résultats métier.
+
 ### Vue du tableau de bord {#dashboard-view}
 
 ![Tableau de bord Waterline](https://raw.githubusercontent.com/durable-workflow/waterline/refs/heads/main/docs/screenshots/dashboard.png)

i18n/fr/source-hashes.json

@@ -62,7 +62,7 @@
   "laravel-adoption.md": "978f2333bf5ce38ebc58619ca3f50a087572a3b0c28d52bc06843bc341010684",
   "mcp-workflows.md": "1c0b5bb7f2e5c7ca835dfdfa57bbe8f6624172c855f4e225057ac2377abf360e",
   "migration.md": "53659987d64f3fc66c935bed55ec4227689185a23970f31327773fa408f5cf22",
-  "monitoring.md": "28bc87ab65b4ef8e466f12114cc56dd60f4216f1f163ec84defec1a030ec320e",
+  "monitoring.md": "e8a0051bf533658287b028cb20dbc1cfff710797ba5bccccd2f41b699606d7bb",
   "operator-operating-envelope.md": "c106e192b3716b8e2d14ffc84b3b2837b25792a7c3a9493d14dc6dd29ae9dee5",
   "platform-conformance.md": "2eec7eba9a65c010e03c4b2eb78afe4dddd6fd8170218b3194c49e3777124c91",
   "platform-protocol-specs.md": "ba9c69adfca7fb4a0dd982464b0ca69dd5a21de1e340edbe23b075ec0fb0c35c",

i18n/ja/docusaurus-plugin-content-docs/current/monitoring.md

@@ -39,6 +39,31 @@ Worker・クライアントの設定も運用インターフェースと別で
 
 Worker テレメトリに繰り返しの取得、遅延完了の競合、停止したリースがある場合は、このガイドと[実行保証と冪等性](./constraints/execution-guarantees.md)を併読してください。この契約は、少なくとも一回の配送で生じる不確実性と、永続結果の重複を分離し、重複して見える証拠から誤った運用判断をしないようにします。
 
+:::tip 組み込み Laravel のトレース相関
+
+アプリケーションログをワークフロー実行やアクティビティの試行に関連付けるには、
+任意の[組み込みモードのトレース連携（英語）](https://github.com/durable-workflow/workflow/blob/main/docs/embedded-tracing.md)を設定します。
+キュー Worker、再試行、復旧をまたいで W3C コンテキストを保持し、アプリケーションの
+OpenTelemetry プロバイダーと Laravel ログチャネルを使用します。ガイドでは、
+トレースの有効化、ログ tap の追加、スキーマ移行の実行、エクスポートの制限を説明します。
+ロールアウト前に、Span の関係図とランタイム・SDK の機能対応表を確認してください。
+
+:::
+
+### サービスモードのトレース {#service-mode-tracing}
+
+SDK のテレメトリーを有効にする前に、アプリケーションの provider、サンプリング、propagator、上限付きのエクスポートを設定してください。[PHP ガイド](https://php.durable-workflow.com/operate/tracing/)、[Python ガイド](https://python.durable-workflow.com/telemetry/)、[Rust API](https://rust.durable-workflow.com/durable_workflow/telemetry/)を参照してください（英語）。
+
+| Runtime | 伝播の範囲 |
+| --- | --- |
+| 組み込み Laravel | 任意の Core 統合が、アプリケーションのキューワーカー間でコンテキストを永続化します。 |
+| PHP Server | [Server ガイド](https://github.com/durable-workflow/server/blob/2.10.0/docs/observability-context.md)に従い、任意の API、有効な設定フラグ、実際の nullable スキーマを備えたアプリケーションイメージが必要です。 |
+| PHP、Python、Rust SDK | 任意のタスク・試行 span とスコープ付きログ相関。呼び出し元コンテキストの永続的な伝播には、Server が通知する正確な capability が必要です。欠落または不正な場合、タスクごとの独立したトレースになります。 |
+| ネイティブ Rust Server | この PHP リリースは、ネイティブ carrier やカタログ変換を認定しません。 |
+| Cloud | このリリースには Cloud へのデプロイを含みません。管理対象 runtime の対応を確認してください。 |
+
+trace、run、activity、attempt、request の ID は別々です。baggage は既定で空の許可リストに制限され、link には含まれません。provider と exporter はアプリケーションが管理します。突然の終了でテレメトリーが失われる場合があり、replay は exactly-once エクスポートを保証しません。業務結果の確認には永続履歴を使用してください。
+
 ### ダッシュボードビュー {#dashboard-view}
 
 ![Waterline ダッシュボード](https://raw.githubusercontent.com/durable-workflow/waterline/refs/heads/main/docs/screenshots/dashboard.png)

i18n/ja/source-hashes.json

@@ -62,7 +62,7 @@
   "laravel-adoption.md": "978f2333bf5ce38ebc58619ca3f50a087572a3b0c28d52bc06843bc341010684",
   "mcp-workflows.md": "1c0b5bb7f2e5c7ca835dfdfa57bbe8f6624172c855f4e225057ac2377abf360e",
   "migration.md": "53659987d64f3fc66c935bed55ec4227689185a23970f31327773fa408f5cf22",
-  "monitoring.md": "28bc87ab65b4ef8e466f12114cc56dd60f4216f1f163ec84defec1a030ec320e",
+  "monitoring.md": "e8a0051bf533658287b028cb20dbc1cfff710797ba5bccccd2f41b699606d7bb",
   "operator-operating-envelope.md": "c106e192b3716b8e2d14ffc84b3b2837b25792a7c3a9493d14dc6dd29ae9dee5",
   "platform-conformance.md": "2eec7eba9a65c010e03c4b2eb78afe4dddd6fd8170218b3194c49e3777124c91",
   "platform-protocol-specs.md": "ba9c69adfca7fb4a0dd982464b0ca69dd5a21de1e340edbe23b075ec0fb0c35c",