How to manage Zenoss Data Monitor

The Zenoss Data Monitor service has separate configuration files for itself and for the metrics and events it collects.

Service

Use Windows Services Manager to stop, pause, and restart the Zenoss Data Monitor service.

All of the user-configurable properties in Zenoss Data Monitor service configuration file are set when you install the service. The default path of the service configuration file is C:\Program Files (x86)\Zenoss\ZenDatamon\configs\agent.yaml. Example file:

agent.yaml

apiVersion: v1
agent:
  name: win.svc.zdmagent
  source: _ZDM_SEC_<ALT_SOURCE>
  defaultInterval: 60s
datasinks:
  - name: zenoss-stream
    type: zenoss
    conf:
      address: _ZDM_SEC_<ALT_ADDRESS>
      apiKey: _ZDM_SEC_<ALT_APIKEY>
      logOnly: false
configurationSource:
  local:
    - name: localds
      directory: configs/datasources
secretlookup:
  type: alternate

The values that start with _ZDM_SEC_ are defined in alternate.xml (in the same directory). The Zenoss Data Monitor service loads configuration file changes immediately.

Metrics

The Windows datasource configuration file controls which metrics are collected. The default path of the file is C:\Program Files (x86)\Zenoss\ZenDatamon\configs\datasources\localhost.yaml. Example file:

localhost.yaml

apiVersion: v1
kind: datasource
name: localhost
spec:
  type: localhost
  datasource:
    #disableSys: true
    #disableNet: true
    #disableMem: true
    #disableCPU: true
    #disableDisk: true
    #disableDiskIO: true
  filters:
    # All metrics
    metricPass:
      - "*"

You can disable collection for a group of metrics by removing the comment character (#) from a metric group. By default, all metrics are collected. The following table associates properties in the localhost.yaml file with specific metrics:

Property	Metrics
(@spec.datasource.disableSys)	System
(@spec.datasource.disableNet)	Network
(@spec.datasource.disableMem)	Memory
(@spec.datasource.disableCPU)	CPU
(@spec.datasource.disableDisk)	Disk
(@spec.datasource.disableDiskIO)	Disk I/O

Events

Zenoss Data Monitor gathers events from the Windows Event log according to the settings in its events configuration file. The default path of the file is C:\Program Files (x86)\Zenoss\ZenDatamon\configs\datasources\winevents.yaml. The Zenoss Data Monitor service loads configuration file changes immediately.