[ja] docs(i18n): Translate /content/en/docs/collector/internal-telemetry.md by aki0000 · Pull Request #9387 · open-telemetry/opentelemetry.io

aki0000 · 2026-03-12T04:27:01Z

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 used AI and I have read and followed the Generative AI Contribution Policy.
I have the experience and knowledge necessary to understand, review, and validate all content in this PR.¹

Could you review internal-telemetry.md of Japanese version ? This page contains a large amount of text...

English Page

https://opentelemetry.io/docs/collector/internal-telemetry/

Preview Page

https://deploy-preview-9387--opentelemetry.netlify.app/ja/docs/collector/internal-telemetry/

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

…try.md

katzchang

@aki0000 翻訳お疲れさまです！大量のテキストを丁寧に訳されていると思います。いくつかコメントしたので、対応をお願いいたします。

追加で一点あります。default_lang_commit（e4d556eb3c）以降に英語原文が更新されており、以下の内容が追加されています:

Metric views セクションに NOTE（Prometheus エクスポーター手動設定時の otelcol_process_uptime の挙動について）
Unit suffixes セクション（_seconds 等のユニット接尾辞の説明）
without_type_suffix の値が false → true に修正

マージ前に default_lang_commit の更新と追加分の翻訳もしていただくのがスムーズかもしれません。

katzchang · 2026-03-12T08:30:08Z

content/ja/docs/collector/internal-telemetry.md

+
+`http*` および `rpc*` メトリクスは計装ライブラリに由来します。
+それらの元の名前はドット（`.`）を使っていました。
+コレクター v0.120.0 より前では、Prometheus で公開される内部メトリクスは、Prometheus の命名規則に合わせるためにドット（`.`）がアンダースコア（`_`）へ変更していました。、その結果、`rpc_server_duration`のようなメトリクス名になっていました。


句読点の誤り（。、）と助詞の修正が必要です。

「が」→「を」（ドットが変更したのではなく、ドットを変更した）

「へ変更していました。、その結果」→「に変更していました。その結果」

Suggested change

コレクター v0.120.0 より前では、Prometheus で公開される内部メトリクスは、Prometheus の命名規則に合わせるためにドット（`.`）がアンダースコア（`_`）へ変更していました。、その結果、`rpc_server_duration`のようなメトリクス名になっていました。

コレクター v0.120.0 より前では、Prometheus で公開される内部メトリクスは、Prometheus の命名規則に合わせるためにドット（`.`）をアンダースコア（`_`）に変更していました。その結果、`rpc_server_duration`のようなメトリクス名になっていました。

katzchang · 2026-03-12T08:30:08Z

content/ja/docs/collector/internal-telemetry.md

+
+#### 非推奨 {#deprecated}
+
+非推奨メトリクスは削除予定ですが、まだ使用可能になります。


「まだ使用可能になります」は「将来そうなる」というニュアンスになります。原文 "are still available for use" は現在の状態を述べているので、「使用可能です」が適切です。

Suggested change

非推奨メトリクスは削除予定ですが、まだ使用可能になります。

非推奨メトリクスは削除予定ですが、まだ使用可能です。

katzchang · 2026-03-12T08:30:08Z

content/ja/docs/collector/internal-telemetry.md

+#### ベータ {#beta}
+
+ベータのメトリクスはリリース間でまだ変更される可能性がありますが、コンポーネントのオーナーは破壊的変更を最小化するよう努める必要があります。
+この段階は、より広い利用を促進したり、`stable` の前の最終ステップです。


「たり」は通常ペアで使うか「たりする」で締めます。ここでは単独で使われているため不自然です。

Suggested change

この段階は、より広い利用を促進したり、`stable` の前の最終ステップです。

この段階は、より広い利用を促進し、`stable` の前の最終ステップです。

katzchang · 2026-03-12T08:30:08Z

content/ja/docs/collector/internal-telemetry.md

+
+## コレクターで内部テレメトリーを有効化する {#activate-internal-telemetry-in-the-collector}
+
+デフォルトでは、 コレクターは2つの方法で自身のテレメトリーを公開します。


「、」と「コレクター」の間に余分なスペースがあります。

Suggested change

