Checks
How to Use the Ascent Checks Data Source to Query Checks
Last updated
Was this helpful?
How to Use the Ascent Checks Data Source to Query Checks
Last updated
Was this helpful?
Navigate to the queries page in your dashboard to begin
In the Queries page, click on the "New Query" button to start a new query
On the left sidebar, click on Ascent Checks. This will display a list of all available checks that you can query.
From the list, expand the check you want to query by clicking on it. This will show more details about the check.
Click on the right arrow next to the check id to append it to the query editor
To use a specific time range, enter the start and end times as Unix epoch values.
To query relative durations, use the duration option with a human-readable format (e.g., 1d for one day, 2h for two hours, etc.)
Example:
Start: 1609459200 (Unix epoch for the start time)
End: 1609545600 (Unix epoch for the end time)
Duration: 1d (relative to the current time)
Once your query is complete, click on Execute to run the query and see the results.
The query for the Ascent Checks Data Source is written in YAML format. The following options are supported:
check_id (Mandatory):
The check_id refers to the checkguid of the check. You can find this in the sidebar when expanding a check.
start (mandatory if no duration): The start time, provided as a Unix epoch value, defines the beginning of the time range for your query.
end (mandatory if no duration): The end time, also in Unix epoch format, defines the end of the time range for your query.
duration (mandatory if no start/end): A human-readable format for relative durations. It supports the following units:
s for seconds
m for minutes
h for hours
d for days
Example: 2d for two days ago, 1h for one hour ago.
limit(optional): The limit option allows you to specify the maximum number of check results to retrieve. This helps to control the size of the query results.
By default, results are sorted by time in descending chronological order.
