Built-in Plugin Logs

View as Markdown

What Are Built-in Plugin Logs?

Built-in plugin logs provide a unified view of all log entries generated by Moveworks built-in plugins. These logs capture both the external API calls made to your integrated systems and the internal workflow execution steps that occur during plugin runs.

This page combines two types of logs:

  • External API call logs — Records of each HTTP API call that Moveworks makes to your external systems (for example, creating a ticket or provisioning software access).
  • Workflow execution logs — Records of internal workflow steps such as identifying the correct workflow, executing actions, and processing results.

Built-in plugin logs only capture activity for built-in plugins. To track API calls made during Agent Studio plugin runs, use the Agent Studio logs.

How Does Moveworks Call Your External Systems?

Moveworks calls your external systems through REST API calls and passes the relevant information in the API request body and headers. These API calls are embedded into the Moveworks AI assistant workflows. Moveworks uses the configured connector for the relevant plugin and then calls the external system endpoints.

When Are Built-in Plugin Logs Recorded?

Whenever a built-in plugin executes, log entries are recorded for each step of the workflow and each external API call. The SLA for these logs is near-instant — as soon as the execution completes, the log entries are captured.

Where Are Built-in Plugin Logs Located?

You can find the Built-in Plugin Logs page in Moveworks Setup at Moveworks Setup → Organizational Details → Audit → Built-in Plugin Logs.

Built-in Plugin Logs table showing log entries with filters, log level, timestamp, trace ID, log type, plugin name, requestor, and summary columns

Data capture and retention
  • 1. The data recorded in this tool is captured on an ongoing, forward-looking basis — once enabled, Moveworks captures data for all subsequent plugin executions. Historical data is not backfilled.
  • 2. Logs within this view are retained and visible for one (1) week on a rolling basis. Logs older than one week are removed.

Understanding the Log Table

Table Columns

Each log entry in the table contains the following columns:

ColumnDescription
Log LevelSeverity level of the log entry. Possible values: Error (indicates a failure) and Info (indicates a successful or informational event).
TimestampThe date and time when the log entry was recorded, displayed in your local timezone.
Trace IDA unique identifier that groups all log entries belonging to the same plugin execution. Use this to correlate related logs across a single request.
Log TypeThe category of the log entry. Common values include action.http.trigger (an external API call) and service_log.ticket_gateway.* entries (internal workflow steps).
Plugin NameThe built-in plugin that generated the log entry (for example, “Add Comment to Ticket”, “Grant Software Access”, or “Create Ticket”).
RequestorThe email address of the user whose action triggered the plugin execution.
SummaryA human-readable description of what happened (for example, “HTTP request executed” or “Ticket workflow generate ticket executed”).

Log Detail Panel

Click any row in the table to open the About this Log detail panel on the right side. This panel displays the full details of the selected log entry, including request and response data when available.

The detail panel for an Error log entry shows the error summary and the full log body:

About this Log detail panel for an error log entry, showing log level, trace ID, log type, plugin name, summary with error message, and JSON log body

The detail panel for an Info log entry shows the successful execution details, including the HTTP status code:

About this Log detail panel for an info log entry, showing log level, trace ID, log type, plugin name, summary, status code 201, and JSON log body

Filters

You can narrow down the log entries using the following filters at the top of the page:

FilterDescription
Time rangeSelect the time window for logs. Defaults to Last 6 hours.
Log LevelFilter by severity (Error or Info).
Trace IDSearch for a specific Trace ID to view all logs from a single plugin execution.
Log TypeFilter by log type (for example, action.http.trigger or service_log.ticket_gateway.execute).
PluginFilter by the built-in plugin name.
RequestorFilter by the email of the user who triggered the action.
API MethodFilter by HTTP method (GET, POST, PUT, etc.).
API Status CodeFilter by HTTP response status code (for example, 200, 201, 400).

Understanding Log Types

Built-in plugin logs contain two families of log types:

External API Call Logs

Log entries with the type action.http.trigger represent HTTP API calls that Moveworks made to your external systems. These logs capture the request and response details for each API call.

Workflow Execution Logs

