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 March 30, 2022 15.Dt ZONESTATD 8 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 24is a system daemon that is started during system boot. 25It monitors the utilization of system resources by zones, as well 26as zone and system configuration information such as psrset psets, 27pool psets, and resource control settings. 28.Pp 29This daemon is started automatically by the zone management 30software and should not be invoked directly. 31It does not constitute a programming interface, but is classified as a 32private interface. 33.Sh IMPLEMENTATION NOTES 34The zonestat service is managed by the service management 35facility, 36.Xr smf 7 , 37under the service identifier: 38.Pp 39.D1 svc:/system/zones-monitoring:default 40.Pp 41Administrative actions on this service, such as enabling, disabling, or 42requesting restart, can be performed using 43.Xr svcadm 8 . 44The service's status can be queried using the 45.Xr svcs 1 46command. 47.Pp 48The zonestat service has the following SMF configuration property: 49.Bd -ragged -offset indent 50config/sample_interval 51.Pp 52This property sets the 53.Nm 54sample interval. 55This is the interval used by the zones monitoring daemon, 56.Nm 57to sample resource utilization. 58This is also the interval used to determine configuration changes such as 59processor set changes, resource control changes, and zone state changes. 60.Pp 61The default interval is 5 seconds. 62.Ed 63.Pp 64The zonestat service makes use of extended accounting facility. 65If not already enabled, it enables the tracking of process accounting 66resources, and configures a process accounting file. 67The zonestat service will roll the process accounting log at its configured 68interval. 69.Pp 70If extended process accounting is enabled externally, the zonestat 71service will use the process accounting log as configured. 72It will not roll the accounting log, but will operate correctly if 73the accounting log is rolled externally. 74.Sh INTERFACE STABILITY 75.Sy Private 76.Sh SECURITY 77The zonestat service in the global zone must be online for the zonestat 78service in each non-global zone (NGZ) to function properly. 79The zonestat service in each NGZ does not directly read system configuration 80and utilization data, but rather reads from the zonestat service on the 81global zone. 82.Sh SEE ALSO 83.Xr prctl 1 , 84.Xr zonestat 1 , 85.Xr smf 7 , 86.Xr zones 7 , 87.Xr acctadm 8 , 88.Xr pooladm 8 , 89.Xr poolcfg 8 , 90.Xr rcapadm 8 91