Prasyarat Mendapatkan bantuan baris perintah Mencari acara Wawasan Menentukan jumlah peristiwa Insights yang akan dikembalikan Mencari acara Wawasan berdasarkan rentang waktu Mencari acara Wawasan berdasarkan atribut Menentukan halaman hasil berikutnya Mendapatkan JSON masukan dari sebuah file Bidang keluaran pencarian

Melihat acara CloudTrail Wawasan untuk jalur dengan AWS CLI

Anda dapat mencari acara CloudTrail Insights selama 90 hari terakhir dengan menjalankan aws cloudtrail lookup-events perintah. lookup-eventsPerintah memiliki opsi berikut:

--end-time
--event-category
--max-results
--start-time
--lookup-attributes
--next-token
--generate-cli-skeleton
--cli-input-json

Untuk informasi umum tentang penggunaan AWS Command Line Interface, lihat Panduan AWS Command Line Interface Pengguna.

Daftar Isi

Prasyarat

Untuk menjalankan AWS CLI perintah, Anda harus menginstal file AWS CLI. Untuk informasi selengkapnya, lihat Memulai dengan AWS CLI.
Pastikan AWS CLI versi Anda lebih besar dari 1.6.6. Untuk memverifikasi CLI versi, jalankan aws --version pada baris perintah.
Untuk mengatur akun, Wilayah, dan format output default untuk AWS CLI sesi, gunakan aws configure perintah. Untuk informasi selengkapnya, lihat Mengonfigurasi Antarmuka Baris AWS Perintah.
Untuk mencatat peristiwa Insights pada volume API panggilan, jejak harus mencatat peristiwa write manajemen. Untuk mencatat peristiwa Insights pada tingkat API kesalahan, jejak harus mencatat read atau write mengelola peristiwa.

catatan

CloudTrail AWS CLI Perintahnya peka huruf besar/kecil.

Mendapatkan bantuan baris perintah

Untuk melihat bantuan baris perintahlookup-events, ketik perintah berikut.


aws cloudtrail lookup-events help

Mencari acara Wawasan

Untuk melihat sepuluh peristiwa Insights terbaru, ketik perintah berikut.


aws cloudtrail lookup-events --event-category insight

Peristiwa yang dikembalikan terlihat mirip dengan contoh berikut,


