Remote Command to Trigger AppleCare Log Collection - Jamf Pro Release Notes 11.29.0

Jamf Pro Release Notes 11.29.0

Solution
Application
Content Type
Technical Documentation
Release Notes
Utilities & Services
version
11.29.0
ft:locale
en-US
vrm_version
11.29.0

You can use the Jamf Pro API to remotely request diagnostic logs (sysdiagnose logs) from managed devices. This is useful for working with AppleCare to troubleshoot situations that require detailed logging.* When you report a problem to AppleCare, they may ask you to run enhanced log collection on the device. AppleCare will then give you a token to be used with the TriggerEnhancedLogCollection command that can be sent to the device to trigger the process.

Requirements

  • The "Send MDM command information in Jamf Pro API" permission in Jamf Pro

  • A target device with iOS 27, iPadOS 27, macOS 27, or tvOS 27 (all currently in beta)

  • An AppleCare for Enterprise agreement (for testing this feature during the beta)

    For more information, see the following Apple documentation:

    https://www.apple.com/support/professional/enterprise/

To test out requesting diagnostic logs for a managed device, send a request to the Jamf Pro API similar to the following:

curl -X 'POST' \
  'https://<jamf-pro-server-url>/api/v2/mdm/commands' \
  -H 'accept: application/json' \
  -H "Authorization: Bearer <token>" \
  -H 'Content-Type: application/json' \
  -d '{
  "clientData": [
    {
      "managementId": "<device-management-ID>",
    }
  ],
  "commandData": {
    "commandType": "TRIGGER_ENHANCED_LOG_COLLECTION",
    "appleCareToken": "test-token-normal"
  }
}'
Note:
  • Replace <jamf-pro-server-url> in the above example with your Jamf Pro server URL.

  • Replace <token> in the above example with your Jamf Pro API bearer token string.

  • Replace <device-management-ID> in the above example with the Jamf Pro Management ID of the target device (found in the inventory record of that device in the General category).

  • During beta, you can use the test-token-normal string to simulate an interactive enhanced log collection session trigger. When this feature is generally available, you will use a token value from your AppleCare ticket instead. For more information, see the following developer documentation from Apple:

    https://developer.apple.com/documentation/devicemanagement/trigger-enhanced-log-collection-command

Jamf Pro sends a command to the target device to begin a logging session. After the session completes, the collected logs are sent to Apple.

*Feature support is based on testing with the latest Apple beta releases.