Australian cloud for business software — built and run in Sydney since 2003

NetLeverage
NetLeverage

Missing vCenter History: Retention, Filters or the Wrong Date?

Technical article
Troubleshooting

A missing event in the vSphere Client does not prove that a VM was never powered off. First establish the selected object and filters, then compare the incident date with the actual event-retention policy. If the event has been deleted, changing the query tool cannot recreate it. A VM creation timestamp is a different kind of evidence.

This is a source-only diagnostic for vCenter 8.0. No appliance, database or event store was inspected for this article. The examples are hypothetical.

Why the answer may be absent

The 8.0 event-view guide says the selected object's event list includes associated child-object events. It also allows filtering by event category, user type and time range. The visible list is therefore a view of retained evidence, not an unconditional history of every operation.

Retention is a separate boundary. vCenter can discard task and event information periodically, using separate cleanup settings. The retention guide says deletion can lag the configured period. An occasional older event is not proof that the organisation retains all events that old.

Finally, the property being requested may be wrong. KB 375957 distinguishes a VM's configuration creation date from power-off information derived from historical events. Creation is not a substitute for the most recent shutdown, nor evidence that a particular application was available at that time.

KB 375957 adds another limitation: VM power-off or creation dates might be unavailable before a recent vCenter reboot. Record the reboot timeline when assessing this case; the KB does not say that every reboot removes every historical event.

Inspect the view before changing the policy

Prerequisites are read access to the relevant vCenter inventory and its general settings, the VM's unambiguous identity and the incident interval with time zone. Record which vCenter owns the object. A familiar display name in another inventory is not the same VM.

Select the VM in the vSphere Client and inspect Monitor → Events. Expand candidate rows to read their details. Record the active category, user and time filters. Compare the incident interval with the filter range, and widen the view only as necessary within your permitted inventory scope. This is UI inspection, not a replay of the operation.

Then inspect the vCenter instance's Configure → Settings → General → Edit → Database dialog. Cancel the dialog after reading it. Record whether Event cleanup is enabled and its retention in days. Record Task cleanup separately. Do not click Save or change the maximum database connections while investigating missing history.

The event guide documents a default of 30 days. The deployed settings are the evidence: an upgraded appliance, a deliberate retention policy or a previous cleanup operation can make an assumption about defaults misleading. The configuration guide says cleanup limits database growth and warns not to use the retention options when a complete task/event history must be kept. Disabling cleanup is not a harmless way to answer a historical question.

Worked example: two different missing records

Suppose an administrator investigates a shutdown from 45 days ago. The event filter covers the last seven days, and Event cleanup is enabled with a 30-day retention. Removing the seven-day filter corrects one visibility problem, but does not promise to expose the 45-day-old record. The event may already have been purged.

Now suppose the investigation concerns yesterday. A user-type filter excludes the type of user that performed the operation. The same 30-day policy does not explain that absence; the filter is the first boundary to resolve. If the record remains absent after correct scope and filters, retain that result as unknown. Do not infer a shutdown time from the absence alone.

A third misleading result is a creation date of 1970-01-01T00:00:00Z. KB 375957 describes that default for VMs created before the 6.7 creation-date property was available. It is not evidence that the VM really dates from 1970. Likewise, a valid creation date does not establish its later power history.

Choose the next evidence source honestly

Where authorised external event archives, automation records or backup-job records already exist, they may supply independent timestamps. Label which system recorded each fact and what operation it actually observed. A backup job completion is not automatically a VM power-off event.

The KB supplies PowerCLI examples, but this article does not reproduce a query that could imply recovery of purged records. Supported API access can expose retained data or properties absent from a particular UI view; it cannot establish a missing historical event simply by changing the interface. Do not query or repair vCenter database tables to fill the gap.

Acceptance and reversal

The diagnostic result should say either which retained event answers the question, or which visibility and retention boundaries were checked and why the timestamp remains unknown. Preserve the object identity, time zone, relevant event detail and actual cleanup settings.

UI inspection requires no configuration rollback. Any later retention change needs a storage-capacity assessment and an archive requirement; restoring its previous value cannot restore already deleted records. No retention change or operational test has been performed here.

Learning notes

  • Filters and retention remove information for different reasons.
  • Task cleanup and event cleanup are separate settings.
  • A creation property cannot stand in for a power-off event.

References

Related articles