Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Melihat rentang rekaman aktivitas Model Armor

Dokumen ini menjelaskan span Model Armor dalam trace dan cara melihat detailnya. Untuk mengetahui informasi selengkapnya tentang trace, lihat Melihat trace agen.

Tentang Cloud Trace dan observabilitas agen

Trace mewakili jalur permintaan di seluruh bagian aplikasi terdistribusi Anda. Artinya, setiap trace mewakili satu operasi end-to-end. Karena trace terdiri dari span, yang merupakan data untuk satu fungsi atau operasi, trace memungkinkan Anda mengikuti alur permintaan dan memeriksa data latensi. Informasi ini dapat membantu Anda mengidentifikasi akar masalah.

Cloud Trace adalah sistem pelacakan terdistribusi untuk Google Cloud, dan menyediakan fitur untuk menjelajahi trace atau menganalisis data trace dengan SQL. Namun, banyak layananGoogle Cloud , seperti Pemantauan Aplikasi dan Agent Registry, dapat menampilkan data yang dikelola oleh Cloud Trace. Layanan ini memungkinkan Anda melihat data trace dalam konteks layanan yang Anda gunakan.

Sebelum memulai

Aktifkan Cloud Trace, Cloud Logging, Telemetry, dan Model Armor API, jika ada yang belum diaktifkan.
Peran yang diperlukan untuk mengaktifkan API
Untuk mengaktifkan API, Anda memerlukan izin serviceusage.services.enable. Jika Anda membuat project, kemungkinan Anda sudah memiliki izin ini melalui peran Pemilik (roles/owner). Jika tidak, Anda bisa mendapatkan izin ini melalui peran Service Usage Admin (roles/serviceusage.serviceUsageAdmin). Pelajari cara memberikan peran.
Aktifkan API
Siapkan pelacakan untuk agen Anda.
Konfigurasi Model Armor di gateway atau di Google Cloud server MCP.

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk melihat data trace, minta administrator untuk memberi Anda peran IAM berikut di project Anda:

Cloud Trace User (roles/cloudtrace.user)
Logs Viewer (roles/logging.viewer)

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Untuk mengetahui informasi tentang peran lain yang mungkin Anda perlukan, lihat Kontrol akses Cloud Trace dan Kontrol akses Cloud Logging.

Payload yang didukung

Untuk mengetahui daftar payload yang didukung, lihat Payload yang didukung dan tidak didukung.

Untuk permintaan yang berisi payload yang tidak didukung, Model Armor akan menghasilkan span dengan error.

Nama dan atribut span Model Armor

Span Model Armor berikut tersedia:

Span induk: apply_guardrail "Google Cloud Model Armor"
Span turunan: Request Path
Span turunan: Response Path

Bagian berikut mencantumkan semua kemungkinan atribut span Model Armor. Tidak semua atribut ada di setiap span. Nama atribut ini dapat berubah sewaktu-waktu.

Atribut span induk

Span induk, apply_guardrail "Google Cloud Model Armor", memiliki atribut berikut:

cloud.provider: penyedia cloud yang terkait dengan operasi.
cloud.region: region Google Cloud tempat operasi terjadi.
gcp.project_id: ID project tempat operasi terjadi.
rpc.system: framework atau protokol remote procedure call (RPC) yang mendasari, yang digunakan untuk operasi—misalnya, grpc.
service.name: layanan Google Cloud yang terkait dengan operasi. Untuk span Model Armor, nilai kolom ini adalah modelarmor.

Atribut Jalur Permintaan

Span turunan Request Path memiliki atribut berikut:

