operator usage
The operator usage
command allows an administrator to retrieve a
client count report
for the default reporting period, or for a specific time range of months.
The command output will list clients by distinct entities, non-entity tokens, and total active clients for each namespace, and the total for the entire cluster. It may indicate that no data is available for the requested time range, which may be because the client count reporting is disabled, the time range is too far in the past, or no data has yet been collected since the feature was enabled.
Refer to the Vault Usage Metrics tutorial to learn more about usage metrics, including required policy and data collection details.
Examples
Retrieve the client counts for the default reporting period:
Retrieve the client counts for a specific month in the past:
Usage
The following flags are available in addition to the standard set of flags included on all commands.
Output options
-format
(string: "table")
- Print the output in the given format. Valid formats are "table", "json", or "yaml". This can also be specified via theVAULT_FORMAT
environment variable.
Command options
-start-time
(date)
- Start month of the report to generate. May be given as YYYY-MM-DD, YYYY-MM-DD, a full RFC3339 timestamp, or a Unix epoch timestamp. Defaults to the configurabledefault_report_months
prior toend-time
.-end-time
(date: previous month)
- End month of the report to generate. Defaults to the end of the previous calendar month.
The output shows the exact time range being reported, which may not match the input parameters if a full month is not available, or if the available reports are a subset of the months requested.