Skip to main content
Version: 3.9.0

history Command

The history command selects all changes inside a graph based on the given criteria.

Whenever changes are detected by Resoto, a dedicated change event is written as separate entity. Following changes are supported:

  • node_created: a node is added to the graph that has not been seen before.
  • node_updated: a node is delivered and is different to the one in the graph.
  • node_deleted: a node is no longer reported and gets deleted from the graph.

Usage

history [--before <timestamp>] [--after <timestamp>] [--change <change>] [search-statement]

Parameters

ParameterDescriptionRequired?Default Value
search-statmentSearch filter statement to filter the list of changes.

Options

OptionDescriptionRequired?
--before <timestamp>Only include changes before the ISO 8601 timestamp
--after <timestamp>Only include changes after the ISO 8601 timestamp
--change <type>Filter changes by type

Examples

Show all nodes changed in the last hour
> history --after 2022-01-01T03:00:
​change=node_updated, changed_at=2022-01-01T03:00:59Z, kind=kubernetes_config_map, id=73616434 name=leader, cloud=k8s
​change=node_deleted, changed_at=2022-01-01T04:40:59Z, kind=aws_vpc, id=vpc-1, name=resoto-eks, cloud=aws
Show all nodes created on 1.1.2022 between 03:00 and 06:00 (UTC)
> history --change node_created --after 2022-01-01T03:00:00Z --before 2022-01-02T06:00:00Z
​change=node_created, changed_at=2022-01-01T05:40:59Z, kind=aws_iam_role, id=AROA, name=some-role, cloud=aws
Show all changes to kubernetes resources in the kube-system namespace
> history is(kubernetes_resource) and namespace=kube-system
​change=node_created, changed_at=2022-11-18T12:00:49Z, kind=kubernetes_role, name=eks, namespace=kube-system
​change=node_updated, changed_at=2022-11-18T12:00:50Z, kind=kubernetes_config_map, name=cert, namespace=kube-system

Miscellaneous

The event history is only kept for a limited amount of time. The default retention time is 14 days. All changes that are older than that time are deleted from the database.

The current implementation only maintains the history of nodes, not edges.

Contact Us

Have feedback or need help? Don’t be shy—we’d love to hear from you!

 

 

 

Some Engineering Inc.