Monitoring

You can ask to Ceremony to monitor the installation of applications and packages. For now, it can monitor applications and packages installed via Jamf, AirWatch (Workspace ONE) and via VPP (or other services that use the App Store). To ask Ceremony to monitor an installation, you add an item in the Monitors array in the configuration file.

Key Type Possible values Explanation Is Required
Type String File, Application File is used to monitor the presence of a file in a folder. When choosing Application to monitor installation , specifying the key Installer is required ⚠️
Identifier String - The bundle identifier used by the system to download an application from the Mac App Store. Useful only when installing VPP applications which are not downloaded directly in the /Applications folder (like Microsoft applications for example). Example: com.microsoft.Word
Name String - The name of the application or package as it will appear in the MDM log or in the /Applications folder for App Store downloads. You have to ensure that the value of this key is contained in the name of the installed package or application ⚠️
DisplayName String - The name which will be displayed to the user in the AppMonitoring component. Otherwise, it's the Name key which is displayed, or the Identifier key if specified.
Installer String Jamf, AirWatch, System Specify how the application will be installed. If the application is installed with Jamf or AirWatch directly, you can choose the Jamf or AirWatch value. If it is by App Store (like VPP), choose the System value. ⚠️
Detail String - Detail text displayed under the name or display name in the AppMonitoring component
IconURL String - Let you specify a local or online URL for the icon to be shown in the AppMonitoring component. Ceremony will use a generic icon image if not specified
Example

Monitor for the application Things, installed via VPP. The App Store identified the application as Things3 so it's the one written here. The name displayed to the user is Things.


    <dict>
        <key>Type</key>
        <string>Application</string>
        <key>Name</key>
        <string>Things3</string>
        <key>DisplayName</key>
        <string>Things</string>
        <key>Detail</key>
        <string>Your soon favorite To-do list</string>
        <key>Installer</key>
        <string>System</string>
    </dict>
    

Monitor for the application VMware Fusion, installed via Jamf. A placeholder is used to address the icon path.


    <dict>
        <key>Type</key>
        <string>Application</string>
        <key>Name</key>
        <string>VMWareFusion</string>
        <key>DisplayName</key>
        <string>VMware Fusion</string>
        <key>Installer</key>
        <string>Jamf</string>
        <string>${AppIconsFolderPath}/VMWare.png</string>
    </dict>
    

Monitor for the application Gimp, installed via AirWatch. The app name and the version are strictly identified by the Identifier key. The IconURL key addresses Wikipedia.


    <dict>
        <key>Type</key>
        <string>Application</string>
        <key>Identifier</key>
        <string>Gimp-v2.10.4.pkg</string>
        <key>DisplayName</key>
        <string>Gimp</string>
        <key>Detail</key>
        <string>Less boring meetings</string>
        <key>IconURL</key>
        <string>https://upload.wikimedia.org/wikipedia/commons/thumb/4/45/The_GIMP_icon_-_gnome.svg/1024px-The_GIMP_icon_-_gnome.svg.png</string>
        <key>Installer</key>
        <string>AirWatch</string>
    </dict>