PROMESCOPE

🔭 The board — what you see

One live list of every metric series the endpoint is reporting, refreshed on a countdown you can see — and pause. Each row is plain:

• NAME — what the metric is called.
• TYPE — what kind it is (the kinds are explained below, in plain words, every time).
• VALUE — its number right now, written the way a human reads numbers. A strange value is shown as itself — never “fixed” into something plausible.
• LABELS — the details that tell one series from its brothers: which processor, which disk, which job.
• HELP — the endpoint's own description of the metric, in its own words. Where an endpoint doesn't describe a metric, the board says so — it never invents one.

Big servers can hold tens of thousands of series, so the board loads in chunks and shows its progress in the header — and everything already loaded stays fully usable while the rest arrives. If a load is interrupted, the board says exactly what it has and what it doesn't.

🔌 Two doors in — a server, or an exporter

Prometheus-shaped things come in two shapes, and PROMESCOPE speaks both:

• A Prometheus server — the program that collects measurements and answers questions. Paste its address and PROMESCOPE reads it through the server's own documented interface: the metric names, the types and descriptions, the targets behind them, and live values.
• An exporter page — a single program's own metrics page (a /metrics address). There's no server behind it, just the standard text — and PROMESCOPE parses that text line by line into the same board. A histogram arrives as a family of rows, and the board says so in plain words instead of leaving you to guess why one metric has fourteen rows.

Paste an address and the app works out which kind it is — and if the answer is ever unclear, it asks you, with two big buttons. The header always shows which kind it believes it's talking to, and you can override it. Nothing is ever a silent guess.

↕️ Sort it, filter it

Click a column name — NAME, TYPE, VALUE, LABELS, HELP — and the board re-orders by that column; click again to flip it. VALUE sorts by real numbers, so 9 lands before 10. The filter row cuts the board down to just what you're hunting: one type, or your own text matched against names, labels, and help — and the counter tells you the truth: showing X of Y. Sorting and filtering work on data already in the window; they send nothing anywhere and ask the endpoint nothing extra. Restart the app and it starts unfiltered, so yesterday's filter can never hide today's board from you.

And your place is yours: a refresh never swaps the row you picked for a neighbor, and never yanks your scroll back to the top while you're reading.

🔍 One series — the whole story

Click any row and the detail pane tells you everything about that one series: its full labels, the endpoint's own description, its current value with the exact time it was fetched, and a sparkline — a small chart of its recent history. The type is explained in plain words, every time:

• COUNTER — counts up, like an odometer. Watch how fast it climbs; a drop means the counter restarted.
• GAUGE — a level that goes up and down, like a thermometer.
• HISTOGRAM / SUMMARY — a spread of measurements shown as a family of series: buckets, a sum, and a count.
• UNTYPED — the endpoint didn't declare a kind. The app shows it as untyped — it won't guess one.

On a server, the sparkline comes from the server's own history. An exporter keeps no history, so there the app remembers the values it has seen since you opened it — and labels the chart with exactly that truth. It never pretends to be a longer history than it is.

📈 The graph screen

When a sparkline isn't enough, the graph screen draws a series' history as a real graph over the window you pick — 15 minutes, 1 hour, 6 hours, or 24 hours — and up to five series at once, each in its own color, so “is it climbing, and when did it start?” is something you can see, not squint at. On a server, the graph comes from the server's own stored history. On an exporter connection, the graph is drawn from what the app has watched since you connected, and says so.

❓ Ask it yourself — PromQL

On a server connection, a query box lets you ask your own questions in PromQL — Prometheus's question language — and the answers land in the same clean table. If the server can't run a question, PROMESCOPE shows the server's own answer plus a plain-words version of what it means; a question that ran fine and matched nothing says exactly that, which is a different sentence from every failure. Every result is stamped with the time it ran — a result is always labeled with when it was true.

On an exporter page there is honestly no query box: an exporter has no question-answering engine, and faking one would be pretend. The program says so, in one plain line.

🎯 Targets — what's being watched

On a server connection, a second view lists every scrape target the server knows: which job, which machine, whether it's UP ✓, DOWN ✖, or NOT KNOWN ? — a word and a symbol, never color alone — when it was last scraped, and, when a scrape failed, the server's own error words, shown verbatim, because that's the most useful sentence on the screen. The broken things sort first, because there the broken things are the point.

🤝 Honest, or nothing

