Sistem yang didukung

Sinyal Aplikasi didukung dan diuji di Amazon EKS, Kubernetes asli, Amazon ECS, dan Amazon. EC2 Petunjuk untuk mengaktifkan Sinyal Aplikasi di Amazon EC2 harus berfungsi pada platform apa pun yang mendukung CloudWatch agen dan AWS Distro OpenTelemetry, tetapi instruksinya belum diuji pada platform lain.

Kompatibilitas Java

Application Signals mendukung aplikasi Java, dan mendukung pustaka dan kerangka kerja Java yang sama seperti yang dilakukan AWS Distro. OpenTelemetry Untuk informasi selengkapnya, lihat Pustaka, kerangka kerja, server aplikasi yang didukung, dan. JVMs

JVM versi 8, 11, 17, 21, dan 23 didukung.

Kompatibilitas Python

Kompatibilitas Python

Application Signals mendukung pustaka dan kerangka kerja yang sama seperti yang dilakukan oleh AWS Distro. OpenTelemetry Untuk informasi selengkapnya, lihat Paket yang didukung di opentelemetry-python-contrib.

Python versi 3.8 dan yang lebih baru didukung.

Sebelum Anda mengaktifkan Sinyal Aplikasi untuk aplikasi Python Anda, perhatikan pertimbangan berikut.

• Dalam beberapa aplikasi kontainer, variabel PYTHONPATH lingkungan yang hilang terkadang dapat menyebabkan aplikasi gagal memulai. Untuk mengatasi hal ini, pastikan Anda menyetel variabel PYTHONPATH lingkungan ke lokasi direktori kerja aplikasi Anda. Ini karena masalah yang diketahui dengan OpenTelemetry instrumentasi otomatis. Untuk informasi selengkapnya tentang masalah ini, lihat Pengaturan autoinstrumentasi Python dari PYTHONPATH tidak sesuai.

• Untuk aplikasi Django, ada konfigurasi tambahan yang diperlukan, yang diuraikan dalam dokumentasi Python OpenTelemetry .

  • Gunakan --noreload bendera untuk mencegah pemuatan ulang otomatis.

  • Tetapkan variabel DJANGO_SETTINGS_MODULE lingkungan ke lokasi settings.py berkas aplikasi Django Anda. Ini memastikan bahwa OpenTelemetry dapat mengakses dan mengintegrasikan dengan benar dengan pengaturan Django Anda.

Kompatibilitas .NET

Application Signals mendukung aplikasi.NET dengan instrumentasi AWS Distro for Open Telemetry (ADOT) di Amazon EKS, Amazon, Amazon ECS dan Kubernetes yang berjalan di EC2 Amazon. EC2

Rilis ini mendukung .NET 8, 9, dan .NET Framework 4.6.2 dan yang lebih tinggi.

catatan

Versi 1.7.0 dari AWS Distro untuk OpenTelemetry SDK adalah versi terakhir yang mendukung .NET 6. Setiap versi baru dari .NET 6 tidak didukung.

Application Signals mendukung aplikasi.NET yang berjalan pada x86-64 atau ARM64 CPUs, dan mendukung sistem operasi Linux x64, Linux, ARM64 Microsoft Windows Server 2022 x64, dan Microsoft Windows Server 2019 x64.

Kompatibilitas Node.js

Application Signals mendukung pustaka dan kerangka kerja Node.js yang sama seperti yang dilakukan oleh AWS Distro. OpenTelemetry Untuk informasi selengkapnya, lihat Instrumentasi yang didukung.

Rilis ini mendukung Node.js versi 14, 16, 18, 20, dan 22.

Keterbatasan yang diketahui tentang Node.js dengan ESM

AWS Distro untuk Opentelemetry Node.js mendukung dua sistem modul: ECMAScript Modul (ESM) dan CommonJS (CJS). Untuk mengaktifkan Sinyal Aplikasi, kami sarankan Anda menggunakan format modul CJS karena OpenTelemetry JavaScript dukungan ESM bersifat eksperimental dan pekerjaan sedang berlangsung. Untuk detail selengkapnya, lihat ECMAScript Modul vs CommonJS di. GitHub

Untuk menentukan apakah aplikasi Anda menggunakan CJS dan bukan ESM, pastikan bahwa aplikasi Anda tidak memenuhi persyaratan untuk mengaktifkan ESM. Untuk informasi selengkapnya tentang kondisi ini, lihat Mengaktifkan dalam dokumentasi Node.js.

AWS Distro untuk Opentelemetry Node.js menyediakan dukungan terbatas untuk ESM berdasarkan dukungan eksperimental untuk ESM OpenTelemetry JavaScript. Ini berarti sebagai berikut:

• Versi Node.js harus 18.19.0 atau yang lebih baru.

• Aplikasi Node.js yang ingin Anda instrumen harus menyertakan @aws/aws-distro-opentelemetry-node-autoinstrumentation dan @opentelemetry/instrumentation sebagai dependensi.

• Aplikasi Node.js yang ingin Anda instrumen harus dimulai dengan opsi node berikut:

  NODE_OPTIONS=' --import @aws/aws-distro-opentelemetry-node-autoinstrumentation/register --experimental-loader=@opentelemetry/instrumentation/hook.mjs'

Untuk mengaktifkan Sinyal Aplikasi dengan format modul ESM Node.js, kami menyediakan pengaturan yang berbeda untuk platform yang berbeda:

• Amazon EKS — Menyiapkan aplikasi Node.js dengan format modul ESM

• Amazon ECS dengan strategi sespan - Setting up a Node.js application with the ESM module format

• Amazon ECS dengan strategi daemon - Setting up a Node.js application with the ESM module format

• Amazon ECS dengan AWS CDK

• Amazon EC2 — Setting up a Node.js application with the ESM module format

• Kubernetes — Menyiapkan aplikasi Node.js dengan format modul ESM

OpenTelemetry kompatibilitas

CloudWatch Sinyal Aplikasi sepenuhnya kompatibel denganOpenTelemetry. Untuk informasi tentang cara memulai, lihat OpenTelemetry dengan CloudWatch. Jika Anda menginginkan pengalaman yang lebih terintegrasi, seperti menggunakan CloudWatch Agen dengan AWS Distro for OpenTelemetry (ADOT) SDKs, lihat Memulai Sinyal Aplikasi untuk menemukan metode konfigurasi pilihan Anda.

Masalah yang diketahui

Koleksi metrik runtime dalam rilis Java SDK v1.32.5 diketahui tidak berfungsi dengan aplikasi yang menggunakan Wildfly. JBoss Masalah ini meluas ke add-on Amazon CloudWatch Observability EKS, memengaruhi versi melalui. 2.3.0-eksbuild.1 2.6.0-eksbuild.1 Masalah telah diperbaiki dalam rilis Java SDK v1.32.6 dan versi add-on Amazon CloudWatch Observability EKS. v3.0.0-eksbuild.1

Jika Anda terpengaruh, upgrade versi Java SDK atau nonaktifkan koleksi metrik runtime Anda dengan menambahkan variabel OTEL_AWS_APPLICATION_SIGNALS_RUNTIME_ENABLED=false lingkungan ke aplikasi Anda.