From d421127c8c3727fe7168b989b897bc7007d76886 Mon Sep 17 00:00:00 2001 From: Cijo Thomas Date: Mon, 10 Mar 2025 17:55:16 -0700 Subject: [PATCH 01/22] Fix Rust getting started --- .../en/docs/languages/rust/getting-started.md | 241 +++++++++--------- data/registry/exporter-rust-stdout.yml | 2 +- data/registry/otel-rust-sdk.yml | 2 +- data/registry/otel-rust.yml | 2 +- 4 files changed, 128 insertions(+), 119 deletions(-) diff --git a/content/en/docs/languages/rust/getting-started.md b/content/en/docs/languages/rust/getting-started.md index b461c2866184..d8eb0c37240b 100644 --- a/content/en/docs/languages/rust/getting-started.md +++ b/content/en/docs/languages/rust/getting-started.md @@ -28,74 +28,88 @@ For more elaborate examples, see [examples](/docs/languages/rust/examples/). ### Dependencies -To begin, create a file `Cargo.toml` in a new directory and add the following -content: +To begin, create an executable using `cargo new dice_server` in a new directory and add the following +content to the `Cargo.toml` file: ```toml [package] name = "dice_server" version = "0.1.0" edition = "2021" -publish = false - -[[bin]] -name = "dice_server" -path = "dice_server.rs" -doc = false [dependencies] -hyper = { version = "0.14", features = ["full"] } -tokio = { version = "1.29", features = ["full"] } -rand = { version = "0.8" } +hyper = { version = "1", features = ["full"] } +tokio = { version = "1", features = ["full"] } +http-body-util = "0.1" +hyper-util = { version = "0.1", features = ["full"] } +rand = "0.9.0" ``` ### Create and launch an HTTP Server -In that same folder, create a file called `dice_server.rs` and add the following -code to the file: +Modify `main.rs` to the following: ```rust -use hyper::service::{make_service_fn, service_fn}; -use hyper::{Body, Request, Response, Server, Method, StatusCode}; +use std::convert::Infallible; +use std::net::SocketAddr; + +use http_body_util::Full; +use hyper::body::Bytes; +use hyper::server::conn::http1; +use hyper::service::service_fn; +use hyper::Method; +use hyper::{Request, Response}; +use hyper_util::rt::TokioIo; use rand::Rng; -use std::{convert::Infallible, net::SocketAddr}; +use tokio::net::TcpListener; -async fn handle(req: Request) -> Result, Infallible> { - let mut response = Response::new(Body::empty()); +async fn roll_dice(_: Request) -> Result>, Infallible> { + let random_number = rand::rng().random_range(1..=6); + Ok(Response::new(Full::new(Bytes::from( + random_number.to_string(), + )))) +} +async fn handle(req: Request) -> Result>, Infallible> { match (req.method(), req.uri().path()) { - (&Method::GET, "/rolldice") => { - let random_number = rand::thread_rng().gen_range(1..7); - *response.body_mut() = Body::from(random_number.to_string()); - } - _ => { - *response.status_mut() = StatusCode::NOT_FOUND; - } - }; - - Ok(response) + (&Method::GET, "/rolldice") => roll_dice(req).await, + _ => Ok(Response::builder() + .status(404) + .body(Full::new(Bytes::from("Not Found"))) + .unwrap()), + } } #[tokio::main] -async fn main() { +async fn main() -> Result<(), Box> { let addr = SocketAddr::from(([127, 0, 0, 1], 8080)); - let make_svc = make_service_fn(|_conn| async { Ok::<_, Infallible>(service_fn(handle)) }); - let server = Server::bind(&addr).serve(make_svc); + let listener = TcpListener::bind(addr).await?; - println!("Listening on {addr}"); - if let Err(e) = server.await { - eprintln!("server error: {e}"); + loop { + let (stream, _) = listener.accept().await?; + + let io = TokioIo::new(stream); + + tokio::task::spawn(async move { + if let Err(err) = http1::Builder::new() + .serve_connection(io, service_fn(handle)) + .await + { + eprintln!("Error serving connection: {:?}", err); + } + }); } } + ``` Build and run the application with the following command, then open in your web browser to ensure it is working. ```console -$ cargo run --bin dice_server +$ cargo run ... Listening on 127.0.0.1:8080 ``` @@ -114,67 +128,85 @@ opentelemetry_sdk = "{{% version-from-registry otel-rust-sdk %}}" opentelemetry-stdout = { version = "{{% version-from-registry exporter-rust-stdout %}}", features = ["trace"] } ``` -Update the `dice_server.rs` file with code to initialize a tracer and to emit +Update the `main.rs` file with code to initialize a tracer and to emit spans when the `handle` function is called: ```rust -use hyper::service::{make_service_fn, service_fn}; -use hyper::{Body, Method, Request, Response, Server, StatusCode}; -use rand::Rng; -use std::{convert::Infallible, net::SocketAddr}; -use opentelemetry::global::ObjectSafeSpan; -use opentelemetry::trace::{SpanKind, Status}; -use opentelemetry::{global, trace::Tracer}; -use opentelemetry_sdk::propagation::TraceContextPropagator; -use opentelemetry_sdk::trace::TracerProvider; +use std::convert::Infallible; +use std::net::SocketAddr; +use std::sync::OnceLock; + +use http_body_util::Full; +use hyper::body::Bytes; +use hyper::server::conn::http1; +use hyper::service::service_fn; +use hyper::Method; +use hyper::{Request, Response}; +use hyper_util::rt::TokioIo; +use opentelemetry::global::{self, BoxedTracer}; +use opentelemetry::trace::{Span, SpanKind, Status, Tracer}; +use opentelemetry_sdk::trace::SdkTracerProvider; use opentelemetry_stdout::SpanExporter; +use rand::Rng; +use tokio::net::TcpListener; -async fn handle(req: Request) -> Result, Infallible> { - let mut response = Response::new(Body::empty()); +async fn roll_dice(_: Request) -> Result>, Infallible> { + let random_number = rand::rng().random_range(1..=6); + Ok(Response::new(Full::new(Bytes::from( + random_number.to_string(), + )))) +} - let tracer = global::tracer("dice_server"); +async fn handle(req: Request) -> Result>, Infallible> { + let tracer = get_tracer(); let mut span = tracer .span_builder(format!("{} {}", req.method(), req.uri().path())) .with_kind(SpanKind::Server) - .start(&tracer); + .start(tracer); match (req.method(), req.uri().path()) { - (&Method::GET, "/rolldice") => { - let random_number = rand::thread_rng().gen_range(1..7); - *response.body_mut() = Body::from(random_number.to_string()); - span.set_status(Status::Ok); - } + (&Method::GET, "/rolldice") => roll_dice(req).await, _ => { - *response.status_mut() = StatusCode::NOT_FOUND; - span.set_status(Status::error("Not Found")); + span.set_status(Status::Ok); + Ok(Response::builder() + .status(404) + .body(Full::new(Bytes::from("Not Found"))) + .unwrap()) } - }; + } +} - Ok(response) +fn get_tracer() -> &'static BoxedTracer { + static TRACER: OnceLock = OnceLock::new(); + TRACER.get_or_init(|| global::tracer("dice_server")) } -fn init_tracer() { - global::set_text_map_propagator(TraceContextPropagator::new()); - let provider = TracerProvider::builder() +fn init_tracer_provider() { + let provider = SdkTracerProvider::builder() .with_simple_exporter(SpanExporter::default()) .build(); global::set_tracer_provider(provider); } #[tokio::main] -async fn main() { - init_tracer(); +async fn main() -> Result<(), Box> { let addr = SocketAddr::from(([127, 0, 0, 1], 8080)); - let make_svc = make_service_fn(|_conn| async { Ok::<_, Infallible>(service_fn(handle)) }); + let listener = TcpListener::bind(addr).await?; + init_tracer_provider(); - let server = - Server::bind(&addr).serve(make_svc); - - println!("Listening on {addr}"); - if let Err(e) = server.await { - eprintln!("server error: {e}"); + loop { + let (stream, _) = listener.accept().await?; + let io = TokioIo::new(stream); + tokio::task::spawn(async move { + if let Err(err) = http1::Builder::new() + .serve_connection(io, service_fn(handle)) + .await + { + eprintln!("Error serving connection: {:?}", err); + } + }); } } ``` @@ -182,57 +214,34 @@ async fn main() { Start your server again: ```sh -$ cargo run --bin dice_server +$ cargo run ... Listening on 127.0.0.1:8080 ``` When you send a request to the server at , -you'll see a span being emitted to the console (output is pretty printed for -convenience): - -```json -{ - "resourceSpans": [ - { - "resource": { - "attributes": [ - { - "key": "service.name", - "value": { - "stringValue": "unknown_service" - } - } - ] - }, - "scopeSpans": [ - { - "scope": { - "name": "dice_server" - }, - "spans": [ - { - "attributes": [], - "droppedAttributesCount": 0, - "droppedEventsCount": 0, - "droppedLinksCount": 0, - "endTimeUnixNano": 1691076354768034000, - "kind": 2, - "name": "GET /rolldice", - "parentSpanId": "", - "spanId": "27e1d7d8e44a63c5", - "startTimeUnixNano": 1691076354768025000, - "status": { - "code": 2 - }, - "traceId": "adfe9d364ee19610adde517d722167ca" - } - ] - } - ] - } - ] -} +you'll see a span being emitted to the console: + +```txt +Spans +Resource + -> telemetry.sdk.version=String(Static("0.28.0")) + -> service.name=String(Static("unknown_service")) + -> telemetry.sdk.language=String(Static("rust")) + -> telemetry.sdk.name=String(Static("opentelemetry")) +Span #0 + Instrumentation Scope + Name : "dice_server" + + Name : GET /rolldice + TraceId : 9f03de7cf14780bd54b95d7095332107 + SpanId : 9faed88b3f9ed699 + TraceFlags : TraceFlags(1) + ParentSpanId: 0000000000000000 + Kind : Server + Start time: 2025-03-11 00:47:26.687497 + End time: 2025-03-11 00:47:26.687653 + Status: Unset ``` ## What next? diff --git a/data/registry/exporter-rust-stdout.yml b/data/registry/exporter-rust-stdout.yml index c29484fd9b97..6c51590bb522 100644 --- a/data/registry/exporter-rust-stdout.yml +++ b/data/registry/exporter-rust-stdout.yml @@ -16,4 +16,4 @@ createdAt: 2024-01-19 package: registry: crates name: opentelemetry-stdout - version: 0.27.0 + version: 0.28.0 diff --git a/data/registry/otel-rust-sdk.yml b/data/registry/otel-rust-sdk.yml index 50f7beec71e6..a7ebd49f2b00 100644 --- a/data/registry/otel-rust-sdk.yml +++ b/data/registry/otel-rust-sdk.yml @@ -13,4 +13,4 @@ createdAt: 2020-02-04 package: registry: crates name: opentelemetry_sdk - version: 0.22.1 + version: 0.28.0 diff --git a/data/registry/otel-rust.yml b/data/registry/otel-rust.yml index ae5d83e78f18..ccdfbe248591 100644 --- a/data/registry/otel-rust.yml +++ b/data/registry/otel-rust.yml @@ -13,4 +13,4 @@ createdAt: 2020-02-04 package: registry: crates name: opentelemetry - version: 0.22.0 + version: 0.28.0 From 7ba99afb28d8e23c70259e6eb69cf799883b124b Mon Sep 17 00:00:00 2001 From: opentelemetrybot <107717825+opentelemetrybot@users.noreply.github.com> Date: Wed, 12 Mar 2025 16:45:58 +0000 Subject: [PATCH 02/22] Results from /fix:all --- content/en/docs/languages/rust/getting-started.md | 9 ++++----- content/ja/docs/collector/deployment/agent.md | 1 + content/ja/docs/collector/deployment/gateway/index.md | 1 + content/ja/docs/demo/feature-flags.md | 1 + content/ja/docs/what-is-opentelemetry.md | 1 + content/pt/docs/concepts/instrumentation/_index.md | 1 + 6 files changed, 9 insertions(+), 5 deletions(-) diff --git a/content/en/docs/languages/rust/getting-started.md b/content/en/docs/languages/rust/getting-started.md index d8eb0c37240b..23101aac2694 100644 --- a/content/en/docs/languages/rust/getting-started.md +++ b/content/en/docs/languages/rust/getting-started.md @@ -28,8 +28,8 @@ For more elaborate examples, see [examples](/docs/languages/rust/examples/). ### Dependencies -To begin, create an executable using `cargo new dice_server` in a new directory and add the following -content to the `Cargo.toml` file: +To begin, create an executable using `cargo new dice_server` in a new directory +and add the following content to the `Cargo.toml` file: ```toml [package] @@ -102,7 +102,6 @@ async fn main() -> Result<(), Box> { }); } } - ``` Build and run the application with the following command, then open @@ -128,8 +127,8 @@ opentelemetry_sdk = "{{% version-from-registry otel-rust-sdk %}}" opentelemetry-stdout = { version = "{{% version-from-registry exporter-rust-stdout %}}", features = ["trace"] } ``` -Update the `main.rs` file with code to initialize a tracer and to emit -spans when the `handle` function is called: +Update the `main.rs` file with code to initialize a tracer and to emit spans +when the `handle` function is called: ```rust use std::convert::Infallible; 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/demo/feature-flags.md b/content/ja/docs/demo/feature-flags.md index 0cdb2f886941..27fc2a10871e 100644 --- a/content/ja/docs/demo/feature-flags.md +++ b/content/ja/docs/demo/feature-flags.md @@ -5,6 +5,7 @@ aliases: - services/feature-flag - services/featureflagservice default_lang_commit: 24146bd1368e4c6082c7d6077efd29dba0d51055 +drifted_from_default: true cSpell:ignore: OLJCESPC7Z --- 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 1f5ec0feaacd9be0f5b1135f43b0f1d0247d22d6 Mon Sep 17 00:00:00 2001 From: Msksgm <49427230+Msksgm@users.noreply.github.com> Date: Thu, 13 Mar 2025 01:06:57 +0900 Subject: [PATCH 03/22] [ja] translate contributing/blog into ja (#6521) --- content/ja/docs/contributing/blog.md | 104 +++++++++++++++++++++++++++ 1 file changed, 104 insertions(+) create mode 100644 content/ja/docs/contributing/blog.md diff --git a/content/ja/docs/contributing/blog.md b/content/ja/docs/contributing/blog.md new file mode 100644 index 000000000000..17260792d9df --- /dev/null +++ b/content/ja/docs/contributing/blog.md @@ -0,0 +1,104 @@ +--- +title: ブログ +description: ブログ投稿する方法を学びます。 +weight: 30 +default_lang_commit: 87f313117340a9fb3bb58d33a66111c29323a5b7 +--- + +[OpenTelemetry ブログ](/blog/)は OpenTelemetry に関連する可能性のある、新機能、コミュニティレポートそしてニュースを発信します。 +これは、エンドユーザーと開発者を含みます。 +誰でもブログを書くことができます。 +要件について下記を読んでください。 + +## ドキュメントテーションまたはブログ投稿？ {#documentation-or-blog-post} + +ブログ記事を書くには、ドキュメントに書いた方が良いのではないかと自問自答してください。 +もし答えが「はい」であれば、そのコンテンツをドキュメントに追加するために、新しいイシューまたはプルリクエスト（PR）を作成してください。 + +OpenTelemetry ウェブサイトのメンテナーと承認者はプロジェクトのドキュメントの改善に焦点を当てているため、ブログ記事はレビューの優先度が低くなることに注意してください。 + +## ブログ記事を提出する前に {#before-submitting-a-blog-post} + +ブログ記事は商業的な内容であってはならず、OpenTelemetry コミュニティに全体に適用される独自の内容で作成する必要があります。 +ブログ記事は [Social Media Guide](https://github.com/open-telemetry/community/blob/main/social-media-guide.md) に記載されている方針に従ってください。 + +投稿しようとしている内容が、OpenTelemetry コミュニティ全体に適用されることを確認してください。 +適切な内容には、以下が含まれます。 + +- 新しい OpenTelemetry の機能 +- OpenTelemetry プロジェクトの更新情報 +- Special Interest Group（SIG）の最新情報 +- チュートリアルやウォークスルー +- OpenTelemetry の統合 + +不適切な内容には、以下が含まれます。 + +- ベンダー製品の宣伝 + +もし、ブログ投稿がこの適切な内容のリストに沿っているのであれば、次の詳細と一緒に[イシューを起票]してください。 + +- ブログ投稿のタイトル +- 簡潔な説明とブログ投稿の概要 +- 該当する場合、ブログ記事で使用する技術のリスト。すべてオープンソースであることを確認し、CNCF プロジェクトでないものより CNCF プロジェクトが好まれます（例：トレースの可視化には Jaeger、メトリクスの可視化には Prometheus を使用） +- ブログ記事に関連する [SIG](https://github.com/open-telemetry/community/) の名前 +- PR のレビューを手伝う、SIG のスポンサー（メンテナーまたは承認者）の名前。理想的にはスポンサーは異なる企業であることが望ましい + +SIG Communication のメンテナーがブログ記事が受け入れられるのに必要な要件を満たしていることを確認します。 +最初のイシューの詳細に、SIG やスポンサーの名前を書けない場合は、スポンサーを求めるために連絡できる適切な SIG を紹介します。 +スポンサーを持つことは任意ですが、スポンサーを持つことでブログポストをより早くレビューや承認を得る可能性が高まります。 + +もしイシューが必要としているものをすべて揃っている場合は、メンテナーが確認し次の手順に進めてブログ記事を投稿できることを通知します。 + +## ブログ記事を提出する {#submit-a-blog-post} + +リポジトリをフォークしてローカルで書くか、GitHub UI を利用することでブログ記事を投稿できます。 +両方の場合において、[ブログ投稿テンプレート](https://github.com/open-telemetry/opentelemetry.io/tree/main/archetypes/blog.md)で提供されている指示に従うように依頼します。 + +### フォークしてローカルで書く {#fork-and-write-locally} + +ローカルのフォークをセットアップした後に、テンプレートを利用してブログポストを作成できます。 +テンプレートから記事を作成するために、次の手順に従ってください。 + +1. リポジトリルートから以下のコマンドを実行してください + + ```sh + npx hugo new content/en/blog/2024/short-name-for-post.md + ``` + + 投稿に画像やその他のアセットが含まれている場合、次のコマンドを実行してください。 + + ```sh + npx hugo new content/en/blog/2024/short-name-for-post/index.md + ``` + +1. 前のコマンドで提供したパスのマークダウンファイルを編集してください。このファイルは、[archetypes](https://github.com/open-telemetry/opentelemetry.io/tree/main/archetypes/)配下のブログ記事スターターから初期化されます。 + +1. 作成したフォルダの中に、画像や他のファイルのアセットを配置してください + +1. 記事の準備ができたら、プルリクエストを通して提出してください + +### GitHub UI を使用する {#use-the-github-ui} + +ローカルのフォークを作成することを好まないのであれば、新しい記事を作成するのに GitHub UI を利用できます。 +UI を利用して記事を追加するのに次のステップに従ってください。 + +1. [ブログ記事のテンプレート](https://github.com/open-telemetry/opentelemetry.io/tree/main/archetypes/blog.md)に行って、メニューの右上にある **Copy raw content** をクリックしてください + +1. [Create a new file](https://github.com/open-telemetry/opentelemetry.io/new/main)を選択してください + +1. 最初のステップでコピーしたテンプレートを貼り付けます + +1. ファイルに名前をつけてください。たとえば、`content/en/blog/2022/short-name-for-your-blog-post/index.md` です + +1. GitHub で Markdown を編集してください + +1. 記事の準備ができたら、**Propose changes** を選択して指示に従ってください + +## 公開スケジュール {#publication-timelines} + +OpenTelemetryのブログは厳密な公開スケジュールに従いません。 +これは、次のことを意味します。 + +- ブログ記事はすべての必要とする承認が揃ったときに公開されます +- 公開は必要に応じて延期されますが、メンテナーは特定の日付に公開されることを保証できません +- 一部のブログ記事（重要な発表など）は優先され、あなたの記事よりも先に公開されることがあります From 56dde5d14a65437bfc2c370ad60798fc2c6d344a Mon Sep 17 00:00:00 2001 From: Msksgm <49427230+Msksgm@users.noreply.github.com> Date: Thu, 13 Mar 2025 01:08:35 +0900 Subject: [PATCH 04/22] [ja] fix drift of content/ja/docs/demo/feature-flags (#6527) --- content/ja/docs/demo/feature-flags.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/content/ja/docs/demo/feature-flags.md b/content/ja/docs/demo/feature-flags.md index 27fc2a10871e..c1c19af4a580 100644 --- a/content/ja/docs/demo/feature-flags.md +++ b/content/ja/docs/demo/feature-flags.md @@ -4,8 +4,7 @@ aliases: - feature_flags - services/feature-flag - services/featureflagservice -default_lang_commit: 24146bd1368e4c6082c7d6077efd29dba0d51055 -drifted_from_default: true +default_lang_commit: ea3b23ce16243364ae03d368d49af870454f686f cSpell:ignore: OLJCESPC7Z --- From 9c3caaf1e54c7aad02d62aa6ba809f3ed6ebacaa Mon Sep 17 00:00:00 2001 From: Yoshi Yamaguchi Date: Thu, 13 Mar 2025 02:22:30 +0900 Subject: [PATCH 05/22] blog: fix slack channel name up-to-date (#6531) --- content/en/blog/2025/ai-agent-observability/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/blog/2025/ai-agent-observability/index.md b/content/en/blog/2025/ai-agent-observability/index.md index 5ec858c78f90..a8eb84fc076f 100644 --- a/content/en/blog/2025/ai-agent-observability/index.md +++ b/content/en/blog/2025/ai-agent-observability/index.md @@ -255,5 +255,5 @@ transparent and effective AI ecosystem. Don’t miss this opportunity to help shape the future of industry standards for GenAI Observability! Join us on the [CNCF Slack](https://slack.cncf.io) -`#otel-genai-instrumentation-wg` channel, or by attending a +`#otel-genai-instrumentation` channel, or by attending a [GenAI SIG meeting](https://github.com/open-telemetry/community/blob/main/projects/gen-ai.md#meeting-times). From a6cd8a7b1cf025a848d3a841d8c8b07ac14b9b4f Mon Sep 17 00:00:00 2001 From: OpenTelemetry Bot <107717825+opentelemetrybot@users.noreply.github.com> Date: Wed, 12 Mar 2025 11:17:29 -0700 Subject: [PATCH 06/22] Update community members (#6518) Co-authored-by: Tiffany Hrabusa <30397949+tiffany76@users.noreply.github.com> --- data/community/members.yaml | 5 +++++ static/refcache.json | 4 ++++ 2 files changed, 9 insertions(+) diff --git a/data/community/members.yaml b/data/community/members.yaml index 7566a25aed57..bdc2dca80153 100644 --- a/data/community/members.yaml +++ b/data/community/members.yaml @@ -1918,6 +1918,11 @@ triagers: - javascript-contrib-triagers html_url: https://github.com/abhee11 avatar_url: https://avatars.githubusercontent.com/u/6670495?v=4 + - name: akats7 + teams: + - go-triagers + html_url: https://github.com/akats7 + avatar_url: https://avatars.githubusercontent.com/u/56042997?v=4 - name: anosek-an teams: - java-contrib-triagers diff --git a/static/refcache.json b/static/refcache.json index 3dafc12ee083..af3accafcebe 100644 --- a/static/refcache.json +++ b/static/refcache.json @@ -2815,6 +2815,10 @@ "StatusCode": 206, "LastSeen": "2025-02-01T07:20:44.508718-05:00" }, + "https://github.com/akats7": { + "StatusCode": 206, + "LastSeen": "2025-03-12T17:55:27.860655885Z" + }, "https://github.com/alanwest": { "StatusCode": 206, "LastSeen": "2025-02-01T07:20:44.733417-05:00" From 254b76267f8db7c94a45271c8607a15b4b208e97 Mon Sep 17 00:00:00 2001 From: Msksgm <49427230+Msksgm@users.noreply.github.com> Date: Thu, 13 Mar 2025 03:59:24 +0900 Subject: [PATCH 07/22] [ja] translated contributing/pr-checks into ja (#6529) --- content/ja/docs/contributing/pr-checks.md | 90 +++++++++++++++++++++++ 1 file changed, 90 insertions(+) create mode 100644 content/ja/docs/contributing/pr-checks.md diff --git a/content/ja/docs/contributing/pr-checks.md b/content/ja/docs/contributing/pr-checks.md new file mode 100644 index 000000000000..589986801be8 --- /dev/null +++ b/content/ja/docs/contributing/pr-checks.md @@ -0,0 +1,90 @@ +--- +title: プルリクエストのチェック +description: プルリクエストがすべてのチェックをパスする方法学ぶ +weight: 40 +default_lang_commit: 9ba98f4fded66ec78bfafa189ab2d15d66df2309 +cSpell:ignore: REFCACHE +--- + +[opentelemetry.io リポジトリ](https://github.com/open-telemetry/opentelemetry.io)に[pull request](https://docs.github.com/en/get-started/learning-about-github/github-glossary#pull-request)（PR）を作成した際に、一連のチェックが実行されます。 +PR のチェックは次のことを検証します。 + +- [CLA](#easy-cla) の署名しているか +- [Netlify](#netlify-deployment)を通じて正常にデプロイしているか +- [スタイルガイド](#style-checks)に変更が従っているか + +{{% alert title="Note" color="primary" %}} + +もし何らかの PR チェックが失敗していれば、最初に自身の PC で `npm run fix:all` を実行することで[自動的に内容が修正されるか](../pull-requests/#fix-issues)試してください。 + +加えて、`/fix:all` をプルリクエストにコメントできます。 +OpenTelemetry ボットが代わりにこれらのコマンドを実行して、PR を更新します。 +ローカルに変更をプルすることを忘れないでください。 + +問題が残り続けている場合のみ、以下を読んで様々なチェックの内容と、失敗した状態からの修正する方法を確認してください。 + +{{% /alert %}} + +## Easy CLA {#easy-cla} + +[CLA に署名](../prerequisites/#cla)していなかった場合は、このチェックが失敗します。 + +## Netlify deployment {#netlify-deployment} + +[Netlify](https://www.netlify.com/)のビルドが失敗した場合は、より詳細のために **Details** を選択してください。 + +## スタイルチェック {#style-checks} + +コントリビューションが [スタイルガイド](../style-guide/) に従っていることを検証するために、スタイルガイドのルールを検証し、問題が見つかった場合に失敗する一連のチェックを実装しています。 + +後述のリストでは、現在のチェック内容と、それに関連するエラーを修正する方法について説明します。 + +### TEXT linter {#text-linter} + +このチェックは、[OpenTelemetry 固有の用語や単語がサイト全体で一貫して使用されていること](../style-guide/#opentelemetryio-word-list)を検証します。 + +問題が見つかった場合、プルリクエストの `files changed` ビューでファイルにアノテーションが追加されます。これらを修正すると、チェックが成功します。 +また、`npm run check:text -- --fix` をローカルで実行すると、ほとんどの問題を修正できます。 +`npm run check:text` を再度実行し、残りの問題を手動で修正してください。 + +### MARKDOWN linter {#markdown-linter} + +このチェックは、[Markdown ファイルの標準と一貫性が強制されていること](../style-guide/#markdown-standards)を検証します。 + +問題が見つかった場合、`npm run:format` を実行すると、ほとんどの問題を修正できます。 +より複雑な問題がある場合は、`npm run check:markdown` を実行し、提案された変更を適用してください。 + +### SPELLING check {#spelling-check} + +このチェックは、[すべての単語が正しく綴られていること](../style-guide/#spell-checking) を検証します。 + +### CSPELL:IGNORE check {#cspellignore-check} + +このチェックは、cSpell の ignore リストに含まれるすべての単語が正規化されていることを検証します。 + +このチェックが失敗した場合、`npm run fix:dict` をローカルで実行し、新しいコミットの変更をプッシュしてください。 + +### FILENAME check {#filename-check} + +このチェックは、[すべてのファイルが Prettier によってフォーマットされていること](../style-guide/#file-format) を検証します。 + +このチェックが失敗した場合、`npm fix:format` をローカルで実行し、新しいコミットで変更をプッシュしてください。 + +### FILE FORMAT {#file-format} + +このチェックは、[すべてのファイル名が kebab-case になっていること](../style-guide/#file-names) を検証します。 + +このチェックが失敗した場合、`npm fix:filenames` をローカルで実行し、新しいコミットで変更をプッシュしてください。 + +### BUILD and CHECK LINKS / REFCACHE updates? {#build-and-check-links--refcache-updates} + +このチェックは、コミットによって追加されたすべてのリンクが機能していることを検証します。 + +`npm run check:links` を実行して、ローカルでリンクを検証してください。 +これにより参照キャッシュ (`REFCACHE`) も更新されます。 +`REFCACHE` の変更があれば、新しいコミットでプッシュしてください。 + +### WARNINGS in build log? {#warnings-in-build-log} + +このチェックが失敗した場合、ビルドログを検証し、他の潜在的な問題を特定してください。 +復旧方法がわからない場合は、メンテナーに助けを求めてください。 From d30549f30f1df45847928dce58cf558cad8d55cd Mon Sep 17 00:00:00 2001 From: pinky <37374201+tko-cactus@users.noreply.github.com> Date: Thu, 13 Mar 2025 04:19:51 +0900 Subject: [PATCH 08/22] docs: translated demo/requirements into ja (#6522) --- content/ja/docs/demo/requirements/_index.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 content/ja/docs/demo/requirements/_index.md diff --git a/content/ja/docs/demo/requirements/_index.md b/content/ja/docs/demo/requirements/_index.md new file mode 100644 index 000000000000..4f5835c9be49 --- /dev/null +++ b/content/ja/docs/demo/requirements/_index.md @@ -0,0 +1,21 @@ +--- +title: デモ要件 +linkTitle: 要件 +default_lang_commit: f9cb26fb4a288f536ab20ab3f472060dd465ef56 +--- + +以下のドキュメントは私たちが公開しているデモアプリケーションに必要なアプリケーション、OpenTelemetry (OTel)、システムの要件を記載しています。 +これらは進行中のSIGミーティングの中で取り決められました。 + +1. [アプリケーション要件](application/) +2. [OpenTelemetry要件](opentelemetry/) +3. [システム要件](system/) + +## 対象読者 {#target-personas} + +私たちは以下の対象読者を想定してデモアプリケーションを作成しています。 + +1. **熱狂的な愛好家** 組織でOTelを提唱するために個人でデモアプリが使用できる方。 +2. **開発者** 特定の言語のスキルを持っていて、より大局的な視点を持ちたい方。 +3. **APMベンダー** 一般的にOTelを評価したり、顧客向けのデモを作成する方。 +4. **エンタープライズ** OTelの採用を検討していて、本番環境に近い環境での実験に興味と関心がある組織。 From bc6304e7751b31b263113f33a9f93e76afd4919f Mon Sep 17 00:00:00 2001 From: Yoshi Yamaguchi Date: Fri, 14 Mar 2025 06:15:19 +0900 Subject: [PATCH 09/22] [ja] translate SDK configurations (#6532) --- .../languages/sdk-configuration/_index.md | 11 + .../languages/sdk-configuration/general.md | 172 ++++++++++++++ .../sdk-configuration/otlp-exporter.md | 220 ++++++++++++++++++ 3 files changed, 403 insertions(+) create mode 100644 content/ja/docs/languages/sdk-configuration/_index.md create mode 100644 content/ja/docs/languages/sdk-configuration/general.md create mode 100644 content/ja/docs/languages/sdk-configuration/otlp-exporter.md diff --git a/content/ja/docs/languages/sdk-configuration/_index.md b/content/ja/docs/languages/sdk-configuration/_index.md new file mode 100644 index 000000000000..3dfa39900568 --- /dev/null +++ b/content/ja/docs/languages/sdk-configuration/_index.md @@ -0,0 +1,11 @@ +--- +title: SDKの設定 +linkTitle: SDKの設定 +aliases: [/docs/concepts/sdk-configuration] +weight: 1 +default_lang_commit: 9ba98f4fded66ec78bfafa189ab2d15d66df2309 +--- + +OpenTelemetry SDK は、各言語と環境変数によるコンフィギュレーションをサポートしています。 +以下のページでは、SDK を設定するために使用できる環境変数について説明します。 +環境変数で設定された値は、SDK APIを使用したコード内の同等の設定を上書きします。 diff --git a/content/ja/docs/languages/sdk-configuration/general.md b/content/ja/docs/languages/sdk-configuration/general.md new file mode 100644 index 000000000000..47c9ba019dc6 --- /dev/null +++ b/content/ja/docs/languages/sdk-configuration/general.md @@ -0,0 +1,172 @@ +--- +title: 一般的なSDK設定 +linkTitle: 一般 +aliases: [general-sdk-configuration] +default_lang_commit: 9ba98f4fded66ec78bfafa189ab2d15d66df2309 +cSpell:ignore: ottrace +--- + +{{% alert title="Note" color="info" %}} + +環境変数のサポートはオプションです。 +各言語の実装がどの環境変数をサポートしているかの詳細については、[実装準拠マトリックス](https://github.com/open-telemetry/opentelemetry-specification/blob/main/spec-compliance-matrix.md#environment-variables)を参照してください。 + +{{% /alert %}} + +## `OTEL_SERVICE_NAME` + +[`service.name`](/docs/specs/semconv/resource/#service) リソース属性の値を設定します。 + +**デフォルト値:** `"unknown_service"` + +`OTEL_RESOURCE_ATTRIBUTES` に `service.name` も指定されている場合は、`OTEL_SERVICE_NAME` が優先されます。 + +**例:** + +`export OTEL_SERVICE_NAME="your-service-name"` + +## `OTEL_RESOURCE_ATTRIBUTES` + +リソース属性として使用されるキーと値のペア。 +詳細は[リソースSDK](/docs/specs/otel/resource/sdk#specifying-resource-information-via-an-environment-variable)を参照してください。 + +**デフォルト値:** 空 + +一般的なリソースタイプで従うべきセマンティック規約については、[リソースのセマンティック規約](/docs/specs/semconv/resource/#semantic-attributes-with-sdk-provided-default-value)を参照してください。 + +**例:** + +`export OTEL_RESOURCE_ATTRIBUTES="key1=value1,key2=value2"` + +## `OTEL_TRACES_SAMPLER` + +SDKによるトレースのサンプリングに使用するサンプラーを指定します。 + +**デフォルト値:** `"parentbased_always_on"` + +**例:** + +`export OTEL_TRACES_SAMPLER="traceidratio"` + +`OTEL_TRACES_SAMPLER` に指定できる値の一覧は以下です。 + +- `"always_on"`: `AlwaysOnSampler` +- `"always_off"`: `AlwaysOffSampler` +- `"traceidratio"`: `TraceIdRatioBased` +- `"parentbased_always_on"`: `ParentBased(root=AlwaysOnSampler)` +- `"parentbased_always_off"`: `ParentBased(root=AlwaysOffSampler)` +- `"parentbased_traceidratio"`: `ParentBased(root=TraceIdRatioBased)` +- `"parentbased_jaeger_remote"`: `ParentBased(root=JaegerRemoteSampler)` +- `"jaeger_remote"`: `JaegerRemoteSampler` +- `"xray"`: + [AWS X-Ray Centralized Sampling](https://docs.aws.amazon.com/xray/latest/devguide/xray-console-sampling.html) + (_サードパーティ_) + +## `OTEL_TRACES_SAMPLER_ARG` + +`OTEL_TRACES_SAMPLER` で定義されているサンプラーの引数を指定します。 +指定した値は `OTEL_TRACES_SAMPLER` が設定されている場合にのみ使用されます。 +各サンプラータイプは、期待される入力があれば、それを定義します。 +無効な入力や認識できない入力はエラーとしてログに記録されます。 + +**デフォルト値:** 空 + +**例:** + +```shell +export OTEL_TRACES_SAMPLER="traceidratio" +export OTEL_TRACES_SAMPLER_ARG="0.5" +``` + +`OTEL_TRACES_SAMPLER` の値によって、`OTEL_TRACES_SAMPLER_ARG` は以下のように設定されます。 + +- `traceidratio` と `parentbased_traceidratio` サンプラーの場合: サンプリング確率。[0..1]の範囲で指定します。未設定の場合、デフォルトは1.0。 +- `jaeger_remote` と `parentbased_jaeger_remote` の場合: 値はカンマ区切りのリストです。 + - 例: + `"endpoint=http://localhost:14250,pollingIntervalMs=5000,initialSamplingRate=0.25"` + - `endpoint`: サービスのサンプリング戦略を提供する gRPC サーバの `scheme://host:port` 形式のエンドポイント ([sampling.proto](https://github.com/jaegertracing/jaeger-idl/blob/main/proto/api_v2/sampling.proto)). + - `pollingIntervalMs`: サンプラーがサンプリング戦略の更新のためにバックエンドをポーリングする頻度をミリ秒単位で指定します。 + - `initialSamplingRate`: [0..1]の範囲で、サンプリング戦略を取得するためにバックエンドに到達できない場合のサンプリング確率として使用されます。サンプリング戦略の取得に成功すると、この値は意味を持たなくなり、新しいアップデートが取得されるまでリモート戦略が使用されるようになります。 + +## `OTEL_PROPAGATORS` + +カンマ区切りのリストで使用するプロパゲーターを指定します。 + +**デフォルト値:** `"tracecontext,baggage"` + +**Example:** + +`export OTEL_PROPAGATORS="b3"` + +`OTEL_PROPAGATORS` に指定できる値の一覧は以下です。 + +- `"tracecontext"`: [W3C Trace Context](https://www.w3.org/TR/trace-context/) +- `"baggage"`: [W3C Baggage](https://www.w3.org/TR/baggage/) +- `"b3"`: [B3 Single](/docs/specs/otel/context/api-propagators#configuration) +- `"b3multi"`: + [B3 Multi](/docs/specs/otel/context/api-propagators#configuration) +- `"jaeger"`: + [Jaeger](https://www.jaegertracing.io/docs/1.21/client-libraries/#propagation-format) +- `"xray"`: + [AWS X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/xray-concepts.html#xray-concepts-tracingheader) + (_サードパーティ_) +- `"ottrace"`: + [OT Trace](https://github.com/opentracing?q=basic&type=&language=) (_サードパーティ_) +- `"none"`: 自動設定されたプロパゲータがない。 + +## `OTEL_TRACES_EXPORTER` + +トレースに使用するエクスポーターを指定します。 +実装によっては、カンマ区切りのリストになります。 + +**デフォルト値:** `"otlp"` + +**例:** + +`export OTEL_TRACES_EXPORTER="jaeger"` + +指定できる値の一覧は以下です。 + +- `"otlp"`: [OTLP][] +- `"jaeger"`: Jaegerデータモデルでのエクスポート +- `"zipkin"`: [Zipkin](https://zipkin.io/zipkin-api/) +- `"console"`: [Standard Output](/docs/specs/otel/trace/sdk_exporters/stdout/) +- `"none"`: トレース用に自動設定されたエクスポーターがない。 + +## `OTEL_METRICS_EXPORTER` + +メトリクスに使用するエクスポーターを指定します。 +実装によっては、カンマ区切りのリストになります。 + +**デフォルト値:** `"otlp"` + +**例:** + +`export OTEL_METRICS_EXPORTER="prometheus"` + +`OTEL_METRICS_EXPORTER` に指定できる値の一覧は以下です。 + +- `"otlp"`: [OTLP][] +- `"prometheus"`: + [Prometheus](https://github.com/prometheus/docs/blob/main/content/docs/instrumenting/exposition_formats.md) +- `"console"`: [標準出力](/docs/specs/otel/metrics/sdk_exporters/stdout/) +- `"none"`: メトリクスのエクスポーターが自動的に設定されない。 + +## `OTEL_LOGS_EXPORTER` + +ログにどのエクスポーターを使用するかを指定します。 +実装によっては、カンマ区切りのリストになります。 + +**デフォルト値:** `"otlp"` + +**例:** + +`export OTEL_LOGS_EXPORTER="otlp"` + +`OTEL_LOGS_EXPORTER` に指定できる値の一覧は以下です。 + +- `"otlp"`: [OTLP][] +- `"console"`: [標準出力](/docs/specs/otel/logs/sdk_exporters/stdout/) +- `"none"`: ログのエクスポーターが自動的に設定されない。 + +[otlp]: /docs/specs/otlp/ diff --git a/content/ja/docs/languages/sdk-configuration/otlp-exporter.md b/content/ja/docs/languages/sdk-configuration/otlp-exporter.md new file mode 100644 index 000000000000..faf0d6661ca8 --- /dev/null +++ b/content/ja/docs/languages/sdk-configuration/otlp-exporter.md @@ -0,0 +1,220 @@ +--- +title: OTLPエクスポーター設定 +linkTitle: OTLPエクスポーター +aliases: [otlp-exporter-configuration] +default_lang_commit: 9ba98f4fded66ec78bfafa189ab2d15d66df2309 +--- + +## エンドポイントの設定 {#endpoint-configuration} + +以下の環境変数により、トレース、メトリクス、およびログのためのOTLP/gRPCまたはOTLP/HTTPエンドポイントを構成できます。 + +### `OTEL_EXPORTER_OTLP_ENDPOINT` + +任意のシグナルタイプ用の基本エンドポイントURLで、オプションでポート番号を指定します。 +同じエンドポイントに複数のシグナルを送信し、1つの環境変数でエンドポイントを制御したい場合に便利です。 + +**デフォルト値:** + +- gRPC: `"http://localhost:4317"` +- HTTP: `"http://localhost:4318"` + +**例:** + +- gRPC: `export OTEL_EXPORTER_OTLP_ENDPOINT="https://my-api-endpoint:443"` +- HTTP: `export OTEL_EXPORTER_OTLP_ENDPOINT="http://my-api-endpoint/"` + +OTLP/HTTPの場合、この環境変数が設定されると、SDKのエクスポーターはシグナル固有のURLを構築します。 +つまり、トレース、メトリクス、ログを送信する場合、上記の例から以下のURLが構築されます。 + +- トレース: `"http://my-api-endpoint/v1/traces"` +- メトリクス: `"http://my-api-endpoint/v1/metrics"` +- ログ: `"http://my-api-endpoint/v1/logs"` + +### `OTEL_EXPORTER_OTLP_TRACES_ENDPOINT` + +トレースデータ専用のエンドポイントURL。 +オプションでポート番号を指定できます。 +OTLP/HTTP を使用している場合は、通常 `v1/traces` で終わります。 + +**デフォルト値:** + +- gRPC: `"http://localhost:4317"` +- HTTP: `"http://localhost:4318/v1/traces"` + +**例:** + +- gRPC: + `export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT="https://my-api-endpoint:443"` +- HTTP: + `export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT="http://my-api-endpoint/v1/traces"` + +### `OTEL_EXPORTER_OTLP_METRICS_ENDPOINT` + +オプションでポート番号を指定することができます。 +OTLP/HTTP を使用する場合は、通常 `v1/metrics` で終わります。 + +**デフォルト値:** + +- gRPC: `"http://localhost:4317"` +- HTTP: `"http://localhost:4318/v1/metrics"` + +**例:** + +- gRPC: + `export OTEL_EXPORTER_OTLP_METRICS_ENDPOINT="https://my-api-endpoint:443"` +- HTTP: + `export OTEL_EXPORTER_OTLP_METRICS_ENDPOINT="http://my-api-endpoint/v1/metrics"` + +### `OTEL_EXPORTER_OTLP_LOGS_ENDPOINT` + +ログデータ専用のエンドポイントURL。 +オプションでポート番号を指定できます。 +OTLP/HTTP を使う場合は、通常 `v1/logs` で終わります。 + +**デフォルト値:** + +- gRPC: `"http://localhost:4317"` +- HTTP: `"http://localhost:4318/v1/logs"` + +**例:** + +- gRPC: `export OTEL_EXPORTER_OTLP_LOGS_ENDPOINT="https://my-api-endpoint:443"` +- HTTP: + `export OTEL_EXPORTER_OTLP_LOGS_ENDPOINT="http://my-api-endpoint/v1/logs"` + +## ヘッダーの設定 {#header-configuration} + +以下の環境変数を使用すると、gRPC または HTTP リクエストの発信時に追加するヘッダーを、キーと値のペアのリストとして設定できます。 + +### `OTEL_EXPORTER_OTLP_HEADERS` + +すべての送信データ（トレース、メトリクス、ログ）に適用するヘッダーのリスト。 + +**デフォルト値:** なし + +**例:** +`export OTEL_EXPORTER_OTLP_HEADERS="api-key=key,other-config-value=value"` + +### `OTEL_EXPORTER_OTLP_TRACES_HEADERS` + +すべての送信トレースに適用するヘッダーのリスト。 + +**デフォルト値:** なし + +**例:** +`export OTEL_EXPORTER_OTLP_TRACES_HEADERS="api-key=key,other-config-value=value"` + +### `OTEL_EXPORTER_OTLP_METRICS_HEADERS` + +すべての送信メトリクスに適用するヘッダーのリスト。 + +**デフォルト値:** なし + +**例:** +`export OTEL_EXPORTER_OTLP_METRICS_HEADERS="api-key=key,other-config-value=value"` + +### `OTEL_EXPORTER_OTLP_LOGS_HEADERS` + +すべての送信ログに適用するヘッダーのリスト。 + +**デフォルト値:** なし + +**例:** +`export OTEL_EXPORTER_OTLP_LOGS_HEADERS="api-key=key,other-config-value=value"` + +## タイムアウトの設定 {#timeout-configuration} + +以下の環境変数は、OTLPエクスポーターがデータのネットバッチを送信する前に待つ最大時間（ミリ秒単位）を設定します。 + +### `OTEL_EXPORTER_OTLP_TIMEOUT` + +すべての送信データ（トレース、メトリクス、ログ）のタイムアウト値をミリ秒単位で指定します。 + +**デフォルト値:** `10000` (10秒) + +**例:** `export OTEL_EXPORTER_OTLP_TIMEOUT=500` + +### `OTEL_EXPORTER_OTLP_TRACES_TIMEOUT` + +すべての送信トレースのタイムアウト値（ミリ秒）。 + +**デフォルト値:** 10000 (10秒) + +**例:** `export OTEL_EXPORTER_OTLP_TRACES_TIMEOUT=500` + +### `OTEL_EXPORTER_OTLP_METRICS_TIMEOUT` + +すべての送信メトリクスのタイムアウト値をミリ秒単位で指定します。 + +**デフォルト値:** 10000 (10秒) + +**例:** `export OTEL_EXPORTER_OTLP_METRICS_TIMEOUT=500` + +### `OTEL_EXPORTER_OTLP_LOGS_TIMEOUT` + +すべての送信ログのタイムアウト値（ミリ秒）。 + +**デフォルト値:** 10000 (10s) + +**例:** `export OTEL_EXPORTER_OTLP_LOGS_TIMEOUT=500` + +## プロトコルの設定 {#protocol-configuration} + +以下の環境変数は、OTLPエクスポーターが使用するOTLPトランスポートプロトコルを設定します。 + +### `OTEL_EXPORTER_OTLP_PROTOCOL` + +すべてのテレメトリーデータに使用するOTLPトランスポートプロトコルを指定します。 + +**デフォルト値:** SDK依存ですが、通常は `http/protobuf` か `grpc` のいずれかです。 + +**例:** `export OTEL_EXPORTER_OTLP_PROTOCOL=grpc` + +指定できる値は以下です。 + +- OTLP/gRPCを使う場合は `grpc` +- OTLP/HTTP + protobuf を使う場合は `http/protobuf` +- OTLP/HTTP + JSON を使う場合は `http/json` + +### `OTEL_EXPORTER_OTLP_TRACES_PROTOCOL` + +トレースデータに使用するOTLPトランスポートプロトコルを指定します。 + +**デフォルト値:** SDK依存ですが、通常は `http/protobuf` か `grpc` のいずれかです。 + +**例:** `export OTEL_EXPORTER_OTLP_TRACES_PROTOCOL=grpc` + +指定できる値は以下です。 + +- OTLP/gRPCを使う場合は `grpc` +- OTLP/HTTP + protobuf を使う場合は `http/protobuf` +- OTLP/HTTP + JSON を使う場合は `http/json` + +### `OTEL_EXPORTER_OTLP_METRICS_PROTOCOL` + +メトリクスデータに使用するOTLPトランスポートプロトコルを指定します。 + +**デフォルト値:** SDK依存ですが、通常は `http/protobuf` か `grpc` のいずれかです。 + +**例:** `export OTEL_EXPORTER_OTLP_METRICS_PROTOCOL=grpc` + +指定できる値は以下です。 + +- OTLP/gRPCを使う場合は `grpc` +- OTLP/HTTP + protobuf を使う場合は `http/protobuf` +- OTLP/HTTP + JSON を使う場合は `http/json` + +### `OTEL_EXPORTER_OTLP_LOGS_PROTOCOL` + +ログデータに使用するOTLPトランスポートプロトコルを指定します。 + +**デフォルト値:** SDK依存ですが、通常は `http/protobuf` か `grpc` のいずれかです。 + +**例:** `export OTEL_EXPORTER_OTLP_LOGS_PROTOCOL=grpc` + +指定できる値は以下です。 + +- OTLP/gRPCを使う場合は `grpc` +- OTLP/HTTP + protobuf を使う場合は `http/protobuf` +- OTLP/HTTP + JSON を使う場合は `http/json` From 8b9d175abfc926d84eb68c10487fae246ffd1369 Mon Sep 17 00:00:00 2001 From: Msksgm <49427230+Msksgm@users.noreply.github.com> Date: Fri, 14 Mar 2025 06:16:52 +0900 Subject: [PATCH 10/22] [ja] translated contributing/development into ja (#6536) --- content/ja/docs/contributing/development.md | 119 ++++++++++++++++++++ 1 file changed, 119 insertions(+) create mode 100644 content/ja/docs/contributing/development.md diff --git a/content/ja/docs/contributing/development.md b/content/ja/docs/contributing/development.md new file mode 100644 index 000000000000..125d9eae49fc --- /dev/null +++ b/content/ja/docs/contributing/development.md @@ -0,0 +1,119 @@ +--- +title: 開発環境のセットアップとビルド、サーブなどのコマンド +linkTitle: 開発環境セットアップなど +description: この Web サイトの開発環境をセットアップする方法を学びます。 +weight: 60 +default_lang_commit: 9ba98f4fded66ec78bfafa189ab2d15d66df2309 +--- + +以下の手順では、この Web サイトの開発環境をセットアップする方法を説明します。 + +## クラウド IDE のセットアップ {#cloud-ide-setup} + +これらの手順は [Gitpod.io] 用ですが、お好みのクラウド IDE に合わせて調整してください。 + +1. このリポジトリをフォークします。詳細は [リポジトリのフォーク方法][fork] を参照してください。 +2. [gitpod.io/workspaces] から新しいワークスペースを作成する（初回のみ）か、フォークしたリポジトリ上の既存のワークスペースを開きます。 + また、次の形式のリンクを開くこともできます。 + `https://gitpod.io#https://github.com/YOUR_GITHUB_ID/opentelemetry.io` + + > **注記**: このリポジトリで作業するための権限がある場合や、単に内容を確認したい場合は、 + > を開いてください。 + +Gitpod はリポジトリ固有のパッケージを自動的にインストールします。 + +これで、[ビルド](#build)、[サーブ](#serve)、または Web サイトファイルの更新を行う準備が整いました。 + +## ローカルセットアップ {#local-setup} + +1. <{{% param github_repo %}}> でWeb サイトのリポジトリ[フォーク][fork]した後に、[クローン][clone]します。 +2. リポジトリのディレクトリに移動します。 +3. Node.js の [**Active LTS** リリース][nodejs-rel] をインストールまたはアップグレードします。Node.js インストレーションの管理には [nvm][] の使用を推奨します。Linux では以下のコマンドを実行してください。.nvmrc ファイルで指定されたバージョンにインストールとアップグレードします。 + + ```sh + nvm install + ``` + + Windows で [インストールする場合][nodejs-win] は、[nvm-windows][] を使用してください。 + + ```cmd + > nvm install lts && nvm use lts + ``` + +4. npm パッケージとその他の依存関係をインストールします。 + + ```sh + npm install + ``` + +これで、[ビルド](#build)、[サーブ](#serve)、または Web サイトファイルの更新を行う準備が整いました。 + +### ビルド {#build} + +サイトをビルドするには、次のコマンドを実行します。 + +```sh +npm run build +``` + +生成されたサイトのファイルは `public` ディレクトリ内にあります。 + +### サーブ {#serve} + +サイトをサーブするには、次のコマンドを実行します。 + +```sh +npm run serve +``` + +サイトは [localhost:1313][] でサーブされます。 + +[Netlify] のリダイレクトをテストする必要がある場合は、次のコマンドを実行し、[localhost:8888][] にアクセスしてください。 + +```sh +npm run serve:netlify +``` + +この `serve` コマンドは、ディスクではなくメモリ上のファイルを提供します。 + +macOS で `too many open files` や `pipe failed` というエラーが発生する場合は、ファイルディスクリプタの制限を増やす必要があるかもしれません。 +詳しくは [Hugo のイシューの #6109](https://github.com/gohugoio/hugo/issues/6109) を参照してください。 + +### コンテンツとサブモジュール {#content-and-submodules} + +Web サイトは以下のコンテンツを基に構築されます。 + +- `content/`、`static/` などの [Hugo][] のデフォルトディレクトリ +- [hugo.yaml][] の `mounts` で定義されたマウントポイント + - これらは [content-modules][] の Git サブモジュールから直接取得される場合や、 + `content-modules` 内で前処理されたコンテンツが `tmp/` に配置される場合があります。 + +[hugo.yaml]: https://github.com/open-telemetry/opentelemetry.io/blob/main/hugo.yaml +[content-modules]: https://github.com/open-telemetry/opentelemetry.io/tree/main/content-modules + +### サブモジュールの変更 {#submodule-changes} + +[content-modules][] のサブモジュール内のコンテンツを変更する場合は、まずそのサブモジュールのリポジトリに対して PR（サブモジュールの変更を含む）を送信する必要があります。 +サブモジュールの PR が承認された後にのみ、サブモジュールを更新し、この Web サイトに変更を反映できます。 + +これは、サブモジュールそのものを更新するよりも、対応するサブモジュールの元のリポジトリで作業することが、`content-modules` の変更を管理する最も簡単な方法です。 + +経験豊富なコントリビューターは、サブモジュール内で直接作業することも可能です。 +その場合、（サブモジュールの）変更を直接ビルドおよびサーブできます。 +デフォルトでは CI スクリプトが呼び出しのたびに、サブモジュールを取得します。 +作業中にこの動作を防ぐには、環境変数 `GET=no` を設定してください。 +サブモジュールの PR を提出する前に、サブモジュールに対して `git fetch --unshallow` を実行する必要もあります。 +または、`DEPTH=100` を設定してサブモジュールを再取得してください。 + +[clone]: https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository +[fork]: https://docs.github.com/en/get-started/quickstart/fork-a-repo +[gitpod.io]: https://gitpod.io +[gitpod.io/workspaces]: https://gitpod.io/workspaces +[hugo]: https://gohugo.io +[localhost:1313]: http://localhost:1313 +[localhost:8888]: http://localhost:8888 +[netlify]: https://netlify.com +[nodejs-rel]: https://nodejs.org/en/about/previous-releases +[nodejs-win]: https://docs.microsoft.com/en-us/windows/dev-environment/javascript/nodejs-on-windows +[nvm]: https://github.com/nvm-sh/nvm/blob/master/README.md#installing-and-updating +[nvm-windows]: https://github.com/coreybutler/nvm-windows From e85131c9df86695802b83caaf17f009c74112c32 Mon Sep 17 00:00:00 2001 From: Msksgm <49427230+Msksgm@users.noreply.github.com> Date: Fri, 14 Mar 2025 06:17:35 +0900 Subject: [PATCH 11/22] [ja] translated contributing/acknowledgements into ja (#6539) --- content/ja/docs/contributing/acknowledgements.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) create mode 100644 content/ja/docs/contributing/acknowledgements.md diff --git a/content/ja/docs/contributing/acknowledgements.md b/content/ja/docs/contributing/acknowledgements.md new file mode 100644 index 000000000000..a262e8b44b8b --- /dev/null +++ b/content/ja/docs/contributing/acknowledgements.md @@ -0,0 +1,16 @@ +--- +title: 謝辞 +description: 本サイトの内容に関するソースへの謝辞 +aliases: [/acknowledgements, /docs/acknowledgements] +default_lang_commit: 722beb5b9ecf8a603b2f5ae6128e3c3509f52fcf +cSpell:ignore: Pigram +--- + +本サイトの一部のコンテンツについて、以下のソースに感謝の意を表します。 + +1. [APM is Dying and That's Okay - Lightstep](https://lightstep.com/blog/apm-is-dying-and-thats-okay) +2. [Alexandria Pigram](https://github.com/alexandriastech)（[Honeycomb](https://www.honeycomb.io/) による、[トレース](/docs/concepts/signals/traces/)に関するトレーシングの内容） +3. [What is OpenTelemetry - Dynatrace](https://www.dynatrace.com/news/blog/what-is-opentelemetry-2/) +4. [Understanding OpenTracing, OpenCensus, and OpenMetrics - BMC](https://www.bmc.com/blogs/opentracing-opencensus-openmetrics/) +5. [Ask Miss O11y: Baggage in OTel - Honeycomb](https://www.honeycomb.io/blog/ask-miss-o11y-opentelemetry-baggage/) +6. [Observability Whitepaper - CNCF Tag Observability](https://github.com/cncf/tag-observability/blob/whitepaper-v1.0.0/whitepaper.md)（[シグナル](/docs/concepts/signals/)に関する内容） From 00235cd179d556d80fa62ca363dbe655cc6e8691 Mon Sep 17 00:00:00 2001 From: Kieron Lanning Date: Fri, 14 Mar 2025 10:51:16 +0000 Subject: [PATCH 12/22] Updated description/ details for Purview.Telemetry.SourceGenerator in Registry (#6546) --- ...tnet-purview-telemetry-sourcegenerator.yml | 46 +++++++++++++------ static/refcache.json | 20 ++++++++ 2 files changed, 51 insertions(+), 15 deletions(-) diff --git a/data/registry/tools-dotnet-purview-telemetry-sourcegenerator.yml b/data/registry/tools-dotnet-purview-telemetry-sourcegenerator.yml index 66ba9d6ed490..48e118f9f566 100644 --- a/data/registry/tools-dotnet-purview-telemetry-sourcegenerator.yml +++ b/data/registry/tools-dotnet-purview-telemetry-sourcegenerator.yml @@ -6,32 +6,48 @@ tags: - c# - .net - dotnet - - source-generator - - activities - - logging + - aspnet - logs - - events - - metrics - - spans - - attributes - - tags - - baggage - - telemetry + - log + - logger + - logging + - source-generator - high-performance-logging + - otel + - open-telemetry + - telemetry + - traces - tracing + - metric + - metrics + - meter + - meters + - instrumentation + - instruments + - events + - distributed-traces - distributed-tracing - - dependency-injection + - melt - purview - - nuget license: MIT description: - Generates ActivitySource, Activity, ActivityEvent, High-performance logging - (ILogger) and Metrics based on methods on an interface, enabling fast - iteration cycles and substitutes for testing through dependency injection. + 'Generates + [ActivitySource](https://learn.microsoft.com/en-us/dotnet/api/system.diagnostics.activitysource), + [ILogger](https://learn.microsoft.com/en-us/dotnet/api/microsoft.extensions.logging.ilogger), + and + [Metrics](https://learn.microsoft.com/en-us/dotnet/api/system.diagnostics.metrics) + based telemetry from methods you define on an interface.

