Sie können die Jamf Pro API verwenden, um Diagnoseprotokolle (Sysdiagnose-Protokolle) von verwalteten Geräten aus der Ferne anzufordern. Dies ist nützlich für die Zusammenarbeit mit AppleCare bei der Fehlerbehebung in Situationen, die eine detaillierte Protokollierung erfordern.* Wenn Sie ein Problem an AppleCare melden, werden Sie möglicherweise aufgefordert, eine erweiterte Protokollsammlung auf dem Gerät auszuführen. AppleCare stellt Ihnen dann ein Token zur Verfügung, das mit dem Befehl TriggerEnhancedLogCollection verwendet werden kann, der an das Gerät gesendet wird, um den Vorgang auszulösen.
Anforderungen
Die Berechtigung „MDM-Befehlsinformationen in Jamf Pro API senden“ in Jamf Pro
Ein Zielgerät mit iOS 27, iPadOS 27, macOS 27 oder tvOS 27 (alle derzeit in der Betaversion)
Eine AppleCare for Enterprise Vereinbarung (zum Testen dieses Features während der Betaphase)
Weitere Informationen finden Sie in der nachstehenden Apple Dokumentation:
Um das Anfordern von Diagnoseprotokollen für ein verwaltetes Gerät zu testen, senden Sie eine Anfrage an die Jamf Pro API, die der folgenden ähnelt:
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"
}
}'Ersetzen Sie
<jamf-pro-server-url>im obigen Beispiel durch Ihre Jamf Pro Server-URL.Ersetzen Sie
<token>im obigen Beispiel durch Ihren Jamf Pro API Bearer-Token-String.Ersetzen Sie
<device-management-ID>im obigen Beispiel durch die Jamf Pro Management-ID des Zielgeräts (zu finden im Bestandsdatensatz dieses Geräts in der Kategorie Allgemein).Während der Betaphase können Sie den String
test-token-normalverwenden, um eine interaktive erweiterte Protokollsammlungssitzung zu simulieren. Wenn dieses Feature allgemein verfügbar ist, verwenden Sie stattdessen einen Token-Wert aus Ihrem AppleCare Ticket. Weitere Informationen finden Sie in der folgenden Entwicklerdokumentation von Apple:https://developer.apple.com/documentation/devicemanagement/trigger-enhanced-log-collection-command
Jamf Pro sendet einen Befehl an das Zielgerät, um eine Protokollierungssitzung zu starten. Nach Abschluss der Sitzung werden die gesammelten Protokolle an Apple gesendet.
Die Unterstützung neuer Features geht zurück auf Tests mit den aktuellen Beta-Versionen von Apple.