Skip to content

Errors (versions) #3187

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
matt-aitken wants to merge 7 commits into
base: main
Choose a base branch
from
+2,182 −64
Draft

Errors (versions) #3187

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
b6ead44
Add versions filtering to the Errors list page
matt-aitken Mar 5, 2026
307f968
Added versions filter to the fingerprint page
matt-aitken Mar 5, 2026
1b05a0b
Stacked bars for the versions
matt-aitken Mar 5, 2026
5e44b5f
Removed legend
matt-aitken Mar 5, 2026
82a5ea0
Error alerting
matt-aitken Mar 10, 2026
de3a49f
Use SegmentedControl for error filtering
matt-aitken Mar 10, 2026
e609e8b
Switch to a status dropdown
matt-aitken Mar 16, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
58 changes: 58 additions & 0 deletions apps/webapp/app/components/logs/LogsVersionFilter.tsx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,58 @@
import * as Ariakit from "@ariakit/react";
import { SelectTrigger } from "~/components/primitives/Select";
import { useSearchParams } from "~/hooks/useSearchParam";
import { appliedSummary, FilterMenuProvider } from "~/components/runs/v3/SharedFilters";
import { filterIcon, VersionsDropdown } from "~/components/runs/v3/RunFilters";
import { AppliedFilter } from "~/components/primitives/AppliedFilter";

const shortcut = { key: "v" };

