✨ New: Try our AI‑powered Search (Ctrl + K) — Read more

history

Prev Next

history edit file

history edit file - Change the report file generation parameters

Description:
history edit file allows to change parameters used to generate and upload the report files to a remote server.

Syntax:

  history edit file {
                {period-mode {new | fixed | all}} |
                {local-periods <1-672>} |
                {include-disabled {enabled | disabled }} |
                {include-previous {enabled | disabled }} |
                {url <url>} |
                {scp-password <password>} }+

Parameters:

Parameter Description
period-mode Selects the mode in which the periods are retrieved to generate a report file:
  • new: only the periods since the last report.
  • fixed: fixed number of periods.
  • all: all available periods.
local-periods Specifies the number of local periods to process in fixed mode.
include-disabled Specifies if the report should include the statistics for disabled objects.
include-previous Specifies if the report should include the periods included in a previous aborted file transfer. This is only used if period-mode is "new".
url URL to reach the server and directory, e.g.:
  • http://mypc.com
  • ftp://username:password@mypc.com
  • sftp://username@mypc.com
  • tftp://mypc.com
  • scp://username@mypc.com:/target_directory
The URL host subcomponent consists of a name or an IP address. IPv4 addresses must be in dot-decimal notation, and IPv6 addresses must be enclosed in brackets ([]).
scp-password Password used for SCP and SFTP transfers.

history edit local

history edit local - Change the local history parameters

Description:
With history local edit, you can change the parameters of the history buckets mechanism.

Syntax:

  history edit local {
                {flowmeter-state {disable | enable}} |
                {flowmeter-filing {disable | enable}} |
                {flowmeter-period <1-60>} |
                {regulator-state {disable | enable}} |
                {regulator-filing {disable | enable}} |
                {regulator-period <1-60>} |
                {soamdmm-state {disable | enable}} |
                {soamdmm-filing {disable | enable}} |
                {soamdmm-period <1-60>} |
                {soampl-state {disable | enable}} |
                {soampl-filing {disable | enable}} |
                {soampl-period <1-60>} |
                {soamslm-state {disable | enable}} |
                {soamslm-filing {disable | enable}} |
                {soamslm-period <1-60>}}+

Parameters:

Parameter Description
flowmeter-state Enable or disable FlowMETER history.
flowmeter-filing Enable filesystem storage of the FlowMETER history buckets.
flowmeter-period Reference period for the FlowMETER history buckets.
regulator-state Enable or disable regulator history.
regulator-filing Enable filesystem storage of the regulator history buckets.
regulator-period Reference period for the regulator history buckets.
soamdmm-state Enable or disable SOAM DMM history.
soamdmm-filing Enable filesystem storage of the SOAM DMM history buckets.
soamdmm-period Reference period for the SOAM DMM history buckets.
soampl-state Enable or disable SOAM PL history.
soampl-filing Enable filesystem storage of the SOAM PL history buckets.
soampl-period Reference period for the SOAM PL history buckets.
soamslm-state Enable or disable SOAM SLM history.
soamslm-filing Enable filesystem storage of the SOAM SLM history buckets.
soamslm-period Reference period for the SOAM SLM history buckets.

history edit scheduling

history edit scheduling - Modify scheduling parameters

Description:
With the history edit scheduling command, you can modify how reporting history bucket data is scheduled.

Syntax:

  history edit scheduling {
                {local-state {disable | enable}} |
                {local-hours {<hour-value>}+} |
                {local-minutes {<minutes-value>}+} |
                {local-offset <0-(local-period - 1)>} |
                {local-random-offset <0-900>} |
                {local-period <5|10|15|20|30|60>}|
                {local-mode <hourly|periodic>}}+

Parameters:

Parameter Description
local-state Enables or disables the scheduling mechanism on the local device.
local-hours Sets the hour(s) at which the local statistics are reported {00H00
local-minutes When in hourly mode, sets the minute(s) at which the local statistics are reported with 15-minute granularity {00H00
local-offset Sets the offset to add to the local-minutes. Adding an offset spreads out the load on the file servers by distributing the upload moments over time.
local-random-offset Randomly generates an extra offset between 0 and the specified value that is added to the local offset. Expressed in seconds.
local-period When in periodic mode, the period at which the local statistics are retrieved. Similar to local-minutes, but statistics are reported every local-period minutes for the selected local-hours. When in hourly mode, this parameter is ignored and the value of local-period is 15 minutes.
local-mode Sets either periodic or hourly mode. In periodic mode, the minutes that trigger statistics reporting are set using local-period; whereas in hourly mode, the minutes that trigger statistics reporting are set using local-minutes.

history show file

history show file - Show the report file generation parameters

Description:
history show file displays the report file generation configuration parameters.

Syntax:

  history show file

history show local

history show local - Show the local history parameters

Description:
history show local displays the local history configuration parameters.

Syntax:

  history show local

history show scheduling

history show scheduling - Show the scheduling parameters

Description:
history show scheduling displays the scheduling configuration parameters.

Syntax:

  history show scheduling

© 2026 Cisco and/or its affiliates. All rights reserved.

For more information about trademarks, please visit:
Cisco trademarks 
For more information about legal terms, please visit:
Cisco legal terms