TrueNAS SCALETrueNAS SCALE Nightly Development Documentation
This content follows experimental early release software. Use the Product and Version selectors above to view content specific to a stable software release.

Reporting

The Reporting screen displays graphs of system information for CPU, disk, memory, network, NFS, partition, target, UPS, ZFS, and system functions. Use the dropdown in the upper right corner to select between reporting graph display options. The CPU report displays by default.

What does TrueNAS SCALE use for reporting?

TrueNAS SCALE uses Netdata to gather metrics, create visualizations, and provide reporting statistics.

Click Netdata from the Reporting page to see the built-in netdata UI. This UI bases metrics off your local system and browser time, which might be different from the default TrueNAS system time.

To configure a third-party reporting integration, such as Graphite, click Exporters to open the Reporting Exporters screen.

Report Graphs

The following sections provide examples of each report graph.

CPU Graphs

Displays the CPU Temperature, CPU Usage, and System Load graphs.

Click Here for More Information

CPU graphs show the amount of time spent by the CPU in various states such as executing user code, executing system code, and being idle. Graphs of short-, mid-, and long-term load are shown, along with CPU temperature graphs.

Disk Graphs

Displays graphs for each selected system disk and by report type.

Click Here for More Information

Disk graphs shows read and write statistics on I/O, percent busy, latency, operations per second, pending I/O requests, and disk temperature. Use the Select Disks dropdown list to select the disks and the Select Reports dropdown to select the report types to display.

Disk Report Setting Options

SettingDescription
Select AllDisplays all available graphs for any or all disks selected on the Disks dropdown list.
Disk TemperatureDisplays the minimum, maximum and mean temperature reading for the disk selected.
Disk I/ODisplays the disk read and write I/O stats in bytes/s.
Temperature monitoring for the disk is disabled if HDD Standby is enabled. Check the Storage > Disks Edit Disk* configuration form for any or all disks in the system if you do not see the temperature monitoring graph.

Large petabyte systems may report storage numbers inaccurately. Storage configurations with more than 9,007,199,254,740,992 bytes will round the last 4 digits.

For example, a system with 18,446,744,073,709,551,615 bytes reports the number as 18,446,744,073,709,552,000 bytes.

Memory Graphs

Displays both the Physical memory utilization and Swap utilization graphs.

Click Here for More Information

Memory graphs display memory usage and swap graphs display the amount of free and used swap space.

Network Graphs

Displays an Interface Traffic graph for each interface in the system.

Click Here for More Information

Network graph report received and transmitted traffic in megabytes per second for each configured interface.

System Graphs

Displays both the Processes and Uptime graphs.

Click Here for More Information

System graphs display the number of processes grouped by state, sleeping, running, stopped, zombies and blocked, and system uptime.

UPS Graphs

Displays the UPS Charging percentage, UPS Runtime, UPS Voltage - Battery, UPS Voltage - Input, UPS Voltage - Output, UPS Input Current, UPS Input Frequency, UPS Input Load, and UPS Temperature.

The UPS service must be configured with a compatible Uninterruptible Power Supply (UPS) device.

UPS Reporting
Figure 8: UPS Reporting

ZFS Graphs

Displays the ARC Size, ARC Hit Ratio, ARC Requests demand_data, ARC Requests demand_metadata, ARC Requests prefetch_data, and ARC Requests prefetch_metadata graphs with the Arc and L2 gigabytes and hits (%), and the hits, misses and total number of requests.

Click Here for More Information

ZFS graphs show compressed physical ARC size, hit ratio, demand data, demand metadata, and prefetch data and metadata.

Reporting Exporters Screen

Exporter on the Reporting screen opens the Reporting Exporter screen. The Reporting Exporters screen displays reporting exporters configured on the system. Exporting enables TrueNAS SCALE to send Netdata reporting metrics to another time-series database. Exporters send Netdata reporting records in the form of JSON objects to third party reporting collection cloud services or applications installed on servers. For more information, see the Netdata exporting reference guide.

Reporting Exporters Screen
Figure 11: Reporting Exporters Screen

Add opens the Add Reporting Exporter screen.

Add Reporting Exporter

Use the Add Reporting Exporter screen to configure third party reporting integrations.

Add Reporting Exporter
Figure 12: Add Reporting Exporter
SettingDescription
NameEnter a unique name for the exporter configuration. If configuring multiple instances, give each a distinct name.
TypeSelect the report object format. At present, GRAPHITE is the only current supported option. Selecting GRAPHITE displays the exporter configuration settings
EnableSelect to enable sending reporting data to the configured exporter. Leave checkbox clear to disable the explorer without removing configuration.

Additional settings populate based on the selected Type option.

Graphite Settings

Graphite Exporter Settings
Figure 13: Graphite Exporter Settings
Graphite Setting Descriptions
SettingDescription
Destination IpRequired. Enter the IP address of the Graphite server.
Destination PortRequired. Enter the port the Graphite server monitors.
PrefixEnter the top-level of the file hierarchy for the path to use to store exported records. For example, enter the top-level folder name for the path, and use Namespace to enter the folder for the data records. For example, enter dragonfish.
namespaceEnter the name for the folder where you store data records. Use with the Prefix to define the full path. You can also enter the host name to add to all data records sent to the Graphite server. Defaults to truenas.
Update Every(Optional) Enter the number of seconds for the interval to send data to the Graphite database. Defaults to 1.
Buffer On Failures(Optional) Enter the number of iterations (Update Every seconds) to buffer data, when the Graphite server is not available. Defaults to 10.
Send Names Instead Of Ids(Optional) Enter true to send Netdata chart and dimension names to Graphite or false to send IDs. Defaults to true.
Matching Charts(Optional) Enter one or more space separated patterns in regular expression. Use the asterisk () as wildcard to send all charts or the exclamation mark (!) to define a negative match to specify the charts to send to Graphite. Defaults to ().

See Adding a Reporting Exporter for guidance with configuring a Graphite exporter on TrueNAS.