Aktifkan aplikasi Anda di cluster Amazon EKS

Untuk mengaktifkan Sinyal Aplikasi untuk aplikasi Anda di klaster Amazon EKS yang ada

1. Buka CloudWatch konsol di https://console.aws.amazon.com/cloudwatch/.

2. Pilih Sinyal Aplikasi.

3. Untuk Tentukan platform, pilih EKS.

4. Untuk Pilih klaster EKS, pilih klaster tempat Anda ingin mengaktifkan Sinyal Aplikasi.

5. Jika cluster ini belum mengaktifkan add-on Amazon CloudWatch Observability EKS, Anda akan diminta untuk mengaktifkannya. Jika ini terjadi, lakukan hal berikut:

   1. Pilih Add CloudWatch Observability EKS add-on. Konsol Amazon EKS akan dimunculkan.

   2. Pilih kotak centang untuk Amazon CloudWatch Observability dan pilih Next.

      Peng CloudWatch aya Observability EKS memungkinkan Sinyal Aplikasi dan CloudWatch Wawasan Kontainer dengan pengamatan yang ditingkatkan untuk Amazon EKS. Untuk informasi selengkapnya tentang Wawasan Kontainer ini, silakan lihat Wawasan Kontainer.

   3. Pilih versi terbaru add-on untuk diinstal.

   4. Pilih peran IAM yang akan digunakan untuk add-on. Jika Anda memilih Diwariskan dari node, lampirkan izin yang benar untuk peran IAM yang digunakan oleh simpul pekerja Anda. Ganti my-worker-node-role dengan peran IAM yang digunakan oleh node pekerja Kubernetes Anda.

      aws iam attach-role-policy \
      --role-name my-worker-node-role \
      --policy-arn arn:aws:iam::aws:policy/CloudWatchAgentServerPolicy \
      --policy-arn arn:aws:iam::aws:policy/AWSXRayWriteOnlyAccess

   5. Jika Anda ingin membuat peran layanan untuk menggunakan add-on, silakan lihat Instal CloudWatch agen dengan add-on Amazon CloudWatch Observability EKS atau bagan Helm.

   6. Pilih Berikutnya, konfirmasikan informasi di layar, dan pilih Buat.

   7. Di layar berikutnya, pilih Aktif CloudWatch kan Sin yal Aplikasi untuk kembali ke CloudWatch konsol dan menyelesaikan proses.

