Agent Client Collector - Visibility for SAM

RhageshVS
Tera Contributor

‎08-13-2025 06:28 AM

I am working with ACC-V (Agent Client Collector) to capture installed software usage and metering data. Having completed the prerequisites, I now need to install the OSQuery daemon for SAM basic metering and total usage on a test laptop (Linux and macOS). For Windows, I used the script provided in the ServiceNow documentation to download and configure OSquery — what is the recommended approach for macOS and Linux?

Labels:
0 Helpfuls
  • 448 Views
3 REPLIES 3

AJ-TechTrek
Giga Sage
Giga Sage

‎08-13-2025 11:54 PM

Hi @RhageshVS ,

 

As per my understanding, you are looking for this , Below steps might be helpful for this.

 

1. macOS – Recommended Installation
ServiceNow recommends using the official OSQuery package and then applying the ACC-V configuration from your instance.

 

Steps:
1. Download OSQuery for macOS from the official GitHub releases:
https://github.com/osquery/osquery/releases
* File type: .pkg installer.
2. Install OSQuery:
sudo installer -pkg /path/to/osquery-<version>.pkg -target /
4. Create/Update the OSQuery config file to include ServiceNow ACC-V settings:
* Config file path: /var/osquery/osquery.conf
* Paste in the JSON config provided in ServiceNow → Agent Client Collector → Configuration for software metering.
5. Ensure the OSQuery daemon is running:
sudo launchctl load /Library/LaunchDaemons/com.facebook.osqueryd.plist
6. sudo launchctl start com.facebook.osqueryd
7. Verify:
osqueryi --version
8. osqueryi "SELECT * FROM apps;"

 

2. Linux – Recommended Installation
ServiceNow supports installing OSQuery via package managers or direct binary.
Steps:
1. Install OSQuery:
* For Ubuntu/Debian:
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 1484120AC4E9F8A1A577AEEE97A80C63C9D8B80B
* sudo add-apt-repository 'deb [arch=amd64] https://pkg.osquery.io/deb deb main'
* sudo apt-get update
* sudo apt-get install osquery
* For RHEL/CentOS:
sudo yum install https://pkg.osquery.io/rpm/osquery-<version>.rpm

2. Configure OSQuery:
* Config file path: /etc/osquery/osquery.conf
* Insert ServiceNow-provided ACC-V JSON config for metering.
3. Enable and start service:
sudo systemctl enable osqueryd
4. sudo systemctl start osqueryd
5. Test:
osqueryi --version
6. osqueryi "SELECT * FROM rpm_packages;" # or dpkg_packages on Debian

 

3. Key Points from ServiceNow’s Latest Documentation
* Config Source: The OSQuery config used must come from your ServiceNow ACC-V Software Metering setup so that the queries match the SAM usage data requirements.
* Communication: Ensure the device can reach the ACC-V endpoint (agentclientcollector.servicenow.com) over HTTPS (port 443).
* Permissions: OSQuery must run with elevated privileges to capture installed software details.
* Verification in SN: After installation, navigate to Software Asset → Metering → All Metering Records to confirm the test device is reporting.

 

Please appreciate the efforts of community contributors by marking appropriate response as Mark my Answer Helpful or Accept Solution this may help other community users to follow correct solution in future.
 

Thank You
AJ - TechTrek with AJ - ITOM Trainer
LinkedIn:- https://www.linkedin.com/in/ajay-kumar-66a91385/
YouTube:- https://www.youtube.com/@learnitomwithaj
Topmate:- https://topmate.io/aj_techtrekwithaj (Connect for 1-1 Session)
ServiceNow Community MVP 2025