diff --git a/docs/monitoring.md b/docs/monitoring.md index 30427ea91c2..b6ba1aea848 100644 --- a/docs/monitoring.md +++ b/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) diff --git a/i18n/de/docusaurus-plugin-content-docs/current/monitoring.md b/i18n/de/docusaurus-plugin-content-docs/current/monitoring.md index c8012ab18c6..f3c967d2041 100644 --- a/i18n/de/docusaurus-plugin-content-docs/current/monitoring.md +++ b/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) diff --git a/i18n/de/source-hashes.json b/i18n/de/source-hashes.json index b29fe75dc4d..1ce040ce865 100644 --- a/i18n/de/source-hashes.json +++ b/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", diff --git a/i18n/es/docusaurus-plugin-content-docs/current/monitoring.md b/i18n/es/docusaurus-plugin-content-docs/current/monitoring.md index 5f917238c0e..1fd6db089bd 100644 --- a/i18n/es/docusaurus-plugin-content-docs/current/monitoring.md +++ b/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) diff --git a/i18n/es/source-hashes.json b/i18n/es/source-hashes.json index b29fe75dc4d..1ce040ce865 100644 --- a/i18n/es/source-hashes.json +++ b/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", diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/monitoring.md b/i18n/fr/docusaurus-plugin-content-docs/current/monitoring.md index 98e02558aff..39b08cd56f6 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/monitoring.md +++ b/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) diff --git a/i18n/fr/source-hashes.json b/i18n/fr/source-hashes.json index b29fe75dc4d..1ce040ce865 100644 --- a/i18n/fr/source-hashes.json +++ b/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", diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/monitoring.md b/i18n/ja/docusaurus-plugin-content-docs/current/monitoring.md index 465697e01e0..7b44db67390 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/monitoring.md +++ b/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) diff --git a/i18n/ja/source-hashes.json b/i18n/ja/source-hashes.json index b29fe75dc4d..1ce040ce865 100644 --- a/i18n/ja/source-hashes.json +++ b/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", diff --git a/i18n/pt-BR/docusaurus-plugin-content-docs/current/monitoring.md b/i18n/pt-BR/docusaurus-plugin-content-docs/current/monitoring.md index 5a1d1d9342e..c4655cbf1ce 100644 --- a/i18n/pt-BR/docusaurus-plugin-content-docs/current/monitoring.md +++ b/i18n/pt-BR/docusaurus-plugin-content-docs/current/monitoring.md @@ -72,6 +72,32 @@ junto deste guia. Esse contrato separa a incerteza do transporte pelo menos uma vez de resultados duráveis duplicados, evitando conclusões operacionais erradas a partir de evidências que parecem duplicadas. +:::tip Correlação de traces no Laravel embutido + +Para relacionar os logs da aplicação a uma execução de workflow e a uma tentativa +de atividade, configure a [integração opcional de rastreamento no modo embutido (em inglês)](https://github.com/durable-workflow/workflow/blob/main/docs/embedded-tracing.md). +Ela preserva o contexto W3C entre workers de fila, novas tentativas e recuperação, +e usa o provedor OpenTelemetry e os canais de log do Laravel da sua aplicação. +O guia explica como habilitar o rastreamento, adicionar o tap de logs, executar +as migrações do esquema e limitar as exportações. Consulte o diagrama de spans +e a matriz de capacidades de runtimes e SDKs antes da implantação. + +::: + +### Rastreamento no modo serviço {#service-mode-tracing} + +Configure o provedor, a amostragem, os propagadores e a exportação limitada antes de ativar a telemetria do SDK. Consulte o [guia PHP](https://php.durable-workflow.com/operate/tracing/), o [guia Python](https://python.durable-workflow.com/telemetry/) ou a [API Rust](https://rust.durable-workflow.com/durable_workflow/telemetry/) em inglês. + +| Runtime | Limite de propagação | +| --- | --- | +| Laravel embarcado | A integração Core opcional preserva o contexto entre os workers de fila da aplicação. | +| Servidor PHP | O [guia do servidor](https://github.com/durable-workflow/server/blob/2.10.0/docs/observability-context.md) exige imagem da aplicação com API opcional, opção ativada e esquema nullable real. | +| SDKs PHP, Python e Rust | Spans opcionais de tarefa/tentativa e correlação de logs com escopo. A propagação durável exige a capacidade exata anunciada pelo servidor. Capacidade ausente ou malformada gera traces de tarefa independentes. | +| Servidor Rust nativo | Esta versão PHP não qualifica carriers nativos nem conversão de catálogo. | +| Cloud | Esta versão não inclui implantação no Cloud. Confirme o suporte do runtime gerenciado. | + +IDs de trace, run, atividade, tentativa e requisição permanecem distintos. Baggage usa lista permitida, vazia por padrão; links não contêm baggage. Provedores e exportadores pertencem à aplicação. Encerramento abrupto pode perder telemetria; replay não garante exportação exatamente uma vez. Use o histórico durável para resultados de negócio. + ### Visão do painel {#dashboard-view} ![Painel do Waterline](https://raw.githubusercontent.com/durable-workflow/waterline/refs/heads/main/docs/screenshots/dashboard.png) diff --git a/i18n/pt-BR/source-hashes.json b/i18n/pt-BR/source-hashes.json index b29fe75dc4d..1ce040ce865 100644 --- a/i18n/pt-BR/source-hashes.json +++ b/i18n/pt-BR/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", diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/monitoring.md b/i18n/uk/docusaurus-plugin-content-docs/current/monitoring.md index 34ea4d77e2b..b9a7d914db2 100644 --- a/i18n/uk/docusaurus-plugin-content-docs/current/monitoring.md +++ b/i18n/uk/docusaurus-plugin-content-docs/current/monitoring.md @@ -70,6 +70,32 @@ Waterline навмисно не замінює метрики worker. щонайменше один раз і повторні стійкі результати, щоб схожі на дублікати докази не призвели до неправильного операційного висновку. +:::tip Кореляція трас у вбудованому Laravel + +Щоб пов'язати журнали застосунку із запуском workflow та спробою activity, +налаштуйте [необов'язкову інтеграцію трасування для вбудованого режиму (англійською)](https://github.com/durable-workflow/workflow/blob/main/docs/embedded-tracing.md). +Вона зберігає контекст W3C між worker черги, повторними спробами й відновленням +та використовує провайдер OpenTelemetry і канали журналювання Laravel вашого +застосунку. Посібник пояснює, як увімкнути трасування, додати tap журналів, +виконати міграції схеми й обмежити експорт. Перед розгортанням перегляньте +діаграму span і матрицю можливостей runtime та SDK. + +::: + +### Трасування в сервісному режимі {#service-mode-tracing} + +Налаштуйте провайдер, семплювання, пропагатори та обмежений експорт перед увімкненням телеметрії SDK. Використовуйте [посібник PHP](https://php.durable-workflow.com/operate/tracing/), [посібник Python](https://python.durable-workflow.com/telemetry/) або [API Rust](https://rust.durable-workflow.com/durable_workflow/telemetry/) англійською. + +| Runtime | Межа поширення контексту | +| --- | --- | +| Вбудований Laravel | Необов'язкова інтеграція Core зберігає контекст між воркерами черги застосунку. | +| Сервер PHP | [Посібник сервера](https://github.com/durable-workflow/server/blob/2.10.0/docs/observability-context.md) вимагає образ застосунку з необов'язковим API, увімкненою опцією та фактичною схемою з nullable-полями. | +| SDK PHP, Python і Rust | Необов'язкові spans задач/спроб і кореляція логів у межах виконання. Надійне поширення контексту виклику вимагає точної заявленої можливості сервера. Відсутня або некоректна можливість дає незалежні траси задач. | +| Нативний сервер Rust | Цей PHP-реліз не підтверджує нативні carriers або конвертацію каталогу. | +| Cloud | Цей реліз не містить розгортання Cloud. Перевірте підтримку керованого runtime. | + +Ідентифікатори trace, run, активності, спроби та запиту залишаються окремими. Baggage обмежений списком дозволених ключів, порожнім за замовчуванням; links не містять baggage. Провайдери й експортери належать застосунку. Раптова зупинка може втратити телеметрію; replay не гарантує експорт рівно один раз. Для бізнес-результатів використовуйте надійну історію. + ### Панель огляду {#dashboard-view} ![Панель Waterline](https://raw.githubusercontent.com/durable-workflow/waterline/refs/heads/main/docs/screenshots/dashboard.png) diff --git a/i18n/uk/source-hashes.json b/i18n/uk/source-hashes.json index b29fe75dc4d..1ce040ce865 100644 --- a/i18n/uk/source-hashes.json +++ b/i18n/uk/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", diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/monitoring.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/monitoring.md index 8e6f6b19723..d9aa8e50d86 100644 --- a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/monitoring.md +++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/monitoring.md @@ -39,6 +39,29 @@ Worker 和客户端的配置也独立于运维界面。将应用客户端和 Wor 如果 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 集成在队列 worker 之间持久保存上下文。 | +| 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 不携带 baggage。provider 和 exporter 由应用管理。进程突然终止可能丢失遥测,replay 不保证恰好一次导出。请使用持久历史确认业务结果。 + ### 仪表板视图 {#dashboard-view} ![Waterline 仪表板](https://raw.githubusercontent.com/durable-workflow/waterline/refs/heads/main/docs/screenshots/dashboard.png) diff --git a/i18n/zh-Hans/source-hashes.json b/i18n/zh-Hans/source-hashes.json index b29fe75dc4d..1ce040ce865 100644 --- a/i18n/zh-Hans/source-hashes.json +++ b/i18n/zh-Hans/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", diff --git a/static/stable-releases.json b/static/stable-releases.json index f6244179ebd..9be202bdc4a 100644 --- a/static/stable-releases.json +++ b/static/stable-releases.json @@ -4,11 +4,11 @@ "updated_at": "2026-10-21", "artifacts": { "cli": "2.3.0", - "sdk-php": "2.5.4", - "sdk-python": "2.6.2", - "sdk-rust": "3.5.6", - "server": "2.9.9", - "waterline": "2.11.4", - "workflow": "2.7.3" + "sdk-php": "3.1.0", + "sdk-python": "2.7.0", + "sdk-rust": "4.1.0", + "server": "2.10.0", + "waterline": "2.12.0", + "workflow": "2.9.0" } }