# history

## Syntax

```
[no] history <instance> [<command>]
```

## Syntax Description

<table><thead><tr><th width="203">Keyword</th><th>Description</th></tr></thead><tbody><tr><td><code>no</code></td><td>(Optional) Deletes the specified history instance.</td></tr><tr><td>instance</td><td>The history instance to be created or modified. If the specified instance does not exist, it will be created unless the no keyword was also specified. Must be alphanumeric.</td></tr><tr><td>command</td><td>One of “empty”, “filter”, “interval”, “output-format”, “rename”, “url”, or “utc”. The command is required unless the <code>no</code> parameter is specified.</td></tr></tbody></table>

## Defaults

## Usage Guidelines

This command is used to create, modify, or delete a history file instance.

Island maintans a record of all device-related activity such as Internet access and session data counters, online and offline events, etc. These “history” events are stored internally in a compact binary format, and can be displayed with the show history command.

History data can formatted and saved in files to be transferred to a remote file server on a periodic basis. A history “instance” refers to a set of named history configuration commands that control the creation, format, transfer, and other characteristics of the associated history files.

The creation of history files is enabled with the [history interval](/island-router-cli-2.3.2/commands/history/history-interval.md) command. Therefore **when creating a new history instance, it is usually preferrable to issue all other desired history commands such as** [**history output-format**](/island-router-cli-2.3.2/commands/history/history-output-format.md) **and** [**history filter**](/island-router-cli-2.3.2/commands/history/history-filter.md) **before issuing the history interval command**, otherwise the system may create one or more initial history files with improper characteristics.

History files are automatically deleted upon successful transfer to the remote system. To see the list of history files waiting to be transferred, use the [show syslog history](/island-router-cli-2.3.2/commands/show-syslog.md) command.

An entire history instance can be deleted by entering this command with the `no` prefix. This will delete all unsent history files and all configuration commands associated with the instance.

## Examples

```
no history myhist2
```

## Related Commands

{% content-ref url="/pages/ulDg8sG29LkAenomh4hC" %}
[history empty](/island-router-cli-2.3.2/commands/history/history-empty.md)
{% endcontent-ref %}

{% content-ref url="/pages/IVug5476Bs8cLxzg5sEf" %}
[history filter](/island-router-cli-2.3.2/commands/history/history-filter.md)
{% endcontent-ref %}

{% content-ref url="/pages/fZrsDi5WtehDbETWv174" %}
[history interval](/island-router-cli-2.3.2/commands/history/history-interval.md)
{% endcontent-ref %}

{% content-ref url="/pages/x8FakxMJEVSyJcAQNRD1" %}
[history output-format](/island-router-cli-2.3.2/commands/history/history-output-format.md)
{% endcontent-ref %}

{% content-ref url="/pages/a96eij0daj6VTBAf7ZyP" %}
[history rename](/island-router-cli-2.3.2/commands/history/history-rename.md)
{% endcontent-ref %}

{% content-ref url="/pages/E9eoY0XKxKS0qDaguPtn" %}
[history url](/island-router-cli-2.3.2/commands/history/history-url.md)
{% endcontent-ref %}

{% content-ref url="/pages/3gKjnMsAinBq0GJtRECQ" %}
[history utc](/island-router-cli-2.3.2/commands/history/history-utc.md)
{% endcontent-ref %}

{% content-ref url="/pages/WdjwIUr3S2jwccuQ8rJS" %}
[show history](/island-router-cli-2.3.2/commands/show-history.md)
{% endcontent-ref %}

{% content-ref url="/pages/uoSfg7pzZjhUhgKPr0tt" %}
[show syslog](/island-router-cli-2.3.2/commands/show-syslog.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.islandrouter.com/island-router-cli-2.3.2/commands/history.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.