This + approach allows for:
- Faster iteration cycles - simply create the + method on your interface and the implementation will be automatically + generated
- Easy mocking/ substitution for testing - a full sample + project, including tests can be found + [here](https://github.com/purview-dev/purview-telemetry-sourcegenerator/tree/main/samples/SampleApp)
- Built-in dependency injection helper generation' authors: - name: Kieron Lanning url: https://github.com/kieronlanning urls: + website: https://github.com/purview-dev/purview-telemetry-sourcegenerator/wiki repo: https://github.com/purview-dev/purview-telemetry-sourcegenerator/ docs: https://github.com/purview-dev/purview-telemetry-sourcegenerator/blob/main/README.md createdAt: 2024-04-26 diff --git a/static/refcache.json b/static/refcache.json index af3accafcebe..62ffaa82550f 100644 --- a/static/refcache.json +++ b/static/refcache.json @@ -12247,6 +12247,14 @@ "StatusCode": 206, "LastSeen": "2025-01-16T11:40:52.473775-05:00" }, + "https://github.com/purview-dev/purview-telemetry-sourcegenerator/tree/main/samples/SampleApp": { + "StatusCode": 206, + "LastSeen": "2025-03-14T10:04:55.39722679Z" + }, + "https://github.com/purview-dev/purview-telemetry-sourcegenerator/wiki": { + "StatusCode": 206, + "LastSeen": "2025-03-14T10:04:55.71535952Z" + }, "https://github.com/pyohannes": { "StatusCode": 206, "LastSeen": "2025-02-02T10:41:25.960943-05:00" @@ -13895,6 +13903,18 @@ "StatusCode": 206, "LastSeen": "2025-02-01T06:58:04.411013-05:00" }, + "https://learn.microsoft.com/en-us/dotnet/api/microsoft.extensions.logging.ilogger": { + "StatusCode": 206, + "LastSeen": "2025-03-14T10:04:54.552538273Z" + }, + "https://learn.microsoft.com/en-us/dotnet/api/system.diagnostics.activitysource": { + "StatusCode": 200, + "LastSeen": "2025-03-14T10:04:53.921752353Z" + }, + "https://learn.microsoft.com/en-us/dotnet/api/system.diagnostics.metrics": { + "StatusCode": 200, + "LastSeen": "2025-03-14T10:04:54.95919053Z" + }, "https://learn.microsoft.com/en-us/dotnet/api/system.reflection.assembly.getentryassembly": { "StatusCode": 200, "LastSeen": "2025-01-30T14:41:04.756369-05:00" From 8cf79eda9f446a5d284d7947aa07b2087397c55c Mon Sep 17 00:00:00 2001 From: jason plumb <75337021+breedx-splk@users.noreply.github.com> Date: Fri, 14 Mar 2025 04:14:19 -0700 Subject: [PATCH 13/22] Add docs for @WithSpan params. (#6543) Co-authored-by: opentelemetrybot <107717825+opentelemetrybot@users.noreply.github.com> Co-authored-by: Fabrizio Ferri-Benedetti --- .../docs/zero-code/java/agent/annotations.md | 19 +++++++++++++++++++ .../blog/2025/ai-agent-observability/index.md | 1 + static/refcache.json | 4 ++++ 3 files changed, 24 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..dc93c1e7e3ee 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 the following optional parameters to allow +customization of spans: + +| name | type | default | description | +| ---------------- | ----------------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------- | +| `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: + +```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 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/static/refcache.json b/static/refcache.json index 62ffaa82550f..03f956539a27 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 69398c8888f7ee66233928526c51e8a5cd578f70 Mon Sep 17 00:00:00 2001 From: OpenTelemetry Bot <107717825+opentelemetrybot@users.noreply.github.com> Date: Fri, 14 Mar 2025 04:16:37 -0700 Subject: [PATCH 14/22] Auto-update registry versions (ec0219561e3dbe276f9d3bd3b41468ad0744d97b) (#6540) --- data/registry/instrumentation-js-cerbos.yml | 2 +- data/registry/instrumentation-php-cakephp.yml | 2 +- data/registry/instrumentation-php-codeigniter.yml | 2 +- data/registry/instrumentation-php-curl.yml | 2 +- data/registry/instrumentation-php-extamqp.yml | 2 +- data/registry/instrumentation-php-extrdkafka.yml | 2 +- data/registry/instrumentation-php-guzzle.yml | 2 +- data/registry/instrumentation-php-httpasyncclient.yml | 2 +- data/registry/instrumentation-php-io.yml | 2 +- data/registry/instrumentation-php-mongodb.yml | 2 +- data/registry/instrumentation-php-openaiphp.yml | 2 +- data/registry/instrumentation-php-pdo.yml | 2 +- data/registry/instrumentation-php-psr14.yml | 2 +- data/registry/instrumentation-php-psr15.yml | 2 +- data/registry/instrumentation-php-psr16.yml | 2 +- data/registry/instrumentation-php-psr18.yml | 2 +- data/registry/instrumentation-php-psr3.yml | 2 +- data/registry/instrumentation-php-psr6.yml | 2 +- data/registry/instrumentation-php-slim.yml | 2 +- data/registry/instrumentation-php-symfony.yml | 2 +- data/registry/instrumentation-php-wordpress.yml | 2 +- data/registry/instrumentation-php-yii.yml | 2 +- 22 files changed, 22 insertions(+), 22 deletions(-) diff --git a/data/registry/instrumentation-js-cerbos.yml b/data/registry/instrumentation-js-cerbos.yml index 00632322e57a..4a51b1f07eaa 100644 --- a/data/registry/instrumentation-js-cerbos.yml +++ b/data/registry/instrumentation-js-cerbos.yml @@ -21,5 +21,5 @@ createdAt: 2023-09-13 package: name: '@cerbos/opentelemetry' registry: npm - version: 0.5.8 + version: 0.5.9 isFirstParty: true diff --git a/data/registry/instrumentation-php-cakephp.yml b/data/registry/instrumentation-php-cakephp.yml index 17898e2ed751..823ead90b857 100644 --- a/data/registry/instrumentation-php-cakephp.yml +++ b/data/registry/instrumentation-php-cakephp.yml @@ -18,5 +18,5 @@ createdAt: 2024-07-08 package: registry: packagist name: open-telemetry/opentelemetry-auto-cakephp - version: 0.0.3 + version: 0.0.4 isFirstParty: false diff --git a/data/registry/instrumentation-php-codeigniter.yml b/data/registry/instrumentation-php-codeigniter.yml index 4fc9df33d32c..4c3dac90b510 100644 --- a/data/registry/instrumentation-php-codeigniter.yml +++ b/data/registry/instrumentation-php-codeigniter.yml @@ -16,5 +16,5 @@ createdAt: 2023-05-22 package: registry: packagist name: open-telemetry/opentelemetry-auto-codeigniter - version: 0.0.8 + version: 0.0.9 isFirstParty: false diff --git a/data/registry/instrumentation-php-curl.yml b/data/registry/instrumentation-php-curl.yml index 6a0decac30e0..85e241b058d3 100644 --- a/data/registry/instrumentation-php-curl.yml +++ b/data/registry/instrumentation-php-curl.yml @@ -19,5 +19,5 @@ createdAt: 2024-11-18 package: registry: packagist name: open-telemetry/opentelemetry-auto-curl - version: 0.0.2 + version: 0.0.3 isFirstParty: false diff --git a/data/registry/instrumentation-php-extamqp.yml b/data/registry/instrumentation-php-extamqp.yml index 0efb8799e057..663a46014db4 100644 --- a/data/registry/instrumentation-php-extamqp.yml +++ b/data/registry/instrumentation-php-extamqp.yml @@ -16,5 +16,5 @@ createdAt: 2024-01-19 package: registry: packagist name: open-telemetry/opentelemetry-auto-ext-amqp - version: 0.0.4 + version: 0.0.5 isFirstParty: false diff --git a/data/registry/instrumentation-php-extrdkafka.yml b/data/registry/instrumentation-php-extrdkafka.yml index 12091f79c2cb..661172bcba6e 100644 --- a/data/registry/instrumentation-php-extrdkafka.yml +++ b/data/registry/instrumentation-php-extrdkafka.yml @@ -20,5 +20,5 @@ createdAt: 2024-11-18 package: registry: packagist name: open-telemetry/opentelemetry-auto-ext-rdkafka - version: 0.0.1 + version: 0.0.2 isFirstParty: false diff --git a/data/registry/instrumentation-php-guzzle.yml b/data/registry/instrumentation-php-guzzle.yml index 95212624294a..ff7660e613b3 100644 --- a/data/registry/instrumentation-php-guzzle.yml +++ b/data/registry/instrumentation-php-guzzle.yml @@ -15,5 +15,5 @@ createdAt: 2024-01-19 package: registry: packagist name: open-telemetry/opentelemetry-auto-guzzle - version: 1.0.1 + version: 1.1.0 isFirstParty: false diff --git a/data/registry/instrumentation-php-httpasyncclient.yml b/data/registry/instrumentation-php-httpasyncclient.yml index 6d1c08f906dc..25c8a575fd51 100644 --- a/data/registry/instrumentation-php-httpasyncclient.yml +++ b/data/registry/instrumentation-php-httpasyncclient.yml @@ -16,5 +16,5 @@ createdAt: 2023-05-22 package: registry: packagist name: open-telemetry/opentelemetry-auto-http-async - version: 1.0.1 + version: 1.1.0 isFirstParty: false diff --git a/data/registry/instrumentation-php-io.yml b/data/registry/instrumentation-php-io.yml index 4d3c672617bc..80d6ec4147bf 100644 --- a/data/registry/instrumentation-php-io.yml +++ b/data/registry/instrumentation-php-io.yml @@ -15,5 +15,5 @@ createdAt: 2023-05-22 package: registry: packagist name: open-telemetry/opentelemetry-auto-io - version: 0.0.12 + version: 0.0.13 isFirstParty: false diff --git a/data/registry/instrumentation-php-mongodb.yml b/data/registry/instrumentation-php-mongodb.yml index 78676e22c86d..fcbfe540be9b 100644 --- a/data/registry/instrumentation-php-mongodb.yml +++ b/data/registry/instrumentation-php-mongodb.yml @@ -17,5 +17,5 @@ createdAt: 2023-08-08 package: registry: packagist name: open-telemetry/opentelemetry-auto-mongodb - version: 0.0.7 + version: 0.0.8 isFirstParty: false diff --git a/data/registry/instrumentation-php-openaiphp.yml b/data/registry/instrumentation-php-openaiphp.yml index d6019d703313..2531a4202fa5 100644 --- a/data/registry/instrumentation-php-openaiphp.yml +++ b/data/registry/instrumentation-php-openaiphp.yml @@ -19,5 +19,5 @@ createdAt: 2024-02-05 package: registry: packagist name: open-telemetry/opentelemetry-auto-openai-php - version: 0.0.2 + version: 0.0.3 isFirstParty: false diff --git a/data/registry/instrumentation-php-pdo.yml b/data/registry/instrumentation-php-pdo.yml index e15155a9ea23..33f404d5e2fd 100644 --- a/data/registry/instrumentation-php-pdo.yml +++ b/data/registry/instrumentation-php-pdo.yml @@ -15,5 +15,5 @@ createdAt: 2023-05-22 package: registry: packagist name: open-telemetry/opentelemetry-auto-pdo - version: 0.0.17 + version: 0.0.18 isFirstParty: false diff --git a/data/registry/instrumentation-php-psr14.yml b/data/registry/instrumentation-php-psr14.yml index fb2ca960ccfe..d0a07fb1620d 100644 --- a/data/registry/instrumentation-php-psr14.yml +++ b/data/registry/instrumentation-php-psr14.yml @@ -17,5 +17,5 @@ createdAt: 2024-01-19 package: registry: packagist name: open-telemetry/opentelemetry-auto-psr14 - version: 0.0.3 + version: 0.0.4 isFirstParty: false diff --git a/data/registry/instrumentation-php-psr15.yml b/data/registry/instrumentation-php-psr15.yml index 22072406793c..52f7161fe5d8 100644 --- a/data/registry/instrumentation-php-psr15.yml +++ b/data/registry/instrumentation-php-psr15.yml @@ -15,5 +15,5 @@ createdAt: 2022-12-14 package: registry: packagist name: open-telemetry/opentelemetry-auto-psr15 - version: 1.0.6 + version: 1.1.0 isFirstParty: false diff --git a/data/registry/instrumentation-php-psr16.yml b/data/registry/instrumentation-php-psr16.yml index fb59632eb4b8..4f0587d75256 100644 --- a/data/registry/instrumentation-php-psr16.yml +++ b/data/registry/instrumentation-php-psr16.yml @@ -17,5 +17,5 @@ createdAt: 2024-04-18 package: registry: packagist name: open-telemetry/opentelemetry-auto-psr16 - version: 0.0.3 + version: 0.0.4 isFirstParty: false diff --git a/data/registry/instrumentation-php-psr18.yml b/data/registry/instrumentation-php-psr18.yml index 5ba0fa48cac0..e28179ae84c7 100644 --- a/data/registry/instrumentation-php-psr18.yml +++ b/data/registry/instrumentation-php-psr18.yml @@ -16,5 +16,5 @@ createdAt: 2022-12-14 package: registry: packagist name: open-telemetry/opentelemetry-auto-psr18 - version: 1.0.4 + version: 1.1.0 isFirstParty: false diff --git a/data/registry/instrumentation-php-psr3.yml b/data/registry/instrumentation-php-psr3.yml index ff0ba130d1cc..f253158f8454 100644 --- a/data/registry/instrumentation-php-psr3.yml +++ b/data/registry/instrumentation-php-psr3.yml @@ -17,5 +17,5 @@ createdAt: 2023-07-10 package: registry: packagist name: open-telemetry/opentelemetry-auto-psr3 - version: 0.0.8 + version: 0.0.9 isFirstParty: false diff --git a/data/registry/instrumentation-php-psr6.yml b/data/registry/instrumentation-php-psr6.yml index c7f511818a60..39de618ea121 100644 --- a/data/registry/instrumentation-php-psr6.yml +++ b/data/registry/instrumentation-php-psr6.yml @@ -17,5 +17,5 @@ createdAt: 2024-07-08 package: registry: packagist name: open-telemetry/opentelemetry-auto-psr6 - version: 0.0.3 + version: 0.0.4 isFirstParty: false diff --git a/data/registry/instrumentation-php-slim.yml b/data/registry/instrumentation-php-slim.yml index 5b6f013a1df4..15611e7fb5ba 100644 --- a/data/registry/instrumentation-php-slim.yml +++ b/data/registry/instrumentation-php-slim.yml @@ -15,5 +15,5 @@ createdAt: 2022-12-14 package: registry: packagist name: open-telemetry/opentelemetry-auto-slim - version: 1.0.7 + version: 1.1.0 isFirstParty: false diff --git a/data/registry/instrumentation-php-symfony.yml b/data/registry/instrumentation-php-symfony.yml index a3660b093f17..d4ead0e2c87d 100644 --- a/data/registry/instrumentation-php-symfony.yml +++ b/data/registry/instrumentation-php-symfony.yml @@ -15,5 +15,5 @@ createdAt: 2023-05-22 package: registry: packagist name: open-telemetry/opentelemetry-auto-symfony - version: 1.0.0beta30 + version: 1.0.0 isFirstParty: false diff --git a/data/registry/instrumentation-php-wordpress.yml b/data/registry/instrumentation-php-wordpress.yml index 8e3b0f0553f1..6955412c1ba4 100644 --- a/data/registry/instrumentation-php-wordpress.yml +++ b/data/registry/instrumentation-php-wordpress.yml @@ -15,5 +15,5 @@ createdAt: 2023-05-22 package: registry: packagist name: open-telemetry/opentelemetry-auto-wordpress - version: 0.0.16 + version: 0.0.17 isFirstParty: false diff --git a/data/registry/instrumentation-php-yii.yml b/data/registry/instrumentation-php-yii.yml index 42b4374e9e71..406e44b32c5e 100644 --- a/data/registry/instrumentation-php-yii.yml +++ b/data/registry/instrumentation-php-yii.yml @@ -14,5 +14,5 @@ createdAt: 2022-12-14 package: registry: packagist name: open-telemetry/opentelemetry-auto-yii - version: 0.0.5 + version: 0.0.6 isFirstParty: false From a2a852028cdb94931352316d697caf740af123b3 Mon Sep 17 00:00:00 2001 From: OpenTelemetry Bot <107717825+opentelemetrybot@users.noreply.github.com> Date: Fri, 14 Mar 2025 04:41:36 -0700 Subject: [PATCH 15/22] Update opentelemetry-java-instrumentation version to v2.14.0 (#6545) Co-authored-by: Fabrizio Ferri-Benedetti --- content/en/docs/languages/java/_index.md | 2 +- content/en/docs/zero-code/java/_index.md | 2 +- static/refcache.json | 8 ++++++++ 3 files changed, 10 insertions(+), 2 deletions(-) diff --git a/content/en/docs/languages/java/_index.md b/content/en/docs/languages/java/_index.md index 968f320bd352..3ad1df611bc5 100644 --- a/content/en/docs/languages/java/_index.md +++ b/content/en/docs/languages/java/_index.md @@ -6,7 +6,7 @@ description: >- aliases: [/java, /java/metrics, /java/tracing] cascade: vers: - instrumentation: 2.13.3 + instrumentation: 2.14.0 otel: 1.48.0 contrib: 1.44.0 semconv: 1.30.0 diff --git a/content/en/docs/zero-code/java/_index.md b/content/en/docs/zero-code/java/_index.md index a7d5ec0b86f3..411e8f419662 100644 --- a/content/en/docs/zero-code/java/_index.md +++ b/content/en/docs/zero-code/java/_index.md @@ -6,7 +6,7 @@ aliases: - /docs/languages/java/automatic_instrumentation cascade: vers: - instrumentation: 2.13.3 + instrumentation: 2.14.0 otel: 1.48.0 --- diff --git a/static/refcache.json b/static/refcache.json index 03f956539a27..3c68c771dcfb 100644 --- a/static/refcache.json +++ b/static/refcache.json @@ -16339,6 +16339,10 @@ "StatusCode": 206, "LastSeen": "2025-02-28T17:42:49.919886094Z" }, + "https://repo1.maven.org/maven2/io/opentelemetry/instrumentation/opentelemetry-instrumentation-bom-alpha/2.14.0-alpha/opentelemetry-instrumentation-bom-alpha-2.14.0-alpha.pom": { + "StatusCode": 206, + "LastSeen": "2025-03-14T11:18:49.240831716Z" + }, "https://repo1.maven.org/maven2/io/opentelemetry/instrumentation/opentelemetry-instrumentation-bom-alpha/2.7.0-alpha/opentelemetry-instrumentation-bom-alpha-2.7.0-alpha.pom": { "StatusCode": 206, "LastSeen": "2024-10-23T20:20:08.34491-05:00" @@ -16371,6 +16375,10 @@ "StatusCode": 206, "LastSeen": "2025-02-28T17:42:47.206408302Z" }, + "https://repo1.maven.org/maven2/io/opentelemetry/instrumentation/opentelemetry-instrumentation-bom/2.14.0/opentelemetry-instrumentation-bom-2.14.0.pom": { + "StatusCode": 206, + "LastSeen": "2025-03-14T11:18:48.069661166Z" + }, "https://repo1.maven.org/maven2/io/opentelemetry/instrumentation/opentelemetry-instrumentation-bom/2.7.0/opentelemetry-instrumentation-bom-2.7.0.pom": { "StatusCode": 206, "LastSeen": "2024-10-23T20:20:07.402964-05:00" From 90e8c071c6d2543793ea88d793bde0e42ddf9838 Mon Sep 17 00:00:00 2001 From: Yoshi Yamaguchi Date: Sat, 15 Mar 2025 01:01:36 +0900 Subject: [PATCH 16/22] [ja] translate platform/android and platform/faas (#6535) --- content/ja/docs/platforms/_index.md | 10 ++ content/ja/docs/platforms/android/_index.md | 7 + content/ja/docs/platforms/faas/_index.md | 22 +++ .../platforms/faas/lambda-auto-instrument.md | 114 +++++++++++++ .../docs/platforms/faas/lambda-collector.md | 156 ++++++++++++++++++ .../faas/lambda-manual-instrument.md | 23 +++ 6 files changed, 332 insertions(+) create mode 100644 content/ja/docs/platforms/_index.md create mode 100644 content/ja/docs/platforms/android/_index.md create mode 100644 content/ja/docs/platforms/faas/_index.md create mode 100644 content/ja/docs/platforms/faas/lambda-auto-instrument.md create mode 100644 content/ja/docs/platforms/faas/lambda-collector.md create mode 100644 content/ja/docs/platforms/faas/lambda-manual-instrument.md diff --git a/content/ja/docs/platforms/_index.md b/content/ja/docs/platforms/_index.md new file mode 100644 index 000000000000..52ad2fbd8893 --- /dev/null +++ b/content/ja/docs/platforms/_index.md @@ -0,0 +1,10 @@ +--- +title: プラットフォームと環境 +linkTitle: プラットフォーム +description: OpenTelemetryをサポートするハードウェアとソフトウェアのプラットフォームや環境 +weight: 260 +default_lang_commit: 9ba98f4fded66ec78bfafa189ab2d15d66df2309 +--- + +OpenTelemetry はさまざまなプラットフォームと環境で利用可能で、ハイブリッドシステムでのシームレスなオブザーバビリティを保証します。 +この節では、サポートされているプラットフォームで OpenTelemetry を有効にして使用する方法について説明します。 diff --git a/content/ja/docs/platforms/android/_index.md b/content/ja/docs/platforms/android/_index.md new file mode 100644 index 000000000000..c31029ca024a --- /dev/null +++ b/content/ja/docs/platforms/android/_index.md @@ -0,0 +1,7 @@ +--- +title: Android +# description: +default_lang_commit: 9ba98f4fded66ec78bfafa189ab2d15d66df2309 +--- + +コンテンツは近日公開！ diff --git a/content/ja/docs/platforms/faas/_index.md b/content/ja/docs/platforms/faas/_index.md new file mode 100644 index 000000000000..0223810cfe02 --- /dev/null +++ b/content/ja/docs/platforms/faas/_index.md @@ -0,0 +1,22 @@ +--- +title: Functions as a Service +linkTitle: FaaS +description: >- + OpenTelemetryは、さまざまなクラウドベンダーが提供するFaaSを監視するさまざまな方法をサポートしています。 +redirects: [{ from: /docs/faas/*, to: ':splat' }] # cSpell:disable-line +default_lang_commit: 9ba98f4fded66ec78bfafa189ab2d15d66df2309 +--- + +Functions as a Service（FaaS）は、[クラウドネイティブアプリ][cloud native apps]にとって重要なサーバーレスコンピュートプラットフォームです。 +しかし、プラットフォームの癖によって、これらのアプリケーションはKubernetesやVirtual Machines上で実行されるアプリケーションとは若干異なる監視ガイダンスや要件を持つことになります。 + +FaaSドキュメントの最初のベンダー範囲は、Microsoft Azure、Google Cloud Platform（GCP）、Amazon Web Services（AWS）です。 +AWSのファンクション（関数）はLambdaとしても知られています。 + +### コミュニティアセット {#community-assets} + +現在、OpenTelemetry コミュニティは、アプリケーションを自動計装することができるビルド済みの Lambda レイヤーと、アプリケーションを手動または自動で計装する際に使用できるスタンドアロンの Collector Lambda レイヤーを提供しています。 + +リリース状況は[OpenTelemetry-Lambdaリポジトリ](https://github.com/open-telemetry/opentelemetry-lambda)で追跡できます。 + +[cloud native apps]: https://glossary.cncf.io/cloud-native-apps/ diff --git a/content/ja/docs/platforms/faas/lambda-auto-instrument.md b/content/ja/docs/platforms/faas/lambda-auto-instrument.md new file mode 100644 index 000000000000..8e4586504966 --- /dev/null +++ b/content/ja/docs/platforms/faas/lambda-auto-instrument.md @@ -0,0 +1,114 @@ +--- +title: Lambda 自動計装 +weight: 11 +description: あなたのLambdaをOpenTelemetryで自動的に計装する +default_lang_commit: 9ba98f4fded66ec78bfafa189ab2d15d66df2309 +cSpell:ignore: Corretto +--- + +OpenTelemetryコミュニティは、以下の言語用のスタンドアロン計装Lambdaレイヤーを提供しています。 + +- Java +- JavaScript +- Python +- Ruby + +これらのレイヤーは、AWSポータルを使用してLambdaに追加し、アプリケーションを自動的に計装できます。 +これらのレイヤーにはコレクターは含まれておらず、外部コレクターインスタンスを構成してデータを送信しない限り、追加する必要があります。 + +### OTel Collector LambdaレイヤーのARNを追加する {#add-the-arn-of-the-otel-collector-lambda-layer} + +[Collector Lambdaレイヤーのガイダンス](../lambda-collector/)を参照して、アプリケーションにレイヤーを追加し、Collectorを設定してください。 +これを最初に追加することをおすすめします。 + +### 言語要件 {#language-requirements} + +{{< tabpane text=true >}} {{% tab Java %}} + +Lambdaレイヤーは、Java 8, 11, 17 (Corretto) Lambdaランタイムをサポートしています。 +サポートされているJavaのバージョンについては、[OpenTelemetry Java ドキュメント](/docs/languages/java/) を参照してください。 + +**注意:** Javaの自動計装エージェントがLambdaレイヤー内にあります - 自動計装エージェントはAWS Lambdaの起動時間に顕著な影響を与えるので、初期化中に最初のリクエストでタイムアウトを起こさずに本番のリクエストに対応するためには、一般的にプロビジョニングされた同時実行とウォームアップリクエストと共にこれを使用する必要があります。 + +デフォルトでは、レイヤーのOTel Javaエージェントは、アプリケーション内のすべてのコードを自動計装しようとします。 +これはLambdaのコールドスタートの起動時間に悪影響を及ぼす可能性があります。 + +アプリケーションで使用するライブラリ／フレームワークの自動計装のみを有効にすることをおすすめします。 + +特定の計装だけを有効にするには、以下の環境変数を使用します。 + +- `OTEL_INSTRUMENTATION_COMMON_DEFAULT_ENABLED`: falseに設定すると、レイヤーの自動計装を無効にし、各計装を個別に有効にする必要があります。 +- `OTEL_INSTRUMENTATION__ENABLED`: 特定のライブラリやフレームワークの自動計装を有効にするには true を設定します。``の部分を有効にしたい計装で置き換えます。利用可能な計装のリストについては、[特定のエージェントの計装を抑制する][1] を参照してください。 + + [1]: /docs/zero-code/java/agent/disable/#suppressing-specific-agent-instrumentation + +たとえば、LambdaとAWS SDKの自動計装だけを有効にするには、以下の環境変数を設定します。 + +```sh +OTEL_INSTRUMENTATION_COMMON_DEFAULT_ENABLED=false +OTEL_INSTRUMENTATION_AWS_LAMBDA_ENABLED=true +OTEL_INSTRUMENTATION_AWS_SDK_ENABLED=true +``` + +{{% /tab %}} {{% tab JavaScript %}} + +Lambdaレイヤーは、Node.js v14+のLambdaランタイムをサポートしています。 +サポートされるJavaScriptとNode.jsのバージョンの詳細については、[OpenTelemetry JavaScriptドキュメント](https://github.com/open-telemetry/opentelemetry-js)を参照してください。 + +{{% /tab %}} {{% tab Python %}} + +LambdaレイヤーはPython 3.8とPython 3.9のLambdaランタイムをサポートしています。 +サポートされているPythonのバージョンについては、[OpenTelemetry Pythonドキュメント](https://github.com/open-telemetry/opentelemetry-python/blob/main/README.md#supported-runtimes) と [PyPi](https://pypi.org/project/opentelemetry-api/) のパッケージを参照してください。 + +{{% /tab %}} {{% tab Ruby %}} + +Lambda レイヤーは、Ruby 3.2 と 3.3 の Lambda ランタイムをサポートしています。 +サポートされる OpenTelemetry Ruby SDK と API バージョンの詳細については、[OpenTelemetry Rubyドキュメント](https://github.com/open-telemetry/opentelemetry-ruby/blob/main/README.md#compatibility) と [RubyGem](https://rubygems.org/search?query=opentelemetry) のパッケージを参照してください。 + +{{% /tab %}} {{< /tabpane >}} + +### `AWS_LAMBDA_EXEC_WRAPPER` を設定する {#configure-aws_lambda_exec_wrapper} + +Node.js、Java、Rubyの場合は `AWS_LAMBDA_EXEC_WRAPPER=/opt/otel-handler` 、Pythonの場合は`AWS_LAMBDA_EXEC_WRAPPER=/opt/otel-instrument` を設定して、アプリケーションのエントリーポイントを変更します。 +これらのラッパースクリプトは、自動計装を適用したLambdaアプリケーションを起動します。 + +### 計装LambdaレイヤーのARNを追加する {#add-the-arn-of-instrumentation-lambda-layer} + +Lambda関数でOTelの自動計装を有効にするには、計装レイヤーとコレクターレイヤーを追加して設定し、トレースを有効にする必要があります。 + +1. AWSコンソールで、計装するLambda関数を開く。 +2. 「レイヤー」セクションで、「レイヤーの追加」を選択します。 +3. 「ARNを指定」でレイヤーのARNを貼り付け、「追加」を選択します。 + +あなたの言語の[最新の計装レイヤーリリース](https://github.com/open-telemetry/opentelemetry-lambda/releases)を見つけ、そのARNを使用します。 +``タグをあなたのラムダがあるリージョンに変更します。 + +注意: ラムダレイヤーはリージョンで分かれたリソースで、公開されているリージョンでのみ使用できます。Lambda関数と同じリージョンでレイヤーを使用するようにしてください。コミュニティは、利用可能なすべてのリージョンでレイヤーを公開しています。 + +### SDKのエクスポーターの設定 {#configure-your-sdk-exporters} + +gRPC/HTTPレシーバーを持つコレクターが組み込まれている場合、Lambdaレイヤーで使用されるデフォルトのエクスポーターは変更なしで動作します。 +環境変数を更新する必要はありません。 +ただし、プロトコルのサポートレベルやデフォルト値は言語によって異なります。 + +{{< tabpane text=true >}} {{% tab Java %}} + +`OTEL_EXPORTER_OTLP_PROTOCOL=grpc` は `grpc`、`http/protobuf` および `http/json`、`OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317` をサポートします。 + +{{% /tab %}} {{% tab JavaScript %}} + +環境変数 `OTEL_EXPORTER_OTLP_PROTOCOL` はサポートされていません。ハードコードされたエクスポーターはプロトコル `http/protobuf` を使用します。`OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318` + +{{% /tab %}} {{% tab Python %}} + +`OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf` は `http/protobuf` と `http/json` 、`OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318` をサポートします。 + +{{% /tab %}} {{% tab Ruby %}} + +`OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf` は `http/protobuf` `OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318` をサポートします。 + +{{% /tab %}} {{< /tabpane >}} + +### Lambdaを公開する {#publish-your-lambda} + +Lambdaの新しいバージョンを公開して、新しい変更と計装をデプロイします。 diff --git a/content/ja/docs/platforms/faas/lambda-collector.md b/content/ja/docs/platforms/faas/lambda-collector.md new file mode 100644 index 000000000000..d1787d00824c --- /dev/null +++ b/content/ja/docs/platforms/faas/lambda-collector.md @@ -0,0 +1,156 @@ +--- +title: Lambdaコレクター設定 +linkTitle: Lambdaコレクター設定 +weight: 11 +description: コレクターLambdaレイヤーをあなたのLambdaに追加して設定する +default_lang_commit: 9ba98f4fded66ec78bfafa189ab2d15d66df2309 +cSpell:ignore: ADOT awsxray configmap confmap +--- + +OpenTelemetry コミュニティは、ユーザーに最大限の柔軟性を与えるために、コレクターを計装レイヤーとは別のLambdaレイヤーで提供しています。 +これは、計装とコレクターをバンドルしている現在の AWS Distribution of OpenTelemetry (ADOT) の実装とは異なります。 + +### OTelコレクターLambdaレイヤーのARNを追加する {#add-the-arn-of-the-otel-collector-lambda-layer} + +アプリケーションの計装が完了したら、コレクターLambdaレイヤーを追加してデータを収集し、選択したバックエンドに送信します。 + +[最新のコレクターレイヤーリリース](https://github.com/open-telemetry/opentelemetry-lambda/releases)を見つけ、そのARNを使用します。 +``タグをラムダがいるリージョンに変更します。 + +注意: ラムダレイヤーはリージョンで分かれたリソースであり、公開されているリージョンでのみ使用できます。Lambda関数と同じリージョンでレイヤーを使用するようにしてください。コミュニティは、利用可能なすべてのリージョンでレイヤーを公開しています。 + +### OTelコレクターの設定 {#configure-the-otel-collector} + +OTelコレクターLambdaレイヤーの設定は、OpenTelemetry標準にしたがっています。 + +デフォルトでは、OTelコレクターLambdaレイヤーはconfig.yamlを使用します。 + +#### 希望するバックエンドの環境変数を設定する {#set-the-environment-variable-for-your-preferred-backend} + +Lambda環境変数の設定で、認証トークンを格納する新しい変数を作成します。 + +#### デフォルトエクスポーターを更新する {#update-the-default-exporters} + +もしまだ存在していなければ、`config.yaml` ファイルに好みのエクスポーターを追加します。 +前のステップでアクセストークンのために設定した環境変数を使用して、エクスポーターを設定します。 + +**エクスポーターに環境変数が設定されていない場合、デフォルトの設定は、デバッグエクスポーターを使用したデータ送信のみをサポートします** +以下はデフォルトの設定です。 + +```yaml +receivers: + otlp: + protocols: + grpc: + endpoint: '0.0.0.0:4317' + http: + endpoint: '0.0.0.0:4318' + +exporters: + # 注意: v0.86.0 より前のバージョンでは、`debug` のかわりに `logging` を使用すること + debug: + verbosity: detailed + +service: + pipelines: + traces: + receivers: [otlp] + exporters: [debug] + metrics: + receivers: [otlp] + exporters: [debug] + telemetry: + metrics: + address: localhost:8888 +``` + +### Lambdaを公開する {#publish-your-lambda} + +Lambdaの新しいバージョンをパブリッシュして、行った変更を有効にします。 + +### 高度な OTel コレクターの設定 {#advanced-otel-collector-configuration} + +カスタム構成でサポートされる利用可能なコンポーネントのリストは、こちらをご覧ください。 +デバッグを有効にするには、設定ファイルを使ってログレベルをデバッグに設定します。 +以下の例を参照してください。 + +#### 希望のConfmapプロバイダーを選択する {#choose-your-preferred-confmap-provider} + +OTel Lambdaレイヤーは `file`、`env`、`yaml`、`http`、`https`、`s3` といった種類の Confmap プロバイダーをサポートしています。 +異なる Confmap プロバイダーを使用して OTel コレクターの設定をカスタマイズするには、[Amazon Distribution of OpenTelemetry Confmap providers document](https://aws-otel.github.io/docs/components/confmap-providers#confmap-providers-supported-by-the-adot-collector) を参照してください。 + +#### カスタム設定ファイルの作成 {#create-a-custom-configuration-file} + +以下はルートディレクトリにある `collector.yaml` の設定ファイルのサンプルです。 + +```yaml +# ルート・ディレクトリの collector.yaml +# 環境変数 'OPENTELEMETRY_COLLECTOR_CONFIG_URI' を '/var/task/collector.yaml' に設定する + +receivers: + otlp: + protocols: + grpc: + endpoint: 'localhost:4317' + http: + endpoint: 'localhost:4318' + +exporters: + # 注意: v0.86.0 より前のバージョンでは `debug` のかわりに `logging` を使用すること + debug: + awsxray: + +service: + pipelines: + traces: + receivers: [otlp] + exporters: [awsxray] + metrics: + receivers: [otlp] + exporters: [debug] + telemetry: + metrics: + address: localhost:8888 +``` + +#### 環境変数を使ってカスタム設定ファイルをマップする {#map-your-custom-configuration-file-using-environment-variables} + +confmapプロバイダーを通してコレクターを設定したら、Lambda関数に環境変数 `OPENTELEMETRY_COLLECTOR_CONFIG_URI` を作成し、その値としてconfmapプロバイダーの設定のパスを設定します。 +たとえば、ファイルconfigmapプロバイダーを使用している場合は、その値を `/var/task///` に設定します。 +これにより、拡張モジュールにコレクターの設定がどこにあるかを伝えます。 + +##### CLIを使用したカスタムコレクター設定 {#custom-collector-configuration-using-the-cli} + +Lambdaコンソール、またはAWS CLIから設定できます。 + +```bash +aws lambda update-function-configuration --function-name Function --environment Variables={OPENTELEMETRY_COLLECTOR_CONFIG_URI=/var/task/collector.yaml} +``` + +##### CloudFormationから設定用の環境変数を設定する {#set-configuration-environment-variables-from-cloudformation} + +環境変数は**CloudFormation**テンプレートでも設定できます。 + +```yaml +Function: + Type: AWS::Serverless::Function + Properties: + ... + Environment: + Variables: + OPENTELEMETRY_COLLECTOR_CONFIG_URI: /var/task/collector.yaml +``` + +##### S3オブジェクトから設定を読み込む {#load-configuration-from-an-s3-object} + +S3から設定を読み込むには、関数にアタッチされたIAMロールに、関連するバケットへの読み取りアクセスが含まれている必要があります。 + +```yaml +Function: + Type: AWS::Serverless::Function + Properties: + ... + Environment: + Variables: + OPENTELEMETRY_COLLECTOR_CONFIG_URI: s3://.s3..amazonaws.com/collector_config.yaml +``` diff --git a/content/ja/docs/platforms/faas/lambda-manual-instrument.md b/content/ja/docs/platforms/faas/lambda-manual-instrument.md new file mode 100644 index 000000000000..8c9612145db3 --- /dev/null +++ b/content/ja/docs/platforms/faas/lambda-manual-instrument.md @@ -0,0 +1,23 @@ +--- +title: Lambdaの手動計装 +weight: 11 +description: OpenTelemetryであなたのLambdaを手動計装する +default_lang_commit: 9ba98f4fded66ec78bfafa189ab2d15d66df2309 +--- + +Lambdaの自動計装ドキュメントでカバーされていない言語については、コミュニティはスタンドアロンの計装レイヤーを持っていません。 + +ユーザーは、選択した言語の汎用計装ガイダンスにしたがい、コレクターLambdaレイヤーを追加してデータを送信する必要があります。 + +### OTelコレクターLambdaレイヤーのARNを追加する {#add-the-arn-of-the-otel-collector-lambda-layer} + +[コレクターLambdaレイヤーのガイダンス](../lambda-collector/)を参照して、アプリケーションにレイヤーを追加し、コレクターを設定してください。 +これを最初に追加することをおすすめします。 + +### LambdaをOTelで計装する {#instrument-the-lambda-with-otel} + +アプリケーションを手動で計装する方法については、[各言語向け計装ガイド](/docs/languages/) を確認してください。 + +### Lambdaを公開する {#publish-your-lambda} + +Lambdaの新しいバージョンを公開して、新しい変更と計装をデプロイします。 From e21c2d9ab3cb1d3d8a1686014665514bb21771c5 Mon Sep 17 00:00:00 2001 From: Patrice Chalin Date: Fri, 14 Mar 2025 12:11:50 -0400 Subject: [PATCH 17/22] [CI] cSpell config tweak (#6547) --- .cspell.yml | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/.cspell.yml b/.cspell.yml index ccbc97b343cd..a8049a4449a8 100644 --- a/.cspell.yml +++ b/.cspell.yml @@ -10,11 +10,11 @@ import: caseSensitive: true ignorePaths: - '*.svg' - - content/ja - - content/zh + - content/{ja,zh} - data/community/members.yaml + - data/ecosystem/vendors.yaml + - public/_redirects - static/refcache.json - - vendors.yaml patterns: - name: CodeBlock pattern: | @@ -22,7 +22,7 @@ patterns: ^(\s*[~`]{3,}) # code-block start .* # all languages and options, e.g. shell {hl_lines=[12]} [\s\S]*? # content - \1 # code-block end + \1 # code-block end - cSpell:disable-next-line /igmx languageSettings: - languageId: markdown @@ -58,6 +58,6 @@ dictionaries: words: # Valid words across all locales - Docsy - htmltest - # Hugo - jsonify + - opentelemetrybot - warnf From c246d000413d3b2fb4b74dd16f9b87780d1a9e0f Mon Sep 17 00:00:00 2001 From: Patrice Chalin Date: Fri, 14 Mar 2025 12:12:44 -0400 Subject: [PATCH 18/22] Add video link to what-is-opentelemetry page (#6550) --- content/en/docs/what-is-opentelemetry.md | 15 +++++++++++++++ static/refcache.json | 8 ++++++++ 2 files changed, 23 insertions(+) diff --git a/content/en/docs/what-is-opentelemetry.md b/content/en/docs/what-is-opentelemetry.md index 985e0203cc77..12d3c14cae06 100644 --- a/content/en/docs/what-is-opentelemetry.md +++ b/content/en/docs/what-is-opentelemetry.md @@ -3,6 +3,7 @@ title: What is OpenTelemetry? description: A brief explanation of what OpenTelemetry is and isn't. aliases: [/about, /docs/concepts/what-is-opentelemetry, /otel] weight: 150 +cSpell:ignore: youtube --- OpenTelemetry is: @@ -27,6 +28,13 @@ infrastructure, and runtime environments used. The backend (storage) and the frontend (visualization) of telemetry data are intentionally left to other tools. +
+{{< youtube iEEIabOha8U >}} +
+ +For more videos in this series and additional resources, see +[What next?](#what-next) + ## What is observability? [Observability] is the ability to understand the internal state of a system by @@ -124,6 +132,9 @@ migrate to OpenTelemetry in the [Migration guide](../migration/). - [Getting started](../getting-started/) — jump right in! - Learn about [OpenTelemetry concepts](../concepts/). +- [Watch videos][] from the [OTel for beginners][] or other [playlists]. +- Sign up for [training](/training), including the **free course** + [Getting started with OpenTelemetry](/training/#courses). [Cloud Native Computing Foundation]: https://www.cncf.io [instr]: ../concepts/instrumentation @@ -131,6 +142,10 @@ migrate to OpenTelemetry in the [Migration guide](../migration/). [logs]: ../concepts/signals/logs/ [metrics]: ../concepts/signals/metrics/ [observability]: ../concepts/observability-primer/#what-is-observability +[OTel for beginners]: + https://www.youtube.com/playlist?list=PLVYDBkQ1TdyyWjeWJSjXYUaJFVhplRtvN +[playlists]: https://www.youtube.com/@otel-official/playlists [Prometheus]: https://prometheus.io/ [telemetry data]: ../concepts/signals/ [traces]: ../concepts/signals/traces/ +[Watch videos]: https://www.youtube.com/@otel-official diff --git a/static/refcache.json b/static/refcache.json index 3c68c771dcfb..3edfa6520737 100644 --- a/static/refcache.json +++ b/static/refcache.json @@ -19115,6 +19115,10 @@ "StatusCode": 200, "LastSeen": "2025-02-01T06:59:07.840496-05:00" }, + "https://www.youtube.com/@otel-official/playlists": { + "StatusCode": 200, + "LastSeen": "2025-03-14T11:42:49.100481-04:00" + }, "https://www.youtube.com/embed/TIMgKXCeiyQ": { "StatusCode": 200, "LastSeen": "2024-12-17T15:37:39.559999-05:00" @@ -19123,6 +19127,10 @@ "StatusCode": 200, "LastSeen": "2025-02-01T07:10:38.092527-05:00" }, + "https://www.youtube.com/embed/iEEIabOha8U": { + "StatusCode": 200, + "LastSeen": "2025-03-14T11:42:48.773761-04:00" + }, "https://www.youtube.com/watch": { "StatusCode": 200, "LastSeen": "2025-01-06T11:32:20.787744-05:00" From e7d04ea101085c31edec9ce4ff5b87a8a1569a73 Mon Sep 17 00:00:00 2001 From: Cijo Thomas Date: Fri, 14 Mar 2025 09:22:37 -0700 Subject: [PATCH 19/22] Results from /fix:all --- content/ja/docs/demo/feature-flags.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/content/ja/docs/demo/feature-flags.md b/content/ja/docs/demo/feature-flags.md index c1c19af4a580..27fc2a10871e 100644 --- a/content/ja/docs/demo/feature-flags.md +++ b/content/ja/docs/demo/feature-flags.md @@ -4,7 +4,8 @@ aliases: - feature_flags - services/feature-flag - services/featureflagservice -default_lang_commit: ea3b23ce16243364ae03d368d49af870454f686f +default_lang_commit: 24146bd1368e4c6082c7d6077efd29dba0d51055 +drifted_from_default: true cSpell:ignore: OLJCESPC7Z --- From 660e2a413d604bfef340e8d5b750b50d24b57485 Mon Sep 17 00:00:00 2001 From: Msksgm <49427230+Msksgm@users.noreply.github.com> Date: Thu, 13 Mar 2025 01:08:35 +0900 Subject: [PATCH 20/22] [ja] fix drift of content/ja/docs/demo/feature-flags (#6527) --- content/ja/docs/demo/feature-flags.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/content/ja/docs/demo/feature-flags.md b/content/ja/docs/demo/feature-flags.md index 27fc2a10871e..c1c19af4a580 100644 --- a/content/ja/docs/demo/feature-flags.md +++ b/content/ja/docs/demo/feature-flags.md @@ -4,8 +4,7 @@ aliases: - feature_flags - services/feature-flag - services/featureflagservice -default_lang_commit: 24146bd1368e4c6082c7d6077efd29dba0d51055 -drifted_from_default: true +default_lang_commit: ea3b23ce16243364ae03d368d49af870454f686f cSpell:ignore: OLJCESPC7Z --- From 2e119668496df4539129446391f8816a194273ae Mon Sep 17 00:00:00 2001 From: Cijo Thomas Date: Fri, 14 Mar 2025 09:24:20 -0700 Subject: [PATCH 21/22] Results from /fix:all --- content/ja/docs/demo/feature-flags.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/content/ja/docs/demo/feature-flags.md b/content/ja/docs/demo/feature-flags.md index c1c19af4a580..1a4832f81ae9 100644 --- a/content/ja/docs/demo/feature-flags.md +++ b/content/ja/docs/demo/feature-flags.md @@ -4,7 +4,12 @@ aliases: - feature_flags - services/feature-flag - services/featureflagservice +<<<<<<< HEAD default_lang_commit: ea3b23ce16243364ae03d368d49af870454f686f +======= +default_lang_commit: 24146bd1368e4c6082c7d6077efd29dba0d51055 +drifted_from_default: true +>>>>>>> 7ba99afb (Results from /fix:all) cSpell:ignore: OLJCESPC7Z --- From 0dcaefcf4394770c45d97f5006ce43dfd31c3864 Mon Sep 17 00:00:00 2001 From: Msksgm <49427230+Msksgm@users.noreply.github.com> Date: Thu, 13 Mar 2025 01:08:35 +0900 Subject: [PATCH 22/22] [ja] fix drift of content/ja/docs/demo/feature-flags (#6527) --- content/ja/docs/demo/feature-flags.md | 5 ----- 1 file changed, 5 deletions(-) diff --git a/content/ja/docs/demo/feature-flags.md b/content/ja/docs/demo/feature-flags.md index 1a4832f81ae9..c1c19af4a580 100644 --- a/content/ja/docs/demo/feature-flags.md +++ b/content/ja/docs/demo/feature-flags.md @@ -4,12 +4,7 @@ aliases: - feature_flags - services/feature-flag - services/featureflagservice -<<<<<<< HEAD default_lang_commit: ea3b23ce16243364ae03d368d49af870454f686f -======= -default_lang_commit: 24146bd1368e4c6082c7d6077efd29dba0d51055 -drifted_from_default: true ->>>>>>> 7ba99afb (Results from /fix:all) cSpell:ignore: OLJCESPC7Z ---