Skip to content

[ja] docs(i18n): Translate /content/en/docs/concepts/signals/profiles.md#9474

Open
aki0000 wants to merge 2 commits intoopen-telemetry:mainfrom
aki0000:translate-ja-track-collector-profiles
Open

[ja] docs(i18n): Translate /content/en/docs/concepts/signals/profiles.md#9474
aki0000 wants to merge 2 commits intoopen-telemetry:mainfrom
aki0000:translate-ja-track-collector-profiles

Conversation

@aki0000
Copy link
Copy Markdown
Contributor

@aki0000 aki0000 commented Mar 23, 2026

  • I have read and followed the Contributing docs, especially the "First-time contributing?" section.
  • This PR has content that I did not fully write myself.
  • I have the experience and knowledge necessary to understand, review, and validate all content in this PR.1

Could you please review this PR for the ja translation ?

English Page

https://opentelemetry.io/docs/concepts/signals/profiles/

Preview Page

https://deploy-preview-9474--opentelemetry.netlify.app/ja/docs/concepts/signals/profiles/

Footnotes

  1. Yes, I can answer maintainer questions about the content of this PR, without using AI.

@aki0000 aki0000 requested a review from a team as a code owner March 23, 2026 08:48
@otelbot-docs otelbot-docs bot added the missing:docs-approval Co-owning SIG has provided approval, PR needs approval from docs maintainer label Mar 23, 2026
@otelbot-docs otelbot-docs bot requested review from a team March 23, 2026 08:48
@otelbot-docs otelbot-docs bot added the missing:sig-approval Co-owning SIG didn't provide an approval label Mar 23, 2026
@aki0000 aki0000 force-pushed the translate-ja-track-collector-profiles branch from 1cd97c4 to 53f1724 Compare March 23, 2026 08:56
@aki0000 aki0000 force-pushed the translate-ja-track-collector-profiles branch from 53f1724 to f42e23a Compare March 23, 2026 09:00
title: プロファイル
weight: 5
description: コードレベルにおけるリソース使用の記録
default_lang_commit: 274bf95abd0cbad3ad9f95b4426f282466cdaade
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
default_lang_commit: 274bf95abd0cbad3ad9f95b4426f282466cdaade
default_lang_commit: 065e35458f11219cc77c7fb5ead7507d426694f3

ちょうどこのPR起票した直後に最新のコミットが更新されていましたので、取り込んでしまいたいと思います 🙏
065e354

Comment on lines +8 to +13
**ステータス**: [開発中](/docs/specs/otel/document-status/)

> [!NOTE]
>
> プロファイルシグナルはまだ実験的であり、活発に開発されています。
> 将来のバージョンでは破壊的変更が導入される可能性があります。
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
**ステータス**: [開発中](/docs/specs/otel/document-status/)
> [!NOTE]
>
> プロファイルシグナルはまだ実験的であり、活発に開発されています。
> 将来のバージョンでは破壊的変更が導入される可能性があります。
**ステータス**: [アルファ](/docs/specs/otel/document-status/)

https://github.com/open-telemetry/opentelemetry.io/pull/9474/changes#r2975061606 での変更はこれのみでした

> プロファイルシグナルはまだ実験的であり、活発に開発されています。
> 将来のバージョンでは破壊的変更が導入される可能性があります。

**プロファイル**は、実行中にどこでアプリケーションがリソースを消費するかを示すサンプルと関連メタデータの**集まり**です。サンプルは、あるプログラムのコンテキスト(典型的にはスタックトレース)で検出した値を記録します。オプションで、より上位のリクエストに対応するトレース ID のような補助情報が付加される場合もあります。
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
**プロファイル**は、実行中にどこでアプリケーションがリソースを消費するかを示すサンプルと関連メタデータの**集まり**です。サンプルは、あるプログラムのコンテキスト(典型的にはスタックトレース)で検出した値を記録します。オプションで、より上位のリクエストに対応するトレース ID のような補助情報が付加される場合もあります。
**プロファイル**は、実行中にどこでアプリケーションがリソースを消費するかを示すサンプルと関連メタデータの**集まり**です。
サンプルは、あるプログラムのコンテキスト(典型的にはスタックトレース)で検出した値を記録します。
オプションで、より上位のリクエストに対応するトレース ID のような補助情報が付加される場合もあります。

改行のみ


## プロファイルの概要 {#profiles-overview}

プロファイルは、ログ、メトリクス、そしてトレースに並ぶ、可観測性における第4の本質的シグナルとして台頭しつつあります。システムおよびアプリケーションの挙動についてきわめて詳しい洞察を提供し、他のシグナルでは見落とされがちなパフォーマンスのボトルネックを明らかにすることがよくあります。
Copy link
Copy Markdown
Contributor

@kohbis kohbis Mar 23, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
プロファイルは、ログ、メトリクス、そしてトレースに並ぶ、可観測性における第4の本質的シグナルとして台頭しつつあります。システムおよびアプリケーションの挙動についてきわめて詳しい洞察を提供し、他のシグナルでは見落とされがちなパフォーマンスのボトルネックを明らかにすることがよくあります。
プロファイルは、ログ、メトリクス、そしてトレースに並ぶ、可観測性における第4の本質的シグナルとして台頭しつつあります。
システムおよびアプリケーションの挙動について他にはない洞察を提供し、他のシグナルでは見落とされがちなパフォーマンスのボトルネックを明らかにすることがよくあります。