• Every value carries its fetch time. The header shows when the board last updated; the pane stamps its value; query results stamp their run.
• Stale is said out loud. If the endpoint can't be reached, a banner says so and the board keeps showing the last true data — labeled with when it was true. It never keeps a “live” countdown running over dead data.
• Errors in plain words. Unreachable, refused, wants a login this profile doesn't have, answered but not as a Prometheus endpoint — each is its own sentence, written for a person, with the technical detail underneath, never instead.
• Nothing invented. Missing descriptions and missing types are shown as missing. Disagreements between sources are shown as disagreements. Partial loads are labeled partial, with the count.

🔒 Your machine, your business

Your connections live in one file on your computer only — your named profiles, their addresses, and any sign-in they need, locked to your account alone (permissions 0600). After you save one, its secret shows as “saved” — it is never shown again, never printed in a log, and never sent anywhere except to that profile's own endpoint when you connect to it. A login that fails stops and asks you — the app never loops your credentials at a server.

The app only ever asks questions and reads answers — never the parts of the interface that can change or delete anything. The strongest verbs in the whole program are Connect, Refresh, Pause, Copy, and Run Query — and every one of them acts on the app's own window. No accounts, no telemetry, no update checks, no servers of ours — none. The only network traffic the app ever makes is to the endpoint you typed, while you're looking at it.

⬇️ Downloads

✨ NEW — the Multi Lang Update, now in English · Español · Deutsch (2026-10-30)

The language edition of PROMESCOPE 1.0 — the confusion-fix edition, now speaking three languages: a plain-words clarity update. It sits beside the original 1.0 downloads below; both stay available. What changed:

• Every button answers — the six controls that used to fail in silence now say what happened, or what to do first.
• Deleting a saved connection asks first, naming the connection — and removing is the only deletion in the program, confirmed by you, every time.
• A real Refresh-every picker (5/15/30/60 seconds) that persists, exactly as the README always promised.
• A Help menu with 13 plain-words topics and tooltips on every non-obvious control; exporter-page reasons for Query/Targets are shown on screen; the “which kind is it?” question has an “I don't know — go back” escape.
• Nothing else of yours is touched: a tree-checked proof shows the only file that ever changes is the program's own saved-connections file, and only on your Save, your confirmed Delete, or your picker change.
• Geometry verified at 1024×600 and 800×600 — everything inside the window at both sizes.
• Now in English, Español and Deutsch: use the globe button on the first screen (Language · Idioma · Sprache) to choose — screens, tooltips, Help and manuals all follow. It still only ever looks; it changes nothing.

Download PROMESCOPE — Multi Lang Update for Linux

Unpack it — inside is the program PROMESCOPE, the full source promescope.py, and short READMEs in all three languages. Make the program runnable with chmod +x PROMESCOPE, then run ./PROMESCOPE. No install, no administrator rights.
SHA-256: 9adecfcaa3ab8c6561bf48139d04b8d684f20e173b25a43f79597b854c289f5d (tarball, 12.9 MB)

Windows: the update kit is ready — Steven compiles it in the house Windows guest from this same source, language packs included, and the Windows Multi Lang Update lands here the moment it is verified. The 1.0 Windows download below stays available meanwhile.

🐧 The program — Linux (1.0, 2026-10-29)

Download PROMESCOPE for Linux

Unpack it — inside is the program PROMESCOPE, the full source promescope.py, and a short README. Make the program runnable with chmod +x PROMESCOPE, then run ./PROMESCOPE. No install, no administrator rights.
SHA-256: cde2c543d695970bceeab6b789fb0918dad3711aa41bb59809620f6d74b3b290 (tarball, 12.8 MB)

Built Linux first, like every 777 Software program.

🪟 The program — Windows (1.0, 2026-10-29)

Download PROMESCOPE for Windows

Unzip it anywhere — inside is the program PROMESCOPE.exe, its terminal twin PROMESCOPE-Console.exe, and a short how-to. Double-click PROMESCOPE.exe and point it at your Prometheus server or exporter page. No install, no administrator rights. The same proven build as Linux — the program inside is code-identical to the tested source.
SHA-256: ed59d8cc71a00528d17f3cbb1e45fb98fa01a6827a4058f3db3fba2ec54b9aef (zip, 21.5 MB)

FREE. Download it, run it, keep it. Free forever — we do not charge people for protecting themselves with our tools.

📖 The manual (PDF)

The full picture of what PROMESCOPE does and how to drive it.

PROMESCOPE — How It Works (PDF)
The program manual — connecting to a server or an exporter, the board, sort + filter, the detail pane, the graph screen, the query box, targets, and the honest limits. 11 pages · SHA-256: a8d90ef10aaee3776ba99dfa184e01796dafa7a7d7490c6deb97fcf7dc3c8dab