Release History
The Release History provides a complete audit trail of all activities performed in a release, capturing user actions along with dates and times. This helps track progress, monitor changes, and troubleshoot issues with greater visibility.
Overview
The History tab is available contextually in the following areas:
- Release templates
- Workflow templates
- Releases
- Workflow executions
- Delivery patterns
- Deliveries
- Triggers
The overall layout is consistent across these views, with minor variations depending on the context.
Accessing the History Tab
To open the History tab:
- Navigate to a release or template.
- Click VIEW > Flow in the sidebar.
- Click INSIGHTS > History.
You can also access it directly from the Task Drawer shortcut menu:
- Open the Task Drawer.
- Click the ellipsis icon (
).
- Select View history.
This redirects you to the History tab.
Key Features
On the History tab, you can:
-
View Activity Logs
The table lists all events with the following columns:- Performed by: The user or system actor that executed the action.
- Activity: A description of the event (e.g., task started, release completed, task skipped).
Long log messages are trimmed and can be expanded using Show more. Status-based events such as failed, completed, or skipped are highlighted with badges.
- Target: The object affected by the action (release, phase, task, or trigger).
If a task ID is present, it links directly to the task. If unavailable (e.g., for attachments), an alternative message is shown.
- Time: The date and time when the event occurred. Use the arrow icon to sort in ascending or descending order.
-
Highlight Important Activities
Enable the Highlight important toggle to emphasize critical events such as:- Failed or skipped tasks
- Completed releases or workflows
- Aborted executions
- Phase and stage starts/completions
The system highlights the following event types:
DELIVERY_COMPLETED
ITEM_COMPLETED
ITEM_COMPLETED_MANUALLY
ITEM_DESCOPED
ITEM_REMOVED
ITEM_RESCOPED
ITEM_RESET
ITEM_RESET_MANUALLY
ITEM_SKIPPED
ITEM_TRANSITION_APPROVED
PHASE_STARTED
RELEASE_ABORTED
RELEASE_COMPLETED
RELEASE_FLAG_COMMENT_UPDATED
RELEASE_FLAG_STATUS_UPDATED
RELEASE_STARTED
STAGE_COMPLETED
STAGE_REMOVED
STAGE_STARTED
TASK_ABORT_SCRIPT_COMPLETED
TASK_ABORT_SCRIPT_STARTED
TASK_DELETED
TASK_FAILED
TASK_FLAG_COMMENT_UPDATED
TASK_FLAG_STATUS_UPDATED
TASK_RECOVERED
TASK_RECOVERY_STARTED
TASK_SKIPPED
TASK_SKIPPED_IN_ADVANCE
TRANSITION_EXECUTED_AUTOMATICALLY
TRANSITION_EXECUTED_MANUALLY
WORKFLOW_EXECUTION_ABORTED
WORKFLOW_EXECUTION_COMPLETED
WORKFLOW_EXECUTION_STARTED
Default Display
- By default, all activities are displayed in the History tab with the most recent entries at the top.
- This eliminates the need to manually select the Category filter.
Filter and Search
-
Use the search bar to quickly find logs by user, activity type, or log ID.
-
Release administrator actions (for example, task comments) are grouped under Release Administrator.
Example: Filtering logs by user and activity type
-
Apply advanced filters using the filter drawer (target, time, or user).
-
The number of active filters appears in both the filter button badge and the subheader.
Example: Advanced filter drawer with multiple options
Persistent Filters
- Any filters or selections you make update the URL.
- When you refresh or return later, the same filters remain applied via local storage.
Color-Coded Tags
-
Visual labels (pills) help distinguish completed, failed, or skipped items for quick scanning.
Categories of Activities
The History tab groups activities into the following categories:
- Task-Level Activities
- Examples: Task started, Task completed, Task skipped.
- Tracks the execution and outcome of individual tasks.
- Release and Phase Activities
- Examples: Release started, Release completed, Phase started, Phase failed.
- Provides visibility into overall release progress and health.
- System-Generated Activities
- Examples: Error messages, failure reasons, or system-triggered status updates.
- Helps with root cause analysis during troubleshooting.
- Sub-Release Creation
- When a child release is created using the Create Release task, the History tab records the parent release as the Target.
- This ensures proper linkage and avoids confusion where the child release was previously shown as the target.
- Trigger-Based Release Creation
- When a release is created through a trigger, the History tab displays the Trigger name and lists the Target as Trigger.
- This improves traceability by showing how and why the release was initiated.