Logging Amazon Comprehend panggilan API dengan AWS CloudTrail

Amazon Comprehend AWS CloudTrail terintegrasi dengan, layanan yang menyediakan catatan tindakan yang diambil oleh pengguna, peran, atau AWS layanan di Amazon Comprehend. CloudTrail menangkap panggilan API untuk Amazon Comprehend sebagai peristiwa. Panggilan yang diambil termasuk panggilan dari konsol Amazon Comprehend dan panggilan kode ke operasi Amazon Comprehend API. Jika Anda membuat jejak, Anda dapat mengaktifkan pengiriman CloudTrail acara secara berkelanjutan ke bucket Amazon S3, termasuk acara untuk Amazon Comprehend. Jika Anda tidak mengonfigurasi jejak, Anda masih dapat melihat peristiwa terbaru di CloudTrail konsol dalam Riwayat acara. Dengan menggunakan informasi yang dikumpulkan oleh CloudTrail, Anda dapat menentukan permintaan yang dibuat untuk Amazon Comprehend, alamat IP dari mana permintaan dibuat, siapa yang membuat permintaan, kapan dibuat, dan detail tambahan.

Untuk mempelajari selengkapnya CloudTrail, termasuk cara mengonfigurasi dan mengaktifkannya, lihat Panduan AWS CloudTrail Pengguna.

Amazon Comprehend informasi di CloudTrail

CloudTrail diaktifkan pada Akun AWS saat Anda membuat akun. Ketika aktivitas peristiwa yang didukung terjadi di Amazon Comprehend, aktivitas tersebut direkam CloudTrail dalam suatu peristiwa bersama AWS dengan peristiwa layanan lainnya dalam riwayat Acara. Anda dapat melihat, mencari, dan mengunduh peristiwa terbaru di Akun AWS Anda. Untuk informasi selengkapnya, lihat Melihat peristiwa dengan riwayat CloudTrail acara.

Untuk catatan acara yang sedang berlangsung di AndaAkun AWS, termasuk acara untuk Amazon Comprehend, buat jejak. Jejak memungkinkan CloudTrail untuk mengirimkan file log ke bucket Amazon S3. Secara default, saat Anda membuat jejak di konsol tersebut, jejak diterapkan ke semua Wilayah AWS. Jejak mencatat peristiwa dari semua Wilayah di partisi AWS dan mengirimkan file log ke bucket Amazon S3 yang Anda tentukan. Selain itu, Anda dapat mengonfigurasi AWS layanan lain untuk menganalisis lebih lanjut dan menindaklanjuti data peristiwa yang dikumpulkan dalam CloudTrail log. Untuk informasi selengkapnya, lihat berikut:

• Gambaran umum untuk membuat jejak

• CloudTrail layanan dan integrasi yang didukung

• Mengonfigurasi notifikasi Amazon SNS untuk CloudTrail

• Menerima file CloudTrail log dari beberapa wilayah dan Menerima file CloudTrail log dari beberapa akun

Amazon Comprehend mendukung pencatatan tindakan berikut sebagai peristiwa dalam file log: CloudTrail

• BatchDetectDominantLanguage

• BatchDetectEntities

• BatchDetectKeyPhrases

• BatchDetectSentiment

• BatchDetectSyntax

• ClassifyDocument

• CreateDocumentClassifier

• CreateEndpoint

• CreateEntityRecognizer

• DeleteDocumentClassifier

• DeleteEndpoint

• DeleteEntityRecognizer

• DescribeDocumentClassificationJob

• DescribeDocumentClassifier

• DescribeDominantLanguageDetectionJob

• DescribeEndpoint

• DescribeEntitiesDetectionJob

• DescribeEntityRecognizer

• DescribeKeyPhrasesDetectionJob

• DescribePiiEntitiesDetectionJob

• DescribeSentimentDetectionJob

• DescribeTargetedSentimentDetectionJob

• DescribeTopicsDetectionJob

• DetectDominantLanguage

• DetectEntities

