Filter Executions by executed node #16036

Alexandero89 · 2025-06-05T00:52:40Z

Introduced the ability to filter executions by specific nodes in both backend and frontend components.

Summary

This PR is a first draft and also serves as a Request for Comments (RFC).

I frequently need to see all executions where a specific node was executed.
Currently, there is no way to filter executions by executed nodes.
This PR adds a button to the right-click context menu in the editor, enabling quick access to this functionality.
It introduces an update to the /executions route router, so that it can accept a URL parameter.
The URL parameter allows specifying the nodeId to be filtered for in the backend/database.

Feedback and suggestions are highly appreciated!

Showcasevideo

bildschirmaufzeichnung-vom-2025-06-05-02-47-12_wKow5MCV.mp4

Review / Merge checklist

PR title and summary are descriptive. (conventions)
Docs updated or follow-up ticket created.
Tests included.
PR Labeled with release/backport (if the PR is an urgent fix that needs to be backported)

Introduced the ability to filter executions by specific nodes in both backend and frontend components.

CLAassistant · 2025-06-05T00:52:46Z

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.

Alex O seems not to be a GitHub user. You need a GitHub account to be able to sign the CLA. If you have already a GitHub account, please add the email address used for this commit to your account.
_{You have signed the CLA already but the status is still pending? Let us recheck it.}

cubic-dev-ai

cubic found 10 issues across 12 files. Review them in cubic.dev

_{React with 👍 or 👎 to teach cubic. Tag @cubic-dev-ai to give specific feedback.}

cubic-dev-ai · 2025-06-05T00:57:14Z

packages/frontend/@n8n/i18n/src/locales/en.json

@@ -1545,6 +1545,7 @@
 	"contextMenu.addSticky": "Add sticky note",
 	"contextMenu.editSticky": "Edit sticky note",
 	"contextMenu.changeColor": "Change color",
+	"contextMenu.FilterExecutionsBy": "Filter Executions by",


Translation key naming inconsistency. The key uses camelCase 'FilterExecutionsBy' but is referenced in code as 'filter_executions_by'.

Suggested change

"contextMenu.FilterExecutionsBy": "Filter Executions by",

"contextMenu.filter_executions_by": "Filter Executions by",

Will change this and some other variables to be consistent with the rest of the naming

cubic-dev-ai · 2025-06-05T00:57:14Z

packages/frontend/editor-ui/src/views/WorkflowExecutionsView.vue

@@ -51,6 +51,13 @@ const executions = computed(() =>
 		: [],
 );

