---
title: Snapshot
order: 18
description: "A point-in-time view of live state (the pool's occupancy or a tick of exported metrics), as opposed to accumulated history."
tags: [glossary, execution-and-caching]
---

# Snapshot

A point-in-time view of live state (the pool's occupancy or a tick of exported
metrics), as opposed to accumulated history.

## Elsewhere

A filesystem or VM snapshot freezes stored state so it can be restored; a snapshot test
compares output against a recorded file. A magus snapshot restores nothing: it is one reading
of live state.

## Example

```sh
magus status -o json
```

## Used in

<!-- BEGIN GLOSSARY USAGE (generated by glossary-usage-generate from the knowledge graph; edit the generator, not this list) -->

In the docs:

- [Live pool snapshot in a multiplexer sidebar](../guides/tips.md#live-pool-snapshot-in-a-multiplexer-sidebar)
- [Snapshot](../reference/api/metrics/v1alpha1/metrics.md#snapshot)

In the code (`magus refs <name>` lists every site):

- `audit.snapshot` (Go)
- `job.Snapshot` (Go)
- `queue.Snapshot` (Go)
- `race.snapshot` (Go)

<!-- END GLOSSARY USAGE -->

## See also

- [The broker and the daemon](../guides/integrations/server.md)
- [Backfill](backfill.md)