Log entries with types prefixed by service_log.* represent internal workflow execution steps. These include:

  • service_log.ticket_gateway.execute — The overall execution result of a ticket gateway workflow.
  • service_log.ticket_gateway.workflow_identifier_step — Identifies which workflow to use for the request.
  • service_log.ticket_gateway.workflow_actions_step — Identifies the workflow actions to execute.
  • service_log.ticket_gateway.action_trigger — Records the execution of a specific workflow action (for example, GENERATE_TICKET).

What Events Are Captured?

Built-in plugin logs capture activity across eight major categories of built-in plugins. Each category contains individual plugins that are recorded in the Plugin Name column. For a full list of built-in plugins, refer to the Capabilities page.

  1. Ticketing — Filing, resolving, reopening, and commenting on tickets.
  2. Live Agent — Connection requests and live agent session termination.
  3. Approvals — End-user updates to approval records.
  4. Group Operations — Creating groups, adding members, and removing members.
  5. Account Operations — Password updates and account unlocks.
  6. Software Operations — Software provisioning attempts.
  7. System — Internal Moveworks calls for purposes like connector validation. This is the default fallback if a plugin is not identified.
  8. Enterprise Search and Forms — API calls routed to the ticket service for ticket-related information. This does not include ingestion logs — only ticketing-related use cases are captured.
Ingestion API calls

This view does not capture ingestion logs. Only end-user-driven actions generate log entries.

Multiple log entries per action

A single user action may generate multiple log entries — this is expected. Moveworks plugins can invoke the same API more than once depending on how a workflow is implemented, and the system automatically retries calls on intermittent failures. This tool surfaces logs as-is, without filtering or aggregation.

Authentication API calls

Built-in plugin logs do not capture API calls related to authentication. This is a security measure to prevent credentials or passwords from being exposed to administrators.

Example: Debugging a Failed Plugin Execution

The primary purpose of built-in plugin logs is to track whether plugin executions and their associated API calls succeed. If a failure occurs, you can use these logs to identify the root cause and determine the configuration changes required to resolve the issue.

Scenario: Investigating a Failed Ticket Comment

Suppose a user reports that adding a comment to a ticket failed. You can use the built-in plugin logs to investigate.

  1. Navigate to Moveworks Setup → Organizational Details → Audit → Built-in Plugin Logs.
  2. Apply the following filters:
    • Requestor: The email of the user who reported the issue
    • Plugin: Add Comment to Ticket
    • Log Level: Error
  3. Review the matching log entries. Look at the Summary column for error details such as “Ticket missing in response — Unable to fetch ticket; requestor does not have access to any integration.”
  4. Use the Trace ID to find all related log entries for that execution. This helps you see the full sequence of events, including which workflow was identified and which API calls were attempted.
  5. Click on a log row to open the About this Log detail panel for the full request and response details.

Understanding Multiple Log Entries

During a plugin execution, Moveworks may generate several log entries. For example, a “Grant Software Access” request might produce:

  • A service_log.ticket_gateway.workflow_identifier_step entry showing which workflow was selected
  • A service_log.ticket_gateway.workflow_actions_step entry showing the identified actions
  • Multiple action.http.trigger entries for each API call made to the external system
  • A service_log.ticket_gateway.execute entry showing the final execution result

If you see Error entries for action.http.trigger logs followed by additional retries, this indicates Moveworks automatically retried the API call. Check the final service_log.ticket_gateway.execute entry to determine the overall outcome.

Governance and Access Control

Built-in plugin logs may include sensitive data such as API request and response bodies. Access to this data is governed through the PII Viewer role in Moveworks Setup.

Full Access

Users with the following roles can view complete log details, including unredacted request and response data:

  • Super Admin
  • Moveworks Setup Admin
  • Users assigned the PII Viewer role

These users can view:

  • API URLs
  • Request parameters
  • Request and response bodies

Restricted Access

Users without the PII Viewer permission can still access the Built-in Plugin Logs interface. However, sensitive information is redacted.

These users cannot view:

  • Request details
  • Query parameters
  • Request bodies
  • Other sensitive data included in API requests

This governance model ensures that sensitive information is only accessible to authorized users while still allowing others to monitor system activity.

How to provision PII Viewer role

Only Super Admins can provision the PII Viewer role. Within the Roles and Permissions app, Super Admins can assign the Moveworks Setup PII Role Viewer role to the intended users.

Reach out to your Super Admin if you need view access to unredacted log details.