Skip to content

Commit d37f619

Browse files
authored
[ja] translate demo/_index and demo/architecture page into ja (#5863)
1 parent 9f4fc6e commit d37f619

File tree

2 files changed

+278
-0
lines changed

2 files changed

+278
-0
lines changed

content/ja/docs/demo/_index.md

+80
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,80 @@
1+
---
2+
title: OpenTelemetryデモ ドキュメンテーション
3+
linkTitle: デモ
4+
cascade:
5+
repo: https://github.com/open-telemetry/opentelemetry-demo
6+
weight: 180
7+
cSpell:ignore: OLJCESPC
8+
default_lang_commit: 1e69c8f94a605ce5624c6b6657080d98f633ac7b
9+
---
10+
11+
[OpenTelemetryデモ](/ecosystem/demo/)のドキュメンテーションへようこそ。
12+
ここでは、デモのインストール方法や実行方法、そしてOpenTelemetryの動作を確認できるいくつかのシナリオについて説明しています。
13+
14+
## デモの実行 {#running-the-demo}
15+
16+
デモをデプロイして動作を確認したい場合は、ここから始めてください。
17+
18+
- [Docker](docker-deployment/)
19+
- [Kubernetes](kubernetes-deployment/)
20+
21+
## 言語機能リファレンス {#language-feature-reference}
22+
23+
特定の言語の計装がどのように機能するかを理解したい場合は、ここから始めてください。
24+
25+
| 言語 | 自動計装 | 計装ライブラリ | 手動計装 |
26+
| ---------- | ------------------------------------------------------ | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
27+
| .NET | [会計サービス](services/accounting/) | [カートサービス](services/cart/) | [カートサービス](services/cart/) |
28+
| C++ | | | [通貨サービス](services/currency/) |
29+
| Go | | [決済サービス](services/checkout/), [商品カタログサービス](services/product-catalog/) | [決済サービス](services/checkout/), [商品カタログサービス](services/product-catalog/) |
30+
| Java | [広告サービス](services/ad/) | | [広告サービス](services/ad/) |
31+
| JavaScript | | [フロントエンド](services/frontend/) | [フロントエンド](services/frontend/), [支払いサービス](services/payment/) |
32+
| Kotlin | | [不正検知サービス](services/fraud-detection/) | |
33+
| PHP | | [見積サービス](services/quote/) | [見積サービス](services/quote/) |
34+
| Python | [レコメンデーションサービス](services/recommendation/) | | [レコメンデーションサービス](services/recommendation/) |
35+
| Ruby | | [メールサービス](services/email/) | [メールサービス](services/email/) |
36+
| Rust | | [配送サービス](services/shipping/) | [配送サービス](services/shipping/) |
37+
38+
## サービスドキュメント {#service-documentation}
39+
40+
各サービスのOpenTelemetryのデプロイの仕方に関する具体的な情報は、こちらで確認できます
41+
42+
- [会計サービス](services/accounting/)
43+
- [広告サービス](services/ad/)
44+
- [カートサービス](services/cart/)
45+
- [決済サービス](services/checkout/)
46+
- [メールサービス](services/email/)
47+
- [フロントエンド](services/frontend/)
48+
- [負荷生成ツール](services/load-generator/)
49+
- [支払いサービス](services/payment/)
50+
- [商品カタログサービス](services/product-catalog/)
51+
- [見積サービス](services/quote/)
52+
- [レコメンデーションサービス](services/recommendation/)
53+
- [配送サービス](services/shipping/)
54+
- [画像プロバイダーサービス](services/imageprovider/)
55+
56+
## シナリオ {#scenarios}
57+
58+
OpenTelemetryを使用してどのように問題を解決できるでしょうか?
59+
これらのシナリオでは、事前に設定された問題を紹介し、それらを解決するためにOpenTelemetryのデータをどのように解釈するかを説明します。
60+
61+
今後、さらに多くのシナリオを追加していく予定です。
62+
63+
- フィーチャーフラグサービスを使用して、商品ID:`OLJCESPC7Z``GetProduct`リクエストに対する[商品カタログエラー](feature-flags)を生成
64+
- メモリリークを発見し、メトリクスとトレースを使用して診断。
65+
[詳細](scenarios/recommendation-cache/)
66+
67+
## リファレンス {#reference}
68+
69+
要件や機能マトリクスなどのプロジェクトリファレンスドキュメント。
70+
71+
- [アーキテクチャ](architecture/)
72+
- [開発](development/)
73+
- [フィーチャーフラグリファレンス](feature-flags/)
74+
- [メトリック機能マトリクス](telemetry-features/metric-coverage/)
75+
- [要件](./requirements/)
76+
- [スクリーンショット](screenshots/)
77+
- [サービス](services/)
78+
- [スパン属性リファレンス](telemetry-features/manual-span-attributes/)
79+
- [テスト](tests/)
80+
- [トレース機能マトリクス](telemetry-features/trace-coverage/)

content/ja/docs/demo/architecture.md

+198
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,198 @@
1+
---
2+
title: デモのアーキテクチャ
3+
linkTitle: アーキテクチャ
4+
aliases: [current_architecture]
5+
body_class: otel-mermaid-max-width
6+
default_lang_commit: 1e69c8f94a605ce5624c6b6657080d98f633ac7b
7+
---
8+
9+
**OpenTelemetryデモ** は、異なるプログラミング言語で書かれた複数のマイクロサービスから構成されており、gRPCとHTTPを使って相互に通信を行います。
10+
さらに、負荷生成ツールが含まれており、[Locust](https://locust.io/)というツールを使用して、ユーザートラフィックを模擬的に生成します。
11+
12+
```mermaid
13+
graph TD
14+
subgraph サービス図
15+
accountingservice(会計サービス):::dotnet
16+
adservice(広告サービス):::java
17+
cache[(キャッシュ<br/>&#40Valkey&#41)]
18+
cartservice(カートサービス):::dotnet
19+
checkoutservice(決済サービス):::golang
20+
currencyservice(通貨サービス):::cpp
21+
emailservice(メールサービス):::ruby
22+
flagd(Flagd):::golang
23+
flagdui(Flagd-ui):::typescript
24+
frauddetectionservice(不正検知サービス):::kotlin
25+
frontend(フロントエンド):::typescript
26+
frontendproxy(フロントエンドプロキシ <br/>&#40Envoy&#41):::cpp
27+
imageprovider(画像プロバイダー <br/>&#40nginx&#41):::cpp
28+
loadgenerator([負荷生成ツール]):::python
29+
paymentservice(支払いサービス):::javascript
30+
productcatalogservice(商品カタログサービス):::golang
31+
quoteservice(見積サービス):::php
32+
recommendationservice(レコメンデーションサービス):::python
33+
shippingservice(配送サービス):::rust
34+
queue[(キュー<br/>&#40Kafka&#41)]:::java
35+
36+
adservice ---->|gRPC| flagd
37+
38+
checkoutservice -->|gRPC| cartservice
39+
checkoutservice --->|TCP| queue
40+
cartservice --> cache
41+
cartservice -->|gRPC| flagd
42+
43+
checkoutservice -->|gRPC| shippingservice
44+
checkoutservice -->|gRPC| paymentservice
45+
checkoutservice --->|HTTP| emailservice
46+
checkoutservice -->|gRPC| currencyservice
47+
checkoutservice -->|gRPC| productcatalogservice
48+
49+
frauddetectionservice -->|gRPC| flagd
50+
51+
frontend -->|gRPC| adservice
52+
frontend -->|gRPC| cartservice
53+
frontend -->|gRPC| checkoutservice
54+
frontend ---->|gRPC| currencyservice
55+
frontend ---->|gRPC| recommendationservice
56+
frontend -->|gRPC| productcatalogservice
57+
58+
frontendproxy -->|gRPC| flagd
59+
frontendproxy -->|HTTP| frontend
60+
frontendproxy -->|HTTP| flagdui
61+
frontendproxy -->|HTTP| imageprovider
62+
63+
Internet -->|HTTP| frontendproxy
64+
65+
loadgenerator -->|HTTP| frontendproxy
66+
67+
paymentservice -->|gRPC| flagd
68+
69+
queue -->|TCP| accountingservice
70+
queue -->|TCP| frauddetectionservice
71+
72+
recommendationservice -->|gRPC| productcatalogservice
73+
recommendationservice -->|gRPC| flagd
74+
75+
shippingservice -->|HTTP| quoteservice
76+
end
77+
78+
classDef dotnet fill:#178600,color:white;
79+
classDef cpp fill:#f34b7d,color:white;
80+
classDef golang fill:#00add8,color:black;
81+
classDef java fill:#b07219,color:white;
82+
classDef javascript fill:#f1e05a,color:black;
83+
classDef kotlin fill:#560ba1,color:white;
84+
classDef php fill:#4f5d95,color:white;
85+
classDef python fill:#3572A5,color:white;
86+
classDef ruby fill:#701516,color:white;
87+
classDef rust fill:#dea584,color:black;
88+
classDef typescript fill:#e98516,color:black;
89+
```
90+
91+
```mermaid
92+
graph TD
93+
subgraph サービスの凡例
94+
dotnetsvc(.NET):::dotnet
95+
cppsvc(C++):::cpp
96+
golangsvc(Go):::golang
97+
javasvc(Java):::java
98+
javascriptsvc(JavaScript):::javascript
99+
kotlinsvc(Kotlin):::kotlin
100+
phpsvc(PHP):::php
101+
pythonsvc(Python):::python
102+
rubysvc(Ruby):::ruby
103+
rustsvc(Rust):::rust
104+
typescriptsvc(TypeScript):::typescript
105+
end
106+
107+
classDef dotnet fill:#178600,color:white;
108+
classDef cpp fill:#f34b7d,color:white;
109+
classDef golang fill:#00add8,color:black;
110+
classDef java fill:#b07219,color:white;
111+
classDef javascript fill:#f1e05a,color:black;
112+
classDef kotlin fill:#560ba1,color:white;
113+
classDef php fill:#4f5d95,color:white;
114+
classDef python fill:#3572A5,color:white;
115+
classDef ruby fill:#701516,color:white;
116+
classDef rust fill:#dea584,color:black;
117+
classDef typescript fill:#e98516,color:black;
118+
```
119+
120+
デモアプリケーションの[メトリック](/docs/demo/telemetry-features/metric-coverage/)[トレース](/docs/demo/telemetry-features/trace-coverage/) の計装の現状については、リンクをご確認ください。
121+
122+
コレクターの設定は [otelcol-config.yml](https://github.com/open-telemetry/opentelemetry-demo/blob/main/src/otelcollector/otelcol-config.yml) で行われており、代替のエクスポーターをここで設定することができます。
123+
124+
```mermaid
125+
graph TB
126+
subgraph tdf[テレメトリーデータフロー]
127+
subgraph subgraph_padding [ ]
128+
style subgraph_padding fill:none,stroke:none;
129+
%% タイトルの重複を防ぐためのパディング
130+
subgraph od[OpenTelemetryデモ]
131+
ms(マイクロサービス)
132+
end
133+
134+
ms -.->|"OTLP<br/>gRPC"| oc-grpc
135+
ms -.->|"OTLP<br/>HTTP POST"| oc-http
136+
137+
subgraph oc[OTelコレクター]
138+
style oc fill:#97aef3,color:black;
139+
oc-grpc[/"OTLPレシーバー<br/>リッスン先:<br/>grpc://localhost:4317"/]
140+
oc-http[/"OTLPレシーバー<br/>リッスン先:<br/>localhost:4318<br/>"/]
141+
oc-proc(プロセッサー)
142+
oc-prom[/"OTLP HTTPエクスポーター"/]
143+
oc-otlp[/"OTLPエクスポーター"/]
144+
145+
oc-grpc --> oc-proc
146+
oc-http --> oc-proc
147+
148+
oc-proc --> oc-prom
149+
oc-proc --> oc-otlp
150+
end
151+
152+
oc-prom -->|"localhost:9090/api/v1/otlp"| pr-sc
153+
oc-otlp -->|gRPC| ja-col
154+
155+
subgraph pr[Prometheus]
156+
style pr fill:#e75128,color:black;
157+
pr-sc[/"Prometheus OTLP書き込みレシーバー"/]
158+
pr-tsdb[(Prometheus TSDB)]
159+
pr-http[/"Prometheus HTTP<br/>リッスン先:<br/>localhost:9090"/]
160+
161+
pr-sc --> pr-tsdb
162+
pr-tsdb --> pr-http
163+
end
164+
165+
pr-b{{"ブラウザ<br/>Prometheus UI"}}
166+
pr-http ---->|"localhost:9090/graph"| pr-b
167+
168+
subgraph ja[Jaeger]
169+
style ja fill:#60d0e4,color:black;
170+
ja-col[/"Jaegerコレクター<br/>リッスン先:<br/>grpc://jaeger:4317"/]
171+
ja-db[(Jaeger DB)]
172+
ja-http[/"Jaeger HTTP<br/>リッスン先:<br/>localhost:16686"/]
173+
174+
ja-col --> ja-db
175+
ja-db --> ja-http
176+
end
177+
178+
subgraph gr[Grafana]
179+
style gr fill:#f8b91e,color:black;
180+
gr-srv["Grafanaサーバー"]
181+
gr-http[/"Grafana HTTP<br/>リッスン先:<br/>localhost:3000"/]
182+
183+
gr-srv --> gr-http
184+
end
185+
186+
pr-http --> |"localhost:9090/api"| gr-srv
187+
ja-http --> |"localhost:16686/api"| gr-srv
188+
189+
ja-b{{"ブラウザ<br/>Jaeger UI"}}
190+
ja-http ---->|"localhost:16686/search"| ja-b
191+
192+
gr-b{{"ブラウザ<br/>Grafana UI"}}
193+
gr-http -->|"localhost:3000/dashboard"| gr-b
194+
end
195+
end
196+
```
197+
198+
Protocol Bufferの定義は /pb/ ディレクトリにあります。

0 commit comments

Comments
 (0)