View a markdown version of this page

Mencatat panggilan Amazon SageMaker AI API menggunakan AWS CloudTrail - Amazon SageMaker AI
Per SageMaker istiwa data Amazon AI di CloudTrailA SageMaker cara manajemen AI Amazon di CloudTrailOperasi yang Dilakukan oleh Penyetelan Model OtomatisContoh acara Amazon SageMaker AI

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

Mencatat panggilan Amazon SageMaker AI API menggunakan AWS CloudTrail

Amazon SageMaker AI terintegrasi dengan AWS CloudTrail, layanan yang menyediakan catatan tindakan yang diambil oleh pengguna, peran, atau Layanan AWS. CloudTrail menangkap semua panggilan API untuk Amazon SageMaker AI sebagai peristiwa. Panggilan yang ditangkap termasuk panggilan dari konsol Amazon SageMaker AI dan panggilan kode ke operasi Amazon SageMaker AI API. Dengan menggunakan informasi yang dikumpulkan oleh CloudTrail, Anda dapat menentukan permintaan yang dibuat ke Amazon SageMaker AI, alamat IP dari mana permintaan dibuat, kapan itu dibuat, dan detail tambahan.

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

  • Baik permintaan tersebut dibuat dengan kredensial pengguna root atau pengguna.

  • Apakah permintaan dibuat atas nama pengguna Pusat Identitas IAM.

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

  • Apakah permintaan tersebut dibuat oleh Layanan AWS lain.

CloudTrail aktif di akun Anda Akun AWS saat Anda membuat akun dan Anda secara otomatis memiliki akses ke riwayat CloudTrail Acara. Ri CloudTrail wayat acara menyediakan catatan yang dapat dilihat, dapat dicari, dapat diunduh, dan tidak dapat diubah dari 90 hari terakhir dari peristiwa manajemen yang direkam dalam sebuah. Wilayah AWS Untuk informasi selengkapnya, lihat Bek erja dengan riwayat CloudTrail acara di Panduan AWS CloudTrail Pengguna. Tidak ada CloudTrail biaya untuk melihat ri wayat acara.

Untuk catatan peristiwa yang berkelanjutan dalam 90 hari Akun AWS terakhir Anda, buat jejak atau penyimpanan data acara CloudTrail Lake.

CloudTrail jalan setapak

Jej ak CloudTrail memungkinkan pengiriman file log ke bucket Amazon S3. Semua jalur yang dibuat menggunakan Multi-wilayah. Konsol Manajemen AWS Anda dapat membuat jejak wilayah tunggal atau multi-wilayah dengan menggunakan. AWS CLI Membuat jejak Multi-wilayah disarankan karena Anda menangkap aktivitas di semua Wilayah AWS di akun Anda. Jika Anda membuat jejak satu wilayah, Anda hanya dapat melihat peristiwa yang dicatat di jalur tersebut Wilayah AWS. Untuk informasi selengkapnya tentang jalur, lihat Membuat jejak untuk Anda Akun AWS dan Membuat jejak untuk organisasi di Panduan AWS CloudTrail Pengguna.

Anda dapat mengirimkan satu salinan acara manajemen yang sedang berlangsung ke bucket Amazon S3 Anda tanpa biaya CloudTrail dengan membuat jejak, namun, ada biaya penyimpanan Amazon S3. Untuk informasi selengkapnya tentang CloudTrail harga, lihat AWS CloudTrail Harga. Untuk informasi tentang harga Amazon S3, lihat Harga Amazon S3.

CloudTrail Penyimpanan data acara danau

