From ee61274cb9d59a7a97bee47f5a8e10e575b85e96 Mon Sep 17 00:00:00 2001 From: Yoshi Yamaguchi Date: Wed, 12 Mar 2025 13:44:37 +0000 Subject: [PATCH 1/4] wip: add platform/android and platform/faas --- content/ja/docs/platforms/_index.md | 11 ++ content/ja/docs/platforms/android/_index.md | 7 ++ content/ja/docs/platforms/faas/_index.md | 22 ++++ .../platforms/faas/lambda-auto-instrument.md | 116 ++++++++++++++++++ 4 files changed, 156 insertions(+) create mode 100644 content/ja/docs/platforms/_index.md create mode 100644 content/ja/docs/platforms/android/_index.md create mode 100644 content/ja/docs/platforms/faas/_index.md create mode 100644 content/ja/docs/platforms/faas/lambda-auto-instrument.md diff --git a/content/ja/docs/platforms/_index.md b/content/ja/docs/platforms/_index.md new file mode 100644 index 000000000000..a901f4d863c9 --- /dev/null +++ b/content/ja/docs/platforms/_index.md @@ -0,0 +1,11 @@ +--- +title: プラットフォームと環境 +linkTitle: プラットフォーム +description: + OpenTelemetryをサポートするハードウェアとソフトウェアのプラットフォームや環境 +weight: 260 +default_lang_commit: 9ba98f4fded66ec78bfafa189ab2d15d66df2309 +--- + +OpenTelemetry はさまざまなプラットフォームと環境で利用可能で、ハイブリッドシステムでのシームレスなオブザーバビリティを保証します。 +この節では、サポートされているプラットフォームで OpenTelemetry を有効にして使用する方法について説明します。 diff --git a/content/ja/docs/platforms/android/_index.md b/content/ja/docs/platforms/android/_index.md new file mode 100644 index 000000000000..c31029ca024a --- /dev/null +++ b/content/ja/docs/platforms/android/_index.md @@ -0,0 +1,7 @@ +--- +title: Android +# description: +default_lang_commit: 9ba98f4fded66ec78bfafa189ab2d15d66df2309 +--- + +コンテンツは近日公開！ diff --git a/content/ja/docs/platforms/faas/_index.md b/content/ja/docs/platforms/faas/_index.md new file mode 100644 index 000000000000..894c451275e8 --- /dev/null +++ b/content/ja/docs/platforms/faas/_index.md @@ -0,0 +1,22 @@ +--- +title: Functions as a Service +linkTitle: FaaS +description: >- + OpenTelemetryは、さまざまなクラウドベンダーが提供するFaaSを監視するさまざまな方法をサポートしています。 +redirects: [{ from: /docs/faas/*, to: ':splat' }] # cSpell:disable-line +default_lang_commit: 9ba98f4fded66ec78bfafa189ab2d15d66df2309 +--- + +Functions as a Service（FaaS）は、[クラウドネイティブアプリ][cloud native apps]にとって重要なサーバーレスコンピュートプラットフォームです。 +しかし、プラットフォームの癖によって、これらのアプリケーションはKubernetesやVirtual Machines上で実行されるアプリケーションとは若干異なる監視ガイダンスや要件を持つことになります。 + +FaaSドキュメントの最初のベンダー範囲は、Microsoft Azure、Google Cloud Platform（GCP）、Amazon Web Services（AWS）です。 +AWSのファンクション（関数）はLambdaとしても知られています。 + +### コミュニティアセット + +現在、OpenTelemetry コミュニティは、アプリケーションを自動計装することができるビルド済みの Lambda レイヤーと、アプリケーションを手動または自動で計装する際に使用できるスタンドアロンの Collector Lambda レイヤーを提供しています。 + +リリース状況は[OpenTelemetry-Lambdaリポジトリ](https://github.com/open-telemetry/opentelemetry-lambda)で追跡できます。 + +[cloud native apps]: https://glossary.cncf.io/cloud-native-apps/ diff --git a/content/ja/docs/platforms/faas/lambda-auto-instrument.md b/content/ja/docs/platforms/faas/lambda-auto-instrument.md new file mode 100644 index 000000000000..168d4c734c21 --- /dev/null +++ b/content/ja/docs/platforms/faas/lambda-auto-instrument.md @@ -0,0 +1,116 @@ +--- +title: Lambda 自動計装 +weight: 11 +description: あなたのLambdaをOpenTelemetryで自動的に計装する +cSpell:ignore: Corretto regionalized +default_lang_commit: 9ba98f4fded66ec78bfafa189ab2d15d66df2309 +--- + +OpenTelemetryコミュニティは、以下の言語用のスタンドアロン計装Lambdaレイヤーを提供しています。 + +- Java +- JavaScript +- Python +- Ruby + +これらのレイヤーは、AWSポータルを使用してLambdaに追加し、アプリケーションを自動的に計装できます。 +これらのレイヤーにはコレクターは含まれておらず、外部コレクターインスタンスを構成してデータを送信しない限り、追加する必要があります。 + +### OTel Collector LambdaレイヤーのARNを追加する + +[Collector Lambdaレイヤーのガイダンス](../lambda-collector/)を参照して、アプリケーションにレイヤーを追加し、Collectorを設定してください。 +これを最初に追加することをおすすめします。 + +### 言語要件 + +{{< tabpane text=true >}} {{% tab Java %}} + +Lambdaレイヤーは、Java 8, 11, 17 (Corretto) Lambdaランタイムをサポートしています。 +サポートされているJavaのバージョンについては、[OpenTelemetry Java ドキュメント](/docs/languages/java/) を参照してください。 + +**注意:** Javaの自動計装エージェントがLambdaレイヤー内にあります - 自動計装エージェントはAWS Lambdaの起動時間に顕著な影響を与えるので、初期化中に最初のリクエストでタイムアウトを起こさずに本番のリクエストに対応するためには、一般的にプロビジョニングされた同時実行とウォームアップリクエストと共にこれを使用する必要があります。 + +デフォルトでは、レイヤーのOTel Javaエージェントは、アプリケーション内のすべてのコードを自動計装しようとします。 +これはLambdaのコールドスタートの起動時間に悪影響を及ぼす可能性があります。 + +アプリケーションで使用するライブラリ／フレームワークの自動計装のみを有効にすることをおすすめします。 + +特定の計装だけを有効にするには、以下の環境変数を使用します。 + +- `OTEL_INSTRUMENTATION_COMMON_DEFAULT_ENABLED`: falseに設定すると、レイヤーの自動計装を無効にし、各計装を個別に有効にする必要があります。 +- `OTEL_INSTRUMENTATION__ENABLED`: 特定のライブラリやフレームワークの自動計装を有効にするには true を設定します。``の部分を有効にしたい計装で置き換えます。利用可能な計装のリストについては、[特定のエージェントの計装を抑制する][1] を参照してください。 + + [1]: + /docs/zero-code/java/agent/disable/#suppressing-specific-agent-instrumentation + +たとえば、LambdaとAWS SDKの自動計装だけを有効にするには、以下の環境変数を設定します。 + +```sh +OTEL_INSTRUMENTATION_COMMON_DEFAULT_ENABLED=false +OTEL_INSTRUMENTATION_AWS_LAMBDA_ENABLED=true +OTEL_INSTRUMENTATION_AWS_SDK_ENABLED=true +``` + +{{% /tab %}} {{% tab JavaScript %}} + +Lambdaレイヤーは、Node.js v14+のLambdaランタイムをサポートしています。 +サポートされるJavaScriptとNode.jsのバージョンの詳細については、[OpenTelemetry JavaScriptドキュメント](https://github.com/open-telemetry/opentelemetry-js)を参照してください。 + +{{% /tab %}} {{% tab Python %}} + +LambdaレイヤーはPython 3.8とPython 3.9のLambdaランタイムをサポートしています。 +サポートされているPythonのバージョンについては、[OpenTelemetry Pythonドキュメント](https://github.com/open-telemetry/opentelemetry-python/blob/main/README.md#supported-runtimes) と [PyPi](https://pypi.org/project/opentelemetry-api/) のパッケージを参照してください。 + +{{% /tab %}} {{% tab Ruby %}} + +Lambda レイヤーは、Ruby 3.2 と 3.3 の Lambda ランタイムをサポートしています。 +サポートされる 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) のパッケージを参照してください。 + +{{% /tab %}} {{< /tabpane >}} + +### `AWS_LAMBDA_EXEC_WRAPPER` を設定する + +Node.js、Java、Rubyの場合は `AWS_LAMBDA_EXEC_WRAPPER=/opt/otel-handler` 、Pythonの場合は`AWS_LAMBDA_EXEC_WRAPPER=/opt/otel-instrument` を設定して、アプリケーションのエントリーポイントを変更します。 +これらのラッパースクリプトは、自動計装を適用したLambdaアプリケーションを起動します。 + +### 計装LambdaレイヤーのARNを追加する + +Lambda関数でOTelの自動計装を有効にするには、計装レイヤーとコレクターレイヤーを追加して設定し、トレースを有効にする必要があります。 + +1. AWSコンソールで、計装するLambda関数を開く。 +2. 「レイヤー」セクションで、「レイヤーの追加」を選択します。 +3. 「ARNを指定」でレイヤーのARNを貼り付け、「追加」を選択します。 + +あなたの言語の[最新の計装レイヤーリリース](https://github.com/open-telemetry/opentelemetry-lambda/releases)を見つけ、そのARNを使用します。 +``タグをあなたのラムダがあるリージョンに変更します。 + +注意: ラムダレイヤーはリージョンで分かれたリソースで、公開されているリージョンでのみ使用できます。Lambda関数と同じリージョンでレイヤーを使用するようにしてください。コミュニティは、利用可能なすべてのリージョンでレイヤーを公開しています。 + +### SDKのエクスポーターの設定 + +gRPC/HTTPレシーバーを持つコレクターが組み込まれている場合、Lambdaレイヤーで使用されるデフォルトのエクスポーターは変更なしで動作します。 +環境変数を更新する必要はありません。 +ただし、プロトコルのサポートレベルやデフォルト値は言語によって異なります。 + +{{< tabpane text=true >}} {{% tab Java %}} + +`OTEL_EXPORTER_OTLP_PROTOCOL=grpc` は `grpc`、`http/protobuf` および `http/json`、`OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317` をサポートします。 + +{{% /tab %}} {{% tab JavaScript %}} + +環境変数 `OTEL_EXPORTER_OTLP_PROTOCOL` はサポートされていません。ハードコードされたエクスポーターはプロトコル `http/protobuf` を使用します。`OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318` + +{{% /tab %}} {{% tab Python %}} + +`OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf` は `http/protobuf` と `http/json` 、`OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318` をサポートします。 + +{{% /tab %}} {{% tab Ruby %}} + +`OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf` は `http/protobuf` `OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318` をサポートします。 + +{{% /tab %}} {{< /tabpane >}} + +### あなたのLambdaを公開する + +Lambdaの新しいバージョンを公開して、新しい変更と計装をデプロイします。 + From 61dea8f9e33c1e24827b5507ff876deaa6dc9f29 Mon Sep 17 00:00:00 2001 From: Yoshi Yamaguchi Date: Wed, 12 Mar 2025 13:54:53 +0000 Subject: [PATCH 2/4] add platforms/faas/lambda-collector --- content/ja/docs/platforms/_index.md | 3 +- .../platforms/faas/lambda-auto-instrument.md | 4 +- .../docs/platforms/faas/lambda-collector.md | 156 ++++++++++++++++++ 3 files changed, 158 insertions(+), 5 deletions(-) create mode 100644 content/ja/docs/platforms/faas/lambda-collector.md diff --git a/content/ja/docs/platforms/_index.md b/content/ja/docs/platforms/_index.md index a901f4d863c9..52ad2fbd8893 100644 --- a/content/ja/docs/platforms/_index.md +++ b/content/ja/docs/platforms/_index.md @@ -1,8 +1,7 @@ --- title: プラットフォームと環境 linkTitle: プラットフォーム -description: - OpenTelemetryをサポートするハードウェアとソフトウェアのプラットフォームや環境 +description: OpenTelemetryをサポートするハードウェアとソフトウェアのプラットフォームや環境 weight: 260 default_lang_commit: 9ba98f4fded66ec78bfafa189ab2d15d66df2309 --- diff --git a/content/ja/docs/platforms/faas/lambda-auto-instrument.md b/content/ja/docs/platforms/faas/lambda-auto-instrument.md index 168d4c734c21..3610ec655006 100644 --- a/content/ja/docs/platforms/faas/lambda-auto-instrument.md +++ b/content/ja/docs/platforms/faas/lambda-auto-instrument.md @@ -40,8 +40,7 @@ Lambdaレイヤーは、Java 8, 11, 17 (Corretto) Lambdaランタイムをサポ - `OTEL_INSTRUMENTATION_COMMON_DEFAULT_ENABLED`: falseに設定すると、レイヤーの自動計装を無効にし、各計装を個別に有効にする必要があります。 - `OTEL_INSTRUMENTATION__ENABLED`: 特定のライブラリやフレームワークの自動計装を有効にするには true を設定します。``の部分を有効にしたい計装で置き換えます。利用可能な計装のリストについては、[特定のエージェントの計装を抑制する][1] を参照してください。 - [1]: - /docs/zero-code/java/agent/disable/#suppressing-specific-agent-instrumentation + [1]: /docs/zero-code/java/agent/disable/#suppressing-specific-agent-instrumentation たとえば、LambdaとAWS SDKの自動計装だけを有効にするには、以下の環境変数を設定します。 @@ -113,4 +112,3 @@ gRPC/HTTPレシーバーを持つコレクターが組み込まれている場 ### あなたのLambdaを公開する Lambdaの新しいバージョンを公開して、新しい変更と計装をデプロイします。 - diff --git a/content/ja/docs/platforms/faas/lambda-collector.md b/content/ja/docs/platforms/faas/lambda-collector.md new file mode 100644 index 000000000000..02b8750b3d52 --- /dev/null +++ b/content/ja/docs/platforms/faas/lambda-collector.md @@ -0,0 +1,156 @@ +--- +title: Lambdaコレクター設定 +linkTitle: Lambdaコレクター設定 +weight: 11 +description: コレクターLambdaレイヤーをあなたのLambdaに追加して設定する +cSpell:ignore: ADOT awsxray configmap confmap regionalized +default_lang_commit: 9ba98f4fded66ec78bfafa189ab2d15d66df2309 +--- + +OpenTelemetry コミュニティは、ユーザーに最大限の柔軟性を与えるために、コレクターを計装レイヤーとは別のLambdaレイヤーで提供しています。 +これは、計装とコレクターをバンドルしている現在の AWS Distribution of OpenTelemetry (ADOT) の実装とは異なります。 + +### OTelコレクターLambdaレイヤーのARNを追加する + +アプリケーションの計装が完了したら、コレクターLambdaレイヤーを追加してデータを収集し、選択したバックエンドに送信します。 + +[最新のコレクターレイヤーリリース](https://github.com/open-telemetry/opentelemetry-lambda/releases)を見つけ、そのARNを使用します。 +``タグをラムダがいるリージョンに変更します。 + +注意: ラムダレイヤーはリージョンで分かれたリソースであり、公開されているリージョンでのみ使用できます。Lambda関数と同じリージョンでレイヤーを使用するようにしてください。コミュニティは、利用可能なすべてのリージョンでレイヤーを公開しています。 + +### OTelコレクターの設定 + +OTelコレクターLambdaレイヤーの設定は、OpenTelemetry標準にしたがっています。 + +デフォルトでは、OTelコレクターLambdaレイヤーはconfig.yamlを使用します。 + +#### 希望するバックエンドの環境変数を設定する + +Lambda環境変数の設定で、認証トークンを格納する新しい変数を作成します。 + +#### デフォルトエクスポーターを更新する + +もしまだ存在していなければ、`config.yaml` ファイルに好みのエクスポーターを追加します。 +前のステップでアクセストークンのために設定した環境変数を使用して、エクスポーターを設定します。 + +**エクスポーターに環境変数が設定されていない場合、デフォルトの設定は、デバッグエクスポーターを使用したデータ送信のみをサポートします** +以下はデフォルトの設定です。 + +```yaml +receivers: + otlp: + protocols: + grpc: + endpoint: '0.0.0.0:4317' + http: + endpoint: '0.0.0.0:4318' + +exporters: + # 注意: v0.86.0 より前のバージョンでは、`debug` のかわりに `logging` を使用すること + debug: + verbosity: detailed + +service: + pipelines: + traces: + receivers: [otlp] + exporters: [debug] + metrics: + receivers: [otlp] + exporters: [debug] + telemetry: + metrics: + address: localhost:8888 +``` + +### Lambdaを公開する + +Lambdaの新しいバージョンをパブリッシュして、行った変更を有効にします。 + +### 高度な OTel コレクターの設定 + +カスタム構成でサポートされる利用可能なコンポーネントのリストは、こちらをご覧ください。 +デバッグを有効にするには、設定ファイルを使ってログレベルをデバッグに設定します。 +以下の例を参照してください。 + +#### 希望のConfmapプロバイダーを選択する + +OTel Lambdaレイヤーは `file`、`env`、`yaml`、`http`、`https`、`s3` といった種類の Confmap プロバイダーをサポートしています。 +異なる 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) を参照してください。 + +#### カスタム設定ファイルの作成 + +以下はルートディレクトリにある `collector.yaml` の設定ファイルのサンプルです。 + +```yaml +# ルート・ディレクトリの collector.yaml +# 環境変数 'OPENTELEMETRY_COLLECTOR_CONFIG_URI' を '/var/task/collector.yaml' に設定する + +receivers: + otlp: + protocols: + grpc: + endpoint: 'localhost:4317' + http: + endpoint: 'localhost:4318' + +exporters: + # 注意: v0.86.0 より前のバージョンでは `debug` のかわりに `logging` を使用すること + debug: + awsxray: + +service: + pipelines: + traces: + receivers: [otlp] + exporters: [awsxray] + metrics: + receivers: [otlp] + exporters: [debug] + telemetry: + metrics: + address: localhost:8888 +``` + +#### 環境変数を使ってカスタム設定ファイルをマップする + +confmapプロバイダーを通してコレクターを設定したら、Lambda関数に環境変数 `OPENTELEMETRY_COLLECTOR_CONFIG_URI` を作成し、その値としてconfmapプロバイダーの設定のパスを設定します。 +たとえば、ファイルconfigmapプロバイダーを使用している場合は、その値を `/var/task///` に設定します。 +これにより、拡張モジュールにコレクターの設定がどこにあるかを伝えます。 + +##### CLIを使用したカスタムコレクター設定 + +Lambdaコンソール、またはAWS CLIから設定できます。 + +```bash +aws lambda update-function-configuration --function-name Function --environment Variables={OPENTELEMETRY_COLLECTOR_CONFIG_URI=/var/task/collector.yaml} +``` + +##### CloudFormationから設定用の環境変数を設定する + +環境変数は**CloudFormation**テンプレートでも設定できます。 + +```yaml +Function: + Type: AWS::Serverless::Function + Properties: + ... + Environment: + Variables: + OPENTELEMETRY_COLLECTOR_CONFIG_URI: /var/task/collector.yaml +``` + +##### S3オブジェクトから設定を読み込む + +S3から設定を読み込むには、関数にアタッチされたIAMロールに、関連するバケットへの読み取りアクセスが含まれている必要があります。 + +```yaml +Function: + Type: AWS::Serverless::Function + Properties: + ... + Environment: + Variables: + OPENTELEMETRY_COLLECTOR_CONFIG_URI: s3://.s3..amazonaws.com/collector_config.yaml +``` From c379141e16f42317651c875dd3e081d043042305 Mon Sep 17 00:00:00 2001 From: Yoshi Yamaguchi Date: Wed, 12 Mar 2025 13:59:35 +0000 Subject: [PATCH 3/4] add platforms/lambda-manual-instrument --- .../platforms/faas/lambda-auto-instrument.md | 2 +- .../docs/platforms/faas/lambda-collector.md | 2 +- .../faas/lambda-manual-instrument.md | 23 +++++++++++++++++++ 3 files changed, 25 insertions(+), 2 deletions(-) create mode 100644 content/ja/docs/platforms/faas/lambda-manual-instrument.md diff --git a/content/ja/docs/platforms/faas/lambda-auto-instrument.md b/content/ja/docs/platforms/faas/lambda-auto-instrument.md index 3610ec655006..f4a1a82b5aac 100644 --- a/content/ja/docs/platforms/faas/lambda-auto-instrument.md +++ b/content/ja/docs/platforms/faas/lambda-auto-instrument.md @@ -2,8 +2,8 @@ title: Lambda 自動計装 weight: 11 description: あなたのLambdaをOpenTelemetryで自動的に計装する -cSpell:ignore: Corretto regionalized default_lang_commit: 9ba98f4fded66ec78bfafa189ab2d15d66df2309 +cSpell:ignore: Corretto --- OpenTelemetryコミュニティは、以下の言語用のスタンドアロン計装Lambdaレイヤーを提供しています。 diff --git a/content/ja/docs/platforms/faas/lambda-collector.md b/content/ja/docs/platforms/faas/lambda-collector.md index 02b8750b3d52..a97f330a0a3c 100644 --- a/content/ja/docs/platforms/faas/lambda-collector.md +++ b/content/ja/docs/platforms/faas/lambda-collector.md @@ -3,8 +3,8 @@ title: Lambdaコレクター設定 linkTitle: Lambdaコレクター設定 weight: 11 description: コレクターLambdaレイヤーをあなたのLambdaに追加して設定する -cSpell:ignore: ADOT awsxray configmap confmap regionalized default_lang_commit: 9ba98f4fded66ec78bfafa189ab2d15d66df2309 +cSpell:ignore: ADOT awsxray configmap confmap --- OpenTelemetry コミュニティは、ユーザーに最大限の柔軟性を与えるために、コレクターを計装レイヤーとは別のLambdaレイヤーで提供しています。 diff --git a/content/ja/docs/platforms/faas/lambda-manual-instrument.md b/content/ja/docs/platforms/faas/lambda-manual-instrument.md new file mode 100644 index 000000000000..cf01013dce96 --- /dev/null +++ b/content/ja/docs/platforms/faas/lambda-manual-instrument.md @@ -0,0 +1,23 @@ +--- +title: Lambdaの手動計装 +weight: 11 +description: OpenTelemetryであなたのLambdaを手動計装する +default_lang_commit: 9ba98f4fded66ec78bfafa189ab2d15d66df2309 +--- + +Lambdaの自動計装ドキュメントでカバーされていない言語については、コミュニティはスタンドアロンの計装レイヤーを持っていません。 + +ユーザーは、選択した言語の汎用計装ガイダンスにしたがい、コレクターLambdaレイヤーを追加してデータを送信する必要があります。 + +### OTelコレクターLambdaレイヤーのARNを追加する + +[コレクターLambdaレイヤーのガイダンス](../lambda-collector/)を参照して、アプリケーションにレイヤーを追加し、コレクターを設定してください。 +これを最初に追加することをおすすめします。 + +### LambdaをOTelで計装する + +アプリケーションを手動で計装する方法については、[各言語向け計装ガイド](/docs/languages/) を確認してください。 + +### Lambdaを公開する + +Lambdaの新しいバージョンを公開して、新しい変更と計装をデプロイします。 From 2b0169ad4d89e1f7a0379fc7b9863386a34bbdbc Mon Sep 17 00:00:00 2001 From: Yoshi Yamaguchi Date: Thu, 13 Mar 2025 01:13:51 +0000 Subject: [PATCH 4/4] add header IDs --- content/ja/docs/platforms/faas/_index.md | 2 +- .../platforms/faas/lambda-auto-instrument.md | 12 +++++----- .../docs/platforms/faas/lambda-collector.md | 24 +++++++++---------- .../faas/lambda-manual-instrument.md | 6 ++--- 4 files changed, 22 insertions(+), 22 deletions(-) diff --git a/content/ja/docs/platforms/faas/_index.md b/content/ja/docs/platforms/faas/_index.md index 894c451275e8..0223810cfe02 100644 --- a/content/ja/docs/platforms/faas/_index.md +++ b/content/ja/docs/platforms/faas/_index.md @@ -13,7 +13,7 @@ Functions as a Service（FaaS）は、[クラウドネイティブアプリ][clo FaaSドキュメントの最初のベンダー範囲は、Microsoft Azure、Google Cloud Platform（GCP）、Amazon Web Services（AWS）です。 AWSのファンクション（関数）はLambdaとしても知られています。 -### コミュニティアセット +### コミュニティアセット {#community-assets} 現在、OpenTelemetry コミュニティは、アプリケーションを自動計装することができるビルド済みの Lambda レイヤーと、アプリケーションを手動または自動で計装する際に使用できるスタンドアロンの Collector Lambda レイヤーを提供しています。 diff --git a/content/ja/docs/platforms/faas/lambda-auto-instrument.md b/content/ja/docs/platforms/faas/lambda-auto-instrument.md index f4a1a82b5aac..8e4586504966 100644 --- a/content/ja/docs/platforms/faas/lambda-auto-instrument.md +++ b/content/ja/docs/platforms/faas/lambda-auto-instrument.md @@ -16,12 +16,12 @@ OpenTelemetryコミュニティは、以下の言語用のスタンドアロン これらのレイヤーは、AWSポータルを使用してLambdaに追加し、アプリケーションを自動的に計装できます。 これらのレイヤーにはコレクターは含まれておらず、外部コレクターインスタンスを構成してデータを送信しない限り、追加する必要があります。 -### OTel Collector LambdaレイヤーのARNを追加する +### OTel Collector LambdaレイヤーのARNを追加する {#add-the-arn-of-the-otel-collector-lambda-layer} [Collector Lambdaレイヤーのガイダンス](../lambda-collector/)を参照して、アプリケーションにレイヤーを追加し、Collectorを設定してください。 これを最初に追加することをおすすめします。 -### 言語要件 +### 言語要件 {#language-requirements} {{< tabpane text=true >}} {{% tab Java %}} @@ -67,12 +67,12 @@ Lambda レイヤーは、Ruby 3.2 と 3.3 の Lambda ランタイムをサポー {{% /tab %}} {{< /tabpane >}} -### `AWS_LAMBDA_EXEC_WRAPPER` を設定する +### `AWS_LAMBDA_EXEC_WRAPPER` を設定する {#configure-aws_lambda_exec_wrapper} Node.js、Java、Rubyの場合は `AWS_LAMBDA_EXEC_WRAPPER=/opt/otel-handler` 、Pythonの場合は`AWS_LAMBDA_EXEC_WRAPPER=/opt/otel-instrument` を設定して、アプリケーションのエントリーポイントを変更します。 これらのラッパースクリプトは、自動計装を適用したLambdaアプリケーションを起動します。 -### 計装LambdaレイヤーのARNを追加する +### 計装LambdaレイヤーのARNを追加する {#add-the-arn-of-instrumentation-lambda-layer} Lambda関数でOTelの自動計装を有効にするには、計装レイヤーとコレクターレイヤーを追加して設定し、トレースを有効にする必要があります。 @@ -85,7 +85,7 @@ Lambda関数でOTelの自動計装を有効にするには、計装レイヤー 注意: ラムダレイヤーはリージョンで分かれたリソースで、公開されているリージョンでのみ使用できます。Lambda関数と同じリージョンでレイヤーを使用するようにしてください。コミュニティは、利用可能なすべてのリージョンでレイヤーを公開しています。 -### SDKのエクスポーターの設定 +### SDKのエクスポーターの設定 {#configure-your-sdk-exporters} gRPC/HTTPレシーバーを持つコレクターが組み込まれている場合、Lambdaレイヤーで使用されるデフォルトのエクスポーターは変更なしで動作します。 環境変数を更新する必要はありません。 @@ -109,6 +109,6 @@ gRPC/HTTPレシーバーを持つコレクターが組み込まれている場 {{% /tab %}} {{< /tabpane >}} -### あなたのLambdaを公開する +### Lambdaを公開する {#publish-your-lambda} Lambdaの新しいバージョンを公開して、新しい変更と計装をデプロイします。 diff --git a/content/ja/docs/platforms/faas/lambda-collector.md b/content/ja/docs/platforms/faas/lambda-collector.md index a97f330a0a3c..d1787d00824c 100644 --- a/content/ja/docs/platforms/faas/lambda-collector.md +++ b/content/ja/docs/platforms/faas/lambda-collector.md @@ -10,7 +10,7 @@ cSpell:ignore: ADOT awsxray configmap confmap OpenTelemetry コミュニティは、ユーザーに最大限の柔軟性を与えるために、コレクターを計装レイヤーとは別のLambdaレイヤーで提供しています。 これは、計装とコレクターをバンドルしている現在の AWS Distribution of OpenTelemetry (ADOT) の実装とは異なります。 -### OTelコレクターLambdaレイヤーのARNを追加する +### OTelコレクターLambdaレイヤーのARNを追加する {#add-the-arn-of-the-otel-collector-lambda-layer} アプリケーションの計装が完了したら、コレクターLambdaレイヤーを追加してデータを収集し、選択したバックエンドに送信します。 @@ -19,17 +19,17 @@ OpenTelemetry コミュニティは、ユーザーに最大限の柔軟性を与 注意: ラムダレイヤーはリージョンで分かれたリソースであり、公開されているリージョンでのみ使用できます。Lambda関数と同じリージョンでレイヤーを使用するようにしてください。コミュニティは、利用可能なすべてのリージョンでレイヤーを公開しています。 -### OTelコレクターの設定 +### OTelコレクターの設定 {#configure-the-otel-collector} OTelコレクターLambdaレイヤーの設定は、OpenTelemetry標準にしたがっています。 デフォルトでは、OTelコレクターLambdaレイヤーはconfig.yamlを使用します。 -#### 希望するバックエンドの環境変数を設定する +#### 希望するバックエンドの環境変数を設定する {#set-the-environment-variable-for-your-preferred-backend} Lambda環境変数の設定で、認証トークンを格納する新しい変数を作成します。 -#### デフォルトエクスポーターを更新する +#### デフォルトエクスポーターを更新する {#update-the-default-exporters} もしまだ存在していなければ、`config.yaml` ファイルに好みのエクスポーターを追加します。 前のステップでアクセストークンのために設定した環境変数を使用して、エクスポーターを設定します。 @@ -64,22 +64,22 @@ service: address: localhost:8888 ``` -### Lambdaを公開する +### Lambdaを公開する {#publish-your-lambda} Lambdaの新しいバージョンをパブリッシュして、行った変更を有効にします。 -### 高度な OTel コレクターの設定 +### 高度な OTel コレクターの設定 {#advanced-otel-collector-configuration} カスタム構成でサポートされる利用可能なコンポーネントのリストは、こちらをご覧ください。 デバッグを有効にするには、設定ファイルを使ってログレベルをデバッグに設定します。 以下の例を参照してください。 -#### 希望のConfmapプロバイダーを選択する +#### 希望のConfmapプロバイダーを選択する {#choose-your-preferred-confmap-provider} OTel Lambdaレイヤーは `file`、`env`、`yaml`、`http`、`https`、`s3` といった種類の Confmap プロバイダーをサポートしています。 異なる 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) を参照してください。 -#### カスタム設定ファイルの作成 +#### カスタム設定ファイルの作成 {#create-a-custom-configuration-file} 以下はルートディレクトリにある `collector.yaml` の設定ファイルのサンプルです。 @@ -113,13 +113,13 @@ service: address: localhost:8888 ``` -#### 環境変数を使ってカスタム設定ファイルをマップする +#### 環境変数を使ってカスタム設定ファイルをマップする {#map-your-custom-configuration-file-using-environment-variables} confmapプロバイダーを通してコレクターを設定したら、Lambda関数に環境変数 `OPENTELEMETRY_COLLECTOR_CONFIG_URI` を作成し、その値としてconfmapプロバイダーの設定のパスを設定します。 たとえば、ファイルconfigmapプロバイダーを使用している場合は、その値を `/var/task///` に設定します。 これにより、拡張モジュールにコレクターの設定がどこにあるかを伝えます。 -##### CLIを使用したカスタムコレクター設定 +##### CLIを使用したカスタムコレクター設定 {#custom-collector-configuration-using-the-cli} Lambdaコンソール、またはAWS CLIから設定できます。 @@ -127,7 +127,7 @@ Lambdaコンソール、またはAWS CLIから設定できます。 aws lambda update-function-configuration --function-name Function --environment Variables={OPENTELEMETRY_COLLECTOR_CONFIG_URI=/var/task/collector.yaml} ``` -##### CloudFormationから設定用の環境変数を設定する +##### CloudFormationから設定用の環境変数を設定する {#set-configuration-environment-variables-from-cloudformation} 環境変数は**CloudFormation**テンプレートでも設定できます。 @@ -141,7 +141,7 @@ Function: OPENTELEMETRY_COLLECTOR_CONFIG_URI: /var/task/collector.yaml ``` -##### S3オブジェクトから設定を読み込む +##### S3オブジェクトから設定を読み込む {#load-configuration-from-an-s3-object} S3から設定を読み込むには、関数にアタッチされたIAMロールに、関連するバケットへの読み取りアクセスが含まれている必要があります。 diff --git a/content/ja/docs/platforms/faas/lambda-manual-instrument.md b/content/ja/docs/platforms/faas/lambda-manual-instrument.md index cf01013dce96..8c9612145db3 100644 --- a/content/ja/docs/platforms/faas/lambda-manual-instrument.md +++ b/content/ja/docs/platforms/faas/lambda-manual-instrument.md @@ -9,15 +9,15 @@ Lambdaの自動計装ドキュメントでカバーされていない言語に ユーザーは、選択した言語の汎用計装ガイダンスにしたがい、コレクターLambdaレイヤーを追加してデータを送信する必要があります。 -### OTelコレクターLambdaレイヤーのARNを追加する +### OTelコレクターLambdaレイヤーのARNを追加する {#add-the-arn-of-the-otel-collector-lambda-layer} [コレクターLambdaレイヤーのガイダンス](../lambda-collector/)を参照して、アプリケーションにレイヤーを追加し、コレクターを設定してください。 これを最初に追加することをおすすめします。 -### LambdaをOTelで計装する +### LambdaをOTelで計装する {#instrument-the-lambda-with-otel} アプリケーションを手動で計装する方法については、[各言語向け計装ガイド](/docs/languages/) を確認してください。 -### Lambdaを公開する +### Lambdaを公開する {#publish-your-lambda} Lambdaの新しいバージョンを公開して、新しい変更と計装をデプロイします。