Google Cloud Platform (GCP) plugin

Data streams standardize data from all the different shapes and formats your tools use into a straightforward tabular format.

While creating a tile you can tweak data streams by grouping or aggregating specific columns.

Depending on the kind of data, SquaredUp will automatically suggest how to visualize the result, for example as a table or line graph.

Data streams can be either global or scoped:

• Global data streams are unscoped and return information of a general nature (e.g. "Get the current number of unused hosts").
• A scoped data stream gets information relevant to the specific set objects supplied in the tile scope (e.g. "Get the current session count for these hosts").

See Data Streams for more information.

The GCP data source allows you to set up data streams for any kind of query for Google BigQuery.

1. In the tile editor, filter by the GCP data source, select BigQuery from the data stream list and then click Next.
2. Query:
   Enter a BigQuery query.
3. Project ID:
   Specify the project that you would like to run the BigQuery against.

The GCP data source allows you to set up configurable data streams for any kind of query for Monitoring Query Language (MQL). Use the + MQL Query data stream to enter your own MQL queries into SquaredUp.

You are able to query any object from your Google Cloud, even if they are not indexed in the SquaredUp graph. See Google Cloud: Using Monitoring Query Language for more information about MQL.

1. In the tile editor, filter by the GCP data source, select MQL Query from the data stream list and then click Next.

   You can either select the scoped MQL Query data stream or the global MQL Query data stream.

2. If you selected the scoped MQL Query data stream, select the objects you want to use and then click Next.

   You do not need to do this if you have selected the global MQL Query data stream.

3. Project:
   Select the project that you would like to run the MQL against from the dropdown.

   You will not need to select a project if you have already selected one in the scope.

