Skip to content

Features

Temp edited this page Jan 27, 2026 · 6 revisions

Features

Comprehensive guide to all DO Manager features.


Namespace Management

Auto-Discovery

Click Discover Namespaces to automatically detect all Durable Object namespaces in your Cloudflare account via the API.

Manual Configuration

Add namespaces manually with custom settings for setups that aren't auto-detected.

Namespace Operations

Operation Description
Clone Duplicate namespace configuration with a new name
Download Export namespace settings as JSON
Delete Remove namespace from tracking

System Namespace Filtering

Internal system DOs are automatically hidden to prevent accidental deletion:

  • kv-manager_*
  • d1-manager_*
  • do-manager_*

Search & Filter

Real-time filtering by name, class name, or script name.

Storage Backend Support

Both SQLite and KV storage backends are supported.


Instance Management

Instance Tracking

Track DO instances by:

  • Instance name — Human-readable identifier
  • Hex ID — Cloudflare's object ID

Instance Operations

Operation Description
Create Create new instance with custom name
Clone Copy all storage data to a new instance
Download Export instance storage as JSON
Delete Remove instance from tracking

Color Tags

Color-code instances for visual organization with 9 preset colors. Useful for marking environments (prod/staging/dev) or categories.

Instance Diff

Compare storage between two instances side-by-side to see:

  • Keys unique to each instance
  • Keys with different values
  • Matching keys

Instance Migration

Migrate instances between namespaces with full data transfer. Requires admin hooks enabled on both source and target namespaces.

Cutover Mode Behavior
Copy Only Source instance remains unchanged
Copy + Freeze Source becomes read-only (blocks writes via 423 response)
Copy + Delete Source instance deleted after successful migration

Options:

  • Verification — Compare key counts after migration to ensure data integrity
  • Alarm Migration — Transfer scheduled alarm state to the new instance

Search & Filter

Real-time filtering by instance name or object ID.


SQL Console

For SQLite-backed Durable Objects, execute raw SQL queries with a feature-rich editor.

Enhanced SQL Editor

Feature Description
Syntax Highlighting Prism.js-powered SQL highlighting with line numbers
Real-time Validation Live error detection with inline squiggly underlines
Hover Documentation Tooltips for SQL keywords and functions
Context Autocomplete Smart suggestions for keywords, table names, and columns
Smart Indentation Auto-pairing brackets/quotes and Tab indentation
Format Button One-click SQL formatting (SQLite dialect)
Copy Button Copy query to clipboard with visual feedback
Word Wrap Toggle Toggle line wrapping in editor

Editor Preferences

Setting Description
Enable SQL Suggestions Toggle autocomplete popup (persisted to localStorage)
Allow Destructive Queries Enable DROP, DELETE, TRUNCATE statements

Quick Queries

Pre-built SQL templates for common operations, grouped by category:

Category Templates
Information Show All Objects, Show All Tables, Show CREATE Statement, Foreign Keys, Indexes, Table Schema
Select Data Count Rows, Select All, Select with JOIN, LIKE, WHERE
Modify Data Insert Row, Update Rows, Delete Rows
Table Management Create Table, Add Column, Create/Drop Index, Rename/Drop Table

Templates use ALL_CAPS placeholders (e.g., TABLE_NAME) — double-click to select and replace.

Saved Queries

Store frequently used queries per namespace for quick access.

Query History

Access recent queries without retyping.

Results Display

Query results are displayed in a sortable table format.


Multi-Select & Batch Operations

Selection UI

  • Always-visible checkboxes on all list items
  • Selection toolbar — Floating bar shows count with Select All and Clear actions

Batch Download

Target Output
Namespaces ZIP file with namespace configs and manifest
Instances ZIP file with instance storage data and manifest
Keys JSON file with selected keys and metadata

Batch Delete

Delete multiple namespaces, instances, or storage keys with confirmation dialog.

Batch Backup

Backup multiple instances to R2 with progress tracking.

Compare

Select exactly 2 instances to compare storage differences.


Storage Management

Key Operations

Operation Description
View See key-value pairs with JSON formatting
Edit Modify values directly
Create Add new key-value pairs
Delete Remove individual or multiple keys

Search & Filter

Real-time filtering to find keys quickly.

