Skip to content
Weik.ioDocs
2026.2
Try Weik.io

Observability

Weik.io 2026.2

Read 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.

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.

Terminal
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, --follow Prints new lines as they arrive, until you press Ctrl-C.
--since <since> Sets how far back to read, such as 10m.
--level <level> Shows only lines at this level or above, one of trace, debug, info, warn, error or fatal.
--query <query> Searches the lines with a LogsQL filter, such as error AND "timeout". A | or # must be inside quotes.
--limit <limit> Sets how many lines to read, at most 5,000.
--before <before> Shows lines older than the line with this ID.
--after <after> 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.
--agent <agent> Shows only the lines written by the agent with this ID.
--correlation-id <correlation-id> Shows only lines with this correlation id.
--histogram Prints line counts per interval and level instead of lines.
--interval <interval> Sets the width of one histogram interval, such as 5m or 1h.
--top-errors Prints the most common errors of the window instead of lines, one row per exception and route.
--build Prints a version’s build output instead of the log lines.
--version <version> 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.

Terminal
$ weikio logs finance/erp-invoice-export --env production --since 15m --level warn --limit 2
You see
14: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
Terminal
$ weikio logs finance/erp-invoice-export --env production --since 6h --histogram --interval 1h
You see
HOUR        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     0

weikio agent logs#

Show the agent’s own log lines.

Terminal
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, --follow Prints new lines as they arrive, until you press Ctrl-C.
--since <since> Sets how far back to read, such as 10m.
--level <level> Shows only lines at this level or above, one of trace, debug, info, warn, error or fatal.
--query <query> Searches the lines with a LogsQL filter, such as error AND "timeout". A | or # must be inside quotes.
--limit <limit> Sets how many lines to read, at most 5,000.
--before <before> Shows lines older than the line with this ID.
--after <after> 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.

Terminal
$ weikio agent logs agent-fi-02 --since 10m
You see
14: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.

Terminal
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, --follow Prints new lines as they arrive, until you press Ctrl-C.
--since <since> Sets how far back to read, such as 10m.
--level <level> Shows only lines at this level or above, one of trace, debug, info, warn, error or fatal.
--query <query> Searches the lines with a LogsQL filter, such as error AND "timeout". A | or # must be inside quotes.
--limit <limit> Sets how many lines to read, at most 5,000.
--before <before> Shows lines older than the line with this ID.
--after <after> 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.

Terminal
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.
--since <since> 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/health
  • GET /api/v1/platform/metrics
  • GET /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
Terminal
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
--since <since> 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.
--actor <actor> Shows only records by this actor, such as user:<id> or api-key:<id>.
--action <action> Shows only records of this action. Give the action’s name as -o json prints it, such as SecretRevealed.
--target-kind <target-kind> Shows only records about this kind of target, such as deployment.
--target <target> Shows only records about the target at this address, such as production.finance.erp-invoice-export.
--target-id <target-id> Shows only records about the target with this ID, including a deleted one.
--project-id <project-id> Shows only records in the project with this ID, including a deleted one.
--env-id <env-id> Shows only records in the environment with this ID, including a deleted one.
--outcome <outcome> Shows only records with this outcome, one of ok, denied, refused or error.
--limit <limit> Sets how many records to read, at most 1,000.
--before <before> Shows records older than the one with this sequence number.
--after <after> 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.

Terminal
$ weikio audit query --since 24h --action SecretRevealed
You see
TIME                   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.

Terminal
weikio audit show <correlation-id>
Argument or flag What it does
<correlation-id> 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.

Terminal
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.

Terminal
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
--limit <limit> Sets how many changes to read, at most 1,000.
--before <before> Shows changes older than the one with this sequence number.
--after <after> Shows changes newer than the one with this sequence number. Give 0 to start from the oldest.
--integration <integration> 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.

Terminal
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.
--query <query> Draws a MetricsQL expression over the metrics you can read.
--since <since> 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.

Terminal
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.
--errors Lists only failed traces.
--min-duration <min-duration> Lists only traces that took at least this long, such as 500ms or 2s.
--route <route> Lists only traces that ran in this route, given by the route’s id or by the endpoint it starts from.
--limit <limit> Sets how many traces to list, at most 1,000.
--before <before> Lists the traces that started before the one at this position. Copy the position from the command at the end of the list.
--after <after> Lists the traces that started after the one at this position.
--since <since> 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.

Terminal
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.

Terminal
weikio platform health [--server URL] [--watch] [-o json]
Argument or flag What it does
--watch 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.

Terminal
$ weikio platform health
You see
Server:     https://hub.example
Liveness:   ok
Readiness:  ok
Issuer:     https://hub.example

Exit 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.

See also#

Sign in to the live demo

Sign in with the shared viewer account. It can open every screen of the example projects but can't change anything.

E-mail
viewer@demo.weik.io
Password
try-weikio-live-demo
Open the live demo