Work with metrics over time

Published

May 6, 2026

Once generated via the ValidMind Library, view and add metrics over time to your ongoing monitoring reports in the ValidMind Platform.

Metrics over time refers to the continued monitoring of a model’s performance once it is deployed. Tracking how a model performs as new data is introduced or conditions change ensures that it remains accurate and reliable in real-world environments where data distributions or market conditions shift.

Learn how to log metrics over time, set thresholds, and analyze model performance trends with our Jupyter Notebook sample.

Prerequisites

Add metrics over time

  1. In the left sidebar, click Inventory.

  2. Select a model or find your model by applying a filter or searching for it.4

  3. In the left sidebar that appears for your model, click Documents and select the Latest tab.5

  4. Select a Monitoring type file.6

  5. Click on a section header to expand that section and add content.

  6. Hover your mouse over the space where you want your new block to go until a horizontal line with a sign appears that indicates you can insert a new block:

    A gif showing the process of adding a content block in the UI

    Adding a content block in the UI
  7. Click and then select Metric Over Time7 under from library.

  8. Select metric over time results:

    • Choose from available VM Library (out-of-the-box) or Custom tests under metric over time in the left sidebar of the test selection modal.
    • Use Search by name on the top-left to locate specific metric results.

    A screenshot showing several Metric Over Time blocks that have been selected for insertion

    Metric Over Time blocks that have been selected for insertion

    To preview what is included in a metric, click on it. By default, the actively selected metric is previewed.

  9. Click Insert # Metric(s) Over Time to Document when you are ready.

  10. After inserting the metrics into your document, review the data to confirm that it is accurate and relevant.

    A screenshot showing an example F1 Score — Metric Over Time visualization

    Example F1 Score — Metric Over Time visualization

Add integration metrics

You can add metrics from external integrations such as Amazon Bedrock directly to your monitoring documents. This feature enables you to track evaluation results from Bedrock agents alongside your other model metrics.

NoneIntegration metrics require a configured connection.

Before you can add metrics from an integration, ensure that the connection is configured and the model is linked to the external system.8

  1. In the left sidebar, click Inventory.

  2. Select a model or find your model by applying a filter or searching for it.9

  3. In the left sidebar, click Monitoring to open the monitoring report.

  4. Hover your mouse over the space where you want your new block to go until a horizontal line with a sign appears.

  5. Click and then select Metric Over Time.

  6. In the modal that opens, select the From Integration tab.

  7. Select your integration under integration source, then choose from the Evaluators list — such as Goal Success Rate, Correctness, or Helpfulness.

  8. Select one or more evaluation metrics to add. For each metric, you can optionally configure:

    • threshold (lower) — Set a lower threshold value to flag when metrics fall below acceptable limits.
    • threshold (upper) — Set an upper threshold value to flag when metrics exceed acceptable limits.
    • time range — Define the time range for querying metric data. Choose to inherit from the document, use a relative preset, or specify a custom date range.
  9. Click Insert # Metric(s) Over Time to Document when you are ready.

After the metrics sync, data from the integration appears in your document alongside any metrics logged via the ValidMind Library.

Use the global time range

When working with monitoring documents that contain multiple time-based metrics, use the global time range to coordinate the time range across all relevant content.

  1. Navigate to a monitoring document with metrics over time.

  2. Locate the time range button at the top of the document.

  3. Select the desired time range from the available options:

    • All Time — Show all available data
    • Relative presets (Last 7 days, Last 30 days, etc.)
    • Custom range — Specify exact start and end dates

The selected time range applies to all metrics in the document that support time-based filtering, providing a consistent view of your model’s performance over the chosen period. This setting is only visible to you and does not affect other users.

View metric over time metadata

After you have added metrics over time to your document, you can view the following information attached to the result:

  • Date and time the metric was recorded
  • Who updated the metric
  • The numeric value of the metric
  • The metric’s thresholds
  • Any additional parameters
  1. In the left sidebar, click Inventory.

  2. Select a model or find your model by applying a filter or searching for it.10

  3. In the left sidebar that appears for your model, click Documents and select the Latest tab.11

  4. Select a Monitoring type file.12

  5. Locate the metric whose metadata you want to view.

  6. Under the metric’s name, click on Data tab.

    A screenshot showing an example Data tab within a Metric Over Time

    Example Data tab within a Metric Over Time