OPA sends status reports whenever one of the following happens:

The status updates will include a set of labels that uniquely identify the OPA instance. OPA automatically includes an value in the label set that provides a globally unique identifier or the running OPA instance and a version value that provides the version of OPA.

See the for configuration details.

The partition name is an optional path segment that can be used to route status updates to different backends. If the partition name is not configured on the agent, updates will be sent to /status.

Status updates contain the following fields:

If the bundle download or activation failed, the status update will contain the following additional fields.

Services should reply with HTTP status 200 OK if the status update is processed successfully.

Local Status Logs

Local console logging of status updates can be enabled via the console config option. This does not require any remote server. Example of minimal config to enable:

This will dump all status updates to the console. See for more details.