Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Pencatatan percobaan untuk AWS FIS
Anda dapat menggunakan pencatatan eksperimen untuk menangkap informasi terperinci tentang eksperimen Anda saat dijalankan.
Anda dikenakan biaya untuk pencatatan percobaan berdasarkan biaya yang terkait dengan setiap jenis tujuan log. Untuk informasi selengkapnya, lihat [ CloudWatch Harga Amazon](https://aws.amazon.com/cloudwatch/pricing/) (di bawah **Tingkat Berbayar**, **Log**, **Log Penjual**) dan Harga [Amazon S3](https://aws.amazon.com/s3/pricing/).
## Izin
Anda harus memberikan izin AWS FIS untuk mengirim log ke setiap tujuan log yang Anda konfigurasikan. Untuk informasi selengkapnya, lihat berikut ini di *Panduan Pengguna Amazon CloudWatch Logs*:
+ [Log dikirim ke CloudWatch Log](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html#AWS-logs-infrastructure-CWL)
+ [Log dikirim ke Amazon S3](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html#AWS-logs-infrastructure-S3)
## Skema log
Berikut ini adalah skema yang digunakan dalam pencatatan percobaan. Versi skema saat ini adalah 2. Bidang untuk `details` tergantung pada nilai`log_type`. Bidang untuk `resolved_targets` tergantung pada nilai`target_type`. Untuk informasi selengkapnya, lihat [Contoh catatan log](#example-log-records).
```
{
"id": "EXP123abc456def789",
"log_type": "experiment-start | target-resolution-start | target-resolution-detail | target-resolution-end | action-start | action-error | action-end | experiment-end",
"event_timestamp": "yyyy-mm-ddThh:mm:ssZ",
"version": "2",
"details": {
"account_id":"123456789012",
"action_end_time": "yyyy-mm-ddThh:mm:ssZ",
"action_id": "String",
"action_name": "String",
"action_start_time": "yyyy-mm-ddThh:mm:ssZ",
"action_state": {
"status": "pending | initiating | running | completed | cancelled | stopping | stopped | failed",
"reason": "String"
},
"action_targets": "String to string map",
"error_information": "String",
"experiment_end_time": "yyyy-mm-ddThh:mm:ssZ",
"experiment_state": {
"status": "pending | initiating | running | completed | stopping | stopped | failed",
"reason": "String"
},
"experiment_start_time": "yyyy-mm-ddThh:mm:ssZ",
"experiment_template_id": "String",
"page": Number,
"parameters": "String to string map",
"resolved_targets": [
{
"field": "value"
}
],
"resolved_targets_count": Number,
"status": "failed | completed",
"target_name": "String",
"target_resolution_end_time": "yyyy-mm-ddThh:mm:ssZ",
"target_resolution_start_time": "yyyy-mm-ddThh:mm:ssZ",
"target_type": "String",
"total_pages": Number,
"total_resolved_targets_count": Number
}
}
```
**Catatan perilisan**
+ Versi 2 memperkenalkan:
+ `target_type`Bidang dan mengubah `resolved_targets` bidang dari daftar ARNs ke daftar objek. Bidang yang valid untuk `resolved_targets` objek bergantung pada nilai`target_type`, yang merupakan [jenis sumber daya](targets.md#resource-types) target.
+ Jenis `action-error` dan `target-resolution-detail` acara yang menambahkan `account_id` bidang.
+ Versi 1 adalah rilis awal.
## Log tujuan
AWS FIS mendukung pengiriman log ke tujuan berikut:
+ Bucket Amazon S3
+ Grup CloudWatch log Amazon Logs
**Pengiriman log S3**
Log dikirim ke lokasi berikut.
```
bucket-and-optional-prefix/AWSLogs/account-id/fis/region/experiment-id/YYYY/MM/DD/account-id_awsfislogs_region_experiment-id_YYYYMMDDHHMMZ_hash.log
```
Ini bisa memakan waktu beberapa menit sebelum log dikirim ke ember.
**CloudWatch Log pengiriman log**
Log dikirim ke aliran lognamed /aws/fis/*experiment-id*.
Log dikirim ke grup log dalam waktu kurang dari satu menit.
## Contoh catatan log
Berikut ini adalah contoh catatan log untuk eksperimen yang menjalankan **aws:ec2:reboot-instances** tindakan pada EC2 instance yang dipilih secara acak.
**Catatan**
+ [percobaan-mulai](#experiment-start)
+ [target-resolution-start](#target-resolution-start)
+ [target-resolution-detail](#target-resolution-detail)
+ [target-resolution-end](#target-resolution-end)
+ [aksi-mulai](#action-start)
+ [aksi-akhir](#action-end)
+ [tindakan-kesalahan](#action-error)
+ [ujung-eksperimen](#experiment-end)
**percobaan-mulai**
Berikut ini adalah contoh catatan untuk `experiment-start` acara tersebut.
```
{
"id": "EXPhjAXCGY78HV2a4A",
"log_type": "experiment-start",
"event_timestamp": "2023-05-31T18:50:45Z",
"version": "2",
"details": {
"experiment_template_id": "EXTCDh1M8HHkhxoaQ",
"experiment_start_time": "2023-05-31T18:50:43Z"
}
}
```
**target-resolution-start**
Berikut ini adalah contoh catatan untuk `target-resolution-start` acara tersebut.
```
{
"id": "EXPhjAXCGY78HV2a4A",
"log_type": "target-resolution-start",
"event_timestamp": "2023-05-31T18:50:45Z",
"version": "2",
"details": {
"target_resolution_start_time": "2023-05-31T18:50:45Z",
"target_name": "EC2InstancesToReboot"
}
}
```
**target-resolution-detail**
Berikut ini adalah contoh catatan untuk `target-resolution-detail` acara tersebut. Jika resolusi target gagal, catatan juga menyertakan `error_information` bidang.
```
{
"id": "EXPhjAXCGY78HV2a4A",
"log_type": "target-resolution-detail",
"event_timestamp": "2023-05-31T18:50:45Z",
"version": "2",
"details": {
"target_resolution_end_time": "2023-05-31T18:50:45Z",
"target_name": "EC2InstancesToReboot",
"target_type": "aws:ec2:instance",
"account_id": "123456789012",
"resolved_targets_count": 2,
"status": "completed"
}
}
```
**target-resolution-end**
Jika resolusi target gagal, catatan juga menyertakan `error_information` bidang. Jika `total_pages` lebih besar dari 1, jumlah target yang diselesaikan melebihi batas ukuran untuk satu catatan. Ada `target-resolution-end` catatan tambahan yang berisi target yang diselesaikan yang tersisa.
Berikut ini adalah contoh catatan untuk `target-resolution-end` acara untuk suatu EC2 tindakan.
```
{
"id": "EXPhjAXCGY78HV2a4A",
"log_type": "target-resolution-end",
"event_timestamp": "2023-05-31T18:50:45Z",
"version": "2",
"details": {
"target_resolution_end_time": "2023-05-31T18:50:46Z",
"target_name": "EC2InstanceToReboot",
"target_type": "aws:ec2:instance",
"resolved_targets": [
{
"arn": "arn:aws:ec2:us-east-1:123456789012:instance/i-0f7ee2abffc330de5"
}
],
"page": 1,
"total_pages": 1
}
}
```
Berikut ini adalah contoh catatan untuk `target-resolution-end` acara untuk tindakan EKS.
```
{
"id": "EXP24YfiucfyVPJpEJn",
"log_type": "target-resolution-end",
"event_timestamp": "2023-05-31T18:50:45Z",
"version": "2",
"details": {
"target_resolution_end_time": "2023-05-31T18:50:46Z",
"target_name": "myPods",
"target_type": "aws:eks:pod",
"resolved_targets": [
{
"pod_name": "example-696fb6498b-sxhw5",
"namespace": "default",
"cluster_arn": "arn:aws:eks:us-east-1:123456789012:cluster/fis-demo-cluster",
"target_container_name": "example"
}
],
"page": 1,
"total_pages": 1
}
}
```
**aksi-mulai**
Berikut ini adalah contoh catatan untuk `action-start` acara tersebut. Jika template percobaan menentukan parameter untuk tindakan, catatan juga menyertakan `parameters` bidang.
```
{
"id": "EXPhjAXCGY78HV2a4A",
"log_type": "action-start",
"event_timestamp": "2023-05-31T18:50:56Z",
"version": "2",
"details": {
"action_name": "Reboot",
"action_id": "aws:ec2:reboot-instances",
"action_start_time": "2023-05-31T18:50:56Z",
"action_targets": {"Instances":"EC2InstancesToReboot"}
}
}
```
**tindakan-kesalahan**
Berikut ini adalah contoh catatan untuk `action-error` acara tersebut. Acara ini hanya dikembalikan ketika suatu tindakan gagal. Itu dikembalikan untuk setiap akun di mana tindakan gagal.
```
{
"id": "EXPhjAXCGY78HV2a4A",
"log_type": "action-error",
"event_timestamp": "2023-05-31T18:50:56Z",
"version": "2",
"details": {
"action_name": "pause-io",
"action_id": "aws:ebs:pause-volume-io",
"account_id": "123456789012",
"action_state": {
"status": "failed",
"reason":"Unable to start Pause Volume IO. Target volumes must be attached to an instance type based on the Nitro system. VolumeId(s): [vol-1234567890abcdef0]:"
}
}
}
```
**aksi-akhir**
Berikut ini adalah contoh catatan untuk `action-end` acara tersebut.
```
{
"id": "EXPhjAXCGY78HV2a4A",
"log_type": "action-end",
"event_timestamp": "2023-05-31T18:50:56Z",
"version": "2",
"details": {
"action_name": "Reboot",
"action_id": "aws:ec2:reboot-instances",
"action_end_time": "2023-05-31T18:50:56Z",
"action_state": {
"status": "completed",
"reason": "Action was completed."
}
}
}
```
**ujung-eksperimen**
Berikut ini adalah contoh catatan untuk `experiment-end` acara tersebut.
```
{
"id": "EXPhjAXCGY78HV2a4A",
"log_type": "experiment-end",
"event_timestamp": "2023-05-31T18:50:57Z",
"version": "2",
"details": {
"experiment_end_time": "2023-05-31T18:50:57Z",
"experiment_state": {
"status": "completed",
"reason": "Experiment completed"
}
}
}
```
## Aktifkan pencatatan percobaan
Pencatatan percobaan dinonaktifkan secara default. Untuk menerima log eksperimen untuk eksperimen, Anda harus membuat eksperimen dari templat eksperimen dengan pencatatan diaktifkan. Pertama kali Anda menjalankan eksperimen yang dikonfigurasi untuk menggunakan tujuan yang belum pernah digunakan sebelumnya untuk logging, kami menunda eksperimen untuk mengonfigurasi pengiriman log ke tujuan ini, yang memakan waktu sekitar 15 detik.
**Untuk mengaktifkan pencatatan eksperimen menggunakan konsol**
1. Buka konsol AWS FIS di [https://console.aws.amazon.com/fis/](https://console.aws.amazon.com/fis/).
1. Di panel navigasi, pilih **Template eksperimen**.
1. Pilih template eksperimen, lalu pilih **Tindakan**, **Perbarui templat eksperimen**.
1. Untuk **Log**, konfigurasikan opsi tujuan. Untuk mengirim log ke bucket S3, pilih **Kirim ke bucket Amazon S3** dan masukkan nama bucket dan awalan. Untuk mengirim CloudWatch log ke Log, pilih **Kirim ke CloudWatch Log** dan masukkan grup log.
1. Pilih **Perbarui templat eksperimen**.
**Untuk mengaktifkan pencatatan eksperimen menggunakan AWS CLI**
Gunakan [update-experiment-template](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fis/update-experiment-template.html)perintah dan tentukan konfigurasi log.
## Nonaktifkan pencatatan percobaan
Jika Anda tidak lagi ingin menerima log untuk eksperimen Anda, Anda dapat menonaktifkan pencatatan eksperimen.
**Untuk menonaktifkan pencatatan eksperimen menggunakan konsol**
1. Buka konsol AWS FIS di [https://console.aws.amazon.com/fis/](https://console.aws.amazon.com/fis/).
1. Di panel navigasi, pilih **Template eksperimen**.
1. Pilih template eksperimen, lalu pilih **Tindakan**, **Perbarui templat eksperimen**.
1. Untuk **Log**, hapus **Kirim ke bucket Amazon S3** dan **Kirim ke CloudWatch ** Log.
1. Pilih **Perbarui templat eksperimen**.
**Untuk menonaktifkan pencatatan eksperimen menggunakan AWS CLI**
Gunakan [update-experiment-template](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/fis/update-experiment-template.html)perintah dan tentukan konfigurasi log kosong.