View a markdown version of this page

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 ke CloudWatch, informasi entitas yang diperlukan untuk telemetri terkait tidak ada secara default. Saat mengirim metrik ke CloudWatch atau CloudWatch log ke Log (dengan PutLogEvents operasi PutMetricData atau), Anda dapat menambahkan informasi entitas ke log atau metrik tersebut. Informasi entitas dikaitkan dengan telemetri, dan digunakan dalam fitur Jelajahi terkait untuk menemukan telemetri terkait yang terkait dengan entitas yang sama.

Entitas yang dikirim dengan telemetri mewakili sumber daya atau layanan yang dikaitkan 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 entitas KeyAttributes dan opsionalAttributes.

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

Untuk informasi tentang cara menambahkan informasi entitas, lihatInformasi entitas dalam format EMF.

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

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

catatan

Di CloudWatch API, properti dipanggilKeyAttributes. Di CloudWatch Logs API, properti dipanggilkeyAttributes. Di sini mereka diperlakukan sebagai properti yang sama.

Ada lima kemungkinan jenis objek yang Entity dapat diwakili.

  • AWS::ResourceEntitas mewakili AWS sumber daya, seperti tabel DynamoDB atau instans Amazon EC2.

  • AWS::ServiceEntitas 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.

  • Sumber daya — 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 mana 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 Sumber AWS Daya, Anda harus menyertakan tiga pasangan nilai kunci berikut:

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

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

  • "Identifier": "<resource-id>"— Pengidentifikasi utama untuk sumber daya. Untuk informasi selengkapnya, lihat PrimaryIdentifier di Pengembangan Ek stensi 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 AWS layanan.

  • "Name": "<service-name>"— Nilai dari Name adalah string nama 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 dihosting, atau lingkungan tempat layanan itu 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 Pod Kubernetes.

  • "Identifier": "<resource-id>"— Pengidentifikasi string untuk sumber daya. Dapat berisi beberapa nama, dipisahkan oleh pipa. Misalnya, Pod Kubernetes mungkin diwakili oleh nama cluster, 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 rincian 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 dipanggilAttributes. Di CloudWatch Logs API, properti dipanggilattributes. Di sini mereka diperlakukan sebagai properti yang sama.

Detail platform

Kata Kunci Penggunaan Domain nilai Contoh

PlatformType

Mendefinisikan platform yang dihosting.

AWS: :EKS, AWS: :ECS, AWS: :EC2,, K8s, Umum AWS::Lambda

AWS::EC2

EKS.Cluster

Nama cluster Amazon EKS.

String alfanumerik dengan pembatas dasar.

FlyingSquad

K8s.Cluster

Nama cluster Kubernetes yang di-host sendiri.

String alfanumerik dengan pembatas dasar.

minicube

K8s.Namespace

Nama namespace Kubernetes di cluster Amazon EKS atau K8s.

String alfanumerik dengan pembatas dasar.

default, pet-clinic

K8s.Workload

Nama beban kerja Kubernetes di cluster Amazon EKS dan K8s.

String alfanumerik dengan pembatas dasar.

frontend

K8s.Node

Identitas node Kubernetes di cluster Amazon EKS dan K8s.

Nama node K8s (misalnya, nama DNS instans Amazon EC2).

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

K8s.Pod

Identitas pod Kubernetes di cluster Amazon EKS dan K8s.

Pengidentifikasi pod K8s.

frontend-1234abcd56-ef7890

EC2.AutoScalingGroup

Nama AutoScaling Grup Amazon EC2.

String alfanumerik dengan pembatas dasar.

my-asg-name-1

EC2.InstanceId

Identitas instans Amazon EC2.

Pengidentifikasi instans Amazon EC2.

i-1234abcd5678ef90

ECS.Cluster

Identitas cluster Amazon ECS.

Nama cluster Amazon ECS.

MyCluster

ECS.Service

Identitas layanan Amazon ECS.

Nama layanan Amazon ECS.

MyService

ECS.Task

Identitas tugas Amazon ECS.

ID tugas Amazon ECS.

task-123abc

Lambda.Function

Identitas fungsi Lambda.

Nama fungsi lambda.

MyFunction

Host

Nama host untuk semua jenis platform.

Sub-domain format.

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

Rincian sumber daya

Kata Kunci Penggunaan Domain nilai Contoh

AWS.Resource.ARN

ARN untuk AWS sumber daya.

String alfanumerik dengan pembatas dasar.

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

Rincian aplikasi

Kata Kunci Penggunaan Domain nilai Contoh

AWS.Application

Nama aplikasi di AppRegistry.

String alfanumerik dengan pembatas dasar.

PetClinicApp

AWS.Application.ARN

ARN aplikasi di AppRegistry.

String alfanumerik dengan pembatas dasar.

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

Rincian penyedia telemetri

Kata Kunci Penggunaan Domain nilai Contoh

Telemetry.SDK

Sidik jari versi OTEL SDK untuk layanan berinstrumen.

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 Span, JMX, OS.

ClientSpan, JMX