{
    "NextToken": "kbOt5LlZe++mErCebpy2TgaMgmDvF1kYGFcH64JSjIbZFjsuvrSqg66b5YGssKutDYIyII4lrP4IDbeQdiObkp9YAlju3oXd12juEXAMPLE=", 
    "Events": [
        {
            "eventVersion": "1.07",
            "eventTime": "2019-10-15T21:13:00Z",
            "awsRegion": "us-east-1",
            "eventID": "EXAMPLE-9b6f-45f8-bc6b-9b41c052ebc7",
            "eventType": "AwsCloudTrailInsight",
            "recipientAccountId": "123456789012",
            "sharedEventID": "EXAMPLE8-02b2-4e93-9aab-08ed47ea5fd3",
            "insightDetails": {
            "state": "Start",
            "eventSource": "autoscaling.amazonaws.com",
            "eventName": "CompleteLifecycleAction",
            "insightType": "ApiCallRateInsight",
            "insightContext": {
              "statistics": {
                "baseline": {
                  "average": 0.0000882145
                },
                "insight": {
                  "average": 0.6
                },
                "insightDuration": 5,
                "baselineDuration": 11336
              },
              "attributions": [
                {
                  "attribute": "userIdentityArn",
                  "insight": [
                    {
                      "value": "arn:aws:sts::012345678901:assumed-role/CodeDeployRole1",
                      "average": 0.2
                    },
                    {
                      "value": "arn:aws:sts::012345678901:assumed-role/CodeDeployRole2",
                      "average": 0.2
                    },
                    {
                      "value": "arn:aws:sts::012345678901:assumed-role/CodeDeployRole3",
                      "average": 0.2
                    }
                  ],
                  "baseline": [
                    {
                      "value": "arn:aws:sts::012345678901:assumed-role/CodeDeployRole1",
                      "average": 0.0000882145
                    }
                  ]
                },
                {
                  "attribute": "userAgent",
                  "insight": [
                    {
                      "value": "codedeploy.amazonaws.com",
                      "average": 0.6
                    }
                  ],
                  "baseline": [
                    {
                      "value": "codedeploy.amazonaws.com",
                      "average": 0.0000882145
                    }
                  ]
                },
                {
                  "attribute": "errorCode",
                  "insight": [
                    {
                      "value": "null",
                      "average": 0.6
                    }
                  ],
                  "baseline": [
                    {
                      "value": "null",
                      "average": 0.0000882145
                    }
                  ]
                }
              ]
            }
          },
            "eventCategory": "Insight"
        },
        {
            "eventVersion": "1.07",
            "eventTime": "2019-10-15T21:14:00Z",
            "awsRegion": "us-east-1",
            "eventID": "EXAMPLEc-9eac-4af6-8e07-26a5ae8786a5",
            "eventType": "AwsCloudTrailInsight",
            "recipientAccountId": "123456789012",
            "sharedEventID": "EXAMPLE8-02b2-4e93-9aab-08ed47ea5fd3",
            "insightDetails": {
            "state": "End",
            "eventSource": "autoscaling.amazonaws.com",
            "eventName": "CompleteLifecycleAction",
            "insightType": "ApiCallRateInsight",
            "insightContext": {
              "statistics": {
                "baseline": {
                  "average": 0.0000882145
                },
                "insight": {
                  "average": 0.6
                },
                "insightDuration": 5,
                "baselineDuration": 11336
              },
              "attributions": [
                {
                  "attribute": "userIdentityArn",
                  "insight": [
                    {
                      "value": "arn:aws:sts::012345678901:assumed-role/CodeDeployRole1",
                      "average": 0.2
                    },
                    {
                      "value": "arn:aws:sts::012345678901:assumed-role/CodeDeployRole2",
                      "average": 0.2
                    },
                    {
                      "value": "arn:aws:sts::012345678901:assumed-role/CodeDeployRole3",
                      "average": 0.2
                    }
                  ],
                  "baseline": [
                    {
                      "value": "arn:aws:sts::012345678901:assumed-role/CodeDeployRole1",
                      "average": 0.0000882145
                    }
                  ]
                },
                {
                  "attribute": "userAgent",
                  "insight": [
                    {
                      "value": "codedeploy.amazonaws.com",
                      "average": 0.6
                    }
                  ],
                  "baseline": [
                    {
                      "value": "codedeploy.amazonaws.com",
                      "average": 0.0000882145
                    }
                  ]
                },
                {
                  "attribute": "errorCode",
                  "insight": [
                    {
                      "value": "null",
                      "average": 0.6
                    }
                  ],
                  "baseline": [
                    {
                      "value": "null",
                      "average": 0.0000882145
                    }
                  ]
                }
              ]
            }
          },
            "eventCategory": "Insight"
        }
    ]
}

Untuk penjelasan tentang bidang terkait pencarian di output, lihat Bidang keluaran pencarian di topik ini. Untuk penjelasan bidang dalam acara Wawasan, lihatCloudTrail isi rekam.

Menentukan jumlah peristiwa Insights yang akan dikembalikan

Untuk menentukan jumlah acara yang akan dikembalikan, ketik perintah berikut.


aws cloudtrail lookup-events --event-category insight --max-results <integer>

Nilai default untuk <integer>, jika tidak ditentukan, adalah 10. Nilai yang mungkin adalah 1 hingga 50. Contoh berikut mengembalikan satu hasil.


aws cloudtrail lookup-events --event-category insight --max-results 1

Mencari acara Wawasan berdasarkan rentang waktu

Insights event dari 90 hari terakhir tersedia untuk pencarian. Untuk menentukan rentang waktu, ketik perintah berikut.


aws cloudtrail lookup-events --event-category insight --start-time <timestamp> --end-time <timestamp>

--start-time <timestamp>menetapkan, dalamUTC, bahwa hanya peristiwa Wawasan yang terjadi setelah atau pada waktu yang ditentukan dikembalikan. Jika waktu mulai yang ditentukan adalah setelah waktu akhir yang ditentukan, kesalahan dikembalikan.

