Error Tracking CLI Command Reference

Every dcloud errors command. The shape is dcloud <service> <resource> <verb>; every command also takes the global flags (--json, --profile, --dry-run, …).

dcloud errors projects

Projects: a DSN for the Sentry SDKs, retention, rate limit and alerts

  • listList projects with their DSNs, unresolved issues and events of the last 24 hours
  • createCreate a project and its first DSN key
  • getRead a project, its keys and DSNs
  • updateChange a project: name, platform, retention, rate limit, client IP, alerts
  • deleteDelete a project: its keys stop working at once, its issues and events go
  • usageWhat the ingest received for the project in the last 30 days, by category and outcome

dcloud errors keys

DSN keys of a project

  • createAdd a DSN key
  • revokeRevoke a DSN key; the ingest refuses it within seconds

dcloud errors issues

Issues: events grouped by fingerprint, with counts, users, first and last seen

  • listList a project’s issues
  • updateResolve, reopen, ignore or assign issues
  • deleteDelete issues and their events
  • getRead an issue with its 14-day hourly counts and tag distribution

dcloud errors events

Events of an issue: stack traces (source-mapped), breadcrumbs, request, tags, contexts

  • listList an issue’s events, newest first
  • latestRead an issue’s latest event in full
  • getRead one event in full

dcloud errors traces

Performance traces: a trace’s transactions with their spans as a waterfall, and its errors

  • getRead a trace: its transactions and spans on one time axis, and the errors in it

dcloud errors profiles

Profiles: where a transaction spent its time, as a flame graph and by function

  • getRead a transaction’s profile: its call tree (flame graph) and its functions by self time
  • listList a project’s continuous profile chunks in a window (last 15 min, hour, day or custom): filters, samples per minute, the chunks
  • flamegraphMerge a project’s continuous profiles in a window into one flame graph, with its slowest functions by self time (optionally only in-app frames, or compared with the previous window)

dcloud errors transactions

Transactions of a project by name and operation: counts, durations, failure rate

  • listList a project’s transactions by name: count (sampled and extrapolated), p50/p75/p95 duration and failure rate

dcloud errors releases

Releases created by sentry-cli and the bundler plugins

dcloud errors alert-rules

Alert rules of a project: a trigger (new issue, frequency, users, crash-free rate), filters, and mail or webhook actions (Slack, Teams, Discord, JSON)

  • listList a project’s alert rules and their latest firings
  • createCreate an alert rule
  • updateChange an alert rule, or turn it on or off
  • deleteDelete an alert rule and its history
  • testSend the rule’s alert now with sample data, to check its mail and webhooks

dcloud errors queries

Database statements from db spans: time share, calls, slowest calls, N+1, by the fingerprint the database’s query insights use

  • listList a project’s database statements by total time: calls, mean and slowest call, time share, N+1 transactions
  • getRead one statement: what sampled requests saw, what the database measured (pg_stat_statements), charts, and the database at one request’s minute
  • list-allList every statement: measured by the connected databases (every call) and seen in traces, joined by fingerprint

dcloud errors databases

Managed PostgreSQL databases connected to a project: its Queries tab reads their Query insights

  • listList the connected databases and the suggested ones (databases the project’s connected apps use)
  • connectConnect a PostgreSQL database of the organization to the project
  • disconnectDisconnect a database (its Query insights are unchanged)
  • dismiss-suggestionStop suggesting this database for the project

dcloud errors release-health

Release health of a project: crash-free sessions and users, adoption, per release

  • listList a project’s releases with their sessions, crash-free sessions and users, adoption and new issues

dcloud errors auth-tokens

Tokens for sentry-cli and withSentryConfig

  • createCreate a SENTRY_AUTH_TOKEN (an access key of yours capped to errors:*), shown once
  • create-upload-tokenA short-lived SENTRY_AUTH_TOKEN for one project: source-map upload only, at most an hour

dcloud errors connections

Apps and CI environments connected to a project, its managed key and Secrets entry, rotation, upload tokens

  • getWhat is connected: apps, CI environments, the managed key and secret, the last upload tokens (no secrets)
  • connect-ciConnect a repository’s CI environment: its jobs exchange their OIDC token for an upload token
  • disconnect-ciDisconnect a CI environment
  • rotate-keyRotate the managed DSN key: new key, every connected app rebuilt, the old key revoked after the grace
  • revoke-previous-keyRevoke the rotated-out key now (its events are refused from then on)
  • extend-graceMove the rotated-out key’s revocation

Generated from the API description, the same one the API checks requests against and the CLI is built from.