يوضّح هذا المستند عملية تسجيل التدقيق في Cloud Firestore. Google Cloud تنشئ الخدمات سجلات تدقيق تسجّل أنشطة الإدارة والوصول ضمن موارد Google Cloud.
لمزيد من المعلومات عن "سجلّات تدقيق السحابة الإلكترونية"، يُرجى الاطّلاع على ما يلي:
- أنواع سجلّات التدقيق
- بنية إدخال في سجلّ التدقيق
- تخزين سجلّات التدقيق وتوجيهها
- Cloud Logging ملخّص الأسعار
- تفعيل سجلّات تدقيق الوصول إلى البيانات
ملاحظات
عند ضبط عملية تسجيل التدقيق، استخدِم اسم الخدمة datastore.googleapis.com
لضبط كل من datastore.googleapis.com وfirestore.googleapis.com.
Once configured, logs for the Cloud Firestore API include the service namefirestore.googleapis.com.
للاطّلاع على الوقت المستغرَق في معالجة طلب DATA_READ أو DATA_WRITE، راجِع حقل processing_duration ضمن عنصر metadata في AuditLog.
يصف الحقل processing_duration الوقت الذي استغرقته قاعدة البيانات لمعالجة طلب. وهذا أقل من وقت الاستجابة لدى المستخدم النهائي. وبشكل خاص، لا يشمل ذلك الحمل الزائد للشبكة.
اسم الخدمة
تستخدِم سجلّات التدقيق Cloud Firestore اسم الخدمة firestore.googleapis.com.
فلتر لهذه الخدمة:
protoPayload.serviceName="firestore.googleapis.com"
الطُرق حسب نوع الإذن
يحتوي كل إذن من أذونات إدارة الهوية وإمكانية الوصول (IAM) على السمة type، وقيمتها هي تعداد يمكن أن يكون إحدى القيم الأربع التالية: ADMIN_READ أو ADMIN_WRITE أو DATA_READ أو DATA_WRITE. عند استدعاء إحدى الطرق، تنشئ Cloud Firestore سجل تدقيق يعتمد تصنيفه على السمة type للإذن المطلوب لتنفيذ الطريقة.
تؤدي الطرق التي تتطلّب إذنًا من "إدارة الهوية وإمكانية الوصول" (IAM) مع قيمة السمة type التي تساوي DATA_READ أو DATA_WRITE أو ADMIN_READ إلى إنشاء سجلّات تدقيق الوصول إلى البيانات.
تؤدي الطرق التي تتطلّب إذنًا في "إدارة الهوية وإمكانية الوصول" (IAM) مع قيمة type ADMIN_WRITE إلى إنشاء سجلّات تدقيق نشاط المشرف.
| نوع الإذن | الإجراءات |
|---|---|
ADMIN_READ |
google.cloud.location.Locations.GetLocationgoogle.cloud.location.Locations.ListLocationsgoogle.firestore.admin.v1.FirestoreAdmin.GetBackupgoogle.firestore.admin.v1.FirestoreAdmin.GetBackupSchedulegoogle.firestore.admin.v1.FirestoreAdmin.GetDatabasegoogle.firestore.admin.v1.FirestoreAdmin.GetFieldgoogle.firestore.admin.v1.FirestoreAdmin.GetIndexgoogle.firestore.admin.v1.FirestoreAdmin.ListBackupSchedulesgoogle.firestore.admin.v1.FirestoreAdmin.ListBackupsgoogle.firestore.admin.v1.FirestoreAdmin.ListDatabasesgoogle.firestore.admin.v1.FirestoreAdmin.ListFieldsgoogle.firestore.admin.v1.FirestoreAdmin.ListIndexesgoogle.firestore.admin.v1beta1.FirestoreAdmin.GetIndexgoogle.firestore.admin.v1.MongoDBCompatible.ListIndexesgoogle.firestore.admin.v1.MongoDBCompatible.ListDatabases
|
ADMIN_WRITE |
google.firestore.admin.v1.FirestoreAdmin.CreateBackupSchedulegoogle.firestore.admin.v1.FirestoreAdmin.CreateDatabasegoogle.firestore.admin.v1.FirestoreAdmin.CreateIndexgoogle.firestore.admin.v1.FirestoreAdmin.DeleteBackupgoogle.firestore.admin.v1.FirestoreAdmin.DeleteBackupSchedulegoogle.firestore.admin.v1.FirestoreAdmin.DeleteDatabasegoogle.firestore.admin.v1.FirestoreAdmin.DeleteIndexgoogle.firestore.admin.v1.FirestoreAdmin.RestoreDatabasegoogle.firestore.admin.v1.FirestoreAdmin.UpdateBackupSchedulegoogle.firestore.admin.v1.FirestoreAdmin.UpdateDatabasegoogle.firestore.admin.v1.FirestoreAdmin.UpdateFieldgoogle.longrunning.Operations.CancelOperationgoogle.longrunning.Operations.DeleteOperation
|
DATA_READ |
google.firestore.v1.MongoDBCompatible.Findgoogle.firestore.v1.MongoDBCompatible.Aggregategoogle.firestore.v1.MongoDBCompatible.GetMoregoogle.firestore.v1.MongoDBCompatible.ListCollectionsgoogle.firestore.v1.MongoDBCompatible.Countgoogle.firestore.v1.MongoDBCompatible.Distinctgoogle.firestore.v1.MongoDBCompatible.CommitTransactiongoogle.firestore.v1.MongoDBCompatible.AbortTransactiongoogle.firestore.v1.MongoDBCompatible.EndSessionsgoogle.firestore.v1.MongoDBCompatible.KillCursors
|
DATA_WRITE |
google.firestore.v1.MongoDBCompatible.Insertgoogle.firestore.v1.MongoDBCompatible.Updategoogle.firestore.v1.MongoDBCompatible.Deletegoogle.firestore.v1.MongoDBCompatible.FindAndModifygoogle.firestore.v1.MongoDBCompatible.CreateCollection
|
تحديد هوية المتصلين الذين يرسلون الطلبات
تتضمّن إدخالات سجلّ التدقيق معلومات عن الهوية التي نفّذت العملية المسجّلة. لتحديد هوية مقدّم الطلب، اطّلِع على الحقول التالية ضمن عنصر AuditLog:
يتم الاحتفاظ بهوية المتصل في الحقل
AuthenticationInfo. يمكن أن يشمل ذلكprincipalEmailالمستخدم. يتم أحيانًا إخفاء هذه المعلومات.يتضمّن الحقل
callerIpضمن العنصرrequestMetadataلإدخالAuditLogعنوان IP الخاص بالمتصل.