--end-time <timestamp>menetapkan, dalamUTC, bahwa hanya peristiwa Wawasan yang terjadi sebelum atau pada waktu yang ditentukan dikembalikan. Jika waktu akhir yang ditentukan sebelum waktu mulai yang ditentukan, kesalahan dikembalikan.

Waktu mulai default adalah tanggal paling awal bahwa data tersedia dalam 90 hari terakhir. Waktu akhir default adalah waktu peristiwa yang terjadi paling dekat dengan waktu saat ini.

Semua stempel waktu ditampilkan di. UTC

Mencari acara Wawasan berdasarkan atribut

Untuk memfilter berdasarkan atribut, ketik perintah berikut.


aws cloudtrail lookup-events --event-category insight --lookup-attributes AttributeKey=<attribute>,AttributeValue=<string>

Anda hanya dapat menentukan satu pasangan nilai kunci atribut untuk setiap lookup-events perintah. Berikut ini adalah nilai acara Insights yang valid untukAttributeKey. Nama nilai peka huruf besar/kecil.

EventId
EventName
EventSource

Panjang maksimum untuk AttributeValue adalah 2000 karakter. Karakter berikut (_'', '', , ',\\n') dihitung sebagai dua karakter menuju batas 2000 karakter.

Contoh pencarian atribut

Perintah contoh berikut mengembalikan peristiwa Wawasan di mana nilai EventName adalahPutRule.


aws cloudtrail lookup-events --event-category insight --lookup-attributes AttributeKey=EventName, AttributeValue=PutRule

Perintah contoh berikut mengembalikan peristiwa Wawasan di mana nilai EventId adalahb5cc8c40-12ba-4d08-a8d9-2bceb9a3e002.


aws cloudtrail lookup-events --event-category insight --lookup-attributes AttributeKey=EventId, AttributeValue=b5cc8c40-12ba-4d08-a8d9-2bceb9a3e002

Perintah contoh berikut mengembalikan peristiwa Wawasan di mana nilai EventSource adalahiam.amazonaws.com.


aws cloudtrail lookup-events --event-category insight --lookup-attributes AttributeKey=EventSource, AttributeValue=iam.amazonaws.com

Menentukan halaman hasil berikutnya

Untuk mendapatkan halaman hasil berikutnya dari lookup-events perintah, ketik perintah berikut.


aws cloudtrail lookup-events --event-category insight <same parameters as previous command> --next-token=<token>

Dalam perintah ini, nilai untuk <token> diambil dari bidang pertama dari output dari perintah sebelumnya.

Saat Anda menggunakan --next-token perintah, Anda harus menggunakan parameter yang sama seperti pada perintah sebelumnya. Misalnya, Anda menjalankan perintah berikut.


aws cloudtrail lookup-events --event-category insight --lookup-attributes AttributeKey=EventName, AttributeValue=PutRule

Untuk mendapatkan halaman hasil berikutnya, perintah Anda berikutnya akan terlihat seperti berikut.


aws cloudtrail lookup-events --event-category insight --lookup-attributes AttributeKey=EventName,AttributeValue=PutRule --next-token=EXAMPLEZe++mErCebpy2TgaMgmDvF1kYGFcH64JSjIbZFjsuvrSqg66b5YGssKutDYIyII4lrP4IDbeQdiObkp9YAlju3oXd12juEXAMPLE=

Mendapatkan JSON masukan dari sebuah file

AWS CLI Untuk beberapa AWS layanan memiliki dua parameter, --generate-cli-skeleton dan--cli-input-json, yang dapat Anda gunakan untuk menghasilkan JSON template, yang dapat Anda modifikasi dan gunakan sebagai input ke --cli-input-json parameter. Bagian ini menjelaskan cara menggunakan parameter ini denganaws cloudtrail lookup-events. Untuk informasi lebih lanjut, lihat AWS CLI kerangka dan file input.

Untuk mencari acara Insights dengan mendapatkan JSON masukan dari file

