macOS Integration
Host metrics, process monitoring, and system log ingestion for macOS servers. Monitor Apple Silicon and Intel Macs with native API metrics and Unified Logging System integration.
How It Works
Install TigerOps Agent for macOS
Install the TigerOps agent via Homebrew or the pkg installer. The agent runs as a launchd daemon and starts collecting host metrics and unified log entries immediately after installation.
Grant Required Permissions
Grant the TigerOps agent Full Disk Access in System Preferences for log file access. Process metrics and network statistics are available without additional permissions.
Configure Unified Logging
TigerOps agent reads from the macOS Unified Logging System (ULS) using the log stream command. Configure subsystem and category filters to capture relevant app and system log entries.
Monitor macOS Server Services
Enable per-service monitoring for macOS server components (Profile Manager, Xcode Server, directory services). TigerOps correlates service log events with host resource metrics.
What You Get Out of the Box
macOS Host Metrics via IOKit and sysctl
Collect CPU utilization (per-core), memory pressure (wired, active, inactive, compressed), disk I/O via IOKit, network throughput, and thermal state using native macOS APIs.
Unified Logging System Integration
Stream macOS Unified Log entries using the log stream or log show APIs. Filter by subsystem (com.apple.network), category, or log level. Structured ULS fields are preserved as searchable labels.
Process and App Monitoring
Track per-process CPU, memory RSS/virtual, open file descriptors, and network connections via libproc and /proc-equivalent APIs. Detect runaway processes and memory leaks in macOS apps.
macOS Security and System Events
Ingest macOS security log events: authentication failures, sudo usage, SIP violations, Gatekeeper actions, and XProtect detections from the unified log for security monitoring.
Thermal and Power Monitoring
Track CPU thermal state, fan speed, battery charge cycles, and power source via IOPMCopySystemPowerSettings. Alert on sustained thermal throttling events that indicate cooling issues.
launchd Service Health Tracking
Monitor launchd service states (loaded, running, stopped, error exit) for your custom plist daemons and agents. TigerOps alerts on unexpected service exits and crash-restart loops.
TigerOps Agent macOS Install & Config
Install the TigerOps agent on macOS via Homebrew and configure unified log streaming.
# Install via Homebrew
brew tap tigerops/tap
brew install tigerops-agent
# Configure API key
sudo tee /etc/tigerops-agent/agent.yaml <<EOF
api_key: ${TIGEROPS_API_KEY}
endpoint: https://ingest.atatus.net
host_tags:
env: ci
role: xcode-build-server
# macOS host metrics
host_metrics:
enabled: true
collection_interval: 10s
# Unified Logging System (log stream)
unified_logging:
enabled: true
# Stream specific subsystems
filters:
- subsystem: com.apple.network
level: error
- subsystem: com.apple.securityd
level: default
- subsystem: com.mycompany.myapp
level: info
# Or capture all at warning+
default_level: fault
# launchd service monitoring
launchd:
enabled: true
watch_labels:
- com.mycompany.api-server
- com.mycompany.worker
EOF
# Start as launchd daemon
sudo launchctl load /Library/LaunchDaemons/net.atatus.agent.plistCommon Questions
Does TigerOps support Apple Silicon (M-series) Macs?
Yes. The TigerOps macOS agent is a universal binary supporting both Apple Silicon (arm64) and Intel (x86_64). Performance counters and IOKit metrics work on both architectures, including M-series performance and efficiency core separation.
How does TigerOps read macOS Unified Log entries?
The TigerOps agent uses the macOS log stream API to subscribe to the Unified Logging System in real time. You configure subsystem, category, and level filters in the agent config to control which entries are forwarded.
Can I monitor Xcode build performance on macOS CI servers with TigerOps?
Yes. Enable the Xcode subsystem filter in the TigerOps ULS configuration and instrument your CI scripts to emit custom log entries or metrics. TigerOps tracks build duration, test pass rates, and simulator spin-up time trends.
What permissions does the TigerOps agent require on macOS?
The agent requires Full Disk Access (for reading log files) and optionally Accessibility access (for process list detail). It runs as a launchd daemon under a dedicated tigerops-agent user without admin privileges after installation.
Does TigerOps work with macOS system extensions and endpoint security?
The TigerOps agent does not use a system extension. It uses the standard log stream and libproc APIs. For advanced endpoint security monitoring, pair TigerOps with an ESF-based security tool and forward events to TigerOps via its syslog endpoint.
Native macOS Observability for CI, Staging, and Production
IOKit metrics, Unified Logging integration, and launchd health tracking. Brew install and you are done.