Skip to content

feat: expose function checkpoints (from/to) in Nango logs#5565

Open
TBonnin wants to merge 1 commit intomasterfrom
tbonnin/nan-4909/checkpoints-logs
Open

feat: expose function checkpoints (from/to) in Nango logs#5565
TBonnin wants to merge 1 commit intomasterfrom
tbonnin/nan-4909/checkpoints-logs

Conversation

@TBonnin
Copy link
Collaborator

@TBonnin TBonnin commented Mar 4, 2026

Runner is now returning from/to checkpoints which is exposed in the logs operation metadata to make it visible for customers for monitoring/debugging purpose

Screenshot 2026-03-04 at 14 54 07

from is the checkpoint value at the beginning of the execution (aka: last saved checkpoint of the previous execution)
to is the last saved checkpoints of this execution

Note: in a followup PR, the checkpoints info will be added to the sync webhook


It also propagates these checkpoint ranges through execution results into the jobs service, updating the jobs API contract and task payloads so handlers capture checkpoints on both success and error paths for end-to-end logging and metadata.

Possible Issues

• If getCheckpoint is never called, from may remain null and logs may show an incomplete range; confirm that is acceptable for monitoring expectations.


This summary was automatically generated by @propel-code-bot

@TBonnin TBonnin requested a review from a team March 4, 2026 20:19
@linear
Copy link

linear bot commented Mar 4, 2026

telemetryBag: { customLogs: 0, proxyCalls: 0, durationMs: 0, memoryGb: 0 },
functionRuntime: 'lambda'
functionRuntime: 'lambda',
checkpoints: null
Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Unfortunately we are losing the checkpoints when the lambda OOM or times out. (same as telemetryBag).
Not a deal breaker imho for now but annoying nonetheless

Copy link
Contributor

Choose a reason for hiding this comment

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

If this is something we want to fix we could keep an execution log of some sort that we could interrogate at this point. Example, when a checkpoint is stored we could record something using the AWS request id (or task id). If not a deal breaker right now maybe not pursuing in the short term, but if it becomes an issue, we have options.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

yes, logs/proxy/checkpoints are all touching the backend so we could keep track of them instead of relying on the runner to report them. Much more complicated though

propel-code-bot[bot]

This comment was marked as outdated.

Runner is now returning from/to checkpoints which is exposed in the logs
operation metadata
`from` is the checkpoint value at the beginning of the execution (aka:
first call to getCheckpoint)
`to` is the last saved checkepoints
@TBonnin TBonnin force-pushed the tbonnin/nan-4909/checkpoints-logs branch from d2454f9 to 85d0b9a Compare March 4, 2026 20:33
Copy link
Contributor

@propel-code-bot propel-code-bot bot left a comment

Choose a reason for hiding this comment

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

Review found no issues; changes appear well implemented.

Status: No Issues Found | Risk: Low

Review Details

📁 16 files reviewed | 💬 0 comments

Instruction Files
├── .claude/
│   ├── agents/
│   │   └── nango-docs-migrator.md
│   └── skills/
│       ├── agent-builder-skill/
│       │   ├── EXAMPLES.md
│       │   └── SKILL.md
│       ├── creating-integration-docs/
│       │   └── SKILL.md
│       └── creating-skills-skill/
│           └── SKILL.md
├── AGENTS.md
└── GEMINI.md

@TBonnin TBonnin added this pull request to the merge queue Mar 5, 2026
@github-merge-queue github-merge-queue bot removed this pull request from the merge queue due to failed status checks Mar 5, 2026
@TBonnin TBonnin added this pull request to the merge queue Mar 5, 2026
@github-merge-queue github-merge-queue bot removed this pull request from the merge queue due to failed status checks Mar 5, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants