[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M79F0FVE3E3ZRAYAA41BFDS5":3,"skill-same:01M79F0FVE3E3ZRAYAA41BFDS5":175},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":148,"commitSha":149,"skillDirectory":150,"forksCount":14,"repositoryHtmlUrl":151,"repositoryHomepageUrl":6,"ownerHtmlUrl":152,"ownerBlogUrl":6,"ownerDescription":153,"updatedAt":154,"install":155,"resources":168},"01M79F0FVE3E3ZRAYAA41BFDS5","observability",null,"Vercel Observability expert guidance — Drains (logs, traces, speed insights, web analytics), Web Analytics, Speed Insights, runtime logs, custom events, OpenTelemetry integration, and monitoring dashboards. Use when instrumenting, debugging, or optimizing application performance and user experience on Vercel.","zfifteen\u002Fskills-catalog","zfifteen","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F221906715?v=4","01M79CQFXDZM5J5CJTCECPFA66","Dionisio Alberto Lopez III","01M79CQFY4C62PN8A2T5KDAHGA",1,"MIT","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fobservability\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: observability\ndescription: Vercel Observability expert guidance — Drains (logs, traces, speed insights, web analytics), Web Analytics, Speed Insights, runtime logs, custom events, OpenTelemetry integration, and monitoring dashboards. Use when instrumenting, debugging, or optimizing application performance and user experience on Vercel.\nmetadata:\n  priority: 6\n  docs:\n    - \"https:\u002F\u002Fvercel.com\u002Fdocs\u002Fobservability\"\n    - \"https:\u002F\u002Fvercel.com\u002Fdocs\u002Fobservability\u002Fotel-overview\"\n  sitemap: \"https:\u002F\u002Fvercel.com\u002Fsitemap\u002Fdocs.xml\"\n  pathPatterns:\n    - 'instrumentation.ts'\n    - 'instrumentation.js'\n    - 'src\u002Finstrumentation.ts'\n    - 'src\u002Finstrumentation.js'\n    - 'app\u002Flayout.*'\n    - 'src\u002Fapp\u002Flayout.*'\n    - 'pages\u002F_app.*'\n    - 'src\u002Fpages\u002F_app.*'\n    - 'apps\u002F*\u002Finstrumentation.ts'\n    - 'apps\u002F*\u002Finstrumentation.js'\n    - 'apps\u002F*\u002Fapp\u002Flayout.*'\n    - 'apps\u002F*\u002Fsrc\u002Fapp\u002Flayout.*'\n    - 'apps\u002F*\u002Fpages\u002F_app.*'\n    - 'apps\u002F*\u002Fsrc\u002Fpages\u002F_app.*'\n    - 'sentry.client.config.*'\n    - 'sentry.server.config.*'\n    - 'sentry.edge.config.*'\n  bashPatterns:\n    - '\\bvercel\\s+logs?\\b'\n    - '\\bvercel\\s+logs?\\s+.*--follow\\b'\n    - '\\bvercel\\s+logs?\\s+.*--level\\b'\n    - '\\bvercel\\s+logs?\\s+.*--since\\b'\n    - '\\bcurl\\s+.*deployments.*events\\b'\n    - '\\bnpm\\s+(install|i|add)\\s+[^\\n]*@vercel\u002Fanalytics\\b'\n    - '\\bpnpm\\s+(install|i|add)\\s+[^\\n]*@vercel\u002Fanalytics\\b'\n    - '\\bbun\\s+(install|i|add)\\s+[^\\n]*@vercel\u002Fanalytics\\b'\n    - '\\byarn\\s+add\\s+[^\\n]*@vercel\u002Fanalytics\\b'\n    - '\\bnpm\\s+(install|i|add)\\s+[^\\n]*@vercel\u002Fspeed-insights\\b'\n    - '\\bpnpm\\s+(install|i|add)\\s+[^\\n]*@vercel\u002Fspeed-insights\\b'\n    - '\\bbun\\s+(install|i|add)\\s+[^\\n]*@vercel\u002Fspeed-insights\\b'\n    - '\\byarn\\s+add\\s+[^\\n]*@vercel\u002Fspeed-insights\\b'\n    - '\\bnpm\\s+(install|i|add)\\s+[^\\n]*@sentry\u002Fnextjs\\b'\n    - '\\bpnpm\\s+(install|i|add)\\s+[^\\n]*@sentry\u002Fnextjs\\b'\n    - '\\bbun\\s+(install|i|add)\\s+[^\\n]*@sentry\u002Fnextjs\\b'\n    - '\\byarn\\s+add\\s+[^\\n]*@sentry\u002Fnextjs\\b'\n    - '\\bnpm\\s+(install|i|add)\\s+[^\\n]*@sentry\u002Fnode\\b'\n    - '\\bpnpm\\s+(install|i|add)\\s+[^\\n]*@sentry\u002Fnode\\b'\n    - '\\bbun\\s+(install|i|add)\\s+[^\\n]*@sentry\u002Fnode\\b'\n    - '\\byarn\\s+add\\s+[^\\n]*@sentry\u002Fnode\\b'\n    - '\\bnpm\\s+(install|i|add)\\s+[^\\n]*@datadog\u002Fbrowser-rum\\b'\n    - '\\bpnpm\\s+(install|i|add)\\s+[^\\n]*@datadog\u002Fbrowser-rum\\b'\n    - '\\bbun\\s+(install|i|add)\\s+[^\\n]*@datadog\u002Fbrowser-rum\\b'\n    - '\\byarn\\s+add\\s+[^\\n]*@datadog\u002Fbrowser-rum\\b'\n    - '\\bnpm\\s+(install|i|add)\\s+[^\\n]*\\bcheckly\\b'\n    - '\\bpnpm\\s+(install|i|add)\\s+[^\\n]*\\bcheckly\\b'\n    - '\\bbun\\s+(install|i|add)\\s+[^\\n]*\\bcheckly\\b'\n    - '\\byarn\\s+add\\s+[^\\n]*\\bcheckly\\b'\n    - '\\bnpm\\s+(install|i|add)\\s+[^\\n]*\\bnewrelic\\b'\n    - '\\bpnpm\\s+(install|i|add)\\s+[^\\n]*\\bnewrelic\\b'\n    - '\\bbun\\s+(install|i|add)\\s+[^\\n]*\\bnewrelic\\b'\n    - '\\byarn\\s+add\\s+[^\\n]*\\bnewrelic\\b'\n  promptSignals:\n    phrases:\n      - \"add logging\"\n      - \"add logs\"\n      - \"set up logging\"\n      - \"setup logging\"\n      - \"configure logging\"\n      - \"structured logging\"\n      - \"log drain\"\n      - \"log drains\"\n      - \"vercel analytics\"\n      - \"speed insights\"\n      - \"web analytics\"\n      - \"opentelemetry\"\n      - \"otel\"\n      - \"instrumentation\"\n      - \"monitoring\"\n      - \"set up monitoring\"\n      - \"add observability\"\n      - \"track errors\"\n      - \"error tracking\"\n      - \"sentry\"\n      - \"datadog\"\n      - \"check the logs\"\n      - \"show me the error\"\n      - \"what went wrong\"\n      - \"where did it fail\"\n      - \"show me the logs\"\n      - \"find the error\"\n      - \"why did it fail\"\n      - \"debug the error\"\n    allOf:\n      - [add, logging]\n      - [add, monitoring]\n      - [set up, logs]\n      - [configure, analytics]\n      - [vercel, logs]\n      - [vercel, analytics]\n      - [track, performance]\n      - [track, errors]\n    anyOf:\n      - \"logging\"\n      - \"monitoring\"\n      - \"analytics\"\n      - \"observability\"\n      - \"telemetry\"\n      - \"traces\"\n      - \"metrics\"\n      - \"debug\"\n      - \"debugging\"\n      - \"stuck\"\n      - \"hanging\"\n      - \"hung\"\n      - \"waiting\"\n      - \"stalled\"\n      - \"spinning\"\n      - \"timeout\"\n      - \"slow\"\n      - \"pending\"\n      - \"unresponsive\"\n    minScore: 6\n---\n\n# Vercel Observability\n\nYou are an expert in Vercel's observability stack — runtime logs, structured logging, Drains, Web Analytics, Speed Insights, and monitoring integrations. **Always start with logging.** When something is stuck, slow, or broken, the first step is always to check or add logs.\n\n## Structured Logging Baseline\n\nAdd this to every API route and server action as a minimum. If the user reports something stuck, hanging, or slow, verify this baseline exists first:\n\n```ts\nconst start = Date.now();\nconsole.log(JSON.stringify({ level: \"info\", msg: \"start\", route: \"\u002Fapi\u002Fexample\", requestId: req.headers.get(\"x-vercel-id\") }));\n\u002F\u002F ... your logic ...\nconsole.log(JSON.stringify({ level: \"info\", msg: \"done\", route: \"\u002Fapi\u002Fexample\", ms: Date.now() - start }));\n\u002F\u002F On error:\nconsole.error(JSON.stringify({ level: \"error\", msg: \"failed\", route: \"\u002Fapi\u002Fexample\", error: err.message, ms: Date.now() - start }));\n```\n\n## Runtime Logs\n\nVercel provides real-time logs for all function invocations.\n\n### Structured Logging\n\n```ts\n\u002F\u002F app\u002Fapi\u002Fprocess\u002Froute.ts\nexport async function POST(req: Request) {\n  const start = Date.now()\n  const data = await req.json()\n\n  \u002F\u002F Structured logs appear in Vercel's log viewer\n  console.log(JSON.stringify({\n    level: 'info',\n    message: 'Processing request',\n    requestId: req.headers.get('x-vercel-id'),\n    payload_size: JSON.stringify(data).length,\n  }))\n\n  try {\n    const result = await processData(data)\n    console.log(JSON.stringify({\n      level: 'info',\n      message: 'Request completed',\n      duration_ms: Date.now() - start,\n    }))\n    return Response.json(result)\n  } catch (error) {\n    console.error(JSON.stringify({\n      level: 'error',\n      message: 'Processing failed',\n      error: error instanceof Error ? error.message : String(error),\n      duration_ms: Date.now() - start,\n    }))\n    return Response.json({ error: 'Internal error' }, { status: 500 })\n  }\n}\n```\n\n### Next.js Instrumentation\n\n```ts\n\u002F\u002F instrumentation.ts (Next.js 16)\nexport async function register() {\n  if (process.env.NEXT_RUNTIME === 'nodejs') {\n    \u002F\u002F Initialize monitoring on server startup\n    const { initMonitoring } = await import('.\u002Flib\u002Fmonitoring')\n    initMonitoring()\n  }\n}\n```\n\n### Runtime Logs via REST API\n\nQuery deployment runtime logs programmatically. The endpoint returns `application\u002Fstream+json` — a streaming response where each line is a separate JSON object.\n\n```bash\n# Stream runtime logs for a deployment (returns application\u002Fstream+json)\ncurl -N -H \"Authorization: Bearer $VERCEL_TOKEN\" \\\n  \"https:\u002F\u002Fapi.vercel.com\u002Fv3\u002Fdeployments\u002F\u003Cdeployment-id>\u002Fevents\" \\\n  --max-time 120\n```\n\n> **Streaming guidance:** The response is unbounded — always set a timeout (`--max-time` in curl, `AbortController` with `setTimeout` in fetch). Parse line-by-line as NDJSON. Each line contains `{ timestamp, text, level, source }`.\n\n```ts\n\u002F\u002F Programmatic streaming with timeout\nconst controller = new AbortController()\nconst timeout = setTimeout(() => controller.abort(), 60_000) \u002F\u002F 60s max\n\nconst res = await fetch(\n  `https:\u002F\u002Fapi.vercel.com\u002Fv3\u002Fdeployments\u002F${deploymentId}\u002Fevents`,\n  {\n    headers: { Authorization: `Bearer ${process.env.VERCEL_TOKEN}` },\n    signal: controller.signal,\n  }\n)\n\nconst reader = res.body!.getReader()\nconst decoder = new TextDecoder()\nlet buffer = ''\n\ntry {\n  while (true) {\n    const { done, value } = await reader.read()\n    if (done) break\n    buffer += decoder.decode(value, { stream: true })\n    const lines = buffer.split('\\n')\n    buffer = lines.pop()! \u002F\u002F keep incomplete line in buffer\n    for (const line of lines) {\n      if (!line.trim()) continue\n      const event = JSON.parse(line)\n      console.log(`[${event.level}] ${event.text}`)\n    }\n  }\n} finally {\n  clearTimeout(timeout)\n}\n```\n\n> **MCP alternative:** Use `get_runtime_logs` via the Vercel MCP server for agent-friendly log queries without managing streams directly. See `⤳ skill: vercel-api`.\n\n## Web Analytics\n\nPrivacy-friendly, first-party analytics with no cookie banners required.\n\n### Installation\n\n```bash\nnpm install @vercel\u002Fanalytics\n```\n\n### Setup (Next.js App Router)\n\n```tsx\n\u002F\u002F app\u002Flayout.tsx\nimport { Analytics } from '@vercel\u002Fanalytics\u002Fnext'\n\nexport default function RootLayout({ children }: { children: React.ReactNode }) {\n  return (\n    \u003Chtml>\n      \u003Cbody>\n        {children}\n        \u003CAnalytics \u002F>\n      \u003C\u002Fbody>\n    \u003C\u002Fhtml>\n  )\n}\n```\n\n### Custom Events (Pro\u002FEnterprise)\n\nTrack business-specific events beyond pageviews.\n\n```ts\nimport { track } from '@vercel\u002Fanalytics'\n\n\u002F\u002F Track a conversion\ntrack('purchase', {\n  product: 'pro-plan',\n  value: 20,\n  currency: 'USD',\n})\n\n\u002F\u002F Track a feature usage\ntrack('feature_used', {\n  name: 'ai-chat',\n  duration_ms: 3200,\n})\n```\n\n### Server-Side Tracking\n\n```ts\nimport { track } from '@vercel\u002Fanalytics\u002Fserver'\n\nexport async function POST(req: Request) {\n  const data = await req.json()\n  await processOrder(data)\n\n  track('order_completed', {\n    order_id: data.id,\n    total: data.total,\n  })\n\n  return Response.json({ success: true })\n}\n```\n\n## Speed Insights\n\nReal-user performance monitoring built on Core Web Vitals.\n\n### Installation\n\n```bash\nnpm install @vercel\u002Fspeed-insights\n```\n\n### Setup (Next.js App Router)\n\n```tsx\n\u002F\u002F app\u002Flayout.tsx\nimport { SpeedInsights } from '@vercel\u002Fspeed-insights\u002Fnext'\n\nexport default function RootLayout({ children }: { children: React.ReactNode }) {\n  return (\n    \u003Chtml>\n      \u003Cbody>\n        {children}\n        \u003CSpeedInsights \u002F>\n      \u003C\u002Fbody>\n    \u003C\u002Fhtml>\n  )\n}\n```\n\n### Metrics Tracked\n\n| Metric | What It Measures | Good Threshold |\n|--------|-----------------|----------------|\n| LCP | Largest Contentful Paint | \u003C 2.5s |\n| INP | Interaction to Next Paint | \u003C 200ms |\n| CLS | Cumulative Layout Shift | \u003C 0.1 |\n| FCP | First Contentful Paint | \u003C 1.8s |\n| TTFB | Time to First Byte | \u003C 800ms |\n\n### Performance Attribution\n\nSpeed Insights attributes metrics to specific routes and pages, letting you identify which pages are slow and why.\n\n## Drains\n\nDrains forward observability data from Vercel to external endpoints. They are the primary mechanism for exporting logs, traces, Speed Insights, and Web Analytics data to third-party platforms.\n\n> **Plan requirement:** Drains require a **Pro or Enterprise** plan. For Hobby plans, see the [Fallback Guidance](#fallback-guidance-no-drains) section below.\n\n### Data Types\n\nDrains can forward multiple categories of telemetry:\n\n| Data Type | What It Contains | Use Case |\n|-----------|-----------------|----------|\n| **Logs** | Runtime function logs, build logs, static access logs | Centralized log aggregation |\n| **Traces** | OpenTelemetry-compatible distributed traces | End-to-end request tracing |\n| **Speed Insights** | Core Web Vitals and performance metrics | Performance monitoring pipelines |\n| **Web Analytics** | Pageviews, custom events, visitor data | Analytics data warehousing |\n\n### Supported Formats\n\n| Format | Protocol | Best For |\n|--------|----------|----------|\n| JSON | HTTPS POST | Custom backends, generic log collectors |\n| NDJSON | HTTPS POST | Streaming-friendly consumers, high-volume pipelines |\n| Syslog | TLS syslog | Traditional log management (rsyslog, syslog-ng) |\n\n### Setting Up Drains\n\nDrains are configured via the **Vercel Dashboard** at `https:\u002F\u002Fvercel.com\u002Fdashboard\u002F{team}\u002F~\u002Fsettings\u002Flog-drains` or the **REST API**.\n\n#### Via Dashboard\n\n1. Open `https:\u002F\u002Fvercel.com\u002Fdashboard\u002F{team}\u002F~\u002Fsettings\u002Flog-drains` (replace `{team}` with your team slug)\n2. Click **Add Log Drain**\n3. Select the drain type (JSON, NDJSON, or syslog) and enter the endpoint URL\n4. Choose which environments and sources to include\n5. Click **Create** to activate the drain\n\n#### Via REST API (`\u002Fv1\u002Fdrains`)\n\n```bash\n# List all drains\ncurl -s -H \"Authorization: Bearer $VERCEL_TOKEN\" \\\n  \"https:\u002F\u002Fapi.vercel.com\u002Fv1\u002Fdrains?teamId=$TEAM_ID\" | jq\n\n# Create a JSON drain\ncurl -X POST -H \"Authorization: Bearer $VERCEL_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  \"https:\u002F\u002Fapi.vercel.com\u002Fv1\u002Fdrains?teamId=$TEAM_ID\" \\\n  -d '{\n    \"url\": \"https:\u002F\u002Fyour-endpoint.example.com\u002Flogs\",\n    \"type\": \"json\",\n    \"sources\": [\"lambda\", \"edge\", \"static\"],\n    \"environments\": [\"production\"]\n  }'\n\n# Test a drain (sends a test payload to your endpoint)\ncurl -X POST -H \"Authorization: Bearer $VERCEL_TOKEN\" \\\n  \"https:\u002F\u002Fapi.vercel.com\u002Fv1\u002Fdrains\u002F\u003Cdrain-id>\u002Ftest?teamId=$TEAM_ID\"\n\n# Update a drain (change URL, sources, or environments)\ncurl -X PATCH -H \"Authorization: Bearer $VERCEL_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  \"https:\u002F\u002Fapi.vercel.com\u002Fv1\u002Fdrains\u002F\u003Cdrain-id>?teamId=$TEAM_ID\" \\\n  -d '{\n    \"url\": \"https:\u002F\u002Fnew-endpoint.example.com\u002Flogs\",\n    \"environments\": [\"production\", \"preview\"]\n  }'\n\n# Delete a drain\ncurl -X DELETE -H \"Authorization: Bearer $VERCEL_TOKEN\" \\\n  \"https:\u002F\u002Fapi.vercel.com\u002Fv1\u002Fdrains\u002F\u003Cdrain-id>?teamId=$TEAM_ID\"\n```\n\n### Web Analytics Drains Reference\n\nWhen a drain is configured to receive Web Analytics data, payloads arrive as batched events. The format depends on your drain type.\n\n#### JSON Payload Schema\n\n```json\n[\n  {\n    \"type\": \"pageview\",\n    \"url\": \"https:\u002F\u002Fexample.com\u002Fblog\u002Fpost-1\",\n    \"referrer\": \"https:\u002F\u002Fgoogle.com\",\n    \"timestamp\": 1709568000000,\n    \"geo\": { \"country\": \"US\", \"region\": \"CA\", \"city\": \"San Francisco\" },\n    \"device\": { \"os\": \"macOS\", \"browser\": \"Chrome\", \"isBot\": false },\n    \"projectId\": \"prj_xxxxx\",\n    \"environment\": \"production\"\n  },\n  {\n    \"type\": \"custom_event\",\n    \"name\": \"purchase\",\n    \"url\": \"https:\u002F\u002Fexample.com\u002Fcheckout\",\n    \"properties\": { \"product\": \"pro-plan\", \"value\": 20 },\n    \"timestamp\": 1709568100000,\n    \"geo\": { \"country\": \"US\" },\n    \"device\": { \"os\": \"macOS\", \"browser\": \"Chrome\", \"isBot\": false },\n    \"projectId\": \"prj_xxxxx\",\n    \"environment\": \"production\"\n  }\n]\n```\n\n#### NDJSON Payload Format\n\nEach line is a separate JSON object (one event per line):\n\n```\n{\"type\":\"pageview\",\"url\":\"https:\u002F\u002Fexample.com\u002F\",\"timestamp\":1709568000000,\"geo\":{\"country\":\"US\"},\"device\":{\"browser\":\"Chrome\"},...}\n{\"type\":\"pageview\",\"url\":\"https:\u002F\u002Fexample.com\u002Fabout\",\"timestamp\":1709568001000,\"geo\":{\"country\":\"DE\"},\"device\":{\"browser\":\"Firefox\"},...}\n{\"type\":\"custom_event\",\"name\":\"signup\",\"url\":\"https:\u002F\u002Fexample.com\u002Fregister\",\"timestamp\":1709568002000,...}\n```\n\n> **Ingestion tip:** For NDJSON, process line-by-line as events arrive. This format is preferred for high-volume pipelines where batch parsing overhead matters.\n\n### Security: Signature Verification\n\nVercel signs every drain payload with an HMAC-SHA1 signature in the `x-vercel-signature` header. **Always verify signatures in production** to prevent spoofed data.\n\n> **Critical:** You must verify against the **raw request body** (not a parsed\u002Fre-serialized version). JSON parsing and re-stringifying can change key order or whitespace, breaking the signature match.\n\n```ts\nimport { createHmac, timingSafeEqual } from 'crypto'\n\nfunction verifyDrainSignature(rawBody: string, signature: string, secret: string): boolean {\n  const expected = createHmac('sha1', secret).update(rawBody).digest('hex')\n  \u002F\u002F Use timing-safe comparison to prevent timing attacks\n  if (expected.length !== signature.length) return false\n  return timingSafeEqual(Buffer.from(expected), Buffer.from(signature))\n}\n```\n\nUsage in a drain endpoint:\n\n```ts\n\u002F\u002F app\u002Fapi\u002Fdrain\u002Froute.ts\nexport async function POST(req: Request) {\n  const rawBody = await req.text()\n  const signature = req.headers.get('x-vercel-signature')\n  const secret = process.env.DRAIN_SECRET!\n\n  if (!signature || !verifyDrainSignature(rawBody, signature, secret)) {\n    return new Response('Unauthorized', { status: 401 })\n  }\n\n  const events = JSON.parse(rawBody)\n  \u002F\u002F Process verified events...\n  return new Response('OK', { status: 200 })\n}\n```\n\n> **Secret management:** The drain signing secret is shown once when you create the drain. Store it in an environment variable (e.g., `DRAIN_SECRET`). If lost, delete and recreate the drain.\n\n### OpenTelemetry Integration\n\nVercel exports traces in OpenTelemetry-compatible format via Drains. Configure an OTel-compatible drain endpoint at `https:\u002F\u002Fvercel.com\u002Fdashboard\u002F{team}\u002F~\u002Fsettings\u002Flog-drains` → **Add Log Drain** → select **OTLP** format, or via the REST API.\n\n### Vendor Integrations\n\n```bash\n# Install via Marketplace (recommended — auto-configures drain)\nvercel integration add datadog\n```\n\nOr manually create a drain at `https:\u002F\u002Fvercel.com\u002Fdashboard\u002F{team}\u002F~\u002Fsettings\u002Flog-drains` → **Add Log Drain**, or via REST API, pointing to:\n\n| Vendor | Endpoint | Auth Header |\n|--------|----------|-------------|\n| **Datadog** | `https:\u002F\u002Fhttp-intake.logs.datadoghq.com\u002Fapi\u002Fv2\u002Flogs` | `DD-API-KEY` |\n| **Honeycomb** | `https:\u002F\u002Fapi.honeycomb.io\u002F1\u002Fbatch\u002F\u003Cdataset>` | `X-Honeycomb-Team` |\n\n### Fallback Guidance (No Drains)\n\nIf drains are unavailable (Hobby plan or not yet configured), use these alternatives:\n\n| Need | Alternative | How |\n|------|-------------|-----|\n| View runtime logs | **Vercel Dashboard** | `https:\u002F\u002Fvercel.com\u002F{team}\u002F{project}\u002Fdeployments` → select deployment → Logs tab |\n| Stream logs from terminal | **Vercel CLI** | `vercel logs \u003Cdeployment-url> --follow` (see `⤳ skill: vercel-cli`) |\n| Query logs programmatically | **MCP \u002F REST API** | `get_runtime_logs` tool or `\u002Fv3\u002Fdeployments\u002F:id\u002Fevents` (see `⤳ skill: vercel-api`) |\n| Monitor errors post-deploy | **CLI** | `vercel logs \u003Curl> --level error --since 1h` |\n| Web Analytics data | **Dashboard only** | `https:\u002F\u002Fvercel.com\u002F{team}\u002F{project}\u002Fanalytics` |\n| Performance metrics | **Dashboard only** | `https:\u002F\u002Fvercel.com\u002F{team}\u002F{project}\u002Fspeed-insights` |\n\n> **Upgrade path:** When ready for centralized observability, upgrade to Pro and configure drains at `https:\u002F\u002Fvercel.com\u002Fdashboard\u002F{team}\u002F~\u002Fsettings\u002Flog-drains` or via REST API. The drain setup is typically \u003C 5 minutes.\n\n### Deploy Preflight Observability\n\nBefore promoting to production, verify observability readiness:\n\n- **Drains check**: Query configured drains via MCP `list_drains` or REST API. If no drains are configured on a Pro\u002FEnterprise plan, warn:\n  > ⚠️ No drains configured. Production errors won't be forwarded to external monitoring.\n  > Configure drains via Dashboard or REST API before promoting. See `⤳ skill: observability`.\n- **Errored drains**: If any drain is in error state, warn and suggest remediation before deploying:\n  > ⚠️ Drain \"\u003Curl>\" is errored. Fix or recreate before production deploy to avoid monitoring gaps.\n- **Error monitoring**: Check that at least one of these is in place: configured drains, an error tracking integration (e.g., Sentry, Datadog via `vercel integration ls`), or `@vercel\u002Fanalytics` in the project.\n- These are warnings, not blockers — the user may proceed after acknowledgment.\n\n### Post-Deploy Error Scan\n\nFor production deployments, wait 60 seconds after READY state, then scan for early runtime errors:\n\n```bash\nvercel logs \u003Cdeployment-url> --level error --since 1h\n```\n\nOr via MCP if available: use `get_runtime_logs` with level filter `error`.\n\n**Interpret results:**\n\n| Finding | Action |\n|---------|--------|\n| No errors | ✓ Clean deploy — no runtime errors in first hour |\n| Errors detected | List error count and first 5 unique error messages. Suggest: check drain payloads for correlated traces, review function logs in Dashboard |\n| 500 status codes in logs | Correlate timestamps with drain data (if configured) or `vercel logs \u003Curl> --json` for structured output. Flag for immediate investigation |\n| Timeout errors | Check function duration limits in `vercel.json` or project settings. Consider increasing `maxDuration` |\n\n**Fallback (no drains):**\n\nIf no drains are configured, the error scan relies on CLI and Dashboard:\n\n```bash\n# Stream live errors\nvercel logs \u003Cdeployment-url> --level error --follow\n\n# JSON output for parsing\nvercel logs \u003Cdeployment-url> --level error --since 1h --json\n```\n\n> For richer post-deploy monitoring, configure drains to forward logs\u002Ftraces to an external platform. See `⤳ skill: observability`.\n\n### Performance Audit Checklist\n\nRun through this when asked to optimize a Vercel application:\n\n1. **Measure first**: Check Speed Insights dashboard for real-user CWV data\n2. **Identify LCP element**: Use Chrome DevTools → Performance → identify the LCP element\n3. **Audit `'use client'`**: Every `'use client'` file ships JS to the browser — minimize\n4. **Check images**: All above-fold images use `next\u002Fimage` with `priority`\n5. **Check fonts**: All fonts loaded via `next\u002Ffont` (zero CLS)\n6. **Check third-party scripts**: All use `next\u002Fscript` with correct strategy\n7. **Check data fetching**: Server Components fetch in parallel, no waterfalls\n8. **Check caching**: Cache Components used for expensive operations\n9. **Check bundle**: Run analyzer, look for low-hanging fruit\n10. **Check infrastructure**: Functions in correct region, Fluid Compute enabled\n\n## Monitoring Dashboard Patterns\n\n### Full-Stack Observability Setup\n\nCombine all Vercel observability tools for comprehensive coverage.\n\n```tsx\n\u002F\u002F app\u002Flayout.tsx — complete observability setup\nimport { Analytics } from '@vercel\u002Fanalytics\u002Fnext'\nimport { SpeedInsights } from '@vercel\u002Fspeed-insights\u002Fnext'\n\nexport default function RootLayout({ children }: { children: React.ReactNode }) {\n  return (\n    \u003Chtml>\n      \u003Cbody>\n        {children}\n        \u003CAnalytics \u002F>\n        \u003CSpeedInsights \u002F>\n      \u003C\u002Fbody>\n    \u003C\u002Fhtml>\n  )\n}\n```\n\n### Custom Monitoring with `waitUntil`\n\nFire-and-forget telemetry that doesn't block responses.\n\n```ts\nimport { waitUntil } from '@vercel\u002Ffunctions'\n\nexport async function GET(req: Request) {\n  const start = Date.now()\n  const result = await fetchData()\n\n  \u002F\u002F Send response immediately\n  const response = Response.json(result)\n\n  \u002F\u002F Report metrics in background\n  waitUntil(async () => {\n    await reportMetric('api_latency', Date.now() - start, {\n      route: '\u002Fapi\u002Fdata',\n      status: 200,\n    })\n  })\n\n  return response\n}\n```\n\n### Error Tracking Pattern\n\n```ts\n\u002F\u002F lib\u002Ferror-reporting.ts\nexport async function reportError(error: unknown, context: Record\u003Cstring, unknown>) {\n  const payload = {\n    message: error instanceof Error ? error.message : String(error),\n    stack: error instanceof Error ? error.stack : undefined,\n    timestamp: new Date().toISOString(),\n    ...context,\n  }\n\n  \u002F\u002F Log for Vercel's runtime logs\n  console.error(JSON.stringify(payload))\n\n  \u002F\u002F Also send to external service if configured\n  if (process.env.ERROR_WEBHOOK_URL) {\n    await fetch(process.env.ERROR_WEBHOOK_URL, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application\u002Fjson' },\n      body: JSON.stringify(payload),\n    })\n  }\n}\n```\n\n## Marketplace Observability Integrations\n\n### Sentry — Error & Performance Monitoring\n\nNative Vercel Marketplace integration. Auto-configures source maps and release tracking.\n\n```bash\nnpx @sentry\u002Fwizard@latest -i nextjs\n# Or install manually:\nnpm install @sentry\u002Fnextjs\n```\n\nSentry wizard creates `sentry.client.config.ts`, `sentry.server.config.ts`, and `sentry.edge.config.ts`. It also wraps `next.config.js` with `withSentryConfig`.\n\nInstall via Marketplace: `vercel integration add sentry`\n\n### Datadog — Full-Stack Monitoring\n\nAPM, logs, and Real User Monitoring (RUM). Auto-configures log drain on Marketplace install.\n\n```bash\nnpm install @datadog\u002Fbrowser-rum\n```\n\n```ts\nimport { datadogRum } from '@datadog\u002Fbrowser-rum'\n\ndatadogRum.init({\n  applicationId: process.env.NEXT_PUBLIC_DD_APPLICATION_ID!,\n  clientToken: process.env.NEXT_PUBLIC_DD_CLIENT_TOKEN!,\n  site: 'datadoghq.com',\n  service: 'my-app',\n  sessionSampleRate: 100,\n  trackResources: true,\n  trackLongTasks: true,\n})\n```\n\nInstall via Marketplace: `vercel integration add datadog`\n\n### Checkly — Synthetic Monitoring & Testing\n\nAPI and browser checks that run continuously against your deployments.\n\n```bash\nnpm install -D checkly\nnpx checkly init\n```\n\nCheckly integrates with Vercel deployment events to trigger checks on every deploy.\n\nInstall via Marketplace: `vercel integration add checkly`\n\n### New Relic — Application Performance Monitoring\n\nFull-stack observability with distributed tracing and alerting.\n\n```bash\nnpm install newrelic\n```\n\nRequires a `newrelic.js` config file at the project root. Install via Marketplace: `vercel integration add newrelic`\n\n## Decision Matrix\n\n| Need | Use | Why |\n|------|-----|-----|\n| Page views, traffic sources | Web Analytics | First-party, privacy-friendly |\n| Business event tracking | Web Analytics custom events | Track conversions, feature usage |\n| Core Web Vitals monitoring | Speed Insights | Real user data per route |\n| Function debugging | Runtime Logs (CLI `vercel logs` \u002F Dashboard (`https:\u002F\u002Fvercel.com\u002F{team}\u002F{project}\u002Flogs`) \u002F REST) | Real-time, per-invocation logs |\n| Export logs to external platform | Drains (JSON\u002FNDJSON\u002FSyslog) | Centralize observability (Pro+) |\n| Export analytics data | Drains (Web Analytics type) | Warehouse pageviews + custom events (Pro+) |\n| OpenTelemetry traces | Drains (OTel-compatible endpoint) | Standards-based distributed tracing (Pro+) |\n| Post-response telemetry | `waitUntil` + custom reporting | Non-blocking metrics |\n| Server-side event tracking | `@vercel\u002Fanalytics\u002Fserver` | Track API-triggered events |\n| Hobby plan log access | CLI `vercel logs` + Dashboard (`https:\u002F\u002Fvercel.com\u002F{team}\u002F{project}\u002Flogs`) | No drains needed |\n\n## Cross-References\n\n- **Drains REST API & runtime logs endpoint** → `⤳ skill: vercel-api` (Observability APIs section)\n- **CLI log streaming (`--follow`, `--since`, `--level`)** → `⤳ skill: vercel-cli` (Logs & Inspection section)\n- **Marketplace vendor integrations** → `⤳ skill: marketplace`\n\n## Official Documentation\n\n- [Vercel Analytics](https:\u002F\u002Fvercel.com\u002Fdocs\u002Fanalytics)\n- [Speed Insights](https:\u002F\u002Fvercel.com\u002Fdocs\u002Fspeed-insights)\n- [Runtime Logs](https:\u002F\u002Fvercel.com\u002Fdocs\u002Flogs\u002Fruntime)\n- [Drains Overview](https:\u002F\u002Fvercel.com\u002Fdocs\u002Fdrains)\n- [Drains REST API](https:\u002F\u002Fvercel.com\u002Fdocs\u002Frest-api\u002Freference\u002Fendpoints\u002Fdrains\u002Fretrieve-a-list-of-all-drains)\n- [Drains Security](https:\u002F\u002Fvercel.com\u002Fdocs\u002Fdrains\u002Fsecurity)\n- [Web Analytics Drains Reference](https:\u002F\u002Fvercel.com\u002Fdocs\u002Fdrains\u002Freference\u002Fanalytics)\n- [Monitoring](https:\u002F\u002Fvercel.com\u002Fdocs\u002Fquery\u002Fmonitoring)\n- [@vercel\u002Fanalytics npm](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@vercel\u002Fanalytics)\n- [@vercel\u002Fspeed-insights npm](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@vercel\u002Fspeed-insights)\n","# Vercel Observability\n\nYou are an expert in Vercel's observability stack — runtime logs, structured logging, Drains, Web Analytics, Speed Insights, and monitoring integrations. **Always start with logging.** When something is stuck, slow, or broken, the first step is always to check or add logs.\n\n## Structured Logging Baseline\n\nAdd this to every API route and server action as a minimum. If the user reports something stuck, hanging, or slow, verify this baseline exists first:\n\n```ts\nconst start = Date.now();\nconsole.log(JSON.stringify({ level: \"info\", msg: \"start\", route: \"\u002Fapi\u002Fexample\", requestId: req.headers.get(\"x-vercel-id\") }));\n\u002F\u002F ... your logic ...\nconsole.log(JSON.stringify({ level: \"info\", msg: \"done\", route: \"\u002Fapi\u002Fexample\", ms: Date.now() - start }));\n\u002F\u002F On error:\nconsole.error(JSON.stringify({ level: \"error\", msg: \"failed\", route: \"\u002Fapi\u002Fexample\", error: err.message, ms: Date.now() - start }));\n```\n\n## Runtime Logs\n\nVercel provides real-time logs for all function invocations.\n\n### Structured Logging\n\n```ts\n\u002F\u002F app\u002Fapi\u002Fprocess\u002Froute.ts\nexport async function POST(req: Request) {\n  const start = Date.now()\n  const data = await req.json()\n\n  \u002F\u002F Structured logs appear in Vercel's log viewer\n  console.log(JSON.stringify({\n    level: 'info',\n    message: 'Processing request',\n    requestId: req.headers.get('x-vercel-id'),\n    payload_size: JSON.stringify(data).length,\n  }))\n\n  try {\n    const result = await processData(data)\n    console.log(JSON.stringify({\n      level: 'info',\n      message: 'Request completed',\n      duration_ms: Date.now() - start,\n    }))\n    return Response.json(result)\n  } catch (error) {\n    console.error(JSON.stringify({\n      level: 'error',\n      message: 'Processing failed',\n      error: error instanceof Error ? error.message : String(error),\n      duration_ms: Date.now() - start,\n    }))\n    return Response.json({ error: 'Internal error' }, { status: 500 })\n  }\n}\n```\n\n### Next.js Instrumentation\n\n```ts\n\u002F\u002F instrumentation.ts (Next.js 16)\nexport async function register() {\n  if (process.env.NEXT_RUNTIME === 'nodejs') {\n    \u002F\u002F Initialize monitoring on server startup\n    const { initMonitoring } = await import('.\u002Flib\u002Fmonitoring')\n    initMonitoring()\n  }\n}\n```\n\n### Runtime Logs via REST API\n\nQuery deployment runtime logs programmatically. The endpoint returns `application\u002Fstream+json` — a streaming response where each line is a separate JSON object.\n\n```bash\n# Stream runtime logs for a deployment (returns application\u002Fstream+json)\ncurl -N -H \"Authorization: Bearer $VERCEL_TOKEN\" \\\n  \"https:\u002F\u002Fapi.vercel.com\u002Fv3\u002Fdeployments\u002F\u003Cdeployment-id>\u002Fevents\" \\\n  --max-time 120\n```\n\n> **Streaming guidance:** The response is unbounded — always set a timeout (`--max-time` in curl, `AbortController` with `setTimeout` in fetch). Parse line-by-line as NDJSON. Each line contains `{ timestamp, text, level, source }`.\n\n```ts\n\u002F\u002F Programmatic streaming with timeout\nconst controller = new AbortController()\nconst timeout = setTimeout(() => controller.abort(), 60_000) \u002F\u002F 60s max\n\nconst res = await fetch(\n  `https:\u002F\u002Fapi.vercel.com\u002Fv3\u002Fdeployments\u002F${deploymentId}\u002Fevents`,\n  {\n    headers: { Authorization: `Bearer ${process.env.VERCEL_TOKEN}` },\n    signal: controller.signal,\n  }\n)\n\nconst reader = res.body!.getReader()\nconst decoder = new TextDecoder()\nlet buffer = ''\n\ntry {\n  while (true) {\n    const { done, value } = await reader.read()\n    if (done) break\n    buffer += decoder.decode(value, { stream: true })\n    const lines = buffer.split('\\n')\n    buffer = lines.pop()! \u002F\u002F keep incomplete line in buffer\n    for (const line of lines) {\n      if (!line.trim()) continue\n      const event = JSON.parse(line)\n      console.log(`[${event.level}] ${event.text}`)\n    }\n  }\n} finally {\n  clearTimeout(timeout)\n}\n```\n\n> **MCP alternative:** Use `get_runtime_logs` via the Vercel MCP server for agent-friendly log queries without managing streams directly. See `⤳ skill: vercel-api`.\n\n## Web Analytics\n\nPrivacy-friendly, first-party analytics with no cookie banners required.\n\n### Installation\n\n```bash\nnpm install @vercel\u002Fanalytics\n```\n\n### Setup (Next.js App Router)\n\n```tsx\n\u002F\u002F app\u002Flayout.tsx\nimport { Analytics } from '@vercel\u002Fanalytics\u002Fnext'\n\nexport default function RootLayout({ children }: { children: React.ReactNode }) {\n  return (\n    \u003Chtml>\n      \u003Cbody>\n        {children}\n        \u003CAnalytics \u002F>\n      \u003C\u002Fbody>\n    \u003C\u002Fhtml>\n  )\n}\n```\n\n### Custom Events (Pro\u002FEnterprise)\n\nTrack business-specific events beyond pageviews.\n\n```ts\nimport { track } from '@vercel\u002Fanalytics'\n\n\u002F\u002F Track a conversion\ntrack('purchase', {\n  product: 'pro-plan',\n  value: 20,\n  currency: 'USD',\n})\n\n\u002F\u002F Track a feature usage\ntrack('feature_used', {\n  name: 'ai-chat',\n  duration_ms: 3200,\n})\n```\n\n### Server-Side Tracking\n\n```ts\nimport { track } from '@vercel\u002Fanalytics\u002Fserver'\n\nexport async function POST(req: Request) {\n  const data = await req.json()\n  await processOrder(data)\n\n  track('order_completed', {\n    order_id: data.id,\n    total: data.total,\n  })\n\n  return Response.json({ success: true })\n}\n```\n\n## Speed Insights\n\nReal-user performance monitoring built on Core Web Vitals.\n\n### Installation\n\n```bash\nnpm install @vercel\u002Fspeed-insights\n```\n\n### Setup (Next.js App Router)\n\n```tsx\n\u002F\u002F app\u002Flayout.tsx\nimport { SpeedInsights } from '@vercel\u002Fspeed-insights\u002Fnext'\n\nexport default function RootLayout({ children }: { children: React.ReactNode }) {\n  return (\n    \u003Chtml>\n      \u003Cbody>\n        {children}\n        \u003CSpeedInsights \u002F>\n      \u003C\u002Fbody>\n    \u003C\u002Fhtml>\n  )\n}\n```\n\n### Metrics Tracked\n\n| Metric | What It Measures | Good Threshold |\n|--------|-----------------|----------------|\n| LCP | Largest Contentful Paint | \u003C 2.5s |\n| INP | Interaction to Next Paint | \u003C 200ms |\n| CLS | Cumulative Layout Shift | \u003C 0.1 |\n| FCP | First Contentful Paint | \u003C 1.8s |\n| TTFB | Time to First Byte | \u003C 800ms |\n\n### Performance Attribution\n\nSpeed Insights attributes metrics to specific routes and pages, letting you identify which pages are slow and why.\n\n## Drains\n\nDrains forward observability data from Vercel to external endpoints. They are the primary mechanism for exporting logs, traces, Speed Insights, and Web Analytics data to third-party platforms.\n\n> **Plan requirement:** Drains require a **Pro or Enterprise** plan. For Hobby plans, see the [Fallback Guidance](#fallback-guidance-no-drains) section below.\n\n### Data Types\n\nDrains can forward multiple categories of telemetry:\n\n| Data Type | What It Contains | Use Case |\n|-----------|-----------------|----------|\n| **Logs** | Runtime function logs, build logs, static access logs | Centralized log aggregation |\n| **Traces** | OpenTelemetry-compatible distributed traces | End-to-end request tracing |\n| **Speed Insights** | Core Web Vitals and performance metrics | Performance monitoring pipelines |\n| **Web Analytics** | Pageviews, custom events, visitor data | Analytics data warehousing |\n\n### Supported Formats\n\n| Format | Protocol | Best For |\n|--------|----------|----------|\n| JSON | HTTPS POST | Custom backends, generic log collectors |\n| NDJSON | HTTPS POST | Streaming-friendly consumers, high-volume pipelines |\n| Syslog | TLS syslog | Traditional log management (rsyslog, syslog-ng) |\n\n### Setting Up Drains\n\nDrains are configured via the **Vercel Dashboard** at `https:\u002F\u002Fvercel.com\u002Fdashboard\u002F{team}\u002F~\u002Fsettings\u002Flog-drains` or the **REST API**.\n\n#### Via Dashboard\n\n1. Open `https:\u002F\u002Fvercel.com\u002Fdashboard\u002F{team}\u002F~\u002Fsettings\u002Flog-drains` (replace `{team}` with your team slug)\n2. Click **Add Log Drain**\n3. Select the drain type (JSON, NDJSON, or syslog) and enter the endpoint URL\n4. Choose which environments and sources to include\n5. Click **Create** to activate the drain\n\n#### Via REST API (`\u002Fv1\u002Fdrains`)\n\n```bash\n# List all drains\ncurl -s -H \"Authorization: Bearer $VERCEL_TOKEN\" \\\n  \"https:\u002F\u002Fapi.vercel.com\u002Fv1\u002Fdrains?teamId=$TEAM_ID\" | jq\n\n# Create a JSON drain\ncurl -X POST -H \"Authorization: Bearer $VERCEL_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  \"https:\u002F\u002Fapi.vercel.com\u002Fv1\u002Fdrains?teamId=$TEAM_ID\" \\\n  -d '{\n    \"url\": \"https:\u002F\u002Fyour-endpoint.example.com\u002Flogs\",\n    \"type\": \"json\",\n    \"sources\": [\"lambda\", \"edge\", \"static\"],\n    \"environments\": [\"production\"]\n  }'\n\n# Test a drain (sends a test payload to your endpoint)\ncurl -X POST -H \"Authorization: Bearer $VERCEL_TOKEN\" \\\n  \"https:\u002F\u002Fapi.vercel.com\u002Fv1\u002Fdrains\u002F\u003Cdrain-id>\u002Ftest?teamId=$TEAM_ID\"\n\n# Update a drain (change URL, sources, or environments)\ncurl -X PATCH -H \"Authorization: Bearer $VERCEL_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  \"https:\u002F\u002Fapi.vercel.com\u002Fv1\u002Fdrains\u002F\u003Cdrain-id>?teamId=$TEAM_ID\" \\\n  -d '{\n    \"url\": \"https:\u002F\u002Fnew-endpoint.example.com\u002Flogs\",\n    \"environments\": [\"production\", \"preview\"]\n  }'\n\n# Delete a drain\ncurl -X DELETE -H \"Authorization: Bearer $VERCEL_TOKEN\" \\\n  \"https:\u002F\u002Fapi.vercel.com\u002Fv1\u002Fdrains\u002F\u003Cdrain-id>?teamId=$TEAM_ID\"\n```\n\n### Web Analytics Drains Reference\n\nWhen a drain is configured to receive Web Analytics data, payloads arrive as batched events. The format depends on your drain type.\n\n#### JSON Payload Schema\n\n```json\n[\n  {\n    \"type\": \"pageview\",\n    \"url\": \"https:\u002F\u002Fexample.com\u002Fblog\u002Fpost-1\",\n    \"referrer\": \"https:\u002F\u002Fgoogle.com\",\n    \"timestamp\": 1709568000000,\n    \"geo\": { \"country\": \"US\", \"region\": \"CA\", \"city\": \"San Francisco\" },\n    \"device\": { \"os\": \"macOS\", \"browser\": \"Chrome\", \"isBot\": false },\n    \"projectId\": \"prj_xxxxx\",\n    \"environment\": \"production\"\n  },\n  {\n    \"type\": \"custom_event\",\n    \"name\": \"purchase\",\n    \"url\": \"https:\u002F\u002Fexample.com\u002Fcheckout\",\n    \"properties\": { \"product\": \"pro-plan\", \"value\": 20 },\n    \"timestamp\": 1709568100000,\n    \"geo\": { \"country\": \"US\" },\n    \"device\": { \"os\": \"macOS\", \"browser\": \"Chrome\", \"isBot\": false },\n    \"projectId\": \"prj_xxxxx\",\n    \"environment\": \"production\"\n  }\n]\n```\n\n#### NDJSON Payload Format\n\nEach line is a separate JSON object (one event per line):\n\n```\n{\"type\":\"pageview\",\"url\":\"https:\u002F\u002Fexample.com\u002F\",\"timestamp\":1709568000000,\"geo\":{\"country\":\"US\"},\"device\":{\"browser\":\"Chrome\"},...}\n{\"type\":\"pageview\",\"url\":\"https:\u002F\u002Fexample.com\u002Fabout\",\"timestamp\":1709568001000,\"geo\":{\"country\":\"DE\"},\"device\":{\"browser\":\"Firefox\"},...}\n{\"type\":\"custom_event\",\"name\":\"signup\",\"url\":\"https:\u002F\u002Fexample.com\u002Fregister\",\"timestamp\":1709568002000,...}\n```\n\n> **Ingestion tip:** For NDJSON, process line-by-line as events arrive. This format is preferred for high-volume pipelines where batch parsing overhead matters.\n\n### Security: Signature Verification\n\nVercel signs every drain payload with an HMAC-SHA1 signature in the `x-vercel-signature` header. **Always verify signatures in production** to prevent spoofed data.\n\n> **Critical:** You must verify against the **raw request body** (not a parsed\u002Fre-serialized version). JSON parsing and re-stringifying can change key order or whitespace, breaking the signature match.\n\n```ts\nimport { createHmac, timingSafeEqual } from 'crypto'\n\nfunction verifyDrainSignature(rawBody: string, signature: string, secret: string): boolean {\n  const expected = createHmac('sha1', secret).update(rawBody).digest('hex')\n  \u002F\u002F Use timing-safe comparison to prevent timing attacks\n  if (expected.length !== signature.length) return false\n  return timingSafeEqual(Buffer.from(expected), Buffer.from(signature))\n}\n```\n\nUsage in a drain endpoint:\n\n```ts\n\u002F\u002F app\u002Fapi\u002Fdrain\u002Froute.ts\nexport async function POST(req: Request) {\n  const rawBody = await req.text()\n  const signature = req.headers.get('x-vercel-signature')\n  const secret = process.env.DRAIN_SECRET!\n\n  if (!signature || !verifyDrainSignature(rawBody, signature, secret)) {\n    return new Response('Unauthorized', { status: 401 })\n  }\n\n  const events = JSON.parse(rawBody)\n  \u002F\u002F Process verified events...\n  return new Response('OK', { status: 200 })\n}\n```\n\n> **Secret management:** The drain signing secret is shown once when you create the drain. Store it in an environment variable (e.g., `DRAIN_SECRET`). If lost, delete and recreate the drain.\n\n### OpenTelemetry Integration\n\nVercel exports traces in OpenTelemetry-compatible format via Drains. Configure an OTel-compatible drain endpoint at `https:\u002F\u002Fvercel.com\u002Fdashboard\u002F{team}\u002F~\u002Fsettings\u002Flog-drains` → **Add Log Drain** → select **OTLP** format, or via the REST API.\n\n### Vendor Integrations\n\n```bash\n# Install via Marketplace (recommended — auto-configures drain)\nvercel integration add datadog\n```\n\nOr manually create a drain at `https:\u002F\u002Fvercel.com\u002Fdashboard\u002F{team}\u002F~\u002Fsettings\u002Flog-drains` → **Add Log Drain**, or via REST API, pointing to:\n\n| Vendor | Endpoint | Auth Header |\n|--------|----------|-------------|\n| **Datadog** | `https:\u002F\u002Fhttp-intake.logs.datadoghq.com\u002Fapi\u002Fv2\u002Flogs` | `DD-API-KEY` |\n| **Honeycomb** | `https:\u002F\u002Fapi.honeycomb.io\u002F1\u002Fbatch\u002F\u003Cdataset>` | `X-Honeycomb-Team` |\n\n### Fallback Guidance (No Drains)\n\nIf drains are unavailable (Hobby plan or not yet configured), use these alternatives:\n\n| Need | Alternative | How |\n|------|-------------|-----|\n| View runtime logs | **Vercel Dashboard** | `https:\u002F\u002Fvercel.com\u002F{team}\u002F{project}\u002Fdeployments` → select deployment → Logs tab |\n| Stream logs from terminal | **Vercel CLI** | `vercel logs \u003Cdeployment-url> --follow` (see `⤳ skill: vercel-cli`) |\n| Query logs programmatically | **MCP \u002F REST API** | `get_runtime_logs` tool or `\u002Fv3\u002Fdeployments\u002F:id\u002Fevents` (see `⤳ skill: vercel-api`) |\n| Monitor errors post-deploy | **CLI** | `vercel logs \u003Curl> --level error --since 1h` |\n| Web Analytics data | **Dashboard only** | `https:\u002F\u002Fvercel.com\u002F{team}\u002F{project}\u002Fanalytics` |\n| Performance metrics | **Dashboard only** | `https:\u002F\u002Fvercel.com\u002F{team}\u002F{project}\u002Fspeed-insights` |\n\n> **Upgrade path:** When ready for centralized observability, upgrade to Pro and configure drains at `https:\u002F\u002Fvercel.com\u002Fdashboard\u002F{team}\u002F~\u002Fsettings\u002Flog-drains` or via REST API. The drain setup is typically \u003C 5 minutes.\n\n### Deploy Preflight Observability\n\nBefore promoting to production, verify observability readiness:\n\n- **Drains check**: Query configured drains via MCP `list_drains` or REST API. If no drains are configured on a Pro\u002FEnterprise plan, warn:\n  > ⚠️ No drains configured. Production errors won't be forwarded to external monitoring.\n  > Configure drains via Dashboard or REST API before promoting. See `⤳ skill: observability`.\n- **Errored drains**: If any drain is in error state, warn and suggest remediation before deploying:\n  > ⚠️ Drain \"\u003Curl>\" is errored. Fix or recreate before production deploy to avoid monitoring gaps.\n- **Error monitoring**: Check that at least one of these is in place: configured drains, an error tracking integration (e.g., Sentry, Datadog via `vercel integration ls`), or `@vercel\u002Fanalytics` in the project.\n- These are warnings, not blockers — the user may proceed after acknowledgment.\n\n### Post-Deploy Error Scan\n\nFor production deployments, wait 60 seconds after READY state, then scan for early runtime errors:\n\n```bash\nvercel logs \u003Cdeployment-url> --level error --since 1h\n```\n\nOr via MCP if available: use `get_runtime_logs` with level filter `error`.\n\n**Interpret results:**\n\n| Finding | Action |\n|---------|--------|\n| No errors | ✓ Clean deploy — no runtime errors in first hour |\n| Errors detected | List error count and first 5 unique error messages. Suggest: check drain payloads for correlated traces, review function logs in Dashboard |\n| 500 status codes in logs | Correlate timestamps with drain data (if configured) or `vercel logs \u003Curl> --json` for structured output. Flag for immediate investigation |\n| Timeout errors | Check function duration limits in `vercel.json` or project settings. Consider increasing `maxDuration` |\n\n**Fallback (no drains):**\n\nIf no drains are configured, the error scan relies on CLI and Dashboard:\n\n```bash\n# Stream live errors\nvercel logs \u003Cdeployment-url> --level error --follow\n\n# JSON output for parsing\nvercel logs \u003Cdeployment-url> --level error --since 1h --json\n```\n\n> For richer post-deploy monitoring, configure drains to forward logs\u002Ftraces to an external platform. See `⤳ skill: observability`.\n\n### Performance Audit Checklist\n\nRun through this when asked to optimize a Vercel application:\n\n1. **Measure first**: Check Speed Insights dashboard for real-user CWV data\n2. **Identify LCP element**: Use Chrome DevTools → Performance → identify the LCP element\n3. **Audit `'use client'`**: Every `'use client'` file ships JS to the browser — minimize\n4. **Check images**: All above-fold images use `next\u002Fimage` with `priority`\n5. **Check fonts**: All fonts loaded via `next\u002Ffont` (zero CLS)\n6. **Check third-party scripts**: All use `next\u002Fscript` with correct strategy\n7. **Check data fetching**: Server Components fetch in parallel, no waterfalls\n8. **Check caching**: Cache Components used for expensive operations\n9. **Check bundle**: Run analyzer, look for low-hanging fruit\n10. **Check infrastructure**: Functions in correct region, Fluid Compute enabled\n\n## Monitoring Dashboard Patterns\n\n### Full-Stack Observability Setup\n\nCombine all Vercel observability tools for comprehensive coverage.\n\n```tsx\n\u002F\u002F app\u002Flayout.tsx — complete observability setup\nimport { Analytics } from '@vercel\u002Fanalytics\u002Fnext'\nimport { SpeedInsights } from '@vercel\u002Fspeed-insights\u002Fnext'\n\nexport default function RootLayout({ children }: { children: React.ReactNode }) {\n  return (\n    \u003Chtml>\n      \u003Cbody>\n        {children}\n        \u003CAnalytics \u002F>\n        \u003CSpeedInsights \u002F>\n      \u003C\u002Fbody>\n    \u003C\u002Fhtml>\n  )\n}\n```\n\n### Custom Monitoring with `waitUntil`\n\nFire-and-forget telemetry that doesn't block responses.\n\n```ts\nimport { waitUntil } from '@vercel\u002Ffunctions'\n\nexport async function GET(req: Request) {\n  const start = Date.now()\n  const result = await fetchData()\n\n  \u002F\u002F Send response immediately\n  const response = Response.json(result)\n\n  \u002F\u002F Report metrics in background\n  waitUntil(async () => {\n    await reportMetric('api_latency', Date.now() - start, {\n      route: '\u002Fapi\u002Fdata',\n      status: 200,\n    })\n  })\n\n  return response\n}\n```\n\n### Error Tracking Pattern\n\n```ts\n\u002F\u002F lib\u002Ferror-reporting.ts\nexport async function reportError(error: unknown, context: Record\u003Cstring, unknown>) {\n  const payload = {\n    message: error instanceof Error ? error.message : String(error),\n    stack: error instanceof Error ? error.stack : undefined,\n    timestamp: new Date().toISOString(),\n    ...context,\n  }\n\n  \u002F\u002F Log for Vercel's runtime logs\n  console.error(JSON.stringify(payload))\n\n  \u002F\u002F Also send to external service if configured\n  if (process.env.ERROR_WEBHOOK_URL) {\n    await fetch(process.env.ERROR_WEBHOOK_URL, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application\u002Fjson' },\n      body: JSON.stringify(payload),\n    })\n  }\n}\n```\n\n## Marketplace Observability Integrations\n\n### Sentry — Error & Performance Monitoring\n\nNative Vercel Marketplace integration. Auto-configures source maps and release tracking.\n\n```bash\nnpx @sentry\u002Fwizard@latest -i nextjs\n# Or install manually:\nnpm install @sentry\u002Fnextjs\n```\n\nSentry wizard creates `sentry.client.config.ts`, `sentry.server.config.ts`, and `sentry.edge.config.ts`. It also wraps `next.config.js` with `withSentryConfig`.\n\nInstall via Marketplace: `vercel integration add sentry`\n\n### Datadog — Full-Stack Monitoring\n\nAPM, logs, and Real User Monitoring (RUM). Auto-configures log drain on Marketplace install.\n\n```bash\nnpm install @datadog\u002Fbrowser-rum\n```\n\n```ts\nimport { datadogRum } from '@datadog\u002Fbrowser-rum'\n\ndatadogRum.init({\n  applicationId: process.env.NEXT_PUBLIC_DD_APPLICATION_ID!,\n  clientToken: process.env.NEXT_PUBLIC_DD_CLIENT_TOKEN!,\n  site: 'datadoghq.com',\n  service: 'my-app',\n  sessionSampleRate: 100,\n  trackResources: true,\n  trackLongTasks: true,\n})\n```\n\nInstall via Marketplace: `vercel integration add datadog`\n\n### Checkly — Synthetic Monitoring & Testing\n\nAPI and browser checks that run continuously against your deployments.\n\n```bash\nnpm install -D checkly\nnpx checkly init\n```\n\nCheckly integrates with Vercel deployment events to trigger checks on every deploy.\n\nInstall via Marketplace: `vercel integration add checkly`\n\n### New Relic — Application Performance Monitoring\n\nFull-stack observability with distributed tracing and alerting.\n\n```bash\nnpm install newrelic\n```\n\nRequires a `newrelic.js` config file at the project root. Install via Marketplace: `vercel integration add newrelic`\n\n## Decision Matrix\n\n| Need | Use | Why |\n|------|-----|-----|\n| Page views, traffic sources | Web Analytics | First-party, privacy-friendly |\n| Business event tracking | Web Analytics custom events | Track conversions, feature usage |\n| Core Web Vitals monitoring | Speed Insights | Real user data per route |\n| Function debugging | Runtime Logs (CLI `vercel logs` \u002F Dashboard (`https:\u002F\u002Fvercel.com\u002F{team}\u002F{project}\u002Flogs`) \u002F REST) | Real-time, per-invocation logs |\n| Export logs to external platform | Drains (JSON\u002FNDJSON\u002FSyslog) | Centralize observability (Pro+) |\n| Export analytics data | Drains (Web Analytics type) | Warehouse pageviews + custom events (Pro+) |\n| OpenTelemetry traces | Drains (OTel-compatible endpoint) | Standards-based distributed tracing (Pro+) |\n| Post-response telemetry | `waitUntil` + custom reporting | Non-blocking metrics |\n| Server-side event tracking | `@vercel\u002Fanalytics\u002Fserver` | Track API-triggered events |\n| Hobby plan log access | CLI `vercel logs` + Dashboard (`https:\u002F\u002Fvercel.com\u002F{team}\u002F{project}\u002Flogs`) | No drains needed |\n\n## Cross-References\n\n- **Drains REST API & runtime logs endpoint** → `⤳ skill: vercel-api` (Observability APIs section)\n- **CLI log streaming (`--follow`, `--since`, `--level`)** → `⤳ skill: vercel-cli` (Logs & Inspection section)\n- **Marketplace vendor integrations** → `⤳ skill: marketplace`\n\n## Official Documentation\n\n- [Vercel Analytics](https:\u002F\u002Fvercel.com\u002Fdocs\u002Fanalytics)\n- [Speed Insights](https:\u002F\u002Fvercel.com\u002Fdocs\u002Fspeed-insights)\n- [Runtime Logs](https:\u002F\u002Fvercel.com\u002Fdocs\u002Flogs\u002Fruntime)\n- [Drains Overview](https:\u002F\u002Fvercel.com\u002Fdocs\u002Fdrains)\n- [Drains REST API](https:\u002F\u002Fvercel.com\u002Fdocs\u002Frest-api\u002Freference\u002Fendpoints\u002Fdrains\u002Fretrieve-a-list-of-all-drains)\n- [Drains Security](https:\u002F\u002Fvercel.com\u002Fdocs\u002Fdrains\u002Fsecurity)\n- [Web Analytics Drains Reference](https:\u002F\u002Fvercel.com\u002Fdocs\u002Fdrains\u002Freference\u002Fanalytics)\n- [Monitoring](https:\u002F\u002Fvercel.com\u002Fdocs\u002Fquery\u002Fmonitoring)\n- [@vercel\u002Fanalytics npm](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@vercel\u002Fanalytics)\n- [@vercel\u002Fspeed-insights npm](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@vercel\u002Fspeed-insights)\n",{"name":5,"metadata":24,"description":7},{"docs":25,"sitemap":28,"priority":29,"bashPatterns":30,"pathPatterns":64,"promptSignals":82},[26,27],"https:\u002F\u002Fvercel.com\u002Fdocs\u002Fobservability","https:\u002F\u002Fvercel.com\u002Fdocs\u002Fobservability\u002Fotel-overview","https:\u002F\u002Fvercel.com\u002Fsitemap\u002Fdocs.xml",6,[31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,52,53,54,55,56,57,58,59,60,61,62,63],"\\bvercel\\s+logs?\\b","\\bvercel\\s+logs?\\s+.*--follow\\b","\\bvercel\\s+logs?\\s+.*--level\\b","\\bvercel\\s+logs?\\s+.*--since\\b","\\bcurl\\s+.*deployments.*events\\b","\\bnpm\\s+(install|i|add)\\s+[^\\n]*@vercel\u002Fanalytics\\b","\\bpnpm\\s+(install|i|add)\\s+[^\\n]*@vercel\u002Fanalytics\\b","\\bbun\\s+(install|i|add)\\s+[^\\n]*@vercel\u002Fanalytics\\b","\\byarn\\s+add\\s+[^\\n]*@vercel\u002Fanalytics\\b","\\bnpm\\s+(install|i|add)\\s+[^\\n]*@vercel\u002Fspeed-insights\\b","\\bpnpm\\s+(install|i|add)\\s+[^\\n]*@vercel\u002Fspeed-insights\\b","\\bbun\\s+(install|i|add)\\s+[^\\n]*@vercel\u002Fspeed-insights\\b","\\byarn\\s+add\\s+[^\\n]*@vercel\u002Fspeed-insights\\b","\\bnpm\\s+(install|i|add)\\s+[^\\n]*@sentry\u002Fnextjs\\b","\\bpnpm\\s+(install|i|add)\\s+[^\\n]*@sentry\u002Fnextjs\\b","\\bbun\\s+(install|i|add)\\s+[^\\n]*@sentry\u002Fnextjs\\b","\\byarn\\s+add\\s+[^\\n]*@sentry\u002Fnextjs\\b","\\bnpm\\s+(install|i|add)\\s+[^\\n]*@sentry\u002Fnode\\b","\\bpnpm\\s+(install|i|add)\\s+[^\\n]*@sentry\u002Fnode\\b","\\bbun\\s+(install|i|add)\\s+[^\\n]*@sentry\u002Fnode\\b","\\byarn\\s+add\\s+[^\\n]*@sentry\u002Fnode\\b","\\bnpm\\s+(install|i|add)\\s+[^\\n]*@datadog\u002Fbrowser-rum\\b","\\bpnpm\\s+(install|i|add)\\s+[^\\n]*@datadog\u002Fbrowser-rum\\b","\\bbun\\s+(install|i|add)\\s+[^\\n]*@datadog\u002Fbrowser-rum\\b","\\byarn\\s+add\\s+[^\\n]*@datadog\u002Fbrowser-rum\\b","\\bnpm\\s+(install|i|add)\\s+[^\\n]*\\bcheckly\\b","\\bpnpm\\s+(install|i|add)\\s+[^\\n]*\\bcheckly\\b","\\bbun\\s+(install|i|add)\\s+[^\\n]*\\bcheckly\\b","\\byarn\\s+add\\s+[^\\n]*\\bcheckly\\b","\\bnpm\\s+(install|i|add)\\s+[^\\n]*\\bnewrelic\\b","\\bpnpm\\s+(install|i|add)\\s+[^\\n]*\\bnewrelic\\b","\\bbun\\s+(install|i|add)\\s+[^\\n]*\\bnewrelic\\b","\\byarn\\s+add\\s+[^\\n]*\\bnewrelic\\b",[65,66,67,68,69,70,71,72,73,74,75,76,77,78,79,80,81],"instrumentation.ts","instrumentation.js","src\u002Finstrumentation.ts","src\u002Finstrumentation.js","app\u002Flayout.*","src\u002Fapp\u002Flayout.*","pages\u002F_app.*","src\u002Fpages\u002F_app.*","apps\u002F*\u002Finstrumentation.ts","apps\u002F*\u002Finstrumentation.js","apps\u002F*\u002Fapp\u002Flayout.*","apps\u002F*\u002Fsrc\u002Fapp\u002Flayout.*","apps\u002F*\u002Fpages\u002F_app.*","apps\u002F*\u002Fsrc\u002Fpages\u002F_app.*","sentry.client.config.*","sentry.server.config.*","sentry.edge.config.*",{"allOf":83,"anyOf":103,"phrases":119,"minScore":29},[84,87,89,92,95,97,98,101],[85,86],"add","logging",[85,88],"monitoring",[90,91],"set up","logs",[93,94],"configure","analytics",[96,91],"vercel",[96,94],[99,100],"track","performance",[99,102],"errors",[86,88,94,5,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118],"telemetry","traces","metrics","debug","debugging","stuck","hanging","hung","waiting","stalled","spinning","timeout","slow","pending","unresponsive",[120,121,122,123,124,125,126,127,128,129,130,131,132,133,88,134,135,136,137,138,139,140,141,142,143,144,145,146,147],"add logging","add logs","set up logging","setup logging","configure logging","structured logging","log drain","log drains","vercel analytics","speed insights","web analytics","opentelemetry","otel","instrumentation","set up monitoring","add observability","track errors","error tracking","sentry","datadog","check the logs","show me the error","what went wrong","where did it fail","show me the logs","find the error","why did it fail","debug the error","main","d9535210da9af28aa76bca80de80355197e1b6d6","skills\u002Fobservability","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog","https:\u002F\u002Fgithub.com\u002Fzfifteen","I like to measure things.","2026-07-19 23:41:54",{"source":8,"skillName":5,"commands":156,"prompt":166,"zipAvailable":167},[157,160,163],{"tool":158,"command":159},"npx","npx skills add zfifteen\u002Fskills-catalog --skill observability",{"tool":161,"command":162},"bunx","bunx skills add zfifteen\u002Fskills-catalog --skill observability",{"tool":164,"command":165},"pnpm","pnpm dlx skills add zfifteen\u002Fskills-catalog --skill observability","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fobservability\u002FSKILL.md",true,[169],{"path":170,"resourceType":171,"resourceTypeDesc":172,"sizeBytes":173,"sourceHtmlUrl":174},"agents\u002Fopenai.yaml","REFERENCE","参考文档",179,"https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fobservability\u002Fagents\u002Fopenai.yaml",[176,183,190,197,206,213],{"skillNo":177,"name":178,"nameZh":6,"description":179,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":180,"categories":181,"keywords":182,"publishedAt":19},"01M79GXQ2PWPT2E4CJYHXVJ0YE","Zotero","Use Zotero Desktop from Codex to enable\u002Fprobe the local API, search a local Zotero library, list items\u002Fcollections\u002Ftags, export BibTeX, insert citation keys into LaTeX or Markdown drafts, read indexed full text when requested, and import BibTeX\u002FRIS records into Zotero through the connector server. Use when the user mentions Zotero, citations, references.bib, BibTeX export, local Zotero API, localhost:23119, or adding citations from a Zotero library.","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fzotero\u002FSKILL.md",[],[],{"skillNo":184,"name":185,"nameZh":6,"description":186,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":187,"categories":188,"keywords":189,"publishedAt":19},"01M79GXN85NETKBE06865CWK6Z","zoom-apps-sdk","Use when using Apps SDK.","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fzoom-apps-sdk\u002FSKILL.md",[],[],{"skillNo":191,"name":192,"nameZh":6,"description":193,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":194,"categories":195,"keywords":196,"publishedAt":19},"01M79GXCYD7FGYS932J9N9RFFY","youtube","Obtain accurate, timestamped YouTube video transcripts (preferring manual captions over auto-generated) as the primary deliverable, then derive summaries, key claims, or notes from that transcript.  Use when the user provides a YouTube URL (or video ID) and wants the transcript, a faithful summary, key claims with attribution, timestamped notes, or \"what does this video actually say\".  The skill is transcript-first: never substitute metadata, title, description, or search snippets for the spoken content.  Triggers: \"youtube transcript\", \"get the transcript of this video\", \"summarize this youtube video\", \"what did they say in https:\u002F\u002Fyoutube.com\u002F...\", \"key claims from this talk\".","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fyoutube\u002FSKILL.md",[],[],{"skillNo":198,"name":199,"nameZh":6,"description":200,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":201,"licenseFileUrl":202,"sourceHtmlUrl":203,"categories":204,"keywords":205,"publishedAt":19},"01M79GX8EXHHYM566BKR7MS778","yeet","Publish local changes to GitHub by confirming scope, committing intentionally, pushing the branch, and opening a draft PR through the GitHub app from this plugin, with `gh` used only as a fallback where connector coverage is insufficient.","Apache-2.0","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fyeet\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fyeet\u002FSKILL.md",[],[],{"skillNo":207,"name":208,"nameZh":6,"description":209,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":210,"categories":211,"keywords":212,"publishedAt":19},"01M79GX2HFJPX84NMRE5VBTYX9","x-post-creator","Create X-ready post threads and co-located story packages from the active conversation or referenced project material. Use when the user says turn this into an X-post, \u002Fx-post, make this into an X thread, or wants plain-language social posts with supporting images saved to docs\u002Fx-posts\u002F[story-name]\u002F.","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fx-post-creator\u002FSKILL.md",[],[],{"skillNo":214,"name":215,"nameZh":6,"description":216,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":217,"categories":218,"keywords":219,"publishedAt":19},"01M79GWXQT4HBT6QME6QSBZJFA","x-api","Search, read, and write X posts through the local X API MCP server (the same backend used by the Codex x-api skill). Use for searching X\u002Fx.com, reading threads and replies, creating lists, staging\u002Fpublishing posts for @alltheputs, finding high-visibility reply targets for research outreach, ingesting public context, or any request that mentions \u002Fx-api or \"search X\".","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fx-api\u002FSKILL.md",[],[]]