此页面由 Cloud Translation API 翻译。

日志记录

Fleet Engine 提供了一项简单的日志记录服务，可让您保存 API 请求和响应载荷。借助这些日志，您可以调试集成、创建监控指标并分析流量模式。

Fleet Engine 将日志作为平台发送将日志复制到 Cloud 日志记录，以便您可以使用用于访问它们的日志记录工具。

Fleet Engine 可记录的内容

Fleet Engine 将多条信息发送到 Cloud Logging，例如：

所有经过身份验证的 REST 和 gRPC 请求和响应
错误响应
来自驾驶员发起的通话的请求、响应和错误消息 SDK 添加到 Fleet Engine。
为受支持的日志类型拆分日志：

使用受限日志存储分区和默认日志存储分区以遵守数据保留政策

使用“受限”和“default”可确保您的集群 “受限”和“不受限”的数据流量使用方式Fleet Engine 会将一些日志数据发送到 Google Maps Platform 的请求只能保留有限的一段时间，根据 Mobility Service Specific（移动服务专用）条款。为了确保受限数据的保留时长不超过允许的时长，此类数据应标记为 TOS_RESTRICTED（Fleet Engine 已执行此操作）并记录到名为“受限”的专用存储分区中

在此处，您可以控制数据的保留时长，并在以下时间自动完全清除数据使用 Cloud Logging 设置指定到期时间。例如，限制使用日志只会保留 30 天。

将所有剩余的不受限数据记录到“默认值”中您可以将其根据移动服务专用条款（通常为 1 年）。使用“受限”和“default”存储分区可确保数据使用受限和不受限的图片。

通过合并受限和不受限日志获取完整视图

受限使用日志包含受限使用数据以及对默认日志，这样才能将它们一起考虑。限制使用日志包含默认日志的 insertId，作为 parent_insert_id 中的引用字段。您可以使用此字段联接来自两个日志的数据，

请参阅 Logging 中所有可用的日志消息和架构的文档参考文档。

启用 Cloud Logging

Fleet Engine 会自动为新的 Mobility 客户启用默认日志，从 2022 年 2 月 10 日创建的项目开始。您可以确认通过在日志中使用以下查询启用日志记录功能探索器：

resource.type:"fleetengine.googleapis.com/DeliveryFleet"

如果您没有看到该查询的任何日志，则说明 Cloud Logging 可能尚未。联系支持服务即可启用该功能

启用受限使用日志

根据请求启用使用受限日志。要为您的 Google 代码启用这些日志， Cloud 项目中，请完成以下步骤：

准备您的项目以接收使用限制日志

在 Google Cloud 控制台中，打开“日志路由器”页面。
更新 _Default 日志记录存储分区，以排除仅限使用的日志。
1. 选择 _Default 日志记录存储分区，然后选择修改接收器。
2. 在“选择要从接收器中过滤掉的日志”部分，点击“添加” 排除项”按钮： <ph type="x-smartling-placeholder">
  1. 排除项过滤条件名称：ExcludeRestrictedLogs
  2. 排除过滤条件：labels.restriction="TOS_RESTRICTED"
