Instances

Instances (Instance Manager)

The Instances page shows all compute nodes (instances) in your Datatailr deployment. You can manage instances through both the GUI and the CLI. You need Admin access to perform these operations.

GUI

Open the Instance Manager from the left sidebar by clicking the Instances icon.

Use this page to monitor node state, environment, class, type, and resource usage (CPU, memory).

---

Walkthrough

1. Open Instances
   Click the Instances icon in the sidebar. The Instance Manager opens with a table of all nodes.

2. Understand the columns

3. Name — Node hostname/identifier.
4. Environment — Environment this node serves (dev, pre, prod, or system).
5. Class — Node class (e.g. compute vs system).
6. Type — Instance type (e.g. machine size or role).
7. State — Current state (e.g. running, stopped).
8. CPU — CPU usage or allocation.
9. Memory — Memory usage or allocation.
10. Created At — When the instance was created.

11. Architecture — CPU architecture (e.g. amd64, arm64).

12. Open jobs for a node
    Click a row to go to that instance's Jobs view, where you can see jobs running (or that ran) on that node.

13. Add New (cloud deployments)
    On cloud deployments (e.g. AWS, Azure, GCP), an Add New button may be available to provision new instances. It is hidden when the provider is Local (e.g. local Docker-based setup).

Instances are the workers that run your compute processes and jobs. Use this page to verify that nodes are in the expected state and environment.

---

CLI

Instances and nodes can also be managed with the dt node commands. This is useful for scripting, automation, and infrastructure management.

Action	Command
List all nodes	dt node ls
List nodes with filter	dt node ls <filter>
Create new nodes	dt node new <config_file>
Start nodes	dt node start <node_id> [...]
Stop nodes	dt node stop <node_id> [...]
Restart nodes	dt node restart <node_id> [...]
Terminate nodes	dt node terminate <node_id> [...]
Change instance type	dt node change-type <type> <node_id>
Show running processes	dt node ps
Drain a node	dt node drain [-N <node_name>]
Stop draining	dt node drain -s [-N <node_name>]
Check drain status	dt node drain-status [-N <node_name>]

Examples:

# List all nodes
dt node ls

# List nodes with a filter
dt node ls name=compute,id=id-123

# Show running processes on a specific node
dt node ps -N node_name

# Stop a node
dt node stop i-08666efd2a24f10f8

# Drain a node (stop scheduling new jobs)
dt node drain -N node_name

# Change instance type (cloud deployments)
dt node change-type r6a.large i-08666efd2a24f10f8

Add -p to pretty-print output or -j for JSON output.