CloudTrail Lake memungkinkan Anda menjalankan SQL-based kueri pada acara Anda. CloudTrail Lake mengonversi peristiwa yang ada dalam format JSON berbasis baris ke format Apache ORC. ORC adalah format penyimpanan kolumnar yang dioptimalkan untuk pengambilan data dengan cepat. Peristiwa digabungkan ke dalam penyimpanan data peristiwa, yang merupakan kumpulan peristiwa yang tidak dapat diubah berdasarkan kriteria yang Anda pilih dengan menerapkan pemilih peristiwa lanj utan. Pemilih yang Anda terapkan ke penyimpanan data peristiwa mengontrol peristiwa mana yang bertahan dan tersedia untuk Anda kueri. Untuk informasi selengkapnya tentang CloudTrail Danau, lihat Bek erja dengan AWS CloudTrail Danau di Panduan AWS CloudTrail Pengguna.

CloudTrail Penyimpanan dan kueri data acara danau dikenakan biaya. Saat membuat penyimpanan data peristiwa, Anda memilih opsi harga yang ingin Anda gunakan untuk penyimpanan data peristiwa. Opsi penetapan harga menentukan biaya untuk menelan dan menyimpan peristiwa, serta periode retensi default dan maksimum untuk penyimpanan data peristiwa. Untuk informasi selengkapnya tentang CloudTrail harga, lihat AWS CloudTrail Harga.

Untuk tujuan keamanan, Anda dapat memantau CloudTrail log untuk mengidentifikasi aktivitas pengguna yang tidak normal. Untuk informasi selengkapnya tentang log pemantauan, lihatPembuatan Log dan Pemantauan.

Per SageMaker istiwa data Amazon AI di CloudTrail

Peristiwa data memberikan informasi tentang operasi sumber daya yang dilakukan pada atau di sumber daya (misalnya, membaca atau menulis ke objek Amazon S3). Ini juga dikenal sebagai operasi bidang data. Peristiwa data sering kali merupakan aktivitas bervolume tinggi. Secara default, CloudTrail tidak mencatat peristiwa data. Ri CloudTrail wayat peristiwa tidak merekam peristiwa data.

Biaya tambahan berlaku untuk peristiwa data. Untuk informasi selengkapnya tentang CloudTrail harga, lihat AWS CloudTrail Harga.

Anda dapat mencatat peristiwa data untuk berbagai jenis sumber daya Amazon SageMaker AI dengan menggunakan CloudTrail konsol, AWS CLI, atau operasi CloudTrail API. Untuk informasi selengkapnya tentang cara mencatat peristiwa data, lihat Pencatatan peristiwa data dengan Konsol Manajemen AWS dan Pencatatan peristiwa data dengan AWS Command Line Interface di Panduan AWS CloudTrail Pengguna.

Tabel berikut mencantumkan jenis sumber daya Amazon SageMaker AI yang dapat Anda catat peristiwa datanya. Kolom Jenis sumber daya (konsol) menunjukkan nilai untuk dipilih dari daftar jenis sumber daya di CloudTrail konsol. Kolom nilai resources.type menunjukkan resources.type nilai, yang akan Anda tentukan saat mengonfigurasi pemilih acara lanjutan menggunakan API or. AWS CLI CloudTrail CloudTrailKol om API Data yang dicatat ke menampilkan panggilan API yang dicatat CloudTrail untuk jenis sumber daya.

Jenis sumber daya (konsol) nilai resource.type API data log ke CloudTrail
SageMaker titik akhir AWS::SageMaker::Endpoint
SageMaker lowongan kerja AWS::SageMaker::Job
catatan

Pang InvokeEndpoint gilan InvokeEndpointAsyncSample,,, dan SampleWithResponseStream API tidak mencatat parameter permintaan.

Anda dapat mengonfigurasi pemilih acara lanjutan untuk memfilter eventNamereadOnly,, dan resources.ARN bidang untuk mencatat hanya peristiwa yang penting bagi Anda. Untuk informasi selengkapnya tentang bidang ini, lihat AdvancedFieldSelector di Refer AWS CloudTrail ensi API.

