The Cyclr Console offers several reporting options. These can be found under the “Reports” tab in the Console Menu, with only a few exceptions.
The majority of reports can be exported as CSV files using the “Export Report as CSV” button, which is located in the top-right corner of each report page.
For most reports, the default page range is set to 10 items per page. This can be changed from the drop-down menu at the bottom of the page to 20, 50, or 100 per page.
Task Usage & Task History Report #
The Task Usage report is available on the Dashboard of the Partner Console. It provides an overview of the total number of used and remaining tasks for the current billing period. It helps monitor usage and assessing whether your current task allowance is sufficient.
A visual indicator is displayed next to the Task Usage Report on the Dashboard, to visualize the used percentage of the monthly task allowance.
The “View Task History” button navigates to the Task History Report. This report provides historical task usage data for previous billing periods. The report includes start and end dates for each period, as well as the count of successful and incident tasks.
It is important to note that this report shows a tally of all tasks in the billing period, and it’s not differentiated by accounts or connectors.
For further details on the task usage on a specific account, refer to the Account Task History report.
What is a “Task”?
Usage within Cyclr is logged when API calls are made to external systems or data is processed on a Step within an integration. These activities are recorded as “Tasks”.
- If an action is successful, a “Successful Task” is recorded. This is typically indicated by Cyclr receiving an HTTP 2xx Status Code when making an API call.
- If an action is unsuccessful or results in an error, an “Incident Task” is recorded. This is typically identified by an HTTP 4xx or 5xx Status Code.
- Steps categorized as “Tools,” such as Decisions and Delays, do not utilize Tasks.
Each Partner Console has a Monthly Task Allowance defined by the Cyclr pricing plan. If this allowance is exceeded, additional charges may apply.
Account Report #
The Account Report provides a count of active Cycles and Connectors in Accounts. Cycles are considered active if they are currently running or were paused within the last 24 hours.
Find the Account report by navigating to Reports > Account Report on the Console Menu.
At the top of the report, there are counters that display:
- Total Active Connectors
- Total Active Cycles
- Total Active Accounts
Below the counters, the complete report is presented. This report lists all Accounts, ordered by the number of Active Cycles within each Account. The report includes:
- Account Name
- Number of Active Cycles
- Number of Active Connectors
- Number of Custom Connectors
Account Connector Method Report #
The Account Connector Method Report displays all Connectors and Methods used in Accounts, providing an overview of which Connectors and Methods are being utilized.
Find it by navigating to Reports > Account Connector Method Report.
It includes a list of all Accounts in alphabetical order, with two associated columns:
- Connectors: A list of installed Connectors per Account
- Methods: A list of Connector Methods used in Cycles on the Account
Account Task Report #
The Account Task Report presents daily task and incident metrics per Account.
It can be accessed by navigating to Reports > Account Task Report.
The report presents a grouped column chart that visualizes the number of successful tasks (blue columns) and incident tasks (red columns) per Account.
By default, the chart displays the first 10 Accounts listed in the report. To view a specific Account, use the search field above the chart. The chart can also be expanded by scrolling down and selecting how many Accounts should be displayed per page (10, 20, 50, or 100).
The default Report Date is always the current date, but it can be adjusted from the “Report Date” drop-down menu above the chart. The report can display data up to 30 days in the past, but only one day can be viewed at a time.
A detailed report is provided below the chart, including the following columns:
| Column Name | Description |
|---|---|
| Account | Name of the Account |
| Last Task | Shows you how long it has been since the latest task on the Account |
| Total Tasks | Number of tasks on the Account for the report date |
| 30-Day AVG | The Account’s average daily task usage based on the last 30 days. |
| Deviation | Difference between the report date’s task usage and the average daily task usage. You can use this to spot changes in activity within an Account. |
| Incident Tasks | Number of Incident tasks on the Account for the report date |
| Rate | Report date’s incident rate (percentage of incident tasks from the total number of tasks) |
| 30-Day AVG | Average incident rate from the last 30 days |
| Deviation | Difference between the report date’s incident rate and the average incident rate |
The report and the chart can be sorted by clicking on the column headers.
Shortcuts to the “Cycle Task Report” and “Task History & Incident Report” are available within the last column of the table.
Cycle Task Report #
The Cycle Task Report presents daily task and incident metrics per Cycle.
It can be accessed by navigating to Reports > Cycle Task Report, or via the associated button in the Account Task Report.
Similar to the Account Task Report, the Cycle Task Report opens with a grouped column chart displaying the number of successful tasks (blue columns) and incident tasks (red columns) per Cycle for the selected day.
The default date for this report is always the current date but can be adjusted using the “Report Date” drop-down menu. Data can be viewed for up to 30 days in the past, but only one day at a time.
The chart range is set to 10 Cycles per page by default. To display more Cycles, the number of Cycles per page can be adjusted (10, 20, 50, or 100). A specific Cycle can also be located using the search field above the chart.
Below the chart, the full report is displayed, providing details on Total Tasks and Incident Tasks. Sorting options are available by clicking on the column headers.
The report includes the following columns:
| Column Name | Description |
|---|---|
| Cycle | Cycle Name |
| Account | Name of the Account where the Cycle can be found |
| Last Run | How long it has been since the Cycle’s Last Successful Runtime |
| Total Tasks | Number of tasks used by the Cycle on the report date |
| 30-day AVG | The Cycle’s average daily task usage from the past 30 days |
| Deviation | Difference between the total tasks and the daily average |
| Incident Tasks | Number of incident tasks in the Cycle on the report date |
| Rate | Incident rate on the report date (percentage of incidents out of total number of tasks) |
| 30-day AVG | Average incident rate from the last 30 days |
| Deviation | Difference between the report date’s incident rate and the average incident rate |
Shortcuts to the “Task & Incident History Report” and to jump straight to the Cycle itself are available in the last column of the report.
Task & Incident History Report #
The Task & Incident History Report provides historical task and incident metrics for an individual Account or Cycle.
The report can be accessed via the Account Task Report or the Cycle Task Report by selecting the “clock icon” next to the appropriate Account or Cycle.
A grouped column chart displays successful and incident tasks per day for the last 30 days.
Below the chart, a list of the last 30 days is shown, detailing:
- Date
- Total Tasks
- Successful Tasks
- Incident Tasks
Connector Report #
The Connector Report presents Connector usage across all Accounts. It provides insights into how customers are using the product and which integrations are most frequently utilized.
It can be accessed by navigating to Reports > Connector Report.
The report is displayed as a list of all installed Connectors, ordered by the number of Active Installations.
The list includes:
- Connector Name
- Version (if applicable)
- Total number of Installations
- Total number of Active Installations
Installations refer to the total number of installed instances of a Connector, while Active Installations indicate the number of instances currently in use. An Account Connector is considered “Active” if it has been used in a Cycle that has run within the last 24 hours or has been used via the Cyclr API within the past two days.
Custom Connectors are indicated with a blue flag, making it easier to spot them in the report.
API Report #
The API Report presents the number of Requests made to the Cyclr API using credentials from the Partner Console.
It can be accessed by navigating to Reports > API Report.
The report is presented as a line chart displaying the number of API calls over the last 7 days, along with a tally that provides an overview of:
- Number of successful API calls
- Number of failed API calls
- Average runtime per API call
Below the chart, a list of API calls from the past 7 days is displayed with further details on each API call, including:
- Timestamp
- Source IP
- HTTP Method
- Endpoint
- Status Code
- Runtime
Audit Log #
The Audit Log records events that have occurred in the last 30 days, including Console logins, Account logins, and Cycle activation/deactivation.
It can be accessed by navigating to Reports > Audit Log.
The log includes:
- Timestamp
- Entity where the event occurred
- Event description
- User ID
- IP Address of the event initiator