export function LogsVersionFilter() {
const { values, del } = useSearchParams();
const selectedVersions = values("versions");

if (selectedVersions.length === 0 || selectedVersions.every((v) => v === "")) {
return (
<FilterMenuProvider>
{(search, setSearch) => (
<VersionsDropdown
trigger={
<SelectTrigger
icon={filterIcon("versions")}
variant="secondary/small"
shortcut={shortcut}
tooltipTitle="Filter by version"
>
<span className="ml-0.5">Versions</span>
</SelectTrigger>
}
searchValue={search}
clearSearchValue={() => setSearch("")}
/>
)}
</FilterMenuProvider>
);
}

return (
<FilterMenuProvider>
{(search, setSearch) => (
<VersionsDropdown
trigger={
<Ariakit.Select render={<div className="group cursor-pointer focus-custom" />}>
<AppliedFilter
label="Versions"
icon={filterIcon("versions")}
value={appliedSummary(selectedVersions)}
onRemove={() => del(["versions", "cursor", "direction"])}
variant="secondary/small"
/>
</Ariakit.Select>
}
searchValue={search}
clearSearchValue={() => setSearch("")}
/>
)}
</FilterMenuProvider>
);
}
7 changes: 7 additions & 0 deletions apps/webapp/app/components/primitives/charts/ChartRoot.tsx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -40,6 +40,8 @@ export type ChartRootProps = {
onViewAllLegendItems?: () => void;
/** When true, constrains legend to max 50% height with scrolling */
legendScrollable?: boolean;
/** Additional className for the legend */
legendClassName?: string;
/** When true, chart fills its parent container height and distributes space between chart and legend */
fillContainer?: boolean;
/** Content rendered between the chart and the legend */
Expand Down Expand Up @@ -87,6 +89,7 @@ export function ChartRoot({
legendValueFormatter,
onViewAllLegendItems,
legendScrollable = false,
legendClassName,
fillContainer = false,
beforeLegend,
children,
Expand Down Expand Up @@ -114,6 +117,7 @@ export function ChartRoot({
legendValueFormatter={legendValueFormatter}
onViewAllLegendItems={onViewAllLegendItems}
legendScrollable={legendScrollable}
legendClassName={legendClassName}
fillContainer={fillContainer}
beforeLegend={beforeLegend}
>
Expand All @@ -133,6 +137,7 @@ type ChartRootInnerProps = {
legendValueFormatter?: (value: number) => string;
onViewAllLegendItems?: () => void;
legendScrollable?: boolean;
legendClassName?: string;
fillContainer?: boolean;
beforeLegend?: React.ReactNode;
children: React.ComponentProps<typeof RechartsPrimitive.ResponsiveContainer>["children"];
Expand All @@ -148,6 +153,7 @@ function ChartRootInner({
legendValueFormatter,
onViewAllLegendItems,
legendScrollable = false,
legendClassName,
fillContainer = false,
beforeLegend,
children,
Expand Down Expand Up @@ -193,6 +199,7 @@ function ChartRootInner({
valueFormatter={legendValueFormatter}
onViewAllLegendItems={onViewAllLegendItems}
scrollable={legendScrollable}
className={legendClassName}
/>
)}
</div>
Expand Down
2 changes: 1 addition & 1 deletion apps/webapp/app/components/runs/v3/RunFilters.tsx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1216,7 +1216,7 @@ function AppliedMachinesFilter() {
);
}

function VersionsDropdown({
export function VersionsDropdown({
trigger,
clearSearchValue,
searchValue,
Expand Down
6 changes: 6 additions & 0 deletions apps/webapp/app/models/projectAlert.server.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -32,3 +32,9 @@ export const ProjectAlertSlackStorage = z.object({
});

export type ProjectAlertSlackStorage = z.infer<typeof ProjectAlertSlackStorage>;

export const ErrorAlertConfig = z.object({
evaluationIntervalMs: z.number().min(60_000).default(300_000),
});

export type ErrorAlertConfig = z.infer<typeof ErrorAlertConfig>;
106 changes: 90 additions & 16 deletions apps/webapp/app/presenters/v3/ErrorGroupPresenter.server.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ import { z } from "zod";
import { type ClickHouse, msToClickHouseInterval } from "@internal/clickhouse";
import { TimeGranularity } from "~/utils/timeGranularity";
import { ErrorId } from "@trigger.dev/core/v3/isomorphic";
import { type PrismaClientOrTransaction } from "@trigger.dev/database";
import { type ErrorGroupStatus, type PrismaClientOrTransaction } from "@trigger.dev/database";
import { timeFilterFromTo } from "~/components/runs/v3/SharedFilters";
import { type Direction, DirectionSchema } from "~/components/ListPagination";
import { findDisplayableEnvironment } from "~/models/runtimeEnvironment.server";
Expand All @@ -27,6 +27,7 @@ export type ErrorGroupOptions = {
userId?: string;
projectId: string;
fingerprint: string;
versions?: string[];
runsPageSize?: number;
period?: string;
from?: number;
Expand All @@ -39,6 +40,7 @@ export const ErrorGroupOptionsSchema = z.object({
userId: z.string().optional(),
projectId: z.string(),
fingerprint: z.string(),
versions: z.array(z.string()).optional(),
runsPageSize: z.number().int().positive().max(1000).optional(),
period: z.string().optional(),
from: z.number().int().nonnegative().optional(),
Expand All @@ -59,6 +61,18 @@ function parseClickHouseDateTime(value: string): Date {
return new Date(value.replace(" ", "T") + "Z");
}

export type ErrorGroupState = {
status: ErrorGroupStatus;
resolvedAt: Date | null;
resolvedInVersion: string | null;
resolvedBy: string | null;
ignoredUntil: Date | null;
ignoredReason: string | null;
ignoredByUserId: string | null;
ignoredUntilOccurrenceRate: number | null;
ignoredUntilTotalOccurrences: number | null;
};

export type ErrorGroupSummary = {
fingerprint: string;
errorType: string;
Expand All @@ -68,10 +82,12 @@ export type ErrorGroupSummary = {
firstSeen: Date;
lastSeen: Date;
affectedVersions: string[];
state: ErrorGroupState;
};

export type ErrorGroupOccurrences = Awaited<ReturnType<ErrorGroupPresenter["getOccurrences"]>>;
export type ErrorGroupActivity = ErrorGroupOccurrences["data"];
export type ErrorGroupActivityVersions = ErrorGroupOccurrences["versions"];

export class ErrorGroupPresenter extends BasePresenter {
constructor(
Expand All @@ -89,6 +105,7 @@ export class ErrorGroupPresenter extends BasePresenter {
userId,
projectId,
fingerprint,
versions,
runsPageSize = DEFAULT_RUNS_PAGE_SIZE,
period,
from,
Expand All @@ -110,23 +127,36 @@ export class ErrorGroupPresenter extends BasePresenter {
defaultPeriod: "7d",
});

const [summary, affectedVersions, runList] = await Promise.all([
const [summary, affectedVersions, runList, stateRow] = await Promise.all([
this.getSummary(organizationId, projectId, environmentId, fingerprint),
this.getAffectedVersions(organizationId, projectId, environmentId, fingerprint),
this.getRunList(organizationId, environmentId, {
userId,
projectId,
fingerprint,
versions,
pageSize: runsPageSize,
from: time.from.getTime(),
to: time.to.getTime(),
cursor,
direction,
}),
this.getState(environmentId, fingerprint),
]);
Comment on lines +130 to 145
Copy link
Contributor

@coderabbitai coderabbitai bot Mar 16, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major

State lookup needs the task identifier.

ErrorGroupState is keyed by environment + taskIdentifier + fingerprint elsewhere in this PR, but this query only filters by environment and fingerprint. If the same fingerprint exists under multiple tasks, the page can show the wrong resolved/ignored state; fetching summary and stateRow in the same Promise.all also prevents you from disambiguating it.

Also applies to: 318-340

🤖 Prompt for AI Agents 
Verify each finding against the current code and only fix it if needed.

In `@apps/webapp/app/presenters/v3/ErrorGroupPresenter.server.ts` around lines 130
- 145, getState is being called without the task identifier so it can return the
wrong ErrorGroupState when the same fingerprint exists under multiple tasks;
stop fetching summary and state in parallel and instead first await
this.getSummary(...) to read the taskIdentifier, then call
this.getState(environmentId, taskIdentifier, fingerprint) (or otherwise pass the
task identifier into getState) when you run the remaining Promise.all for
getAffectedVersions, getRunList and getState so state lookup is disambiguated by
taskIdentifier.


if (summary) {
summary.affectedVersions = affectedVersions;
summary.state = stateRow ?? {
status: "UNRESOLVED",
resolvedAt: null,
resolvedInVersion: null,
resolvedBy: null,
ignoredUntil: null,
ignoredReason: null,
ignoredByUserId: null,
ignoredUntilOccurrenceRate: null,
ignoredUntilTotalOccurrences: null,
};
}

return {
Expand All @@ -140,23 +170,26 @@ export class ErrorGroupPresenter extends BasePresenter {
}

/**
* Returns bucketed occurrence counts for a single fingerprint over a time range.
* Granularity is determined automatically from the range span.
* Returns bucketed occurrence counts for a single fingerprint over a time range,
* grouped by task_version for stacked charts.
*/
public async getOccurrences(
organizationId: string,
projectId: string,
environmentId: string,
fingerprint: string,
from: Date,
to: Date
to: Date,
versions?: string[]
): Promise<{
data: Array<{ date: Date; count: number }>;
data: Array<Record<string, number | Date>>;
versions: string[];
}> {
const granularityMs = errorGroupGranularity.getTimeGranularityMs(from, to);
const intervalExpr = msToClickHouseInterval(granularityMs);

const queryBuilder = this.logsClickhouse.errors.createOccurrencesQueryBuilder(intervalExpr);
const queryBuilder =
this.logsClickhouse.errors.createOccurrencesByVersionQueryBuilder(intervalExpr);

queryBuilder.where("organization_id = {organizationId: String}", { organizationId });
queryBuilder.where("project_id = {projectId: String}", { projectId });
Expand All @@ -169,7 +202,11 @@ export class ErrorGroupPresenter extends BasePresenter {
toTimeMs: to.getTime(),
});

queryBuilder.groupBy("error_fingerprint, bucket_epoch");
if (versions && versions.length > 0) {
queryBuilder.where("task_version IN {versions: Array(String)}", { versions });
}

queryBuilder.groupBy("error_fingerprint, task_version, bucket_epoch");
queryBuilder.orderBy("bucket_epoch ASC");

const [queryError, records] = await queryBuilder.execute();
Expand All @@ -186,17 +223,27 @@ export class ErrorGroupPresenter extends BasePresenter {
buckets.push(epoch);
}

const byBucket = new Map<number, number>();
// Collect distinct versions and index results by (epoch, version)
const versionSet = new Set<string>();
const byBucketVersion = new Map<string, number>();
for (const row of records ?? []) {
byBucket.set(row.bucket_epoch, (byBucket.get(row.bucket_epoch) ?? 0) + row.count);
const version = row.task_version || "unknown";
versionSet.add(version);
const key = `${row.bucket_epoch}:${version}`;
byBucketVersion.set(key, (byBucketVersion.get(key) ?? 0) + row.count);
}

return {
data: buckets.map((epoch) => ({
date: new Date(epoch * 1000),
count: byBucket.get(epoch) ?? 0,
})),
};
const sortedVersions = sortVersionsDescending([...versionSet]);

const data = buckets.map((epoch) => {
const point: Record<string, number | Date> = { date: new Date(epoch * 1000) };
for (const version of sortedVersions) {
point[version] = byBucketVersion.get(`${epoch}:${version}`) ?? 0;
}
return point;
});
Comment on lines +238 to +244
Copy link
Contributor

@devin-ai-integration devin-ai-integration bot Mar 5, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Version string used as Record key can collide with reserved date key, breaking the chart

In getOccurrences, version strings are used as dynamic keys in the same Record<string, number | Date> that already has a date key (apps/webapp/app/presenters/v3/ErrorGroupPresenter.server.ts:214-217). If a task_version value is literally "date" (or empty-string mapped to "unknown" which is safe, but "date" is not guarded), the version count (a number) overwrites the date field (a Date). Downstream in ActivityChart (apps/webapp/app/routes/_app.orgs.$organizationSlug.projects.$projectParam.env.$envParam.errors.$fingerprint/route.tsx:428), d.date instanceof Date would be false and new Date(smallNumber).getTime() would produce a nonsensical timestamp (epoch 1970), completely breaking the chart's x-axis. The same collision can occur with "__timestamp" added at route.tsx:427.

Prompt for agents 
In apps/webapp/app/presenters/v3/ErrorGroupPresenter.server.ts, the getOccurrences method (lines 213-219) uses version strings as keys in a Record that also has a "date" key. To prevent collisions, either:

1. Prefix version keys with a safe namespace (e.g., "v:" prefix) and update the chart consumer to strip the prefix when displaying labels, OR
2. Restructure the data to use a separate nested object for version counts, e.g.:
   { date: Date, versions: Record<string, number> }
   and update the ChartRoot consumer in the fingerprint route (route.tsx lines 475-496) to match.

Also in apps/webapp/app/routes/_app.orgs.$organizationSlug.projects.$projectParam.env.$envParam.errors.$fingerprint/route.tsx line 427, the __timestamp key added via spread could similarly collide if a version were named "__timestamp". Guard against both reserved keys ("date" and "__timestamp").
Open in Devin Review

Was this helpful? React with 👍 or 👎 to provide feedback.


return { data, versions: sortedVersions };
}

private async getSummary(
Expand Down Expand Up @@ -268,13 +315,39 @@ export class ErrorGroupPresenter extends BasePresenter {
return sortVersionsDescending(versions).slice(0, 5);
}

private async getState(
environmentId: string,
fingerprint: string
): Promise<ErrorGroupState | null> {
const row = await this.replica.errorGroupState.findFirst({
where: {
environmentId,
errorFingerprint: fingerprint,
},
select: {
status: true,
resolvedAt: true,
resolvedInVersion: true,
resolvedBy: true,
ignoredUntil: true,
ignoredReason: true,
ignoredByUserId: true,
ignoredUntilOccurrenceRate: true,
ignoredUntilTotalOccurrences: true,
},
});

return row;
}

private async getRunList(
organizationId: string,
environmentId: string,
options: {
userId?: string;
projectId: string;
fingerprint: string;
versions?: string[];
pageSize: number;
from?: number;
to?: number;
Expand All @@ -289,6 +362,7 @@ export class ErrorGroupPresenter extends BasePresenter {
projectId: options.projectId,
rootOnly: false,
errorId: ErrorId.toFriendlyId(options.fingerprint),
versions: options.versions,
pageSize: options.pageSize,
from: options.from,
to: options.to,
Expand Down
Loading
Loading