edge-view:log-gathering
Table of Contents
Viewing Real-Time EVE Logs with Edge-View
The Zededa UI shows logs, but they are batched and delayed (~15 min). To see logs live, pull them straight from the edge node with Edge-View. It works remotely over a secure connection — no SSH and no need to be on the device's network.
Before You Start
- Enable a session in the UI: Edge Nodes → (your edge node) → Remote Access → Enable session.
- Enabling gives you a run script with the token already embedded, e.g.
run.CHENNAI-SERVER.edgeview.sh. Download it and chmod +x it.
Basic Usage
./run.CHENNAI-SERVER.edgeview.sh [options] <query>
For logs, the query is log/<word> — it searches the logs for <word>.
Log Examples
| Command | What it does |
|---|---|
./run...edgeview.sh -inst 1 log/<match> | Only lines containing “<match>” |
| Command | What it does (sample matches) |
|---|---|
./run...edgeview.sh -inst 1 log/guest | Container / app console + boot logs (the “inside the container” view) |
./run...edgeview.sh -inst 1 log/nginx | Only lines containing “nginx” |
./run...edgeview.sh -inst 1 log/error | Only lines containing “error” |
./run...edgeview.sh -inst 1 log/guest -type app | Force the application log stream (container stdout) |
./run...edgeview.sh -inst 1 log/guest -type dev | EVE system log stream (app start/stop/download lifecycle) |
./run...edgeview.sh -inst 1 app/<app-name> | Status/info for an app instance |
Useful Options
| Option | What it does | Example |
|---|---|---|
-inst 1 | Pick the connection slot. Required when it says “multi-instance mode”. | -inst 1 |
-line N | Return more lines (default is small). | -line 300 |
-time A-B | Limit to a time window. | -time 0-0.5 (last half hour) |
-type app⎮dev | Choose container logs (app) vs EVE system logs (dev). | -type app |
-json | Output as JSON. | -json |
Tips
- Always add
-inst 1if it prints “multi-instance mode”. - If you get only a few boot lines, raise
-lineand widen-time. log/guest= the container's own output (nginx, your startup script).
log/<dev/system word> with -type dev = EVE's lifecycle logs.
Quick Recipe: Watch a Container Boot
# everything the container printed, recent, targeted ./run.<device>.<id>.edgeview.sh -inst 1 log/guest -type app -line 300
Reference
- Edge-View command reference: lf-edge/eve – pkg/edgeview/README.md
edge-view/log-gathering.txt · Last modified: by mc