NinjaOne icon

NinjaOne

Consume NinjaOne API

Actions158

Queries → Get Processors

AI-generated

Overview

This node interacts with the NinjaOne API to retrieve information about processors (CPUs) from monitored devices. Specifically, the "Get Processors" operation under the "Queries" resource fetches processor data filtered by device, timestamp, pagination cursor, and page size.

Use cases include:

  • Monitoring CPU details across devices in an IT environment.
  • Fetching historical or current processor metrics for reporting or alerting.
  • Paginating through large sets of processor records for analysis.

For example, you might use this node to get all processors active on a specific device at a given monitoring timestamp, limiting results to 50 per page.

Properties

Name Meaning
Df Device filter: Specify a device identifier to filter processors belonging to that device.
Ts Monitoring timestamp filter: Filter processors based on a specific monitoring timestamp.
Cursor Cursor name: Used for paginating through results, indicating the position in the dataset.
Page Size Limit number of records per page: Controls how many processor records are returned per request.

Output

The node outputs JSON data representing the response from the NinjaOne API for the processors query. The structure typically includes an array of processor objects with their attributes (e.g., model, speed, cores), along with pagination metadata if applicable.

No binary data output is produced by this operation.

Dependencies

  • Requires an OAuth2 API credential configured for NinjaOne to authenticate requests.
  • Depends on the NinjaOne API being accessible and the user having appropriate permissions to query processor data.

Troubleshooting

  • Common issues:

    • Missing or invalid API credentials will cause authentication failures.
    • Incorrect device filter or timestamp format may result in empty responses or errors.
    • Pagination cursors must be used correctly; invalid cursors can cause errors or no data returned.
  • Error messages:

    • Authentication errors indicate problems with the API key/token setup.
    • Validation errors may occur if input parameters do not meet expected formats.
    • Network or API downtime errors require checking NinjaOne service status.

To resolve these, verify credentials, ensure correct parameter formatting, and confirm NinjaOne API availability.

Links and References

Discussion