---
title: Timeliness indicators for predictions and actuals
description: Enable timeliness tracking to retain the last calculated health status and reveal when status indicators are based on old data.
section_name: MLOps
maturity: public-preview

---

# Timeliness indicators for predictions and actuals

!!! info "Availability information"
    The timeliness indicator is off by default. Contact your DataRobot representative or administrator for information on enabling this feature.

    <b>Feature flag:</b> Enable timeliness stats indicator for deployments

Deployments have four statuses to define the general health of a deployment: [Service Health](service-health), [Data Drift](data-drift), [Accuracy](deploy-accuracy), and [Fairness](mlops-fairness). These statuses are calculated based on the most recent available data. For deployments relying on batch predictions made in intervals greater than 24 hours, this method can result in a _Gray / Unknown_ status on the [Prediction Health indicators in the deployment inventory](deploy-inventory#prediction-health-lens). Now available for Public Preview, those deployment health indicators can retain the most recently calculated health status, presented along with _timeliness_ status indicators to reveal when they are based on old data. You can determine the appropriate timeliness intervals for your deployments on a case-by-case basis.

## Define timeliness settings

You can configure timeliness tracking on the [**Usage** tab](deploy-usage) for predictions and actuals. After enabling tracking, you can define the timeliness interval frequency based on the prediction timestamp and the actuals upload time separately, depending on your organization's needs:

To enable and define timeliness tracking:

1. From the **Deployments** page, do either of the following:

    * Click the deployment you want to define timeliness settings for, and then click **Usage > Settings**.

    * Click the _Gray / Not Tracked_ icon in the Predictions Timeliness or Actuals Timeliness column to open the **Usage Settings** page for that deployment.

        ![](images/open-timeliness-settings.png)

2. On the **Usage Settings** page, configure the following settings:

    ![](images/timeliness-settings.png)

    Setting                          | Description
    ---------------------------------|------------
    Track timeliness                 | Enable one or more of **Track timeliness of predictions** and **Track timeliness of actuals**. To track the timeliness of actuals, [provide an association ID](accuracy-settings#select-an-association-id) and [enable target monitoring](data-drift-settings) for the deployment.
    Predictions timestamp definition | If you enabled timeliness tracking for predictions, use the frequency selectors to define an **Expected prediction frequency** in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html){ target=_blank }  format. The minimum granularity is one hour. To define time intervals directly in ISO 8601 notation (`P1Y2M3DT1H`), click **Switch to advanced frequency**.
    Actuals timestamp definition     | If you enabled timeliness tracking for actuals, use the frequency selectors to define the **Expected actuals upload frequency** in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html){ target=_blank }  format. The minimum granularity is one hour. To define time intervals directly in ISO 8601 notation (`P1Y2M3DT1H`), click **Switch to advanced frequency**.

    !!! tip
        You can click **Reset to defaults** to return to a daily expected frequency, or `P1D`.

3. Click **Save**.

## View timeliness indicators

Once you've enabled timeliness tracking on the **Usage > Settings** tab, you can view timeliness indicators on the [**Usage** tab](deploy-usage) and in the [**Deployments** inventory](deploy-inventory):

!!! note
     In addition to the indicators on the **Usage** tab and the **Deployments** inventory, when a timeliness status changes to _Red / Failing_, a notification is sent through email or the [channel configured in your notification policies](web-notify).

=== "Deployments inventory"

    View the **Predictions Timeliness** and **Actuals Timeliness** columns:

    ![](images/timeliness-columns.png)

=== "Usage tab"

    View the **Predictions Timeliness** and **Actuals Timeliness** tiles:

    ![](images/timeliness-tiles.png)

    Along with the status, you can view the **Updated** time for the timeliness tile.

## View timeliness status events

On the **Service Health** tab, under **Recent Activity**, you can view timeliness status events in the **Agent Activity** log:

![](images/timeliness-events.png)

## Filter the deployment inventory by timeliness

In the **Deployments** inventory, you can click **Filters** to apply **Predictions Timeliness Status** and **Actuals Timeliness Status** filters by status value:

![](images/timeliness-filters.png)