Contoh berikut menunjukkan cara mencatat peristiwa data untuk SageMaker titik akhir Amazon dan SageMaker pekerjaan Amazon. Dalam contoh ini, Anda menggunakan AWS CLI perintah put-event-selectors untuk menambahkan pemilih peristiwa lanjutan yang menangkap peristiwa data dari titik akhir Anda. Anda harus memiliki CloudTrail jejak yang ada. Sebelum menjalankan perintah, Anda juga dapat menyimpan objek JSON pemilih acara lanjutan dalam file seperti berikut:

[
  {
    "FieldSelectors": [
      {
        "Field": "eventCategory",
        "Equals": ["Data"]
      },
      {
        "Field": "resources.ARN",
        "Equals": ["arn:aws:sagemaker:us-east-1:111122223333:endpoint/your-inference-endpoint-arn"]
      },
      {
        "Field": "resources.type",
        "Equals": ["AWS::SageMaker::Endpoint"]
      }
    ]
  },
  {
    "FieldSelectors": [
      {
        "Field": "eventCategory",
        "Equals": ["Data"]
      },
      {
        "Field": "resources.ARN",
        "Equals": ["arn:aws:sagemaker:us-east-1:111122223333:job/your-job-arn"]
      },
      {
        "Field": "resources.type",
        "Equals": ["AWS::SageMaker::Job"]
      }
    ]
  }
]

Kemudian, Anda dapat menjalankan perintah berikut untuk mulai mencatat peristiwa data dari titik akhir.

aws cloudtrail put-event-selectors
      --trail-name your-trail-name
      --advanced-event-selectors=file://advanced-event-selectors.json # specify your previously created JSON file

A SageMaker cara manajemen AI Amazon di CloudTrail

Acara manajemen memberikan informasi tentang operasi manajemen yang dilakukan pada sumber daya di Anda Akun AWS. Ini juga dikenal sebagai operasi bidang kontrol. Secara default, CloudTrail mencatat peristiwa manajemen.

Amazon SageMaker AI mencatat semua operasi pesawat kontrol Amazon SageMaker AI sebagai peristiwa manajemen. Untuk daftar operasi pesawat kontrol Amazon SageMaker AI yang dicatat Amazon SageMaker AI CloudTrail, lihat Referensi API Amazon SageMaker AI.

Operasi yang Dilakukan oleh Penyetelan Model Otomatis

SageMaker AI mendukung pencatatan peristiwa layanan non-API ke file CloudTrail log Anda untuk pekerjaan penyetelan model otomatis. Peristiwa ini terkait dengan pekerjaan penyetelan Anda tetapi, bukan hasil langsung dari permintaan pelanggan ke AWS API publik. Misalnya, saat Anda membuat pekerjaan penyetelan hyperparameter dengan memanggil CreateHyperParameterTuningJob, SageMaker AI membuat pekerjaan pelatihan untuk mengevaluasi berbagai kombinasi hyperparameter untuk menemukan hasil terbaik. Demikian pula, ketika Anda memanggil StopHyperParameterTuningJob untuk menghentikan pekerjaan penyetelan hyperparameter, SageMaker AI mungkin menghentikan salah satu pekerjaan pelatihan lari yang terkait. Non-API peristiwa untuk pekerjaan penyetelan Anda dicatat CloudTrail untuk membantu Anda meningkatkan tata kelola, kepatuhan, serta audit operasional dan risiko AWS akun Anda.

Entri log yang dihasilkan dari peristiwa layanan non-API memiliki oreventType, AwsServiceEvent bukan. AwsApiCall

Contoh acara Amazon SageMaker AI

Peristiwa mewakili permintaan tunggal dari sumber apa pun dan mencakup informasi tentang operasi API yang diminta, tanggal dan waktu operasi, parameter permintaan, dan sebagainya. CloudTrail file log bukanlah jejak tumpukan yang diurutkan dari panggilan API publik, jadi acara tidak muncul dalam urutan tertentu.

Contoh berikut menunjukkan CloudTrail peristiwa yang menunjukkan CreateEndpoint operasi.

