Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Log yang didukung dan bidang yang ditemukan

CloudWatch Logs Insights mendukung berbagai jenis log. Untuk setiap log yang dikirim ke grup log kelas Standar di Amazon Logs, CloudWatch CloudWatch Logs Insights secara otomatis menghasilkan lima bidang sistem:

CloudWatch Logs Insights menyisi pkan simbol @ di awal bidang yang dihasilkannya.

Untuk banyak jenis CloudWatch log, Log juga secara otomatis menemukan bidang log yang terkandung dalam log. Bidang penemuan otomatis ini ditunjukkan dalam tabel berikut.

Untuk jenis log lain dengan bidang yang CloudWatch tidak ditemukan secara otomatis oleh Logs Insights, Anda dapat menggunakan parse perintah untuk mengekstrak dan membuat bidang yang diekstraksi untuk digunakan dalam kueri tersebut. Untuk informasi selengkapnya, lihat CloudWatch Sintaks kueri bahasa Logs Insights.

Jika nama bidang log yang ditemukan dimulai dengan @ karakter, CloudWatch Logs Insights menampilkannya dengan @ tambahan ditambahkan ke awal. Sebagai contoh, jika nama bidang log adalah @example.com, nama bidang ini ditampilkan sebagai @@example.com.

Bidang di log JSON

Dengan CloudWatch Logs Insights, Anda menggunakan notasi titik untuk mewakili bidang JSON. Bagian ini berisi contoh peristiwa JSON dan cuplikan kode yang menunjukkan bagaimana Anda dapat mengakses bidang JSON menggunakan notasi titik.

Contoh: peristiwa JSON

{
    "eventVersion": "1.0",
    "userIdentity": {
        "type": "IAMUser",
        "principalId": "EX_PRINCIPAL_ID",
        "arn": "arn: aws: iam: : 123456789012: user/Alice",
        "accessKeyId": "EXAMPLE_KEY_ID",
        "accountId": "123456789012",
        "userName": "Alice"
    },
    "eventTime": "2014-03-06T21: 22: 54Z",
    "eventSource": "ec2.amazonaws.com",
    "eventName": "StartInstances",
    "awsRegion": "us-east-2",
    "sourceIPAddress": "192.0.2.255",
    "userAgent": "ec2-api-tools1.6.12.2",
    "requestParameters": {
        "instancesSet": {
            "items": [
                {
                    "instanceId": "i-abcde123"
                }
            ]
        }
    },
    "responseElements": {
        "instancesSet": {
            "items": [
                {
                    "instanceId": "i-abcde123",
                    "currentState": {
                        "code": 0,
                        "name": "pending"
                    },
                    "previousState": {
                        "code": 80,
                        "name": "stopped"
                    }
                }
            ]
        }
    }
}

Contoh peristiwa JSON berisi objek yang diberi namauserIdentity. userIdentityberisi bidang yang diberi namatype. Untuk mewakili nilai type menggunakan notasi titik, Anda menggunakanuserIdentity.type.

Contoh peristiwa JSON berisi array yang meratakan ke daftar nama dan nilai bidang bersarang. Untuk mewakili nilai instanceId untuk item pertama direquestParameters.instancesSet, Anda gunakanrequestParameters.instancesSet.items.0.instanceId. Ang 0 ka yang ditempatkan sebelum bidang instanceID mengacu pada posisi nilai untuk bidangitems. Contoh berikut berisi cuplikan kode yang menunjukkan bagaimana Anda dapat mengakses bidang JSON bersarang dalam peristiwa log JSON.

Contoh: Query

fields @timestamp, @message
| filter requestParameters.instancesSet.items.0.instanceId="i-abcde123"
| sort @timestamp desc

Cuplikan kode menunjukkan kueri yang menggunakan notasi titik dengan filter perintah untuk mengakses nilai bidang JSON bersarang. instanceId Kueri memfilter pesan di mana nilai instanceId sama dengan "i-abcde123" dan mengembalikan semua peristiwa log yang berisi nilai yang ditentukan.

Notasi titik dan bidang JSON-encoded string

Notasi titik hanya melintasi bidang yang disimpan sebagai objek JSON bersarang secara struktural pada waktu konsumsi. Jika nilai bidang adalah JSON-encoded string (string yang isinya kebetulan JSON valid), notasi titik memperlakukannya sebagai nilai daun buram dan tidak mengakses sub-bidang di dalamnya.

Hal ini biasanya terjadi dengan:

Misalnya, jika api.request.data berisi {"startTime":1234,"endTime":5678} sebagai nilai string, maka tidak api.request.data.startTime mengembalikan hasil karena CloudWatch Logs Insights memperlakukan seluruh string sebagai nilai daun tunggal daripada objek bersarang.

Untuk mengakses sub-bidang dalam JSON-encoded string, gunakan jsonParse untuk mengubah string menjadi peta yang dapat dilalui.

Contoh: Kueri menggunakan JSONParse untuk bidang string JSON-encoded

fields jsonParse(api.request.data).startTime as startTime

Kueri ini jsonParse digunakan untuk mengurai JSON-encoded string api.request.data ke dalam peta, dan kemudian mengakses startTime sub-bidang dengan notasi titik. Untuk informasi selengkapnyajsonParse, lihat Jenis struktur.