Flow Timeline

​

What is a Flow?

​

Viewing Flows

​

From the Logs View

1. Click any log that has a flow ID
2. In the detail panel, click the flow ID link
3. View all logs in that flow

​

Flow Timeline View

• All logs in the flow, ordered by step index
• Time elapsed between steps
• Total flow duration
• Visual timeline showing progress

​

Flow Details

​

Header

• Flow Name - Extracted from flow ID (e.g., checkout from checkout-a1b2c3d4)
• Flow ID - Full identifier
• Total Steps - Number of logs in the flow
• Duration - Time from first to last log
• Status - Success/Error based on final log level

​

Timeline

• Step Index - Position in sequence (0, 1, 2…)
• Time - When the step occurred
• Delta - Time since previous step
• Level - Log level (color-coded)
• Message - Log message

​

Example Flow

checkout-a1b2c3d4
Duration: 2.3s | 4 steps

[0] 0ms    info  "Checkout started"
[1] 150ms  info  "Cart validated"  (+150ms)
[2] 1.2s   info  "Payment processed"  (+1.05s)
[3] 2.3s   info  "Order confirmed"  (+1.1s)

​

Filtering Flows

​

By Flow ID

flowId:checkout-a1b2c3d4

​

By Flow Name

flowId:checkout-*

​

By Status

1. Filter logs to error level
2. Look for logs with flowId
3. Click through to see the full flow

​

Flow Analysis

​

Identifying Bottlenecks

[0] 0ms    "Started"
[1] 50ms   "Validated"     (+50ms)   ← Fast
[2] 3.5s   "Payment done"  (+3.45s)  ← Slow step!
[3] 3.6s   "Complete"      (+100ms)  ← Fast

​

Error Analysis

[0] info   "Checkout started"
[1] info   "Cart validated"
[2] error  "Payment failed: Card declined"

​

Missing Steps

[0] info   "Started"
[2] info   "Processing"  ← Step 1 missing!
[3] info   "Complete"

​

Best Practices

​

SDK Support

import { createTimberlogs } from 'timberlogs-client'

const timber = createTimberlogs({
  source: 'my-app',
  environment: 'production',
  apiKey: process.env.TIMBER_API_KEY,
})

const flow = timber.flow('checkout')

flow.info('Started checkout')
flow.info('Cart validated')
flow.info('Payment processed')
flow.info('Order confirmed')