{
    "eventVersion":"1.05",
    "userIdentity": {
        "type":"IAMUser",
        "principalId":"AIXDAYQEXAMPLEUMLYNGL",
        "arn":"arn:aws:iam::123456789012:user/intern",
        "accountId":"123456789012",
        "accessKeyId":"ASXIAGXEXAMPLEQULKNXV",
        "userName":"intern"
    },
    "eventTime":"2018-01-02T13:39:06Z",
    "eventSource":"sagemaker.amazonaws.com",
    "eventName":"CreateEndpoint",
    "awsRegion":"us-west-2",
    "sourceIPAddress":"127.0.0.1",
    "userAgent":"USER_AGENT",
    "requestParameters": {
        "endpointName":"ExampleEndpoint",
        "endpointConfigName":"ExampleEndpointConfig"
    },
    "responseElements": {
        "endpointArn":"arn:aws:sagemaker:us-west-2:123456789012:endpoint/exampleendpoint"
    },
    "requestID":"6b1b42b9-EXAMPLE",
    "eventID":"a6f85b21-EXAMPLE",
    "eventType":"AwsApiCall",
    "recipientAccountId":"444455556666"
}

Contoh berikut menunjukkan CloudTrail peristiwa yang menunjukkan CreateModel operasi.

{
    "eventVersion":"1.05",
    "userIdentity": {
        "type":"IAMUser",
        "principalId":"AIXDAYQEXAMPLEUMLYNGL",
        "arn":"arn:aws:iam::123456789012:user/intern",
        "accountId":"123456789012",
        "accessKeyId":"ASXIAGXEXAMPLEQULKNXV",
        "userName":"intern"
    },
    "eventTime":"2018-01-02T15:23:46Z",
    "eventSource":"sagemaker.amazonaws.com",
    "eventName":"CreateModel",
    "awsRegion":"us-west-2",
    "sourceIPAddress":"127.0.0.1",
    "userAgent":"USER_AGENT",
    "requestParameters": {
        "modelName":"ExampleModel",
        "primaryContainer": {
            "image":"174872318107.dkr.ecr.us-west-2.amazonaws.com/kmeans:latest"
        },
        "executionRoleArn":"arn:aws:iam::123456789012:role/EXAMPLEARN"
    },
    "responseElements": {
        "modelArn":"arn:aws:sagemaker:us-west-2:123456789012:model/barkinghappy2018-01-02t15-23-32-275z-ivrdog"
    },
    "requestID":"417b8dab-EXAMPLE",
    "eventID":"0f2b3e81-EXAMPLE",
    "eventType":"AwsApiCall",
    "recipientAccountId":"444455556666"
}

Contoh berikut menunjukkan peristiwa CloudTrail data untuk pekerjaan SageMaker AI.

Contoh berikut menunjukkan CloudTrail peristiwa yang menunjukkan CompleteRollout operasi.

{
    "eventVersion": "1.11",
    "userIdentity": {
        "type":"IAMUser",
        "principalId":"AIXDAYQEXAMPLEUMLYNGL",
        "arn":"arn:aws:iam::123456789012:user/intern",
        "accountId":"123456789012",
        "accessKeyId":"ASXIAGXEXAMPLEQULKNXV",
        "userName":"intern"
    },
    "eventTime": "2024-01-15T02:07:50Z",
    "eventSource": "sagemaker.amazonaws.com",
    "eventName": "CompleteRollout",
    "awsRegion": "us-west-2",
    "sourceIPAddress":"127.0.0.1",
    "userAgent":"USER_AGENT",
    "requestParameters": {
        "jobArn": "arn:aws:sagemaker:us-west-2:123456789012:job/my-job-name",
        "trajectoryId": "my-trajectory-id",
        "status": "ready"
    },
    "responseElements": null,
    "requestID": "d9278f6e-EXAMPLE",
    "eventID": "6cbd2cde-EXAMPLE",
    "readOnly": false,
    "resources": [
        {
            "accountId": "123456789012",
            "type": "AWS::SageMaker::Job",
            "ARN": "arn:aws:sagemaker:us-west-2:123456789012:job/AgentRFT/my-job-name"
        }
    ],
    "eventType": "AwsApiCall",
    "managementEvent": false,
    "recipientAccountId": "444455556666",
    "eventCategory": "Data"
}