+const FilterExecutionsBy = computed(() => {


Rule violated: Ensure every PR has unit tests for Vue files

Missing unit tests for WorkflowExecutionsView.vue component

cubic-dev-ai · 2025-06-05T00:57:14Z

packages/@n8n/db/src/repositories/execution.repository.ts

+			const idConditions: string[] = [];
+			query.nodesExecuted.forEach((node, idx) => {
+				idConditions.push(
+					`json_type(json_extract(execution_data.data, '$[4].' || :nodeName${idx})) IS NOT NULL`,


SQL function json_extract may not be compatible with all database types

Is this query executed in the sqlite and the postgres setup aswell?
Or only the sqlite?

Cause:
"json_extract is natively supported in modern SQLite versions (3.9.0 and above, released since 2015) if it is compiled with the JSON1 extension—most pre-built binaries include this by default."

cubic-dev-ai · 2025-06-05T00:57:14Z

packages/@n8n/db/src/repositories/execution.repository.ts

+			const idConditions: string[] = [];
+			query.nodesExecuted.forEach((node, idx) => {
+				idConditions.push(
+					`json_type(json_extract(execution_data.data, '$[4].' || :nodeName${idx})) IS NOT NULL`,


Hardcoded array index '$[4]' in JSON path is brittle and lacks documentation

I analyzed the json in the database and it seems the 4th element is a list where all executed nodes of an execution are listed. so we should always find the node we are searching for in the 4th element.

cubic-dev-ai · 2025-06-05T00:57:14Z

packages/frontend/editor-ui/src/Interface.ts

@@ -1371,6 +1372,7 @@ export type ExecutionsQueryFilter = {
 	startedBefore?: string;
 	annotationTags?: string[];
 	vote?: ExecutionFilterVote;
+	nodesExecuted: string[];


Type inconsistency between ExecutionFilterType and ExecutionsQueryFilter interfaces. In ExecutionFilterType, nodesExecuted is optional, but in ExecutionsQueryFilter, it's required. This could cause runtime errors when transforming between these types in executionFilterToQueryFilter function.

Suggested change

nodesExecuted: string[];

+ nodesExecuted?: string[];

cubic-dev-ai · 2025-06-05T00:57:14Z

packages/frontend/editor-ui/src/components/canvas/Canvas.vue

@@ -54,7 +54,11 @@ import CanvasArrowHeadMarker from './elements/edges/CanvasArrowHeadMarker.vue';
 import Edge from './elements/edges/CanvasEdge.vue';
 import Node from './elements/nodes/CanvasNode.vue';
 import { useViewportAutoAdjust } from '@/components/canvas/composables/useViewportAutoAdjust';
+import { useRouter, useRoute } from 'vue-router';


Rule violated: Ensure every PR has unit tests for Vue files

Missing unit tests for the new filter executions functionality

cubic-dev-ai · 2025-06-05T00:57:15Z

packages/frontend/editor-ui/src/components/canvas/Canvas.vue

+async function onFilterExecutionBy(input: { ids: string[] }) {
+	const workflowId = route.params.name as string;
+	if (!workflowId || !input || !input.ids || input.ids.length === 0) return;
+	const customFilter = nodeDataById.value[input.ids[0]]?.name;


Missing validation for nodeDataById.value[input.ids[0]] existence before accessing name property

Suggested change

const customFilter = nodeDataById.value[input.ids[0]]?.name;

+ const customFilter = nodeDataById.value[input.ids[0]]?.name || undefined;

cubic-dev-ai · 2025-06-05T00:57:15Z

packages/@n8n/db/src/repositories/execution.repository.ts

@@ -961,6 +961,9 @@ export class ExecutionRepository extends Repository<ExecutionEntity> {
 		const qb = this.createQueryBuilder('execution')
 			.select(fields)
 			.innerJoin('execution.workflow', 'workflow')
+			// Add join to execution_data in the query builder


Comment indicates this join might not be needed for all queries, but it's added unconditionally

I will have to think about how to solve this better. not every execution needs this join.
feedback is very welcomed here

implemented a better solution in the new commit. have a look

cubic-dev-ai · 2025-06-05T00:57:15Z

packages/frontend/editor-ui/src/types/canvas.ts

@@ -182,6 +182,7 @@ export type CanvasEventBusEvents = {
 		payload?: CanvasNodeEventBusEvents[keyof CanvasNodeEventBusEvents];
 	};
 	tidyUp: { source: CanvasLayoutSource };
+	filter_executions_by: { ids: string[] };


The event only uses the first node ID from the array in the implementation, but the type suggests multiple IDs are supported.

For this proof of concept i implemented the filtering for only one node.
The idea is later to be able to filter by multiple nodes that are marked.

cubic-dev-ai · 2025-06-05T00:57:15Z

packages/frontend/editor-ui/src/components/canvas/Canvas.vue

@@ -699,6 +714,9 @@ async function onContextMenuAction(action: ContextMenuAction, nodeIds: string[])
 			return await onTidyUp({ source: 'context-menu' });
 		case 'extract_sub_workflow':
 			return emit('extract-workflow', nodeIds);
+		case 'filter_executions_by':
+			onFilterExecutionBy({ ids: nodeIds });


Redundant function call before emitting the same event

Joffcom · 2025-06-05T01:00:32Z

Hey @Alexandero89,

Thanks for the PR, We have created "GHC-2353" as the internal reference to get this reviewed.

One of us will be in touch if there are any changes needed, in most cases this is normally within a couple of weeks but it depends on the current workload of the team.

Alex O added 2 commits June 5, 2025 02:24

feat(executions): add filter by executed nodes

9e58acc

Introduced the ability to filter executions by specific nodes in both backend and frontend components.

fix typo

124815d

fix typo

f2ca467

cubic-dev-ai bot reviewed Jun 5, 2025

View reviewed changes

n8n-assistant bot added community Authored by a community member core Enhancement outside /nodes-base and /editor-ui in linear Issue or PR has been created in Linear for internal review labels Jun 5, 2025

Alex O added 4 commits June 5, 2025 14:53

Better db querying and only innerjoin when necessary

a3bf3eb

follow naming convention

504be33

make filter value optional

2046478

just some optimization

4cbf7ba

	"contextMenu.FilterExecutionsBy": "Filter Executions by",
	"contextMenu.filter_executions_by": "Filter Executions by",

	const customFilter = nodeDataById.value[input.ids[0]]?.name;
	+ const customFilter = nodeDataById.value[input.ids[0]]?.name \|\| undefined;

Filter Executions by executed node #16036

Are you sure you want to change the base?

Filter Executions by executed node #16036

Conversation

Alexandero89 commented Jun 5, 2025

Summary

Showcasevideo

Review / Merge checklist

Uh oh!

CLAassistant commented Jun 5, 2025

Uh oh!

cubic-dev-ai bot left a comment

Choose a reason for hiding this comment

Uh oh!

cubic-dev-ai bot Jun 5, 2025

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

cubic-dev-ai bot Jun 5, 2025

Choose a reason for hiding this comment

Uh oh!

cubic-dev-ai bot Jun 5, 2025

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

cubic-dev-ai bot Jun 5, 2025

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

cubic-dev-ai bot Jun 5, 2025

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

cubic-dev-ai bot Jun 5, 2025

Choose a reason for hiding this comment

Uh oh!

cubic-dev-ai bot Jun 5, 2025

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

cubic-dev-ai bot Jun 5, 2025

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Alexandero89 Jun 5, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

cubic-dev-ai bot Jun 5, 2025

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

cubic-dev-ai bot Jun 5, 2025

Choose a reason for hiding this comment

Uh oh!

Joffcom commented Jun 5, 2025

Uh oh!

Uh oh!

Alexandero89 Jun 5, 2025 •

edited

Loading