Skip to content

Commit 61dea8f

Browse files
ymotongpooymotongpoo
committed
add platforms/faas/lambda-collector
1 parent ee61274 commit 61dea8f

File tree

3 files changed

+158
-5
lines changed

3 files changed

+158
-5
lines changed

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

+1-2
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,7 @@
11
---
22
title: プラットフォームと環境
33
linkTitle: プラットフォーム
4-
description:
5-
OpenTelemetryをサポートするハードウェアとソフトウェアのプラットフォームや環境
4+
description: OpenTelemetryをサポートするハードウェアとソフトウェアのプラットフォームや環境
65
weight: 260
76
default_lang_commit: 9ba98f4fded66ec78bfafa189ab2d15d66df2309
87
---

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

+1-3
Original file line numberDiff line numberDiff line change
@@ -40,8 +40,7 @@ Lambdaレイヤーは、Java 8, 11, 17 (Corretto) Lambdaランタイムをサポ
4040
- `OTEL_INSTRUMENTATION_COMMON_DEFAULT_ENABLED`: falseに設定すると、レイヤーの自動計装を無効にし、各計装を個別に有効にする必要があります。
4141
- `OTEL_INSTRUMENTATION_<NAME>_ENABLED`: 特定のライブラリやフレームワークの自動計装を有効にするには true を設定します。`<NAME>`の部分を有効にしたい計装で置き換えます。利用可能な計装のリストについては、[特定のエージェントの計装を抑制する][1] を参照してください。
4242

43-
[1]:
44-
/docs/zero-code/java/agent/disable/#suppressing-specific-agent-instrumentation
43+
[1]: /docs/zero-code/java/agent/disable/#suppressing-specific-agent-instrumentation
4544

4645
たとえば、LambdaとAWS SDKの自動計装だけを有効にするには、以下の環境変数を設定します。
4746

@@ -113,4 +112,3 @@ gRPC/HTTPレシーバーを持つコレクターが組み込まれている場
113112
### あなたのLambdaを公開する
114113

115114
Lambdaの新しいバージョンを公開して、新しい変更と計装をデプロイします。
116-

‎content/ja/docs/platforms/faas/lambda-collector.md