• DetectKeyPhrases

• DetectPiiEntities

• DetectSentiment

• DetectSyntax

• ListDocumentClassificationJobs

• ListDocumentClassifiers

• ListDominantLanguageDetectionJobs

• ListEndpoints

• ListEntitiesDetectionJobs

• ListEntityRecognizers

• ListKeyPhrasesDetectionJobs

• ListPiiEntitiesDetectionJobs

• ListSentimentDetectionJobs

• ListTargetedSentimentDetectionJobs

• ListTagsForResource

• ListTopicsDetectionJobs

• StartDocumentClassificationJob

• StartDominantLanguageDetectionJob

• StartEntitiesDetectionJob

• StartKeyPhrasesDetectionJob

• StartPiiEntitiesDetectionJob

• StartSentimentDetectionJob

• StartTargetedSentimentDetectionJob

• StartTopicsDetectionJob

• StopDominantLanguageDetectionJob

• StopEntitiesDetectionJob

• StopKeyPhrasesDetectionJob

• StopPiiEntitiesDetectionJob

• StopSentimentDetectionJob

• StopTargetedSentimentDetectionJob

• StopTrainingDocumentClassifier

• StopTrainingEntityRecognizer

• TagResource

• UntagResource

• UpdateEndpoint

Setiap peristiwa atau entri log berisi informasi tentang siapa yang membuat permintaan tersebut. Informasi identitas membantu Anda menentukan berikut:

• Apakah permintaan dibuat dengan kredenal pengguna root.

• Apakah permintaan dibuat dengan kredensial keamanan sementara untuk suatu peran atau pengguna gabungan.

• Apakah permintaan dibuat oleh layanan AWS lain.

Untuk informasi selengkapnya, lihat Elemen userIdentity CloudTrail .

Contoh: Amazon Comprehend entri file log

Trail adalah konfigurasi yang memungkinkan pengiriman peristiwa sebagai file log ke bucket Amazon S3 yang Anda tentukan. CloudTrail file log berisi satu atau lebih entri log. Peristiwa mewakili permintaan tunggal dari sumber manapun dan mencakup informasi tentang tindakan yang diminta, tanggal dan waktu tindakan, parameter permintaan, dan sebagainya. CloudTrail file log bukanlah jejak tumpukan yang diurutkan dari panggilan API publik, jadi file tersebut tidak muncul dalam urutan tertentu.

Contoh berikut menunjukkan entri CloudTrail log yang menunjukkan ClassifyDocument tindakan.

{
    "eventVersion": "1.08",
    "userIdentity": {
        "type": "IAMUser",
        "principalId": "AROAICFHPEXAMPLE",
        "arn": "arn:aws:iam::12345678910:user/myadmin2",
        "accountId": "12345678910",
        "accessKeyId": "ASIA3VZEXAMPLE",
        "sessionContext": {
            "sessionIssuer": {},
            "webIdFederationData": {},
            "attributes": {
                "creationDate": "2023-10-19T14:22:09Z",
                "mfaAuthenticated": "false"
            }
        }
    },
    "eventTime": "2023-10-19T17:31:20Z",
    "eventSource": "comprehend.amazonaws.com",
    "eventName": "ClassifyDocument",
    "awsRegion": "us-east-2",
    "sourceIPAddress": "3.21.185.237",
    "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:109.0) Gecko/20100101 Firefox/115.0",
    "requestParameters": null,
    "responseElements": null,
    "requestID": "fd916e66-caac-46c9-a1fc-81a0ef33e61b",
    "eventID": "535ca22b-b3a3-4c13-b2c5-bf51ab082794",
    "readOnly": false,
    "resources": [
        {
            "accountId": "12345678910",
            "type": "AWS::Comprehend::DocumentClassifierEndpoint",
            "ARN": "arn:aws:comprehend:us-east-2:12345678910:document-classifier-endpoint/endpointExample"
        }
    ],
    "eventType": "AwsApiCall",
    "recipientAccountId": "12345678910"
}