4. MQL Query:
   Enter a MQL query.

   Mustache parameters are only supported if you have scoped to a GCP object and selected the + MQL Query. Mustache parameters are not supported if you have scoped to a project or the data source instance itself.

   
   See MQL query examples below for more information about queries. Supports mustache parameters supplied in an array

   A mustache parameter is a dynamic value, the actual value will be inserted to replace the field in curly braces. For example, {{timeframe.start}} will insert the start time based on the timeframe configured within the tile, or {{name}} will insert the name of the object(s) in scope.

   This data stream supplies scoped objects in an array for mustache parameters. When there are multiple objects in scope this data source will send the query once with all the objects in an array.

   When the scoped objects are supplied in an array the normal mustache syntax, for example {{name}}, must be contained between {{#.}} and {{/.}} (the full-stop indicates that the whole object should be used, in this case the array of objects in scope).

   For example, a query where clause might look like:

   Copy

   | where ComputerName in (  {{#.}}    '{{name}}',    {{/.}} '' )

   • The {{#.}} and {{/.}} indicate that what is contained within is expanded for each element in the array of objects.
   • You can use properties of objects and write them in between curly braces e.g {{name}} to use them as mustache parameters. For example, if objects of type "host" have a property called name, you can use {{name}}. This will resolve {{name}} to the value of the name property of the different "host" objects used in the scope.
   • '{{name}}', means that the name property is expanded inside single-quotes with a trailing comma.
   • The trailing single quotes '' are necessary to stop the query being rejected because a trailing comma is disallowed.
   • Whenever you use mustache parameters, you need to use a scope of objects that contain the property you're referencing.
5. Automatically apply dashboard timeframe:
   By default, Automatically apply dashboard timeframe will be selected.

   The dashboard timeframe setting lets you choose the time span that a dashboard displays data for. For example, instead of showing data from the last 12 hours, you can choose to show data from the last 7 days.

   Tiles on a dashboard inherit that dashboard's timeframe by default, meaning that the tile data shown changes whenever you change the dashboard timeframe. However, you can instead choose to set a fixed timeframe for a tile via its timeframe setting.

   Fixed-timeframe tiles display their set timeframe in a bubble next to their title and the tile data does not change when the dashboard timeframe is changed.

   

   If all the tiles on a dashboard use a fixed timeframe then the timeframe dropdown is disabled. Likewise, if a specific timeframe is unsupported then it is disabled in the dropdown.

   You should indicate if a tile's timeframe can be changed in the name of a tile. For example, naming a tile Performance during the last week indicated that the tile always displays data for the last week.

   Setting a default timeframe

   To set the default timeframe for a dashboard, click the pin

   next to an option in the timeframe dropdown. This sets the initial timeframe for all viewers of the dashboard, including shared dashboards.

   

   Cache refresh intervals

   As well as determining the period for the data that displays, the dashboard timeframe also controls the cache refresh frequency of that data. In other words, the timeframe you pick also affects how "fresh" that data is.

   Dashboard timeframe	Cache expiry
   1 hour	1 minute
   12 hours	5 minutes
   24 hours	15 minutes
   7 days	6 hours
   30 days	12 hours
   Up to 6 months	24 hours
   Over 6 months	7 days

   If you do not wish to use a dashboard timeframe, you can set the timeframe in the MQL query by adding within to the query. If you deselect Automatically apply dashboard timeframe and do not specify a timeframe in the MQL query, the query will fail. To add a timeframe to a query, simply type | within (timeframe) at the end of your query. For example, to add a timeframe of 24 hours you enter: | within (24h)

fetch gce_instance | metric 'compute.googleapis.com/instance/cpu/usage_time' | within (20m)

fetch iam_service_account
| metric 'iam.googleapis.com/service_account/authn_events_count'
| align rate(1m)
| every 1m | within (24h)

fetch bigquery_dataset
| metric 'bigquery.googleapis.com/storage/uploaded_bytes'
| align rate(1m)
| every 1m

fetch gce_instance
            | metric 'compute.googleapis.com/instance/cpu/usage_time'
            | filter (metadata.system_labels.name == '{{#.}}{{name}}{{/.}}')
            | align rate(1m)
            | every 1m

1. In the tile editor, filter by the GCP data source, select Monitor Metric from the data stream list and then click Next.
2. Select the objects that you want to use and then click Next.

   If you are selecting multiple objects, we suggest you only scope to objects of the same type. For example, the data will probably not be displayed in a helpful way if you were to select both Host objects and SQL objects in the same scope.

3. Metric Name:
   Select the desired metric from the dropdown. The dropdown options will automatically update depending on the object that you have scoped to. For example, scope to a Host and select CPU usage from the Metric Name dropdown.

Just like other services, Workflow is also supported by the GCP data source. You can monitor Workflow executions, execution times, and finished execution counts.

To set up a data stream for Workflow:

1. In the tile editor, filter by the GCP data source or select Workflow from the scope, then select your desired metrics (Workflow executions, Execution times, Finished execution count) from the list of data streams, and then click Next.
2. Select the Workflow you wish to scope to, then click Next.

The GCP data source also supports monitoring Builds from the Build Trigger service.

To set up a data stream for Build:

1. In the tile editor, filter by the GCP data source or select Build Trigger from the scope, then select Builds from the list of data streams, and then click Next.
2. Select the Build Trigger you wish to scope to, then click Next.

For PubSub service, you can monitor Publish requests, Publish message size, Oldest unacked message age, and Unacked messages.

To set up a data stream for PubSub:

1. In the tile editor, filter by the GCP data source or select Topic or Subscription from the scope (depending on what you want to monitor), then select your desired metrics from the list of data streams, and then click Next.
2. Select the Topic or Subscription you wish to scope to, then click Next.

Firestore databases can be queried for document data by specifying a Document Path to your.

1. In the tile editor, filter by the Google Cloud Platform data source or select Database from the scope.
2. Select Firestore Documents from the list of data streams, and then click Next.
3. Select the database you wish to scope to, then click Next.
4. Specify the Document Path to a document or a collection. The path should be relative to the database (i.e. not include the project or database name). For example mycollection or mycollection/mydoc.

Firestore databases can be queried for document data by specifying a Firestore query.

1. In the tile editor, filter by the Google Cloud Platform data source or select Database from the scope.
2. Select Firestore Structured Query from the list of data streams, and then click Next.
3. Select the database you wish to scope to, then click Next.
4. Enter the structured query JSON. For example:
   

   See the Firestore StructuredQuery schema documentation for detailed information on writing queries.

   Copy

   {
       "from": {
           "collectionId": "users"
       },
       "where": {
           "fieldFilter": {
               "field": {
                   "fieldPath": "firstName"
               },
               "op": "EQUAL",
               "value": {
                   "stringValue": "Jo"
               }
           }
       }
   }

Create BigQuery (Scoped) data stream

Code example:

{
  "name": "exampleScopedBigQuery",
  "dataSourceConfig": {
    "query": "SELECT project.name, service.description FROM `<project_id>.<data_set_name>.<table_name>` WHERE project.id in ('{{sourceId}}') GROUP BY 1,2 ORDER BY 1,2;"
  },
  "rowPath": [],
  "matches": {
    "sourceType.0": {
      "type": "oneOf",
      "values": [
        "GCP Project"
      ]
    }
  },
      "metadata": [
        { "name": "name", "displayName": "Project","shape": "string", "role": "label" },
        { "name": "description", "displayName": "Service", "shape": "string" },
      ]
}

Parameters

name	Mandatory The internal name of the data stream. Can be used the refer to this data stream in a tile's JSON instead of using the data stream's internal ID.
useTimeFrame	Optional You can add "useTimeFrame": true to the dataSourceConfig to use the dashboard timeframe, and inject @startDate and/or @endDate parameters into your query and these will be passed to the dashboard timeframe. For example: Copy { "name": "exampleBigQuery", "dataSourceConfig": { "useTimeFrame": true, "query": "SELECT <column_1> FROM `<project_id>.<data_set_name>.<table_name>` WHERE <dateColumn> BETWEEN @startDate AND @endDate" }, "rowPath": [], "matches": "none", "metadata": [] } What is the dashboard timeframe? The dashboard timeframe setting lets you choose the time span that a dashboard displays data for. For example, instead of showing data from the last 12 hours, you can choose to show data from the last 7 days. Tiles on a dashboard inherit that dashboard's timeframe by default, meaning that the tile data shown changes whenever you change the dashboard timeframe. However, you can instead choose to set a fixed timeframe for a tile via its timeframe setting. Fixed-timeframe tiles display their set timeframe in a bubble next to their title and the tile data does not change when the dashboard timeframe is changed. If all the tiles on a dashboard use a fixed timeframe then the timeframe dropdown is disabled. Likewise, if a specific timeframe is unsupported then it is disabled in the dropdown. You should indicate if a tile's timeframe can be changed in the name of a tile. For example, naming a tile Performance during the last week indicated that the tile always displays data for the last week. Setting a default timeframe To set the default timeframe for a dashboard, click the pin next to an option in the timeframe dropdown. This sets the initial timeframe for all viewers of the dashboard, including shared dashboards. Cache refresh intervals As well as determining the period for the data that displays, the dashboard timeframe also controls the cache refresh frequency of that data. In other words, the timeframe you pick also affects how "fresh" that data is. Dashboard timeframe Cache expiry 1 hour 1 minute 12 hours 5 minutes 24 hours 15 minutes 7 days 6 hours 30 days 12 hours Up to 6 months 24 hours Over 6 months 7 days
query	Mandatory Insert your query here. The query must be written all in one line. The query supports mustache parameters (in between curly braces e.g {{name}}). Mustache must refer to the property names of a GCP object that is the scope of the query. In the example we scope a query by GCP project. The query will execute for each object in the scope and return all results. What is a mustache parameter? A mustache parameter is a dynamic value, the actual value will be inserted to replace the field in curly braces. For example, {{timeframe.start}} will insert the start time based on the timeframe configured within the tile, or {{name}} will insert the name of the object(s) in scope. This data stream supplies scoped objects individually for mustache parameters. When there are multiple objects in scope this data source will send the query multiple times, once for each object. The results are then displayed together, for example in a single table. You can use properties of objects and write them in between curly braces e.g {{name}} to use them as mustache parameters. Whenever you use mustache parameters, you need to use a scope of objects that contain the property you're referencing. For example, if objects of type "host" have a property called name, you can use {{name}}. This will resolve {{name}} to the value of the name property of the different "host" objects used in the scope.
rowPath	Optional Depends on the data returned from your query. Enter the path to the row you want to use.
matches	Matches should be populated appropriately to the type of objects in the scope, that you want this data stream to work for. Note: Defining the matches parameter is mandatory. With the matches parameter you define for which objects the data stream will be shown in SquaredUp. It works like this: When you configure a tile, you have to choose its scope. If this scope contains objects you specified here in the matches parameter, the data stream will be shown in SquaredUp under Data Streams. If the scope doesn't contain objects specified here, the data stream will be hidden. This keeps things clean and simple since you'll only see the data stream when it's relevant for the scope you chose. As a best practice you should limit the data stream to objects that make sense for the specific use case of this data stream. Format for matches: Copy //If you want to specify only one value of an object property// "matches": { "ObjectProperty": { "type": "equals", "value": "ValueOfTheObjectProperty" } },   //If you want to specify multiple values for an object property// "matches": { "ObjectProperty": { "type": "oneOf", "values": ["ValueOfTheObjectProperty1", "ValueOfTheObjectProperty2", "ValueOfTheObjectProperty3"] } }, Example for limiting a data stream to objects: If you are using multiple values for the object property, you can decide if you want the data stream to be visible for objects that match all of the criteria or at least one of the criteria. Lets say you have two values you want objects to have in order for the data stream to be visible for them: a SourceName property with the value AppDynamics (meaning objects that come from the AppDynamics data source) a type property with the value app (meaning application objects) If you want the data stream to be visible only for objects that match both of the criteria, your code would look like this: Copy "matches": { "sourceName": { "type": "equals", "value": "AppDynamics" }, "type": { "type": "equals", "value": "app" } }, If you want the data stream to be visible for objects that match at least one of the criteria, your code would look like this: Copy "matches": [ { "sourceName": { "type": "equals", "value": "AppDynamics" } }, { "type": { "type": "equals", "value": "app" } } ] Note: If you run into errors when configuring the matches parameter, check if you're dealing with a global entry point. Data streams can be either global or scoped: Global data streams are unscoped and return information of a general nature (e.g. "Get the current number of unused hosts"). A scoped data stream gets information relevant to the specific set objects supplied in the tile scope (e.g. "Get the current session count for these hosts"). Identifying and configuring global entry points Global entry points can't use specific objects in the matches parameter. You can identify global entry points by their name, they have "Global", "No Scope" or "Unscoped" added to their name. There are two possible options for the matches parameter for global entry points: "matches": "none", When creating a tile, the Data Stream will be shown as long as no scope is selected. As soon as a scope is selected, the Data Stream will be hidden. "matches": "all", When creating a tile, the Data Stream will be shown as soon as any scope is selected.
metadata	Optional, but recommended The metadata parameters are used to describe columns in order to tell SquaredUp what to do with them. You can do multiple things with the metadata parameters: Specify how SquaredUp should interpret the columns you return and - to an extent - how their content displayed. You do this by giving each column a shape. The shape you assign to a column tells SquaredUp what the column contains (for example, a number, a date, a currency, a URL, etc.). Based on the shape SquaredUp decides how to display this column, for example to display a URL as a clickable link. Filter out or just hide columns. Only the columns you define in metadata will be returned in the results. This helps you to filter out columns you don't need. If you need the content of a column but don't want to display it, you can use the visible parameter. Give columns a nicely readable display name. Assign a specific role to columns . The role you assign to a column tells SquaredUp the purpose of the column. For example, if you have two different columns that contain numbers, you need to assign the role value to the column that contains the actual value you want to use in your visualization. If you don't specify any metadata, all columns will be returned and SquaredUp will do its best to determine which columns should be used for which purpose. If you're returning pretty simple data, for example just a string and a number, this can work fine. But if you're returning two columns with numbers it gets trickier for SquaredUp to figure out which one is the value and which one is just an ID or some other number. Parameters: Before you start specifying metadata, leave them empty at first and get all the raw data with your new data stream once. In order to do this, finish creating your custom data stream without metadata and create a tile with this data stream. The Table visualization will show you all raw data. This will give you an overview about all columns and their content and help you decide which columns you need and what their shapes and roles should be. It's also essential for getting the correct column name to reference in the name parameter. Use this information to go back to the data stream configuration and specifying the metadata. name Mandatory Enter the name of the column you are referencing here. To find the name of a column, get the data from this data stream once without any metadata. See the tip above for how to do that. You'll see the column name when you hover over the column in the Table. displayName Optional Here you can give the column a user-friendly name shape Recommended The shape you assign to a column tells SquaredUp what the column contains (for example, a number, a date, a currency, a URL, etc.). Based on the shape SquaredUp decides how to display this column, for example to display a URL as a clickable link. Note: Please refer to the list of shapes below this table to see available shapes. role Recommended The role you assign to a column tells SquaredUp the purpose of the column. For example, if you have two different columns that contain numbers, you need to assign the role value to the column that contains the actual value you want to use in your visualization. Note: Please refer to the list of roles below this table to see available roles. visible Optional true or false Use this if you need a columns content but don't need to display the column itself. Example: Column A contains the full link to a ticket in your ticket system. Column B contains the ticket ID. You want to use the ticket ID as a label for the link, turning the long URL into a much nicer to read "Ticket 123". This is why you need the content of column B, to assign it as a label for column A. But since the URL is now displayed as the ticket ID, it would be redundant to still display column B. This is why you hide column B with false. List of shapes There are many different shapes you can use for your columns and the list of possible shapes gets expanded constantly: Basic types, like: boolean, date, number, string Currency types that get displayed with two decimal values and their currency symbol (for example $23,45), like: currency (generic currency), eur, gbp, usd Data types, like: bytes, kilobytes, megabytes Time types, like: seconds, milliseconds, timespan The status type : state Utility types, like: customUniturl (will be displayed as a link) Tip: Some shapes can be configured. If a shape is configurable, you can edit how the shape displays data in SquaredUp. See Configurable shapes List of roles id Used by data streams feeding the aggregate health stream to identify their Id column label A column containing user-friendly names. Line Graphs use this role to group data into series. so each label will get its own line in the Line Graph. link A column containing a link that can be used as a drilldown in Status Blocks. timestamp A column containing a date to use on the X -axis of a Line Graph. unitLabel A column containing user-friendly labels for data series, e.g. ‘Duration’. Line Graphs can use this role to label the Y-axis. value A column containing the numeric value you want to use in your visualization.

Create a new tile on a dashboard with the following settings:

Data stream:

Cost

Objects:

Account(s) or Project(s)

Visualization:

Line Graph is good for showing data for dashboard timeframes of 7 or 30 days. A line will be shown for each service.

What is the dashboard timeframe?

The dashboard timeframe setting lets you choose the time span that a dashboard displays data for. For example, instead of showing data from the last 12 hours, you can choose to show data from the last 7 days.

Tiles on a dashboard inherit that dashboard's timeframe by default, meaning that the tile data shown changes whenever you change the dashboard timeframe. However, you can instead choose to set a fixed timeframe for a tile via its timeframe setting.

Fixed-timeframe tiles display their set timeframe in a bubble next to their title and the tile data does not change when the dashboard timeframe is changed.

If all the tiles on a dashboard use a fixed timeframe then the timeframe dropdown is disabled. Likewise, if a specific timeframe is unsupported then it is disabled in the dropdown.

You should indicate if a tile's timeframe can be changed in the name of a tile. For example, naming a tile Performance during the last week indicated that the tile always displays data for the last week.

Setting a default timeframe

To set the default timeframe for a dashboard, click the pin

next to an option in the timeframe dropdown. This sets the initial timeframe for all viewers of the dashboard, including shared dashboards.

Cache refresh intervals

As well as determining the period for the data that displays, the dashboard timeframe also controls the cache refresh frequency of that data. In other words, the timeframe you pick also affects how "fresh" that data is.

Dashboard timeframe	Cache expiry
1 hour	1 minute
12 hours	5 minutes
24 hours	15 minutes
7 days	6 hours
30 days	12 hours
Up to 6 months	24 hours
Over 6 months	7 days

When the dashboard timeframe covers more than one day the first column of a table shows the date. To only show each service once for the selected dashboard timeframe see Use Case: How much does each GCP service cost for a specific timeframe?.

Create a new tile on a dashboard with the following settings:

Data stream:

Cost

Objects:

Account(s) or Project(s) or Hosts

Shaping:

The following settings will show how much each service costs you in total for the account(s) or project(s) in scope for the whole timeframe selected:

Visualization:

Table, Donut or Bar Chart. Each bar or segment will show a service.

After you're done creating the tile, you can specify the timeframe by changing the dashboard timeframe to 7 or 30 days.

What is the dashboard timeframe?

The dashboard timeframe setting lets you choose the time span that a dashboard displays data for. For example, instead of showing data from the last 12 hours, you can choose to show data from the last 7 days.

Tiles on a dashboard inherit that dashboard's timeframe by default, meaning that the tile data shown changes whenever you change the dashboard timeframe. However, you can instead choose to set a fixed timeframe for a tile via its timeframe setting.

Fixed-timeframe tiles display their set timeframe in a bubble next to their title and the tile data does not change when the dashboard timeframe is changed.

If all the tiles on a dashboard use a fixed timeframe then the timeframe dropdown is disabled. Likewise, if a specific timeframe is unsupported then it is disabled in the dropdown.

You should indicate if a tile's timeframe can be changed in the name of a tile. For example, naming a tile Performance during the last week indicated that the tile always displays data for the last week.

Setting a default timeframe

To set the default timeframe for a dashboard, click the pin

next to an option in the timeframe dropdown. This sets the initial timeframe for all viewers of the dashboard, including shared dashboards.

Cache refresh intervals

As well as determining the period for the data that displays, the dashboard timeframe also controls the cache refresh frequency of that data. In other words, the timeframe you pick also affects how "fresh" that data is.

Dashboard timeframe	Cache expiry
1 hour	1 minute
12 hours	5 minutes
24 hours	15 minutes
7 days	6 hours
30 days	12 hours
Up to 6 months	24 hours
Over 6 months	7 days

Create a new tile on a dashboard with the following settings:

Data stream:

Cost

Objects:

Hosts

Shaping:

The following settings will show how much each service costs you in total for the account(s) or project(s) in scope for the whole timeframe selected:

Visualization:

Table, Donut or Bar Chart. If, for example, you've scoped to Hosts, then each bar will be the cost for one host.

After you're done creating the tile, you can specify the timeframe by changing the dashboard timeframe to 7 or 30 days.

What is the dashboard timeframe?

The dashboard timeframe setting lets you choose the time span that a dashboard displays data for. For example, instead of showing data from the last 12 hours, you can choose to show data from the last 7 days.

Tiles on a dashboard inherit that dashboard's timeframe by default, meaning that the tile data shown changes whenever you change the dashboard timeframe. However, you can instead choose to set a fixed timeframe for a tile via its timeframe setting.

Fixed-timeframe tiles display their set timeframe in a bubble next to their title and the tile data does not change when the dashboard timeframe is changed.

If all the tiles on a dashboard use a fixed timeframe then the timeframe dropdown is disabled. Likewise, if a specific timeframe is unsupported then it is disabled in the dropdown.

You should indicate if a tile's timeframe can be changed in the name of a tile. For example, naming a tile Performance during the last week indicated that the tile always displays data for the last week.

Setting a default timeframe

To set the default timeframe for a dashboard, click the pin

next to an option in the timeframe dropdown. This sets the initial timeframe for all viewers of the dashboard, including shared dashboards.

Cache refresh intervals

As well as determining the period for the data that displays, the dashboard timeframe also controls the cache refresh frequency of that data. In other words, the timeframe you pick also affects how "fresh" that data is.

Dashboard timeframe	Cache expiry
1 hour	1 minute
12 hours	5 minutes
24 hours	15 minutes
7 days	6 hours
30 days	12 hours
Up to 6 months	24 hours
Over 6 months	7 days

Create a new tile on a dashboard with the following settings:

Data stream:

Cost

Objects:

Account(s)

Shaping:

The following settings will show how much all the service cost you in total for the accounts in scope for the whole timeframe selected:

Visualization:

If you only have one account in the scope you can choose Scalar, as you only want to see one number (total cost for all services).

If you have several accounts in the scope you can choose Table, to see the cost per account.

After you're done creating the tile, you can specify the timeframe by changing the dashboard timeframe to 7 or 30 days.

What is the dashboard timeframe?

The dashboard timeframe setting lets you choose the time span that a dashboard displays data for. For example, instead of showing data from the last 12 hours, you can choose to show data from the last 7 days.

Tiles on a dashboard inherit that dashboard's timeframe by default, meaning that the tile data shown changes whenever you change the dashboard timeframe. However, you can instead choose to set a fixed timeframe for a tile via its timeframe setting.

Fixed-timeframe tiles display their set timeframe in a bubble next to their title and the tile data does not change when the dashboard timeframe is changed.

If all the tiles on a dashboard use a fixed timeframe then the timeframe dropdown is disabled. Likewise, if a specific timeframe is unsupported then it is disabled in the dropdown.

You should indicate if a tile's timeframe can be changed in the name of a tile. For example, naming a tile Performance during the last week indicated that the tile always displays data for the last week.

Setting a default timeframe

To set the default timeframe for a dashboard, click the pin

next to an option in the timeframe dropdown. This sets the initial timeframe for all viewers of the dashboard, including shared dashboards.

Cache refresh intervals

As well as determining the period for the data that displays, the dashboard timeframe also controls the cache refresh frequency of that data. In other words, the timeframe you pick also affects how "fresh" that data is.

Dashboard timeframe	Cache expiry
1 hour	1 minute
12 hours	5 minutes
24 hours	15 minutes
7 days	6 hours
30 days	12 hours
Up to 6 months	24 hours
Over 6 months	7 days