Skip to content

Commit ee61274

Browse files
ymotongpooymotongpoo
committed
wip: add platform/android and platform/faas
1 parent 9ba98f4 commit ee61274

File tree

4 files changed

+156
-0
lines changed

4 files changed

+156
-0
lines changed

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

+11
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
---
2+
title: プラットフォームと環境
3+
linkTitle: プラットフォーム
4+
description:
5+
OpenTelemetryをサポートするハードウェアとソフトウェアのプラットフォームや環境
6+
weight: 260
7+
default_lang_commit: 9ba98f4fded66ec78bfafa189ab2d15d66df2309
8+
---
9+
10+
OpenTelemetry はさまざまなプラットフォームと環境で利用可能で、ハイブリッドシステムでのシームレスなオブザーバビリティを保証します。
11+
この節では、サポートされているプラットフォームで OpenTelemetry を有効にして使用する方法について説明します。

‎content/ja/docs/platforms/android/_index.md

+7
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
---
2+
title: Android
3+
# description:
4+
default_lang_commit: 9ba98f4fded66ec78bfafa189ab2d15d66df2309
5+
---
6+
7+
コンテンツは近日公開！

‎content/ja/docs/platforms/faas/_index.md

+22
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
---
2+
title: Functions as a Service
3+
linkTitle: FaaS
4+
description: >-
5+
OpenTelemetryは、さまざまなクラウドベンダーが提供するFaaSを監視するさまざまな方法をサポートしています。
6+
redirects: [{ from: /docs/faas/*, to: ':splat' }] # cSpell:disable-line
7+
default_lang_commit: 9ba98f4fded66ec78bfafa189ab2d15d66df2309
8+
---
9+
10+
Functions as a Service（FaaS）は、[クラウドネイティブアプリ][cloud native apps]にとって重要なサーバーレスコンピュートプラットフォームです。
11+
しかし、プラットフォームの癖によって、これらのアプリケーションはKubernetesやVirtual Machines上で実行されるアプリケーションとは若干異なる監視ガイダンスや要件を持つことになります。
12+
13+
FaaSドキュメントの最初のベンダー範囲は、Microsoft Azure、Google Cloud Platform（GCP）、Amazon Web Services（AWS）です。
14+
AWSのファンクション（関数）はLambdaとしても知られています。
15+
16+
### コミュニティアセット
17+
18+
現在、OpenTelemetry コミュニティは、アプリケーションを自動計装することができるビルド済みの Lambda レイヤーと、アプリケーションを手動または自動で計装する際に使用できるスタンドアロンの Collector Lambda レイヤーを提供しています。
19+
20+
リリース状況は[OpenTelemetry-Lambdaリポジトリ](https://github.com/open-telemetry/opentelemetry-lambda)で追跡できます。
21+
22+
[cloud native apps]: https://glossary.cncf.io/cloud-native-apps/

‎content/ja/docs/platforms/faas/lambda-auto-instrument.md

+116
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,116 @@
1+
---
2+
title: Lambda 自動計装
3+
weight: 11
4+
description: あなたのLambdaをOpenTelemetryで自動的に計装する
5+
cSpell:ignore: Corretto regionalized
6+
default_lang_commit: 9ba98f4fded66ec78bfafa189ab2d15d66df2309
7+
---
8+
9+
OpenTelemetryコミュニティは、以下の言語用のスタンドアロン計装Lambdaレイヤーを提供しています。
10+
11+
- Java
12+
- JavaScript
13+
- Python
14+
- Ruby
15+
16+
これらのレイヤーは、AWSポータルを使用してLambdaに追加し、アプリケーションを自動的に計装できます。
17+
これらのレイヤーにはコレクターは含まれておらず、外部コレクターインスタンスを構成してデータを送信しない限り、追加する必要があります。
18+
19+
### OTel Collector LambdaレイヤーのARNを追加する
20+
21+
[Collector Lambdaレイヤーのガイダンス](../lambda-collector/)を参照して、アプリケーションにレイヤーを追加し、Collectorを設定してください。
22+
これを最初に追加することをおすすめします。
23+
24+
### 言語要件
25+
26+
{{< tabpane text=true >}} {{% tab Java %}}
27+
28+
Lambdaレイヤーは、Java 8, 11, 17 (Corretto) Lambdaランタイムをサポートしています。
29+
サポートされているJavaのバージョンについては、[OpenTelemetry Java ドキュメント](/docs/languages/java/) を参照してください。
30+
31+
**注意:** Javaの自動計装エージェントがLambdaレイヤー内にあります - 自動計装エージェントはAWS Lambdaの起動時間に顕著な影響を与えるので、初期化中に最初のリクエストでタイムアウトを起こさずに本番のリクエストに対応するためには、一般的にプロビジョニングされた同時実行とウォームアップリクエストと共にこれを使用する必要があります。
32+
33+
デフォルトでは、レイヤーのOTel Javaエージェントは、アプリケーション内のすべてのコードを自動計装しようとします。
34+
これはLambdaのコールドスタートの起動時間に悪影響を及ぼす可能性があります。
35+
36+
アプリケーションで使用するライブラリ／フレームワークの自動計装のみを有効にすることをおすすめします。
37+
38+
特定の計装だけを有効にするには、以下の環境変数を使用します。
39+
40+
- `OTEL_INSTRUMENTATION_COMMON_DEFAULT_ENABLED`: falseに設定すると、レイヤーの自動計装を無効にし、各計装を個別に有効にする必要があります。
41+
- `OTEL_INSTRUMENTATION_<NAME>_ENABLED`: 特定のライブラリやフレームワークの自動計装を有効にするには true を設定します。`<NAME>`の部分を有効にしたい計装で置き換えます。利用可能な計装のリストについては、[特定のエージェントの計装を抑制する][1] を参照してください。
42+
43+
[1]:
44+
/docs/zero-code/java/agent/disable/#suppressing-specific-agent-instrumentation
45+
46+
たとえば、LambdaとAWS SDKの自動計装だけを有効にするには、以下の環境変数を設定します。
47+
48+
```sh
49+
OTEL_INSTRUMENTATION_COMMON_DEFAULT_ENABLED=false
50+
OTEL_INSTRUMENTATION_AWS_LAMBDA_ENABLED=true
51+
OTEL_INSTRUMENTATION_AWS_SDK_ENABLED=true
52+
```
53+
54+
{{% /tab %}} {{% tab JavaScript %}}
55+
56+
Lambdaレイヤーは、Node.js v14+のLambdaランタイムをサポートしています。
57+
サポートされるJavaScriptとNode.jsのバージョンの詳細については、[OpenTelemetry JavaScriptドキュメント](https://github.com/open-telemetry/opentelemetry-js)を参照してください。
58+
59+
{{% /tab %}} {{% tab Python %}}
60+
61+
LambdaレイヤーはPython 3.8とPython 3.9のLambdaランタイムをサポートしています。
62+
サポートされているPythonのバージョンについては、[OpenTelemetry Pythonドキュメント](https://github.com/open-telemetry/opentelemetry-python/blob/main/README.md#supported-runtimes) と [PyPi](https://pypi.org/project/opentelemetry-api/) のパッケージを参照してください。
63+
64+
{{% /tab %}} {{% tab Ruby %}}
65+
66+
Lambda レイヤーは、Ruby 3.2 と 3.3 の Lambda ランタイムをサポートしています。
67+
サポートされる 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) のパッケージを参照してください。
68+
69+
{{% /tab %}} {{< /tabpane >}}
70+
71+
### `AWS_LAMBDA_EXEC_WRAPPER` を設定する
72+
73+
Node.js、Java、Rubyの場合は `AWS_LAMBDA_EXEC_WRAPPER=/opt/otel-handler` 、Pythonの場合は`AWS_LAMBDA_EXEC_WRAPPER=/opt/otel-instrument` を設定して、アプリケーションのエントリーポイントを変更します。
74+
これらのラッパースクリプトは、自動計装を適用したLambdaアプリケーションを起動します。
75+
76+
### 計装LambdaレイヤーのARNを追加する
77+
78+
Lambda関数でOTelの自動計装を有効にするには、計装レイヤーとコレクターレイヤーを追加して設定し、トレースを有効にする必要があります。
79+
80+
1. AWSコンソールで、計装するLambda関数を開く。
81+
2. 「レイヤー」セクションで、「レイヤーの追加」を選択します。
82+
3. 「ARNを指定」でレイヤーのARNを貼り付け、「追加」を選択します。
83+
84+
あなたの言語の[最新の計装レイヤーリリース](https://github.com/open-telemetry/opentelemetry-lambda/releases)を見つけ、そのARNを使用します。
85+
`<region>`タグをあなたのラムダがあるリージョンに変更します。
86+
87+
注意: ラムダレイヤーはリージョンで分かれたリソースで、公開されているリージョンでのみ使用できます。Lambda関数と同じリージョンでレイヤーを使用するようにしてください。コミュニティは、利用可能なすべてのリージョンでレイヤーを公開しています。
88+
89+
### SDKのエクスポーターの設定
90+
91+
gRPC/HTTPレシーバーを持つコレクターが組み込まれている場合、Lambdaレイヤーで使用されるデフォルトのエクスポーターは変更なしで動作します。
92+
環境変数を更新する必要はありません。
93+
ただし、プロトコルのサポートレベルやデフォルト値は言語によって異なります。
94+
95+
{{< tabpane text=true >}} {{% tab Java %}}
96+
97+
`OTEL_EXPORTER_OTLP_PROTOCOL=grpc` は `grpc`、`http/protobuf` および `http/json`、`OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317` をサポートします。
98+
99+
{{% /tab %}} {{% tab JavaScript %}}
100+
101+
環境変数 `OTEL_EXPORTER_OTLP_PROTOCOL` はサポートされていません。ハードコードされたエクスポーターはプロトコル `http/protobuf` を使用します。`OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318`
102+
103+
{{% /tab %}} {{% tab Python %}}
104+
105+
`OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf` は `http/protobuf` と `http/json` 、`OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318` をサポートします。
106+
107+
{{% /tab %}} {{% tab Ruby %}}
108+
109+
`OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf` は `http/protobuf` `OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318` をサポートします。
110+
111+
{{% /tab %}} {{< /tabpane >}}
112+
113+
### あなたのLambdaを公開する
114+
115+
Lambdaの新しいバージョンを公開して、新しい変更と計装をデプロイします。
116+

0 commit comments

Comments
 (0)