הגדרת Cloud Logging
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
הפעלת Cloud Logging
הרישום ביומן אמור להיות מופעל אוטומטית ב-Fleet Engine.
- פותחים את Logs Explorer.
מזינים את השאילתה הבאה:
resource.type:"fleetengine.googleapis.com"
אם בתוצאות של השאילתה מופיעים יומנים, הרישום ביומן מופעל.
אם לא מוצגים יומנים בתוצאות של השאילתה הזו, יכול להיות ש-Cloud Logging לא מופעל בפרויקט. כדי להפעיל את Cloud Logging, צריך לפנות אל התמיכה של הפלטפורמה של מפות Google.
הפעלת יומנים של שימוש מוגבל
בהתאם לתנאים הספציפיים של שירות הניידות, יכול להיות שחלק מנתוני היומן שנוצרים על ידי Fleet Engine יישמרו רק למשך 30 יום.
Fleet Engine מתייג את היומנים האלה כ-TOS_RESTRICTED וממיין אותם לקטגוריית יומנים עם הגבלות על תקופת השמירה, שצריך ליצור אותה כמו שמוצג בהמשך.
כל שאר נתוני היומן מוקצים לקטגוריית ברירת המחדל שבה אפשר לשמור אותם למשך זמן ארוך יותר, כפי שמוגדר בתנאים הספציפיים של שירות Mobility.
במאמר Logs Storage במסוף Google Cloud מוסבר איך להתאים אישית את מאגרי היומנים ואת תקופות השמירה שלהם.
לצורך ניתוח, אפשר לאחד את הנתונים מיומנים מוגבלים ומיומנים שמוגדרים כברירת מחדל כדי לקבל קבוצה מלאה של נתוני יומן.
כדי להפעיל יומני שימוש מוגבל:
יוצרים מאגר נתונים וקטגוריה ליומנים עם שימוש מוגבל, ומסננים את היומנים לקטגוריות המתאימות.
כדי להפעיל יומנים עם שימוש מוגבל, צריך לפנות לתמיכה.
בסעיפים הבאים יש מידע נוסף בנושא.
יצירת יעד וקטגוריה ליומנים מוגבלים בפרויקט
בLogs Explorer, בתפריט הניווט הימני, פותחים את הדף Log Router.
משנים את קטגוריית ברירת המחדל של היומנים כדי להחריג יומנים עם שימוש מוגבל.
- בקטע Log Router Sinks, בוחרים באפשרות _Default logging bucket.
- בתפריט פעולות, בוחרים באפשרות עריכת יעד.
- עוברים לקטע Choose logs to filter out of sink ולוחצים על הלחצן Add Exclusion.
- מגדירים את שם מסנן ההחרגה ל-ExcludeRestrictedLogs.
- בתיבה Build and exclusion filter, מדביקים את המסנן הבא:
labels.restriction="TOS_RESTRICTED"
- לוחצים על עדכון יעד.
יוצרים קטגוריית אחסון מוגבלת לרישום ביומן כדי לאחסן את היומנים של שימוש מוגבל. כדי לעשות את זה, יוצרים יעד וקטגוריה לכל היומנים, ואז מחריגים את היומנים שלא חלים עליהם הגבלות.
- בחלק העליון של הדף Log Router, לוחצים על Create sink (יצירת יעד).
- ממלאים את פרטי יעד הנתונים:
- שם: RestrictedLogs
- תיאור: יומני שימוש מוגבל של Routes Fleet Engine.
- לוחצים על הבא.
- ממלאים את יעד ה-Sink:
- בוחרים באפשרות Sink service: Logging bucket (שירות יעד: מאגר יומנים)
- בוחרים קטגוריית אחסון ליומנים: בוחרים באפשרות יצירת קטגוריית אחסון חדשה ליומנים.
- בתיבת הדו-שיח פרטי מאגר, ממלאים את הפרטים הבאים:
- שם: מוגבל
- תיאור: מכיל יומנים של שימוש מוגבל ב-Fleet Engine.
- משאירים את שאר השדות כמו שהם ולוחצים על הבא.
- מגדירים את תקופת השמירה ל-30 ימים. (תקופת השמירה לא יכולה להיות ארוכה מ-30 יום).
- לוחצים על Create bucket.
- בתיבת הדו-שיח של יצירת היעד, משאירים את הקטע Logs to include in sink (יומנים שייכללו ביעד) ריק.
- בקטע Logs to filter out of sink, לוחצים על Add Exclusion וממלאים את הפרטים הבאים:
- שם מסנן ההחרגה: ExcludeNonRestrictedLogs
- מסנן החרגה:
NOT (resource.type =
"fleetengine.googleapis.com/Fleet" OR resource.type =
"fleetengine.googleapis.com/DeliveryFleet") NOT (labels.restriction
= "TOS_RESTRICTED")
- לוחצים על יצירת יעד.
- כניסה לדף התמיכה בפלטפורמה של מפות Google
- לוחצים על Create Case (יצירת פנייה) כדי להתחיל בקשת תמיכה חדשה.
עליך לספק את הפרטים הבאים:
- מזהי הפרויקטים להפעלה.
- כתובת האימייל של האדם שמבקש את השינוי. לאדם הזה צריכה להיות הרשאת עריכה בפרויקטים ב-Google Cloud שציינתם.
כדי להביע הסכמה לתנאים הבאים, צריך לכתוב Yes: בהפעלת תוכן מוגבל לשימוש במפות Google ב-Cloud Logging, אתם מסכימים לפעול בהתאם לתנאים של פלטפורמת מפות Google ולתנאים הספציפיים של שירותי ניידות, כולל דרישות לגבי שמירה במטמון ושימוש מותר, כפי שהם מתייחסים לתוכן מפות Google.
אחרי שצוות התמיכה יטפל בבקשה שלכם, תקבלו אישור שהפעלנו את הרישום בפרויקט.
המאמרים הבאים
איך עובדים עם יומנים ב-Logs Explorer
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-31 (שעון UTC).
[null,null,["עדכון אחרון: 2025-08-31 (שעון UTC)."],[[["\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)."]]
