What Timesketch is

The code lives in the google organisation on GitHub under the Apache 2.0 licence, and its README says it is not an official Google product, just code that Google owns. The install guide names Docker as the preferred and only tested method, on Ubuntu 22.04 in its example, and starts a stack of the Timesketch web and API server, an importer and analysis worker, OpenSearch for the index, PostgreSQL for the database, Redis for the workers and an Nginx front. A Kubernetes path exists through the OSDFIR Infrastructure project. The unit of work is a sketch, which holds one or more timelines imported from Plaso storage files, CSV or JSON lines. Events are searched with a query language, saved as views, starred, tagged and commented. Analyzers run over a timeline to add tags automatically and Sigma rules can be applied. An interactive notebook is available for deeper work.

The pairing with Plaso is the common path. log2timeline makes the storage file, the examiner uploads it through the web interface or the importer command and can filter events at import. On a large incident each analyst takes a host while the sketch keeps the shared view, and the comments and tags become the record of who concluded what and when. Timesketch extracts nothing itself. It holds what Plaso or another tool gave it, so a weak timeline makes a weak sketch. Because the server holds evidence, it belongs inside a controlled laboratory network with access control, backups and a retention rule, the same as any evidence store.

Primary applications

Where it is used

  • Joint review of many host timelines after an incident
  • Tagging and commenting events so the reasoning is recorded beside the evidence
  • Applying Sigma rules and analyzers to past events
  • Searching for one indicator across every host in a case
  • Teaching timeline analysis in a laboratory with a shared sketch
  • Building a documented sequence of events for a report

Who uses it

  • Incident response teams
  • Forensic laboratories with several analysts on one case
  • Trainers running timeline exercises
  • Researchers

Capabilities and limits

Major capabilities

  • Sketches that group timelines and share them with collaborators
  • Import of Plaso storage files, CSV and JSON lines with import-time filtering
  • Search with a query language, saved views and starred events
  • Annotations, comments, tags and stars on individual events
  • Analyzers that tag events automatically and Sigma rule support
  • Interactive notebook for analysis beyond the web interface
  • Docker-based deployment with OpenSearch, PostgreSQL and Redis
  • Kubernetes deployment through OSDFIR Infrastructure

Technical limitations

  • Needs server administration skills to deploy and keep healthy
  • Evidence sits in OpenSearch, so access control, backup and retention are the laboratory's responsibility
  • The sketch is only as good as the timeline imported into it
  • Very large sketches slow down without cluster tuning
  • Docker on Ubuntu is the tested path. Other setups are described as unsupported
  • No extraction of its own. Plaso or another tool must run first

Learning with DFRTI

Independent professional education covering the principles and workflows of Timesketch. DFRTI is not a vendor training centre and its courses are not vendor certifications.

Courses that cover this tool

Product names and trademarks belong to their respective owners. DFRTI is an independent educational and research institute. Inclusion in this directory does not imply manufacturer endorsement, partnership or authorisation. Facts are checked against the manufacturer's public documentation on the date shown and may have changed since.

Go deeper with DFRTI

Free pages explain the ground. Structured courses, lab work and a mentor take you from knowing about it to doing it on a case.