# サポートされているシステム
Application Signals は、Amazon EKS、ネイティブ Kubernetes、Amazon ECS、および Amazon EC2 でサポートされ、テストされています。Amazon EC2 で Application Signals を有効にする手順は、CloudWatch エージェントと AWS Distro for OpenTelemetry をサポートするすべてのプラットフォームに適用されます。
**Topics**
+ [Java の互換性](#CloudWatch-Application-Signals-supportmatrix-java)
+ [.NET の互換性](#CloudWatch-Application-Signals-supportmatrix-dotnet)
+ [PHP の互換性](#php-compatibility)
+ [Ruby の互換性](#ruby-compatibility)
+ [Python の互換性](#CloudWatch-Application-Signals-supportmatrix-python)
+ [Node.js の互換性](#CloudWatch-Application-Signals-supportmatrix-node)
+ [GoLang の互換性](#golang-compatibility)
+ [ランタイムバージョンのサポートマトリックス](#rumtime-version-matix)
+ [既知の問題](#AppSignals-Issues)
## Java の互換性
Application Signals は Java アプリケーションをサポートしていますが、AWS Distro for OpenTelemetry と同じ Java ライブラリとフレームワークもサポートしています。詳細については、「[Supported libraries, frameworks, application servers, and JVMs](https://github.com/open-telemetry/opentelemetry-java-instrumentation/blob/main/docs/supported-libraries.md)」を参照してください。
## .NET の互換性
Application Signals は、AWS Distro for OpenTelemetry と同じ .NET ライブラリとフレームワークをサポートしています。詳細については、「[Supported instrumentations](https://github.com/open-telemetry/opentelemetry-dotnet-instrumentation/blob/main/docs/internal/instrumentation-libraries.md)」を参照してください。
Application Signals は、x86-64 CPU または ARM64 CPU で実行されている .NET アプリケーションに加え、Linux x64、Linux ARM64、および Microsoft Windows Server 2022 x64 をサポートしています。
**注記**
AWS Distro for Open Telemetry (ADOT) SDK for .NET は AWS SDK for .NET V4 をサポートしていません。Application Signals を完全にサポートするには、AWS SDK .NET V3 を使用します。
## PHP の互換性
Application Signals は、OpenTelemetry ゼロコード計測による PHP アプリケーションをサポートしています。この目的で使用できる AWS Distro for Open Telemetry (ADOT) SDK はありません。[トランザクション検索](AmazonCloudWatch/latest/monitoring/CloudWatch-Transaction-Search.html)を有効にした標準の OpenTelemetry Instrumentation SDK を使用する必要があります。PHP でゼロコード計測の使用を開始するには、OpenTelemetry PHP 計測ドキュメントの「[PHP zero-code instrumentation](https://opentelemetry.io/docs/zero-code/php/)」の手順に従ってください。自動計測は、一般的に使用される多くの PHP ライブラリで使用できます。詳細については、「[OpenTelemetry registry](https://packagist.org/search/?query=open-telemetry%3Dinstrumentation)」を参照してください。
## Ruby の互換性
Application Signals は、OpenTelemetry ゼロコード計測を使用した Ruby アプリケーションをサポートしています。この目的で使用できる AWS Distro for Open Telemetry (ADOT) SDK はありません。[トランザクション検索](AmazonCloudWatch/latest/monitoring/CloudWatch-Transaction-Search.html)を有効にした標準の OpenTelemetry Instrumentation SDK を使用する必要があります。Ruby でゼロコード計測の使用を開始するには、OpenTelemetry Ruby Instrumentation ドキュメントの「[計装](https://opentelemetry.io/docs/languages/ruby/getting-started/#instrumentation)」の手順に従ってください。リリースされた計測ライブラリのリストについては、「[Registry](https://opentelemetry.io/ecosystem/registry/?language=rubycomponent=instrumentation)」を参照してください。
## Python の互換性
Application Signals は、AWS Distro for OpenTelemetry と同じライブラリとフレームワークをサポートしています。詳細については、[opentelemetry-python-contrib](https://github.com/open-telemetry/opentelemetry-python-contrib/blob/main/instrumentation/README.md) の「**サポート対象パッケージ**」を参照してください。
Python アプリケーションの Application Signals を有効にする前に、以下の考慮事項に注意してください。
+ コンテナ化されたアプリケーションの一部は、`PYTHONPATH` 環境変数がないことが原因でアプリケーションが起動しなくなることがあります。これを解決するには、`PYTHONPATH` 環境変数をアプリケーションの作業ディレクトリの場所に設定します。これは OpenTelemetry の自動計測に関する既知の問題によるものです。この問題の詳細については、「[Python autoinstrumentation setting of PYTHONPATH is not compliant](https://github.com/open-telemetry/opentelemetry-operator/issues/2302)」を参照してください。
+ Django アプリケーションには、[OpenTelemetry Python ドキュメント](https://opentelemetry-python.readthedocs.io/en/latest/examples/django/README.html)で概説されている追加の必須設定があります。
+ `--noreload` フラグを使用すると、自動リロードを防ぐことができます。
+ Django アプリケーションの `settings.py` ファイルの場所に `DJANGO_SETTINGS_MODULE` 環境変数を設定します。これにより、OpenTelemetry がユーザーの Django 設定に正しくアクセスして統合できるようになります。
## Node.js の互換性
Application Signals は、AWS Distro for OpenTelemetry と同じ Node.js ライブラリとフレームワークをサポートしています。詳細については、「[Supported instrumentations](https://github.com/open-telemetry/opentelemetry-js-contrib/tree/main)」を参照してください。
### EMS を使用する ENode.js における既知の制限事項
AWS Distro for Opentelemetry Node.js は、ECMAScript Modules (ESM) と CommonJS (CJS) の 2 つのモジュールシステムをサポートしています。OpenTelemetry JavaScript による ESM のサポートは実験的であり、現在開発中であるため、Application Signals を有効にするには、CJS モジュール形式を使用することをお勧めします。詳細については、GitHub の「[ECMAScript Modules vs. CommonJS](https://github.com/open-telemetry/opentelemetry-js/blob/eb3ca4fb07ee31c62093f5fcec56575573c902ce/doc/esm-support.md)」を参照してください。
お使いのアプリケーションで ESM ではなく CJS を使用しているかどうかは、アプリケーションが ESM を有効にするための条件を満たしていないことを確認することで判断できます。これらのコマンドの詳細については、Node.js ドキュメントの「[Enabling](https://nodejs.org/api/esm.html#enabling)」を参照してください。
AWS Distro for Opentelemetry Node.js は、OpenTelemetry JavaScript の ESM の実験サポートに基づいて、ESM の限定的なサポートを提供します。これは以下を意味します。
+ Node.js のバージョンは 18.19.0 以降である必要があります。
+ インストルメントする Node.js アプリケーションには、`@aws/aws-distro-opentelemetry-node-autoinstrumentation` と `@opentelemetry/instrumentation` を依存関係として含める必要があります。
+ この Node.js アプリケーションは、次のノードオプションで開始する必要があります。
```
NODE_OPTIONS=' --import @aws/aws-distro-opentelemetry-node-autoinstrumentation/register --experimental-loader=@opentelemetry/instrumentation/hook.mjs'
```
Node.js ESM モジュール形式で Application Signals を有効にするにあたって、プラットフォームごとに異なるセットアップが提供されています。
+ **Amazon EKS** – [ESM モジュール形式を使用する Node.js アプリケーションをセットアップする](CloudWatch-Application-Signals-Enable-EKS.md#EKS-NodeJs-ESM)
+ **Amazon ECS でのサイドカー戦略** – [Setting up a Node.js application with the ESM module format](CloudWatch-Application-Signals-ECS-Sidecar.md#ECS-NodeJs-ESM)
+ **Amazon ECS でのデーモン戦略** – [Setting up a Node.js application with the ESM module format](CloudWatch-Application-Signals-ECS-Daemon.md#ECSDaemon-NodeJs-ESM)
+ **Amazon ECS での AWS CDK**
+ **Amazon EC2** – [Setting up a Node.js application with the ESM module format](CloudWatch-Application-Signals-Enable-EC2Main.md#EC2-NodeJs-ESM)
+ **Kubernetes** – [ESM モジュール形式を使用する Node.js アプリケーションをセットアップする](CloudWatch-Application-Signals-Enable-KubernetesMain.md#Kubernetes-NodeJs-ESM)
## GoLang の互換性
Application Signals は、OpenTelemetry ゼロコード計測を備えた GoLang アプリケーションをサポートしています。この目的で使用できる AWS Distro for Open Telemetry (ADOT) SDK はありません。[トランザクション検索](AmazonCloudWatch/latest/monitoring/CloudWatch-Transaction-Search.html)を有効にした標準の OpenTelemetry Instrumentation SDK を使用する必要があります。GoLang でゼロコード計測の使用を開始するには、OpenTelemetry GoLang 計測ドキュメントの「[Getting Started with OpenTelemetry Go Automatic Instrumentation](https://github.com/open-telemetry/opentelemetry-go-instrumentation/blob/main/docs/getting-started.md)」の手順に従ってください。
### 実装に関する考慮事項 GoLang 計測
GoLang 計測を使用するための実装に関する重要な詳細について説明します。このガイダンスでは、GoLang アプリケーションで明示的なコンテキスト伝達を実装し、Application Signals を設定する方法について説明します。GoLang 計測を適切に実装することで、アプリケーションのパフォーマンスを効果的に追跡および分析できます。
#### AWS SDK の計測
Golang 自動計測ライブラリは、AWS SDK 計測を標準ではサポートしていません。自動計測エージェントと共に `otelaws` ライブラリ計測を使用する必要があります。
1. 必要な依存関係をインストールします。
```
go get go.opentelemetry.io/contrib/instrumentation/github.com/aws/aws-sdk-go-v2/otelaws
```
1. アプリケーションに以下の行を追加します。
```
otelaws.AppendMiddlewares(&cfg.APIOptions)
```
1. 前の `aws.Config` オブジェクトを使用して後続の AWS クライアントを作成します。
```
s3Client := s3.NewFromConfig(cfg)
```
以下の例では、AWS 呼び出しのスパンを生成し、自動計測と統合します。
```
func handleRequest(ctx context.Context) error {
cfg, err := config.LoadDefaultConfig(ctx)
if err != nil {
return err
}
// Add OpenTelemetry instrumentation middleware to the AWS config
otelaws.AppendMiddlewares(&cfg.APIOptions)
// Create S3 client with the instrumented config
s3Client := s3.NewFromConfig(cfg)
// Now any operations with this client will be traced
// with the context from the upstream call
_, err = s3Client.ListBuckets(ctx, &s3.ListBucketsInput{})
return err
}
```
自動計測実行可能ファイルの設定については、「[Configuration methods](https://github.com/open-telemetry/opentelemetry-go-instrumentation/blob/main/docs/configuration.md)」を参照してください。
#### HTTP 呼び出しの計測
HTTP 呼び出しは、リクエスト間でコンテキストが渡されない場合にトレースを分割できます。HTTP クライアントは `NewRequest()` の代わりに `NewRequestWithContext()` を使用して、ダウンストリームサービスでも同じコンテキストが使用されるようにする必要があります。両方のサービスに計測エージェントがある場合、スパンは同じトレース ID で接続し、エンドツーエンドの可視性を提供します。
```
func makeDownstreamCall(ctx context.Context, url string) ([]byte, error) {
client := &http.Client{}
// Create request with context from the upstream call
req, err := http.NewRequestWithContext(ctx, http.MethodGet, url, nil)
if err != nil {
return nil, err
}
// Execute the request
resp, err := client.Do(req)
if err != nil {
return nil, err
}
defer resp.Body.Close()
}
```
#### SQL 呼び出しの計測
SQL スパンが親スパンから切断され、クライアント呼び出しがサーバースパンとして推測される可能性があります。これは、SQL 呼び出しがアップストリームハンドラーからコンテキストを受信しない場合に発生します。`Query` や `Exec` などの標準 SQL 呼び出しは、アップストリーム呼び出し元のコンテキストではなく、デフォルトで `context.Background()` を使用します。標準 SQL 呼び出しをコンテキスト対応の同等のものに置き換えます。
+ `Query` の代わりに `QueryContext` を使用する
+ `Exec` の代わりに `ExecContext` を使用する
これらの方法は、アップストリームリクエストコンテキストを DB 呼び出しに渡し、適切なトレース継続性を維持します。
```
func queryDatabase(ctx context.Context, db *sql.DB, userID string) (*sql.Rows, error) {
// This breaks the trace context
// row := db.Query("SELECT name FROM users WHERE id = $1", userID)
// This passes the context from the upstream call for trace continuity
rows, err := db.QueryContext(ctx, "SELECT name FROM users WHERE id = $1", userID)
return rows, error
}
```
**注記**
`db.system` 属性は現在、SQL 呼び出しではサポートされていません。この制限は、CloudWatch がデータベースクライアントを正確に識別する能力に影響します。その結果、依存関係には、クエリを実行する DB クライアントの名前の代わりに **UnknownRemoteService** が表示されます。
#### リソースディテクター
Go 自動計測は現在、ランタイム時のリソースディテクターの設定をサポートしていません。OpenTelemetry コミュニティは、環境変数を使用してリソースディテクターを設定する機能に取り組んでいます。この機能は今後の更新で提供される予定です。その間、自動計測で CloudWatch エージェントを使用して、ホストリソース属性を自動的に生成できます。
## ランタイムバージョンのサポートマトリックス
| Language | ランタイムバージョン |
| --- | --- |
| Java | JVM バージョン 8、11、17、21、23 |
| Python | Python バージョン 3.9 以降がサポートされています |
| .NET | リリース 1.6.0 以前では、.NET 6、8、および .NET Framework 4.6.2 以降がサポートされます リリース 1.7.0 以降では、.NET 8、9、および .NET Framework 4.6.2 以降がサポートされます |
| Node.js | Node.js バージョン 14、16、18、20、22 |
| PHP | PHP バージョン 8.0 以降 |
| Ruby | CRuby >= 3.1、JRuby >= 9.3.2.0、または TruffleRuby >= 22.1 |
| GoLang | Golang バージョン 1.18 以降 |
## 既知の問題
Java SDK リリース v1.32.5 のランタイムメトリクスコレクションは、JBoss Wildfly を使用するアプリケーションで動作しないことが知られています。この問題は Amazon CloudWatch Observability EKS アドオンに及び、`2.3.0-eksbuild.1` から `2.6.0-eksbuild.1` までのバージョンに影響します。この問題は、Java SDK リリース `v1.32.6` と Amazon CloudWatch Observability EKS アドオンバージョン `v3.0.0-eksbuild.1` で修正されています。
影響を受けた場合、Java SDK のバージョンをアップグレードするか、アプリケーションに `OTEL_AWS_APPLICATION_SIGNALS_RUNTIME_ENABLED=false` 環境変数を追加してランタイムメトリクス収集を無効にします。