Przejdź do treści
Biblioteka skilli
DevOps i chmura · Konwersja i formaty

telemetry-export

/telemetry-export

Przenosi zapisy przebiegów potoku do redagowanego NDJSON i wysyła je do zewnętrznego systemu obserwowalności wskazanego w profilu.

Repozytorium
agentic-os ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
30.09.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
3
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 30.09.2026, bez odwołań do wycofanych modeli i API.

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co robi i kiedy

Przenosi zapisy przebiegów potoku do redagowanego NDJSON i wysyła je do zewnętrznego systemu obserwowalności wskazanego w profilu.

Wyzwalacze z opisu

export run telemetrysend this runwire up observability for the pipelineship gate decisions to our dashboard
Oryginalny opis (EN)

Project a pipeline run's governance ledgers (events.jsonl, decisions.jsonl) into redacted NDJSON and hand them to a host-declared observability backend. Invoke when an operator wants run/gate telemetry visible outside the workspace — "export run telemetry", "send this run's events to Axiom", "wire up observability for the pipeline", "ship gate decisions to our dashboard". Requires a declared profile in `.agentic/guides/integration/telemetry-flow.md`; absent that, this skill is a no-op by design. Not for: token/cost telemetry (unimplemented, see tokenomics.md's usage.sampled), querying a backen

Jak działa

  1. Invocation
  2. Steps
  3. What ships vs. what a host adds
  4. Related
Sekcje z nagłówków SKILL.md, w oryginale · 80 linii, 494 słów
Podgląd SKILL.md
---
name: telemetry-export
description: >-
  Project a pipeline run's governance ledgers (events.jsonl, decisions.jsonl)
  into redacted NDJSON and hand them to a host-declared observability backend.
  Invoke when an operator wants run/gate telemetry visible outside the
  workspace — "export run telemetry", "send this run's events to Axiom",
  "wire up observability for the pipeline", "ship gate decisions to our
  dashboard". Requires a declared profile in
  `.agentic/guides/integration/telemetry-flow.md`; absent that, this skill is
  a no-op by design. Not for: token/cost telemetry (unimplemented, see
  tokenomics.md's usage.sampled), querying a backend from an agent (use the
  backend's own MCP server or skill set), or any automatic/default export —
  this skill only runs when explicitly invoked or wired into a host-owned hook.
version: 0.1.0
license: Apache-2.0
allowed-tools: Read, Bash, Glob, Grep
---

# telemetry-export

Turns one run directory's append-only ledgers into a redacted NDJSON stream
and pipes it to whatever backend the host project has declared. Read
`references/observability-adapters.md` before touching this skill or its
projector — it is the contract that keeps this a thin, replaceable adapter
rather than a vendor client.

> **Deny-by-default.** The projector script never forwards `summary`,
> `verdict.rationale`, `prior_context`, or an `artifacts[]` path. If a question
> can't be answered from structural/enum fields, this skill does not answer it.
> Widening the allowlist is a decision for `observability-adapters.md`, not an
> ad-hoc addition here.

## Invocation

```
telemetry-export [run-dir]
```

`run-dir` defaults to the newest run under `docs/superpowers/runs/` (same
discovery `ticket-sync` uses). Typically invoked by an operator after a run
completes, or wired into a host's own Stop hook — this skill never registers
itself as a hook in `plugin.json`, so nothing exports by default.

## Steps

1. **Read the flow file.** Look for
   `.agentic/guides/integration/telemetry-flow.md`. If it is absent, or
   `**Status**` is not `configured`, stop — print nothing, append nothing.
   This is the same `warn-and-continue` posture as `work-item-adapters.md`.
2. **Resolve the run directory.** Use the given path, or the newest
   `meta.json` under `docs/superpowers/runs/` (maxdepth 2), matching
   `ticket-sync`'s discovery exactly so the two adapters never disagree about
   "the current run."
   If the run is managed by `.agentic/state/runtime.sqlite3`, invoke
   `legacy.export` before reading the compatibility files. If that operation is
   unavailable, block rather than exporting a stale view.
3. **Run the projector:**
   ```
   python3 "${CLAUDE_PLUGIN_ROOT}/scripts/export-run-telemetry.py" \
     --run <run-dir> --extra-fields "<Extra fields, if declared>"
   ```
   Capture stdout (the NDJSON batch) and the `CURSOR {...}` line the script
   writes to stderr.
4. **Nothing new?** If stdout is empty, stop without writing any event — a
   receipt for zero new lines would itself become the next `telemetry.*` line
   to exclude, for no benefit.
5. **Invoke the declared exporter**, piping the NDJSON batch to its stdin,
   under a timeout (120s, matching `ticket-sync`). Never let a nonzero exit or
   a hang block turn-end.
6. **Record the outcome** through the runtime event/evidence operation for a
   managed run, then refresh compatibility files with `legacy.export`. For an
   unmanaged legacy run, append the outcome to `events.jsonl`:
   - success → `telemetry.export_receipt`, `data` = the `CURSOR` object plus
     `{"line_count": <lines sent>}`.
   - failure/timeout → `telemetry.export_warning`, `data` =
     `{"reason": "<short reason>"}`. The `CURSOR` offsets are **not** advanced
     on failure, so the same batch is retried next invocation.

## What ships vs. what a host adds

This skill and its projector ship with zero egress: no endpoint, no token, no
vendor name. A host project opts in by writing
`.agentic/guides/integration/telemetry-flow.md` and picking a profile —
`references/profiles/axiom.md` or `references/profiles/otlp-logs.md` document
the two shipped ones; a `custom` profile can point at anything that reads
NDJSON on stdin.

## Related

- `references/observability-adapters.md` — the full contract (allowlist
  tables, `run_id` injection, failure handling).
- `scripts/export-run-telemetry.py` — the projector this skill invokes.
- `references/profiles/axiom.md`, `references/profiles/otlp-logs.md` — shipped
  backend profiles.
- `hooks/ticket-sync` — the sibling adapter this skill's run-discovery and
  failure posture deliberately match.
Pliki w paczce (3)
  • README.md 3 KB
  • SKILL.md 5 KB
  • evals/evals.json 5 KB

Wersje

W bazie nie ma innych skilli o nazwie telemetry-export.

Migawka bazy z 13.11.2026 · wersja paczki 7578fe984474 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 90purview-telemetry
    Dodaje i przegląda logowanie, ślady i metryki w projekcie .NET, zalecając generator telemetrii w każdym rozmiarze projektu.
  • 100agent-observability
    Pomaga monitorować, śledzić i debugować agentowe workflow na produkcji: OpenTelemetry, Langfuse, opóźnienia, koszt tokenów i wykrywanie pętli.
  • 100signoz-setting-up-observability
    Prowadzi pełną konfigurację obserwowalności usługi po starcie telemetrii w SigNoz: SLI i SLO, eksplorację RED i USE, dashboardy, widoki, alerty burn-rate i strojenie.
  • 100axiom-ingest
    Wysyła dane JSON, NDJSON lub CSV do Axiom, tworzy zbiór danych i potwierdza import zapytaniem.
  • 95a365-code-validator
    Sprawdza i poprawia instrumentację obserwowalności Agent 365, by agent wysyłał telemetrię do MAC Activity.
  • 100appinsights-instrumentation
    Instrumentuje aplikacje webowe do wysyłania telemetrii do Azure Application Insights na potrzeby obserwowalności i monitoringu.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.