The model is transactional. We pay a big attention to have data in order, even if there was some error during processing. Furthermore, we want to know all historical operations within model for audit and other purposes.
Transaction is in-memory object used by platform to make model consistent. See transaction for more info. There are many parameters which can be tuned according to transactions. By default, we prefer database consistency over speed.
History objects are "frozen" successful transactions written to database, used for inspecting changes within history. See fcpc history for more info. Every history object has unique URL (furl).
Global history contains information about modifications of global objects. Like adding epoch, deleting epoch, managing tags and core objects.
Epoch history contains information about modifications within epoch. Like adding and modyfying objects, running epoch jobs and collections.
There are two kind of history objects. One for history within epoch and one for global platform management. Epoch history is lost after deleting epoch, while global history objects are never deleted.
According to our example, we can inspect which global changes were made during our scene. Please note that last history object is on the top.
fcpc history global
created description created_objects deleted_objects modified_objects furl
-------------------- ---------------------------------------- ----------------- ----------------- ------------------ -----------------------------------------------------
2022-11-07T10:28:18Z fcpc tag add test:unique1= 1 0 0 global:GlobalHistory/a524b34513d442059345db293d1d45df
2022-11-07T10:28:13Z fcpc tag add test:value1/ 1 0 0 global:GlobalHistory/7ecb3416d30841828cb00904fa6f31a2
2022-11-07T10:28:04Z fcpc tag add test:tag3 1 0 0 global:GlobalHistory/b51ec07fac144f47a5dcc301950f068f
...
According to our example, we can inspect which epoch changes were made within last epoch during our scene. Please note that last history object is on the top.
fcpc history epoch
created description created_objects deleted_objects modified_objects furl
-------------------- ------------------------------------------- ----------------- ----------------- ------------------ ---------------------------------------------------
2022-11-07T15:00:39Z tag-by-query 'asset+' 'vulnerable_medium... 0 0 0 epoch/new2:History/b65547d0587c459b9cf1ba34b633aa45
2022-11-07T15:00:38Z tag-by-query chunk 0 0 23 epoch/new2:History/9e2f008db07042bc9b5afba2fcfb7925
2022-11-07T14:58:55Z tag-by-query 'asset+' 'zabbix', also: le... 0 0 0 epoch/new2:History/2887e414a68944f19650acd0d17e4ed2
...
fcpc history show furl
# History object: History/cea8f2eac6b34cdca69ea8975846e237
- URL: History/cea8f2eac6b34cdca69ea8975846e237
- Full URL: epoch/new2:History/cea8f2eac6b34cdca69ea8975846e237
- Created: 2022-11-07T14:58:54Z
- Description: tag-by-query chunk
- ID: cea8f2eac6b34cdca69ea8975846e237
- Tags:
- history:objects:modified
- history:stats:modified=23
- history:stats:deleted=0
- history:stats:created=0
- history:time:spent=1017
- history:time:commit=93
- history:time:precheck=0
## Objects changed
- host/fw
## Objects created
- application/vm
Previous - Explaining objects hierarchy
Start - See all steps