What

Bumps utopia-php/schedule to ^0.3.0 and uses the row it now hands the error handler, so a reconcile failure tags the project, resource and schedule it was building.

onError: function (\Throwable $error, ?Row $row = null): void {
    Span::init('schedule.functions.reconcile');
    if ($row?->data instanceof Document) {
        Span::add('project.id', (string) $row->data->getAttribute('projectId'));
        Span::add('resource.id', (string) $row->data->getAttribute('resourceId'));
        Span::add('schedule.id', $row->id);
    }
    Span::current()?->finish(error: $error);
},

Same in ScheduleFunctions, ScheduleExecutions and ScheduleMessages.

Why

These failures arrive in Sentry as a message and a region and nothing else — Collection not found, region = fra — for one of several thousand schedules. Identifying the row behind one of them meant writing a task to re-derive it from the database.

The attributes are the same ones the enqueue path in ScheduleFunctions already records on the success side:

Span::init('schedule.functions.enqueue');
Span::add('project.id', $schedule['project']->getId());
Span::add('function.id', $schedule['resource']->getId());
Span::add('schedule.id', $schedule['$id'] ?? '');

The error path simply never had the row to record them from. utopia-php/monorepo#296 (released as schedule/0.3.0) passes it through.

Dependency

^0.2.0 → ^0.3.0. Under caret semantics on 0.x a minor bump is a breaking boundary, so this constraint change is required — 0.3.0 is otherwise not installable. The library change itself is backward compatible: PHP ignores the extra argument, so a one-parameter handler still works.

Tests

None. There is no assertion to make here that would not be asserting the telemetry double against itself — the attributes either reach Sentry or they don't, and that is visible on the first failure after deploy. The three blocks are identical and the behaviour they add is guarded by a single instanceof.

composer lint passes. PHPStan is clean on the three changed files; a repo-wide run is currently blocked by parse errors in app/sdks/console-cli/internal/typegen/testdata/*.php, which are gitignored fixtures unrelated to this change.

Follow-up

appwrite-labs/cloud has a fourth handler, ScheduleBackups, which needs the same treatment once this is released.