デフォルトでは、コレクターは2つの方法で自身のテレメトリーを公開します。

デフォルトでは、コレクターは2つの方法で自身のテレメトリーを公開します。

katzchang · 2026-03-12T08:30:08Z

content/ja/docs/collector/internal-telemetry.md

+
+#### サービスのアドレス {#service-address}
+
+> [!NOTE] 内部テレメトリー構造の変更点


原文は "Internal telemetry configuration changes" です。「構造」ではなく「設定」が正確です。

Suggested change

> [!NOTE] 内部テレメトリー構造の変更点

> [!NOTE] 内部テレメトリー設定の変更点

katzchang · 2026-03-12T08:30:09Z

content/ja/docs/collector/internal-telemetry.md

+```
+
+結果となる集計、属性、およびカーディナリティ制限を更新するために `views` を使用することもできます。
+オプションの完全な一覧については、OpenTelemetry 構成スキーマの[レポジトリ](https://github.com/open-telemetry/opentelemetry-configuration/blob/main/snippets/View_kitchen_sink.yaml)にある例を参照してください。


nit: 「レポジトリ」よりも「リポジトリ」がより一般的な表記です。

Suggested change

オプションの完全な一覧については、OpenTelemetry 構成スキーマの[レポジトリ](https://github.com/open-telemetry/opentelemetry-configuration/blob/main/snippets/View_kitchen_sink.yaml)にある例を参照してください。

オプションの完全な一覧については、OpenTelemetry 構成スキーマの[リポジトリ](https://github.com/open-telemetry/opentelemetry-configuration/blob/main/snippets/View_kitchen_sink.yaml)にある例を参照してください。

katzchang · 2026-03-12T08:30:09Z

content/ja/docs/collector/internal-telemetry.md

+>       address: 0.0.0.0:8888
+> ```
+
+#### メトリクスの冗長度 {#metric-verbosity}


「冗長度」は主要な技術文書での使用例が見当たらず、IT分野では「冗長」が redundancy（冗長化・冗長構成）の意味と混同されやすいです。Red Hat OpenShift 公式日本語ドキュメント等では「詳細度」が使われています。

同様の箇所: 112行目、119行目、290行目

Suggested change

#### メトリクスの冗長度 {#metric-verbosity}

#### メトリクスの詳細度 {#metric-verbosity}

katzchang · 2026-03-12T08:30:09Z

content/ja/docs/collector/internal-telemetry.md

