Manage real-time instances

更新时间:
复制 MD 格式

A real-time instance is created when you submit a real-time task to the operations center. You can view instance data, code, and parameters, and perform operations such as starting, stopping, and decommissioning instances.

Real-time instance page

  1. In the top navigation bar on the Dataphin homepage, choose Development > task operations.

  2. In the top navigation bar, select either the production or development environment.

  3. In the navigation pane on the left, choose instance operations > Real-time Instance to open the Real-time Instance page.

Real-time instance page

The Real-time Instance page lists all system-generated real-time instances and allows you to manage them.

image

Area

Description

Filter and search area

You can search for a real-time instance by entering its object name or ID.

  • My stopped instances: Instances that you own and are in the Stopped status.

  • Instances I operated today: Instances that you operated on today.

  • Project: Filters instances by their project. You can select multiple projects for which you have O&M - Access Directory permissions.

  • Expand filters: Click Filter to show all filter options:

    • Sub-type: Includes Flink SQL, Flink Template SQL, Flink DataStream.

    • Status: Filters by one or more statuses, including Succeeded, Starting, Startup Failed, Running, Failed, Stopping, and Stopped.

    • Last operator: Filter by the user who last operated on the instance.

    • Owner: Filters by the operations owner of the instance.

    • Engine type: Filters by engine type, including Ververica Flink, Blink.

    • Cluster: The cluster ID for the Ververica Flink real-time compute engine.

    • Engine version: The engine version used by the instance.

    • Operation date: The date an operation was performed on the instance.

  • Reset: After expanding the filters, click Reset to clear all selected filter conditions.

List operations

  • View instance statistics: Navigates to the instance statistics page. For details, see View instance statistics.

  • Export instance list: Exports the currently displayed instance list to a .csv file.

  • Customize list header: Click the image icon to select which columns to display and reorder them.

    Note
    • The first column and the Actions column cannot be hidden or reordered.

    • Header settings revert to their defaults if you clear your browser cache or use a different browser.

  • Refresh list: Click the image icon to refresh the current list.

Real-time instance list

The real-time instance list displays Instance Object, Status, Last Operator, Last Update Time, Owner, and Project. Column widths are adjustable and saved locally in your browser. Settings reset if you clear your browser history and cookies.

  • Instance object: When you submit a real-time task for operations, the system generates a real-time instance with an initial status of Stopped. You can start it manually.

  • Status: The status of the instance, such as Starting, Running, Stopping, Stopped, Failed, or Startup Failed. For more information, see .

  • Consumer lag (s): The task's consumer lag, which is the delay in consuming data from the source.

  • Last operator: The user who last operated on the instance.

  • Last update time: The time of the last operation.

  • Owner: The operations owner of the instance.

  • Project: The project to which the instance belongs, displayed in the format Project English name (Project Chinese name).

  • Engine type: The engine type used by the real-time instance.

  • Cluster: The cluster on which the real-time instance is running. This applies only to the Ververica Flink real-time engine; this field is empty for other engines.

  • Resource queue: The resource queue where the real-time instance is running. This applies only to Blink real-time engines; the field is empty for other engines.

  • Engine version: The engine version on which the real-time instance is running.

The Actions column lists the available operations for each real-time instance. For details on individual operations, see Individual operations.

Batch operations

Perform batch operations such as start, stop, and decommission on multiple real-time instances.

For details on supported batch operations, see Batch operations.

Real-time instance status

Icon

Status

Description

image.png

Succeeded

The instance has finished processing all data in a bounded stream.

image

Starting

The instance is preparing to start but has not yet begun executing.

image

Running

The instance is currently running.

image

Stopping

The system is stopping the instance.

image

Stopped

The instance has stopped.

image

Failed

The instance failed during execution.

image

Startup Failed

The instance failed to start.

Manage real-time instances

Individual operations

Actions

Description

Start

In the Actions column of the target real-time instance, click the image icon to start the instance. For details, see Start a real-time instance.

Stop

In the Actions column of a Running instance, click the image icon. You can choose to stop without savepoint or stop with savepoint.

  • Stop without savepoint: Stops the job without creating a savepoint. The next time the job starts, it will not resume from a saved state.

    Important

    Stopping without a savepoint clears any previously saved savepoint but does not clear checkpoints.

  • Stop with savepoint: Creates a savepoint before stopping the job. You can then choose to resume from this savepoint the next time the job starts.

Note
  • The Blink real-time compute engine does not support choosing between stop without savepoint and stop with savepoint.

  • Real-time integration instances can only be stopped without a savepoint. Clicking Stop terminates the real-time incremental task and all active offline synchronization tasks.

Decommission

In the Actions column of the target real-time instance, click the image icon to decommission it from the production environment. This action is available for instances with a status of Stopped, Failed, or Startup Failed.

View runtime analysis

In the Actions column, click the image icon to view the instance's runtime information, data curves, failover parameters, and more.

If the real-time instance uses the Ververica Flink or Blink engine, see View the details of a job.

View real-time task

In the Actions column, click the image icon and select View Real-time Task to navigate to the task page for the current instance and view its details.

View instance code

In the Actions column, click the image icon and select View Instance Code to view the task code for the current instance.

View instance parameters

Click the image icon in the Actions column of the target real-time instance, and select View Instance Parameters to view the runtime parameters of the instance. For example, parameters such as metrics.reporter.promappmgr.port.

Batch operations

Actions

Description

Start

Note

