Computer Health¶
Tools for comprehensive health analysis and diagnostics of computers managed by Jamf Pro.
Get Health Scorecard¶
Generate a comprehensive health scorecard with security compliance analysis for a computer.
Parameter |
Type |
Required |
Description |
|---|---|---|---|
|
str |
Yes |
The serial number of the computer to retrieve |
|
str |
No |
User email instead of serial number |
Example Response
{
"overall_score": 85.5,
"grade": "B",
"status": "GOOD",
"security_score": {
"score": 90.0,
"factors": ["FileVault enabled", "SIP enabled"],
"recommendations": ["Enable Firewall"]
},
"system_health_score": {
"score": 82.0,
"factors": ["Storage adequate", "Battery healthy"],
"recommendations": []
},
"compliance_score": {
"score": 88.0,
"factors": ["Regular check-ins", "Policies up-to-date"],
"recommendations": []
},
"maintenance_score": {
"score": 79.0,
"factors": ["OS current", "Apps updated"],
"recommendations": ["Update to latest macOS version"]
},
"device_info": {
"serial": "ABC123",
"model": "MacBook Pro",
"os_version": "14.2.1"
},
"recommendations": [
"Update to latest macOS version",
"Enable automatic updates"
]
}
Usage Examples¶
Get Basic Diagnostics¶
Extract key diagnostic information from computer inventory without full health analysis.
Parameter |
Type |
Required |
Description |
|---|---|---|---|
|
str |
Yes |
The serial number of the computer to retrieve |
Example Response
{
"computer_name": "John's MacBook Pro",
"serial_number": "ABC123456",
"model": "MacBook Pro (16-inch, 2023)",
"os_version": "macOS 14.2.1",
"last_check_in": "2024-01-15T10:30:00Z",
"ip_address": "10.0.1.50",
"mac_address": "00:11:22:33:44:55",
"storage": {
"total_gb": 512,
"available_gb": 256,
"used_percent": 50
},
"memory": {
"total_gb": 32
},
"battery": {
"cycle_count": 45,
"condition": "Normal"
},
"security": {
"filevault": "Enabled",
"sip": "Enabled",
"gatekeeper": "Enabled"
}
}
Usage Examples¶
Related Tools¶
Full health analysis with scoring and recommendations
View historical logs and policy execution
Health Scoring Algorithm¶
Note
Functionality to configure custom category weights is actively being worked on, allowing organizations to adjust scoring based on their priorities.
The health analyzer evaluates computers across four weighted categories:
Scoring Categories¶
FileVault encryption
System Integrity Protection
Gatekeeper status
Firewall configuration
CVE vulnerabilities
Storage capacity
Battery health
System uptime
Hardware status
Check-in frequency
Policy execution
Profile installation
Management status
OS updates
App updates
Certificate validity
Extension attributes
Grade Scale¶
Grade |
Score Range |
Status |
Action Required |
|---|---|---|---|
A |
90-100 |
Excellent |
Routine monitoring |
B |
80-89 |
Good |
Minor improvements |
C |
70-79 |
Fair |
Attention needed |
D |
60-69 |
Poor |
Immediate action |
F |
0-59 |
Critical |
Urgent remediation |
Best Practices¶
Run health checks weekly or monthly to track trends and catch issues early.
Address F and D grades immediately, focusing on security issues first.
Monitor score changes over time to identify patterns and recurring issues.
Address actively exploited CVEs within 48 hours of detection.