From 93ce1658ab362dc566ec6b30259f5f56a7e0452b Mon Sep 17 00:00:00 2001 From: Jason Plumb Date: Thu, 13 Mar 2025 10:07:26 -0700 Subject: [PATCH 1/7] add docs for @WithSpan params. --- .../docs/zero-code/java/agent/annotations.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/content/en/docs/zero-code/java/agent/annotations.md b/content/en/docs/zero-code/java/agent/annotations.md index 5e80c0ab4d0d..5b8bdf7a714d 100644 --- a/content/en/docs/zero-code/java/agent/annotations.md +++ b/content/en/docs/zero-code/java/agent/annotations.md @@ -80,6 +80,25 @@ types listed below, then the span will not be ended until the future completes. - [io.reactivex.Flowable](https://reactivex.io/RxJava/2.x/javadoc/index.html?io/reactivex/Flowable.html) - [io.reactivex.parallel.ParallelFlowable](https://reactivex.io/RxJava/2.x/javadoc/index.html?io/reactivex/parallel/ParallelFlowable.html) +### Parameters + +The `@WithSpan` attribute supports two optional parameters to allow +customization of spans: + +| name | type | default | description | +|------------------|-------------------|------------|----------------------------------------------------------------------------------------------------------------------------------------------| +| `kind` | `SpanKind` (enum) | `INTERNAL` | The [kind of span](https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/trace/api.md#spankind). | +| `inheritContext` | `boolean` | `true` | Since 2.14.0. Controls whether or not the new span will be parented in the existing (current) context. If `false`, a new context is created. | + +Example parameter usage: + +```java +@WithSpan(kind = SpanKind.CLIENT, inheritContext = false) +public void myMethod() { + <...> +} +``` + ## Adding attributes to the span with `@SpanAttribute` When a [span](/docs/concepts/signals/traces/#spans) is created for an annotated From f93b7562d2bf2cde6b3443563c30934a66e9aeb9 Mon Sep 17 00:00:00 2001 From: opentelemetrybot <107717825+opentelemetrybot@users.noreply.github.com> Date: Thu, 13 Mar 2025 17:24:43 +0000 Subject: [PATCH 2/7] Results from /fix:refcache --- static/refcache.json | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/static/refcache.json b/static/refcache.json index af3accafcebe..218d73ebf747 100644 --- a/static/refcache.json +++ b/static/refcache.json @@ -9739,6 +9739,10 @@ "StatusCode": 206, "LastSeen": "2025-02-06T02:17:59.999Z" }, + "https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/trace/api.md#spankind": { + "StatusCode": 206, + "LastSeen": "2025-03-13T17:21:15.569829279Z" + }, "https://github.com/open-telemetry/opentelemetry-specification/blob/v1.14.0/specification/sdk-environment-variables.md#general-sdk-configuration": { "StatusCode": 200, "LastSeen": "2025-02-06T02:17:12.345Z" From c0b984e6b4a15d1da2119cbffc6215a066a6677a Mon Sep 17 00:00:00 2001 From: opentelemetrybot <107717825+opentelemetrybot@users.noreply.github.com> Date: Fri, 14 Mar 2025 08:26:35 +0000 Subject: [PATCH 3/7] Results from /fix:format --- content/en/docs/zero-code/java/agent/annotations.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/docs/zero-code/java/agent/annotations.md b/content/en/docs/zero-code/java/agent/annotations.md index 5b8bdf7a714d..5441714e2f34 100644 --- a/content/en/docs/zero-code/java/agent/annotations.md +++ b/content/en/docs/zero-code/java/agent/annotations.md @@ -86,7 +86,7 @@ The `@WithSpan` attribute supports two optional parameters to allow customization of spans: | name | type | default | description | -|------------------|-------------------|------------|----------------------------------------------------------------------------------------------------------------------------------------------| +| ---------------- | ----------------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | `kind` | `SpanKind` (enum) | `INTERNAL` | The [kind of span](https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/trace/api.md#spankind). | | `inheritContext` | `boolean` | `true` | Since 2.14.0. Controls whether or not the new span will be parented in the existing (current) context. If `false`, a new context is created. | From bb20d2a540490f76ee513d359fa2edf18ad5f242 Mon Sep 17 00:00:00 2001 From: opentelemetrybot <107717825+opentelemetrybot@users.noreply.github.com> Date: Fri, 14 Mar 2025 09:22:09 +0000 Subject: [PATCH 4/7] Results from /fix:all --- content/ja/blog/2025/ai-agent-observability/index.md | 1 + content/ja/docs/collector/deployment/agent.md | 1 + content/ja/docs/collector/deployment/gateway/index.md | 1 + content/ja/docs/what-is-opentelemetry.md | 1 + content/pt/docs/concepts/instrumentation/_index.md | 1 + 5 files changed, 5 insertions(+) diff --git a/content/ja/blog/2025/ai-agent-observability/index.md b/content/ja/blog/2025/ai-agent-observability/index.md index 0d6f26f30e83..4dca7082503b 100644 --- a/content/ja/blog/2025/ai-agent-observability/index.md +++ b/content/ja/blog/2025/ai-agent-observability/index.md @@ -8,6 +8,7 @@ issue: https://github.com/open-telemetry/opentelemetry.io/issues/6389 sig: SIG GenAI Observability date: 2025-03-06 default_lang_commit: f2a520b85d72db706bff91d879f5bb10fd2e7367 +drifted_from_default: true cSpell:ignore: genai Guangya PydanticAI Sujay --- diff --git a/content/ja/docs/collector/deployment/agent.md b/content/ja/docs/collector/deployment/agent.md index ca42e43c1bd1..395d99ccfdde 100644 --- a/content/ja/docs/collector/deployment/agent.md +++ b/content/ja/docs/collector/deployment/agent.md @@ -3,6 +3,7 @@ title: エージェント description: コレクターにシグナルを送信し、そこからバックエンドに送信する理由と方法 weight: 2 default_lang_commit: b34ebe22b71962da96b898eb39a666ed57d447fe +drifted_from_default: true cSpell:ignore: prometheusremotewrite --- diff --git a/content/ja/docs/collector/deployment/gateway/index.md b/content/ja/docs/collector/deployment/gateway/index.md index f04ce8901bed..a8d12030fb4a 100644 --- a/content/ja/docs/collector/deployment/gateway/index.md +++ b/content/ja/docs/collector/deployment/gateway/index.md @@ -3,6 +3,7 @@ title: ゲートウェイ description: シグナルを単一のOTLPエンドポイントに送信し、そこからバックエンドに送信する理由と方法 weight: 3 default_lang_commit: b34ebe22b71962da96b898eb39a666ed57d447fe +drifted_from_default: true # prettier-ignore cSpell:ignore: filelogreceiver hostmetricsreceiver hostnames loadbalancer loadbalancing resourcedetectionprocessor --- diff --git a/content/ja/docs/what-is-opentelemetry.md b/content/ja/docs/what-is-opentelemetry.md index 4c0bc5f742e2..ff61892629da 100644 --- a/content/ja/docs/what-is-opentelemetry.md +++ b/content/ja/docs/what-is-opentelemetry.md @@ -3,6 +3,7 @@ title: OpenTelemetryとは description: OpenTelemetryが何であり、何でないかについての簡単な説明。 weight: 150 default_lang_commit: 44059882 +drifted_from_default: true --- - OpenTelemetryは、[オブザーバビリティ](/docs/concepts/observability-primer/#what-is-observability)フレームワークであり、[トレース](/docs/concepts/signals/traces/)、[メトリクス](/docs/concepts/signals/metrics/)、[ログ](/docs/concepts/signals/logs/)のようなテレメトリーデータを作成・管理するためにデザインされたツールキットです。 diff --git a/content/pt/docs/concepts/instrumentation/_index.md b/content/pt/docs/concepts/instrumentation/_index.md index 539373707905..6d1062131563 100644 --- a/content/pt/docs/concepts/instrumentation/_index.md +++ b/content/pt/docs/concepts/instrumentation/_index.md @@ -3,6 +3,7 @@ title: Instrumentação description: Como o OpenTelemetry facilita a instrumentação weight: 15 default_lang_commit: 82bd738d51426acb34e126b230a8a1281f193e3e +drifted_from_default: true --- Para que um sistema seja observável, ele deve ser **instrumentado**: ou seja, o From 48c14ccaceda5f5dee8e5d0ea82bb9e26eed5dc9 Mon Sep 17 00:00:00 2001 From: Fabrizio Ferri-Benedetti Date: Fri, 14 Mar 2025 10:22:57 +0100 Subject: [PATCH 5/7] Update `@WithSpan` parameters description --- content/en/docs/zero-code/java/agent/annotations.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/docs/zero-code/java/agent/annotations.md b/content/en/docs/zero-code/java/agent/annotations.md index 5441714e2f34..47166078a60f 100644 --- a/content/en/docs/zero-code/java/agent/annotations.md +++ b/content/en/docs/zero-code/java/agent/annotations.md @@ -82,7 +82,7 @@ types listed below, then the span will not be ended until the future completes. ### Parameters -The `@WithSpan` attribute supports two optional parameters to allow +The `@WithSpan` attribute supports the following optional parameters to allow customization of spans: | name | type | default | description | From ecc13d8cc27186ddf6ab1184828481ea2a9515bf Mon Sep 17 00:00:00 2001 From: Fabrizio Ferri-Benedetti Date: Fri, 14 Mar 2025 10:53:43 +0100 Subject: [PATCH 6/7] Fix link --- content/en/docs/zero-code/java/agent/annotations.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/docs/zero-code/java/agent/annotations.md b/content/en/docs/zero-code/java/agent/annotations.md index 47166078a60f..f224332464fe 100644 --- a/content/en/docs/zero-code/java/agent/annotations.md +++ b/content/en/docs/zero-code/java/agent/annotations.md @@ -87,7 +87,7 @@ customization of spans: | name | type | default | description | | ---------------- | ----------------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------- | -| `kind` | `SpanKind` (enum) | `INTERNAL` | The [kind of span](https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/trace/api.md#spankind). | +| `kind` | `SpanKind` (enum) | `INTERNAL` | The [kind of span](/docs/specs/otel/trace/api/#spankind). | | `inheritContext` | `boolean` | `true` | Since 2.14.0. Controls whether or not the new span will be parented in the existing (current) context. If `false`, a new context is created. | Example parameter usage: From b2828d3d6937a61bb0c3f517bddda4ac24fbfa55 Mon Sep 17 00:00:00 2001 From: opentelemetrybot <107717825+opentelemetrybot@users.noreply.github.com> Date: Fri, 14 Mar 2025 09:56:48 +0000 Subject: [PATCH 7/7] Results from /fix:format --- content/en/docs/zero-code/java/agent/annotations.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/docs/zero-code/java/agent/annotations.md b/content/en/docs/zero-code/java/agent/annotations.md index f224332464fe..dc93c1e7e3ee 100644 --- a/content/en/docs/zero-code/java/agent/annotations.md +++ b/content/en/docs/zero-code/java/agent/annotations.md @@ -87,7 +87,7 @@ customization of spans: | name | type | default | description | | ---------------- | ----------------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------- | -| `kind` | `SpanKind` (enum) | `INTERNAL` | The [kind of span](/docs/specs/otel/trace/api/#spankind). | +| `kind` | `SpanKind` (enum) | `INTERNAL` | The [kind of span](/docs/specs/otel/trace/api/#spankind). | | `inheritContext` | `boolean` | `true` | Since 2.14.0. Controls whether or not the new span will be parented in the existing (current) context. If `false`, a new context is created. | Example parameter usage: