Cara menambahkan informasi terkait ke telemetri khusus yang dikirim ke CloudWatch - Amazon CloudWatch
Entitas KeyAttributesAtribut Entitas

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Cara menambahkan informasi terkait ke telemetri khusus yang dikirim ke CloudWatch

Saat Anda mempublikasikan metrik dan log Anda sendiri CloudWatch, informasi entitas yang diperlukan untuk telemetri terkait tidak ada secara default. Saat Anda mengirim metrik ke CloudWatch atau CloudWatch log ke Log (dengan PutMetricDataatau PutLogEventsoperasi), Anda dapat menambahkan informasi entitas ke log atau metrik tersebut. Informasi entitas dikaitkan dengan telemetri, dan digunakan dalam fitur terkait Jelajahi untuk menemukan telemetri terkait yang terkait dengan entitas yang sama.

Entitas yang dikirim dengan telemetri mewakili sumber daya atau layanan yang terkait dengan telemetri. Misalnya, metrik tentang layanan, atau yang berasal dari AWS sumber daya. Untuk mengidentifikasi entitas yang terkait dalam kode Anda, Anda membuat satu set KeyAttributes dan opsional Attributes entitas.

catatan

CloudWatch Hanya dapat menemukan sumber daya terkait untuk entitas yang telah mengirim telemetri dalam tiga jam sebelumnya. Jika sumber daya Anda hanya memancarkan telemetri jarang (kurang dari sekali setiap 3 jam), Anda mungkin ingin mengirim telemetri detak jantung tambahan, untuk menjaga entitas tetap aktif di dalamnya. CloudWatch

Bagian berikut menjelaskan cara membuat KeyAttributes dan Attributes sehingga CloudWatch dapat mengidentifikasi sumber daya dan layanan yang terkait dengan telemetri.

KeyAttributesProperti objek Entitas (dalam CloudWatch atau di CloudWatch log) secara unik mengidentifikasi entitas untuk. CloudWatch Ini adalah daftar pasangan kunci-nilai. Entitas dengan entitas KeyAttributes yang sama dianggap sebagai entitas yang sama. Telemetri yang terkait dengan entitas yang sama dianggap terkait, dan dapat dengan mudah ditemukan di panel Jelajahi terkait.

catatan

Di CloudWatch API, properti itu disebutKeyAttributes. Dalam CloudWatch LogAPI, properti disebutkeyAttributes. Di sini mereka diperlakukan sebagai properti yang sama.

Ada lima kemungkinan jenis objek yang Entity dapat diwakili oleh seseorang.

  • AWS: :Resource — Entitas mewakili AWS sumber daya, seperti tabel DynamoDB atau instance Amazon. EC2

  • AWS: :Service — Entitas mewakili AWS layanan, seperti Amazon S3. Ini mungkin digunakan, misalnya, saat memanggil ListBuckets operasi, yang tidak terkait dengan sumber daya Amazon S3 tertentu.

  • Layanan — Entitas mewakili beban kerja yang berjalan di akun Anda. Misalnya, aplikasi atau layanan yang Anda kelola.

  • Resource — Entitas mewakili sumber daya yang tidak dikelola oleh AWS, misalnya, sumber daya sistem operasi, seperti proses atau volume file.

  • RemoteServiceEntitas mewakili layanan eksternal dalam panggilan jarak jauh. Misalnya, panggilan jarak jauh ke database, cache eksternal, atau titik akhir eksternal.

Bergantung pada jenis di atas yang Anda coba wakili, Anda harus memberikan pasangan kunci-nilai yang benar untuk. KeyAttributes Berikut ini menjelaskan setiap jenis.

AWS::Resource

Untuk menentukan AWS Resource, Anda harus menyertakan tiga pasangan nilai kunci berikut:

  • "Type": "AWS::Resource"— Pasangan kunci-nilai ini mengidentifikasi entitas sebagai sumber daya. AWS

  • "ResourceType": "<resource-type>"— Nilai string ResourceType adalah string tipe AWS CloudFormation sumber daya. Misalnya, AWS::DynamoDB::Table.

  • "Identifier": "<resource-id>"— Pengidentifikasi utama untuk sumber daya. Untuk informasi selengkapnya, lihat primaryIdentifierdi Pengembangan Ekstensi untuk Panduan CloudFormation Pengguna.

AWS::Service

Untuk menentukan AWS Layanan, Anda harus menyertakan dua pasangan nilai kunci berikut:

  • "Type": "AWS::Service"Pasangan kunci-nilai ini mengidentifikasi entitas sebagai layanan. AWS

  • "Name": "<service-name>"— Nilai dari Name adalah string nama AWS CloudFormation layanan. Misalnya, AWS::DynamoDB.

Service

Untuk menentukan layanan yang tidak dioperasikan oleh AWS, Anda harus menyertakan tiga pasangan nilai kunci berikut:

  • "Type": "Service"Pasangan kunci-nilai ini mengidentifikasi entitas sebagai layanan.

  • "Name": "<service-name>"— Ini mewakili nama layanan yang mengirimkan metrik. Misalnya, my-service-frontend atau api.myservice.com.

  • "Environment": "<environment-name>"— Atribut ini menentukan di mana layanan di-host, atau lingkungan tempat layanan tersebut berada. Misalnyaus-west-2, ataumyservice.production.

Resource

Untuk menentukan sumber daya yang tidak disediakan oleh AWS, Anda harus menyertakan tiga pasangan nilai kunci berikut:

  • "Type": "Resource"Pasangan kunci-nilai ini mengidentifikasi entitas sebagai sumber daya.

  • "ResourceType": "<resource-type>"— Sebuah string yang menentukan jenis sumber daya. Misalnya, K8s::Pod untuk Kubernetes Pod.

  • "Identifier": "<resource-id>"— Pengenal string untuk sumber daya. Dapat berisi beberapa nama, dipisahkan oleh pipa. Misalnya, Pod Kubernetes mungkin diwakili oleh nama klaster, namespace, dan nama pod, seperti. MyCluster|MyNamespace|MyPod

RemoteService

Untuk menentukan layanan jarak jauh, Anda harus menyertakan dua pasangan nilai kunci berikut:

  • "Type": "RemoteService"Pasangan kunci-nilai ini mengidentifikasi entitas sebagai layanan jarak jauh.

  • "Name": "<remote-service-name>"— Menentukan bagaimana aplikasi mengacu pada layanan eksternal dalam panggilan jarak jauh. Misalnya, api.test.myservice.com.

Anda dapat memberikan detail tambahan tentang Entity yang Anda berikan dengan telemetri Anda. Ini dapat mencakup detail tentang platform, sumber daya, aplikasi, atau penyedia telemetri. Tabel berikut menjelaskan kata kunci yang dapat Anda gunakan untuk masing-masing jenis data ini.

catatan

Di CloudWatch API, properti itu disebutAttributes. Dalam CloudWatch LogAPI, properti disebutattributes. Di sini mereka diperlakukan sebagai properti yang sama.

Detail platform

Kata Kunci Penggunaan Domain Nilai Contoh

PlatformType

Mendefinisikan platform hosted-in.

AWS::EKS, AWS::ECS, AWS::EC 2, AWS::Lambda, K8s, Generik

AWS::EC2

EKS.Cluster

Nama EKS cluster Amazon.

String alfanumerik dengan pembatas dasar.

FlyingSquad

K8s.Cluster

Nama klaster Kubernetes yang dihosting sendiri.

String alfanumerik dengan pembatas dasar.

minicube

K8s.Namespace

Nama namespace Kubernetes di Amazon EKS atau kluster K8s.

String alfanumerik dengan pembatas dasar.

default, pet-clinic

K8s.Workload

Nama beban kerja Kubernetes di EKS Amazon dan kluster K8s.

String alfanumerik dengan pembatas dasar.

frontend

K8s.Node

Identitas node Kubernetes di Amazon EKS dan kluster K8s.

Nama simpul K8s (misalnya, DNS nama EC2 instance Amazon).

ip-11-22-33-44.ec2.internal

K8s.Pod

Identitas pod Kubernetes di Amazon EKS dan kluster K8s.

Pengidentifikasi pod K8s.

frontend-1234abcd56-ef7890

EC2.AutoScalingGroup

Nama EC2 AutoScaling Grup Amazon.

String alfanumerik dengan pembatas dasar.

my-asg-name-1

EC2.InstanceId

Identitas EC2 contoh Amazon.

Pengidentifikasi EC2 instans Amazon.

i-1234abcd5678ef90

ECS.Cluster

Identitas ECS cluster Amazon.

Nama ECS cluster Amazon.

MyCluster

ECS.Service

Identitas ECS layanan Amazon.

Nama ECS layanan Amazon.

MyService

ECS.Task

Identitas ECS tugas Amazon.

ID ECS tugas Amazon.

task-123abc

Lambda.Function

Identitas fungsi Lambda.

Nama fungsi Lambda.

MyFunction

Host

Nama host untuk semua jenis platform.

Format sub-domain.

ip-111-22-33-44.example.com

Detail sumber daya

Kata Kunci Penggunaan Domain Nilai Contoh

AWS.Resource.ARN

ARNuntuk sumber AWS daya.

String alfanumerik dengan pembatas dasar.

arn:aws:dynamodb:us-east-1:123456789012:table/myDynamoDBTable

Detail aplikasi

Kata Kunci Penggunaan Domain Nilai Contoh

AWS.Application

Nama aplikasi di AppRegistry.

String alfanumerik dengan pembatas dasar.

PetClinicApp

AWS.Application.ARN

ARNdari aplikasi di AppRegistry.

String alfanumerik dengan pembatas dasar.

arn:aws:servicecatalog:us-east-1:1234567890:/applications/...

Detail penyedia telemetri

Kata Kunci Penggunaan Domain Nilai Contoh

Telemetry.SDK

Sidik jari OTEL SDK versi untuk layanan instrumentasi.

String alfanumerik dengan pembatas dasar.

opentelemetry,1.32.0-aws-SNAPSHOT,java,Auto

Telemetry.Agent

Sidik jari Agen digunakan untuk mengumpulkan dan mengirim data telemetri.

String alfanumerik dengan pembatas dasar.

CWAgent/1.300026.3, ADOTCollector/1.x

Telemetry.Source

Menentukan titik aplikasi di mana telemetri dikumpulkan atau apa yang digunakan untuk sumber data telemetri.

ServerSpan, ClientSpan,, ProducerSpan, ConsumerSpan, LocalRoot Rentang,JMX, OS.

ClientSpan, JMX