1 .\"
   2 .\" This file and its contents are supplied under the terms of the
   3 .\" Common Development and Distribution License ("CDDL"), version 1.0.
   4 .\" You may only use this file in accordance with the terms of version
   5 .\" 1.0 of the CDDL.
   6 .\"
   7 .\" A full copy of the text of the CDDL should have accompanied this
   8 .\" source.  A copy of the CDDL is also available via the Internet at
   9 .\" http://www.illumos.org/license/CDDL.
  10 .\"
  11 .\" Copyright (c) 2010, Oracle and/or its affiliates. All rights reserved.
  12 .\" Copyright 2019 OmniOS Community Edition (OmniOSce) Association.
  13 .\"
  14 .Dd April 04, 2019
  15 .Dt zonestatd 1M
  16 .Os
  17 .Sh NAME
  18 .Nm zonestatd
  19 .Nd zones monitoring daemon
  20 .Sh SYNOPSIS
  21 .Nm /usr/lib/zones/zonestatd
  22 .Sh DESCRIPTION
  23 .Nm
  24 is a system daemon that is started during system boot.
  25 It monitors the utilization of system resources by zones, as well
  26 as zone and system configuration information such as psrset psets,
  27 pool psets, and resource control settings.
  28 .Pp
  29 This daemon is started automatically by the zone management
  30 software and should not be invoked directly.
  31 It does not constitute a programming interface, but is classified as a
  32 private interface.
  33 .Sh IMPLEMENTATION NOTES
  34 The zonestat service is managed by the service management
  35 facility,
  36 .Xr smf 5 ,
  37 under the service identifier:
  38 .Pp
  39 .D1 svc:/system/zones-monitoring:default
  40 .Pp
  41 Administrative actions on this service, such as enabling, disabling, or
  42 requesting restart, can be performed using svcadm(1M).
  43 The service's status can be queried using the
  44 .Xr svcs 1
  45 command.
  46 .Pp
  47 The zonestat service has the following SMF configuration property:
  48 .Bd -ragged -offset indent
  49 config/sample_interval
  50 .Pp
  51 This property sets the
  52 .Nm
  53 sample interval.
  54 This is the interval used by the zones monitoring daemon,
  55 .Nm
  56 to sample resource utilization.
  57 This is also the interval used to determine configuration changes such as
  58 processor set changes, resource control changes, and zone state changes.
  59 .Pp
  60 The default interval is 5 seconds.
  61 .Ed
  62 .Pp
  63 The zonestat service makes use of extended accounting facility.
  64 If not already enabled, it enables the tracking of process accounting
  65 resources, and configures a process accounting file.
  66 The zonestat service will roll the process accounting log at its configured
  67 interval.
  68 .Pp
  69 If extended process accounting is enabled externally, the zonestat
  70 service will use the process accounting log as configured.
  71 It will not roll the accounting log, but will operate correctly if
  72 the accounting log is rolled externally.
  73 .Sh INTERFACE STABILITY
  74 .Sy Private
  75 .Sh SECURITY
  76 The zonestat service in the global zone must be online for the zonestat
  77 service in each non-global zone (NGZ) to function properly.
  78 The zonestat service in each NGZ does not directly read system configuration
  79 and utilization data, but rather reads from the zonestat service on the
  80 global zone.
  81 .Sh SEE ALSO
  82 .Xr zonestat 1 ,
  83 .Xr acctadm 1m ,
  84 .Xr pooladm 1m ,
  85 .Xr poolcfg 1m ,
  86 .Xr prctl 1m ,
  87 .Xr rcapadm 1m ,
  88 .Xr smf 5 ,
  89 .Xr zones 5