Moorhold docs

Moorhold keeps an audit log of what people and their agents asked it to do, and of what agents did in the tools with a person's token. Admins read it on the portal's Agent audit page. This page lists the fields of a record and the actions in the latest release (2026.11.4).

The log keeps 183 days by default.

Field What it is
at When, as an ISO 8601 time in UTC.
user The person it was done for.
client The sign-in client it came through: an agent's client, or the portal's.
channel Where it arrived. See below.
action What was asked. See below.
args The arguments, with secret values taken out.
outcome ok, denied or error.
detail Why it was denied or failed, when it was.
sourceId For a record collected from a tool, the tool's own event id. Moorhold ignores a second record with the same id.
Channel Records
mcp Calls to the portal's MCP server. The action is the tool's name.
shell What people do in the portal.
cli What moorhold commands do.
host What the server's own services do when they act on an approval.
keycloak Tokens Keycloak issued and exchanged, collected from its events.
a tool's audience, such as trino Calls a person, or their agent, made in that tool, collected from the tool's own events.

An agent that reads a tool directly uses a token Keycloak exchanged for that tool. The log joins each call in a tool to the same person's latest token.exchange for that tool's audience, made shortly before it. The Agent audit page shows which agent made the call.

Action Means
proposal.approve Someone approved a proposal.
proposal.reject Someone rejected a proposal.
proposal.withdraw Someone withdrew a proposal, or the change it applied.

When the only admin approves their own upgrade, the record's detail says self-approved, only admin.

propose_source, get_proposal, list_proposals, cancel_proposal, list_mcp_endpoints, list_metrics and run_metric, on the mcp channel. A call outside the person's rights is denied with the detail not permitted for this user. For run_metric, the record keeps the metric's name and the column and operator names, never a condition's value.

Action Means
sources.apply A source was added or changed.
sources.propose A change to a source was proposed for approval.
sources.delete A source was removed.
sources.first-load A source's first load was started.
Action Means
stack.reconcile Someone asked the reconciler to run now.
stack.upgrade.propose An upgrade was proposed for approval.
stack.upgrade.apply An approved upgrade was applied.
Action Means
updates.check The server checked for an update.
updates.offer An update was offered.
updates.request An admin asked for an update.
updates.approve An admin approved an update.
updates.schedule An update was set for a time.
updates.cancel An update request was cancelled.
updates.install An update was installed.
updates.hold An update was held back.
updates.skip A release was skipped.
updates.mode The update setting changed.
updates.timer The maintenance window's timer was written or removed.
updates.automatic.on, updates.automatic.off Automatic updates were turned on or off.
updates.automatic.change The automatic updates window changed.
updates.automatic.pause, updates.automatic.resume Automatic updates were paused or resumed.
updates.automatic.wait An automatic update waited, for example for approval.
updates.automatic.refused An automatic update was refused.

requests.<action>, such as requests.memory-resize, requests.set-secret and requests.add-sample-data: the server acted on an approved request.

Action Means
memory.request An admin asked for more memory for an app. The record's detail says "Asked for and approved by" and their name, because one admin is enough.
memory.approve An admin approved a request that was still waiting from before 2026.11.2.
memory.cancel It was cancelled.
Action Means
setup.sign-in, setup.password, setup.data, setup.run, setup.skip A step of first-run setup.
setup.sample-ask, setup.sample-approve, setup.sample-cancel Asking for the sample data from the first-run page, approving the request, or cancelling it.
setup.refused A setup step was refused, such as a wrong setup code.
identity.user.password-reset A person's password was reset.
identity.serviceaccount.grant A service account was given its roles.
mail.save, mail.fill, mail.remove, mail.test, mail.password The server's mail settings were saved, filled in, removed or tested, or their password set.
Action Means
token.issue Keycloak signed a person in to a client.
token.issue.client A client signed in as itself.
token.exchange A person's token was exchanged for one for a tool. The record names the agent client and the tool's audience.

query.<type>, such as query.select: a query in Trino, collected from its events, on the trino channel.