Skip to content

The only tool you need to know what is happening and how to fix it.

no more Process tab by default + docs update + correct website page data

ddux90b6de90282c
diff --git a/backend/app/controllers/widget_group.controller.go b/backend/app/controllers/widget_group.controller.go
index d5dcf8f5..0051ff62 100644
--- a/backend/app/controllers/widget_group.controller.go
+++ b/backend/app/controllers/widget_group.controller.go
@@ -333,10 +333,9 @@ func ensureDefaultWidgetGroups(tx *sql.Tx, projectId uuid.UUID) error {
var groupDefs []groupDef
if isOtel {
- // Defaults track what `traceway-otel-agent` emits out-of-the-box from
- // hostmetricsreceiver (cpu/memory/load/disk/filesystem/network/process
- // scrapers, with *.utilization opt-ins). See config/default.yaml in
- // traceway-otel-agent for the source set.
+ // Defaults track what `traceway-otel-agent` emits out-of-the-box. The
+ // `process` scraper is opt-in (TRACEWAY_PROCESS_NAMES) as of v0.5.0
+ // and intentionally excluded here — seeding it produced empty tabs.
groupDefs = append(groupDefs,
groupDef{
name: "System",
@@ -370,14 +369,6 @@ func ensureDefaultWidgetGroups(tx *sql.Tx, projectId uuid.UUID) error {
{title: "Open Connections", name: "system.network.connections"},
},
},
- groupDef{
- name: "Process",
- widgets: []widgetDef{
- {title: "Process CPU Time", name: "process.cpu.time"},
- {title: "Process RSS", name: "process.memory.usage"},
- {title: "Process Virtual", name: "process.memory.virtual"},
- },
- },
)
} else {
if !isJS {
diff --git a/docs/pages/learn/otel-agent.mdx b/docs/pages/learn/otel-agent.mdx
index 4857eee5..a82f322b 100644
--- a/docs/pages/learn/otel-agent.mdx
+++ b/docs/pages/learn/otel-agent.mdx
@@ -2,7 +2,7 @@
import { Callout, Steps } from "nextra/components";
-The **Traceway OTel Agent** is a tiny, pre-configured OpenTelemetry Collector that pulls host metrics (CPU, memory, disk, filesystem, network, processes) from a server every 60 seconds and ships them to your Traceway project over OTLP/HTTP. Runs as a background service via `systemd`, `launchd`, or the Windows Service Manager — nothing to write, nothing to tune.
+The **Traceway OTel Agent** is a tiny, pre-configured OpenTelemetry Collector that pulls host metrics (CPU, memory, disk, filesystem, network) from a server every 60 seconds and ships them to your Traceway project over OTLP/HTTP. Runs as a background service via `systemd`, `launchd`, or the Windows Service Manager — nothing to write, nothing to tune.
<Callout type="info">
Full source, advanced config, and the contributor guide live at
@@ -45,7 +45,7 @@ Every 60 seconds the agent scrapes:
- **Disk** — throughput bytes, IOPS, I/O time per device.
- **Filesystem** — usage bytes and utilization % per mount.
- **Network** — throughput bytes, packets, errors, and open connections per interface.
-- **Process** — per-process CPU time, RSS, and virtual memory.
+- **Process** *(opt-in)* — set `TRACEWAY_PROCESS_NAMES` to a list of process names (or `*` for all) to enable per-process CPU time, RSS, and virtual memory.
Every signal is tagged with resource attributes so you can filter in the dashboard — `service.name`, `host.name`, `host.id`, `host.arch`, `os.type`, and on cloud VMs, `cloud.provider`, `cloud.region`, and `cloud.account.id` (EC2 / GCE / Azure are auto-detected).
@@ -53,11 +53,12 @@ Every signal is tagged with resource attributes so you can filter in the dashboa
Set these env vars alongside `TRACEWAY_TOKEN` before piping into the shell:
-| Var | Purpose |
-| ----------------------- | ------------------------------------------------------------------------------------------------------ |
-| `TRACEWAY_SERVICE_NAME` | `service.name` label for this host. Default: the machine's hostname. |
-| `TRACEWAY_ENDPOINT` | OTLP/HTTP base URL. Override when running against self-hosted Traceway. |
-| `TRACEWAY_LOG_PATHS` | Comma-separated file globs to tail as logs (e.g. `/var/log/app/*.log`). Leave unset to ship metrics only. |
+| Var | Purpose |
+| ------------------------- | ------------------------------------------------------------------------------------------------------ |
+| `TRACEWAY_SERVICE_NAME` | `service.name` label for this host. Default: the machine's hostname. |
+| `TRACEWAY_ENDPOINT` | OTLP/HTTP base URL. Override when running against self-hosted Traceway. |
+| `TRACEWAY_LOG_PATHS` | Comma-separated file globs to tail as logs (e.g. `/var/log/app/*.log`). Leave unset to ship metrics only. |
+| `TRACEWAY_PROCESS_NAMES` | Comma-separated process names (e.g. `myapp,postgres`) or `*` for all. Off by default — enables per-process CPU / memory metrics. |
Example — named host, app logs, self-hosted Traceway:
diff --git a/website/app/product/metrics/page.tsx b/website/app/product/metrics/page.tsx
index 630f61f7..99e63899 100644
--- a/website/app/product/metrics/page.tsx
+++ b/website/app/product/metrics/page.tsx
@@ -65,13 +65,13 @@ export default function MetricsPage() {
title="CPU, memory, disk, network — one line to install"
description={
<>
- The <Link href="https://github.com/tracewayapp/traceway-otel-agent" style={{ color: "var(--a2)", textDecoration: "underline" }}>Traceway OTel Agent</Link> is a pre-built OpenTelemetry Collector distribution that scrapes host metrics every 30 seconds and ships them to your project over OTLP/HTTP. Install with a single curl, no config file required.
+ The <Link href="https://github.com/tracewayapp/traceway-otel-agent" style={{ color: "var(--a2)", textDecoration: "underline" }}>Traceway OTel Agent</Link> is a pre-built OpenTelemetry Collector distribution that scrapes host metrics every 60 seconds and ships them to your project over OTLP/HTTP. Install with a single curl, no config file required.
</>
}
bullets={[
"One-line install on Linux (systemd), macOS (launchd), or Windows",
- "CPU, memory, load, disk, filesystem, network, process",
- "30-second collection interval via hostmetricsreceiver",
+ "CPU, memory, load, disk, filesystem, network",
+ "60-second collection interval via hostmetricsreceiver",
"Runs alongside your apps — no code changes",
"Also tails any log files you point it at (opt-in)",
]}
@@ -152,10 +152,12 @@ export default function MetricsPage() {
</Link>{" "}
is a pre-built OpenTelemetry Collector distribution that
you install on the host with a single curl. It scrapes
- CPU, memory, load, disk, filesystem, network, and
- per-process metrics via the upstream{" "}
- <code>hostmetricsreceiver</code> every 30 seconds and
+ CPU, memory, load, disk, filesystem, and network
+ metrics via the upstream{" "}
+ <code>hostmetricsreceiver</code> every 60 seconds and
ships them to your Traceway project over OTLP/HTTP.
+ Per-process metrics are opt-in via{" "}
+ <code>TRACEWAY_PROCESS_NAMES</code>.
</p>
<p>
No config file to write — you set{" "}