- Getting started
- Best practices
- Tenant
- About the Tenant Context
- Searching for Resources in a Tenant
- Managing Robots
- Connecting Robots to Orchestrator
- Storing Robot Credentials in CyberArk
- Storing Unattended Robot Passwords in Azure Key Vault (read only)
- Storing Unattended Robot Credentials in HashiCorp Vault (read only)
- Storing Unattended Robot Credentials in AWS Secrets Manager (read only)
- Deleting Disconnected and Unresponsive Unattended Sessions
- Robot Authentication
- Robot Authentication With Client Credentials
- Configuring automation capabilities
- Solutions
- Audit
- Enforced encryption
- Settings
- Registry
- Notifications
- Folders Context
- Processes
- Jobs
- Apps
- Triggers
- Logs
- Monitoring
- Indexes
- Queues
- Assets
- Connections
- Business Rules
- Storage Buckets
- Agent Gateway
- Orchestrator testing
- Resource Catalog Service
- Integrations
- Troubleshooting
Trigger details
View trigger details including associated jobs and failure history from the trigger side panel.
Selecting a trigger from the list opens a side panel with detailed information about that trigger, organized into the following tabs:
- Jobs: the list of jobs started by the trigger.
- History: the list of all instances where an Event trigger matched a record and attempted to launch an Orchestrator job.
- Traces: details about events received either through polling or webhook execution, as well as events that matched the selected trigger.
Note:
The Traces tab is only available for event triggers.
Jobs tab
To access the jobs started by a trigger:
- Navigate to the Triggers page.
- Choose the corresponding trigger tab.
- Select the relevant trigger from the list.
- Navigate to the Jobs tab to display the list of all jobs started by the selected trigger.
Note:
You can use the Go to Audit button to navigate to the Audit page and check detailed information for each event. For more information, check the Audit page.
The table contains the following details for each job:
- State: the current state of the job. For more information, check the Job States page.
- Started: the timestamp when the job was started.
- Ended: the timestamp when the job ended.
- Duration: the total time the job run.
History
This section tracks all instances where an Event trigger matched a record and attempted to launch an Orchestrator job.
To access it:
- Navigate to the Triggers page.
- Choose the corresponding trigger tab.
- Select the More Actions button
- Choose View history from the drop-down list.
Tip:
You can also select the needed trigger from the list and navigate to the History tab from the side panel.
Trigger history is deleted when the trigger itself is deleted. Additionally, trigger history is retained for 30 days before it is automatically removed.
You can use the Go to Audit button to navigate to the Audit page and check detailed information for each event. For more information, check the Audit page.
The table contains the following details for each trigger:
- Time: shows when the event trigger initiated the job creation.
- Event Name: displays the name of the specific trigger.
- Status: indicates whether the job successfully started.
- Details: provides the failure reason for Failed entries; remains blank for successful jobs.
Potential error types
Check the following list of potential failure types and their description:
Missing license
Description: a valid license is required to start jobs.
Solution: to continue running jobs, make sure that you have a valid license.
Expired license
Description: the license has expired.
Solution: to continue running jobs, you need to renew your license.
Disabled - job failures
Description: the trigger was disabled due to at least two consecutive job failures.
Solution: you can configure this setting using the Disable when consecutive job execution fail count option when creating or editing a trigger.
Disabled - consecutive failures
Description: the trigger was disabled after failing to create jobs a specified number of times within a defined number of days.
Solution: by default, this occurs after 10 failures in 1 day. You can configure this threshold by using the Triggers - Disable when job creation fail count and Triggers - Grace period when job creation keeps failing count (days) fields in conjuction from the Tenant Settings page. For more information, check the Settings page.
Pending jobs
Description: there are already pending jobs.
Solution: make sure that the process execution is not faulty, causing the job to remain in the pending state. You can also review the list of pending jobs and reduce the number of jobs if needed. For more information, check the Managing Jobs page.
Trigger error
Description: the trigger failed to create jobs.
Partial job creation
Description: only some jobs out of the total number of requested ones were created because there were already some pending jobs.
Solution: make sure that the process execution is not faulty, causing the job to remain in the pending state. You can also review the list of pending jobs and reduce the number of jobs if needed. For more information, check the Managing Jobs page.
Test job not supported
Description: test automation jobs are not supported through standard jobs APIs.
Robot not found
Description: no robot was found in the folder to run this job.
Solution: make sure that a robot is provisioned in the target folder. For more information on how to create a setup that allows you to execute jobs in folders, check the Managing Robots page.
Unattended robot not found
Description: no user with an unattended robot was found.
Solution: make sure that a robot is assigned to a user in the folder. For more information on how to assign a robot, check the Managing Robots page.
Trigger disabled
Description: the trigger is not enabled.
Solution: select the More Actions button on the corresponding trigger, and then Enable. An enabled time trigger is marked by the
icon in front of it. An enabled queue trigger is marked by the
in front of it.
No robot for user
Description: the user does not have a robot to trigger the event.
Solution: assign a robot to the user in the appropriate folder.
Process not found
Description: the process associated with the job could not be found.
Solution
- Check if the process is published.
- Check if the process is created. If the process exists as a package, you need to create a corresponding process within Orchestrator
- Check if the robot is connected and available in Orchestrator.
No machine available
Description: no compatible machine with runtimes was found.
Solution: make sure that:
- Machines are not busy.
- Machines have required licenses.
- Machines are properly configured for the job.
User has no robot
Description: the user does not have an assigned unattended robot.
Solution: assign an unattended robot to the user. For more information on how to assign a robot, check the Managing Robots page.
Missing robot credentials
Description: missing credentials for the unattended robot.
Solution: add credentials depending on the chosen authentication method. For more information on how robot credentials work, check the Robot Authentication With Client Credentials page.
Callback not enabled
Description: the trigger requires a callback that is not enabled.
Solution: go to the API trigger and enable the callback.
Bad trigger config
Description: requests using the HTTP GET method cannot include a Content-Type header of type form or json.
Solution: adjust the trigger configuration to comply with HTTP method standards.
Traces
The information displayed in the Traces tab is available only for the most recent version of the trigger. When you edit a trigger, the traces available for the previous version will no longer be visible in the Traces tab.
The Traces tab provides visibility into polling executions or webhook events received for an event trigger, including details about retrieved events and which of them matched the trigger filter criteria.
To access polling or webhook execution details and event information:
This tab is only available for Event triggers.
- Navigate to your Automation.
- Select Triggers.
- Choose the Event Triggers tab.
- Select the Event Trigger.
The side panel is displayed with the Jobs, History, and Traces tabs.
The Traces grid displays a chronological list of trigger execution records.
- For polling triggers, each entry represents a poller execution.
- For webhook triggers, each entry represents a webhook event received.
Each entry includes the execution start time and its outcome, allowing you to review trigger activity for a specific time.
Traces details
When you select a trace entry, a Details panel is displayed on the right-hand side, with information grouped into Event Data and Correlated Jobs.
Event Data
Trigger Details — the following information is available:
- traceId: a unique identifier for the trigger execution attempt.
- triggerId: a unique identifier for the trigger.
- timestamp: the date and time when the polling execution or webhook event occurred.
- name: the name of the trigger.
- eventType: the type of event that initiated the trigger (for example,
FILE_CREATED). - objectName: the record type the trigger is configured for, for example a contact or account.
- filterExpression: the filter expression applied to the event, as configured for the trigger.
- inputArguments: the input arguments of the package.
- connectionId: a unique identifier of the connection the trigger belongs to.
- processKey: a unique identifier of the process.
Response — contains the payload received from the provider, including information about the payload body and query parameters.
Filter Result — shows what data matched or did not match based on any data filter configured on the trigger.
Only the fields that are part of the filter are shown, not the entire payload.
Correlated Jobs
This section displays information about the jobs the trigger started, with links to navigate to them.
There can be more than one job in this section because one poller run can grab many events, and each matched event starts a new job in Orchestrator.