支援的系統

Application Signals 在 Amazon EKS、原生 Kubernetes、Amazon ECS 及 Amazon EC2 平台上受到支援，並且經過測試。在 Amazon EC2 上啟用 Application Signals 的指示應適用於支援 CloudWatch 代理程式和 AWS Distro for OpenTelemetry 的任何平台。

Java 相容性

Application Signals 支援 Java 應用程式，支援的 Java 庫和框架與 AWS Distro for OpenTelemetry 所支援的一樣。如需詳細資訊，請參閱支援的程式庫、架構、應用程式伺服器和 JVM。

.NET 相容性

Application Signals 支援的 .NET 庫和框架與 AWS Distro for OpenTelemetry 所支援的一樣。如需更多詳細資訊，請參閱 Supported instrumentations。

Application Signals 支援在 x86-64 或 ARM64 CPU 上執行的 .NET 應用程式，並支援 Linux x64、Linux ARM64 和 Microsoft Windows Server 2022 x64。

PHP 相容性

Application Signals 支援具備 OpenTelemetry 零代碼檢測功能的 PHP 應用程式。沒有可用於此用途的 AWS Distro for Open Telemetry (ADOT) SDK。應該使用啟用 Transaction Search 的標準 OpenTelemetry 檢測 SDK。若要在 PHP 中開始使用零代碼檢測功能，請依循 OpenTelemetry PHP Instrumentation 文件 PHP 零程式碼檢測中的步驟。自動檢測適用於眾多常用的 PHP 程式庫。如需詳細資訊，請參閱 OpenTelemetry 登錄檔。

Ruby 相容性

Application Signals 支援具備 OpenTelemetry 零代碼檢測功能的 Ruby 應用程式。沒有可用於此用途的 AWS Distro for Open Telemetry (ADOT) SDK。應該使用啟用 Transaction Search 的標準 OpenTelemetry 檢測 SDK。若要在 Ruby 中開始使用零代碼檢測功能，請依循 OpenTelemetry Ruby Instrumentation 文件 Ruby 零程式碼檢測中的步驟。如需已發行檢測程式庫的清單，請參閱登錄檔。

Python 相容性

Application Signals 支援的程式庫和框架與 AWS Distro for OpenTelemetry 所支援的一樣。如需詳細資訊，請參閱 opentelemetry-python-contrib 中的支援的套件。

在為 Python 應用程式啟用 Application Signals 之前，請注意下列考量。

Node.js 相容性

Application Signals 支援的 Node.js 庫和框架與 AWS Distro for OpenTelemetry 所支援的一樣。如需更多詳細資訊，請參閱 Supported instrumentations。

Node.js 搭配使用 ESM 的已知限制

AWS Distro for Opentelemetry Node.js 支援兩個模組系統：ECMAScript Modules (ESM) 和 CommonJS (CJS)。若要啟用 Application Signals，我們建議您使用 CJS 模組格式，因為 OpenTelemetry JavaScript 對 ESM 的支援目前仍處於實驗階段且持續開發中。如需詳細資訊，請參閱 GitHub 上的 ECMAScript 模組與 CommonJS。

若要確定您的應用程式使用的是 CJS 而非 ESM，請確保您的應用程式不符合啟用 ESM 的條件。如需這些條件的詳細資訊，請參閱 Node.js 文件中的啟用。

AWS Distro for Opentelemetry Node.js 基於 OpenTelemetry JavaScript 對 ESM 的實驗性支援，提供有限的 ESM 支援。這表示：

為使用 Node.js ESM 模組格式啟用 Application Signals，我們為不同平台提供不同設定：

GoLang 相容性

Application Signals 支援具備 OpenTelemetry 零代碼檢測功能的 GoLang 應用程式。沒有可用於此用途的 AWS Distro for Open Telemetry (ADOT) SDK。應該使用啟用 Transaction Search 的標準 OpenTelemetry 檢測 SDK。若要在 GoLang 中開始使用零程式碼檢測功能，請依循 OpenTelemetry GoLang 檢測文件《開始使用 OpenTelemetry Go 自動檢測功能》中的下列步驟。

GoLang 檢測實作考量

了解使用 GoLang 檢測的重要實作詳細資訊。本指南說明如何在 GoLang 應用程式中實作明確的內容傳播機制，並設定 Application Signals。正確實作 GoLang 檢測有助於有效追蹤和分析應用程式的效能。

檢測 AWS SDK

Golang 自動檢測程式庫預設狀態下並不支援 AWS SDK 檢測。必須搭配自動檢測代理程式使用 otelaws 程式庫檢測：

下列範例將產生 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
}

如需設定自動檢測可執行檔的資訊，請參閱組態方法。

檢測 HTTP 呼叫

當請求之間未傳遞內容時，HTTP 呼叫可以分割追蹤：HTTP 用戶端必須使用 NewRequestWithContext()，而不是 NewRequest()，以確保下游服務使用相同的內容。當這兩個服務都有檢測代理程式時，範圍將透過同個追蹤 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 呼叫替換為其內容感知對等項目：

這些方法會將上游請求內容傳遞至資料庫呼叫，以維持適當的追蹤持續性。

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
}

資源偵測器

Go 自動檢測功能目前不支援在執行時期設定資源偵測器。OpenTelemetry 社群正在開發使用環境變數設定資源偵測器的功能。我們將在未來的更新中提供此功能。同時，可以使用 CloudWatch 代理程式搭配自動檢測功能來自動產生主機資源屬性。

執行時期版本支援矩陣

已知問題

已知 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 中已修正此問題。

如果您受到影響，請將環境變數 OTEL_AWS_APPLICATION_SIGNALS_RUNTIME_ENABLED=false 新增至您的應用程式，以升級 Java SDK 版本或停用執行時期指標收集。