{"id":1588,"date":"2025-02-07T11:29:46","date_gmt":"2025-02-07T16:29:46","guid":{"rendered":"https:\/\/www.brunerd.com\/blog\/?p=1588"},"modified":"2025-02-15T03:07:40","modified_gmt":"2025-02-15T08:07:40","slug":"psa-its-jamf-inventory-time-do-you-know-where-your-macs-are","status":"publish","type":"post","link":"https:\/\/www.brunerd.com\/blog\/2025\/02\/07\/psa-its-jamf-inventory-time-do-you-know-where-your-macs-are\/","title":{"rendered":"PSA: It’s Jamf Inventory Time, Do You Know Where Your Macs Are?"},"content":{"rendered":"\n

Or rather should I say, “Do you know when<\/em> they are”? Tell me, Mac Admins, has this ever happened to you: You need to figure out when a computer last submitted inventory to Jamf. Seems easy, right? Just use the built-in Last Inventory criteria, right? Well, if you use the API to update computer records then the moment<\/em> you do, that<\/em> becomes the new<\/em> Last Inventory date. The actual<\/em> time when a Mac last sent it’s inventory is lost and can now only be loosely correlated<\/em> with Last Check-In. Not ideal\u2122<\/p>\n\n\n\n

Does anyone really know what time it is?<\/h3>\n\n\n\n

Adding zLast Inventory (Actual)<\/a> creates a safe harbor for the actual<\/em> date of an inventory submission. It won’t change no matter how many API writes you make to the computer record. Just create a new extension attribute in your Jamf with an input type of Script<\/strong> and a data type of Date<\/strong>. Leave it in the General<\/strong> category, so it’s nearer to the built-in Last Inventory field in the UI. You might also want to add it as a default column in your Computer Inventory Display<\/strong> preferences and\/or use it in Advanced Searches and reports where more reality<\/strong> is desired.<\/p>\n\n\n\n

Additional Uses for finding victim’s of “Unknown Error”<\/h3>\n\n\n\n

With zLast Inventory (Actual)<\/a> you may also be able to find Macs that are quietly failing to submit inventory. I came across a few Macs with a cryptic \"Unknown Error\"<\/code> message a few months ago. When jamf recon<\/code> runs it fails<\/em> to upload the inventory which is bad enough but more insidiously the Last Inventory<\/strong> date in Jamf is updated anyway<\/em>! The fix seemed to require removing both the Jamf framework on the endpoint and<\/em> deleting the computer record in Jamf before re-enrolling. If you know what this is let me know! Anyway here it is, all two lines all gussied up with lots of comments.<\/p>\n\n\n\n

The extension attribute <\/h2>\n\n\n\n
#!\/bin\/bash\n# zLast Inventory (Actual) -  Copyright (c) 2025 Joel Bruner (https:\/\/github.com\/brunerd\/macAdminTools\/tree\/main\/Jamf\/EAs) Licensed under the MIT License\n# A Jamf Pro Extension Attribute to report the _actual time_ of a successful inventory submission\n# This is to address two issues with the built-in Last Inventory:\n#  1) This date stamp is not affected by API writes to the computer record\n#  2) Detect \"Unknown Error\" inventory submission failures if date does not match built-in Last Inventory date (excluding API writes in History)\n\n# Notes:\n# The \"z\" at the beginning of this EA's name is to ensure it is runs last and is closest to built-in Last Inventory datestamp\n# The Jamf EA date type does not consider time zone offsets so we must normalize the time to UTC (-u) for the most consistent behavior\n# When viewing an EA date in a Report, Inventory Display, or Computer Record it will not be localized according to Preferences as built-in dates are\n\n#MySQL DATETIME format with time normalized to UTC (YYYY-MM-DD HH:MM:SS)\nDATE_NORMALIZED=$(date -u +\"%F %T\")\n\necho \"<result>${DATE_NORMALIZED}<\/result>\"<\/code><\/pre>\n\n\n
\n
\"\"<\/a>
It looks only slightly<\/em> better in the UI…<\/figcaption><\/figure>\n<\/div>\n\n
\n
\"\"<\/a>
Note: EA dates are not localized according to your UI prefs, unlike like built-in dates.<\/figcaption><\/figure>\n<\/div>\n\n\n
Ideas in Waiting<\/h2>\n\n\n\n
Apparently, my “maximizer” self can’t just write a dang two-line script without also<\/em> thinking of all the “Jamf Ideas<\/a>” that either need to be created and or upvoted in relation this. I encourage you to take a look at these and vote them up too.<\/p>\n\n\n\n
    \n
  1. “Inventory Time becomes incorrect with API (JN-I-16064)<\/a>” – The “raison d’\u00eatre” of this blog post, it shouldn’t be called Last Inventory if API writes are going to affect it also. This feature request dates back to May 22, 2014 (and I’m sure there are FRs that pre-date that!) It’s status is “Future Consideration”: At almost 11 years later, the future is here now Jamf!<\/li>\n\n\n\n
  2. “Localize Extension Attribute dates in the UI according to Account Preferences (JPRO-I-1068)<\/a>” – As you can see above, the dates from Extension Attributes are not localized like the “built-in” dates of Last Update and Last Inventory. Why not?<\/li>\n\n\n\n
  3. “Expanded parsing of date and time formats in extension attribute(JPRO-I-1078)<\/a>” – Jamf hitched it’s wagon to MySQL’s DATETIME<\/code> format YYYY-MM-DD HH:MM:SS<\/code> which was introduced in 1999 and has no provisions for time zone. In 2025 this seems somewhat rudimentary. Jamf could expand what’s accepted for date<\/code> types to accommodate more date time representations or at least<\/em> in the short term document the fact you<\/em> need normalize all times to UTC before sending.<\/li>\n\n\n\n
  4. “Ability to customize order of display fields in Reports (JN-I-22451)<\/a>” – Another “oldie but goody” from Jan 22, 2014 (Happy belated 11th Birthday!) it has 575 votes and has to be one of the most requested features that’s still under “Future Consideration” (again, the future is now<\/em> Jamf). If we have to make<\/em> an extension attribute to get some truth for Last Inventory can we at least have it show up somewhere we’d like? This request has many siblings, some that should be merged here<\/a>, here<\/a>, here<\/a>, here<\/a> and ones that were merged here<\/a> and here<\/a>.<\/li>\n\n\n\n
  5. Oh yeah, almost forgot, you cannot “Retain Display items when Cloning Saved Advanced Search (JN-I-22827)<\/a>“ I thought I was going crazy after I’d made a series of reports by cloning, only to find the “clones” had only copied the search criteria<\/strong> but not<\/em> the all those Display<\/strong> items I’d spent time checking off – that I had to do again and again.<\/s> [Edit: I might have misremembered and you have to uncheck the default Display items you don’t<\/em> want re-enabled in your “clone” so this still holds true]  Aye, what kinda “clone” is that<\/em>?! It’s not! This “idea” is labeled Not likely to implement<\/code> but hey, you can still<\/em> leave your angsty comments in memoriam like me, vote it up, and pour outta 40. \ud83e\udea6\ud83c\udf7b [ Edit: Yes, these are “first world” nerd problems, I know. Blame it on the bad early 2025 vibes.]<\/li>\n<\/ol>\n\n\n\n
    Where was I? Oh right, the thing…<\/h2>\n\n\n\n
    In closing, add zLast Inventory (Actual)<\/a> as an extension attribute to your Jamf. You never know when you might need a bit of reality for Last Inventory in your Jamf reports and searches.<\/p>\n","protected":false},"excerpt":{"rendered":"
    Or rather should I say, “Do you know when they are”? Tell me, Mac Admins, has this ever happened to you: You need to figure out when a computer last submitted inventory to Jamf. Seems easy, right? Just use the built-in Last Inventory criteria, right? Well, if you use the API to update computer records […]<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[19,46,12],"tags":[20,47,22,24],"class_list":["post-1588","post","type-post","status-publish","format-standard","hentry","category-bash","category-jamf","category-scripting","tag-bash","tag-jamf","tag-scripting","tag-shell"],"_links":{"self":[{"href":"https:\/\/www.brunerd.com\/blog\/wp-json\/wp\/v2\/posts\/1588","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.brunerd.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.brunerd.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.brunerd.com\/blog\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.brunerd.com\/blog\/wp-json\/wp\/v2\/comments?post=1588"}],"version-history":[{"count":18,"href":"https:\/\/www.brunerd.com\/blog\/wp-json\/wp\/v2\/posts\/1588\/revisions"}],"predecessor-version":[{"id":1644,"href":"https:\/\/www.brunerd.com\/blog\/wp-json\/wp\/v2\/posts\/1588\/revisions\/1644"}],"wp:attachment":[{"href":"https:\/\/www.brunerd.com\/blog\/wp-json\/wp\/v2\/media?parent=1588"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.brunerd.com\/blog\/wp-json\/wp\/v2\/categories?post=1588"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.brunerd.com\/blog\/wp-json\/wp\/v2\/tags?post=1588"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}