docs: add sentry neon functions guide by dhanushreddy291 · Pull Request #5465 · neondatabase/website

dhanushreddy291 · 2026-08-06T15:59:06Z

https://neon-next-git-fork-dhanushreddy291-add-docs-730336-neondatabase.vercel.app/guides/sentry-neon-functions

vercel · 2026-08-06T15:59:10Z

@dhanushreddy291 is attempting to deploy a commit to the neondatabase Team on Vercel.

A member of the Team first needs to authorize it.

dhanushreddy291 · 2026-08-06T16:37:58Z

+
+</Steps>
+
+<Admonition type="note" title="Source map support">


@danieltprice you may want to update or remove this note as needed.

vercel · 2026-08-07T08:50:32Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
neon-next	Ready	Preview	Aug 13, 2026 2:51pm

Copilot

Pull request overview

Adds a new Neon Functions guide that walks readers through instrumenting a Neon Function with Sentry (errors, structured logs, and tracing), including an optional section for tracing a streaming AI agent via the Neon AI Gateway. It also updates a few existing Neon Functions guides with refreshed updatedOn metadata and a skills-installation note.

Changes:

Add content/guides/sentry-neon-functions.md (end-to-end Sentry instrumentation guide for Neon Functions, plus AI Gateway/agent tracing).
Update three existing Neon Functions guides to add an agent-skills install snippet and bump updatedOn.

Reviewed changes

Copilot reviewed 4 out of 9 changed files in this pull request and generated 3 comments.

File	Description
content/guides/sentry-neon-functions.md	New guide covering Sentry setup for Neon Functions (errors/logs/traces) and AI agent tracing via AI Gateway.
content/guides/llm-proxy-neon-functions.md	Adds an agent-skills install note and updates `updatedOn`.
content/guides/durable-workflow-on-neon-functions.md	Adds an agent-skills install note and updates `updatedOn`.
content/guides/discord-bot-on-neon-functions.md	Adds an agent-skills install note and updates `updatedOn`.

Suppressed comments (1)

content/guides/sentry-neon-functions.md:66

For consistency with the other Neon Functions guides, prefer the neondatabase/agent-skills repo shorthand here and include the neon-ai-gateway skill since the guide later uses the AI Gateway.

npx skills add https://github.com/neondatabase/agent-skills --skill neon-functions

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

dhanushreddy291 · 2026-08-07T15:10:30Z

+✔ Manage this project's Neon setup as code? Adds a neon.ts you can edit and apply with `neon config apply`. … yes
+✔ Which Neon services should neon.ts declare? (space to toggle, enter to confirm) › Functions
+INFO: Created neon.ts declaring functions.
+INFO: Created hello.ts — the source of the hello function.


dhanushreddy291 · 2026-08-07T15:10:41Z

+
+Use the default setup options for all prompts: this includes enabling AI skills, configuring the MCP server, and installing the VS Code extension. These steps ensure AI agents such as Claude Code and Cursor can assist you in building with Neon.
+
+During initialization, the **Neon Postgres** skills are installed automatically. You'll also need the **Neon Functions** skills so AI agents have the context to help you build and deploy your function. Install it with the following command:


Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

andrelandgraf · 2026-08-07T09:45:50Z

