B10-STATS(8)

NAME
b10-stats - BIND 10 statistics module

SYNOPSIS

b10-stats [-v] [--verbose]

DESCRIPTION

The b10-stats daemon collects statistics data from each BIND 10 module. Its statistics information may be reported via bindctl or b10-stats-httpd. It is started by bind10 and communicates by using the Command Channel by b10-msgq with other modules like bind10, b10-auth and so on. It waits for coming data from other modules, then other modules send data to stats module periodically. Other modules send stats data to stats module independently from implementation of stats module, so the frequency of sending data may not be constant. The stats module collects data and aggregates it. b10-stats invokes an internal command for bind10 after its initial starting to make sure it collects statistics data from bind10.

OPTIONS

The arguments are as follows:

-v, --verbose
    This enables maximum debug logging.

CONFIGURATION AND COMMANDS

The b10-stats command does not have any configurable settings.

The configuration commands are:

set will set new statistics data specified in arguments. Statistics data to be set and the module name which owns statistics data are required in argument. Pid of the module in argument is optional.

show will send the statistics data in JSON format. By default, it outputs all the statistics data it has collected. An optional item name may be specified to receive individual output.

showschema will send the schema of the statistics data in JSON format. The output is equivalent to the statistics part of stats.spec.

shutdown will shutdown the b10-stats process. This has an optional pid argument to select the process ID to stop. (Note that the BIND 10 boss process may restart this service if configured.)

status simply indicates that the daemon is running.

STATISTICS DATA

The b10-stats daemon contains these “Stats” statistics:

boot_time
    The date and time when this daemon was started in ISO 8601 format. This is a constant which can't be reset except by restarting b10-stats.

last_update_time
    The date and time (in ISO 8601 format) when this daemon last received data from another component.

lname
    This is the name used for the b10-msgq command-control channel. (This is a constant which can't be reset except by restarting b10-stats.)

report_time
    The latest report date and time in ISO 8601 format.

start_time
    This is the date and time (in ISO 8601 format) when this daemon started collecting data.

timestamp
    The current date and time represented in seconds since UNIX epoch (1970-01-01T00:00:00Z) with precision (delimited with a period) up to one hundred thousandth of second.

See other manual pages for explanations for their statistics that are kept track by b10-stats.

FILES

/usr/local/share/bind10-devel/stats.spec — This is a spec file for b10-stats. It contains commands for b10-stats. They can be invoked via bindctl(1).

SEE ALSO

b10-stats-httpd(8), bind10(8), bindctl(1), b10-auth(8), BIND 10 Guide.

HISTORY

The b10-stats daemon was initially designed and implemented by Naoki Kambe of JPRS in October 2010.

COPYRIGHT
Copyright © 2010-2012 Internet Systems Consortium, Inc. ("ISC")