In this section we show how to monitor active and scheduled deliveries.
You can monitor active and scheduled deliveries in the Monitor
screen. Given the fact that deliveries trigger the automated processing of all datalogistics, you need an overview of what is running and what needs special attention.
If you choose menu > Supply > Monitor
this will show all active Deliveries and their status. This screen is also your default screen when you start up the i-refactory web app.
The donut graphs at the top show the number of active entity updates per layer and the status of the updates. If an entity update fails, the center of the donut graph colors red. If no failures exists, the donut colors dark blue. If you hover over one of the segments of the graph the description and color of the center of the donut changes. If you click on a segment of the donut, a list with all entity updates of that particular segment is shown.
{info} Please note that once a delivery reaches its end-state, this delivery will no longer be shown on this monitor. You can analyze deliveries that reach their end-state with the Analyze Deliveries.
In the monitor you can also see an overview per Delivery. For each active Delivery you can see the status, start time, elapsed time, and the entity updates per layer and per status.
retry
button.
If you automatically want to refresh the graphs on the monitor page, you can set an interval in seconds.
Set to automatic refresh
To adjust the refresh interval:
CTRL
and click with your left mouse button on the refresh icon.Command
and click with your left mouse button on the refresh icon.Apply
to submit the changesIt is possible to Reject
a delivery while the status of a delivery is still on RECEIVED
. If you reject a delivery, the end-state is met directly and the delivery is no longer shown as Active Delivery
. You can find the Rejected Delivery
in the Analyze Deliveries screen.
{info} If the status of the delivery is on
RECEIVED
, the technical loading tasks are not yet finalized. If the technical loading tasks are finished, the status of a delivery will change toLOADED
and rejecting a delivery is not possible.
For deliveries that started processing and cannot reach their end-state (for example, a database error), users with a Developer
role have the option to cancel a delivery.
If an active delivery is cancelled, IDLE
and SCHEDULED
tasks will not be executed anymore. The already PROCESSING
tasks will continue and finish.
Cancel
is executed while the entity updates are in the Technical Staging Layer (TSL) or during the Constraint validation check, this will not require additional steps.Cancel
is executed while the entity updates are in the Logical Validation Layer (LVL), this can lead to interfering effects.Cancel
is executed while processing tasks related to the File Export Layer, this could result in an inconsistent set of files on the target file location. In order to prevent issues for data consumers, it is advised to delete the folder created by the corresponding delivery.{warning} Cancelling Deliveries could lead to an unwanted intermediate state of your data if the cancel happens after the Technical Staging Layer (TSL). A cancel is not a rollback to a previous state. If you cancel the current Delivery, the processed and successful entity updates in these delivery are stored in the Central Facts Layer, while the idle and scheduled tasks are stopped.
If a Cancel
is executed while delivery is processed in the Logical Validation Layer, you have to take into account the effect of the next Delivery on the state of your data:
A
is stored in the Logical Validation Layer (LVL) but not in Central Facts Layer (CFL).A
is submitted, a compare will be made between the Technical Staging in Layer and Logical Validation Layer. Because record A
is already in the LVL, this record will not be delivered or updated in the CFL.{info} The intermediate status of a Cancelled Delivery (as long as not all processing tasks are either succeeded or failed) is
CANCELLING
.
Cancelling a delivery is only allowed if a user has been granted the role of Developer
.
{tip} It's possible to disable the
Developer
role on server level. For example: A user is granted theDeveloper
role in the development environment, but on a production environment the user is never allowed to cancel a delivery. TheDeveloper
role can be disabled by setting this value in the config file:application.disabledRoles
.
Ask advice from our consultants because the fix depends on the type of delivery. Generally, you need to check which records are not successfully updated from the LVL to the CFL and make sure these records are updated in the CPL.
You can find the API documentation on: <hostname>:3001
. For example: https://localhost:3001/
FAILED Cannot insert NULL into...
: In most cases this means you have a problem with the mapping to one of your primary keys or you have a violation of your relationship constraint with a threshold > 0. This means you need to check your mappings or your constraints.
FAILED The number of values in the select statement is higher than the number of values in the insert statement
: The number of columns in the Context is higher than expected. This means you need to check if your primary key is not also a column in your satellite.
{warning} When the status is
FAILED
the delivery is not in an 'end state'. This means that you will need to set it to an acceptable end state first (for example, click onRetry
and try to get the state to Succeeded or click onReject
) before you can continue for a new Delivery.