Skip to content

Commit aa39bbe

Browse files
cijothomascijothomas
authored
Merge branch 'main' into cijothomas/rust-start-1
2 parents d421127 + d1aac68 commit aa39bbe

File tree

27 files changed

+1115
-270
lines changed

27 files changed

+1115
-270
lines changed

‎.gitmodules

+1-1
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@
2020
[submodule "content-modules/semantic-conventions"]
2121
path = content-modules/semantic-conventions
2222
url = https://github.com/open-telemetry/semantic-conventions
23-
semconv-pin = v1.30.0
23+
semconv-pin = v1.31.0
2424
[submodule "content-modules/opamp-spec"]
2525
path = content-modules/opamp-spec
2626
url = https://github.com/open-telemetry/opamp-spec

‎content-modules/semantic-conventions

‎content/en/docs/contributing/pr-checks.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -43,8 +43,8 @@ more information.
4343
## Style checks
4444

4545
To make sure that contributions follow our [style guide](../style-guide/) we
46-
have implemented a set of checks that verify style guide rules and fail l if
47-
they find any issues.
46+
have implemented a set of checks that verify style guide rules and fail if they
47+
find any issues.
4848

4949
The following list describes current checks and what you can do to fix related
5050
errors:
@@ -64,7 +64,7 @@ issues. Run `npm run check:text` again and manually fix the remaining issues.
6464
This check verifies that
6565
[standards and consistency for Markdown files are enforced](../style-guide/#markdown-standards).
6666

67-
If any issues are found, run `npm:run format` to fix most issues. For more
67+
If any issues are found, run `npm run:format` to fix most issues. For more
6868
complex issues, run `npm run check:markdown` and apply the suggested changes.
6969

7070
### SPELLING check

‎content/en/docs/zero-code/java/agent/instrumentation/_index.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -93,7 +93,7 @@ span link connecting it to the producer trace.
9393
## Capturing enduser attributes
9494

9595
You can configure the agent to capture
96-
[general identity attributes](/docs/specs/semconv/general/attributes/#general-identity-attributes)
96+
[general identity attributes](/docs/specs/semconv/attributes-registry/enduser/)
9797
(`enduser.id`, `enduser.role`, `enduser.scope`) from instrumentation libraries
9898
like
9999
[JavaEE/JakartaEE Servlet](https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/instrumentation/servlet)

‎content/ja/blog/2025/_index.md

+5
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
---
2+
title: 2025
3+
weight: -2025
4+
default_lang_commit: 94d77ab8cbfe5552a7cd68bf677be86c574a613a
5+
---

‎content/ja/blog/2025/ai-agent-observability/index.md

+177
Large diffs are not rendered by default.

‎content/ja/blog/_index.md

+13-1
Original file line numberDiff line numberDiff line change
@@ -2,5 +2,17 @@
22
title: ブログ
33
menu: { main: { weight: 50 } }
44
outputs: [HTML, RSS]
5-
default_lang_commit: c0a5eea5d720b0e075efa87f99dcf58c89106268
5+
description: OpenTelemetry ブログ
6+
default_lang_commit: 94d77ab8cbfe5552a7cd68bf677be86c574a613a
67
---
8+
9+
<script>
10+
document.addEventListener("DOMContentLoaded", function () {
11+
if (window.location.pathname.includes('/page/')) return;
12+
13+
var checkbox = document.getElementById("m-blog2025-check");
14+
if (checkbox) checkbox.checked = true;
15+
checkbox = document.getElementById("m-blog2024-check");
16+
if (checkbox) checkbox.checked = true;
17+
});
18+
</script>

‎content/ja/docs/collector/_index.md

+14-8
Original file line numberDiff line numberDiff line change
@@ -2,10 +2,9 @@
22
title: コレクター
33
description: テレメトリーデータを受信、処理、エクスポートするためのベンダー非依存な方法
44
cascade:
5-
vers: 0.120.0
5+
vers: 0.121.0
66
weight: 270
7-
default_lang_commit: cd90ab77550fb2e92ca37cb3c753ec2d8bb7d8dc
8-
drifted_from_default: true
7+
default_lang_commit: e1209f387a604c493e8b41923a3b2ceacd7437a0
98
---
109

1110
![Jaeger、OTLP、Prometheusを統合したOpenTelemetryコレクターのダイアグラム](img/otel-collector.svg)
@@ -40,22 +39,29 @@ OpenTelemetryを試したり始めたりするには、バックエンドに直
4039
[コレクターのセットアップ](quick-start)も、思っているより簡単です。
4140
各言語のデフォルトのOTLPエクスポーターは、ローカルコレクターのエンドポイントを想定しているので、コレクターを起動すると、自動的にテレメトリーの受信を開始します。
4241

43-
## Collector security {#collector-security}
42+
## コレクターのセキュリティ {#collector-security}
4443

4544
ベストプラクティスに従い、コレクターが安全に[ホスト][hosted]と[設定][configured]されていることを確認してください。
4645

47-
## ステータスとリリース {#status-and-releases}
46+
## ステータス {#status}
4847

4948
**コレクター**のステータスは、コレクターのコアコンポーネントが現在、[安定性レベル][stability levels]がまちまちであるため、 [混合状態（mixed）][mixed] となっています。
5049

5150
**コレクターコンポーネント** は成熟度が異なります。
5251
各コンポーネントの安定性は `README.md` で明記されています。
5352
利用可能なコレクターコンポーネントの一覧は、[レジストリ][registry] にあります。
5453

55-
{{% docs/latest-release collector-releases /%}}
54+
コレクターのソフトウェアのアーティファクトは、対象となる利用者に応じた一定の期間、サポートが保証されます。
55+
このサポートには、最低限、重大なバグやセキュリティ問題の修正が含まれます。
56+
詳細については、[サポートポリシー](https://github.com/open-telemetry/opentelemetry-collector/blob/main/VERSIONING.md) を参照してください。
57+
58+
## ディストリビューションとリリース {#releases}
59+
60+
[最新のリリース][latest release] を含むコレクターの配布とリリースについての情報は、[ディストリビューション](distributions/) を確認してください。
5661

57-
[registry]: /ecosystem/registry/?language=collector
58-
[hosted]: /docs/security/hosting-best-practices/
5962
[configured]: /docs/security/config-best-practices/
63+
[hosted]: /docs/security/hosting-best-practices/
64+
[latest release]: https://github.com/open-telemetry/opentelemetry-collector-releases/releases/latest
6065
[mixed]: /docs/specs/otel/document-status/#mixed
66+
[registry]: /ecosystem/registry/?language=collector
6167
[stability levels]: https://github.com/open-telemetry/opentelemetry-collector#stability-levels

‎content/ja/docs/collector/deployment/_index.md

+19
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
---
2+
title: デプロイメント
3+
description: OpenTelemetryコレクターをデプロイするために適用できるパターン
4+
weight: 3
5+
default_lang_commit: b34ebe22b71962da96b898eb39a666ed57d447fe
6+
---
7+
8+
OpenTelemetryコレクターは、さまざまな方法で、さまざまなユースケースに使用できる単一のバイナリから構成されています。
9+
このセクションでは、デプロイメントパターン、それらのユースケース、および長所と短所、クロス環境およびマルチバックエンドデプロイメントにおけるコレクター設定のベストプラクティスについて説明します。
10+
デプロイメントのセキュリティに関する考慮事項については、[コレクターホスティングのベストプラクティス][security]を参照してください。
11+
12+
## リソース {#resources}
13+
14+
- KubeCon NA 2021の[OpenTelemetryコレクターデプロイメントパターン][y-patterns]に関する講演
15+
- 講演に付随する[デプロイメントパターン][gh-patterns]
16+
17+
[security]: /docs/security/hosting-best-practices/
18+
[gh-patterns]: https://github.com/jpkrohling/opentelemetry-collector-deployment-patterns/
19+
[y-patterns]: https://www.youtube.com/watch?v=WhRrwSHDBFs

‎content/ja/docs/collector/deployment/agent.md

+126
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,126 @@
1+
---
2+
title: エージェント
3+
description: コレクターにシグナルを送信し、そこからバックエンドに送信する理由と方法
4+
weight: 2
5+
default_lang_commit: b34ebe22b71962da96b898eb39a666ed57d447fe
6+
cSpell:ignore: prometheusremotewrite
7+
---
8+
9+
コレクターのエージェントデプロイメントパターンは、OpenTelemetry SDKを使用して[計装された][instrumentation]アプリケーション（[OpenTelemetryプロトコル（OTLP）][otlp]を使用）や、他のコレクター（OTLPエクスポーターを使用）が、テレメトリーシグナルを[コレクター][collector]インスタンスに送信する構成です。
10+
このコレクターインスタンスは、アプリケーションと同じホストまたはアプリケーションの横に配置されたサイドカーやデーモンセットとして動作します。
11+
12+
各クライアント側SDKまたはダウンストリームコレクターは、コレクターの場所を設定します。
13+
14+
![分散型コレクターデプロイメント概念](../../img/otel-agent-sdk.svg)
15+
16+
1. アプリケーションで、SDKがOTLPデータをコレクターに送信するように設定されます。
17+
1. コレクターは、テレメトリーデータを1つ以上のバックエンドに送信するように設定されます。
18+
19+
## 例 {#example}
20+
21+
コレクターのエージェントデプロイメントパターンの具体例は以下のようになります。
22+
たとえば、[Javaアプリケーションを計装してメトリクスをエクスポート][instrument-java-metrics]するためにOpenTelemetry Java SDKを使用します。
23+
アプリケーションのコンテキスト内で、`OTEL_METRICS_EXPORTER`を`otlp`（デフォルト値）に設定し、[OTLPエクスポーター][otlp-exporter]をコレクターのアドレスで設定します。たとえば、Bashまたは`zsh`シェルでは、次のように設定します。
24+
25+
```shell
26+
export OTEL_EXPORTER_OTLP_ENDPOINT=http://collector.example.com:4318
27+
```
28+
29+
`collector.example.com:4318` で動作するコレクターは次のように設定されます。
30+
31+
{{< tabpane text=true >}} {{% tab Traces %}}
32+
33+
```yaml
34+
receivers:
35+
otlp: # アプリケーションがトレースを送信するOTLPレシーバー
36+
protocols:
37+
http:
38+
endpoint: 0.0.0.0:4318
39+
40+
processors:
41+
batch:
42+
43+
exporters:
44+
otlp/jaeger: # JaegerはOTLPを直接サポートしています
45+
endpoint: https://jaeger.example.com:4317
46+
47+
service:
48+
pipelines:
49+
traces/dev:
50+
receivers: [otlp]
51+
processors: [batch]
52+
exporters: [otlp/jaeger]
53+
```
54+
55+
{{% /tab %}} {{% tab Metrics %}}
56+
57+
```yaml
58+
receivers:
59+
otlp: # アプリケーションがメトリクスを送信するOTLPレシーバー
60+
protocols:
61+
http:
62+
endpoint: 0.0.0.0:4318
63+
64+
processors:
65+
batch:
66+
67+
exporters:
68+
prometheusremotewrite: # PRWエクスポーター、メトリクスをバックエンドに取り込む
69+
endpoint: https://prw.example.com/v1/api/remote_write
70+
71+
service:
72+
pipelines:
73+
metrics/prod:
74+
receivers: [otlp]
75+
processors: [batch]
76+
exporters: [prometheusremotewrite]
77+
```
78+
79+
{{% /tab %}} {{% tab Logs %}}
80+
81+
```yaml
82+
receivers:
83+
otlp: # アプリケーションがログを送信するOTLPレシーバー
84+
protocols:
85+
http:
86+
endpoint: 0.0.0.0:4318
87+
88+
processors:
89+
batch:
90+
91+
exporters:
92+
file: # ファイルエクスポーター、ログをローカルファイルに取り込む
93+
path: ./app42_example.log
94+
rotation:
95+
96+
service:
97+
pipelines:
98+
logs/dev:
99+
receivers: [otlp]
100+
processors: [batch]
101+
exporters: [file]
102+
```
103+
104+
{{% /tab %}} {{< /tabpane >}}
105+
106+
実際に試してみたい場合は、エンドツーエンドの[Java][java-otlp-example]や[Python][py-otlp-example]の例で確認できます。
107+
108+
## トレードオフ {#tradeoffs}
109+
110+
長所：
111+
112+
- 始めやすい
113+
- アプリケーションとコレクターの間に明確な1:1のマッピング
114+
115+
短所：
116+
117+
- スケーラビリティ（人的および負荷面）
118+
- 柔軟性に欠ける
119+
120+
[instrumentation]: /docs/languages/
121+
[otlp]: /docs/specs/otel/protocol/
122+
[collector]: /docs/collector/
123+
[instrument-java-metrics]: /docs/languages/java/api/#meterprovider
124+
[otlp-exporter]: /docs/specs/otel/protocol/exporter/
125+
[java-otlp-example]: https://github.com/open-telemetry/opentelemetry-java-docs/tree/main/otlp
126+
[py-otlp-example]: https://opentelemetry-python.readthedocs.io/en/stable/examples/metrics/instruments/README.html

0 commit comments

Comments
 (0)