Pencatatan percobaan untuk AWS FIS - AWS Layanan Injeksi Kesalahan
IzinSkema logLog tujuanContoh catatan logAktifkan pencatatan percobaanNonaktifkan pencatatan percobaan

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 (di bawah Tingkat Berbayar, Log, Log Penjual) dan Harga Amazon S3.

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:

Skema log

Berikut ini adalah skema yang digunakan dalam pencatatan percobaan. Versi skema saat ini adalah 2. Bidang untuk details tergantung pada nilailog_type. Bidang untuk resolved_targets tergantung pada nilaitarget_type. Untuk informasi selengkapnya, lihat Contoh catatan log.

{
    "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_typeBidang dan mengubah resolved_targets bidang dari daftar ARN ke daftar objek. Bidang yang valid untuk resolved_targets objek bergantung pada nilaitarget_type, yang merupakan jenis sumber daya target.

    • Jenis action-error dan target-resolution-detail acara yang menambahkan account_id bidang.

  • Versi 1 adalah rilis awal.

Log tujuan

AWSFIS 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 log bernama /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 instans EC2 yang dipilih secara acak.

Catatan
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 tindakan EC2.

{
    "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/.

  2. Di panel navigasi, pilih Template eksperimen.

  3. Pilih template eksperimen, lalu pilih Tindakan, Perbarui templat eksperimen.

  4. 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.

  5. Pilih Perbarui templat eksperimen.

Untuk mengaktifkan pencatatan eksperimen menggunakan AWS CLI

Gunakan update-experiment-templateperintah 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/.

  2. Di panel navigasi, pilih Template eksperimen.

  3. Pilih template eksperimen, lalu pilih Tindakan, Perbarui templat eksperimen.

  4. Untuk Log, hapus Kirim ke bucket Amazon S3 dan Kirim ke CloudWatch Log.

  5. Pilih Perbarui templat eksperimen.

Untuk menonaktifkan pencatatan eksperimen menggunakan AWS CLI

Gunakan update-experiment-templateperintah dan tentukan konfigurasi log kosong.