+#### メトリクスビュー {#metric-views}
+
+[`views`](/docs/specs/otel/metrics/sdk/#view) を使用することで、コレクターからどのようにメトリクスが出力されるかをさらに設定できます。
+たとえば、以下の設定は、新しい名前 `process_uptime` と説明を出力するために `otelcol_process_uptime` と名付けられたメトリクスを更新します。


原文: "the following configuration updates the metric named otelcol_process_uptime to emit a new name process_uptime and description"

現在の訳は主語→目的語の距離が遠く、「出力するために...更新します」の構造が不自然です。

Suggested change

たとえば、以下の設定は、新しい名前 `process_uptime` と説明を出力するために `otelcol_process_uptime` と名付けられたメトリクスを更新します。

たとえば、以下の設定は、`otelcol_process_uptime` という名前のメトリクスを、新しい名前 `process_uptime` と説明で出力するように更新します。

katzchang · 2026-03-12T08:30:09Z

content/ja/docs/collector/internal-telemetry.md

+> `http*` と `rpc*` のメトリクスは、コレクター SIG の管理下にないため、以下の成熟度レベルの対象外になります。
+> `otelcol_processor_batch_` メトリクスは `batchprocessor` 固有です。


英語原文ではこの2つの段落の間に空の > 行があります。

Suggested change

> `http*` と `rpc*` のメトリクスは、コレクター SIG の管理下にないため、以下の成熟度レベルの対象外になります。

> `otelcol_processor_batch_` メトリクスは `batchprocessor` 固有です。

> `http*` と `rpc*` のメトリクスは、コレクター SIG の管理下にないため、以下の成熟度レベルの対象外になります。

>

> `otelcol_processor_batch_` メトリクスは `batchprocessor` 固有です。

katzchang · 2026-03-12T08:30:09Z

content/ja/docs/collector/internal-telemetry.md

+- スロットリングによるデータドロップが停止する。
+- 無効なデータによるデータドロップが開始される。無効なデータのサンプルが含まれる。
+- 無効なデータによるデータドロップが停止する。
+- クラッシュが検出され、クリーン停止と区別される。利用可能であればクラッシュデータが含まれる。


原文: "A crash is detected, differentiated from a clean stop."

現在の「クラッシュが検出され、クリーン停止と区別される」は、2つの独立した事象が列挙されているように読めます。原文の意図は「クリーン停止とは区別される形でクラッシュが検出される」です。

Suggested change

- クラッシュが検出され、クリーン停止と区別される。利用可能であればクラッシュデータが含まれる。

- クリーン停止とは区別される形でクラッシュが検出される。利用可能であればクラッシュデータが含まれる。

aki0000 · 2026-03-12T22:44:24Z

@katzchang
レビューありがとうございました!!
アドバイス頂いた箇所と548ae50123bba6fd70cb0b080c68294b8239769aの内容も反映していますので、ご確認お願いします。

katzchang

@aki0000 前回指摘の修正漏れ+ちょっとした修正をお願いします。追加部分は問題なさそうです。

katzchang · 2026-03-13T00:29:07Z

content/ja/docs/collector/internal-telemetry.md

+
+#### 受信失敗 {#receive-failures}
+
+`otelcol_receiver_refused_log_records`、`otelcol_receiver_refused_spans`、と `otelcol_receiver_refused_metric_points` の発生率が継続している場合、クライアントに返されたエラーが多すぎることを示します。


前回指摘の「、と」→「、および」がこちらの箇所では未修正です。同様に548行目、554行目、555行目も該当します。

Suggested change

`otelcol_receiver_refused_log_records`、`otelcol_receiver_refused_spans`、と `otelcol_receiver_refused_metric_points` の発生率が継続している場合、クライアントに返されたエラーが多すぎることを示します。

`otelcol_receiver_refused_log_records`、`otelcol_receiver_refused_spans`、および `otelcol_receiver_refused_metric_points` の発生率が継続している場合、クライアントに返されたエラーが多すぎることを示します。

katzchang · 2026-03-13T00:29:07Z

content/ja/docs/collector/internal-telemetry.md

+`otelcol_receiver_refused_log_records`、`otelcol_receiver_refused_spans`、と `otelcol_receiver_refused_metric_points` の発生率が継続している場合、クライアントに返されたエラーが多すぎることを示します。
+デプロイメントやクライアントの耐障害性によっては、これはクライアントのデータ損失を示す可能性があります。
+
+`otelcol_exporter_send_failed_log_records`、`otelcol_exporter_send_failed_spans`、と `otelcol_exporter_send_failed_metric_points` の発生率が継続している場合、コレクターが期待どおりにデータをエクスポートできていないことを示します。


Suggested change

`otelcol_exporter_send_failed_log_records`、`otelcol_exporter_send_failed_spans`、と `otelcol_exporter_send_failed_metric_points` の発生率が継続している場合、コレクターが期待どおりにデータをエクスポートできていないことを示します。

`otelcol_exporter_send_failed_log_records`、`otelcol_exporter_send_failed_spans`、および `otelcol_exporter_send_failed_metric_points` の発生率が継続している場合、コレクターが期待どおりにデータをエクスポートできていないことを示します。

katzchang · 2026-03-13T00:29:07Z

content/ja/docs/collector/internal-telemetry.md

+
+#### データフロー {#data-flow}
+
+`otelcol_receiver_accepted_log_records`、`otelcol_receiver_accepted_spans`、と `otelcol_receiver_accepted_metric_points` メトリクスでデータ流入を監視できます。


Suggested change

`otelcol_receiver_accepted_log_records`、`otelcol_receiver_accepted_spans`、と `otelcol_receiver_accepted_metric_points` メトリクスでデータ流入を監視できます。

`otelcol_receiver_accepted_log_records`、`otelcol_receiver_accepted_spans`、および `otelcol_receiver_accepted_metric_points` メトリクスでデータ流入を監視できます。

katzchang · 2026-03-13T00:29:07Z

content/ja/docs/collector/internal-telemetry.md

+#### データフロー {#data-flow}
+
+`otelcol_receiver_accepted_log_records`、`otelcol_receiver_accepted_spans`、と `otelcol_receiver_accepted_metric_points` メトリクスでデータ流入を監視できます。
+そして、 `otelcol_exporter_sent_log_records`、`otelcol_exporter_sent_spans`、と `otelcol_exporter_sent_metric_points` メトリクスでデータ流出を監視できます。


Suggested change

そして、 `otelcol_exporter_sent_log_records`、`otelcol_exporter_sent_spans`、と `otelcol_exporter_sent_metric_points` メトリクスでデータ流出を監視できます。

そして、 `otelcol_exporter_sent_log_records`、`otelcol_exporter_sent_spans`、および `otelcol_exporter_sent_metric_points` メトリクスでデータ流出を監視できます。

katzchang · 2026-03-13T03:07:35Z

content/ja/docs/collector/internal-telemetry.md

+たとえば、`otelcol_process_uptime`（単位: 秒）は `otelcol_process_uptime_seconds_total` としてエクスポートされることがあります。
+つまり、`_seconds` の単位接尾辞が先に追加され、その後に `_total` のカウンタを示す接尾辞が追加されます。
+
+コレクターによって設定されるデフォルトの Prometheus エクスポーター（`readers` が指定されていない場合）は、すでに後方互換性のために `without_type_suffix` と `without_units`を `true` に設定しています。


nit: インラインコード without_units と「を」の間にスペースがありません。

aki0000 · 2026-03-13T06:31:36Z

@katzchang 指摘して頂いた箇所、気づかずすみませんでした。修正したので、再度ご確認お願いいたします。

katzchang

@aki0000 良さそうです。お疲れ様でした！

[ja] docs(i18n): Translate /content/en/docs/collector/internal-teleme…

d2ba085

…try.md

aki0000 requested a review from a team as a code owner March 12, 2026 04:27

github-project-automation bot added this to SIG Comms: PRs & Issues Mar 12, 2026

github-actions bot added the lang:ja label Mar 12, 2026

github-project-automation bot added this to SIG Comms: Docs Translation Mar 12, 2026

github-project-automation bot moved this to Opened in SIG Comms: Docs Translation Mar 12, 2026

otelbot-docs bot added 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 labels Mar 12, 2026

fixed based on linter check

743d3b5

otelbot-docs bot requested review from a team March 12, 2026 04:41

aki0000 added 2 commits March 12, 2026 13:54

fixed based on remaning format and spell checks

5050646

retry ci

d8f8b87

katzchang suggested changes Mar 12, 2026

View reviewed changes

aki0000 added 3 commits March 12, 2026 20:52

fixed based on the reviewer's feedback

4ddae5f

Merge branch 'main' into translate-ja-track-collector-internal-telemetry

db1982e

merged the file in the latest version

c992cd6

otelbot-docs bot requested a review from a team March 12, 2026 13:14

aki0000 added 2 commits March 12, 2026 22:31

fixed the remaining feedback

1381ea0

fixed verbosity in ja

3024ac5

katzchang suggested changes Mar 13, 2026

View reviewed changes

katzchang reviewed Mar 13, 2026

View reviewed changes

fixed based on the reviewer's further feedback

78cf8e0

otelbot-docs bot requested a review from a team March 13, 2026 06:29

katzchang approved these changes Mar 14, 2026

View reviewed changes

otelbot-docs bot removed the missing:sig-approval Co-owning SIG didn't provide an approval label Mar 14, 2026

katzchang added missing:sig-approval Co-owning SIG didn't provide an approval and removed missing:docs-approval Co-owning SIG has provided approval, PR needs approval from docs maintainer labels Mar 14, 2026

	コレクター v0.120.0 より前では、Prometheus で公開される内部メトリクスは、Prometheus の命名規則に合わせるためにドット（`.`）がアンダースコア（`_`）へ変更していました。、その結果、`rpc_server_duration`のようなメトリクス名になっていました。
	コレクター v0.120.0 より前では、Prometheus で公開される内部メトリクスは、Prometheus の命名規則に合わせるためにドット（`.`）をアンダースコア（`_`）に変更していました。その結果、`rpc_server_duration`のようなメトリクス名になっていました。


		#### 非推奨 {#deprecated}

		非推奨メトリクスは削除予定ですが、まだ使用可能になります。

	非推奨メトリクスは削除予定ですが、まだ使用可能になります。
	非推奨メトリクスは削除予定ですが、まだ使用可能です。

	この段階は、より広い利用を促進したり、`stable` の前の最終ステップです。
	この段階は、より広い利用を促進し、`stable` の前の最終ステップです。


		## コレクターで内部テレメトリーを有効化する {#activate-internal-telemetry-in-the-collector}

		デフォルトでは、コレクターは2つの方法で自身のテレメトリーを公開します。


		#### サービスのアドレス {#service-address}

		> [!NOTE] 内部テレメトリー構造の変更点

	> [!NOTE] 内部テレメトリー構造の変更点
	> [!NOTE] 内部テレメトリー設定の変更点

	オプションの完全な一覧については、OpenTelemetry 構成スキーマの[レポジトリ](https://github.com/open-telemetry/opentelemetry-configuration/blob/main/snippets/View_kitchen_sink.yaml)にある例を参照してください。
	オプションの完全な一覧については、OpenTelemetry 構成スキーマの[リポジトリ](https://github.com/open-telemetry/opentelemetry-configuration/blob/main/snippets/View_kitchen_sink.yaml)にある例を参照してください。

	#### メトリクスの冗長度 {#metric-verbosity}
	#### メトリクスの詳細度 {#metric-verbosity}

	たとえば、以下の設定は、新しい名前 `process_uptime` と説明を出力するために `otelcol_process_uptime` と名付けられたメトリクスを更新します。
	たとえば、以下の設定は、`otelcol_process_uptime` という名前のメトリクスを、新しい名前 `process_uptime` と説明で出力するように更新します。

		> `http` と `rpc` のメトリクスは、コレクター SIG の管理下にないため、以下の成熟度レベルの対象外になります。
		> `otelcol_processor_batch_` メトリクスは `batchprocessor` 固有です。

	- クラッシュが検出され、クリーン停止と区別される。利用可能であればクラッシュデータが含まれる。
	- クリーン停止とは区別される形でクラッシュが検出される。利用可能であればクラッシュデータが含まれる。


		#### 受信失敗 {#receive-failures}

		`otelcol_receiver_refused_log_records`、`otelcol_receiver_refused_spans`、と `otelcol_receiver_refused_metric_points` の発生率が継続している場合、クライアントに返されたエラーが多すぎることを示します。

	`otelcol_exporter_send_failed_log_records`、`otelcol_exporter_send_failed_spans`、と `otelcol_exporter_send_failed_metric_points` の発生率が継続している場合、コレクターが期待どおりにデータをエクスポートできていないことを示します。
	`otelcol_exporter_send_failed_log_records`、`otelcol_exporter_send_failed_spans`、および `otelcol_exporter_send_failed_metric_points` の発生率が継続している場合、コレクターが期待どおりにデータをエクスポートできていないことを示します。


		#### データフロー {#data-flow}

		`otelcol_receiver_accepted_log_records`、`otelcol_receiver_accepted_spans`、と `otelcol_receiver_accepted_metric_points` メトリクスでデータ流入を監視できます。

	そして、 `otelcol_exporter_sent_log_records`、`otelcol_exporter_sent_spans`、と `otelcol_exporter_sent_metric_points` メトリクスでデータ流出を監視できます。
	そして、 `otelcol_exporter_sent_log_records`、`otelcol_exporter_sent_spans`、および `otelcol_exporter_sent_metric_points` メトリクスでデータ流出を監視できます。

Conversation

aki0000 commented Mar 12, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

English Page

Preview Page

Footnotes

Uh oh!

katzchang left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

aki0000 commented Mar 12, 2026

Uh oh!

katzchang left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

aki0000 commented Mar 13, 2026

Uh oh!

katzchang left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

aki0000 commented Mar 12, 2026 •

edited

Loading