إعداد التسجيل في السحابة الإلكترونية
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تفعيل Cloud Logging
من المفترض أن يتم تفعيل تسجيل البيانات تلقائيًا في Fleet Engine.
- افتح مستكشف السجلات.
أدخِل طلب البحث التالي:
resource.type:"fleetengine.googleapis.com"
إذا كانت نتائج طلب البحث تعرض السجلات، يعني ذلك أنّ التسجيل مفعّل.
إذا لم تظهر أي سجلّات في نتائج طلب البحث هذا، قد لا تكون خدمة Cloud Logging مفعّلة لمشروعك. لتفعيل Cloud Logging، يُرجى التواصل مع فريق دعم "منصة خرائط Google".
تفعيل سجلّات الاستخدام المحظور
وفقًا للأحكام الخاصة بخدمة التنقّل، قد يتم الاحتفاظ ببعض بيانات السجلّ التي تنشئها Fleet Engine لمدة 30 يومًا فقط.
يصنّف Fleet Engine هذه السجلات على أنّها TOS_RESTRICTED
ويرتّبها في حزمة سجلّات ذات فترة احتفاظ محدودة، ويجب إنشاء هذه الحزمة كما هو موضّح أدناه.
يتم تخصيص جميع بيانات السجلّ الأخرى للحزمة التلقائية حيث يمكن الاحتفاظ بها لفترة أطول، كما هو موضّح في بنود خدمة التنقّل المحدّدة.
يمكنك الاطّلاع على تخزين السجلّات في Google Cloud Console للتعرّف على كيفية تخصيص حِزم السجلّات ومُدد الاحتفاظ بها.
لإجراء التحليل، يمكنك دمج البيانات من السجلّات المحدودة والسجلّات التلقائية للحصول على مجموعة كاملة من بيانات السجلّ.
اتّبِع الخطوات التالية لتفعيل سجلّات الاستخدام المقيّد:
أنشئ حوضًا ومجموعة لسجلات الاستخدام المحظور، وفلتر السجلات في المجموعات المناسبة.
يُرجى التواصل مع فريق الدعم لتفعيل سجلّات الاستخدام المحدود.
لمعرفة التفاصيل، يُرجى الاطّلاع على الأقسام التالية.
إنشاء مصرف وحزمة للسجلات المحظورة في مشروعك
في مستكشف السجلات، افتح صفحة Log Router في شريط التنقّل الأيمن.
عدِّل حزمة التسجيل التلقائية لاستبعاد سجلّات الاستخدام المحظور.
- ضِمن أحواض Log Router، اختَر _Default logging bucket.
- اختَر تعديل مصدر البيانات من قائمة الإجراءات.
- انتقِل إلى القسم اختيار السجلات التي سيتم استبعادها من الحوض وانقر على الزر إضافة استبعاد.
- اضبط اسم فلتر الاستبعاد على ExcludeRestrictedLogs.
- في مربّع إنشاء فلتر الاستبعاد، الصِق الفلتر التالي:
labels.restriction="TOS_RESTRICTED"
- انقر على تعديل مصدر البيانات.
أنشئ حزمة تسجيل دخول مقيّدة لتخزين سجلّات الاستخدام المقيّد. يمكنك إجراء ذلك من خلال إنشاء مصرف وحزمة لجميع السجلات، ثم استبعاد السجلات غير المحظورة.
- في صفحة "موجّه السجلّ" (Log Router)، انقر على
إنشاء مصرف (Create sink) بالقرب من أعلى الصفحة.
- املأ تفاصيل المصدر:
- الاسم: RestrictedLogs
- الوصف: سجلات الاستخدام المحظور في Fleet Engine للمسارات
- انقر على التالي.
- املأ وجهة الحوض:
- اختَر خدمة Sink: حزمة التسجيل
- اختَر حزمة سجلّ: انقر على إنشاء حزمة سجلّ جديدة.
- في مربّع الحوار تفاصيل الحزمة، املأ ما يلي:
- الاسم: مقيَّدة
- الوصف: تحتوي على سجلّات استخدام مقيّد في Fleet Engine.
- اترك باقي الخيارات كما هي وانقر على التالي.
- اضبط فترة الاحتفاظ بالبيانات على 30 يومًا. (يجب ألا تتجاوز فترة الاحتفاظ بالبيانات 30 يومًا).
- انقر على إنشاء حزمة.
- في مربّع حوار إنشاء الحوض، اترك قسم السجلّات المطلوب تضمينها في الحوض فارغًا.
- في القسم السجلات التي سيتم استبعادها من المصدر، انقر على إضافة استبعاد
وملء ما يلي:
- اسم فلتر الاستبعاد: ExcludeNonRestrictedLogs
- فلتر الاستبعاد:
NOT (resource.type =
"fleetengine.googleapis.com/Fleet" OR resource.type =
"fleetengine.googleapis.com/DeliveryFleet") NOT (labels.restriction
= "TOS_RESTRICTED")
- انقر على إنشاء مصرف.
- انتقِل إلى فريق دعم "منصة خرائط Google".
- انقر على إنشاء طلب لبدء طلب دعم جديد.
قدِّم المعلومات التالية:
- معرّفات المشاريع التي سيتم تفعيلها
- عنوان البريد الإلكتروني للشخص الذي يطلب إجراء التغيير يجب أن يكون لدى هذا الشخص إذن تعديل مشاريع Google Cloud التي تُدرجها.
يُرجى الموافقة على ما يلي من خلال كتابة نعم: من خلال تفعيل محتوى "خرائط Google" المقيّد الاستخدام في Cloud Logging، أنت توافق على الالتزام ببنود خدمة "منصة خرائط Google" وبنود الخدمة الخاصة بخدمة التنقّل، بما في ذلك متطلبات التخزين المؤقت والاستخدام المسموح به ذات الصلة بمحتوى "خرائط Google".
بعد أن يتعامل فريق الدعم مع طلبك، ستتلقّى تأكيدًا بأنّه تم تفعيل التسجيل لمشروعك.
الخطوات التالية
كيفية العمل مع السجلات في "مستكشف السجلات"
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eFleet Engine automatically enables logging, verifiable via a query in the Logs Explorer using \u003ccode\u003eresource.type:"fleetengine.googleapis.com"\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eRestricted-use logs, labeled \u003ccode\u003eTOS_RESTRICTED\u003c/code\u003e, require a dedicated bucket with a 30-day retention period due to the Mobility Service Specific Terms.\u003c/p\u003e\n"],["\u003cp\u003eEnabling restricted-use logs involves creating a separate sink and bucket, then contacting Google Maps Platform Support for activation.\u003c/p\u003e\n"],["\u003cp\u003eFleet Engine logs may contain sensitive information and require careful access management using Google Cloud's Identity and Access Management for Cloud Logging.\u003c/p\u003e\n"]]],[],null,["Enable Cloud Logging\n\nFleet Engine should automatically have logging enabled.\n\n1. Open the [Logs Explorer](https://cloud.google.com/logging/docs/view/logs-explorer-interface).\n2. Enter the following query:\n\n resource.type:\"fleetengine.googleapis.com\"\n\nIf the results for the query list logs, then logging is enabled.\n\nIf you don't see any logs listed in the results for this query,\nCloud Logging may not be enabled for your project. To enable\nCloud Logging, contact [Google Maps Platform Support](https://console.cloud.google.com/google/maps-apis/support).\n\nEnable restricted use logs\n\nIn accordance with the [Mobility Service Specific Terms](/maps/documentation/transportation-logistics-terms/mobility/service-terms), some\nof the log data that Fleet Engine generates may only be retained for 30 days.\nFleet Engine labels those logs as `TOS_RESTRICTED` and sorts them into a\nrestricted-retention log bucket, which you must create as shown below.\n\nAll other log data is assigned to the default bucket where it can be retained\nlonger, as defined in the [Mobility Service Specific Terms](/maps/documentation/transportation-logistics-terms/mobility/service-terms).\nSee [Logs Storage](/maps/documentation/mobility/operations/cloud-logging/console.cloud.google.come/logs/storage) in the Google Cloud\nConsole about customizing your log buckets and their retention periods.\n\nFor analysis, you can join the data from restricted and default logs for a\ncomplete set of log data.\n\nDo the following to enable restricted use logs:\n\n1. Create a sink and bucket for restricted-use logs, and filter logs into their\n appropriate buckets.\n\n2. Contact support to enable restricted-use logs.\n\nFor details, see the following sections.\n\nCreate a sink and bucket for restricted logs in your project\n\n1. In the [Logs Explorer](https://cloud.google.com/logging/docs/view/logs-explorer-interface), in the left-hand\n navigation, open the **Log Router** page.\n\n2. Modify the _Default logging bucket to exclude restricted-use logs.\n\n 1. Under **Log Router Sinks**, select the _Default logging bucket.\n 2. Choose **Edit sink** from the **Actions** menu.\n 3. Go to the **Choose logs to filter out of sink** section and click the **Add Exclusion** button.\n 4. Set the **Exclusion filter name** to *ExcludeRestrictedLogs*.\n 5. In the **Build and exclusion filter** box, paste this filter: `labels.restriction=\"TOS_RESTRICTED\"`\n 6. Click **Update sink**.\n3. Create a restricted logging bucket to store the restricted-use logs. You do\n this by creating a sink and bucket for all logs, and then excluding the\n non-restricted logs.\n\n 1. On the [Log Router page](https://console.cloud.google.com/logs/router), towards the top, select **Create sink**.\n 2. Fill in the **Sink details** :\n 1. Name: *RestrictedLogs*\n 2. Description: *Routes Fleet Engine restricted-use logs.*\n 3. Click **Next**.\n 4. Fill in the **Sink destination** :\n 1. Select Sink service: Logging bucket\n 2. Select log bucket: Select **Create new log bucket**.\n 3. In the **Bucket details** dialog, fill in:\n 1. Name: *Restricted*\n 2. Description: *Contains Fleet Engine restricted-use logs.*\n 4. Leave the rest as is and click **Next**.\n 5. Set the **Retention period** to 30 days. (The retention period must not exceed 30 days.)\n 6. Click **Create bucket**.\n 5. Back in the sink creation dialog, leave the **Logs to include in sink** section empty.\n 6. In the **Logs to filter out of sink** section, click **Add Exclusion** and fill in:\n 1. Exclusion filter name: *ExcludeNonRestrictedLogs*\n 2. Exclusion filter: `NOT (resource.type =\n \"fleetengine.googleapis.com/Fleet\" OR resource.type =\n \"fleetengine.googleapis.com/DeliveryFleet\") NOT (labels.restriction\n = \"TOS_RESTRICTED\")`\n 7. Click **Create sink.**\n\nContact support to enable restricted-use logs\n\n1. Go to [Google Maps Platform Support](https://console.cloud.google.com/google/maps-apis/support)\n2. Click **Create Case** to start a new support request.\n3. Provide the following information:\n\n - Project ID(s) to enable.\n - Email address of the person requesting the change. This person should have edit access to the Google Cloud Projects you are listing.\n4. Agree to the following by writing **Yes** : *By enabling restricted-use\n Google Maps Content in Cloud Logging, you agree to adhere to the\n [Google Maps Platform terms](https://cloud.google.com/maps-platform/terms/) and [Mobility service specific\n terms](/maps/documentation/transportation-logistics-terms/mobility/service-terms), including caching and permitted use requirements as they relate\n to Google Maps Content.*\n\nOnce the support team handles your request, you will receive a confirmation that\nlogging has been enabled for your project.\n| **Note:** Fleet Engine logs may contain sensitive vehicle and trip information. You can restrict and audit access to these logs with Google Cloud [Identity and Access Management for Cloud Logging](https://cloud.google.com/logging/docs/access-control).\n\nWhat's next\n\nLearn how to [Work with logs in Logs Explorer](/maps/documentation/mobility/operations/cloud-logging/work-with-logs)."]]