---
title: Machine Reports
description: Ubuntu is an open source software operating system that runs from the
  desktop, to the cloud, to all your internet connected things.
url: https://ps7.staging.ubuntu.com/security/livepatch/docs/livepatch_on_prem/explanation/machine_reports
---

*Submit*

# Machine Reports

Each machine running the Livepatch Client will periodically check in with its configured server.

The machine checks for patches and sends machine status information. The full list of information sent is documented [here](https://ubuntu.com/security/livepatch/docs/livepatch/reference/data).

## [Enabling Machine Reports](https://ps7.staging.ubuntu.com/security/livepatch/docs/livepatch_on_prem/explanation/machine_reports#p-119360-enabling-machine-reports)

See our [machine reports config](https://ps7.staging.ubuntu.com/security/livepatch/docs/livepatch_on_prem/reference/configuration#machine-reports) to enable machine reports and configure their retention period.

## [Generating Machine Reports](https://ps7.staging.ubuntu.com/security/livepatch/docs/livepatch_on_prem/explanation/machine_reports#p-119360-generating-machine-reports)

To generate machine reports use the Livepatch admin tool.
See [our how-to](https://ubuntu.com/security/livepatch/docs/livepatch_on_prem/how-to/administration_tool) on setting up the admin tool.

You can create machine reports where you query machines by their tier, last applied patch version or patch state.

`livepatch-admin report machines <tier> [<patch version> [<patch state]]`

---

[Previous

Logging and monitoring](https://ps7.staging.ubuntu.com/security/livepatch/docs/livepatch_on_prem/explanation/logging_and_monitoring)
[Next

Patch sync filters](https://ps7.staging.ubuntu.com/security/livepatch/docs/livepatch_on_prem/explanation/patch_sync_filters)

This page was last modified 2 years ago. [Help improve this document in the forum](https://discourse.ubuntu.com/t/machine-reports/47936).