Read log files in Apple Business Essentials
Apple Business Essentials maintains a log of all activities you perform. These log files are an important source of troubleshooting in case an activity fails to complete successfully. If an activity fails to complete, review the log file, locate and correct the error, and then attempt the activity again.
Activity | Log file message |
|---|---|
Create sign-in information. | Generates a .csv or PDF or send a mail message with sign-in information. |
Assign a role to a location. | Adds a role and location to an account. |
Edit a Managed Apple Account. | Edits an account’s Managed Apple Account. |
Delete an account. | Deletes an account. |
Deactivate an account. | Deactivates an account. |
Reactivate an account. | Reactivates an account. |
Assign devices to a device management service. | Assigns the selected devices to a device management service. |
Reassign and delete service. | Reassigns and deletes the selected device management service. |
Unassign devices from a device management service. | Unassigns the selected devices from a device management service. |
Unassign and delete service. | Unassigns and deletes the selected device management service. |
Release devices. | Releases the selected devices. |
Read a log file
In Apple Business Essentials, sign in with a user who has privileges to read log files.
Select Activity
in the sidebar.In the list that opens, search for the category and event you want and then select it. See How to search.
Select Download Logs, then locate the file in the folder used by your web browser to download files, then open the file and locate the error.
Log errors
In Apple Business Essentials, you can read log files to learn what’s been completed and to spot errors. If an activity completes successfully, Apple Business Essentials generates the log message UPDATED. If an activity fails to complete, the log file generates messages to help you understand how to correct the error. Below are the log messages, along with their classification, description, and associated activity. Search for these messages in the log file when an activity fails.
Log Message | Classification and Description | Associated activity | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
NOT_ENOUGH_PRIVILEGE | Classification: WARNING Description: No privilege | Create sign-in information. Assign a role and location to an account. Delete an account. Deactivate an account. Reactivate an account. Edit a Managed Apple Account. | |||||||||
OPERATION_NOT_ALLOWED | Classification: WARNING Description: Active account | Delete an account. Reactivate an account. | |||||||||
OPERATION_NOT_ALLOWED | Classification: WARNING Description: New and synced account | Delete an account. | |||||||||
OPERATION_NOT_ALLOWED | Classification: WARNING Description: Inactive account | Create sign-in information. Assign a role to a location. | |||||||||
NOT_FOUND | Classification: WARNING Description: Deleted or claimed account | Create sign-in information. Assign a role to a location. Delete an account. Deactivate an account. Reactivate an account. | |||||||||
NO_EMAIL | Classification: WARNING Description: No email on file | Create sign-in information. | |||||||||
USERNAME_CONFLICT_WITH _EXISTING_APPLE_ID_ISSUE | Classification: WARNING Description: An Apple Account is already in use | Email unavailable as Managed Apple Account. | |||||||||
INTERNAL_ERROR | Classification: ERROR Description: Server error | Create sign-in information. | |||||||||
OPERATION_NOT_ALLOWED _BY_VPP | Classification: ERROR Description: Licenses associated with account | Delete an account. | |||||||||
NOT_ENOUGH_PRIVILEGE | Classification: WARNING Description: Not a user | Create sign-in information. | |||||||||
NOT_ENOUGH_PRIVILEGE | Classification: WARNING Description: Deactivating self | Deactivate account. | |||||||||
OPERATION_NOT_ALLOWED | Classification: WARNING Description: New manual account | Deactivate an account. | |||||||||
INTERNAL_ERROR INVALID_INPUT | Classification: OPERATION_NOT_ALLOWED Description: Assign devices to a device management service | Assigns the selected devices. Device in released state. Device management service doesn’t exist. | |||||||||
INTERNAL_ERROR INVALID_INPUT | Classification: OPERATION_NOT_ALLOWED Description: Reassign and delete service | Reassign and delete the selected device management service. | |||||||||
INTERNAL_ERROR INVALID_INPUT | Classification: OPERATION_NOT_ALLOWED Description: Unassign devices from a device management service | Unassign the selected devices. Device in released state. Device management service doesn’t exist. | |||||||||
INTERNAL_ERROR INVALID_INPUT | Classification: OPERATION_NOT_ALLOWED Description: Unassign and delete service | Unassign and delete the selected device management service. | |||||||||
INTERNAL_ERROR INVALID_INPUT | Classification: OPERATION_NOT_ALLOWED Description: Release devices | Release the selected devices. Device in released state. Device management service doesn’t exist. | |||||||||
FIRST_NAME_EMPTY LAST_NAME_EMPTY EMAIL_EMPTY | Classifications: INTERNAL_ERROR OPERATION_NOT_ALLOWED SYNC_SCIM_ACCOUNTS Description: Sync SCIM accounts | Sync accounts from your identity provider (IdP) using SCIM. | |||||||||