6. Ada dua opsi untuk mengaktifkan aplikasi Anda untuk Sinyal Aplikasi. Untuk konsistensi, kami sarankan Anda memilih satu opsi per cluster.

   • Opsi Konsol lebih sederhana. Menggunakan metode ini menyebabkan pod Anda segera restart.

   • Metode Annotate Manifest File memberi Anda lebih banyak kontrol kapan pod Anda dimulai ulang, dan juga dapat membantu Anda mengelola pemantauan Anda dengan cara yang lebih terdesentralisasi jika Anda tidak ingin memusatkannya.

   catatan

   Jika Anda mengaktifkan Sinyal Aplikasi untuk Node.js aplikasi dengan ESM, lewati ke sebagai Menyiapkan Node.js aplikasi dengan format modul ESM gantinya.

   Console

   Opsi Kon sol menggunakan konfigurasi lanjutan dari add-on Amazon CloudWatch Observability EKS untuk menyiapkan Sinyal Aplikasi untuk layanan Anda. Untuk informasi selengkapnya tentang add-on, lihat(Opsional) Konfigurasi tambahan.

   Jika Anda tidak melihat daftar beban kerja dan ruang nama, pastikan Anda memiliki izin yang tepat untuk melihatnya untuk cluster ini. Untuk informasi selengkapnya, lihat Iz in yang diperlukan.

   Anda dapat memantau semua beban kerja layanan dengan memilih kotak centang Auto monitor atau memilih secara selektif beban kerja dan ruang nama tertentu untuk dipantau.

   Untuk memantau semua beban kerja layanan dengan Auto monitor:

   1. Pilih kotak centang Auto monitor untuk secara otomatis memilih semua beban kerja layanan dalam cluster.

   2. Pilih Auto restart untuk memulai ulang semua pod beban kerja untuk mengaktifkan Sinyal Aplikasi segera dengan AWS Distro untuk SDK OpenTelemetry instrumentasi otomatis (ADOT) yang disuntikkan ke dalam pod Anda.

   3. Pilih Selesai. Ketika Auto restart dipilih, add-on CloudWatch Observability EKS akan segera mengaktifkan Sinyal Aplikasi. Jika tidak, Sinyal Aplikasi akan diaktifkan selama penerapan berikutnya dari setiap beban kerja.

   Anda dapat memantau beban kerja tunggal atau seluruh ruang nama.

   Untuk memantau beban kerja tunggal:

   1. Pilih kotak centang berdasarkan beban kerja yang ingin Anda pantau.

   2. Gunakan daftar tarik- turun Pilih bahasa untuk memilih bahasa beban kerja. Pilih bahasa yang ingin Anda aktifkan Sinyal Aplikasi, lalu pilih ikon tanda centang (✓) untuk menyimpan pilihan ini.

      Untuk aplikasi Python, pastikan aplikasi Anda mengikuti prasyarat yang diperlukan sebelum melanjutkan. Untuk informasi selengkapnya, lihat Aplikasi Python tidak dimulai setelah Sinyal Aplikasi diaktifkan.

   3. Pilih Selesai. Add-on Amazon CloudWatch Observability EKS akan segera menyuntikkan AWS SDK Distro for OpenTelemetry autoinstrumentation (ADOT) ke dalam pod Anda dan memicu restart pod untuk mengaktifkan pengumpulan metrik dan pelacakan aplikasi.

   Untuk memantau seluruh namespace:

   1. Pilih kotak centang berdasarkan namespace yang ingin Anda pantau.

   2. Gunakan daftar tarik- turun Pilih bahasa untuk memilih bahasa namespace. Pilih bahasa yang ingin Anda aktifkan Sinyal Aplikasi, lalu pilih ikon tanda centang (✓) untuk menyimpan pilihan ini. Ini berlaku untuk semua beban kerja di namespace ini, apakah mereka saat ini digunakan atau akan digunakan di masa mendatang.

      Untuk aplikasi Python, pastikan aplikasi Anda mengikuti prasyarat yang diperlukan sebelum melanjutkan. Untuk informasi selengkapnya, lihat Aplikasi Python tidak dimulai setelah Sinyal Aplikasi diaktifkan.

   3. Pilih Selesai. Add-on Amazon CloudWatch Observability EKS akan segera menyuntikkan AWS SDK Distro for OpenTelemetry autoinstrumentation (ADOT) ke dalam pod Anda dan memicu restart pod untuk mengaktifkan pengumpulan metrik dan pelacakan aplikasi.

   Untuk mengaktifkan Sinyal Aplikasi di klaster Amazon EKS lainnya, pilih Aktifkan Sinyal Aplikasi dari layar Layanan.

   Annotate manifest file

   Di CloudWatch konsol, bagian Layanan Monitor menjelaskan bahwa Anda harus menambahkan anotasi ke manifes YAML di cluster. Dengan menambahkan keterangan ini maka secara otomatis melengkapi aplikasi untuk mengirim metrik, jejak, dan log ke Sinyal Aplikasi.

   Anda memiliki dua pilihan untuk keterangan:

   • Beri Keterangan untuk Beban Kerja secara otomatis melengkapi sebuah beban kerja tunggal di klaster.

   • Beri Keterangan Namespace secara otomatis melengkapi semua beban kerja yang di-deploy di namespace yang dipilih.

   Pilih salah satu pilihan tersebut, dan ikuti langkah-langkah yang sesuai:

   • Untuk membuat anotasi pada satu beban kerja:

     1. Pilih Beri Keterangan Beban Kerja.

     2. Tempelkan salah satu baris berikut ke PodTemplate bagian file manifes beban kerja.

        • Untuk beban kerja Java: annotations: instrumentation.opentelemetry.io/inject-java: "true"

        • Untuk beban kerja Python: annotations: instrumentation.opentelemetry.io/inject-python: "true"

          Untuk aplikasi Python, ada konfigurasi tambahan yang diperlukan. Untuk informasi selengkapnya, lihat Aplikasi Python tidak dimulai setelah Sinyal Aplikasi diaktifkan.

        • Untuk beban kerja.NET annotations: instrumentation.opentelemetry.io/inject-dotnet: "true"

          catatan

          Untuk mengaktifkan Sinyal Aplikasi untuk beban kerja.NET pada gambar berbasis Alpine Linux (linux-musl-x64), tambahkan anotasi berikut.

          instrumentation.opentelemetry.io/otel-dotnet-auto-runtime: "linux-musl-x64"

        • Untuk Node.js beban kerja: annotations: instrumentation.opentelemetry.io/inject-nodejs: "true"

     3. Di terminal Anda, masukkan kubectl apply -f your_deployment_yaml untuk menerapkan perubahan.

   • Untuk membuat anotasi semua beban kerja dalam namespace:

     1. Pilih Berikan Keterangan Namespace.

     2. Tempelkan salah satu baris berikut ke bagian metadata dari file manifes namespace. Jika namespace menyertakan beban kerja Java, Python, dan .NET, tempel semua baris berikut ke dalam file manifes namespace.

        • Jika ada beban kerja Java di namespace: annotations: instrumentation.opentelemetry.io/inject-java: "true"

        • Jika ada beban kerja Python di namespace: annotations: instrumentation.opentelemetry.io/inject-python: "true"

          Untuk aplikasi Python, ada konfigurasi tambahan yang diperlukan. Untuk informasi selengkapnya, lihat Aplikasi Python tidak dimulai setelah Sinyal Aplikasi diaktifkan.

        • Jika ada beban kerja.NET di namespace: annotations: instrumentation.opentelemetry.io/inject-dotnet: "true"

        • Jika ada Node.JS beban kerja di namespace: annotations: instrumentation.opentelemetry.io/inject-nodejs: "true"

     3. Di terminal Anda, masukkan kubectl apply -f your_namespace_yaml untuk menerapkan perubahan.

     4. Di terminal Anda, masukkan satu perintah untuk memulai ulang semua pod di namespace tersebut. Contoh perintah untuk me-restart deployment beban kerja adalah kubectl rollout restart deployment -n namespace_name

