History¶

Pulp Server keeps track of operations performed on its consumers in the consumer’s history. The events tracked in the history and their respective event types are as follows:

Consumer Registered - consumer_registered
Consumer Unregistered - consumer_unregistered
Repository Bound - repo_bound
Repository Unbound - repo_unbound
Content Unit Installed - content_unit_installed
Content Unit Uninstalled - content_unit_uninstalled
Unit Profile Changed - unit_profile_changed
Added to a Consumer Group - added_to_group
Removed from a Consumer Group - removed_from_group

Note that only operations that are triggered through Pulp are logged. If the consumer installs a content unit through another means (eg. rpm, yum etc.) an event will not be logged. The package profile, however, will eventually be sent to the server and will reflect any changes that have been made.

A consumer can view its own history using the consumer history command. A number of query arguments may be passed in to the consumer history command in order to refine the results. Here are a few examples of querying consumer history:

$ pulp-consumer history --limit 2 --sort ascending --event-type repo_bound
+----------------------------------------------------------------------+
                      Consumer History [consumer1]
+----------------------------------------------------------------------+

Consumer Id:  test-consumer
Type:         repo_bound
Details:
  Distributor Id: yum_distributor
  Repo Id:        test-repo1
Originator:   SYSTEM
Timestamp:    2013-01-17T05:43:36Z


Consumer Id:  test-consumer
Type:         repo_bound
Details:
  Distributor Id: yum_distributor
  Repo Id:        test-repo2
Originator:   SYSTEM
Timestamp:    2013-01-17T05:49:09Z

$ pulp-consumer history --start-date 2013-01-17T19:00:00Z --end-date 2013-01-17T21:00:00Z
+----------------------------------------------------------------------+
                      Consumer History [consumer1]
+----------------------------------------------------------------------+

Consumer Id:  consumer1
Type:         consumer_registered
Details:      None
Originator:   admin
Timestamp:    2013-01-17T19:14:49Z