On this page
Operator manual

app:metadata:status

Show the metadata sync status: how many tracks have genres, the metadata sync jobs that failed, and the sync jobs by type. The command shows what GET /api/admin/metadata/sync-status returns in the admin API, which the statistics of the admin metadata page read.

Quick start

make exec cmd="php bin/console app:metadata:status"

Options

Option Description
--json Print the status exactly as the API's data object, in JSON

Details

The metadata sync jobs are those that app:metadata:sync and the admin page run and the library, album, song, artist and genre syncs they queue. The counts cover every such job the job monitor still holds.

Metric Content
Total tracks All songs in the catalog
Tracks with genres Songs linked to at least one genre
Pending tracks Total tracks less those with genres and the failed sync jobs, at least 0
Failed sync jobs Metadata sync jobs that failed
Last sync Creation time of the newest metadata sync job in ISO 8601, or never

A second table lists the jobs by type, such as SyncAlbumMessage, with the number that finished and failed. When the monitor holds no metadata sync job, the command prints No metadata sync jobs are recorded. instead.

Exit codes

Code Meaning
0 Status printed
1 The status could not be read; the message says why