改行および一部訳の修正

They offer unparalleled insights ~ について unparalleled には「他と比べて優れている」という意味があるのでそれがわかるような表現にするとよさそうです
👆のsuggestionでは「他にはない」としていますが、もしよりよい翻訳があればご提案いただければと思います 🙇

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ここですが、わかりやすいように「独自の」でどうでしょうか?
unparalleled: bigger, better, or worse than anything else[1]ともあるので、他と比較して優れている/劣っているの形容詞として「独自の」が合いそうだと思いました。

[1] https://www.ldoceonline.com/jp/dictionary/unparalleled

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@aki0000 ありがとうございます!良いと思います!


プロファイルを収集するために複数のアプローチがあり、それらすべてをサポートするために OpenTelemetry のプロファイルを設計しました。

- **サンプリングベースのプロファイリング**: プロファイラは、たとえばタイマーベースの割り込みを用いてプログラムを周期的に中断し、現在のスタックトレースを記録します。これは CPU プロファイリングで最も一般的なアプローチです。Linux 上では、プロファイラは一切ユーザ空間アプリケーションを変更する必要がなく、カーネルからスタックトレースを取得するために eBPF を使うことができます。このアプローチは、システム全体プロファイリング(ランタイムサポートのないコンパイル言語で生成されたコードを含む)のゼロ計装を可能にし、継続的でオーバーヘッドの低い本番利用向けに設計されています。
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- **サンプリングベースのプロファイリング**: プロファイラは、たとえばタイマーベースの割り込みを用いてプログラムを周期的に中断し、現在のスタックトレースを記録します。これは CPU プロファイリングで最も一般的なアプローチです。Linux 上では、プロファイラは一切ユーザ空間アプリケーションを変更する必要がなく、カーネルからスタックトレースを取得するために eBPF を使うことができます。このアプローチは、システム全体プロファイリング(ランタイムサポートのないコンパイル言語で生成されたコードを含む)のゼロ計装を可能にし、継続的でオーバーヘッドの低い本番利用向けに設計されています。
- **サンプリングベースのプロファイリング**: プロファイラは、たとえばタイマーベースの割り込みを用いてプログラムを周期的に中断し、現在のスタックトレースを記録します。
これは CPU プロファイリングで最も一般的なアプローチです。
Linux 上では、プロファイラは一切ユーザ空間アプリケーションを変更する必要がなく、カーネルからスタックトレースを取得するために eBPF を使うことができます。
このアプローチは、システム全体プロファイリング(ランタイムサポートのないコンパイル言語で生成されたコードを含む)のゼロ計装を可能にし、継続的でオーバーヘッドの低い本番利用向けに設計されています。

改行のみ

Copy link
Copy Markdown
Contributor

@kohbis kohbis left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@aki0000 継続的なコントリビューションありがとうございます!
少しだけコメントしております 🙇

@otelbot-docs otelbot-docs bot requested a review from a team March 24, 2026 08:47
@aki0000
Copy link
Copy Markdown
Contributor Author

aki0000 commented Mar 26, 2026

@kohbis
レビューありがとうございました。アドバイス頂いた箇所、修正済になります。

- **サンプリングベースのプロファイリング**: プロファイラは、たとえばタイマーベースの割り込みを用いてプログラムを周期的に中断し、現在のスタックトレースを記録します。
これは CPU プロファイリングで最も一般的なアプローチです。
Linux 上では、プロファイラは一切ユーザ空間アプリケーションを変更する必要がなく、カーネルからスタックトレースを取得するために eBPF を使うことができます。
このアプローチは、システム全体プロファイリング(ランタイムサポートのないコンパイル言語で生成されたコードを含む)のゼロ計装を可能にし、継続的でオーバーヘッドの低い本番利用向けに設計されています。
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
このアプローチは、システム全体プロファイリング(ランタイムサポートのないコンパイル言語で生成されたコードを含む)のゼロ計装を可能にし、継続的でオーバーヘッドの低い本番利用向けに設計されています。
このアプローチは、ゼロ計装によるシステム全体プロファイリング(ランタイムサポートのないコンパイル言語で生成されたコードを含む)を可能にし、継続的でオーバーヘッドの低い本番利用向けに設計されています。

This approach enables zero-instrumentation, whole-system profiling となっており、文脈としても「プロファイリングによるゼロ計装」ではなく「ゼロ計装によるプロファイリング」が可能という説明なので、それがわかるように並び替えるとよさそうです

Copy link
Copy Markdown
Contributor

@kohbis kohbis left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@aki0000 すみません、1点追加でコメントしております 🙇

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

lang:ja missing:docs-approval Co-owning SIG has provided approval, PR needs approval from docs maintainer missing:sig-approval Co-owning SIG didn't provide an approval

Projects

Status: No status

Development

Successfully merging this pull request may close these issues.

2 participants