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. | Generate a .csv or PDF or send a mail message with sign-in information. |
Assign a role to a location. | Add a role and location to an account. |
Edit a Managed Apple Account. | Edit an account’s Managed Apple Account. |
Delete an account. | Delete an account. |
Deactivate an account. | Deactivate an account. |
Reactivate an account. | Reactivate an account. |
Assign devices. | Assign the selected devices. |
Reassign and delete server. | Reassign and delete the selected mobile device management (MDM) server. |
Unassign devices. | Unassign the selected devices. |
Unassign and delete server. | Unassign and delete the selected mobile device management (MDM) server. |
Release devices. | Release the selected devices. |
Read a log file
In Apple Business Essentials, sign in with a user that has the role that can 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 | Description | Associated activity |
|---|---|---|---|
NOT_ENOUGH _PRIVILEGE | WARNING | 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 | WARNING | Active account | Delete an account. Reactivate an account. |
OPERATION_NOT _ALLOWED | WARNING | New and synced account | Delete an account. |
OPERATION_NOT _ALLOWED | WARNING | Inactive account | Create sign-in information. Assign a role to a location. |
NOT_FOUND | WARNING | 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 | WARNING | No email on file | Create sign-in information. |
USERNAME_CONFLICT _WITH_EXISTING _APPLE_ID_ISSUE | WARNING | An Apple Account is already in use | Email unavailable as Managed Apple Account. |
INTERNAL_ERROR | ERROR | Server error | Create sign-in information. |
OPERATION_NOT _ALLOWED_BY _VPP | ERROR | Licenses associated with account | Delete an account. |
NOT_ENOUGH _PRIVILEGE | WARNING | Not a user | Create sign-in information. |
NOT_ENOUGH _PRIVILEGE | WARNING | Deactivating self | Deactivate account. |
OPERATION_NOT _ALLOWED | WARNING | New manual account | Deactivate an account. |
INTERNAL_ERROR INVALID_INPUT | OPERATION_NOT _ALLOWED | Assign devices | Assigns the selected devices. Device in released state. MDM server does not exist. |
INTERNAL_ERROR INVALID_INPUT | OPERATION_NOT _ALLOWED | Reassign and delete server | Reassign and delete the selected MDM server. |
INTERNAL_ERROR INVALID_INPUT | OPERATION_NOT _ALLOWED | Unassign devices | Unassign the selected devices. Device in released state. MDM server does not exist. |
INTERNAL_ERROR INVALID_INPUT | OPERATION_NOT _ALLOWED | Unassign and delete server | Unassign and delete the selected mobile device management (MDM) server. |
INTERNAL_ERROR INVALID_INPUT | OPERATION_NOT _ALLOWED | Release devices | Release the selected devices. Device in released state. MDM server does not exist. |
FIRST_NAME _EMPTY LAST_NAME _EMPTY EMAIL_ EMPTY | INTERNAL_ERROR OPERATION_NOT _ALLOWED SYNC_SCIM _ACCOUNTS | Sync SCIM accounts | Sync accounts from Microsoft Entra ID or your identity provider (IdP) using SCIM. |