Skip to content
cccskills
FreePublished on GitHub

monitoring

Use this implementation map when building or debugging a monitoring interface. It points to the UI, server logic, data schema, scheduled jobs, and actions behind uptime checks, public status pages, and grouped error triage.

OriginalShow the original description

Implementation map for the Monitoring tab (uptime checks, public status pages, error triage): component/server file locations, schema, jobs, and scheduler wiring. Use when building or debugging Monitoring UI, uptime checks, status pages, or error capture/grouping — not when just calling the monitoring actions from chat.

BuilderIO/agent-native7,525 stars(GitHub 7,525 + cccskills 0)
Works withSentry

Run score Not tested

See how to install

Good for

  • Tracing where uptime checks are scheduled
  • Finding the code behind a public status page
  • Debugging grouped browser or server errors
  • Connecting a session replay to its error issue

Files included (1)

  • SKILL.md4.6 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Monitoring Implementation Map

/monitoring is a thin shell (app/routes/monitoring._index.tsx → app/pages/monitoring/MonitoringPage.tsx) hosting two independently-owned panels selected by ?view=uptime|errors (defaults to uptime). navigation mirrors it as view="monitoring" with monitoringView (plus monitorId/errorIssueId when a row is open); each panel also writes richer selection to the monitoring application-state key.

Uptime

  • UI: app/pages/monitoring/UptimePanel.tsx, app/pages/monitoring/uptime/**.
  • Server: server/lib/uptime-monitors.ts (checks/alerting), sweep job server/jobs/uptime-monitors.ts, scheduler server/plugins/uptime-monitor-jobs.ts, schema server/db/schema-monitoring.ts.
  • Actions: list-monitors, get-monitor, save-monitor, run-monitor-check, delete-monitor.
  • Production serverless/Netlify-style runtimes skip the in-process interval scheduler and rely on the generated scheduled/background worker or external cron instead.
  • Deep links: list ?view=uptime, detail ?view=uptime&monitor=<id>, create ?view=uptime&monitor=new, edit ?view=uptime&monitor=<id>&edit=1.
  • See docs/uptime-monitoring.md.

Status Pages

  • UI: app/pages/monitoring/uptime/status-pages/**, a config sub-view under Uptime that bundles chosen monitors under a public /status/<slug> page.
  • Server: owner-scoped CRUD and the sanitized public projection live in server/lib/status-pages.ts over server/db/schema-monitoring.ts.
  • Actions: list-status-pages, get-status-page, save-status-page, delete-status-page, add-status-page-monitor, remove-status-page-monitor, reorder-status-page-monitors, plus the unauthenticated get-public-status-page.
  • Deep links: index ?view=uptime&statuspage=list, create ?view=uptime&statuspage=new, edit ?view=uptime&statuspage=<id>.

Errors

  • UI: app/pages/monitoring/ErrorsPanel.tsx, app/pages/monitoring/errors/** — first-party, Sentry-style exception triage grouped into issues by fingerprint.
  • Server: ingest/grouping in server/lib/error-capture.ts over server/db/schema-errors.ts.
  • Browser exceptions arrive through configureTracking() as $exception events; server captureError() failures arrive through the shared tracking provider when the server Analytics key is configured and use the same grouped issue store.
  • Actions: list-error-issues, get-error-issue, resolve-error-issue, capture-test-error, match-error-issues.
  • Browser capture uses the SDK from @agent-native/core/client (captureException / captureMessage / addErrorBreadcrumb), auto-enabled by configureTracking and transported through the first-party analytics ingest as a $exception event.
  • Test identities (QA/E2E accounts, isTestIdentity) keep their exceptions: occurrences are flagged testIdentity, never count toward users affected, and never alert. An issue only they have hit is testIdentityOnly and hidden from list-error-issues unless includeTestIdentities: true; the new-issue alert fires on its first real-user occurrence instead. Ingest decides from the identities an event carries (userId, email fields, its context), never from a sender's test_identity flag, which any write-key holder could set.
  • Deep link: ?view=errors&issue=<id>. Issue detail includes recent frequency, parsed/raw stack traces, source code snippets when available, breadcrumbs, tags, occurrence history, and session replay links.
  • Agent lookup: call list-error-issues first, then get-error-issue for stack, occurrence, and replay detail. These are separate from the external Sentry action and do not require a Sentry credential.
  • See docs/error-capture.md.

Session Replay ↔ Errors

A recording's devtools Console error lines link to the grouped issue at /monitoring?view=errors&issue=<id>, resolved by match-error-issues (exact fingerprint match, no heuristics); issues link back to the originating recording at /sessions/<recordingId>. The fingerprint includes the app, so match-error-issues takes the recording's app and only matches issues filed under it.

Related Skills

  • session-replay — replay storage, capture, and the Dev Tools panel this feature links to.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

a2a-assets

FreeSummary

Generate, refine, export, and place brand images or videos from an Assets library into another app. The skill covers choosing a library, handling image batches and video runs, and updating selected assets after feedback.

  • Generate brand images for slides or another app
  • Refine an existing asset after feedback
  • Create and export a video asset
BuilderIO/agent-native7.5KUpdated Oct 26, 2026

account-health

FreeSummary

Prepare a customer account health, renewal, or contract usage readout. Verify the account identity, use approved metric definitions, compare contracted capacity with actual usage, and trace findings to sources, time windows, and known gaps.

  • Preparing a named customer's account health review
  • Comparing contracted seats or capacity with usage
  • Gathering adoption signals before a renewal or QBR
BuilderIO/agent-native7.5KUpdated Oct 26, 2026

actions

FreeSummary

Create focused app actions that agents can call as tools and frontend code can use through client hooks. Use them to add provider integrations or fetch UI data, with validated inputs and structured results.

  • Adding a new app operation
  • Connecting an external provider API
  • Fetching data for a frontend view
BuilderIO/agent-native7.5KUpdated Oct 26, 2026

adding-a-feature

FreeSummary

Use this checklist when adding a feature or integration to an agent-native app. It covers the user interface, agent-callable actions, instructions, and app-state sync so both the user and agent can work with the capability consistently.

  • Planning a new feature across UI and agent actions
  • Checking that agent changes appear in the UI
  • Documenting actions and feature state for the agent
BuilderIO/agent-native7.5KUpdated Oct 26, 2026

adhoc-analysis

FreeSummary

Investigate complex questions by combining data from multiple sources, then summarize patterns, metrics, and evidence in a clear report. Save requested analyses as dashboards with instructions for future refreshes.

  • Comparing CRM deals with call records
  • Investigating customer health across systems
  • Saving a repeatable performance analysis
BuilderIO/agent-native7.5KUpdated Oct 26, 2026

admin-surfaces

FreeSummary

Use the Analytics admin surfaces to inspect and change workspace feature flags, review dashboard ownership and usage activity, or browse and edit databases connected from other agent-native apps. The skill guides administrators to the relevant view and actions.

  • Review dashboard owners, views, and edits
  • Change a workspace feature flag for an app
  • Browse or edit a connected app database
BuilderIO/agent-native7.5KUpdated Oct 26, 2026

See all skills by BuilderIO

Report a problem with this skill