Manage Custom Reports

In addition to the standard report options, such as Driver Compliance and Activity reports, you can create a report to view specific data customized to your fleet. You can choose to export the report or save the template to schedule future reports. The report data sets available are dependent on the report type:

Driver Custom Report: Driver-specific information and attributes such as safety and risk related behaviors, compliance data, and fuel-related driving habits. Deactivated drivers will only be included in a report if they were active during the date range selected for the report.
Vehicle & Asset Custom Report: Vehicle and device data such as odometer readings, camera status, and submitted DVIRs.

When you create a custom report, you choose the specific fields, field names, field order, and any applied tags or attributes. To create custom reports, you must be a Full Admin, Standard Admin, or have a custom role with permission to create custom reports.

From the Samsara dashboard, select Reports () > +Create Custom Report.
Choose the Driver or Vehicle & Asset report type that you want to create.
Select Next.
Choose the fields you want to use as columns in your report. To find a specific field, explore the field categories or use the search field.

To view all available fields that you can include in your report, see Custom Report Fields.
Optionally, you can expand the scope of the report when you select data columns from the Attributes column selection.

The attributes category is considered a dynamic field category. Every attribute you create will be available as an individual data column ready for selection during report configuration. To learn more about attributes and how to create them, see Attributes.

If an attribute is removed it will also disappear from the column selection. This means if a custom report includes an attribute which is later removed, that custom report will prompt you to create a new report without that attribute as it no longer exists.
Select Next when done.
Format your report:
1. Enter a descriptive Report Name.
2. (Optional) Drag () and drop the fields into your preferred order.
3. (Optional) Rename any fields for which you want to provide a custom name.
4. (Optional) To add additional columns, click +Add Column.
Save to preview the custom report.
Select Run Report to view all report data.
To edit a custom report, change the filter or date range then Run Report to view the new data set:
1. Select Run Report to view the new data set, or select Cancel to return to the most recent run.
2. (Optional) Select Recent runs to view up to three previous runs in the Recent runs drop-down.
  
  Clicking a previous run will enable you to return to a different filter set or date range without having to re-run the report.
Return to the Custom Reports page and select a custom report to perform the following actions:
1. To export a custom report, select Export and choose an export method (CSV, XLSX, or PDF file).
2. Select Schedule a Custom Report to be emailed on a recurring cadence to users in your organization.
3. To reopen the configuration edit modal where you can add, remove, and reorder columns, select Edit Report.
4. To remove the report from your organization's custom reports, select Delete Report. Deleting the report will delete it for all users in the organization.

Custom Report Fields

The following table summarizes the fields that are available for a custom report:

Field Category	Description	Available Fields
Driver	(Driver custom report only) Data relevant to driver information including HOS status, location, personal information, and vehicle identifying information.	Created At: Date the driver was added to your Samsara dashboard Driver Name ELD Exempt: Driver ELD exemption status ELD Exempt Reason Is Deactivated License Number License State: Issuing state of driver license Notes: Notes from the driver profile within Driver settings Peer Group Tag Phone Tags Timezone Trailer Group Tag Username Vehicle Group Tag
Asset	(Vehicle and Asset custom report only) Asset specific identifying information.	Device Gateway Serial Device Name License Plate Product Tags User Note Vehicle Make Vehicle Model Vehicle Vin Vehicle Year
Activity & Fuel	Data related to fuel efficiency, engine use, and distance.	Anticipation Score: Score reflecting total number of breaking events where the time from accelerator to break is less than 1 second Coasting Score: Score reflecting total time the driver spent coasting in any gear Cruise Control Score: Score reflecting total time the driver spent in cruise control Device Last Connected: Vehicle and Asset custom report only Distance Traveled (Odometer w/ GPS fallback): This field does not require fuel consumption diagnostics to be available and is recommended for vehicles that do not have fuel diagnostics. Distance Traveled Using Electric Power (Odometer) Distance - Fuel & Energy Report: When fuel consumption data is unavailable, mileage where fuel consumption data is missing is filtered out. This field is recommended for vehicles that have fuel diagnostics. Driver Efficiency Score: Driver's overall efficiency score as determined through the Driver Efficiency report End Odometer: Vehicle and Asset custom report only Energy Consumed (kwh): Total energy consumed (hybrid and electric vehicles) Energy Cost Engine Idle Time: Total time the engine is on, but the vehicle is not moving and power take-off (PTO) is not engaged. When a vehicle switches to idle and the idle time exceeds two minutes, idle time is reported. Idle time less than two minutes is not reported. Engine On Time: Total amount of time the engine is on (from the Fuel & Energy report) Engine Time: Total driving time based on location data (same as the Driving Time column in the Activity report) Fuel Consumed Fuel Cost Fuel Efficiency: Miles per gallon usage over the reporting time frame Green Band Driving Score: Score reflecting total time the driver spent in most efficient RPM band High Engine Torque Score: Score reflecting total time the driver spent with engine torque greater than 90% Idle Score: Score reflecting total time the driver spent idling, excluding PTO time when vehicle is stationary Last Known Location: Vehicle and Asset custom report only Over Speed Score: Score reflecting total time the driver spent above recommended speed limit PTO While Idle Time: Total time the engine is on and PTO auxiliary input is engaged Start Odometer: Vehicle and Asset custom report only Vehicle Stop Count: Total number of stops (a stop is counted when a trip ends)
Safety	Data related to cameras and camera-detected risk factors.	Acceleration Count Braking Count Camera Health Recommended Action: Vehicle and Asset custom report only Camera Last Connected: Vehicle and Asset custom report only Camera Status: Vehicle and Asset custom report only Harsh Turn Count Heavy Speeding Time Light Speeding Time Max Speed: The maximum speed the driver reached during reporting timeframe Max Speed At: Date and time the driver reached the maximum speed Moderate Speeding Time Not Speeding Time: Total time the driver spent without speeding Safety Score Safety Score Rank Severe Speeding Time
Compliance	(Driver custom report only) HOS status changes and compliance data.	Driving (Duration) Off Duty (Duration) On Duty (Duration) Personal Conveyance (Duration) Sleeper Berth (Duration) Waiting Time (Duration) Yard Move (Duration)
Maintenance	Submitted DVIR data.	Submitted DVIRs Submitted Safe DVIRs Submitted Unsafe DVIRs

Custom Report Fields

Comments

Articles in this section

Custom Report Fields

Related articles

Articles in this section