The required instance status for starting varies by engine.

  • Ververica Flink: Stopped, Failed, Succeeded.

  • Blink: Stopped, Not Started.

Start real-time development instances:

  1. Select one or more real-time development instances, or click Select All on This Page, then click Start and choose Start Real-time Development Instance.

  2. In the Batch Start Real-time Development Instances dialog box, configure the startup options.

    • Start n instances: Displays the number and names of the instances to be started, separated by commas.

    • Start mode: You can start without state or from a valid state.

      • Start without State: Starts the task without any initial state.

      • Start from a Valid State: Starts the task from an existing, valid state.

        Note

        You can only use the stateless start option if all selected instances are stateless.

    • Read data from: Setting a start time causes all source tables that support startTime (such as Log Service, Kafka, MySQL, MongoDB, and OceanBase) to begin reading data from that time.

      Note

      Code parameter settings in an SQL job take precedence over this specified start time.

    • Business date: Assign a value to time variables by setting a business date. The system then calculates these variables based on the specified date, which defaults to the current day.

      Note

      Code parameter settings in an SQL job take precedence over this specified business date.

  3. Click OK to start the instances.

Stop

Note

Only instances with a status of Failed, Running, Startup Failed, Recovery Failed, or Succeeded can be stopped.

Stop real-time development instances:

  1. Select one or more real-time development instances, or select Select All on This Page, then click Stop and choose Stop Real-time Development Instance.

  2. In the Batch Stop Real-time Development Instances dialog box, configure the options.

    • Stop n instances: Displays the number and names of the instances to be stopped, separated by commas.

    • Stop mode:

      • Stop without savepoint: Stops the task without retaining its current state. The task will start without state next time.

      • Stop with savepoint: Retains the current state. The next time you start the task, you can choose to resume from this saved state.

Decommission

Decommissions the selected real-time instances from the production environment.

Note

Only instances in the Stopped state can be decommissioned.

Real-time instance DAG

Click an instance object name in the list to display its DAG on the right. By default, the DAG centers on the selected node and shows its immediate parent and child nodes. You can adjust the view:

  • Click the tegtwe icon to hide the instance list and expand the DAG.

  • Click the geg icon to hide the DAG.

  • Hover over the teaga icon and drag to resize the DAG pane.

The DAG shows the node's upstream and downstream dependencies. You can perform operations on these nodes.

image

Area

Description

Node information pane

Displays summary information for the selected node. Click View node details for full details.

Ververica Flink real-time engine: Includes Node Details, Runtime Log, Operation Log, Node Code, and Task Parameters (only for compute task instances).

  • Node details: Contains basic and runtime information. Basic information includes node name, ID, instance ID, and project. Runtime information includes status, runtime duration, and more.

  • Runtime log: Displays the runtime logs of the current node. If a failure generates dirty data, you can download the dirty data file.

  • Operation log: Displays the operation logs for the current node, including the time, operator, and specific action.

  • Runtime analysis: Uses a dashboard to display various runtime metrics (such as failure counts and backpressure data) over a selected time range.

  • Logs: Displays startup logs, runtime logs, and exception information separately.

  • Node code: Displays the specific code for the current node.

  • Task parameters: Displays the task parameters for the current node.

Node search and filter area

Set the number of upstream and downstream levels to expand from the main node. You can also search for a node name to locate it in the DAG.

Scheduling dependency graph

Displays the scheduling dependency graph. Expand to show more upstream and downstream nodes and perform operations on them. Hover over a node to view its name, type, scheduling cycle, owner, and description.

Canvas adjustment area

Adjust the DAG display scale: set a specific zoom level (default 100%), zoom in (max 200%), zoom out (min 20%), fit to canvas, or enter full-screen mode. Also displays the node ID and name of the main node.

DAG node operations

Actions

Description

Expand parent nodes

Expands the DAG to show more levels of parent or child nodes.

Expand child nodes

View real-time task

Navigates to the task node DAG for the current instance to view task details, upstream and downstream nodes, and perform task operations. For more information, see Manage real-time tasks.

View node code

Views the task code that generated the current instance.

View runtime log

Views the runtime log of the instance node. If the task generates dirty data, you can click Download Dirty Data File to download it for local inspection. The file includes the Time, Error content, and Error cause. By default, the system retains these files for 7 days.

View task parameters

View the task parameters of the current instance node, such as execution.checkpointing.interval.

Edit development node

Navigates to the task editing page for the current instance in the development project. This is applicable only in the Dev-Prod development mode.

Edit node

Navigates to the task editing page that generated the current instance node. This is applicable only in Basic mode.

View production node

Views the configuration of the task in the Prod project that generated the current instance node.

View operation log

Views the operation log for the current instance, including Operation Time, Operator, and Action.

View runtime analysis

Views the instance's runtime information, data curves, failover parameters, and more.

If the real-time instance uses the Ververica Flink or Alibaba Blink engine, see View the details of a job.

Start

Starts the current real-time instance. For details, see Start a real-time instance.

Stop

Stops a real-time instance that is Running or Succeeded. For instances with a status of Succeeded, only stop without savepoint is supported. You can choose to stop without savepoint or stop with savepoint.

  • Stop without savepoint: Stops the job without creating a savepoint. The job will start without any saved state on its next run.

  • Stop with savepoint: Creates a savepoint before stopping the job. The next time you start the job, you can choose to resume from this saved state.

Note

The Blink real-time compute engine does not support choosing between stop without savepoint and stop with savepoint.

Decommission

Decommissions a real-time instance from the production environment. This action is available only for instances in the Stopped state.