7. Pilih Tampilkan Layanan setelah selesai. Hal ini akan membawa Anda ke tampilan Layanan Sinyal Aplikasi, di mana Anda dapat melihat data yang dikumpulkan oleh Sinyal Aplikasi. Mungkin diperlukan waktu beberapa menit hingga akhirnya data muncul.

   Untuk mengaktifkan Sinyal Aplikasi di klaster Amazon EKS lainnya, pilih Aktifkan Sinyal Aplikasi dari layar Layanan.

   Untuk informasi selengkapnya tentang tampilan Layanan, silakan lihat Memantau kondisi kesehatan operasional aplikasi Anda dengan Sinyal Aplikasi.

Untuk mengaktifkan Sinyal Aplikasi untuk Node.js aplikasi dengan ESM

1. Instal dependensi yang relevan ke Node.js aplikasi Anda untuk autoinstrumentasi:

   npm install @aws/aws-distro-opentelemetry-node-autoinstrumentation
   npm install @opentelemetry/instrumentation@0.54.0

2. Tambahkan variabel lingkungan berikut ke Dockerfile untuk aplikasi Anda dan buat gambar.

   ...
   ENV OTEL_AWS_APPLICATION_SIGNALS_ENABLED=true
   ENV OTEL_TRACES_SAMPLER_ARG='endpoint=http://cloudwatch-agent.amazon-cloudwatch:2000'
   ENV OTEL_TRACES_SAMPLER='xray'
   ENV OTEL_EXPORTER_OTLP_PROTOCOL='http/protobuf'
   ENV OTEL_EXPORTER_OTLP_TRACES_ENDPOINT='http://cloudwatch-agent.amazon-cloudwatch:4316/v1/traces'
   ENV OTEL_AWS_APPLICATION_SIGNALS_EXPORTER_ENDPOINT='http://cloudwatch-agent.amazon-cloudwatch:4316/v1/metrics'
   ENV OTEL_METRICS_EXPORTER='none'
   ENV OTEL_LOGS_EXPORTER='none'
   ENV NODE_OPTIONS='--import @aws/aws-distro-opentelemetry-node-autoinstrumentation/register --experimental-loader=@opentelemetry/instrumentation/hook.mjs'
   ENV OTEL_SERVICE_NAME='YOUR_SERVICE_NAME' #replace with a proper service name
   ENV OTEL_PROPAGATORS='tracecontext,baggage,b3,xray'
   ...
   
   # command to start the application
   # for example
   # CMD ["node", "index.mjs"]