3. 点击“更新接收器”。
更新受限日志记录存储分区以存储仅限使用的日志。
1. 在“日志路由器”页面中，选择“创建接收器”。
2. 创建具有以下设置的接收器： <ph type="x-smartling-placeholder">
  1. 接收器详情： <ph type="x-smartling-placeholder">
    1. 名称：RestrictedLogs
    2. 说明：Routes Fleet Engine 使用限制日志
  2. 接收器目标位置： <ph type="x-smartling-placeholder">
    1. 接收器服务：Logging 存储分区
    2. 选择日志存储分区：创建新的日志存储分区 <ph type="x-smartling-placeholder">
      1. 名称：受限
      2. 说明：包含 Fleet Engine 使用限制日志
    3. 保留期限：30 天 <ph type="x-smartling-placeholder">
      1. 注意：保留期限不得超过 30 天。
  3. 要包含在接收器中的日志：留空
  4. 要从接收器中过滤掉的日志：点击“添加排除项” <ph type="x-smartling-placeholder">
    1. 排除项过滤条件名称：ExcludeNonRestrictedLogs
    2. 排除过滤条件：NOT (resource.type = "fleetengine.googleapis.com/Fleet"OR resource.type = “fleetengine.googleapis.com/DeliveryFleet”）而非（labels.restriction = "TOS_RESTRICTED”）
  5. 点击“创建接收器”

如需启用使用限制日志，请与支持团队联系

然后，联系支持并提供请在支持请求中提供以下信息：

要启用的项目 ID：
请求更改的用户的电子邮件地址： <ph type="x-smartling-placeholder">
1. 注意：此人应拥有 Google Cloud 项目的修改权限。
在 Cloud Logging 中启用限制使用的 Google 地图内容，即表示您同意遵守 Google Maps Platform 条款和移动服务具体条款，包括与 Google 相关的缓存和允许的使用要求地图内容。有/无

支持团队收到您的请求后，会发送确认信息，已为您的项目启用

拆分云日志

Cloud Logging 将传入日志的大小限制为 256KB。该服务会删除日志超过该阈值。为确保 Cloud Logging 保留大型日志，舰队 Engine 可以将它们拆分为一系列小于 256KB 的日志。此类日志共同点 insertId 前缀来指明服务将较小的日志从原始超大型日志。然后，您可以根据其 insertId。

如需访问原始的未拆分日志，请按如下顺序合并拆分日志： insertIds 它们最初的拆分顺序，即它们在 Cloud 日志条目。

拆分日志结构与拆分审核中提到的结构相同日志条目指南 Cloud Audit Logs。舰队日志记录中拆分日志的主要区别在于拆分发生在 jsonPayload 字段中，而不是在 protoPayload 中字段。请参阅下一部分中展示的分屏示例。

支持的日志类型

Fleet Engine 仅支持对以下日志类型进行日志拆分如果日志大小超过 256KB，则会发生此错误：

拆分日志结构示例

// First Split Log
{
  // insertId appended with an increasing number
  "insertId": "ABCDE-1",
  "jsonPayload": {
    "request": {
      "filter": "tracking_id=tracking-test-splitting-task"
    },
    "@type": "type.googleapis.com/maps.fleetengine.delivery.log.v1.ListTasksLog",
    "response": {
      "tasks": [
        {
          "name": "providers/providers-123/tasks/test-splitting-task-id-0",
          // ...
        },
        {
          "name": "providers/providers-123/tasks/test-splitting-task-id-1",
          // ...
        },
        {
          "name": "providers/providers-123/tasks/test-splitting-task-id-2"
          // ...
        },
        {
          "name": "providers/providers-123/tasks/test-splitting-task-id-3",
          // ...
        },
      ]
    },
    "header": {}
  },
  "resource": {
    "type": "fleetengine.googleapis.com/DeliveryFleet",
    "labels": {
      "resource_container": "projects/providers-123",
      "location": "global"
    }
  },
  // Same timestamp
  "timestamp": "2024-01-29T23:35:58.076515Z",
  "labels": {
  },
  "logName": "projects/providers-123/logs/fleetengine.googleapis.com%2Flist_tasks",
  "receiveTimestamp": "2024-01-29T23:35:59.278858322Z",
  "split": {
    // UID for this logical log entry (same across splits)
    "uid": "ABCDE",
    "totalSplits": 2
  }
}

// Second Split Log
{
  // insertId appended with an increasing number
  "insertId": "ABCDE-2",
  "jsonPayload": {
    "request": {
      "filter": "tracking_id=tracking-test-splitting-task"
    },
    "@type": "type.googleapis.com/maps.fleetengine.delivery.log.v1.ListTasksLog",
    "response": {
      "tasks": [
         // Previous tasks appear as empty objects in subsequent splits
        {}, {}, {}, {},
        {
          "name": "providers/providers-123/tasks/test-splitting-task-id-4",
          // ...
        }
      ]
    },
    "header": {}
  },
  "resource": {
    "type": "fleetengine.googleapis.com/DeliveryFleet",
    "labels": {
      "resource_container": "projects/providers-123",
      "location": "global"
    }
  },
  // Same timestamp
  "timestamp": "2024-01-29T23:35:58.076515Z",
  "labels": {
  },
  "logName": "projects/providers-123/logs/fleetengine.googleapis.com%2Flist_tasks",
  "receiveTimestamp": "2024-01-29T23:35:59.278858322Z",
  "split": {
    // UID for this logical log entry (same across splits)
    "uid": "ABCDE",
    // Subsequent logs after the original will have a zero based index
    "index": 1,
    "totalSplits": 2
  }
}

访问日志

Cloud 日志的结构是 LogEntry 格式。Fleet Engine 使用 LogEntry 的 resource.type 已设为 fleetengine.googleapis.com。您可以使用日志从探索器切换到编写查询来查看日志。

例如，要查看 Fleet Engine 中返回了错误的所有 RPC，请使用以下日志浏览器查询：

resource.type:"fleetengine.googleapis.com/DeliveryFleet"
severity=ERROR

如需查看对 UpdateDeliveryVehicle 方法的 RPC 进行项目 example-project-id，请使用以下日志浏览器查询：

logName="projects/project-id/logs/fleetengine.googleapis.com%2Fupdate_delivery_vehicle"

以下示例展示了 UpdateDeliveryVehicle 的 LogEntry 日志。RPC 请求和响应位于 jsonPayload 字段中：

    {
      "insertId": "c6b85fbc927343fc8a85338c57a65733",
      "jsonPayload": {
        "request": {
          "header": {4},
          "updateMask": "deviceSettings",
          "vehicleId": "uniqueVehicleId",
          "vehicle": {2}
        },
        "response": {
          "name": "providers/example-project-id/vehicles/uniqueVehicleId",
          "availableCapacity": 2,
          "state": "VEHICLE_STATE_OFFLINE",
          "maximumCapacity": 2,
          "vehicleType": {1},
          "supportedTrips": {1}
        },
        "@type": "type.googleapis.com/maps.fleetengine.v1.UpdateDeliveryVehicleLog"
      },
      "resource": {
        "type": "fleetengine.googleapis.com/DeliveryFleet",
        "labels": {2}
      },
      "timestamp": "2021-01-01T00:00:00.000000000Z",
      "labels": {2},
      "logName": "projects/example-project-id/logs/fleetengine.googleapis.com%2Fupdate_delivery_vehicle",
      "receiveTimestamp": "2021-01-01T00:00:00.000000000Z"
    }

如果返回 RPC 错误，则 responseDeliveryVehicle 字段已清除 errorResponse 字段，并在 jsonPayload 中填充了字段：

    {
      "insertId": "2ead60bdec561836a1bb84a90e9915cd",
      "jsonPayload": {
        "@type": "type.googleapis.com/maps.fleetengine.delivery.log.v1.UpdateDeliveryVehicleLog",
        "header": {
          "languageCode": "en",
          "osVersion": "11",
          "platform": "PLATFORM_LOG_ANDROID",
          "regionCode": "US",
          "sdkType": "SDK_TYPE_LOG_DRIVER",
          "sdkVersion": "4.4.3"
        },
        "request": {
          "deliveryVehicle": {4},
          "deliveryVehicleId": "uniqueDeliveryVehicleId",
          "updateMask": "lastLocation"
        },
        "response": {
          "lastLocation": {14},
          "name": "providers/example-project-id/deliveryVehicles/uniqueDeliveryVehicleId",
          "navigationStatus": "NAVIGATION_STATUS_ARRIVED_AT_DESTINATION",
          "remainingDistanceMeters": "430",
          "remainingDuration": "10s"
        }
      },
      "labels": {
        "delivery_vehicle_id": "uniqueDeliveryVehicleId"
      },
      "logName": "projects/example-project-id/logs/fleetengine.googleapis.com%2Fupdate_delivery_vehicle",
      "receiveTimestamp": "2023-07-14T22:57:51.156515110Z",
      "resource": {
        "labels": {2},
        "type": "fleetengine.googleapis.com/DeliveryFleet"
      },
      "timestamp": "2023-07-14T22:57:51.018045Z"
    }

如需详细了解日志记录查询语言，请参阅日志记录查询语言。如需了解如何使用日志创建指标，请参阅概览基于日志的指标。

管理日志记录费用

启用日志记录后，您需要按照自己希望的方式进行设置以路由、存储和保留日志。您可能会产生额外的 Google Cloud 费用日志的 charges 超过费用。但是，您可以通过执行以下任一操作来控制日志记录费用：

减少日志记录的使用

您可以通过排除某些日志条目来限制日志数据提取量。

导出或路由日志

您可以将日志路由到其他 Google Cloud 或外部目标位置，以避免默认注入和存储费用请务必关闭日志注入，因为避免注入费用。

关闭日志注入以避免产生费用

减少日志记录，或者导出或路由日志，而不是关闭停用日志提取但是，如果您不打算使用 Fleet Engine 日志，关闭注入功能可以避免产生潜在的 Cloud Logging 费用。默认情况下 Fleet Engine 日志会路由到 _Default 日志存储分区。

以下命令将 _Default 日志记录存储分区更新为不注入舰队 Engine 日志

gcloud logging sinks update _Default \
--log-filter='NOT LOG_ID("cloudaudit.googleapis.com/activity") \
AND NOT LOG_ID("externalaudit.googleapis.com/activity") \
AND NOT LOG_ID("cloudaudit.googleapis.com/system_event") \
AND NOT LOG_ID("externalaudit.googleapis.com/system_event") \
AND NOT LOG_ID("  cloudaudit.googleapis.com/access_transparency") \
AND NOT LOG_ID("externalaudit.googleapis.com/access_transparency") \
AND NOT resource.type:"fleetengine.googleapis.com"''

如需了解详情，请参阅：Cloud Logging 排除对象和排除日志。Cloud Logging 导出和导出日志

使用日志浏览器

如需使用日志浏览器，请打开 Cloud 控制台，选择 Logging，然后 日志浏览器。要查看所有可用的 Fleet Engine 日志列表，请点击 Fleet Engine 资源类型。有些 Delivery API 日志带有任务 ID 和送货车辆 ID。您可以使用这些标签为感兴趣的任务或车辆。

日志标签

按送货车辆 ID 过滤日志

在日志浏览器中，您可以使用以下查询将日志限制为特定车辆：

    resource.type="fleetengine.googleapis.com/DeliveryFleet"
    labels.delivery_vehicle_id="delivery_vehicle_id"

过滤车辆

按任务 ID 过滤日志

在日志浏览器中，您可以使用以下查询将日志限制为特定任务：

    resource.type="fleetengine.googleapis.com/DeliveryFleet"
    labels.task_id=~"task_id"

过滤特定时间段内的车辆日志

在日志浏览器中，您可以使用以下查询将日志限制为特定时间段内的某辆车：

    resource.type="fleetengine.googleapis.com/DeliveryFleet"
    labels.delivery_vehicle_id="delivery_vehicle_id"
    timestamp>="2020-09-24T20:00:00.000Z"
    timestamp<"2020-09-24T21:00:00.000Z"

基于日志的指标示例

以下示例展示了如何使用基于日志的指标来跟踪创建的任务数。

在 Cloud 控制台中，选择 Logging，然后选择日志浏览器以打开 Logs Explorer然后应用以下过滤条件：

resource.type="fleetengine.googleapis.com/DeliveryFleet" resource.labels.location="global"
logName="projects/ProjectID/logs/fleetengine.googleapis.com%2Fupdate_task"
jsonPayload.request.task.taskOutcome="TASK_OUTCOME_LOG_SUCCEEDED"
jsonPayload.request.updateMask="taskOutcome"
jsonPayload.response.type= ("TASK_TYPE_LOG_PICKUP" OR "TASK_TYPE_LOG_DELIVERY")

在“查询结果”窗格中，选择操作下拉菜单，然后选择 创建指标。
在“指标编辑器”对话框中：
- 指定指标名称（例如 billable_tasks）。
- 指定指标说明（例如，可结算的 Tasks）。
- 将 Units（单位）选项留空。_ 将类型选项保留为 计数器。
然后选择创建指标按钮。
在“基于日志的指标”页面上，您应该会看到一条消息，已成功创建指标，新指标应会显示在 “用户定义指标”部分。该指标现在将填充为匹配的会生成日志。
选择新指标右侧的垂直下拉菜单，然后选择在 Metrics Explorer 中查看。
在左侧窗格中的“构建查询”下，将资源类型设置为舰队 Engine 并搜索 billingable_tasks 指标。

右侧图表显示了 billable_tasks 调用率。

使用 BigQuery

BigQuery 是用于执行分析的强大工具。它可以用来存储保存长期日志，并对数据执行类似 SQL 的临时查询。

将日志路由到 BigQuery

要利用 BigQuery，日志必须路由到 BigQuery 数据存储区，如下：

在 Cloud 控制台中，选择 Logging，然后选择 Logs Explorer。
创建用于隔离 Fleet Engine 日志的过滤器。在“日志字段浏览器”中选择 Fleetengine.googleapis.com/DeliveryFleet 资源类型。
在“查询结果”窗格中，点击“操作”下拉菜单，然后选择创建接收器。
在“选择接收器服务”对话框中，选择 BigQuery 数据集。
在“修改接收器”对话框中，指定以下选项：
- 指定接收器名称（例如 FleetEngineLogsSink）。
- 将接收器服务保留为 BigQuery。
- 选择使用分区表选项。这将提升查询性能
- 在接收器目标位置下，选择新建 BigQuery 数据集，然后指定 BigQuery 数据集名称（例如 FleetEngineLogs）。
- 点击创建接收器按钮。

您的日志现在应该开始填充 BigQuery 数据集。您可以看到数据。

BigQuery
部分

系统将填充 FleetEngineLogs 数据集下的多个表系统会自动为每个日志类型分别创建一个：

CreateDeliveryVehicle
GetDeliveryVehicle
ListDeliveryVehicle
UpdateDeliveryVehicle
CreateTask
GetTask
UpdateTask
ListTasks

表名称使用以下模式：

project_id.data_set.log_name

例如，项目名称为 test_project，数据集名称为 FleetEngineLogs 中，CreateTask 表的名称如下：

test_project.FleetEngineLogs.fleetengine_googleapis_com_create_task

示例查询

本部分介绍了您可以创建的查询示例。

每小时创建的任务数

以下查询会统计 CreateTasks 日志的数量并按其分组小时。

    SELECT TIMESTAMP_TRUNC(timestamp, HOUR) as hour,
           count(*) as num_tasks_created
    FROM
    `ProjectId.FleetEngineLogs.fleetengine_googleapis_com_create_task`
    GROUP BY hour
    ORDER by hour

每辆车每小时的经停次数

以下查询生成车辆停靠的经停点计数按小时减少。

例如，以下查询可能表示在过去一小时内：

车辆 A 在第 12 个小时完成 10 次经停，在第 13 个小时完成 8 次经停。
车辆 B 在第 11 个小时完成了 5 次经停，在第 12 个小时完成了 7 次经停。

车辆 C 在第 13 个小时完成了 12 次经停，在第 14 个小时完成了 9 次经停。

SELECT
  jsonpayload_v1_updatedeliveryvehiclelog.request.deliveryvehicleid AS vehicle,
  TIMESTAMP_TRUNC(timestamp, HOUR) AS hour,
  COUNT(*) AS num_stops
FROM
  `ProjectId.FleetEngineLogs.fleetengine_googleapis_com_update_delivery_vehicle`
WHERE
ARRAY_LENGTH(jsonpayload_v1_updatedeliveryvehiclelog.request.deliveryvehicle.remainingvehiclejourneysegments) > 0
AND jsonpayload_v1_updatedeliveryvehiclelog.request.deliveryvehicle.remainingvehiclejourneysegments[
OFFSET
(0)].stop.state = 'VEHICLE_STOP_STATE_LOG_ARRIVED'
GROUP BY
1,
2
ORDER BY
2

首次提交成功率

以下查询显示首次传送的成功百分比尝试率。

    SELECT
     vehicle_id,
     COUNTIF(outcome = "TASK_OUTCOME_LOG_SUCCEEDED") AS num_success,
     COUNT(*) AS total_deliveries,
     COUNTIF(outcome = "TASK_OUTCOME_LOG_SUCCEEDED") * 100/ COUNT(*) AS success_rate
    FROM (
     SELECT
       labels.delivery_vehicle_id AS vehicle_id,
       jsonpayload_v1_updatetasklog.response.trackingid AS trackingid,
       ARRAY_AGG(jsonpayload_v1_updatetasklog.response.taskoutcome
       ORDER BY
         timestamp ASC)[ORDINAL(1)] AS outcome,
     FROM
     `ProjectId.FleetEngineLogsfleetengine_googleapis_com_update_task`
     WHERE
      jsonpayload_v1_updatetasklog.response.type = "TASK_TYPE_LOG_DELIVERY"
     GROUP BY 1, 2
     ORDER BY 1, 2)
    GROUP BY 1
    ORDER BY 1

数据洞察信息中心

BigQuery 可以与商业智能工具和信息中心集成，进行业务分析

以下示例展示了如何基于哪些任务和车辆构建信息中心移动情况可以在地图上显示。

启动新的数据洞察信息中心，并选择 BigQuery 作为数据连接。
选择“自定义查询”，然后选择它应该关联到的 Cloud 项目结算。
在查询框中输入以下查询。

    SELECT
     timestamp,
     labels.delivery_vehicle_id,
    jsonpayload_v1_updatedeliveryvehiclelog.response.lastlocation.rawlocation.latitude AS lat,
    jsonpayload_v1_updatedeliveryvehiclelog.response.lastlocation.rawlocation.longitude AS lng
    FROM
    `ProjectId.FleetEngineLogs.fleetengine_googleapis_com_update_delivery_vehicle`

选择气泡图作为图表类型，然后选择位置字段。
选择创建字段。
为该字段命名并添加以下公式：CONCAT(lat, ",", lng)。

然后将类型设置为地理->纬度, 经度。
您可以通过向信息中心添加控件来过滤数据。例如，选择 “日期范围”过滤条件
修改日期范围框以选择默认日期范围。
您可以为 delivery_vehicle_id 添加其他下拉列表控件。

通过这些控件，您可以直观地看到车辆的移动或