Contoh berikut menunjukkan CloudTrail peristiwa yang menunjukkan Sample operasi.

{
    "eventVersion": "1.11",
    "userIdentity": {
        "type":"IAMUser",
        "principalId":"AIXDAYQEXAMPLEUMLYNGL",
        "arn":"arn:aws:iam::123456789012:user/intern",
        "accountId":"123456789012",
        "accessKeyId":"ASXIAGXEXAMPLEQULKNXV",
        "userName":"intern"
    },
    "eventTime": "2024-01-15T02:07:35Z",
    "eventSource": "sagemaker.amazonaws.com",
    "eventName": "Sample",
    "awsRegion": "us-west-2",
    "sourceIPAddress":"127.0.0.1",
    "userAgent": "USER_AGENT",
    "requestParameters": {
        "body": "HIDDEN_DUE_TO_SECURITY_REASONS",
        "jobArn": "arn:aws:sagemaker:us-west-2:123456789012:job/AgentRFT/my-job-name",
        "trajectoryId": "my-trajectory-id"
    },
    "responseElements": {
        "body": "HIDDEN_DUE_TO_SECURITY_REASONS"
    },
    "requestID": "ab32a279-EXAMPLE",
    "eventID": "56cd262e-EXAMPLE",
    "readOnly": false,
    "resources": [
        {
            "accountId": "123456789012",
            "type": "AWS::SageMaker::Job",
            "ARN": "arn:aws:sagemaker:us-west-2:123456789012:job/AgentRFT/my-job-name"
        }
    ],
    "eventType": "AwsApiCall",
    "managementEvent": false,
    "recipientAccountId": "444455556666",
    "eventCategory": "Data"
}

Contoh berikut menunjukkan CloudTrail peristiwa yang menunjukkan SampleWithResponseStream operasi.

{
    "eventVersion": "1.11",
    "userIdentity": {
        "type":"IAMUser",
        "principalId":"AIXDAYQEXAMPLEUMLYNGL",
        "arn":"arn:aws:iam::123456789012:user/intern",
        "accountId":"123456789012",
        "accessKeyId":"ASXIAGXEXAMPLEQULKNXV",
        "userName":"intern"
    },
    "eventTime": "2024-01-15T02:07:47Z",
    "eventSource": "sagemaker.amazonaws.com",
    "eventName": "SampleWithResponseStream",
    "awsRegion": "us-west-2",
    "sourceIPAddress":"127.0.0.1",
    "userAgent": "USER_AGENT",
    "requestParameters": {
        "trajectoryId": "my-trajectory-id",
        "jobArn": "arn:aws:sagemaker:us-west-2:123456789012:job/AgentRFT/my-job-name",
        "body": "HIDDEN_DUE_TO_SECURITY_REASONS"
    },
    "responseElements": {
        "body": "HIDDEN_DUE_TO_SECURITY_REASONS"
    },
    "requestID": "02c72dac-EXAMPLE",
    "eventID": "8dcc5ebb-EXAMPLE",
    "readOnly": false,
    "resources": [
        {
            "accountId": "123456789012",
            "type": "AWS::SageMaker::Job",
            "ARN": "arn:aws:sagemaker:us-west-2:123456789012:job/AgentRFT/my-job-name"
        }
    ],
    "eventType": "AwsApiCall",
    "managementEvent": false,
    "recipientAccountId": "444455556666",
    "eventCategory": "Data"
}

Untuk informasi tentang konten CloudTrail rekaman, lihat konten CloudTrail rek aman di Panduan AWS CloudTrail Pengguna.