Buat template input untuk digunakan lookup-events dengan mengarahkan --generate-cli-skeleton output ke file, seperti pada contoh berikut.


aws cloudtrail lookup-events --event-category insight --generate-cli-skeleton > LookupEvents.txt

File template yang dihasilkan (dalam hal ini, LookupEvents .txt) terlihat seperti berikut.



{
    "LookupAttributes": [
        {
            "AttributeKey": "",
            "AttributeValue": ""
        }
    ],
    "StartTime": null,
    "EndTime": null,
    "MaxResults": 0,
    "NextToken": ""
}

Gunakan editor teks untuk memodifikasi JSON sesuai kebutuhan. JSONInput harus berisi hanya nilai yang ditentukan.

penting
Semua nilai kosong atau nol harus dihapus dari template sebelum Anda dapat menggunakannya.

Contoh berikut menentukan rentang waktu dan jumlah maksimum hasil untuk kembali.
```
{
    "StartTime": "2023-11-01",
    "EndTime": "2023-12-12",
    "MaxResults": 10
}                         
```
Untuk menggunakan file yang diedit sebagai input, gunakan sintaks --cli-input-json file://<filename>, seperti pada contoh berikut.
```
aws cloudtrail lookup-events --event-category insight --cli-input-json file://LookupEvents.txt
```

catatan

Anda dapat menggunakan argumen lain pada baris perintah yang sama dengan--cli-input-json.

Bidang keluaran pencarian

Peristiwa

Daftar peristiwa pencarian berdasarkan atribut lookup dan rentang waktu yang ditentukan. Daftar acara diurutkan berdasarkan waktu, dengan acara terbaru terdaftar terlebih dahulu. Setiap entri berisi informasi tentang permintaan pencarian dan menyertakan representasi string dari CloudTrail peristiwa yang diambil.

Entri berikut menjelaskan bidang di setiap acara pencarian.

CloudTrailEvent

Sebuah JSON string yang berisi representasi objek dari acara yang dikembalikan. Untuk informasi tentang masing-masing elemen yang dikembalikan, lihat Rekam Isi Tubuh.

EventId

Sebuah string yang GUID berisi acara dikembalikan.

EventName

Sebuah string yang berisi nama acara dikembalikan.

EventSource

AWS Layanan yang diminta untuk dibuat.

EventTime

Tanggal dan waktu, dalam format UNIX waktu, acara.

Sumber Daya

Daftar sumber daya yang direferensikan oleh acara yang dikembalikan. Setiap entri sumber daya menentukan jenis sumber daya dan nama sumber daya.

ResourceName

String yang berisi nama sumber daya yang direferensikan oleh acara tersebut.

ResourceType

String yang berisi jenis sumber daya yang direferensikan oleh acara tersebut. Ketika jenis sumber daya tidak dapat ditentukan, null dikembalikan.

Nama Pengguna

String yang berisi nama pengguna akun untuk acara yang dikembalikan.

NextToken

Sebuah string untuk mendapatkan halaman berikutnya dari hasil dari lookup-events perintah sebelumnya. Untuk menggunakan token, parameternya harus sama dengan yang ada di perintah asli. Jika tidak ada NextToken entri yang muncul di output, tidak ada lagi hasil untuk dikembalikan.

Untuk informasi selengkapnya tentang acara CloudTrail Wawasan, lihat Acara Logging Insights di panduan ini.

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Melihat peristiwa CloudTrail Insights untuk jejak dengan konsol

Menyalin acara jejak ke Danau CloudTrail

Melihat acara CloudTrail Wawasan untuk jalur dengan AWS CLI

Daftar Isi

Prasyarat

catatan

Mendapatkan bantuan baris perintah

Mencari acara Wawasan

Menentukan jumlah peristiwa Insights yang akan dikembalikan

Mencari acara Wawasan berdasarkan rentang waktu

Mencari acara Wawasan berdasarkan atribut

Contoh pencarian atribut

Menentukan halaman hasil berikutnya

Mendapatkan JSON masukan dari sebuah file

Untuk mencari acara Insights dengan mendapatkan JSON masukan dari file

penting

catatan

Bidang keluaran pencarian