View actions in ADBM

In ADBM, an action means any API call, SQL request, or internal procedure that starts when backup configurations or operations related to backups are being applied.

Each action can trigger several other related actions. In this case, a top-level action is called parent, while others are called children or child actions.

List of actions

To view a list of actions, follow the steps:

  1. Open the Backup Manager page via the ADB Control web interface. The Actions section of the next page contains a table with general information on actions for all available ADB clusters.

    adbm actions way1
    The Actions section
  2. If you want to display actions for a specified cluster, click the cluster name in the table that is located in the Clusters section of the opened page.

    adbm cluster open
    Select the ADB cluster

    The Actions tab of the opened page contains a table with general information on actions for the selected cluster.

    adbm actions way2
    The Actions tab

Both tables mentioned above contain the following information on actions.

Action list fields
Field Description

Action Id

An action unique identifier

Cluster

A name of the cluster on which the selected action was executed. Displayed only if no specific cluster is selected

Type

An action type. Possible values:

  • sql — SQL request;

  • api — API call;

  • cmd — shell command;

  • internal — internal ADBM action.

Action

An action full name

Start time

An action start timestamp in the DD/MM/YYYY HH:mm:ss format

Username

The user who performed the selected action

Status

An action status. Possible values:

  • started

  • stopped

  • done

  • failed

  • terminating

  • awaiting

  • unknown

Search actions

Both the Actions section and the Actions tab contain filters that you can use to select actions with specific data. The default filters are listed below:

  • Search action ID…​ — filter by the action identifier (see Action Id above). Enter a full value.

  • Search user…​ — filter by the user name (see Username above). Enter a full value.

  • Cluster — filter by the cluster name (see Cluster above). Select a value from the drop-down list.

  • Action — filter by the action name (see Action above). Select a value from the drop-down list.

  • Status — filter by the action status (see Status above). Select a value from the drop-down list.

adbm actions filter
Filters for actions

For example, to show only the failed actions, you can click the Status filter and select the failed item in the drop-down list.

adbm actions filter2
Set the Status filter

As a result of applying a filter, the table contains actions with the failed status.

adbm actions filter3
Failed actions

You can also add filters by the action start time. To do this, click Add filters and select items in the drop-down list that opens.

adbm actions filter4
New filters

Below is an example how to use the Start time since filter:

  1. Add new filters as shown above.

  2. Click the Start time since filter.

    adbm actions filter5
    The "Start time since" filter
  3. In the form that opens, select a timestamp starting with which you want to show actions. You can select either an interval in the left panel or a date in the calendar.

    adbm calendar
    Choose the start time for actions
  4. Click Set.

  5. As a result, actions for a given period of time appear in the list.

    adbm actions filter6
    Actions appear in the list
IMPORTANT

By default, the tables located both in the Actions section and on the Actions tab show the current-day actions. To view all actions, use the time filters as described above.

Action details

To view the action details, click the action identifier (Action Id) in the table located in the Actions section or on the Actions tab.

adbm actions details
Select an action

The next page can contain the following sections:

  • Overview — shows the general action information.

  • Children — shows a list of child actions. It can be empty if the selected action has no children.

  • Result — shows the action result. This section is displayed only for low-level actions (without children) that have the failed status.

adbm actions details2
The "Overview" and "Children" sections

The fields displayed in the first two sections are listed below.

Fields of the Overview section
Field Description

Parent action

The parent action identifier. Contains - if the selected action has no a parent. You can click the identifier to view the detailed action information

Submitted by

The user who submitted the selected action

Start

The action start timestamp in the DD/MM/YYYY HH:mm:ss format

End

The action end timestamp in the DD/MM/YYYY HH:mm:ss format

Status

The action status (see Status above)

Fields of the Children section
Field Description

Action id

The child action identifier. You can click the identifier to view the detailed action information

Action

The child action name

Status

The child action status (see Status above)

Start

The child action start timestamp in the DD/MM/YYYY HH:mm:ss format

End

The child action end timestamp in the DD/MM/YYYY HH:mm:ss format

To find out why the selected action failed, you can look through the list of its child actions and, if necessary, their child actions (by clicking action identifiers in the first table column of the Children section). The action that caused the error has the filled Result section.

For example, the result listed below means an attempt to create a restore point before any backup is completed.

adbm actions details3
The Result section
TIP

You can copy the result by clicking copy hover dark copy hover light in the top right corner of the code sample. This functionality can be useful for debugging errors.

Found a mistake? Seleсt text and press Ctrl+Enter to report it