3. Tambahkan variabel lingkunganOTEL_RESOURCE_ATTRIBUTES_POD_NAME,, OTEL_RESOURCE_ATTRIBUTES_NODE_NAMEOTEL_RESOURCE_ATTRIBUTES_DEPLOYMENT_NAME, POD_NAMESPACE dan OTEL_RESOURCE_ATTRIBUTES ke file yaml penerapan untuk aplikasi. Contoh:

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: nodejs-app
     labels:
       app: nodejs-app
   spec:
     replicas: 2
     selector:
       matchLabels:
         app: nodejs-app
     template:
       metadata:
         labels:
           app: nodejs-app
         # annotations:
         # make sure this annotation doesn't exit
         #   instrumentation.opentelemetry.io/inject-nodejs: 'true'
       spec:
         containers:
         - name: nodejs-app
           image:your-nodejs-application-image #replace with a proper image uri
           imagePullPolicy: Always
           ports:
           - containerPort: 8000
           env:
             - name: OTEL_RESOURCE_ATTRIBUTES_POD_NAME
               valueFrom:
                 fieldRef:
                   fieldPath: metadata.name
             - name: OTEL_RESOURCE_ATTRIBUTES_NODE_NAME
               valueFrom:
                 fieldRef:
                   fieldPath: spec.nodeName
             - name: OTEL_RESOURCE_ATTRIBUTES_DEPLOYMENT_NAME
               valueFrom:
                 fieldRef:
                   fieldPath: metadata.labels['app'] # Assuming 'app' label is set to the deployment name
             - name: POD_NAMESPACE
               valueFrom:
                 fieldRef:
                   fieldPath: metadata.namespace
             - name: OTEL_RESOURCE_ATTRIBUTES
               value: "k8s.deployment.name=$(OTEL_RESOURCE_ATTRIBUTES_DEPLOYMENT_NAME),k8s.namespace.name=$(POD_NAMESPACE),k8s.node.name=$(OTEL_RESOURCE_ATTRIBUTES_NODE_NAME),k8s.pod.name=$(OTEL_RESOURCE_ATTRIBUTES_POD_NAME)"

4. Menyebarkan Node.js aplikasi ke cluster.

1. Aktifkan Sinyal Aplikasi untuk aplikasi Anda.

   import { aws_applicationsignals as applicationsignals } from 'aws-cdk-lib';
   
   const cfnDiscovery = new applicationsignals.CfnDiscovery(this,
     'ApplicationSignalsServiceRole', { }
   );

   Sumber CloudFormation daya Discovery memberikan izin berikut kepada Sinyal Aplikasi:

   • xray:GetServiceGraph

   • logs:StartQuery

   • logs:GetQueryResults

   • cloudwatch:GetMetricData

   • cloudwatch:ListMetrics

   • tag:GetResources

   Untuk informasi selengkapnya tentang peran ini, silakan lihat Service-linked izin peran untuk Sin CloudWatch yal Aplikasi.

2. Instal amazon-cloudwatch-observability add-on.

   1. Buat peran IAM dengan CloudWatchAgentServerPolicy dan OIDC yang terkait dengan cluster.

      const cloudwatchRole = new Role(this, 'CloudWatchAgentAddOnRole', {
          assumedBy: new OpenIdConnectPrincipal(cluster.openIdConnectProvider),
          managedPolicies: [ManagedPolicy.fromAwsManagedPolicyName('CloudWatchAgentServerPolicy')],
      });

3. Instal add-on dengan peran IAM yang dibuat di atas.

   new CfnAddon(this, 'CloudWatchAddon', {
       addonName: 'amazon-cloudwatch-observability',
       clusterName: cluster.clusterName,
       serviceAccountRoleArn: cloudwatchRole.roleArn
   });

4. Tambahkan salah satu dari berikut ini ke PodTemplate bagian file manifes beban kerja Anda.

   Bahasa	File
   Java	instrumentasi.opentelemetri. io/inject-java: “benar”
   Python	instrumentasi.opentelemetri. io/inject-python: “benar”
   .Net	instrumentasi.opentelemetri. io/inject-dotnet: “benar”
   Node.js	instrumentasi.opentelemetri. io/inject-nodejs: “benar”

   const deployment = {
     apiVersion: "apps/v1",
     kind: "Deployment",
     metadata: { name: "sample-app" },
     spec: {
       replicas: 3,
       selector: {
         matchLabels: {
           "app": "sample-app"
         }
       },
       template: {
         metadata: {
           labels: {
             "app": "sample-app"
           },
           annotations: {
             "instrumentation.opentelemetry.io/inject-$LANG": "true"
           }
         },
         spec: {...},
       },
     },
   };
   
   cluster.addManifest('sample-app', deployment)