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 [PutMetricData](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html)atau [PutLogEvents](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutLogEvents.html)operasi), 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
Untuk informasi tentang cara menambahkan informasi entitas, lihat[Informasi entitas dalam format EMF](CloudWatch_Embedded_Metric_Format_Specification.md#entity-information-emf-format).
Bagian berikut menjelaskan cara membuat `KeyAttributes` dan `Attributes` sehingga CloudWatch dapat mengidentifikasi sumber daya dan layanan yang terkait dengan telemetri.
## Mengidentifikasi entitas dengan KeyAttributes objek
`KeyAttributes`Properti objek Entitas ([dalam CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_Entity.html) atau [di CloudWatch log](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_Entity.html)) 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**
Dalam CloudWatch API, properti dipanggil`KeyAttributes`. Dalam CloudWatch Logs API, properti dipanggil`keyAttributes`. 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 instans 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.
+ **RemoteService**Entitas 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": ""`— Nilai string `ResourceType` adalah string [tipe CloudFormation sumber daya](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html). Misalnya, `AWS::DynamoDB::Table`.
+ `"Identifier": ""`— Pengidentifikasi utama untuk sumber daya. Untuk informasi selengkapnya, lihat [PrimaryIdentifier](https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-schema.html#schema-properties-primaryidentifier) di *Pengembangan Ekstensi untuk CloudFormation Panduan 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": ""`— Nilai dari `Name` string [nama CloudFormation layanan](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html). 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": ""`— Ini mewakili nama layanan yang mengirimkan metrik. Misalnya, `my-service-frontend` atau `api.myservice.com`.
+ `"Environment": ""`— Atribut ini menentukan di mana layanan di-host, atau lingkungan tempat layanan tersebut berada. Misalnya`us-west-2`, atau`myservice.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": ""`— Sebuah string yang menentukan jenis sumber daya. Misalnya, `K8s::Pod` untuk Kubernetes Pod.
+ `"Identifier": ""`— 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": ""`— Menentukan bagaimana aplikasi mengacu pada layanan eksternal dalam panggilan jarak jauh. Misalnya, `api.test.myservice.com`.
------
## Memberikan rincian tambahan tentang entitas dengan objek Attributes
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**
Dalam CloudWatch API, properti dipanggil`Attributes`. Dalam CloudWatch Logs API, properti dipanggil`attributes`. 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::EC2, AWS::Lambda, K8s, Generik | `AWS::EC2` |
| `EKS.Cluster` | Nama cluster Amazon EKS. | 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 Amazon EKS dan kluster K8s. | String alfanumerik dengan pembatas dasar. | `frontend` |
| `K8s.Node` | Identitas node Kubernetes di Amazon EKS dan kluster K8s. | Nama simpul K8s (misalnya, nama DNS instans Amazon EC2). | `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 Grup Amazon EC2 AutoScaling . | 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. | Format sub-domain. | `ip-111-22-33-44.example.com` |
**Detail sumber daya**
| Kata Kunci | Penggunaan | Domain Nilai | Contoh |
| --- | --- | --- | --- |
| `AWS.Resource.ARN` | ARN untuk sumber daya. AWS | 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` | ARN dari 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 versi OTEL SDK 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` |