gen_ai.security.target.type: jenis konten atau tindakan yang menerapkan guardrail. Dalam span Request Path, ini selalu input.
gen_ai.security.decision.type: keputusan atau tindakan yang diterapkan Model Armor. Nilai modify menunjukkan bahwa Model Armor telah menyamarkan (melakukan de-identifikasi) data sensitif dari konten sesuai dengan template yang disediakan.
gen_ai.security.decision.code: kode numerik untuk keputusan keamanan.
gen_ai.security.decision.reason: alasan keputusan yang dapat dibaca pengguna.
gen_ai.security.policy.id: nama resource lengkap template Model Armor dalam format projects/PROJECT_ID/locations/LOCATION/templates/MODEL_ARMOR_TEMPLATE_ID.
gen_ai.security.policy.name: nama template Model Armor yang digunakan untuk operasi.
gcp.modelarmor.filter.match.state: apakah konten melanggar salah satu filter Model Armor (juga disebut detektor).
gcp.modelarmor.violations: filter Model Armor yang dilanggar oleh konten. Nilai deidentified menunjukkan bahwa Model Armor menyamarkan data sensitif dari konten sesuai dengan template yang disediakan.
gcp.modelarmor.rai.violations: kategori responsible AI yang dilanggar oleh konten. Untuk mengetahui informasi selengkapnya, lihat Filter keamanan Responsible AI.
gcp.modelarmor.sdp.info_types: jenis data sensitif (seperti EMAIL_ADDRESS atau PHONE_NUMBER) yang diidentifikasi oleh filter Sensitive Data Protection.
error.type: ID untuk error yang terjadi.

Atribut Jalur Respons

Span turunan Response Path memiliki atribut berikut:

gen_ai.security.target.type: jenis konten atau tindakan yang menerapkan guardrail. Dalam span Response Path, ini selalu output.
gen_ai.security.decision.type: keputusan atau tindakan yang diterapkan Model Armor. Nilai modify menunjukkan bahwa Model Armor telah menyamarkan (melakukan de-identifikasi) data sensitif dari konten sesuai dengan template yang disediakan.
gen_ai.security.decision.code: kode numerik untuk keputusan keamanan.
gen_ai.security.decision.reason: alasan keputusan yang dapat dibaca pengguna.
gen_ai.security.policy.id: nama resource lengkap template Model Armor dalam format projects/PROJECT_ID/locations/LOCATION/templates/MODEL_ARMOR_TEMPLATE_ID.
gen_ai.security.policy.name: nama template Model Armor yang digunakan untuk operasi.
gcp.modelarmor.filter.match.state: apakah konten melanggar salah satu filter Model Armor (juga disebut detektor).
gcp.modelarmor.violations: filter Model Armor yang dilanggar oleh konten. Nilai deidentified menunjukkan bahwa Model Armor menyamarkan data sensitif dari konten sesuai dengan template yang disediakan.
gcp.modelarmor.rai.violations: kategori responsible AI yang dilanggar oleh konten. Untuk mengetahui informasi selengkapnya, lihat Filter keamanan Responsible AI.
gcp.modelarmor.sdp.info_types: jenis data sensitif (seperti EMAIL_ADDRESS atau PHONE_NUMBER) yang diidentifikasi oleh filter Sensitive Data Protection.
error.type: ID untuk error yang terjadi.

Melihat detail span Model Armor

Untuk melihat span Model Armor dan detailnya—termasuk atribut dan DAG-nya—ikuti langkah-langkah berikut:

Di konsol Google Cloud , buka Agent Registry.
Buka Agent Registry
Pilih project Anda.
Klik nama agen.
Klik tab Trace.
Klik ID trace yang ingin Anda lihat. Jika trace melibatkan span Model Armor, trace akan menyertakan span apply_guardrail "Google Cloud Model Armor".
Pelajari rekaman aktivitas:
- Untuk melihat trace sebagai directed acyclic graph (DAG), klik tampilan Graph. Tampilan ini menampilkan trace eksekusi agen sebagai diagram node-link. DAG menekankan hubungan sebab akibat dan dependensi antara span trace yang berbeda dan menunjukkan cara satu operasi memicu operasi berikutnya. Setiap node dalam grafik adalah span.
- Untuk melihat trace sebagai linimasa, klik tampilan Timeline. Setiap batang di linimasa mewakili span.
Klik span untuk melihat atributnya.

Atau, klik View in Cloud Trace untuk melihat semua span dalam project Anda melalui Trace explorer. Terapkan filter span untuk menelusuri span apply_guardrail "Google Cloud Model Armor".