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
<a name="adding-your-own-related-telemetry"></a>

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 ](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutLogEvents.html) operasi [ PutMetricData ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html) 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 opsional`Attributes`.

**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
<a name="custom-related-telemetry-keyattributes"></a>

Pro `KeyAttributes` perti objek Entitas ([dalam CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_Entity.html) atau [ dalam 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 `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 dipanggil`KeyAttributes`. Di CloudWatch Logs API, properti dipanggil`keyAttributes`. Di sini mereka diperlakukan sebagai properti yang sama.

Ada lima kemungkinan jenis objek yang `Entity` dapat diwakili.
+ **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.
+ **Sumber daya ** — 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 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](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html) sumber daya. Misalnya, `AWS::DynamoDB::Table`.
+ `"Identifier": "<resource-id>"`— 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 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](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html) 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. 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": "<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`.

------

## Memberikan detail tambahan tentang entitas dengan objek Attributes
<a name="custom-related-telemetry-attributes"></a>

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 dipanggil`Attributes`. Di 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 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` |