Monitoring

Key name: Monitoring
Element type: Dictionary
Status: Optional

You choose in this section how to monitor applications and packages installation, or file presence. The currently supported MDM are Jamf, Workspace ONE (AirWatch), Microsoft Endpoint Manager (Intune) and Munki, and applications installed with VPP (or from the App Store more generally).

Munki

To use Munki monitoring, set the Monitor Installer key as AirWatch and specify the paths to the corresponding Munki log files in the keys AirWatchInstallLogPath and AirWatchManagedSoftwareUpdateLogPath.

Microsoft Endpoint Manager

To use Microsoft Endpoint Manager, set the Monitor Installer key as Managed and use the Octo-Notifier command line tool to update Octory via your App installation scripts.

Keys

Name	Type	Required
JamfLogPath	String
AirWatchInstallLogPath	String
AirWatchManagedSoftwareUpdateLogPath	String
InstallationCompleteSoundNameOrFilePath	String
Monitors	Array (Monitors)	Required

Detail

JamfLogPath

Type: String
Explanation: Lets you override the path to the Jamf log file path. Default is /var/log/jamf.log

AirWatchInstallLogPath

Type: String
Explanation: Lets you override the path to the AirWatch Install log file path. Default is /Library/Application Support/AirWatch/Data/Munki/Managed Installs/Logs/Install.log

AirWatchManagedSoftwareUpdateLogPath

Type: String
Explanation: Lets you override the path to the AirWatch ManagedSoftwareUpdate log file path. Default is /Library/Application Support/AirWatch/Data/Munki/Managed Installs/Logs/ManagedSoftwareUpdate.log

InstallationCompleteSoundNameOrFilePath

Type: String
Explanation: Play a sound when all the monitors are installed. Can be the name of a system sound or the path to a sound file (MP3, MP4, WAV). You can find the system sounds list at /System/Library/Sounds/.

Monitors Required

Type: Array (Monitors)
Explanation: Specify here the files, applications or packages installations you want Octory to monitor. See the Monitoring section for more info.

Example

Ask Octory to monitor the installation of the application "Drinky", installed from the App Store, and the application "Sushis" installed with Jamf. Note the usage of variable Monitors where could be stored the path to the monitors icons folder.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <!-- ... -->
    <key>Monitoring</key>
    <dict>
        <key>Monitors</key>
        <array>
            <dict>
                <key>Type</key>
                <string>Application</string>
                <key>Installer</key>
                <string>System</string>
                <key>Name</key>
                <string>Drinky</string>
                <key>IconURL</key>
                <string>${Monitors}/drinky.png</string>
            </dict>
            <dict>
                <key>Type</key>
                <string>Application</string>
                <key>Installer</key>
                <string>Jamf</string>
                <key>Name</key>
                <string>Sushis</string>
            </dict>
        </array>
    </dict>
    <!-- ... -->
</dict>
</plist>