+During initialization, the **Neon Postgres** skills are installed automatically. You'll also need the **Neon Functions** and **Neon AI Gateway** skills so AI agents have the context to help you build and deploy your Discord bot. Install them with the following command:
+
+```bash
+npx skills add neondatabase/agent-skills --skill neon-ai-gateway --skill neon-functions


Hey @dhanushreddy291 - always install neon and neon-postgres skills and then per used service the gateway, functions, and/or object-storage skills as well.

neon -> core skill

neon-postgres -> postgres skill

@andrelandgraf neon init is already adding them so didn't add it in steps again.

Its mentioned here: "the Neon Postgres skills are installed automatically."

Ah perfect!

andrelandgraf · 2026-08-07T09:48:32Z

+import * as Sentry from "@sentry/node";
+
+Sentry.init({
+  dsn: process.env.SENTRY_DSN,


You can probably manage those env vars in neon.ts as well!

Check out the env property on a function + maybe look into parseEnv from @neon/env!

import { parseEnv } from "@neon/env"; import { config } from "./neon"; const env = parseEnv(config, "func-name");

sergical

two minor comments, otherwise LGTM, thanks for doing this <3

sergical · 2026-08-07T15:11:56Z

+      }),
+    },
+    stopWhen: isStepCount(5),
+    experimental_telemetry: { isEnabled: true },


I think both v6 and for sure v7 of AI SDK use telemetry as it's no longer experimental

sure @sergical checking it.
I was following the sentry.md file here: https://github.com/neondatabase/agent-skills/blob/main/skills/neon-functions/references/sentry.md

have verified using telemetry, it works the same. updated the guide.

sergical · 2026-08-07T15:39:24Z

+  enableLogs: true,
+  tracesSampleRate: Number(process.env.SENTRY_TRACES_SAMPLE_RATE ?? 1),
+  traceLifecycle: "stream", // [!code ++]
+  streamGenAiSpans: true, // [!code ++]


this is a default in 10.61.0, without knowing which versions get installed, it's hard to say but i believe we can remove this

sure @sergical checking it.
I was following the sentry.md file here: https://github.com/neondatabase/agent-skills/blob/main/skills/neon-functions/references/sentry.md

thanks for pointing out, will update all the placements in the future, this will work as is

have verified by removing streamGenAiSpans and using telemetry, it works the same.

Co-authored-by: Isaac

dhanushreddy291 added 3 commits August 6, 2026 05:08

docs: add sentry neon functions guide

90e3fd8

docs: add images

f6ff52e

docs: minor edit

e49013d

dhanushreddy291 requested review from andrelandgraf, danieltprice, philip and ruf-io as code owners August 6, 2026 15:59

docs: add source map note

28b9f87

dhanushreddy291 commented Aug 6, 2026

View reviewed changes

danieltprice requested a lite review from Copilot August 7, 2026 08:50

Copilot started reviewing on behalf of danieltprice August 7, 2026 08:51 View session

Copilot AI reviewed Aug 7, 2026

View reviewed changes

vercel Bot deployed to Preview – neon-next August 7, 2026 08:54 View deployment

Potential fix for pull request finding

eac737e

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

andrelandgraf reviewed Aug 7, 2026

View reviewed changes

Merge branch 'main' into add-docs/sentry-neon-functions

7bf6eba

dhanushreddy291 marked this pull request as draft August 7, 2026 12:34

docs: use parse env

37bc161

dhanushreddy291 marked this pull request as ready for review August 7, 2026 15:10

sergical reviewed Aug 7, 2026

View reviewed changes

dhanushreddy291 marked this pull request as draft August 7, 2026 16:14

docs: minor updates

2d9dbbd

dhanushreddy291 marked this pull request as ready for review August 7, 2026 16:59

vercel Bot deployed to Preview – neon-next August 13, 2026 14:22 View deployment

danieltprice approved these changes Aug 13, 2026

View reviewed changes

docs: humanize and style pass on Sentry Neon Functions guide

74ec871

Co-authored-by: Isaac

vercel Bot deployed to Preview – neon-next August 13, 2026 14:51 View deployment

danieltprice merged commit 0082975 into neondatabase:main Aug 13, 2026
2 checks passed


		Use the default setup options for all prompts: this includes enabling AI skills, configuring the MCP server, and installing the VS Code extension. These steps ensure AI agents such as Claude Code and Cursor can assist you in building with Neon.

		During initialization, the Neon Postgres skills are installed automatically. You'll also need the Neon Functions skills so AI agents have the context to help you build and deploy your function. Install it with the following command:

Uh oh!

Conversation

dhanushreddy291 commented Aug 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

vercel Bot commented Aug 6, 2026

Uh oh!

dhanushreddy291 Aug 6, 2026 • 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!

vercel Bot commented Aug 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

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!

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!

sergical left a comment

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!

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!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

dhanushreddy291 commented Aug 6, 2026 •

edited

Loading

dhanushreddy291 Aug 6, 2026 •

edited

Loading

vercel Bot commented Aug 7, 2026 •

edited

Loading