+156
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,156 @@
1+
---
2+
title: Lambdaコレクター設定
3+
linkTitle: Lambdaコレクター設定
4+
weight: 11
5+
description: コレクターLambdaレイヤーをあなたのLambdaに追加して設定する
6+
cSpell:ignore: ADOT awsxray configmap confmap regionalized
7+
default_lang_commit: 9ba98f4fded66ec78bfafa189ab2d15d66df2309
8+
---
9+
10+
OpenTelemetry コミュニティは、ユーザーに最大限の柔軟性を与えるために、コレクターを計装レイヤーとは別のLambdaレイヤーで提供しています。
11+
これは、計装とコレクターをバンドルしている現在の AWS Distribution of OpenTelemetry (ADOT) の実装とは異なります。
12+
13+
### OTelコレクターLambdaレイヤーのARNを追加する
14+
15+
アプリケーションの計装が完了したら、コレクターLambdaレイヤーを追加してデータを収集し、選択したバックエンドに送信します。
16+
17+
[最新のコレクターレイヤーリリース](https://github.com/open-telemetry/opentelemetry-lambda/releases)を見つけ、そのARNを使用します。
18+
`<region>`タグをラムダがいるリージョンに変更します。
19+
20+
注意: ラムダレイヤーはリージョンで分かれたリソースであり、公開されているリージョンでのみ使用できます。Lambda関数と同じリージョンでレイヤーを使用するようにしてください。コミュニティは、利用可能なすべてのリージョンでレイヤーを公開しています。
21+
22+
### OTelコレクターの設定
23+
24+
OTelコレクターLambdaレイヤーの設定は、OpenTelemetry標準にしたがっています。
25+
26+
デフォルトでは、OTelコレクターLambdaレイヤーはconfig.yamlを使用します。
27+
28+
#### 希望するバックエンドの環境変数を設定する
29+
30+
Lambda環境変数の設定で、認証トークンを格納する新しい変数を作成します。
31+
32+
#### デフォルトエクスポーターを更新する
33+
34+
もしまだ存在していなければ、`config.yaml` ファイルに好みのエクスポーターを追加します。
35+
前のステップでアクセストークンのために設定した環境変数を使用して、エクスポーターを設定します。
36+
37+
**エクスポーターに環境変数が設定されていない場合、デフォルトの設定は、デバッグエクスポーターを使用したデータ送信のみをサポートします**
38+
以下はデフォルトの設定です。
39+
40+
```yaml
41+
receivers:
42+
otlp:
43+
protocols:
44+
grpc:
45+
endpoint: '0.0.0.0:4317'
46+
http:
47+
endpoint: '0.0.0.0:4318'
48+
49+
exporters:
50+
# 注意: v0.86.0 より前のバージョンでは、`debug` のかわりに `logging` を使用すること
51+
debug:
52+
verbosity: detailed
53+
54+
service:
55+
pipelines:
56+
traces:
57+
receivers: [otlp]
58+
exporters: [debug]
59+
metrics:
60+
receivers: [otlp]
61+
exporters: [debug]
62+
telemetry:
63+
metrics:
64+
address: localhost:8888
65+
```
66+
67+
### Lambdaを公開する
68+
69+
Lambdaの新しいバージョンをパブリッシュして、行った変更を有効にします。
70+
71+
### 高度な OTel コレクターの設定
72+
73+
カスタム構成でサポートされる利用可能なコンポーネントのリストは、こちらをご覧ください。
74+
デバッグを有効にするには、設定ファイルを使ってログレベルをデバッグに設定します。
75+
以下の例を参照してください。
76+
77+
#### 希望のConfmapプロバイダーを選択する
78+
79+
OTel Lambdaレイヤーは `file`、`env`、`yaml`、`http`、`https`、`s3` といった種類の Confmap プロバイダーをサポートしています。
80+
異なる Confmap プロバイダーを使用して OTel コレクターの設定をカスタマイズするには、[Amazon Distribution of OpenTelemetry Confmap providers document](https://aws-otel.github.io/docs/components/confmap-providers#confmap-providers-supported-by-the-adot-collector) を参照してください。
81+
82+
#### カスタム設定ファイルの作成
83+
84+
以下はルートディレクトリにある `collector.yaml` の設定ファイルのサンプルです。
85+
86+
```yaml
87+
# ルート・ディレクトリの collector.yaml
88+
# 環境変数 'OPENTELEMETRY_COLLECTOR_CONFIG_URI' を '/var/task/collector.yaml' に設定する
89+
90+
receivers:
91+
otlp:
92+
protocols:
93+
grpc:
94+
endpoint: 'localhost:4317'
95+
http:
96+
endpoint: 'localhost:4318'
97+
98+
exporters:
99+
# 注意: v0.86.0 より前のバージョンでは `debug` のかわりに `logging` を使用すること
100+
debug:
101+
awsxray:
102+
103+
service:
104+
pipelines:
105+
traces:
106+
receivers: [otlp]
107+
exporters: [awsxray]
108+
metrics:
109+
receivers: [otlp]
110+
exporters: [debug]
111+
telemetry:
112+
metrics:
113+
address: localhost:8888
114+
```
115+
116+
#### 環境変数を使ってカスタム設定ファイルをマップする
117+
118+
confmapプロバイダーを通してコレクターを設定したら、Lambda関数に環境変数 `OPENTELEMETRY_COLLECTOR_CONFIG_URI` を作成し、その値としてconfmapプロバイダーの設定のパスを設定します。
119+
たとえば、ファイルconfigmapプロバイダーを使用している場合は、その値を `/var/task/<path>/<to>/<filename>` に設定します。
120+
これにより、拡張モジュールにコレクターの設定がどこにあるかを伝えます。
121+
122+
##### CLIを使用したカスタムコレクター設定
123+
124+
Lambdaコンソール、またはAWS CLIから設定できます。
125+
126+
```bash
127+
aws lambda update-function-configuration --function-name Function --environment Variables={OPENTELEMETRY_COLLECTOR_CONFIG_URI=/var/task/collector.yaml}
128+
```
129+
130+
##### CloudFormationから設定用の環境変数を設定する
131+
132+
環境変数は**CloudFormation**テンプレートでも設定できます。
133+
134+
```yaml
135+
Function:
136+
Type: AWS::Serverless::Function
137+
Properties:
138+
...
139+
Environment:
140+
Variables:
141+
OPENTELEMETRY_COLLECTOR_CONFIG_URI: /var/task/collector.yaml
142+
```
143+
144+
##### S3オブジェクトから設定を読み込む
145+
146+
S3から設定を読み込むには、関数にアタッチされたIAMロールに、関連するバケットへの読み取りアクセスが含まれている必要があります。
147+
148+
```yaml
149+
Function:
150+
Type: AWS::Serverless::Function
151+
Properties:
152+
...
153+
Environment:
154+
Variables:
155+
OPENTELEMETRY_COLLECTOR_CONFIG_URI: s3://<bucket_name>.s3.<region>.amazonaws.com/collector_config.yaml
156+
```

0 commit comments

Comments
 (0)