Observability
Weik.io 2026.2Read your installation's logs, metrics and traces with the weikio CLI, and look up problems and audit records. Video
Watch: What a running integration is doing, 4:24
The video opens the logs and metrics of a running integration and follows its traces, in the CLI and in the admin UI.
This part of the video couldn't be loaded.
On this page
Weik.io collects the telemetry of every integration and of every agent and hub process over OpenTelemetry. The commands on this page show it with the same filters as the admin UI. Use weikio problems to see what needs attention.
The commands that print a list leave standard output empty when they find nothing, and print one line on standard error.
Commands on this page#
| Command | What it does |
|---|---|
weikio logs |
Print the logs of an integration in one environment. |
weikio agent logs |
Show the agent’s own log lines. |
weikio platform logs |
Show the log lines of a hub process. |
weikio platform metrics |
Print the figures of one part of the platform over a window. |
weikio audit query |
List audit records, newest first. |
weikio audit show |
Print the audit records and log lines of a correlation id, oldest first. |
weikio problems |
List the problems you can see. |
weikio activity |
List the recent changes to the projects you may read, newest first. |
weikio metrics |
Show the metrics of an integration, an API or an environment, or chart one metric over a window. |
weikio traces |
List the traces of an integration, an API or an environment, newest first. |
weikio trace |
Print one trace as its steps. |
weikio platform health |
Print whether the backend is alive and ready, and list the platform’s parts for a platform administrator. |
The tables below leave out the flags every command accepts, such as --env and --project, which the CLI reference lists.
weikio logs#
Print the logs of an integration in one environment.
weikio logs <p>/<n> [--env E] [-f] [--since] [--from --to] [--level] [--agent] [--correlation-id] [--query] [--limit] [--before | --after] [--histogram [--interval]] [--top-errors] [--build --version]| Argument or flag | What it does |
|---|---|
<integration> |
Identifies the integration as project/name. |
-f, -- |
Prints new lines as they arrive, until you press Ctrl-C. |
-- |
Sets how far back to read, such as 10m. |
-- |
Shows only lines at this level or above, one of trace, debug, info, warn, error or fatal. |
-- |
Searches the lines with a LogsQL filter, such as error AND "timeout". A | or # must be inside quotes. |
-- |
Sets how many lines to read, at most 5,000. |
-- |
Shows lines older than the line with this ID. |
-- |
Shows lines newer than the line with this ID. |
--from <from> |
Sets the start of the window, as a time or as how long ago. |
--to <to> |
Sets the end of the window, as a time or as how long ago. |
-- |
Shows only the lines written by the agent with this ID. |
-- |
Shows only lines with this correlation id. |
-- |
Prints line counts per interval and level instead of lines. |
-- |
Sets the width of one histogram interval, such as 5m or 1h. |
-- |
Prints the most common errors of the window instead of lines, one row per exception and route. |
-- |
Prints a version’s build output instead of the log lines. |
-- |
Sets the version whose build output to print. |
Who can run it: any API key. You see only the lines that your read grants cover.
API: GET /api/v1/logs, GET /api/v1/logs/tail, GET /api/v1/logs/histogram, GET /api/v1/logs/top-errors.
$ weikio logs finance/erp-invoice-export --env production --since 15m --level warn --limit 214:31:02.118 UTC WARN fetch-invoices agent-fi-02 HTTP 429 from https://erp.example.internal/api/invoices/pending, retrying in 30 s
14:31:32.204 UTC WARN fetch-invoices agent-fi-02 HTTP 429 from https://erp.example.internal/api/invoices/pending, retrying in 60 s
To read older lines, run:
weikio logs finance/erp-invoice-export --env production --since 15m --level warn --limit 2 --before GNf5pJG7hYAAyvg9zpCA$ weikio logs finance/erp-invoice-export --env production --since 6h --histogram --interval 1hHOUR INFO WARN ERROR
09:00 UTC 612 0 0
10:00 UTC 598 0 0
11:00 UTC 601 0 0
12:00 UTC 604 2 0
13:00 UTC 590 14 1
14:00 UTC 211 38 0weikio agent logs#
Show the agent’s own log lines.
weikio agent logs <id|name> [-f] [--since] [--level] [--query] [--limit] [--before | --after]| Argument or flag | What it does |
|---|---|
<agent> |
Identifies the agent by its name or ID. |
-f, -- |
Prints new lines as they arrive, until you press Ctrl-C. |
-- |
Sets how far back to read, such as 10m. |
-- |
Shows only lines at this level or above, one of trace, debug, info, warn, error or fatal. |
-- |
Searches the lines with a LogsQL filter, such as error AND "timeout". A | or # must be inside quotes. |
-- |
Sets how many lines to read, at most 5,000. |
-- |
Shows lines older than the line with this ID. |
-- |
Shows lines newer than the line with this ID. |
Who can run it: a platform administrator.
API: GET /api/v1/logs, GET /api/v1/logs/tail.
$ weikio agent logs agent-fi-02 --since 10m14:40:02.001 UTC INFO Deployment 'production/finance/erp-invoice-export (01k5xb7q2r4t6v8w0y2z4a6c8e)' is restarting, because its version changed from 1.1.0 to 1.0.0.
14:40:04.214 UTC INFO Deployment 'production/finance/erp-invoice-export (01k5xb7q2r4t6v8w0y2z4a6c8e)' stopped process 4188 within its 70 s stop deadline.
14:40:05.870 UTC INFO Deployment 'production/finance/erp-invoice-export (01k5xb7q2r4t6v8w0y2z4a6c8e)' started as process 4210 (version 1.0.0, Camel 4.22.1). It counts as starting until its health check replies.weikio platform logs#
Show the log lines of a hub process.
weikio platform logs backend|apim [-f] [--since] [--level] [--query] [--limit] [--before | --after]| Argument or flag | What it does |
|---|---|
<process> |
Identifies the hub process, backend or apim. |
-f, -- |
Prints new lines as they arrive, until you press Ctrl-C. |
-- |
Sets how far back to read, such as 10m. |
-- |
Shows only lines at this level or above, one of trace, debug, info, warn, error or fatal. |
-- |
Searches the lines with a LogsQL filter, such as error AND "timeout". A | or # must be inside quotes. |
-- |
Sets how many lines to read, at most 5,000. |
-- |
Shows lines older than the line with this ID. |
-- |
Shows lines newer than the line with this ID. |
Who can run it: a platform administrator.
API: GET /api/v1/logs, GET /api/v1/logs/tail.
weikio platform metrics#
Print the figures of one part of the platform over a window.
weikio platform metrics backend|apim|agent <id>|hub [--since D] [--top] [-o json]| Argument or flag | What it does |
|---|---|
<part> |
Identifies the part of the platform, one of backend, apim, agent or hub. |
<id> |
Identifies the agent by its ID or name when the part is agent. |
-- |
Sets how far back the figures reach, such as 6h or 7d. The default is an hour. |
--top |
Lists the metric names and services with the most metrics, when the part is hub. |
Who can run it: a platform administrator.
API:
GET /api/v1/platform/healthGET /api/v1/platform/metricsGET /api/v1/platform/series
weikio audit query#
List audit records, newest first. Records stay in the audit log for 400 days.
Weik.io writes an audit record for changes and for sensitive actions:
- A change made through the API
- A secret reveal or delivery
- An agent enrolment or revocation
- A backup or restore
- A read of the audit log
weikio audit query [--since 24h] [--from --to] [--actor A] [--action ACTION] [--target-kind K] [--target ADDRESS | --target-id ID] [--outcome ok|denied|refused|error] [--project P | --project-id ID] [--env E | --env-id ID] [--limit N] [--before SEQ | --after SEQ]| Argument or flag | What it does |
|---|---|
-- |
Sets how far back to read, such as 24h. |
--from <from> |
Sets the start of the window. |
--to <to> |
Sets the end of the window. |
-- |
Shows only records by this actor, such as user:<id> or api-key:<id>. |
-- |
Shows only records of this action. Give the action’s name as -o json prints it, such as SecretRevealed. |
-- |
Shows only records about this kind of target, such as deployment. |
-- |
Shows only records about the target at this address, such as production.finance.erp-invoice-export. |
-- |
Shows only records about the target with this ID, including a deleted one. |
-- |
Shows only records in the project with this ID, including a deleted one. |
-- |
Shows only records in the environment with this ID, including a deleted one. |
-- |
Shows only records with this outcome, one of ok, denied, refused or error. |
-- |
Sets how many records to read, at most 1,000. |
-- |
Shows records older than the one with this sequence number. |
-- |
Shows records newer than the one with this sequence number. Give 0 to start from the oldest. |
Who can run it: a platform administrator, or a project’s admin for the records of their projects.
API: GET /api/v1/audit?from&to&actor&action&targetKind&targetId&targetUid&outcome&correlationId&project&projectUid&environment&environmentUid&limit&before&after.
$ weikio audit query --since 24h --action SecretRevealedTIME ACTOR ACTION TARGET OUTCOME IP REASON
2026-09-16 14:36 UTC ville@example.com Not allowed to reveal a secret in production Secret finance/erp-api-key in production denied 10.1.4.31 -
2026-09-16 09:02 UTC anna@example.com Revealed a secret in devtest Secret finance/erp-api-key in devtest ok 10.1.4.22 -weikio audit show#
Print the audit records and log lines of a correlation id, oldest first. A correlation id ties one CLI call to its audit records and to the hub’s log lines.
weikio audit show <correlation-id>| Argument or flag | What it does |
|---|---|
<correlation- |
Identifies the CLI call by its correlation id. |
Who can run it: a platform administrator, or a project’s admin for the records of their projects.
API: GET /api/v1/audit?correlationId=&limit=1000, GET /api/v1/logs?whole=true&order=oldest.
weikio problems#
List the problems you can see. Each row has a figure, such as 42 of 310 failed in 15 min, and a detail that ends with the command that shows more. Each kind of problem has its own page under Problems.
weikio problems [--env E] [--project P]Who can run it: any API key. You see the rows of what you may read.
API: GET /api/v1/summary/problems?environment=&project=.
weikio activity#
List the recent changes to the projects you may read, newest first. The admin UI shows the same list in its Recent activity panel.
weikio activity [--project P] [--env E] [--integration I] [--api A] [--from T --to T] [--limit N] [--before SEQ | --after SEQ]| Argument or flag | What it does |
|---|---|
-- |
Sets how many changes to read, at most 1,000. |
-- |
Shows changes older than the one with this sequence number. |
-- |
Shows changes newer than the one with this sequence number. Give 0 to start from the oldest. |
-- |
Shows only the changes to this integration, written as project/name or as a name. |
--api <api> |
Shows only the changes to this API, written as project/name or as a name. |
--from <from> |
Sets the start of the window, as a time or as how long ago. |
--to <to> |
Sets the end of the window, as a time or as how long ago. |
Who can run it: any API key. You see the changes in the projects you may read.
API: GET /api/v1/activity?project=&environment=&integration=&api=&from=&to=&limit=&before=&after=, GET /api/v1/users/_emails?ids=.
weikio metrics#
Show the metrics of an integration, an API or an environment, or chart one metric over a window.
weikio metrics <p>/<n> [--env E] [--since D | --from T --to T]| Argument or flag | What it does |
|---|---|
<integration> |
Identifies the integration as project/name. |
--api <api> |
Shows an API instead, as project/name, or as project/name@version for one version. |
--name <name> |
Draws the metric with this name. |
--agg <agg> |
Sets how the metric is aggregated over each step, one of rate, increase, last, max, min, avg, p50, p95 or p99. It applies when --name is a stored metric or the integration’s own counter. |
--by <by> |
Sets what to split a chart by. |
--step <step> |
Sets the time each point of a chart covers, such as 5m. |
-- |
Draws a MetricsQL expression over the metrics you can read. |
-- |
Sets how far back to read, such as 10m. |
--from <from> |
Sets the start of the window, as a time or as how long ago. |
--to <to> |
Sets the end of the window, as a time or as how long ago. |
--name accepts a stored metric name or a figure such as failed or memory. It also accepts the integration’s own counter, such as invoices.processed.
The values of --by depend on what the chart shows:
| Chart of | Values of --by |
|---|---|
| An integration | route, agent or version |
| An API | status, version, route or subscription |
| An environment | integration or api |
| The integration’s own counter | agent, version or one of the counter’s attributes |
API: GET /api/v1/metrics, GET /api/v1/metrics/names, GET /api/v1/metrics/metadata, GET /api/v1/metrics/summary.
weikio traces#
List the traces of an integration, newest first. With --api or --env instead, the command lists the traces of an API or of an environment.
weikio traces <p>/<n> | --api <p>/<api>[@<v>] | --env E [--project P] [--errors] [--min-duration D] [--route R] [--limit N] [--before P | --after P] [--since D | --from T --to T]| Argument or flag | What it does |
|---|---|
<integration> |
Identifies the integration as project/name. |
--api <api> |
Lists the traces of an API instead, as project/name, with @version for one version. |
-- |
Lists only failed traces. |
-- |
Lists only traces that took at least this long, such as 500ms or 2s. |
-- |
Lists only traces that ran in this route, given by the route’s id or by the endpoint it starts from. |
-- |
Sets how many traces to list, at most 1,000. |
-- |
Lists the traces that started before the one at this position. Copy the position from the command at the end of the list. |
-- |
Lists the traces that started after the one at this position. |
-- |
Sets how far back to read, such as 10m. |
--from <from> |
Sets the start of the window, as a time or as how long ago. |
--to <to> |
Sets the end of the window, as a time or as how long ago. |
Who can run it: any API key. You see only the traces that your read grants cover.
API: GET /api/v1/traces.
weikio trace#
Print one trace as its steps.
weikio trace <trace-id|traceparent|message-id> [-o json]| Argument or flag | What it does |
|---|---|
<trace> |
Identifies the trace by its trace id, a traceparent header or a message id. |
Who can run it: any API key. You see only the steps that your read grants cover.
API: GET /api/v1/traces/{id}, GET /api/v1/traces?exchangeId=.
weikio platform health#
Print whether the backend is alive and ready. With a platform administrator’s key, the command also lists the agents and the other parts of the platform, such as the backend nodes and the APIM instances. Each part’s row shows its version, uptime, CPU, memory, disk and when it was last seen. When a part is offline, the command prints the health and exits with 6.
weikio platform health [--server URL] [--watch] [-o json]| Argument or flag | What it does |
|---|---|
-- |
Draws the health again every 30 s until you stop it, and adds the platform’s latest warnings and errors under it. |
Who can run it: anyone for whether the backend is alive and ready, and a platform administrator for the parts of the platform.
API: GET /healthz, GET /readyz, GET /.well-known/openid-configuration, GET /api/v1/platform/health, GET /api/v1/logs.
$ weikio platform healthServer: https://hub.example
Liveness: ok
Readiness: ok
Issuer: https://hub.exampleExit codes#
The codes match the exit code table in the CLI reference.
| Code | Meaning |
|---|---|
| 0 | The command succeeded. |
| 1 | The command stopped without making the change. |
| 2 | The command has a usage error. |
| 3 | Your key is missing, expired or revoked, or its access doesn’t cover the command. |
| 4 | What you named doesn’t exist. |
| 5 | The change conflicts with another change. |
| 6 | Weik.io couldn’t be reached or wasn’t ready, or it was rate limiting your calls or out of storage. Run the command again later. |
| 8 | A document isn’t valid. |