Graph Update Frequency

Dashboard.PT allows you to control how frequently data points can be added to your graphs. This feature helps prevent data flooding and ensures consistent update intervals for your visualizations.

Available Frequency Options

Option Description Best Used For
always Data can be added at any time (default) Real-time monitoring, continuous data streams
daily Data can only be added once per 24-hour period Daily KPIs, regular business metrics
weekly Data can only be added once per 7-day period Weekly reports, project progress tracking
yearly Data can only be added once per 365-day period Annual reports, slow-changing statistics

Setting Update Frequency

You can set the update frequency in two ways:

1. When Creating a New Graph

In the graph creation form, you'll find the "Update Frequency" setting in the Advanced Options section. Simply select your preferred update frequency from the dropdown menu.

2. When Editing an Existing Graph

You can also change the update frequency for an existing graph:

  1. Navigate to the Graphs page
  2. Find the graph you want to modify
  3. Click the Edit button (pencil icon)
  4. Open the Advanced Options section
  5. Change the "Update Frequency" setting
  6. Save your changes

Technical Implementation

Behind the scenes, the update frequency is stored in the graph's configuration JSON as:

{
    "theme": "dark",
    "title": "Average Delivery Times",
    "xAxis": {
        "type": "linear",
        "title": "Date"
    },
    "yAxis": {
        "max": 700,
        "min": 600,
        "title": "Days"
    },
    "colors": [],
    "legend": true,
    "animation": true,
    "customOptions": "{}",
    "updateFrequency": "daily"
}

When you attempt to add data points to a graph, the system checks:

  1. The configured update frequency for the graph
  2. When the graph was last updated
  3. If enough time has passed based on the frequency setting

API Response

If you try to update a graph too frequently via the API, you'll receive an error:

HTTP/1.1 429 Too Many Requests
Content-Type: application/json

{
    "status": "error",
    "message": "Update not allowed based on frequency setting (daily)"
}

Special Cases

  • Deleting Data: When you delete all data points from a graph, the update frequency timer is reset, allowing you to add new data immediately regardless of the frequency setting.
  • Default Setting: If the updateFrequency field is not specified, the system defaults to "always", allowing updates at any time.
  • New Graphs: When a graph is first created, the first update is always allowed.

Note

Update frequency limits apply to API calls and web interface updates. For urgent updates, you can delete the existing data points first, which resets the timer.

Want to try it? The free plan has no time limit.

Create a free account