Skip to main content

The Benchling Compliance Controls Team is excited to introduce the Chain of Custody - Container History Report. This was released to standard tenants earlier this fall with the launch to Validated Cloud customers expected in January 2024! These reports provide comprehensive tracking for sample data and are Benchling’s key milestone on the way to offering Chain of Custody in the future. 

With Chain of Custody reporting, you can now:

  • Improve traceability of  sample containers
    • Track the end-to-end lifecycle of a sample container from creation  through use and archival.  
  •  Verify sample integrity for  audit purposes
    • Identify errors in sample handling across users and container  activity.     
  • Increase speed of data  aggregation for reporting
    • Minimize manual search and collation of sample container audit data  from multiple sources.
  • Ensure consistent reporting  of sample container activity
    •  Standardize format of data exports across sample containers.

The Container History Report allows teams to understand the sample’s history, for example: 

  • “Where has this sample been?” 
  • “Who had custody” or “Who transferred contents?” 
  • “How can I better understand additional context around sample container historic events?”

A container history report is a document containing the history of an entity within a container, including who handled the sample and when, what actions were performed against the sample, and the locations, dates, and times of those actions. After downloading the report, you can review it to track information, like how many people handled the sample, its location changes over time, and under what storage conditions the sample was maintained.

Download the Container History Report

  • Where in the UI can you access the Container History Report? How do you download the Report from the Container and how can you also access the report through the Global Search menu? 

xS5tthGmBAQutlaPSU4893TJMC0lSfXqrZsf1EdtjTP3bO2Ij73WX4pN_UTZ7gsSvMkfbmG501aVSAfafloqMxR2ZdOiCOXFntoePrcTEv7rL5HMcrTy7u9tLGRbq0LGQqFhNhu35U8C4FfA6RsUI7c

5RsfnNYMWhuMopYBO7NT7yGs4fnCX6tdOqw31Sk9k5kjjF93gc2S2HdojwHYYeTj0mXA79Wa5Yz6LLSbKwmt_rUN4Sdcan0D7HkwW99_8NLK8oXueZ2f4-Ps6-Zwv9i1R5FhXLscuhLENRf3645OGEE

Structure of the Container History Report 

  • Understand the structure of the Container History Report and definition of columns that appear in the Report.  

Reports render in an intuitive format that includes one update per row, before and after changes in separate columns, and consistent formatting across all change events. 

The table below describes each column in the audit log and what they represent.

Column name

Column description

Timestamp (UTC)

Datetime the activity occurred

User

Username for the account that made the update. 

Activity description

Overview of the action performed

Item

Object the action was performed on

Old value

Previous value before change occurred, if the action resulted in an item value changing

New value

New value after change occurred, if the action resulted in an item value changing

Container

Container the report was exported from. If the event was an entity transfer, this field populates the container the entity was transferred into.

Entity

The entity or entities in the container

Inventory location

Inventory path (location hierarchy) for the container 

 

We are delighted to provide the Benchling Community with the ability to trace your samples. Let us know if you’ve had a chance to try out this feature or if you have any feedback to share!

That is awesome! Will this integrate with the warehouse? (That is: will these time stamps become available as a table in the insights queries module?)


Hi @Robin Dorstijn - Great question and we are glad you are enjoying the functionality! The Container History Report currently does not integrate with the Warehouse, however, we have longer-term plans to expose the Report via API overtime. CC @Melissa DiTucci 

 


Has there been any update to if the container history reporting is exposed in the API for large scale inventory history tracking / troubleshooting? Will this functionality be exposed in the V3?


Great question ​@lenriquez! We recently shipped Audit Trails via API under the V2-beta (GA) endpoint which should allow you to programmatically access the Inventory audit trail now. We plan to promote this to V3 in H1 next year and also include the Container History Report and Plate Chain of Custody report at that time. We hope the audit trail API in V2-beta state can provide value in the interim. 


Thank you ​@ankita_dhar ! Follow up question, when it returns the taskID for generating the audit report (in V2-beta), how would I go about accessing the csv file that gets generated from the call? Wold I then have to use the taskID to get the url via the tasks endpoint in v2?

Also can the the Audit Trails V2-beta endpoint be available through the python SDK?


After returning the taskID, call GET tasks in a loop with the taskID until the task is ready. When the task has completed, you should receive the response containing the download url to copy into browser and export the CSV. 

Also - yes, Audit Trails V2-beta endpoint is available through the python SDK! ​@lenriquez 


Reply