Multi-Select

Select multiple keys with checkboxes for batch operations.

Import/Export

  • Export — Download selected keys as JSON with instance/namespace metadata
  • Import — Upload JSON files or paste JSON directly to bulk import keys into instance storage

Alarms

Durable Objects support alarms for scheduled execution.

Alarm Operations

Operation Description
View See current alarm state and scheduled time
Set Create new alarm with date/time picker
Delete Cancel existing alarm

R2 Backup & Restore

Backup

Snapshot DO instance storage to R2 bucket.

Backup History

Browse all previous backups with timestamps.

Restore

Restore from any backup with automatic page refresh to show restored data.


Metrics Dashboard

Available Metrics

Metric Description
Request Volume Requests over time
Storage Usage Current storage consumption
CPU Time (Avg) Average CPU time per request
CPU Time (Total) Total CPU time consumed

Data is fetched from Cloudflare's GraphQL Analytics API.


Global Search

Search across all namespaces and instances.

Key Search

Find storage keys by name across all instances.

Value Search

Search within JSON values to find data anywhere.

Features

  • Namespace filtering — Limit search to specific namespaces
  • Result grouping — Results organized by namespace
  • Match highlighting — Search terms highlighted in results
  • Value previews — Shows matching portion of values

All search operations are logged to job history.


Job History

Comprehensive tracking of all operations.

Tracked Operations

Category Operations
Namespace create, delete, clone, download (single & batch)
Instance create, delete, clone, download (single & batch)
Storage create/update/delete (single), batch delete, batch export, import
Alarms set, delete
Backup backup, restore
Batch delete, backup, download
Search key search, value search

Job Details

  • Status (pending, running, completed, failed)
  • Progress percentage
  • Timing information
  • Error details for failed operations

Filtering

Filter by status or namespace.


Webhook Notifications

Send HTTP notifications when key events occur.

Supported Events

Storage Events

Event Trigger
storage_create Key created in instance storage
storage_update Key value updated
storage_delete Key deleted from instance storage

Instance Events

Event Trigger
instance_create New instance created/tracked
instance_delete Instance deleted

Import/Export Events

Event Trigger
import_complete Import operation finished
export_complete Export operation finished

Backup/Restore Events

Event Trigger
backup_complete Backup finished successfully
restore_complete Restore finished successfully

Alarm Events

Event Trigger
alarm_set Alarm was created
alarm_deleted Alarm was deleted

Job Events

Event Trigger
job_failed Any job failed
batch_complete Batch operation finished

Security

  • HMAC signatures — Optional secret-based request signing
  • Test webhooks — Verify endpoint connectivity before going live

Health Dashboard

System Overview

  • Total namespaces count
  • Total instances count
  • Active alarms count

Alerts

Alert Condition
Stale Instances Not accessed in 7+ days
Storage Warning 80% of 10GB DO limit
Storage Critical 90% of 10GB DO limit

Active Alarms

List of all pending alarms with countdown timers.

Storage Summary

Aggregate storage usage across all instances.

Recent Activity

Timeline of operations in last 24 hours and 7 days.


Centralized Error Logging

Structured error logging system for consistent error handling across all modules.

Features

Feature Description
Structured Payloads Consistent format with module, operation, context, and metadata
Error Codes Module-prefixed codes like NS_CREATE_FAILED, INST_DELETE_FAILED
Severity Levels error, warning, info
Webhook Integration Automatic webhook triggers for job failures
Stack Traces Full stack traces captured for debugging

Log Format

[LEVEL] [module] [CODE] message (context)

Example:

[ERROR] [namespaces] [NS_CREATE_FAILED] Failed to create namespace (ns: abc123)

Error Code Prefixes

Module Prefix
namespaces NS
instances INST
storage STG
alarms ALM
backup BKP
batch BCH
search SRC
metrics MTR
jobs JOB
webhooks WHK
health HLT

User Experience

Themes

  • Dark — Dark color scheme
  • Light — Light color scheme
  • System — Follow OS preference

Responsive Design

Works on desktop, tablet, and mobile devices.

Accessibility

  • Proper form labels
  • ARIA attributes
  • Keyboard navigation support

Authentication

Enterprise authentication via Cloudflare Access (Zero Trust).

Clone this wiki locally